@paprize/core 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]

package/README.md

@@ -0,0 +1,5 @@
+# Paprize
+
+Design your report using the full power of JavaScript and CSS, mark the report section by paprize components and then paprize pagination engine will transforming it into a beautiful, professional, print-ready pages.
+
+![Components](https://raw.githubusercontent.com/PejmanNik/paprize/refs/heads/bootstrap/packages/website/static/img/components.svg)

package/dist/paprize-core.d.ts

@@ -0,0 +1,232 @@
+import { default as default_2 } from 'loglevel';
+
+declare const AttributeDef: {
+    hyphen: AttributeValueDef<string>;
+    keepOnSamePage: AttributeValueDef<boolean>;
+    hyphenationEnabled: AttributeValueDef<boolean>;
+};
+
+declare type AttributeKey = keyof typeof AttributeDef;
+
+export declare const attributePrefix = "data-pz-";
+
+declare type AttributeValue<K extends AttributeKey> = (typeof AttributeDef)[K] extends AttributeValueDef<infer R> ? R : never;
+
+declare class AttributeValueDef<T> {
+    name: string;
+    defaultValue: T;
+    private _reader;
+    constructor(name: string, reader: (value: string) => T, defaultValue: T);
+    read(value: string): T;
+    static createStr(name: string, defaultValue: string): AttributeValueDef<string>;
+    static createBool(name: string, defaultValue: boolean): AttributeValueDef<boolean>;
+}
+
+export declare function callPluginHook<T extends PluginHookNames>(plugins: PaginationPlugin[], hookName: T, ...args: Parameters<NonNullable<PaginationPlugin[T]>>): void;
+
+export declare type ConfigAttribute = {
+    [K in AttributeKey]?: AttributeValue<K>;
+};
+
+export declare function configToAttributeMap(config: ConfigAttribute): Record<string, string>;
+
+export declare function createLoremIpsumParagraph(wordCount: number, seed: number): string;
+
+export declare const currentElementClassName = "pz-current-element";
+
+export declare const currentTextClassName = "pz-current-text";
+
+export declare const defaultPlugins: PaginationPlugin[];
+
+export declare class DomState {
+    private readonly _transaction;
+    private readonly _treeWalker;
+    private readonly _config;
+    private _completed;
+    private _currentNode;
+    private _previousNode;
+    constructor(root: Element, transaction: Transaction, config: PaginationConfig);
+    get completed(): boolean;
+    get currentNode(): PageNode | null;
+    get previousNode(): PageNode | null;
+    nextNode(): void;
+    nextSiblingOrParentSibling(): {
+        parentsTraversed: number;
+    };
+    firstChildOrNextNode(): {
+        parentsTraversed: number;
+    };
+    private setState;
+}
+
+export declare const enableDebugMode: () => void;
+
+export declare function getVisibleHeight(element: Element): number;
+
+export declare const ignoredElementClassName = "pz-ignored-element";
+
+export declare const ignoredTextClassName = "pz-ignored-text";
+
+export declare const isDebugMode: () => boolean;
+
+export declare function isElement(node: Node): node is Element;
+
+export declare function isTextNode(node: Node): node is Text;
+
+export declare const logger: default_2.Logger;
+
+export declare const loggerName = "paprize";
+
+export declare function moveOffscreen(element: HTMLDivElement): void;
+
+export declare const pageBreakAttributeName = "data-pz-page-break";
+
+export declare const pageBreakPlugin: PaginationPlugin;
+
+export declare const pageBreakPluginName = "pageBreak";
+
+export declare const pageClassName = "pz-page";
+
+declare class PageElement {
+    private readonly _node;
+    private readonly _transaction;
+    readonly type: 'element';
+    readonly config: PaginationConfig;
+    constructor(element: Element, transaction: Transaction, config: PaginationConfig);
+    appendChild(node: PageNode): void;
+    clone(withChildren?: boolean): PageElement;
+    getHeight(): number;
+    remove(): void;
+    isEmpty(): boolean;
+    getChildrenCount(): number;
+    getNode(): SafeElement;
+}
+
+declare class PageManager {
+    private _pageState;
+    private readonly _transaction;
+    private readonly _tempContainer;
+    private readonly _config;
+    constructor(tempContainer: Element, pageSize: PageSize, transaction: Transaction, config: PaginationConfig);
+    nextPage(): void;
+    private cloneParentStackToNewPage;
+    private cleanupEmptyParent;
+    enterElement(): void;
+    leaveElement(): void;
+    private static createPageHtmlElement;
+    private createNewPage;
+    startTransaction(): {
+        rollback: () => void;
+        commit: () => void;
+    };
+    hasEmptySpace(elementHeight?: number): boolean;
+    isOverFlow(): boolean;
+    markPageAsFull(): void;
+    appendChild(node: PageElement, withChildren: boolean): PageElement;
+    addTextNode(text: string): PageText;
+}
+
+declare type PageNode = PageElement | PageText;
+
+export declare interface PageSize {
+    width: number;
+    height: number;
+}
+
+declare class PageState {
+    currentPage: PageElement;
+    activeElement: PageNode | null;
+    currentElement: PageElement;
+    parentStack: PageElement[];
+    pageIsFull: boolean;
+    pageIndex: number;
+    pageHeight: number;
+    constructor(currentPage: PageElement, activeElement: PageNode | null, currentElement: PageElement, parentStack: PageElement[], pageIsFull: boolean, pageIndex: number, pageHeight: number);
+    static create(currentPage: PageElement, parentStack: PageElement[], pageIndex: number, pageHeight: number): PageState;
+    clone: () => PageState;
+}
+
+declare class PageText {
+    private readonly _node;
+    private readonly _transaction;
+    readonly type: 'text';
+    readonly config: PaginationConfig;
+    constructor(text: Text, transaction: Transaction, config: PaginationConfig);
+    get textContent(): string;
+    set textContent(value: string);
+    remove(): void;
+    getNode(): SafeText;
+}
+
+export declare type PaginateResult = string[];
+
+export declare type PaginationConfig = Required<ConfigAttribute> & {
+    plugins: PaginationPlugin[];
+};
+
+export declare interface PaginationPlugin {
+    readonly name: string;
+    onVisitText?: (domState: DomState & {
+        currentNode: PageText;
+    }, pageManager: PageManager, context: VisitContext) => void;
+    onVisitElement?: (domState: DomState & {
+        currentNode: PageElement;
+    }, pageManager: PageManager, context: VisitContext) => void;
+    afterVisitNode?: (domState: DomState, pageManager: PageManager) => void;
+    onNewPage?: (newPageState: PageState) => void;
+    onClone?: (source: Element, cloned: PageElement) => void;
+}
+
+export declare class Paginator {
+    private readonly _domState;
+    private readonly _pageManager;
+    private readonly _transaction;
+    private readonly _tempContainer;
+    private readonly _config;
+    private constructor();
+    private static createTempContainer;
+    static paginate(root: Element, pageSize: PageSize, config?: Partial<PaginationConfig>): PaginateResult;
+    private processAllNodes;
+    private handleNodeSkipped;
+    private handleFullNodePlaced;
+    private handleChildrenSplit;
+    private processCurrentNode;
+}
+
+declare type PluginHookNames = NonNullable<PluginKeys>;
+
+declare type PluginKeys = {
+    [K in keyof PaginationPlugin]: PaginationPlugin[K] extends ((...args: any[]) => any) | undefined ? K : never;
+}[keyof PaginationPlugin];
+
+declare type SafeElement = Omit<Element, 'removeChild' | 'appendChild' | 'replaceChild' | 'remove'>;
+
+declare type SafeText = Omit<Text, 'remove'>;
+
+export declare const SplitResult: {
+    readonly None: 0;
+    readonly FullNodePlaced: 1;
+    readonly SplitChildren: 2;
+};
+
+export declare type SplitResult = (typeof SplitResult)[keyof typeof SplitResult];
+
+export declare const tempContainerClassName = "pz-temp-container";
+
+declare class Transaction {
+    private _onRollback;
+    private _onCommit;
+    isActive: boolean;
+    constructor();
+    start: () => void;
+    addRollbackCallback: (callback: () => void) => void;
+    addCommitCallback: (callback: () => void) => void;
+    rollback: () => void;
+    commit: () => void;
+}
+
+export declare interface VisitContext {
+    result?: SplitResult;
+}
+
+export { }

package/dist/paprize-core.js

@@ -0,0 +1,836 @@
+const ie = "paprize", re = "pz-temp-container", xe = "pz-current-element", we = "pz-current-text", ke = "pz-ignored-element", Te = "pz-ignored-text", Pe = "pz-page", V = "data-pz-";
+let G = !1;
+const Le = () => {
+  G = !0;
+}, Ae = () => G;
+function j(n) {
+  return n.nodeType === Node.ELEMENT_NODE;
+}
+function ae(n) {
+  return n.nodeType === Node.TEXT_NODE;
+}
+function se(n) {
+  const e = n.getBoundingClientRect(), t = getComputedStyle(n), o = parseFloat(t.marginTop) || 0, i = parseFloat(t.marginBottom) || 0;
+  return e.height + o + i;
+}
+function Fe(n) {
+  n.style.visibility = "hidden", n.style.position = "absolute", n.style.left = "-9999px", n.style.top = "-9999px";
+}
+class v {
+  name;
+  defaultValue;
+  _reader;
+  constructor(e, t, o) {
+    this.name = e, this._reader = t, this.defaultValue = o;
+  }
+  read(e) {
+    return this._reader(e);
+  }
+  static createStr(e, t) {
+    return new v(e, (o) => o, t);
+  }
+  static createBool(e, t) {
+    return new v(
+      e,
+      (o) => o === "true",
+      t
+    );
+  }
+}
+const P = {
+  hyphen: v.createStr("hyphen", "-"),
+  keepOnSamePage: v.createBool("keep-on-same-page", !1),
+  hyphenationEnabled: v.createBool(
+    "hyphenation-enabled",
+    !0
+  )
+};
+function Ie(n) {
+  const e = {};
+  for (const t in n) {
+    const o = n[t];
+    if (o !== void 0) {
+      const i = P[t];
+      e[`${V}${i.name}`] = String(o);
+    }
+  }
+  return e;
+}
+const le = Object.fromEntries(
+  Object.entries(P).map(([n, e]) => [
+    n,
+    e.defaultValue
+  ])
+), M = /* @__PURE__ */ new WeakMap();
+function X(n) {
+  if (!n)
+    return {};
+  if (!(n instanceof Element))
+    return X(n?.parentNode);
+  const e = {};
+  for (const i in P) {
+    const a = P[i], s = `${V}${a.name}`, p = n.getAttribute(s);
+    p !== null && (e[i] = a.read(p));
+  }
+  const o = { ...n.parentNode ? M.get(n.parentNode) : void 0, ...e };
+  return M.set(n, o), o;
+}
+const J = {
+  plugins: [],
+  ...le
+};
+function ce(n, e) {
+  const t = X(n);
+  return { ...J, ...e, ...t };
+}
+function ue(n) {
+  return n && n.__esModule && Object.prototype.hasOwnProperty.call(n, "default") ? n.default : n;
+}
+var T = { exports: {} }, de = T.exports, D;
+function pe() {
+  return D || (D = 1, (function(n) {
+    (function(e, t) {
+      n.exports ? n.exports = t() : e.log = t();
+    })(de, function() {
+      var e = function() {
+      }, t = "undefined", o = typeof window !== t && typeof window.navigator !== t && /Trident\/|MSIE /.test(window.navigator.userAgent), i = [
+        "trace",
+        "debug",
+        "info",
+        "warn",
+        "error"
+      ], a = {}, s = null;
+      function p(l, u) {
+        var r = l[u];
+        if (typeof r.bind == "function")
+          return r.bind(l);
+        try {
+          return Function.prototype.bind.call(r, l);
+        } catch {
+          return function() {
+            return Function.prototype.apply.apply(r, [l, arguments]);
+          };
+        }
+      }
+      function K() {
+        console.log && (console.log.apply ? console.log.apply(console, arguments) : Function.prototype.apply.apply(console.log, [console, arguments])), console.trace && console.trace();
+      }
+      function Y(l) {
+        return l === "debug" && (l = "log"), typeof console === t ? !1 : l === "trace" && o ? K : console[l] !== void 0 ? p(console, l) : console.log !== void 0 ? p(console, "log") : e;
+      }
+      function y() {
+        for (var l = this.getLevel(), u = 0; u < i.length; u++) {
+          var r = i[u];
+          this[r] = u < l ? e : this.methodFactory(r, l, this.name);
+        }
+        if (this.log = this.debug, typeof console === t && l < this.levels.SILENT)
+          return "No console available for logging";
+      }
+      function Q(l) {
+        return function() {
+          typeof console !== t && (y.call(this), this[l].apply(this, arguments));
+        };
+      }
+      function Z(l, u, r) {
+        return Y(l) || Q.apply(this, arguments);
+      }
+      function B(l, u) {
+        var r = this, w, L, m, f = "loglevel";
+        typeof l == "string" ? f += ":" + l : typeof l == "symbol" && (f = void 0);
+        function te(c) {
+          var d = (i[c] || "silent").toUpperCase();
+          if (!(typeof window === t || !f)) {
+            try {
+              window.localStorage[f] = d;
+              return;
+            } catch {
+            }
+            try {
+              window.document.cookie = encodeURIComponent(f) + "=" + d + ";";
+            } catch {
+            }
+          }
+        }
+        function H() {
+          var c;
+          if (!(typeof window === t || !f)) {
+            try {
+              c = window.localStorage[f];
+            } catch {
+            }
+            if (typeof c === t)
+              try {
+                var d = window.document.cookie, k = encodeURIComponent(f), $ = d.indexOf(k + "=");
+                $ !== -1 && (c = /^([^;]+)/.exec(
+                  d.slice($ + k.length + 1)
+                )[1]);
+              } catch {
+              }
+            return r.levels[c] === void 0 && (c = void 0), c;
+          }
+        }
+        function ne() {
+          if (!(typeof window === t || !f)) {
+            try {
+              window.localStorage.removeItem(f);
+            } catch {
+            }
+            try {
+              window.document.cookie = encodeURIComponent(f) + "=; expires=Thu, 01 Jan 1970 00:00:00 UTC";
+            } catch {
+            }
+          }
+        }
+        function b(c) {
+          var d = c;
+          if (typeof d == "string" && r.levels[d.toUpperCase()] !== void 0 && (d = r.levels[d.toUpperCase()]), typeof d == "number" && d >= 0 && d <= r.levels.SILENT)
+            return d;
+          throw new TypeError("log.setLevel() called with invalid level: " + c);
+        }
+        r.name = l, r.levels = {
+          TRACE: 0,
+          DEBUG: 1,
+          INFO: 2,
+          WARN: 3,
+          ERROR: 4,
+          SILENT: 5
+        }, r.methodFactory = u || Z, r.getLevel = function() {
+          return m ?? L ?? w;
+        }, r.setLevel = function(c, d) {
+          return m = b(c), d !== !1 && te(m), y.call(r);
+        }, r.setDefaultLevel = function(c) {
+          L = b(c), H() || r.setLevel(c, !1);
+        }, r.resetLevel = function() {
+          m = null, ne(), y.call(r);
+        }, r.enableAll = function(c) {
+          r.setLevel(r.levels.TRACE, c);
+        }, r.disableAll = function(c) {
+          r.setLevel(r.levels.SILENT, c);
+        }, r.rebuild = function() {
+          if (s !== r && (w = b(s.getLevel())), y.call(r), s === r)
+            for (var c in a)
+              a[c].rebuild();
+        }, w = b(
+          s ? s.getLevel() : "WARN"
+        );
+        var W = H();
+        W != null && (m = b(W)), y.call(r);
+      }
+      s = new B(), s.getLogger = function(u) {
+        if (typeof u != "symbol" && typeof u != "string" || u === "")
+          throw new TypeError("You must supply a name when creating a logger.");
+        var r = a[u];
+        return r || (r = a[u] = new B(
+          u,
+          s.methodFactory
+        )), r;
+      };
+      var ee = typeof window !== t ? window.log : void 0;
+      return s.noConflict = function() {
+        return typeof window !== t && window.log === s && (window.log = ee), s;
+      }, s.getLoggers = function() {
+        return a;
+      }, s.default = s, s;
+    });
+  })(T)), T.exports;
+}
+var ge = pe();
+const _ = /* @__PURE__ */ ue(ge), h = _.getLogger(ie);
+h.setDefaultLevel("info");
+const A = "\x1B[46mPLUGIN\x1B[0m";
+function N(n, e, ...t) {
+  n.forEach((o) => {
+    const i = o[e];
+    if (i) {
+      h.debug(
+        A,
+        `executing plugin ${o.name}:${String(e)}`,
+        t
+      );
+      try {
+        i(...t), h.debug(
+          A,
+          `plugin ${o.name}:${String(e)} executed`,
+          t
+        );
+      } catch (a) {
+        h.debug(
+          A,
+          `plugin ${o.name}:${String(e)} failed`,
+          a
+        );
+      }
+    }
+  });
+}
+const S = {
+  Element: "element",
+  Text: "text"
+};
+class O {
+  _node;
+  _transaction;
+  type = S.Element;
+  config;
+  constructor(e, t, o) {
+    this._node = e, this._transaction = t, this.config = o;
+  }
+  appendChild(e) {
+    this._transaction.isActive && this._transaction.addRollbackCallback(() => {
+      this._node.removeChild(e.getNode());
+    }), this._node.appendChild(e.getNode());
+  }
+  clone(e) {
+    const t = this._node.cloneNode(e), o = new O(
+      t,
+      this._transaction,
+      this.config
+    );
+    return N(
+      this.config.plugins,
+      "onClone",
+      this._node,
+      o
+    ), o;
+  }
+  getHeight() {
+    return se(this._node);
+  }
+  remove() {
+    this._transaction.addCommitCallback(() => {
+      this._node.remove();
+    });
+  }
+  isEmpty() {
+    return this._node.innerHTML === "";
+  }
+  getChildrenCount() {
+    return this._node.childNodes.length;
+  }
+  getNode() {
+    return this._node;
+  }
+}
+class he {
+  _node;
+  _transaction;
+  type = S.Text;
+  config;
+  constructor(e, t, o) {
+    this._node = e, this._transaction = t, this.config = o;
+  }
+  get textContent() {
+    return this._node.textContent ?? "";
+  }
+  set textContent(e) {
+    this._node.textContent = e;
+  }
+  remove() {
+    this._transaction.addCommitCallback(() => {
+      this._node.remove();
+    });
+  }
+  getNode() {
+    return this._node;
+  }
+}
+function F(n, e, t) {
+  if (ae(n))
+    return new he(n, e, t);
+  if (j(n))
+    return new O(n, e, t);
+  throw new Error("Unsupported node type");
+}
+const C = "\x1B[106mDOM\x1B[0m";
+class fe {
+  _transaction;
+  _treeWalker;
+  _config;
+  _completed = !1;
+  _currentNode = null;
+  _previousNode = null;
+  constructor(e, t, o) {
+    this._transaction = t, this._config = o, this._treeWalker = document.createTreeWalker(
+      e,
+      NodeFilter.SHOW_ELEMENT | NodeFilter.SHOW_TEXT
+    );
+  }
+  get completed() {
+    return this._completed;
+  }
+  get currentNode() {
+    return this._currentNode;
+  }
+  get previousNode() {
+    return this._previousNode;
+  }
+  nextNode() {
+    this._treeWalker.nextNode() || (this._completed = !0), h.debug(C, "moving to next node"), this.setState();
+  }
+  nextSiblingOrParentSibling() {
+    let e = 0;
+    if (this._treeWalker.nextSibling())
+      return h.debug(C, "moving to next sibling node"), this.setState(), { parentsTraversed: e };
+    for (; this._treeWalker.parentNode(); )
+      if (e++, this._treeWalker.nextSibling())
+        return h.debug(
+          C,
+          "moving to parent sibling node, traversed:",
+          e
+        ), this.setState(), { parentsTraversed: e };
+    return this._completed = !0, { parentsTraversed: e };
+  }
+  firstChildOrNextNode() {
+    return this._treeWalker.firstChild() ? (h.debug(C, "moving to first child node"), this.setState(), { parentsTraversed: 1 }) : (this.nextNode(), { parentsTraversed: 0 });
+  }
+  setState() {
+    this._previousNode = this._currentNode, this._currentNode = F(
+      this._treeWalker.currentNode,
+      this._transaction,
+      ce(this._treeWalker.currentNode, this._config)
+    ), h.debug(C, "moved to node", {
+      currentNode: this.currentNode,
+      previousNode: this.previousNode
+    });
+  }
+}
+class me {
+  _onRollback;
+  _onCommit;
+  isActive;
+  constructor() {
+    this._onRollback = [], this._onCommit = [], this.isActive = !1;
+  }
+  start = () => {
+    if (this.isActive)
+      throw new Error("Transaction already in progress");
+    this.isActive = !0, this._onRollback = [], this._onCommit = [];
+  };
+  addRollbackCallback = (e) => {
+    this._onRollback.push(e);
+  };
+  addCommitCallback = (e) => {
+    if (!this.isActive) {
+      e();
+      return;
+    }
+    this._onCommit.push(e);
+  };
+  rollback = () => {
+    this.isActive && (this.isActive = !1, this._onRollback.forEach((e) => e()));
+  };
+  commit = () => {
+    this.isActive && (this.isActive = !1, this._onCommit.forEach((e) => e()));
+  };
+}
+const U = "\x1B[102mPAGE\x1B[0m";
+class x {
+  currentPage;
+  activeElement;
+  currentElement;
+  parentStack;
+  pageIsFull;
+  pageIndex;
+  pageHeight;
+  constructor(e, t, o, i, a, s, p) {
+    this.currentPage = e, this.activeElement = t, this.currentElement = o, this.parentStack = i, this.pageIsFull = a, this.pageIndex = s, this.pageHeight = p;
+  }
+  static create(e, t, o, i) {
+    return new x(
+      e,
+      null,
+      e,
+      t,
+      !1,
+      o,
+      i
+    );
+  }
+  clone = () => new x(
+    this.currentPage,
+    this.activeElement,
+    this.currentElement,
+    [...this.parentStack],
+    this.pageIsFull,
+    this.pageIndex,
+    this.pageHeight
+  );
+}
+class R {
+  _pageState;
+  _transaction;
+  _tempContainer;
+  _config;
+  constructor(e, t, o, i) {
+    this._tempContainer = e, this._config = i, this._transaction = o;
+    const a = R.createPageHtmlElement(
+      t.width
+    ), s = this.createNewPage(a);
+    this._pageState = x.create(s, [], 0, t.height), N(this._config.plugins, "onNewPage", this._pageState);
+  }
+  nextPage() {
+    const e = this.createNewPage(
+      this._pageState.currentPage.getNode().cloneNode(!1)
+    ), t = x.create(
+      e,
+      [],
+      this._pageState.pageIndex + 1,
+      this._pageState.pageHeight
+    );
+    this.cloneParentStackToNewPage(t), this.cleanupEmptyParent(), this._pageState = t, N(this._config.plugins, "onNewPage", this._pageState);
+  }
+  cloneParentStackToNewPage(e) {
+    for (const t of this._pageState.parentStack) {
+      const o = t.clone(!1);
+      e.currentElement.appendChild(o), e.currentElement = o, e.parentStack.push(o);
+    }
+  }
+  cleanupEmptyParent() {
+    const e = [...this._pageState.parentStack], t = () => {
+      for (let o = e.length - 1; o >= 0; o--) {
+        const i = e[o];
+        i.isEmpty() && i.remove();
+      }
+    };
+    this._transaction.addCommitCallback(t);
+  }
+  enterElement() {
+    if (!this._pageState.activeElement || this._pageState.activeElement.type !== S.Element)
+      throw new Error("Invalid state: activeElement is not an Element");
+    h.debug(
+      U,
+      "entering an element",
+      this._pageState.activeElement
+    ), this._pageState.currentElement = this._pageState.activeElement, this._pageState.parentStack.push(this._pageState.activeElement);
+  }
+  leaveElement() {
+    this._pageState.activeElement = null;
+    const e = this._pageState.parentStack.pop();
+    h.debug(U, "leaving a parent element", e);
+    const t = this._pageState.parentStack.at(-1);
+    this._pageState.currentElement = t ?? this._pageState.currentPage;
+  }
+  static createPageHtmlElement(e) {
+    const t = document.createElement("div");
+    return t.style.display = "flex", t.style.flexDirection = "column", t.style.width = `${e}px`, t.style.maxWidth = `${e}px`, t;
+  }
+  createNewPage(e) {
+    return this._tempContainer.appendChild(e), this._transaction.isActive && this._transaction.addRollbackCallback(() => {
+      this._tempContainer.removeChild(e);
+    }), F(e, this._transaction, this._config);
+  }
+  startTransaction() {
+    this._transaction.start();
+    const e = this._pageState.clone();
+    return this._transaction.addRollbackCallback(() => {
+      this._pageState = e;
+    }), this._transaction;
+  }
+  hasEmptySpace(e) {
+    return !this._pageState.pageIsFull && this._pageState.currentPage.getHeight() + (e || 1) <= this._pageState.pageHeight;
+  }
+  isOverFlow() {
+    return this._pageState.currentPage.getHeight() > this._pageState.pageHeight;
+  }
+  markPageAsFull() {
+    this._pageState.pageIsFull = !0;
+  }
+  appendChild(e, t) {
+    const o = e.clone(t);
+    return this._pageState.currentElement.appendChild(o), this._pageState.activeElement = o, o;
+  }
+  addTextNode(e) {
+    if (this._pageState.activeElement?.type === S.Text)
+      return this._pageState.activeElement;
+    const t = document.createTextNode(e), o = F(
+      t,
+      this._transaction,
+      this._config
+    );
+    return this._pageState.currentElement.appendChild(o), this._pageState.activeElement = o, o;
+  }
+}
+const g = {
+  None: 0,
+  // The node fits completely on the page, no further splitting required.
+  FullNodePlaced: 1,
+  // The entire node was placed on the page, continue with the next sibling or element.
+  SplitChildren: 2
+  // The node is too large for the page, and its children must be paginated individually.
+};
+function _e(n, e) {
+  const t = z(n, e);
+  if (t !== g.None)
+    return t;
+  const { rollback: o, commit: i } = e.startTransaction();
+  e.nextPage();
+  const a = z(n, e);
+  return a !== g.None ? (i(), a) : (o(), h.debug("Element is too big to fit on a page", n), g.None);
+}
+function z(n, e) {
+  if (e.hasEmptySpace(n.getHeight())) {
+    const o = e.appendChild(n, !0);
+    if (e.isOverFlow())
+      o.remove();
+    else
+      return g.FullNodePlaced;
+  }
+  if (n.config.keepOnSamePage || n.getChildrenCount() === 0)
+    return g.None;
+  const t = e.appendChild(n, !1);
+  return e.isOverFlow() ? (t.remove(), g.None) : g.SplitChildren;
+}
+function ve(n, e) {
+  let t = g.FullNodePlaced;
+  const o = n.textContent.split(/(\s+)/).filter((s) => s !== "");
+  let i, a = 0;
+  for (; i || a < o.length; ) {
+    const s = i ?? o[a], p = Ne(s, e, n.config);
+    p.completed || (t = g.None), p.pendingToken ? i = p.pendingToken : (i = void 0, a++);
+  }
+  return t;
+}
+function Ne(n, e, t) {
+  e.hasEmptySpace() || e.nextPage();
+  let o = e.addTextNode("");
+  const i = o.textContent;
+  if (o.textContent += n, !e.isOverFlow())
+    return {
+      completed: !0
+    };
+  o.textContent = i;
+  const a = Se(n, e, t);
+  return {
+    pendingToken: a.leftovers,
+    completed: a.completed
+  };
+}
+function Se(n, e, t) {
+  const { rollback: o, commit: i } = e.startTransaction();
+  if (e.nextPage(), e.addTextNode(n), !e.isOverFlow())
+    return i(), {
+      completed: !0
+    };
+  if (o(), !t.hyphenationEnabled)
+    return h.warn("Hyphenation disabled, skipping oversized token:", n), {
+      completed: !1
+    };
+  const a = ye(n, t.hyphen, e);
+  return {
+    completed: !0,
+    leftovers: a && a.length > 0 ? a : void 0
+  };
+}
+function ye(n, e, t) {
+  const o = t.addTextNode("");
+  let i = "";
+  for (let a = 0; a < n.length; a++) {
+    const s = n[a], p = i + s;
+    if (o.textContent = p + e, !t.hasEmptySpace())
+      return o.textContent = i ? i + e : "", t.markPageAsFull(), n.slice(a);
+    i = p;
+  }
+  return null;
+}
+const E = "\x1B[103mPAGINATOR\x1B[0m";
+class I {
+  _domState;
+  _pageManager;
+  _transaction;
+  _tempContainer;
+  _config;
+  constructor(e, t, o) {
+    this._config = { ...J, ...o }, this._tempContainer = I.createTempContainer(), this._transaction = new me(), this._domState = new fe(e, this._transaction, this._config), this._pageManager = new R(
+      this._tempContainer,
+      t,
+      this._transaction,
+      this._config
+    );
+  }
+  static createTempContainer() {
+    const e = document.createElement("div");
+    return e.classList.add(re), document.body.appendChild(e), e;
+  }
+  static paginate(e, t, o) {
+    const i = new I(e, t, o);
+    return i.processAllNodes(), Array.from(i._tempContainer.childNodes).filter((s) => j(s)).map((s) => s.innerHTML);
+  }
+  processAllNodes() {
+    this._domState.nextNode();
+    do {
+      switch (_.debug(
+        E,
+        "paginating node",
+        this._domState.currentNode
+      ), this.processCurrentNode()) {
+        case g.None:
+          this.handleNodeSkipped();
+          break;
+        case g.FullNodePlaced:
+          this.handleFullNodePlaced();
+          break;
+        case g.SplitChildren:
+          this.handleChildrenSplit();
+          break;
+      }
+      N(
+        this._config.plugins,
+        "afterVisitNode",
+        this._domState,
+        this._pageManager
+      );
+    } while (this._domState.completed === !1);
+    _.debug(E, "pagination completed");
+  }
+  handleNodeSkipped() {
+    _.debug(E, "node skipped - couldn't paginate"), this._domState.nextNode();
+  }
+  handleFullNodePlaced() {
+    _.debug(E, "node fully paginated");
+    const { parentsTraversed: e } = this._domState.nextSiblingOrParentSibling();
+    for (let t = 0; t < e; t++)
+      this._pageManager.leaveElement();
+  }
+  handleChildrenSplit() {
+    _.debug(
+      E,
+      "node partially paginated - splitting children"
+    ), this._domState.firstChildOrNextNode().parentsTraversed === 1 && this._domState.previousNode?.type === S.Element && this._pageManager.enterElement();
+  }
+  processCurrentNode() {
+    if (!this._domState.currentNode)
+      return g.None;
+    if (this._domState.currentNode.type === S.Element) {
+      const e = {};
+      return N(
+        this._config.plugins,
+        "onVisitElement",
+        this._domState,
+        this._pageManager,
+        e
+      ), e.result !== void 0 ? e.result : _e(
+        this._domState.currentNode,
+        this._pageManager
+      );
+    } else {
+      const e = {};
+      return N(
+        this._config.plugins,
+        "onVisitText",
+        this._domState,
+        this._pageManager,
+        e
+      ), e.result !== void 0 ? e.result : ve(
+        this._domState.currentNode,
+        this._pageManager
+      );
+    }
+  }
+}
+const q = [
+  "ad",
+  "adipisicing",
+  "aliqua",
+  "aliquip",
+  "amet",
+  "anim",
+  "aute",
+  "cillum",
+  "commodo",
+  "consectetur",
+  "consequat",
+  "culpa",
+  "cupidatat",
+  "deserunt",
+  "do",
+  "dolor",
+  "dolore",
+  "duis",
+  "ea",
+  "eiusmod",
+  "elit",
+  "enim",
+  "esse",
+  "est",
+  "et",
+  "eu",
+  "ex",
+  "excepteur",
+  "exercitation",
+  "fugiat",
+  "id",
+  "in",
+  "incididunt",
+  "ipsum",
+  "irure",
+  "labore",
+  "laboris",
+  "laborum",
+  "Lorem",
+  "magna",
+  "minim",
+  "mollit",
+  "nisi",
+  "non",
+  "nostrud",
+  "nulla",
+  "occaecat",
+  "officia",
+  "pariatur",
+  "proident",
+  "qui",
+  "quis",
+  "reprehenderit",
+  "sint",
+  "sit",
+  "sunt",
+  "tempor",
+  "ullamco",
+  "ut",
+  "velit",
+  "veniam",
+  "voluptate"
+];
+function Oe(n, e) {
+  if (n <= 0)
+    return "";
+  const t = [], o = Math.floor(e * 982451653);
+  for (let i = 0; i < n; i++) {
+    const a = (o + i * 2654435761) % Math.pow(2, 32), s = Math.floor(
+      a / Math.pow(2, 32) * q.length
+    );
+    t.push(q[s]);
+  }
+  return t.length > 0 && (t[0] = t[0].charAt(0).toUpperCase() + t[0].slice(1)), t.join(" ") + ".";
+}
+const be = "data-pz-page-break", Ce = "pageBreak", Ee = {
+  name: Ce,
+  onVisitElement: (n, e, t) => {
+    n.currentNode.getNode().getAttribute(be) === "true" && (e.markPageAsFull(), t.result = g.FullNodePlaced);
+  }
+}, Re = [Ee];
+export {
+  I as Paginator,
+  g as SplitResult,
+  V as attributePrefix,
+  Ie as configToAttributeMap,
+  Oe as createLoremIpsumParagraph,
+  xe as currentElementClassName,
+  we as currentTextClassName,
+  Re as defaultPlugins,
+  Le as enableDebugMode,
+  se as getVisibleHeight,
+  ke as ignoredElementClassName,
+  Te as ignoredTextClassName,
+  Ae as isDebugMode,
+  j as isElement,
+  ae as isTextNode,
+  h as logger,
+  ie as loggerName,
+  Fe as moveOffscreen,
+  be as pageBreakAttributeName,
+  Ee as pageBreakPlugin,
+  Ce as pageBreakPluginName,
+  Pe as pageClassName,
+  re as tempContainerClassName
+};

package/dist/paprize-core.umd.cjs

@@ -0,0 +1 @@
+(function(l,_){typeof exports=="object"&&typeof module<"u"?_(exports):typeof define=="function"&&define.amd?define(["exports"],_):(l=typeof globalThis<"u"?globalThis:l||self,_(l.paprize_core={}))})(this,(function(l){"use strict";const _="paprize",M="pz-temp-container",oe="pz-current-element",re="pz-current-text",ae="pz-ignored-element",se="pz-ignored-text",le="pz-page",I="data-pz-";let D=!1;const ce=()=>{D=!0},ue=()=>D;function O(n){return n.nodeType===Node.ELEMENT_NODE}function z(n){return n.nodeType===Node.TEXT_NODE}function U(n){const e=n.getBoundingClientRect(),t=getComputedStyle(n),i=parseFloat(t.marginTop)||0,o=parseFloat(t.marginBottom)||0;return e.height+i+o}function de(n){n.style.visibility="hidden",n.style.position="absolute",n.style.left="-9999px",n.style.top="-9999px"}class v{name;defaultValue;_reader;constructor(e,t,i){this.name=e,this._reader=t,this.defaultValue=i}read(e){return this._reader(e)}static createStr(e,t){return new v(e,i=>i,t)}static createBool(e,t){return new v(e,i=>i==="true",t)}}const T={hyphen:v.createStr("hyphen","-"),keepOnSamePage:v.createBool("keep-on-same-page",!1),hyphenationEnabled:v.createBool("hyphenation-enabled",!0)};function ge(n){const e={};for(const t in n){const i=n[t];if(i!==void 0){const o=T[t];e[`${I}${o.name}`]=String(i)}}return e}const pe=Object.fromEntries(Object.entries(T).map(([n,e])=>[n,e.defaultValue])),V=new WeakMap;function q(n){if(!n)return{};if(!(n instanceof Element))return q(n?.parentNode);const e={};for(const o in T){const a=T[o],s=`${I}${a.name}`,f=n.getAttribute(s);f!==null&&(e[o]=a.read(f))}const i={...n.parentNode?V.get(n.parentNode):void 0,...e};return V.set(n,i),i}const j={plugins:[],...pe};function he(n,e){const t=q(n);return{...j,...e,...t}}function fe(n){return n&&n.__esModule&&Object.prototype.hasOwnProperty.call(n,"default")?n.default:n}var P={exports:{}},me=P.exports,G;function _e(){return G||(G=1,(function(n){(function(e,t){n.exports?n.exports=t():e.log=t()})(me,function(){var e=function(){},t="undefined",i=typeof window!==t&&typeof window.navigator!==t&&/Trident\/|MSIE /.test(window.navigator.userAgent),o=["trace","debug","info","warn","error"],a={},s=null;function f(c,d){var r=c[d];if(typeof r.bind=="function")return r.bind(c);try{return Function.prototype.bind.call(r,c)}catch{return function(){return Function.prototype.apply.apply(r,[c,arguments])}}}function Pe(){console.log&&(console.log.apply?console.log.apply(console,arguments):Function.prototype.apply.apply(console.log,[console,arguments])),console.trace&&console.trace()}function Le(c){return c==="debug"&&(c="log"),typeof console===t?!1:c==="trace"&&i?Pe:console[c]!==void 0?f(console,c):console.log!==void 0?f(console,"log"):e}function k(){for(var c=this.getLevel(),d=0;d<o.length;d++){var r=o[d];this[r]=d<c?e:this.methodFactory(r,c,this.name)}if(this.log=this.debug,typeof console===t&&c<this.levels.SILENT)return"No console available for logging"}function Ae(c){return function(){typeof console!==t&&(k.call(this),this[c].apply(this,arguments))}}function Fe(c,d,r){return Le(c)||Ae.apply(this,arguments)}function ee(c,d){var r=this,A,$,y,m="loglevel";typeof c=="string"?m+=":"+c:typeof c=="symbol"&&(m=void 0);function Oe(u){var g=(o[u]||"silent").toUpperCase();if(!(typeof window===t||!m)){try{window.localStorage[m]=g;return}catch{}try{window.document.cookie=encodeURIComponent(m)+"="+g+";"}catch{}}}function te(){var u;if(!(typeof window===t||!m)){try{u=window.localStorage[m]}catch{}if(typeof u===t)try{var g=window.document.cookie,F=encodeURIComponent(m),ie=g.indexOf(F+"=");ie!==-1&&(u=/^([^;]+)/.exec(g.slice(ie+F.length+1))[1])}catch{}return r.levels[u]===void 0&&(u=void 0),u}}function Re(){if(!(typeof window===t||!m)){try{window.localStorage.removeItem(m)}catch{}try{window.document.cookie=encodeURIComponent(m)+"=; expires=Thu, 01 Jan 1970 00:00:00 UTC"}catch{}}}function x(u){var g=u;if(typeof g=="string"&&r.levels[g.toUpperCase()]!==void 0&&(g=r.levels[g.toUpperCase()]),typeof g=="number"&&g>=0&&g<=r.levels.SILENT)return g;throw new TypeError("log.setLevel() called with invalid level: "+u)}r.name=c,r.levels={TRACE:0,DEBUG:1,INFO:2,WARN:3,ERROR:4,SILENT:5},r.methodFactory=d||Fe,r.getLevel=function(){return y??$??A},r.setLevel=function(u,g){return y=x(u),g!==!1&&Oe(y),k.call(r)},r.setDefaultLevel=function(u){$=x(u),te()||r.setLevel(u,!1)},r.resetLevel=function(){y=null,Re(),k.call(r)},r.enableAll=function(u){r.setLevel(r.levels.TRACE,u)},r.disableAll=function(u){r.setLevel(r.levels.SILENT,u)},r.rebuild=function(){if(s!==r&&(A=x(s.getLevel())),k.call(r),s===r)for(var u in a)a[u].rebuild()},A=x(s?s.getLevel():"WARN");var ne=te();ne!=null&&(y=x(ne)),k.call(r)}s=new ee,s.getLogger=function(d){if(typeof d!="symbol"&&typeof d!="string"||d==="")throw new TypeError("You must supply a name when creating a logger.");var r=a[d];return r||(r=a[d]=new ee(d,s.methodFactory)),r};var Ie=typeof window!==t?window.log:void 0;return s.noConflict=function(){return typeof window!==t&&window.log===s&&(window.log=Ie),s},s.getLoggers=function(){return a},s.default=s,s})})(P)),P.exports}var ve=_e();const N=fe(ve),h=N.getLogger(_);h.setDefaultLevel("info");const R="\x1B[46mPLUGIN\x1B[0m";function S(n,e,...t){n.forEach(i=>{const o=i[e];if(o){h.debug(R,`executing plugin ${i.name}:${String(e)}`,t);try{o(...t),h.debug(R,`plugin ${i.name}:${String(e)} executed`,t)}catch(a){h.debug(R,`plugin ${i.name}:${String(e)} failed`,a)}}})}const b={Element:"element",Text:"text"};class B{_node;_transaction;type=b.Element;config;constructor(e,t,i){this._node=e,this._transaction=t,this.config=i}appendChild(e){this._transaction.isActive&&this._transaction.addRollbackCallback(()=>{this._node.removeChild(e.getNode())}),this._node.appendChild(e.getNode())}clone(e){const t=this._node.cloneNode(e),i=new B(t,this._transaction,this.config);return S(this.config.plugins,"onClone",this._node,i),i}getHeight(){return U(this._node)}remove(){this._transaction.addCommitCallback(()=>{this._node.remove()})}isEmpty(){return this._node.innerHTML===""}getChildrenCount(){return this._node.childNodes.length}getNode(){return this._node}}class Ne{_node;_transaction;type=b.Text;config;constructor(e,t,i){this._node=e,this._transaction=t,this.config=i}get textContent(){return this._node.textContent??""}set textContent(e){this._node.textContent=e}remove(){this._transaction.addCommitCallback(()=>{this._node.remove()})}getNode(){return this._node}}function H(n,e,t){if(z(n))return new Ne(n,e,t);if(O(n))return new B(n,e,t);throw new Error("Unsupported node type")}const C="\x1B[106mDOM\x1B[0m";class Se{_transaction;_treeWalker;_config;_completed=!1;_currentNode=null;_previousNode=null;constructor(e,t,i){this._transaction=t,this._config=i,this._treeWalker=document.createTreeWalker(e,NodeFilter.SHOW_ELEMENT|NodeFilter.SHOW_TEXT)}get completed(){return this._completed}get currentNode(){return this._currentNode}get previousNode(){return this._previousNode}nextNode(){this._treeWalker.nextNode()||(this._completed=!0),h.debug(C,"moving to next node"),this.setState()}nextSiblingOrParentSibling(){let e=0;if(this._treeWalker.nextSibling())return h.debug(C,"moving to next sibling node"),this.setState(),{parentsTraversed:e};for(;this._treeWalker.parentNode();)if(e++,this._treeWalker.nextSibling())return h.debug(C,"moving to parent sibling node, traversed:",e),this.setState(),{parentsTraversed:e};return this._completed=!0,{parentsTraversed:e}}firstChildOrNextNode(){return this._treeWalker.firstChild()?(h.debug(C,"moving to first child node"),this.setState(),{parentsTraversed:1}):(this.nextNode(),{parentsTraversed:0})}setState(){this._previousNode=this._currentNode,this._currentNode=H(this._treeWalker.currentNode,this._transaction,he(this._treeWalker.currentNode,this._config)),h.debug(C,"moved to node",{currentNode:this.currentNode,previousNode:this.previousNode})}}class be{_onRollback;_onCommit;isActive;constructor(){this._onRollback=[],this._onCommit=[],this.isActive=!1}start=()=>{if(this.isActive)throw new Error("Transaction already in progress");this.isActive=!0,this._onRollback=[],this._onCommit=[]};addRollbackCallback=e=>{this._onRollback.push(e)};addCommitCallback=e=>{if(!this.isActive){e();return}this._onCommit.push(e)};rollback=()=>{this.isActive&&(this.isActive=!1,this._onRollback.forEach(e=>e()))};commit=()=>{this.isActive&&(this.isActive=!1,this._onCommit.forEach(e=>e()))}}const X="\x1B[102mPAGE\x1B[0m";class E{currentPage;activeElement;currentElement;parentStack;pageIsFull;pageIndex;pageHeight;constructor(e,t,i,o,a,s,f){this.currentPage=e,this.activeElement=t,this.currentElement=i,this.parentStack=o,this.pageIsFull=a,this.pageIndex=s,this.pageHeight=f}static create(e,t,i,o){return new E(e,null,e,t,!1,i,o)}clone=()=>new E(this.currentPage,this.activeElement,this.currentElement,[...this.parentStack],this.pageIsFull,this.pageIndex,this.pageHeight)}class W{_pageState;_transaction;_tempContainer;_config;constructor(e,t,i,o){this._tempContainer=e,this._config=o,this._transaction=i;const a=W.createPageHtmlElement(t.width),s=this.createNewPage(a);this._pageState=E.create(s,[],0,t.height),S(this._config.plugins,"onNewPage",this._pageState)}nextPage(){const e=this.createNewPage(this._pageState.currentPage.getNode().cloneNode(!1)),t=E.create(e,[],this._pageState.pageIndex+1,this._pageState.pageHeight);this.cloneParentStackToNewPage(t),this.cleanupEmptyParent(),this._pageState=t,S(this._config.plugins,"onNewPage",this._pageState)}cloneParentStackToNewPage(e){for(const t of this._pageState.parentStack){const i=t.clone(!1);e.currentElement.appendChild(i),e.currentElement=i,e.parentStack.push(i)}}cleanupEmptyParent(){const e=[...this._pageState.parentStack],t=()=>{for(let i=e.length-1;i>=0;i--){const o=e[i];o.isEmpty()&&o.remove()}};this._transaction.addCommitCallback(t)}enterElement(){if(!this._pageState.activeElement||this._pageState.activeElement.type!==b.Element)throw new Error("Invalid state: activeElement is not an Element");h.debug(X,"entering an element",this._pageState.activeElement),this._pageState.currentElement=this._pageState.activeElement,this._pageState.parentStack.push(this._pageState.activeElement)}leaveElement(){this._pageState.activeElement=null;const e=this._pageState.parentStack.pop();h.debug(X,"leaving a parent element",e);const t=this._pageState.parentStack.at(-1);this._pageState.currentElement=t??this._pageState.currentPage}static createPageHtmlElement(e){const t=document.createElement("div");return t.style.display="flex",t.style.flexDirection="column",t.style.width=`${e}px`,t.style.maxWidth=`${e}px`,t}createNewPage(e){return this._tempContainer.appendChild(e),this._transaction.isActive&&this._transaction.addRollbackCallback(()=>{this._tempContainer.removeChild(e)}),H(e,this._transaction,this._config)}startTransaction(){this._transaction.start();const e=this._pageState.clone();return this._transaction.addRollbackCallback(()=>{this._pageState=e}),this._transaction}hasEmptySpace(e){return!this._pageState.pageIsFull&&this._pageState.currentPage.getHeight()+(e||1)<=this._pageState.pageHeight}isOverFlow(){return this._pageState.currentPage.getHeight()>this._pageState.pageHeight}markPageAsFull(){this._pageState.pageIsFull=!0}appendChild(e,t){const i=e.clone(t);return this._pageState.currentElement.appendChild(i),this._pageState.activeElement=i,i}addTextNode(e){if(this._pageState.activeElement?.type===b.Text)return this._pageState.activeElement;const t=document.createTextNode(e),i=H(t,this._transaction,this._config);return this._pageState.currentElement.appendChild(i),this._pageState.activeElement=i,i}}const p={None:0,FullNodePlaced:1,SplitChildren:2};function ye(n,e){const t=J(n,e);if(t!==p.None)return t;const{rollback:i,commit:o}=e.startTransaction();e.nextPage();const a=J(n,e);return a!==p.None?(o(),a):(i(),h.debug("Element is too big to fit on a page",n),p.None)}function J(n,e){if(e.hasEmptySpace(n.getHeight())){const i=e.appendChild(n,!0);if(e.isOverFlow())i.remove();else return p.FullNodePlaced}if(n.config.keepOnSamePage||n.getChildrenCount()===0)return p.None;const t=e.appendChild(n,!1);return e.isOverFlow()?(t.remove(),p.None):p.SplitChildren}function Ce(n,e){let t=p.FullNodePlaced;const i=n.textContent.split(/(\s+)/).filter(s=>s!=="");let o,a=0;for(;o||a<i.length;){const s=o??i[a],f=Ee(s,e,n.config);f.completed||(t=p.None),f.pendingToken?o=f.pendingToken:(o=void 0,a++)}return t}function Ee(n,e,t){e.hasEmptySpace()||e.nextPage();let i=e.addTextNode("");const o=i.textContent;if(i.textContent+=n,!e.isOverFlow())return{completed:!0};i.textContent=o;const a=we(n,e,t);return{pendingToken:a.leftovers,completed:a.completed}}function we(n,e,t){const{rollback:i,commit:o}=e.startTransaction();if(e.nextPage(),e.addTextNode(n),!e.isOverFlow())return o(),{completed:!0};if(i(),!t.hyphenationEnabled)return h.warn("Hyphenation disabled, skipping oversized token:",n),{completed:!1};const a=ke(n,t.hyphen,e);return{completed:!0,leftovers:a&&a.length>0?a:void 0}}function ke(n,e,t){const i=t.addTextNode("");let o="";for(let a=0;a<n.length;a++){const s=n[a],f=o+s;if(i.textContent=f+e,!t.hasEmptySpace())return i.textContent=o?o+e:"",t.markPageAsFull(),n.slice(a);o=f}return null}const w="\x1B[103mPAGINATOR\x1B[0m";class L{_domState;_pageManager;_transaction;_tempContainer;_config;constructor(e,t,i){this._config={...j,...i},this._tempContainer=L.createTempContainer(),this._transaction=new be,this._domState=new Se(e,this._transaction,this._config),this._pageManager=new W(this._tempContainer,t,this._transaction,this._config)}static createTempContainer(){const e=document.createElement("div");return e.classList.add(M),document.body.appendChild(e),e}static paginate(e,t,i){const o=new L(e,t,i);return o.processAllNodes(),Array.from(o._tempContainer.childNodes).filter(s=>O(s)).map(s=>s.innerHTML)}processAllNodes(){this._domState.nextNode();do{switch(N.debug(w,"paginating node",this._domState.currentNode),this.processCurrentNode()){case p.None:this.handleNodeSkipped();break;case p.FullNodePlaced:this.handleFullNodePlaced();break;case p.SplitChildren:this.handleChildrenSplit();break}S(this._config.plugins,"afterVisitNode",this._domState,this._pageManager)}while(this._domState.completed===!1);N.debug(w,"pagination completed")}handleNodeSkipped(){N.debug(w,"node skipped - couldn't paginate"),this._domState.nextNode()}handleFullNodePlaced(){N.debug(w,"node fully paginated");const{parentsTraversed:e}=this._domState.nextSiblingOrParentSibling();for(let t=0;t<e;t++)this._pageManager.leaveElement()}handleChildrenSplit(){N.debug(w,"node partially paginated - splitting children"),this._domState.firstChildOrNextNode().parentsTraversed===1&&this._domState.previousNode?.type===b.Element&&this._pageManager.enterElement()}processCurrentNode(){if(!this._domState.currentNode)return p.None;if(this._domState.currentNode.type===b.Element){const e={};return S(this._config.plugins,"onVisitElement",this._domState,this._pageManager,e),e.result!==void 0?e.result:ye(this._domState.currentNode,this._pageManager)}else{const e={};return S(this._config.plugins,"onVisitText",this._domState,this._pageManager,e),e.result!==void 0?e.result:Ce(this._domState.currentNode,this._pageManager)}}}const K=["ad","adipisicing","aliqua","aliquip","amet","anim","aute","cillum","commodo","consectetur","consequat","culpa","cupidatat","deserunt","do","dolor","dolore","duis","ea","eiusmod","elit","enim","esse","est","et","eu","ex","excepteur","exercitation","fugiat","id","in","incididunt","ipsum","irure","labore","laboris","laborum","Lorem","magna","minim","mollit","nisi","non","nostrud","nulla","occaecat","officia","pariatur","proident","qui","quis","reprehenderit","sint","sit","sunt","tempor","ullamco","ut","velit","veniam","voluptate"];function xe(n,e){if(n<=0)return"";const t=[],i=Math.floor(e*982451653);for(let o=0;o<n;o++){const a=(i+o*2654435761)%Math.pow(2,32),s=Math.floor(a/Math.pow(2,32)*K.length);t.push(K[s])}return t.length>0&&(t[0]=t[0].charAt(0).toUpperCase()+t[0].slice(1)),t.join(" ")+"."}const Y="data-pz-page-break",Q="pageBreak",Z={name:Q,onVisitElement:(n,e,t)=>{n.currentNode.getNode().getAttribute(Y)==="true"&&(e.markPageAsFull(),t.result=p.FullNodePlaced)}},Te=[Z];l.Paginator=L,l.SplitResult=p,l.attributePrefix=I,l.configToAttributeMap=ge,l.createLoremIpsumParagraph=xe,l.currentElementClassName=oe,l.currentTextClassName=re,l.defaultPlugins=Te,l.enableDebugMode=ce,l.getVisibleHeight=U,l.ignoredElementClassName=ae,l.ignoredTextClassName=se,l.isDebugMode=ue,l.isElement=O,l.isTextNode=z,l.logger=h,l.loggerName=_,l.moveOffscreen=de,l.pageBreakAttributeName=Y,l.pageBreakPlugin=Z,l.pageBreakPluginName=Q,l.pageClassName=le,l.tempContainerClassName=M,Object.defineProperty(l,Symbol.toStringTag,{value:"Module"})}));

package/package.json

@@ -0,0 +1,63 @@
+{
+    "name": "@paprize/core",
+    "version": "0.0.1",
+    "description": "Paginate DOM elements for professional, print-ready reports",
+    "type": "module",
+    "files": [
+        "dist",
+        "CHANGELOG.md"
+    ],
+    "main": "./dist/paprize-core.umd.cjs",
+    "module": "./dist/paprize-core.js",
+    "exports": {
+        ".": {
+            "types": "./dist/paprize-core.d.ts",
+            "import": "./dist/paprize-core.js",
+            "require": "./dist/paprize-core.umd.cjs"
+        },
+        "./src": {
+            "types": "./src/index.ts",
+            "import": "./src/index.ts"
+        },
+        "./src/debug-styles.css": "./src/debugUtilities/styles.css"
+    },
+    "keywords": [
+        "paper",
+        "print",
+        "report",
+        "html2pdf",
+        "pdf"
+    ],
+    "homepage": "https://github.com/PejmanNik/paprize#readme",
+    "bugs": {
+        "url": "https://github.com/PejmanNik/paprize/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/PejmanNik/paprize.git"
+    },
+    "license": "Apache-2.0",
+    "author": "PejmanNikram",
+    "scripts": {
+        "dev": "vite",
+        "test": "vitest",
+        "coverage": "vitest run --coverage",
+        "build": "tsc && vite build",
+        "preview": "vite preview",
+        "prepack": "node ../../scripts/prepack.mjs"
+    },
+    "devDependencies": {
+        "@microsoft/api-extractor": "^7.52.10",
+        "@vitest/coverage-v8": "^3.2.4",
+        "happy-dom": "^18.0.1",
+        "preact": "^10.27.0",
+        "typescript": "~5.8.3",
+        "unplugin-dts": "^1.0.0-beta.6",
+        "vite": "^7.0.4",
+        "vite-plugin-checker": "^0.10.2",
+        "vitest": "^3.2.4"
+    },
+    "dependencies": {
+        "loglevel": "^1.9.2"
+    }
+}