Add PageNumber.DOCUMENT_PAGE_NUMBER

[Jimmy89]

Starting this discussion based on this issue: #2449

There are three PageNumber enum options:

export declare enum PageNumber {
    CURRENT = "CURRENT",
    TOTAL_PAGES = "TOTAL_PAGES",
    TOTAL_PAGES_IN_SECTION = "TOTAL_PAGES_IN_SECTION"
}

Where the TOTAL_PAGES_IN_SECTION does not seem to function (see the issue).

The PageNumber.current by default starts counting at 1. You can manually override the start counter, but when the content is dynamic, you do not know how many pages you have to reset the start counter.

Therefore, the solution provided within #1622 does not resolve this problem.

I suggest to add a property that would actually inform the developer/user which page of the document is being used, e.g. PageNumber.DOCUMENT_PAGE_NUMBER or simply PageNumber.DOCUMENT.

It would also be nice if you could use these variables somehow to do a bit of fancy calculating, but that's a nice to have feature.

[Jimmy89]

I'm sorry, I make a programming mistake and realized I was the problem, not the docx code.