objdiff-wasm 3.0.0-beta.8 → 3.0.0

package/dist/config-schema.json

@@ -25,6 +25,20 @@
         }
       ]
     },
+    {
+      "id": "analyzeDataFlow",
+      "type": "boolean",
+      "default": false,
+      "name": "(Experimental) Perform data flow analysis",
+      "description": "Use data flow analysis to display known information about register contents where possible"
+    },
+    {
+      "id": "showDataFlow",
+      "type": "boolean",
+      "default": true,
+      "name": "Show data flow",
+      "description": "Show data flow analysis results in place of register name where present"
+    },
     {
       "id": "spaceBetweenArgs",
       "type": "boolean",
@@ -264,7 +278,8 @@
       "id": "ppc",
       "name": "PowerPC",
       "properties": [
-        "ppc.calculatePoolRelocations"
+        "ppc.calculatePoolRelocations",
+        "analyzeDataFlow"
       ]
     },
     {

package/dist/interfaces/objdiff-core-diff.d.ts

@@ -1,10 +1,46 @@
 /** @module Interface objdiff:core/diff **/
-export function runDiff(left: Object | undefined, right: Object | undefined, config: DiffConfig): DiffResult;
+export function runDiff(left: Object | undefined, right: Object | undefined, config: DiffConfig, mapping: MappingConfig): DiffResult;
 export interface MappingConfig {
   mappings: Array<[string, string]>,
   selectingLeft?: string,
   selectingRight?: string,
 }
+export type SymbolRef = number;
+/**
+ * # Variants
+ * 
+ * ## `"unknown"`
+ * 
+ * ## `"function"`
+ * 
+ * ## `"object"`
+ * 
+ * ## `"section"`
+ */
+export type SymbolKind = 'unknown' | 'function' | 'object' | 'section';
+export interface SymbolFlags {
+  global?: boolean,
+  local?: boolean,
+  weak?: boolean,
+  common?: boolean,
+  hidden?: boolean,
+  hasExtra?: boolean,
+  sizeInferred?: boolean,
+  ignored?: boolean,
+}
+export interface SymbolInfo {
+  id: SymbolRef,
+  name: string,
+  demangledName?: string,
+  address: bigint,
+  size: bigint,
+  kind: SymbolKind,
+  section?: number,
+  sectionName?: string,
+  flags: SymbolFlags,
+  align?: number,
+  virtualAddress?: bigint,
+}
 export interface DiffResult {
   left?: ObjectDiff,
   right?: ObjectDiff,
@@ -30,5 +66,6 @@ export class ObjectDiff {
    * This type does not have a public constructor.
    */
   private constructor();
-  findSymbol(name: string, sectionName: string | undefined): number | undefined;
+  findSymbol(name: string, sectionName: string | undefined): SymbolInfo | undefined;
+  getSymbol(id: number): SymbolInfo | undefined;
 }

package/dist/interfaces/objdiff-core-display.d.ts

@@ -1,15 +1,16 @@
 /** @module Interface objdiff:core/display **/
 export function displaySections(diff: ObjectDiff, filter: SymbolFilter, config: DisplayConfig): Array<SectionDisplay>;
-export function displaySymbol(diff: ObjectDiff, symbol: SectionDisplaySymbol): SymbolDisplay;
-export function displayInstructionRow(diff: ObjectDiff, symbol: SectionDisplaySymbol, rowIndex: number, config: DiffConfig): InstructionDiffRow;
-export function symbolContext(diff: ObjectDiff, symbol: SectionDisplaySymbol): Array<ContextItem>;
-export function symbolHover(diff: ObjectDiff, symbol: SectionDisplaySymbol): Array<HoverItem>;
-export function instructionContext(diff: ObjectDiff, symbol: SectionDisplaySymbol, rowIndex: number, config: DiffConfig): Array<ContextItem>;
-export function instructionHover(diff: ObjectDiff, symbol: SectionDisplaySymbol, rowIndex: number, config: DiffConfig): Array<HoverItem>;
+export function displaySymbol(diff: ObjectDiff, symbol: SymbolRef): SymbolDisplay;
+export function displayInstructionRow(diff: ObjectDiff, symbol: SymbolRef, rowIndex: number, config: DiffConfig): InstructionDiffRow;
+export function symbolContext(diff: ObjectDiff, symbol: SymbolRef): Array<ContextItem>;
+export function symbolHover(diff: ObjectDiff, symbol: SymbolRef): Array<HoverItem>;
+export function instructionContext(diff: ObjectDiff, symbol: SymbolRef, rowIndex: number, config: DiffConfig): Array<ContextItem>;
+export function instructionHover(diff: ObjectDiff, symbol: SymbolRef, rowIndex: number, config: DiffConfig): Array<HoverItem>;
 export type Object = import('./objdiff-core-diff.js').Object;
 export type ObjectDiff = import('./objdiff-core-diff.js').ObjectDiff;
 export type DiffConfig = import('./objdiff-core-diff.js').DiffConfig;
-export type SymbolRef = number;
+export type SymbolInfo = import('./objdiff-core-diff.js').SymbolInfo;
+export type SymbolRef = import('./objdiff-core-diff.js').SymbolRef;
 export interface DisplayConfig {
   showHiddenSymbols: boolean,
   showMappedSymbols: boolean,
@@ -19,49 +20,15 @@ export interface SymbolFilter {
   regex?: string,
   mapping?: SymbolRef,
 }
-export interface SectionDisplaySymbol {
-  symbol: SymbolRef,
-  isMappingSymbol: boolean,
-}
 export interface SectionDisplay {
   id: string,
   name: string,
   size: bigint,
   matchPercent?: number,
-  symbols: Array<SectionDisplaySymbol>,
-}
-/**
- * # Variants
- * 
- * ## `"unknown"`
- * 
- * ## `"function"`
- * 
- * ## `"object"`
- * 
- * ## `"section"`
- */
-export type SymbolKind = 'unknown' | 'function' | 'object' | 'section';
-export interface SymbolFlags {
-  global?: boolean,
-  local?: boolean,
-  weak?: boolean,
-  common?: boolean,
-  hidden?: boolean,
-  hasExtra?: boolean,
-  sizeInferred?: boolean,
-  ignored?: boolean,
+  symbols: Uint32Array,
 }
 export interface SymbolDisplay {
-  name: string,
-  demangledName?: string,
-  address: bigint,
-  size: bigint,
-  kind: SymbolKind,
-  section?: number,
-  flags: SymbolFlags,
-  align?: number,
-  virtualAddress?: bigint,
+  info: SymbolInfo,
   targetSymbol?: SymbolRef,
   matchPercent?: number,
   diffScore?: [bigint, bigint],
@@ -179,7 +146,7 @@ export interface DiffTextSpacing {
 export interface DiffTextEol {
   tag: 'eol',
 }
-export type DiffTextColor = DiffTextColorNormal | DiffTextColorDim | DiffTextColorBright | DiffTextColorReplace | DiffTextColorDelete | DiffTextColorInsert | DiffTextColorRotating;
+export type DiffTextColor = DiffTextColorNormal | DiffTextColorDim | DiffTextColorBright | DiffTextColorReplace | DiffTextColorDataFlow | DiffTextColorDelete | DiffTextColorInsert | DiffTextColorRotating;
 export interface DiffTextColorNormal {
   tag: 'normal',
 }
@@ -192,6 +159,9 @@ export interface DiffTextColorBright {
 export interface DiffTextColorReplace {
   tag: 'replace',
 }
+export interface DiffTextColorDataFlow {
+  tag: 'data-flow',
+}
 export interface DiffTextColorDelete {
   tag: 'delete',
 }