muhammara 2.4.0 → 3.0.0

package/muhammara.d.ts

@@ -1,4 +1,5 @@
 declare module 'muhammara' {
+  import EventEmitter = require("events");
   export type PosX = number;
   export type PosY = number;
   export type Width = number;
@@ -39,10 +40,10 @@ declare module 'muhammara' {
     options?: PDFRecryptOptions,
   ): void;
   export function recrypt(
-    originalPdfStream: any,
-    newPdfStream: any,
+    originalPdfStream: PDFRStreamForFile | PDFRStreamForBuffer,
+    newPdfStream: PDFWStreamForFile | PDFWStreamForBuffer,
     options?: PDFRecryptOptions,
-  ): void; // TODO stream
+  ): void;
 
   export interface WriteStream {
     write(inBytesArray: any[]): number;
@@ -87,8 +88,10 @@ declare module 'muhammara' {
     writePage(): this;
   }
 
+  export type PDFImageType = 'JPG' | 'PDF' | 'PNG' | 'TIFF'
+
   export interface PDFRStreamForFile extends ReadStream {
-    new (inPath: string): PDFRStreamForFile;
+    new (inPath: FilePath): PDFRStreamForFile;
     close(inCallback?: () => void): void;
   }
 
@@ -106,6 +109,36 @@ declare module 'muhammara' {
     width?: number;
     close?: boolean;
   }
+  export type TransformationMatrix = [a: number, b: number, c: number, d: number, e: number, f: number]
+
+
+  enum LineJoinStyle {
+    LINEJOIN_ROUND,
+    LINEJOIN_BEVEL,
+    LINEJOIN_MITER_VARIABLE,
+    LINEJOIN_MITER          = 2,
+    LINEJOIN_MITER_FIXED    = 3
+  }
+
+  enum EEncoding
+  {
+    EEncodingText = 'text',
+    EEncodingCode = 'code',
+    EEncodingHex = 'hex'
+  }
+
+  enum LineCapStyle {
+    LINECAP_BUTT = 0,
+    LINECAP_ROUND,
+    LINECAP_SQUARE
+  }
+
+  export interface TextRenderOptions {
+    encoding?: EEncoding
+  }
+
+  export type Glyph = Array<[number, number]>;
+
 
   export interface AbstractContentContext {
     b(): this;
@@ -118,13 +151,13 @@ declare module 'muhammara' {
     F(): this;
     fStar(): this;
     n(): this;
-    m(x: number, y: number): this;
-    l(x: number, y: number): this;
-    c(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number): number;
-    v(x2: number, y2: number, x3: number, y3: number): this;
-    y(x1: number, y1: number, x3: number, y3: number): this;
+    m(x: PosX, y: PosY): this;
+    l(x: PosX, y: PosY): this;
+    c(x1: PosX, y1: PosY, x2: PosX, y2: PosY, x3: PosX, y3: PosY): number;
+    v(x2: PosX, y2: PosY, x3: PosX, y3: PosY): this;
+    y(x1: PosX, y1: PosY, x3: PosX, y3: PosY): this;
     h(): this;
-    re(left: number, bottom: number, width: number, height: number): this;
+    re(left: number, bottom: number, width: Width, height: Height): this;
     q(): this;
     Q(): this;
     /**
@@ -132,10 +165,10 @@ declare module 'muhammara' {
      * c d 0
      * e f 1
      */
-    cm(a: number, b: number, c: number, d: number, e: number, f: number): this;
-    w(lineWidth: number): this;
-    J(lineCapStyle: number): this;
-    j(lineJoinStyle: number): this;
+    cm(...args: TransformationMatrix): this;
+    w(lineWidth: Width): this;
+    J(lineCapStyle: LineCapStyle): this;
+    j(lineJoinStyle: LineJoinStyle): this;
     M(miterLimit: number): this;
     d(miterLimit: number[], dashPhase: number): this;
     ri(renderingIntentName: string): this;
@@ -146,9 +179,11 @@ declare module 'muhammara' {
     SC(...colorComponents: number[]): this;
     SCN(...parameters: any[]): this; // This can't be materialized in TypeScript
     ////SCN(...colorComponents: number[], patternName?: string): this;
+    SCN(colorComponents: number[], patternName?: string): this;
     sc(...colorComponents: number[]): this;
     scn(...parameters: any[]): this; // This can't be materialized in TypeScript
     ////scn(...colorComponents: number[], patternName?: string): this;
+    scn(colorComponents: number[], patternName?: string): this;
     G(gray: number): this;
     g(gray: number): this;
     RG(r: number, g: number, b: number): this;
@@ -157,7 +192,7 @@ declare module 'muhammara' {
     k(c: number, m: number, y: number, k: number): this;
     W(): this;
     WStar(): this;
-    doXObject(xObject: string | any): this; // TODO
+    doXObject(xObject: string | FormXObject | ImageXObject): this;
     Tc(characterSpace: number): this;
     Tw(wordSpace: number): this;
     Tz(horizontalScaling: number): this;
@@ -171,18 +206,19 @@ declare module 'muhammara' {
     Tm(a: number, b: number, c: number, d: number, e: number, f: number): this;
     TStar(): this;
     Tf(fontReferenced: UsedFont | string, fontSize: number): this;
-    Tj(text: string | any): this; // Glyph
-    Quote(text: string | any): this; // Glyph
-    DoubleQuote(wordSpacing: number, characterString: number, text: string | any): this; // Glyph
-    TJ(stringsAndSpacing: any): this; // TODO
+    Tj(text: string | Glyph): this;
+    Quote(text: string | Glyph): this;
+    DoubleQuote(wordSpacing: number, characterString: number, text: string | Glyph): this;
+    TJ(value: string | Glyph, options?: TextRenderOptions): this;
     writeFreeCode(freeCode: string): this;
     drawPath(...parameters: any[]): this; // This can't be materialized in TypeScript
     ////drawPath(...xyPairs: number[], options: GraphicOptions): this;
-    drawCircle(x: number, y: number, r: number, options: GraphicOptions): this;
-    drawSquare(x: number, y: number, l: number, options: GraphicOptions): this;
-    drawRectangle(x: number, y: number, w: number, h: number, options: GraphicOptions): this;
-    writeText(text: string, x: number, y: number, options?: WriteTextOptions): this;
-    drawImage(x: number, y: number, imagePath: string, options?: ImageOptions): this;
+    drawPath(xyPairs:  Array<[number, number]>, options: GraphicOptions): this;
+    drawCircle(x: PosX, y: PosY, r: number, options: GraphicOptions): this;
+    drawSquare(x: PosX, y: PosY, l: number, options: GraphicOptions): this;
+    drawRectangle(x: PosX, y: PosY, w: number, h: number, options: GraphicOptions): this;
+    writeText(text: string, x: PosX, y: PosY, options?: WriteTextOptions): this;
+    drawImage(x: PosX, y: PosY, imagePath: string, options?: ImageOptions): this;
   }
 
   export interface TransformationObject {
@@ -215,7 +251,7 @@ declare module 'muhammara' {
   }
 
   export interface PDFStreamForResponse extends WriteStream {
-    new (res: any): PDFStreamForResponse;
+    new (res: PDFRStreamForFile): PDFStreamForResponse;
   }
 	
   export interface PDFWStreamForBuffer extends WriteStream {
@@ -233,7 +269,7 @@ declare module 'muhammara' {
 
   export interface PDFWriterToContinueOptions {
     modifiedFilePath?: string;
-    alternativeStream?: any; // TODO
+    modifiedStream?: PDFRStreamForFile; // TODO
     log?: string;
   }
 
@@ -272,6 +308,10 @@ declare module 'muhammara' {
   export const ePDFPageBoxArtBox = 4;
   export type PDFPageBoxType = 0 | 1 | 2 | 3 | 4;
 
+  export const eRangeTypeAll = 0;
+  export const eRangeTypeSpecific = 1;
+  export type eRangeType = 0 | 1;
+
   export interface PDFWriterOptions {
     version?: EPDFVersion;
     log?: string;
@@ -289,18 +329,17 @@ declare module 'muhammara' {
   }
 
   export interface ResourcesDictionary {
-    addFormXObjectMapping(formXObject: FormXObject): any;
-    /*
-    SET_PROTOTYPE_METHOD(t, "addImageXObjectMapping", AddImageXObjectMapping);
-    SET_PROTOTYPE_METHOD(t, "addProcsetResource", AddProcsetResource);
-    SET_PROTOTYPE_METHOD(t, "addExtGStateMapping", AddExtGStateMapping);
-    SET_PROTOTYPE_METHOD(t, "addFontMapping", AddFontMapping);
-    SET_PROTOTYPE_METHOD(t, "addColorSpaceMapping", AddColorSpaceMapping);
-    SET_PROTOTYPE_METHOD(t, "addPatternMapping", AddPatternMapping);
-    SET_PROTOTYPE_METHOD(t, "addPropertyMapping", AddPropertyMapping);
-    SET_PROTOTYPE_METHOD(t, "addXObjectMapping", AddXObjectMapping);
-    SET_PROTOTYPE_METHOD(t, "addShadingMapping", AddShadingMapping);
-    */
+    addFormXObjectMapping(formXObject: FormXObject): string;
+    addImageXObjectMapping(imageXObject: ImageXObject|number): string;
+    addProcsetResource(procSetName: string): void;
+    addExtGStateMapping(stateObjectId: number): string;
+    addFontMapping(fontObjectId: number): string;
+    addColorSpaceMapping(colorSpaceId: number): string;
+    addPatternMapping(colorSpaceId: number): string;
+    addPatternMapping(patternObjectId: number): string;
+    addPropertyMapping(propertyObjectId: number): string;
+    addXObjectMapping(xObjectId: number): string;
+    addShadingMapping(xObjectId: number): string;
   }
 
   export type PDFBox = [PosX, PosY, Width, Height];
@@ -313,16 +352,6 @@ declare module 'muhammara' {
     artBox?: PDFBox;
     rotate?: number;
     getResourcesDictionary(): ResourcesDictionary;
-
-    /*
-    SET_ACCESSOR_METHODS(t, "mediaBox", GetMediaBox, SetMediaBox);
-	SET_ACCESSOR_METHODS(t, "cropBox", GetCropBox, SetCropBox);
-	SET_ACCESSOR_METHODS(t, "bleedBox", GetBleedBox, SetBleedBox);
-	SET_ACCESSOR_METHODS(t, "trimBox", GetTrimBox, SetTrimBox);
-	SET_ACCESSOR_METHODS(t, "artBox", GetArtBox, SetArtBox);
-    SET_ACCESSOR_METHODS(t, "rotate",GetRotate, SetRotate);
-	SET_PROTOTYPE_METHOD(t, "getResourcesDictionary", GetResourcesDictionary);
-    */
   }
 
   export interface TextDimension {
@@ -348,21 +377,17 @@ declare module 'muhammara' {
   }
 
   export interface ByteReader {
-    /*
-	SET_PROTOTYPE_METHOD(t, "read", Read);
-	SET_PROTOTYPE_METHOD(t, "notEnded", NotEnded);
-    */
+    read(length: number): Array<number>;
+    notEnded(): boolean;
   }
 
   export interface ByteReaderWithPosition {
-    /*
-        SET_PROTOTYPE_METHOD(t, "read", Read);
-        SET_PROTOTYPE_METHOD(t, "notEnded", NotEnded);
-        SET_PROTOTYPE_METHOD(t, "setPosition", SetPosition);
-        SET_PROTOTYPE_METHOD(t, "getCurrentPosition", GetCurrentPosition);
-        SET_PROTOTYPE_METHOD(t, "setPositionFromEnd", SetPositionFromEnd);
-        SET_PROTOTYPE_METHOD(t, "skip", Skip);
-        */
+    read(length: number): Array<number>;
+    notEnded(): boolean;
+    getCurrentPosition(): number;
+    skip(length: number): this;
+    setPosition(position: number): this;
+    setPositionFromEnd(position: number): this;
   }
 
   export interface PDFReader {
@@ -370,24 +395,19 @@ declare module 'muhammara' {
     getPagesCount(): number;
     getTrailer(): PDFDictionary;
     queryDictionaryObject(dictionary: PDFDictionary, name: string): PDFObject;
-    /*
-  SET_PROTOTYPE_METHOD(t, "queryArrayObject", QueryArrayObject);
-  */
+    queryArrayObject(objectList: PDFArray, index: number): undefined|PDFObject;
     parseNewObject(objectId: number): PDFObject;
-    /*
-    SET_PROTOTYPE_METHOD(t, "getPageObjectID", GetPageObjectID);
-    SET_PROTOTYPE_METHOD(t, "parsePageDictionary", ParsePageDictionary);
-    */
+    getPageObjectID(objectId: number): number;
+    parsePageDictionary(objectId: number): PDFDictionary;
     parsePage(page: number): PDFPageInput;
-    /*
-    SET_PROTOTYPE_METHOD(t, "getObjectsCount", GetObjectsCount);
-    SET_PROTOTYPE_METHOD(t, "isEncrypted", IsEncrypted);
-    SET_PROTOTYPE_METHOD(t, "getXrefSize", GetXrefSize);
-    SET_PROTOTYPE_METHOD(t, "getXrefEntry", GetXrefEntry);
-    SET_PROTOTYPE_METHOD(t, "getXrefPosition", GetXrefPosition);
-    SET_PROTOTYPE_METHOD(t, "startReadingFromStream", StartReadingFromStream);
-    SET_PROTOTYPE_METHOD(t, "getParserStream", GetParserStream);
-      */
+    getObjectsCount(): number;
+    isEncrypted(): boolean;
+    getXrefSize(): number;
+    getXrefEntry(objectId: number): { objectPosition: number, revision: number, type: number };
+    getXrefSize(): number;
+    getXrefPosition(objectId: number): number;
+    startReadingFromStream(inputStream: PDFStreamInput): ByteReader;
+    getParserStream(): ByteReaderWithPosition;
   }
 
   export interface PDFStream {
@@ -395,15 +415,11 @@ declare module 'muhammara' {
   }
 
   export interface PDFNull extends PDFObject {
-    /*
-        SET_ACCESSOR_METHOD(t, "value", GetValue);
-        */
+    value: void;
   }
 
   export interface PDFName extends PDFObject {
-    /*
-        SET_ACCESSOR_METHOD(t, "value", GetValue);
-        */
+    value: string;
   }
 
   export interface PDFLiteralString extends PDFObject {
@@ -412,9 +428,7 @@ declare module 'muhammara' {
   }
 
   export interface PDFInteger extends PDFObject {
-    /*
-        SET_ACCESSOR_METHOD(t, "value", GetValue);
-        */
+    value: number;
   }
 
   export interface PDFIndirectObjectReference extends PDFObject {
@@ -423,9 +437,7 @@ declare module 'muhammara' {
   }
 
   export interface PDFHexString extends PDFObject {
-    /*
-        SET_ACCESSOR_METHOD(t, "value", GetValue);
-        */
+    value: string;
   }
 
   export interface PDFDictionary extends PDFObject {
@@ -435,151 +447,145 @@ declare module 'muhammara' {
   }
 
   export interface PDFDate {
-    /*
-        SET_PROTOTYPE_METHOD(t, "toString", ToString);
-        SET_PROTOTYPE_METHOD(t, "setToCurrentTime", SetToCurrentTime);
-        */
+    toString(): string;
+    setToCurrentTime(): this;
   }
 
   export interface PDFBoolean extends PDFObject {
-    /*
-	SET_ACCESSOR_METHOD(t, "value", GetValue);
-    */
+    value: boolean;
   }
 
   export interface PDFArray extends PDFObject {
-    /*
-	SET_PROTOTYPE_METHOD(t, "toJSArray", ToJSArray);
-	SET_PROTOTYPE_METHOD(t, "queryObject", QueryObject);
-	SET_PROTOTYPE_METHOD(t, "getLength", GetLength);
-    */
+    toJSArray(): Array<any>;
+    queryObject(index: number): any;
+    getLength(): number;
   }
 
   export interface OutputFile {
-    /*
-	SET_PROTOTYPE_METHOD(t, "openFile", OpenFile);
-	SET_PROTOTYPE_METHOD(t, "closeFile", CloseFile);
-	SET_PROTOTYPE_METHOD(t, "getFilePath", GetFilePath);
-	SET_PROTOTYPE_METHOD(t, "getOutputStream", GetOutputStream);
-    */
+    openFile(filePath: FilePath, append?: boolean): void;
+    closeFile(): void;
+    getFilePath(): string|undefined;
+    getOutputStream(): ByteWriterWithPosition|undefined;
   }
 
   export interface InputFile {
-    /*
-        SET_PROTOTYPE_METHOD(t, "openFile", OpenFile);
-        SET_PROTOTYPE_METHOD(t, "closeFile", CloseFile);
-        SET_PROTOTYPE_METHOD(t, "getFilePath", GetFilePath);
-        SET_PROTOTYPE_METHOD(t, "getFileSize", GetFileSize);
-        SET_PROTOTYPE_METHOD(t, "getInputStream", GetInputStream);
-    */
+    openFile(filePath: FilePath): void;
+    closeFile(): void;
+    getFilePath(): string|undefined;
+    getFileSize(): number|undefined;
+    getInputStream(): ByteReaderWithPosition|undefined;
   }
 
+    export enum EInfoTrapped {
+      EInfoTrappedTrue,
+      EInfoTrappedFalse,
+      EInfoTrappedUnknown
+    }
+
   export interface InfoDictionary {
-    /*
-	SET_PROTOTYPE_METHOD(t, "addAdditionalInfoEntry", AddAdditionalInfoEntry);
-	SET_PROTOTYPE_METHOD(t, "removeAdditionalInfoEntry", RemoveAdditionalInfoEntry);
-	SET_PROTOTYPE_METHOD(t, "clearAdditionalInfoEntries", ClearAdditionalInfoEntries);
-	SET_PROTOTYPE_METHOD(t, "getAdditionalInfoEntry", GetAdditionalInfoEntry);
-	SET_PROTOTYPE_METHOD(t, "getAdditionalInfoEntries", GetAdditionalInfoEntries);
-	SET_PROTOTYPE_METHOD(t, "setCreationDate", SetCreationDate);
-	SET_PROTOTYPE_METHOD(t, "setModDate", SetModDate);
-	SET_ACCESSOR_METHODS(t, "title", GetTitle, SetTitle);
-	SET_ACCESSOR_METHODS(t, "author", GetAuthor, SetAuthor);
-	SET_ACCESSOR_METHODS(t, "subject", GetSubject, SetSubject);
-	SET_ACCESSOR_METHODS(t, "keywords", GetKeywords, SetKeywords);
-	SET_ACCESSOR_METHODS(t, "creator", GetCreator, SetCreator);
-	SET_ACCESSOR_METHODS(t, "producer", GetProducer, SetProducer);
-	SET_ACCESSOR_METHODS(t, "trapped", GetTrapped, SetTrapped);
-    */
+    addAdditionalInfoEntry(key: string, value: string): void;
+    removeAdditionalInfoEntry(key: string): void;
+    clearAdditionalInfoEntries(): void;
+    getAdditionalInfoEntry(key: string): string;
+    getAdditionalInfoEntries(key: string): {[key: string]: string}
+    setCreationDate(date: string | Date): void;
+    setModDate(date: string | Date): void;
+
+    title: string;
+    author: string;
+    subject: string;
+    keywords: string;
+    creator: string;
+    producer: string;
+    trapped: EInfoTrapped;
   }
 
   export interface ImageXObject {
-    /*
-        SET_ACCESSOR_METHOD(t, "id", GetID);
-        */
+    id: number;
   }
 
   export interface FormObject {
-    /*
-        SET_ACCESSOR_METHOD(t,"id", GetID);
-        SET_PROTOTYPE_METHOD(t, "getContentContext", GetContentContext);
-        SET_PROTOTYPE_METHOD(t, "getResourcesDictinary", GetResourcesDictionary);
-        SET_PROTOTYPE_METHOD(t, "getContentStream", GetContentStream);
-        */
+    id: number;
+    getContentContext(): XObjectContentContext;
+    getResourcesDictinary(): ResourcesDictionary;
+    getContentStream(): PDFStream;
   }
 
   export interface DocumentCopyingContext {
     createFormXObjectFromPDFPage(
       sourcePageIndex: number,
       ePDFPageBox: PDFPageBoxType | PDFBox,
+      transformation?: TransformationMatrix
     ): number;
     mergePDFPageToPage(target: PDFPage, sourcePageIndex: number): void;
     appendPDFPageFromPDF(sourcePageNumber: number): number; // stream start bytes?
-    mergePDFPageToFormXObject(sourcePage: PDFPage, targetPageNumber: number): any;
-    /*
-    SET_PROTOTYPE_METHOD(t, "getSourceDocumentParser", GetSourceDocumentParser);
-    SET_PROTOTYPE_METHOD(t, "copyDirectObjectAsIs", CopyDirectObjectAsIs);
-    SET_PROTOTYPE_METHOD(t, "copyObject", CopyObject);
-    SET_PROTOTYPE_METHOD(t, "copyDirectObjectWithDeepCopy", CopyDirectObjectWithDeepCopy);
-    SET_PROTOTYPE_METHOD(t, "copyNewObjectsForDirectObject", CopyNewObjectsForDirectObject);
-    SET_PROTOTYPE_METHOD(t, "getCopiedObjectID", GetCopiedObjectID);
-    SET_PROTOTYPE_METHOD(t, "getCopiedObjects", GetCopiedObjects);
-    SET_PROTOTYPE_METHOD(t, "replaceSourceObjects", ReplaceSourceObjects);
-    SET_PROTOTYPE_METHOD(t, "getSourceDocumentStream", GetSourceDocumentStream);
-      */
+    mergePDFPageToFormXObject(sourcePage: PDFPage, targetPageNumber: number): void;
+    getSourceDocumentParser(input: FilePath | ReadStream, options?: PDFReaderOptions): PDFReader;
+    copyDirectObjectAsIs(objectToCopy: PDFObject): void;
+    copyObject(objectId: number): number;
+    copyDirectObjectWithDeepCopy(objectToCopy: PDFObject): Array<number>;
+    copyNewObjectsForDirectObject(objectIds: Array<number>): void;
+    getCopiedObjectID(objectId: number): number;
+    getCopiedObjects(): {[key: string]: number};
+    replaceSourceObjects(replaceMap: {[key: string]: number}): void;
+    getSourceDocumentStream(): ByteReaderWithPosition;
   }
 
   export interface DocumentContext {
-    /*
-	SET_PROTOTYPE_METHOD(t, "getInfoDictionary", GetInfoDictionary);
-    */
+    getInfoDictionary(): InfoDictionary;
   }
 
   export interface DictionaryContext {
-    /*
-        SET_PROTOTYPE_METHOD(t, "writeKey", WriteKey);
-        SET_PROTOTYPE_METHOD(t, "writeNameValue", WriteNameValue);
-        SET_PROTOTYPE_METHOD(t, "writeRectangleValue", WriteRectangleValue);
-        SET_PROTOTYPE_METHOD(t, "writeLiteralStringValue", WriteLiteralStringValue);
-        SET_PROTOTYPE_METHOD(t, "writeBooleanValue", WriteBooleanValue);
-        SET_PROTOTYPE_METHOD(t, "writeObjectReferenceValue", WriteObjectReferenceValue);
-        */
+    writeKey(): DictionaryContext;
+    writeNameValue(nameValue: string): this;
+    writeRectangleValue(values: Array<number>): this;
+    writeRectangleValue(a: number, b: number, c: number, d: number): this;
+    writeLiteralStringValue(literal: Array<number>|string): this;
+    writeBooleanValue(boolValue: boolean): this;
+    writeObjectReferenceValue(objectId: number): this;
   }
 
   export interface ByteWriterWithPosition {
-    /*
-        SET_PROTOTYPE_METHOD(t, "write", Write);
-        SET_PROTOTYPE_METHOD(t, "getCurrentPosition", GetCurrentPosition);
-        */
+    write(bytes: Array<number>):  number;
+    getCurrentPosition(): number;
+  }
+
+  export type eTokenSeparatorSpace = 0;
+  export type eTokenSeparatorEndLine = 1;
+  export type eTokenSeparatorNone = 2;
+
+  enum ETokenSeparator {
+    eTokenSeparatorSpace,
+    eTokenSeparatorEndLine,
+    eTokenSeparatorNone
   }
 
   export interface ObjectsContext {
-    /*
-SET_PROTOTYPE_METHOD(t, "allocateNewObjectID", AllocateNewObjectID);
-	SET_PROTOTYPE_METHOD(t, "startDictionary", StartDictionary);
-	SET_PROTOTYPE_METHOD(t, "startArray", StartArray);
-	SET_PROTOTYPE_METHOD(t, "writeNumber", WriteNumber);
-	SET_PROTOTYPE_METHOD(t, "endArray", EndArray);
-	SET_PROTOTYPE_METHOD(t, "endLine", EndLine);
-	SET_PROTOTYPE_METHOD(t, "endDictionary", EndDictionary);
-	SET_PROTOTYPE_METHOD(t, "endIndirectObject", EndIndirectObject);
-	SET_PROTOTYPE_METHOD(t, "writeIndirectObjectReference", WriteIndirectObjectReference);
-	SET_PROTOTYPE_METHOD(t, "startNewIndirectObject", StartNewIndirectObject);
-	SET_PROTOTYPE_METHOD(t, "startModifiedIndirectObject", StartModifiedIndirectObject);
-	SET_PROTOTYPE_METHOD(t, "deleteObject", DeleteObject);
-	SET_PROTOTYPE_METHOD(t, "writeName", WriteName);
-	SET_PROTOTYPE_METHOD(t, "writeLiteralString", WriteLiteralString);
-	SET_PROTOTYPE_METHOD(t, "writeHexString", WriteHexString);
-	SET_PROTOTYPE_METHOD(t, "writeBoolean", WriteBoolean);
-	SET_PROTOTYPE_METHOD(t, "writeKeyword", WriteKeyword);
-	SET_PROTOTYPE_METHOD(t, "writeComment", WriteComment);
-	SET_PROTOTYPE_METHOD(t, "setCompressStreams", SetCompressStreams);
-	SET_PROTOTYPE_METHOD(t, "startPDFStream", StartPDFStream);
-	SET_PROTOTYPE_METHOD(t, "startUnfilteredPDFStream", StartUnfilteredPDFStream);
-	SET_PROTOTYPE_METHOD(t, "endPDFStream", EndPDFStream);
-	SET_PROTOTYPE_METHOD(t, "startFreeContext", StartFreeContext);
-	SET_PROTOTYPE_METHOD(t, "endFreeContext", EndFreeContext);
-    */
+    allocateNewObjectID(): FormXObjectId;
+    startDictionary(): DictionaryContext;
+    startArray(): this;
+    writeNumber(value: number): this;
+    endArray(endType?: ETokenSeparator): this;
+    endLine(): this;
+    endDictionary(dictionary: DictionaryContext): this;
+    endIndirectObject(): this;
+    writeIndirectObjectReference(objectId: FormXObjectId, generationNumber?: number): this;
+    startNewIndirectObject(objectId: FormXObjectId): this;
+    startNewIndirectObject(): FormXObjectId;
+    startModifiedIndirectObject(objectId: FormXObjectId): this;
+    deleteObject(objectId: FormXObjectId): this;
+    writeName(name: string): this;
+    writeLiteralString(literal: string | number[]): this;
+    writeHexString(hex: string | number[]): this;
+    writeBoolean(bool: boolean): this;
+    writeKeyword(keyword: string): this;
+    writeComment(comment: string): this;
+    setCompressStreams(compress: true): this;
+    startPDFStream(dictionaryContext: DictionaryContext): PDFStream;
+    startUnfilteredPDFStream(stream: DictionaryContext): PDFStream;
+    endPDFStream(stream: PDFStream): this;
+    startFreeContext(): ByteWriterWithPosition;
+    endFreeContext(): this;
   }
 
   export interface PDFObject {
@@ -601,30 +607,22 @@ SET_PROTOTYPE_METHOD(t, "allocateNewObjectID", AllocateNewObjectID);
   }
 
   export interface PDFReal extends PDFObject {
-    /*
-        SET_ACCESSOR_METHOD(t, "value", GetValue);
-        */
+    value: number;
   }
 
   export interface PDFSymbol extends PDFObject {
-    /*
-        SET_ACCESSOR_METHOD(t, "value", GetValue);
-        */
+    value: string;
   }
 
   export interface PDFStreamInput extends PDFObject {
-    /*
-	SET_PROTOTYPE_METHOD(t, "getDictionary", GetDictionary);
-	SET_PROTOTYPE_METHOD(t, "getStreamContentStart", GetStreamContentStart);
-    */
+    getDictionary(): PDFDictionary;
+    getStreamContentStart(): number;
   }
 
   export interface PDFTextString {
-    /*
-    SET_PROTOTYPE_METHOD(t, "toBytesArray", ToBytesArray);
-	SET_PROTOTYPE_METHOD(t, "toString", ToString);
-	SET_PROTOTYPE_METHOD(t, "fromString", FromString);
-    */
+    toBytesArray(): Array<number>;
+    toString(): string;
+    fromString(value: string): void;
   }
 
   export interface PageContentContext extends AbstractContentContext {
@@ -632,56 +630,80 @@ SET_PROTOTYPE_METHOD(t, "allocateNewObjectID", AllocateNewObjectID);
     getAssociatedPage(): PDFPage;
   }
 
+  export interface JPEGInformation {
+    samplesWidth: number;
+    samplesHeight: number;
+    colorComponentsCount: number;
+    JFIFInformationExists: boolean;
+    JFIFUnit?: number;
+    JFIFXDensity?: number;
+    JFIFYDensity?: number;
+    ExifInformationExists: boolean;
+    ExifUnit?: number;
+    ExifXDensity?: number;
+    ExifYDensity?: number;
+    PhotoshopInformationExists: boolean;
+    PhotoshopXDensity?: number;
+    PhotoshopYDensity?: number;
+  }
+
+  export type PDFRectangle = [lowerLeftX: number, lowerLeftY: number, upperRightX: number, upperRightY: number];
+
+  export interface MergeOptions {
+    password?: string;
+    type?: eRangeType;
+    specificRanges?: [[number, number]];
+  }
+
+  export interface AppendOptions extends MergeOptions {}
+
+  export type inInterPagesCallback = () => {}
+
+
   export interface PDFWriter {
     end(): PDFWriter;
-    createPage(x: number, y: number, width: number, height: number): PDFPage;
+    createPage(x: PosX, y: PosY, width: Width, height: Height): PDFPage;
     createPage(): PDFPage;
     writePage(page: PDFPage): this;
     writePageAndReturnID(page: PDFPage): number;
     startPageContentContext(page: PDFPage): PageContentContext;
     pausePageContentContext(pageContextContext: PageContentContext): this;
-    /*
-    createFormXObject();
-    endFormXObject();
-    createFormXObjectFromJPG();
-    */
-    // TODO: test streamas
-    createFormXObjectFromPNG(filePath: FilePath | PDFRStreamForFile): FormXObject;
-
+    createFormXObject(x: PosX, y: PosY, width: Width, height: Height, objectId?: FormXObjectId): FormXObject;
+    endFormXObject(formXObject: FormXObject): this;
+    createFormXObjectFromJPG(file: FilePath | PDFRStreamForFile, objectId?: FormXObjectId): FormXObject;
     getFontForFile(inFontFilePath: FilePath, index?: number): UsedFont;
     getFontForFile(
       inFontFilePath: FilePath,
       inOptionalMetricsFile?: string,
       index?: number,
     ): UsedFont;
-    /*
-    attachURLLinktoCurrentPage();
-    shutdown();
-    createFormXObjectFromTIFF();
-    createImageXObjectFromJPG();
-    retrieveJPGImageInformation();
-    getObjectsContext();
-    getDocumentContext();
-    */
-    appendPDFPagesFromPDF(source: FilePath | ReadStream): number[];
-    /*
-    mergePDFPagesToPage();
-    */
+    attachURLLinktoCurrentPage(url: string, x: PosX, y: PosY, width: Width, height: Height): this;
+    shutdown(outputFilePath: FilePath): this;
+    createFormXObjectFromTIFF(filePath: FilePath | PDFRStreamForFile, objectId?: FormXObjectId): FormXObject;
+    createImageXObjectFromJPG(filePath: FilePath | PDFRStreamForFile, objectId?: FormXObjectId): ImageXObject;
+    createFormXObjectFromPNG(filePath: FilePath | PDFRStreamForFile, objectId?: FormXObjectId): FormXObject;
+    retrieveJPGImageInformation(filePath: FilePath): JPEGInformation;
+    getObjectsContext(): ObjectsContext;
+    getDocumentContext(): DocumentContext;
+    appendPDFPagesFromPDF(source: FilePath | ReadStream, options?: AppendOptions): number[];
+    mergePDFPagesToPage(page: PDFPage, file: FilePath | PDFRStreamForFile, options?: MergeOptions, callback?: inInterPagesCallback): this;
+    mergePDFPagesToPage(page: PDFPage, file: FilePath | PDFRStreamForFile, callback?: inInterPagesCallback) : this;
     createPDFCopyingContext(source: FilePath | ReadStream): DocumentCopyingContext;
-    /*
-    createFormXObjectsFromPDF();
-    createPDFCopyingContextForModifiedFile();
-    createPDFTextString();
-    createPDFDate();
-    */
+    createFormXObjectsFromPDF(file: FilePath, box?: PDFBox |  PDFPageBoxType, options?: MergeOptions, transformation?: TransformationMatrix, objectIds?: FormXObjectId[]): FormXObjectId[];
+    createPDFCopyingContextForModifiedFile(): DocumentCopyingContext;
+    createPDFTextString(): PDFTextString;
+    createPDFDate(): PDFDate;
     getImageDimensions(inFontFilePath: FilePath | ReadStream): RectangleDimension;
-    /*
-    getImagePagesCount();
-    getImageType();
-    getModifiedFileParser();
-    getModifiedInputFile();
-    getOutputFile();
-    registerAnnotationReferenceForNextPageWrite();
-    */
+    getImagePagesCount(imagePath: FilePath, options?: {password?: string}): number;
+    getImageType(imagePath: FilePath): PDFImageType | undefined;
+    getModifiedFileParser(): PDFReader;
+    getModifiedInputFile(): InputFile;
+    getOutputFile(): OutputFile;
+    registerAnnotationReferenceForNextPageWrite(annotationId: number): this;
+    requireCatalogUpdate(): void;
+
+    /* Js Extensions (in muhammara.js) */
+    getEvents(): EventEmitter;
+    triggerDocumentExtensionEvent(eventName: string | symbol, eventParams: any): void;
   }
 }