@shadow-garden/bapbong-view 0.1.0

package/dist/lib/render-core.d.ts

@@ -0,0 +1,147 @@
+import { Node as ProseMirrorNode, Schema } from 'prosemirror-model';
+import type { CaretRect, MeasureMetrics, MeasureText, PagePoint, RangeDecoration, ResolvedLayout, SelectionRect } from '@shadow-garden/bapbong-contracts';
+export interface RenderCoreOptions {
+    /** The scroll viewport the page stack lives in (used for virtualization and
+     *  scroll-into-view). Defaults to `stack.closest('.canvas-wrap')`. */
+    viewport?: HTMLElement;
+    /** Initial zoom factor (1 = 100%). */
+    zoom?: number;
+    /** Build a visually-hidden ARIA mirror of the document for screen readers
+     *  (the canvas is opaque to assistive tech). Default true; pass false to opt
+     *  out. `a11yLabel` sets its `aria-label`. */
+    a11y?: boolean;
+    a11yLabel?: string;
+    /** Text-width measurer. Defaults to a canvas-backed one (browser). Inject an
+     *  engine-independent measurer (e.g. font-file metrics) to make wrapping and
+     *  pagination deterministic across WebView engines / headless. */
+    measureText?: MeasureText;
+    /** Vertical-metrics provider, paired with {@link measureText}. Defaults to a
+     *  canvas-backed one. */
+    measureMetrics?: MeasureMetrics;
+}
+/** Caret + selection to paint on the overlay layer (page-local geometry). */
+export interface Overlay {
+    caret?: CaretRect | null;
+    selection?: SelectionRect[];
+}
+/**
+ * The render half of bapbong, with **no editing**: import → layout → paint →
+ * scroll/zoom/virtualize, plus the geometry queries (`caretRect`, `hitTest`,
+ * `pageToCanvas`, …) the editor and viewer both need.
+ *
+ * It holds a **read-only ProseMirror doc** (a `Node`, not an `EditorState`) and
+ * knows nothing about the input-bridge / editing. The {@link BapbongView}
+ * viewer uses it directly; `BapbongEditor` composes it and feeds it a fresh doc
+ * (plus a caret/selection overlay) on every transaction — so layout/paint live
+ * in exactly one place.
+ */
+export declare class RenderCore {
+    readonly stack: HTMLElement;
+    private readonly viewport;
+    private readonly painter;
+    private readonly measureText;
+    private readonly measureMetrics;
+    private resolved;
+    private doc;
+    private zoomFactor;
+    private chromeHeaders;
+    private chromeFooters;
+    private chromeTitlePg;
+    private chromeEvenAndOdd;
+    private footnotes;
+    private importedRaw;
+    private docSchema;
+    private page;
+    private layoutCache;
+    private lastOverlay;
+    private decorationProvider;
+    private scrollRaf;
+    private docFamilies;
+    private fontRelayoutTimer;
+    private readonly fontsListeners;
+    private readonly a11y;
+    constructor(stack: HTMLElement, opts?: RenderCoreOptions);
+    /** The current read-only document, or null before the first load. */
+    get document(): ProseMirrorNode | null;
+    /** The resolved layout for the current doc, or null. */
+    get layout(): ResolvedLayout | null;
+    /** Number of laid-out pages (0 before the first document). */
+    get pageCount(): number;
+    /** The document schema in use (model's base, or a caller-supplied extension). */
+    get schema(): Schema;
+    /** Resolve doc-range decorations to page rects on each content paint. */
+    setDecorationProvider(fn: (() => RangeDecoration[]) | null): void;
+    /**
+     * Import a `.docx`, lay it out, and (by default) paint the first frame. Pass
+     * `{ schema }` to import against an extended schema (e.g. plugin marks);
+     * `{ paint: false }` to skip the initial paint (the editor paints with a caret
+     * overlay itself). Resolves with the doc + imported page-chrome keys.
+     */
+    loadDocx(bytes: ArrayBuffer, opts?: {
+        schema?: Schema;
+        paint?: boolean;
+    }): Promise<{
+        doc: ProseMirrorNode;
+        headerKeys: string[];
+        footerKeys: string[];
+    }>;
+    /** Export the current document to .docx bytes, carrying the imported source
+     *  package so unmodelled parts survive the round-trip. */
+    exportDocx(): Promise<Uint8Array>;
+    /** Lay out (or re-lay, incrementally) `doc` and store it. Does not paint. */
+    layoutDoc(doc: ProseMirrorNode): void;
+    /** Full content repaint, virtualized to the scroll viewport. Pass an overlay
+     *  to update the caret/selection painted on top (kept for later repaints). */
+    paintContent(overlay?: Overlay): void;
+    /** Redraw only the caret/selection overlay (just the affected page canvases —
+     *  used for caret blink, drag preview, selection-only changes). */
+    paintOverlay(overlay: Overlay): void;
+    /** Set the zoom factor (1 = 100%) and repaint content at the new scale. */
+    setZoom(zoom: number): void;
+    /** The current zoom factor. */
+    getZoom(): number;
+    /**
+     * Print the whole document. The live canvas is virtualized (only visible
+     * pages exist), so this renders **every** page with a throwaway painter,
+     * snapshots each to a PNG, and prints one image per sheet via a hidden iframe
+     * (clean pagination, the live view untouched).
+     */
+    print(): Promise<void>;
+    /** Gather decorations from the provider and resolve each doc range to
+     *  page-local rects the painter can fill directly. */
+    private collectDecorations;
+    /** Caret geometry at a doc position (page-local), or null. */
+    caretRect(pos: number): CaretRect | null;
+    /** Selection highlight rects for a doc range (page-local). */
+    selectionRects(from: number, to: number): SelectionRect[];
+    /** The doc position one line above/below `head` at horizontal `x`, or null. */
+    verticalCaret(head: number, dir: -1 | 1, x: number): number | null;
+    /** Map client (viewport) coords to a page-local point, or null. */
+    clientToPage(clientX: number, clientY: number): PagePoint | null;
+    /** The doc position under a page-local point, or null. */
+    posAtPoint(point: PagePoint): number | null;
+    /** The doc position under a pointer/mouse event, or null. */
+    posAtEvent(ev: {
+        clientX: number;
+        clientY: number;
+    }): number | null;
+    /** Map a page-local point to container (canvas-stack) coordinates, or null. */
+    pageToCanvas(p: PagePoint): {
+        x: number;
+        y: number;
+    } | null;
+    /** Scroll the viewport so the caret at `pos` sits `topMargin` px from the top. */
+    scrollToPos(pos: number, topMargin?: number): void;
+    /** The viewport's window onto the page stack, in container CSS px. */
+    private currentViewport;
+    /** Subscribe to late-font relayouts (page geometry changed → recompute any
+     *  caret/selection rects you hold). Returns an unsubscribe fn. */
+    onFontsReloaded(cb: () => void): () => void;
+    destroy(): void;
+    /** Repaint newly visible pages while scrolling (rAF-throttled). */
+    private onScroll;
+    private onFontsLoaded;
+}
+/** Every fontFamily mark in the given documents, plus the engine default. */
+export declare function collectFontFamilies(...docs: (ProseMirrorNode | undefined)[]): string[];
+//# sourceMappingURL=render-core.d.ts.map

package/dist/lib/render-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-core.d.ts","sourceRoot":"","sources":["../../src/lib/render-core.ts"],"names":[],"mappings":"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"}

package/dist/lib/viewer-selection.d.ts

@@ -0,0 +1,32 @@
+import type { RenderCore } from './render-core.js';
+/**
+ * Read-only text selection for {@link BapbongView}. A canvas paints text as
+ * pixels — there is nothing to drag-select — so this mirrors the editor's
+ * approach: hit-test the pointer to document positions, paint the selection
+ * rects on the canvas overlay (same geometry the painter uses, so it aligns
+ * exactly at any zoom), and copy the selected text from the document model.
+ *
+ * No input-bridge / ProseMirror editing is involved — it only reads the doc and
+ * the layout the {@link RenderCore} already holds. (The sr-only ARIA mirror is a
+ * separate concern: it serves screen readers, not mouse selection.)
+ */
+export declare class ViewerSelection {
+    private readonly core;
+    private anchor;
+    private head;
+    private dragging;
+    constructor(core: RenderCore);
+    /** Drop any current selection (e.g. when a new document loads). */
+    clear(): void;
+    destroy(): void;
+    private onDown;
+    private onMove;
+    private onUp;
+    /** Double-click selects the word under the pointer. */
+    private onDblClick;
+    private onKey;
+    private range;
+    private paint;
+    private selectedText;
+}
+//# sourceMappingURL=viewer-selection.d.ts.map

package/dist/lib/viewer-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-selection.d.ts","sourceRoot":"","sources":["../../src/lib/viewer-selection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAKd,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,QAAQ,CAAS;gBAEI,IAAI,EAAE,UAAU;IAc7C,mEAAmE;IACnE,KAAK,IAAI,IAAI;IAMb,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,MAAM,CAcZ;IAEF,OAAO,CAAC,MAAM,CAQZ;IAEF,OAAO,CAAC,IAAI,CAEV;IAEF,uDAAuD;IACvD,OAAO,CAAC,UAAU,CAUhB;IAIF,OAAO,CAAC,KAAK,CAmBX;IAIF,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,YAAY;CAMrB"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@shadow-garden/bapbong-view",
+  "version": "0.1.0",
+  "description": "bapbong — render core + read-only viewer (preview). Loads/lays-out/paints a .docx to canvas with zoom + page virtualization, no input-bridge (no ProseMirror editing).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shadowgarden-app/bapbong.git",
+    "directory": "packages/view"
+  },
+  "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:view"
+    ],
+    "targets": {
+      "build": {
+        "executor": "@nx/esbuild:esbuild",
+        "outputs": [
+          "{options.outputPath}"
+        ],
+        "options": {
+          "outputPath": "packages/view/dist",
+          "main": "packages/view/src/index.ts",
+          "tsConfig": "packages/view/tsconfig.lib.json",
+          "format": [
+            "esm",
+            "cjs"
+          ],
+          "declarationRootDir": "packages/view/src",
+          "external": [
+            "@shadow-garden/bapbong-contracts",
+            "@shadow-garden/bapbong-model",
+            "@shadow-garden/bapbong-docx",
+            "@shadow-garden/bapbong-measuring",
+            "@shadow-garden/bapbong-layout-engine",
+            "@shadow-garden/bapbong-painter-canvas",
+            "@shadow-garden/bapbong-selection",
+            "@shadow-garden/bapbong-a11y"
+          ]
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "prosemirror-model": "^1.25.7",
+    "@shadow-garden/bapbong-contracts": "^0.1.0",
+    "@shadow-garden/bapbong-model": "^0.1.0",
+    "@shadow-garden/bapbong-docx": "^0.1.0",
+    "@shadow-garden/bapbong-measuring": "^0.1.0",
+    "@shadow-garden/bapbong-layout-engine": "^0.1.0",
+    "@shadow-garden/bapbong-painter-canvas": "^0.1.0",
+    "@shadow-garden/bapbong-selection": "^0.1.0",
+    "@shadow-garden/bapbong-a11y": "^0.1.0"
+  }
+}