@shadow-garden/bapbong-layout-engine 0.1.0

package/dist/lib/layout-engine.d.ts

@@ -0,0 +1,73 @@
+import { Node as PMNode } from 'prosemirror-model';
+import type { FlowBlock, FontSpec, LayoutConfig, LayoutImageSegment, LayoutSegment, ResolvedLayout, ResolvedTable } from '@shadow-garden/bapbong-contracts';
+/** Flatten a ProseMirror doc into FlowBlocks (paragraphs + tables). */
+export declare function toFlowBlocks(doc: PMNode, defaultFont?: Partial<FontSpec>, allowFloats?: boolean): FlowBlock[];
+/** A laid-out line whose vertical position is not yet assigned (the page/cell
+ *  placer fills in `y`). */
+interface LineDraft {
+    x: number;
+    width: number;
+    height: number;
+    baseline: number;
+    segments: LayoutSegment[];
+    images: LayoutImageSegment[];
+    from?: number;
+    to?: number;
+}
+/** Lay out already-flattened blocks into paginated pages. Pure (no DOM);
+ *  measurement is injected. */
+export declare function layoutBlocks(blocks: FlowBlock[], config: LayoutConfig): ResolvedLayout;
+interface ParagraphCacheEntry {
+    left: number;
+    right: number;
+    /** Content-start position the cached drafts were computed at. */
+    basePos: number;
+    /** List marker the drafts were computed with — renumbering invalidates. */
+    marker?: string;
+    drafts: LineDraft[];
+}
+interface TableCacheEntry {
+    left: number;
+    right: number;
+    /** Table node position the cached layout was computed at. */
+    basePos: number;
+    /** Canonical layout (y = 0, column-0 x, positions at basePos). Cloned per
+     *  paint so the placer can mutate (offset/shift/split) without corrupting it. */
+    table: ResolvedTable;
+}
+/**
+ * Layout cache keyed on ProseMirror node identity (PM keeps unchanged nodes
+ * identical across transactions). An unchanged paragraph/table skips
+ * measuring/wrapping entirely; one that merely moved gets its positions
+ * shifted. Tables that host list paragraphs are not cached (they advance the
+ * live numbering counter).
+ */
+export declare class LayoutCache {
+    readonly paragraphs: WeakMap<PMNode, ParagraphCacheEntry>;
+    readonly tables: WeakMap<PMNode, TableCacheEntry>;
+}
+export declare function createLayoutCache(): LayoutCache;
+/** Repeating page furniture passed alongside the body document. `header`/
+ *  `footer` are the default (odd-page) bands; the `*First`/`*Even` variants
+ *  apply on page 1 (when `titlePg`) and even pages (when `evenAndOdd`). */
+export interface PageChrome {
+    header?: PMNode;
+    footer?: PMNode;
+    headerFirst?: PMNode;
+    footerFirst?: PMNode;
+    headerEven?: PMNode;
+    footerEven?: PMNode;
+    /** w:titlePg — page 1 uses the first variant (blank if none declared). */
+    titlePg?: boolean;
+    /** w:evenAndOddHeaders — even pages use the even variant (blank if none). */
+    evenAndOdd?: boolean;
+}
+/** Lay out a ProseMirror document into paint-ready pages. With a `cache`,
+ *  only paragraphs whose node changed since the previous call are re-measured.
+ *  `chrome` (page header/footer documents) repeats on every page; the body
+ *  band shrinks when a chrome band is taller than the page margin. `footnotes`
+ *  (note bodies keyed by display number) are laid out at the bottom of the page
+ *  their reference falls on. */
+export declare function layout(doc: PMNode, config: LayoutConfig, cache?: LayoutCache, chrome?: PageChrome, footnotes?: Record<number, PMNode>): ResolvedLayout;
+export {};
+//# sourceMappingURL=layout-engine.d.ts.map

package/dist/lib/layout-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-engine.d.ts","sourceRoot":"","sources":["../../src/lib/layout-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,IAAI,IAAI,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMzD,OAAO,KAAK,EAIV,SAAS,EAOT,QAAQ,EAIR,YAAY,EACZ,kBAAkB,EAElB,aAAa,EASb,cAAc,EAEd,aAAa,EAId,MAAM,kCAAkC,CAAC;AA8Q1C,uEAAuE;AACvE,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,OAAO,CAAC,QAAQ,CAAM,EACnC,WAAW,UAAO,GACjB,SAAS,EAAE,CASb;AAmGD;4BAC4B;AAC5B,UAAU,SAAS;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAiyCD;+BAC+B;AAC/B,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,cAAc,CA0BtF;AAuBD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB;qFACiF;IACjF,KAAK,EAAE,aAAa,CAAC;CACtB;AA6CD;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,UAAU,uCAA8C;IACjE,QAAQ,CAAC,MAAM,mCAA0C;CAC1D;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAKD;;2EAE2E;AAC3E,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAgGD;;;;;gCAKgC;AAChC,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,UAAU,EACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,cAAc,CAqIhB"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@shadow-garden/bapbong-layout-engine",
+  "version": "0.1.0",
+  "description": "bapbong — line-breaking + pagination: ProseMirror doc → ResolvedLayout",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shadowgarden-app/bapbong.git",
+    "directory": "packages/layout-engine"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@shadow-garden/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "nx": {
+    "tags": [
+      "scope:engine"
+    ],
+    "targets": {
+      "build": {
+        "executor": "@nx/esbuild:esbuild",
+        "outputs": [
+          "{options.outputPath}"
+        ],
+        "options": {
+          "outputPath": "packages/layout-engine/dist",
+          "main": "packages/layout-engine/src/index.ts",
+          "tsConfig": "packages/layout-engine/tsconfig.lib.json",
+          "format": [
+            "esm",
+            "cjs"
+          ],
+          "declarationRootDir": "packages/layout-engine/src",
+          "external": [
+            "@shadow-garden/bapbong-contracts",
+            "@shadow-garden/bapbong-model"
+          ]
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "prosemirror-model": "^1.25.7",
+    "@shadow-garden/bapbong-contracts": "^0.1.0",
+    "@shadow-garden/bapbong-model": "^0.1.0"
+  }
+}