@shadow-garden/bapbong-contracts 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Le Phuoc Minh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# @shadow-garden/bapbong-contracts
+
+The shared **vocabulary** every other bapbong package speaks: paint-ready types,
+the plugin contract, and one small isomorphic utility (`Collection`). Almost all
+types; the only runtime code is `Collection`.
+
+- **Scope:** `scope:pure` (leaf — imports no other workspace package)
+- **Depends on:** `prosemirror-state`, `prosemirror-model` — **type-only**, for the
+  plugin/editor-change contracts. No DOM: the package is **isomorphic** (runs on
+  Node/server; enforced by a `no-restricted-globals` lint guard).
+
+## What it defines
+
+- **Flow model** (layout input): `FlowParagraph`, `FlowTable` /
+  `FlowTableRow` / `FlowTableCell`, `FlowFloat`, and inlines
+  `InlineRun` / `InlineImage` / `InlineBreak` / `InlineField`.
+- **Resolved layout** (paint-ready engine output): `ResolvedLayout`,
+  `ResolvedPage`, `LayoutLine`, `LayoutSegment`, `LayoutImageSegment`,
+  `ResolvedCell`, `ResolvedFloat`, `ResolvedFootnotes`, `ResolvedChrome`.
+- **Geometry & config:** `PageConfig`, `LayoutConfig`, `ColumnConfig`,
+  `ParagraphSpacing`, `ParagraphIndent`, `CellPadding`, `CaretRect`,
+  `PagePoint`, `SelectionRect`.
+- **Fonts / measurement:** `FontSpec`, `FontMetrics`, `MeasureText`, `MeasureMetrics`.
+- **Comments:** `IUser`, `CommentNode`, `CommentData`.
+- **Plugin contract** (the stable surface the editor + plugins share, so neither
+  imports the other): `EditorPlugin`, `PluginContext`, `EditorChange`,
+  `RangeDecoration`, `PaintDecoration`, `EditorPointerEvent` (the pointer hook +
+  `ctx.layout`/`ctx.setCursor` let plugins hit-test tables, e.g. column resize).
+- **Command contract**: `Command` (`{ name, run, isActive?, isEnabled? }`) +
+  `Dispatch` — the headless editor-operation surface the toolbar/menubar,
+  plugins and a backend share. Implementations live in
+  `@shadow-garden/bapbong-commands`.
+- **`Collection<T>`** — a name/id-keyed, insertion-ordered collection
+  (`get`/`add`/`remove`/`has`/`entries` + iterable). Keys by `id` by default, or
+  `new Collection(items, { idProperty })`; throws if an item lacks its key.
+  The editor uses it as its plugin registry.
+
+## Build / test
+
+```sh
+pnpm nx build @shadow-garden/bapbong-contracts
+pnpm nx test  @shadow-garden/bapbong-contracts
+```

package/dist/index.cjs

@@ -0,0 +1,77 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/contracts/src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Collection: () => Collection
+});
+module.exports = __toCommonJS(index_exports);
+
+// packages/contracts/src/lib/collection.ts
+var Collection = class {
+  items = /* @__PURE__ */ new Map();
+  idProperty;
+  defaulted;
+  constructor(initial = [], options) {
+    this.defaulted = options?.idProperty === void 0;
+    this.idProperty = options?.idProperty ?? "id";
+    for (const it of initial) this.add(it);
+  }
+  keyOf(keyOrValue) {
+    return typeof keyOrValue === "object" && keyOrValue !== null ? keyOrValue[this.idProperty] : keyOrValue;
+  }
+  /** The item with `key` (or matching the given item), or undefined. */
+  get(keyOrValue) {
+    return this.items.get(this.keyOf(keyOrValue));
+  }
+  /** Add (or replace, by key) an item. Throws if the item lacks its key
+   *  property (e.g. defaulting to `id` on items that have none). */
+  add(value) {
+    const key = value[this.idProperty];
+    if (key === void 0 || key === null) {
+      throw new Error(
+        `Collection: item has no "${String(this.idProperty)}" key` + (this.defaulted ? " \u2014 pass { idProperty } to key by another property." : ".")
+      );
+    }
+    this.items.set(key, value);
+    return this;
+  }
+  /** Remove by key (or by item). Returns whether something was removed. */
+  remove(keyOrValue) {
+    return this.items.delete(this.keyOf(keyOrValue));
+  }
+  has(keyOrValue) {
+    return this.items.has(this.keyOf(keyOrValue));
+  }
+  get size() {
+    return this.items.size;
+  }
+  /** [key, item] pairs, in insertion order. */
+  entries() {
+    return [...this.items.entries()];
+  }
+  [Symbol.iterator]() {
+    return this.items.values();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Collection
+});

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './lib/contracts.js';
+export * from './lib/collection.js';
+export * from './lib/plugin.js';
+export * from './lib/command.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,50 @@
+// packages/contracts/src/lib/collection.ts
+var Collection = class {
+  items = /* @__PURE__ */ new Map();
+  idProperty;
+  defaulted;
+  constructor(initial = [], options) {
+    this.defaulted = options?.idProperty === void 0;
+    this.idProperty = options?.idProperty ?? "id";
+    for (const it of initial) this.add(it);
+  }
+  keyOf(keyOrValue) {
+    return typeof keyOrValue === "object" && keyOrValue !== null ? keyOrValue[this.idProperty] : keyOrValue;
+  }
+  /** The item with `key` (or matching the given item), or undefined. */
+  get(keyOrValue) {
+    return this.items.get(this.keyOf(keyOrValue));
+  }
+  /** Add (or replace, by key) an item. Throws if the item lacks its key
+   *  property (e.g. defaulting to `id` on items that have none). */
+  add(value) {
+    const key = value[this.idProperty];
+    if (key === void 0 || key === null) {
+      throw new Error(
+        `Collection: item has no "${String(this.idProperty)}" key` + (this.defaulted ? " \u2014 pass { idProperty } to key by another property." : ".")
+      );
+    }
+    this.items.set(key, value);
+    return this;
+  }
+  /** Remove by key (or by item). Returns whether something was removed. */
+  remove(keyOrValue) {
+    return this.items.delete(this.keyOf(keyOrValue));
+  }
+  has(keyOrValue) {
+    return this.items.has(this.keyOf(keyOrValue));
+  }
+  get size() {
+    return this.items.size;
+  }
+  /** [key, item] pairs, in insertion order. */
+  entries() {
+    return [...this.items.entries()];
+  }
+  [Symbol.iterator]() {
+    return this.items.values();
+  }
+};
+export {
+  Collection
+};

package/dist/lib/collection.d.ts

@@ -0,0 +1,42 @@
+/** Property names of T whose value can serve as a key (string | number | symbol). */
+type IdKeysOf<T> = {
+    [K in keyof T]: T[K] extends PropertyKey ? K : never;
+}[keyof T];
+/** Default key property: `id` when T has one, otherwise any valid id property. */
+type DefaultIdKey<T> = 'id' extends IdKeysOf<T> ? 'id' : IdKeysOf<T>;
+/**
+ * A key-property-keyed, insertion-ordered collection. Items are keyed by a
+ * property whose value is a primitive (`string | number | symbol`); it defaults
+ * to `id`, or pass `{ idProperty }` to key by another (e.g. plugins by `name`).
+ * Lookups/removals accept either the key or the item; iterating yields the
+ * items in insertion order.
+ *
+ * Dependency-free + isomorphic. Used by the editor as its plugin registry
+ * (`new Collection<EditorPlugin>([], { idProperty: 'name' })`), but generic.
+ *
+ * Note: if T has no `id` property you must pass `{ idProperty }` — otherwise
+ * items would key by an absent property at runtime.
+ */
+export declare class Collection<T extends object, IdKey extends IdKeysOf<T> = DefaultIdKey<T>> implements Iterable<T> {
+    private readonly items;
+    private readonly idProperty;
+    private readonly defaulted;
+    constructor(initial?: T[], options?: {
+        idProperty?: IdKey;
+    });
+    private keyOf;
+    /** The item with `key` (or matching the given item), or undefined. */
+    get(keyOrValue: T[IdKey] | T): T | undefined;
+    /** Add (or replace, by key) an item. Throws if the item lacks its key
+     *  property (e.g. defaulting to `id` on items that have none). */
+    add(value: T): this;
+    /** Remove by key (or by item). Returns whether something was removed. */
+    remove(keyOrValue: T[IdKey] | T): boolean;
+    has(keyOrValue: T[IdKey] | T): boolean;
+    get size(): number;
+    /** [key, item] pairs, in insertion order. */
+    entries(): [T[IdKey], T][];
+    [Symbol.iterator](): Iterator<T>;
+}
+export {};
+//# sourceMappingURL=collection.d.ts.map

package/dist/lib/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/lib/collection.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,WAAW,GAAG,CAAC,GAAG,KAAK;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AAErF,kFAAkF;AAClF,KAAK,YAAY,CAAC,CAAC,IAAI,IAAI,SAAS,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,SAAS,QAAQ,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CACnF,YAAW,QAAQ,CAAC,CAAC,CAAC;IAEtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;gBAExB,OAAO,GAAE,CAAC,EAAO,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,KAAK,CAAA;KAAE;IAM/D,OAAO,CAAC,KAAK;IAMb,sEAAsE;IACtE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS;IAI5C;sEACkE;IAClE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAYnB,yEAAyE;IACzE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO;IAIzC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO;IAItC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,6CAA6C;IAC7C,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE;IAI1B,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;CAGjC"}

package/dist/lib/command.d.ts

@@ -0,0 +1,30 @@
+import type { EditorState, Transaction } from 'prosemirror-state';
+/** Apply a transaction to the editor — ProseMirror's dispatch convention. */
+export type Dispatch = (tr: Transaction) => void;
+/**
+ * A named editor operation: the shared vocabulary the toolbar/menubar, plugins,
+ * and a headless (server-side) caller all speak. It operates purely on
+ * {@link EditorState} with no DOM, so the *same* command runs in the browser
+ * and on the backend.
+ *
+ * This is just the contract — implementations live in
+ * `@shadow-garden/bapbong-commands`. Keeping the type here lets the editor
+ * expose a `Collection<Command>` registry, and the menubar read it, without
+ * either importing the implementations (same rationale as {@link EditorPlugin}).
+ */
+export interface Command {
+    /** Stable identifier — the registry key and the name a menu/toolbar references. */
+    readonly name: string;
+    /**
+     * Apply the operation. Following ProseMirror's convention, omit `dispatch` to
+     * probe whether it *would* apply (returns true/false without mutating).
+     */
+    run(state: EditorState, dispatch?: Dispatch): boolean;
+    /** Whether the operation is currently "on" (e.g. bold over the selection) —
+     *  drives toggle/active UI. */
+    isActive?(state: EditorState): boolean;
+    /** Whether the operation can apply at all (else a button renders disabled).
+     *  When omitted, callers fall back to a no-dispatch `run` probe. */
+    isEnabled?(state: EditorState): boolean;
+}
+//# sourceMappingURL=command.d.ts.map

package/dist/lib/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/lib/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAElE,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,OAAO;IACtB,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACtD;mCAC+B;IAC/B,QAAQ,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IACvC;wEACoE;IACpE,SAAS,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;CACzC"}

package/dist/lib/contracts.d.ts

@@ -0,0 +1,510 @@
+/** Page geometry, in CSS pixels. */
+export interface PageConfig {
+    width: number;
+    height: number;
+    margin: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+}
+/** Multi-column layout (w:cols): `count` equal-width columns separated by
+ *  `gap` px. count 1 is the ordinary single-column flow. */
+export interface ColumnConfig {
+    count: number;
+    gap: number;
+}
+/** One document section's flow properties. Sections are delimited by section
+ *  breaks (w:sectPr); each spans `blockCount` top-level blocks. `newPage` is
+ *  true for a next-page break (the section starts a fresh page), false for a
+ *  continuous break (columns switch mid-page). */
+export interface SectionConfig {
+    blockCount: number;
+    columns: ColumnConfig;
+    newPage: boolean;
+}
+/** A document comment (w:comment) referenced by a w:commentRange in the body.
+ *  `id` matches the comment mark's ids; `text` is the flattened comment body. */
+export interface CommentData {
+    id: number;
+    author: string;
+    date: string;
+    text: string;
+}
+/** Author of a comment / reply. `id` identifies the user (for own-only edit
+ *  checks and @mentions); name/email/avatar are for display. */
+export interface IUser {
+    id: string;
+    name: string;
+    email?: string;
+    avatar?: string;
+}
+/** A comment thread node stored on `doc.attrs.comments` (authoring model). The
+ *  thread is a tree via `parentId` (null = root, the node a comment mark
+ *  anchors to). `body` is commentSchema ProseMirror-doc JSON. `resolved` is
+ *  meaningful only on roots. */
+export interface CommentNode {
+    id: number;
+    parentId: number | null;
+    user: IUser;
+    date: string;
+    body: unknown;
+    resolved?: boolean;
+}
+/** A resolved font used for both measuring and painting. */
+export interface FontSpec {
+    family: string;
+    /** Size in points (CSS `pt`). */
+    sizePt: number;
+    bold: boolean;
+    italic: boolean;
+}
+/** Measures the width (CSS px) of `text` rendered with `font`. */
+export type MeasureText = (text: string, font: FontSpec) => number;
+/** Vertical font metrics (CSS px) for baseline-accurate line boxes. */
+export interface FontMetrics {
+    /** Distance from the baseline up to the top of the line box. */
+    ascent: number;
+    /** Distance from the baseline down to the bottom of the line box. */
+    descent: number;
+}
+/** Provides vertical metrics for a font. Injected so the engine stays pure. */
+export type MeasureMetrics = (font: FontSpec) => FontMetrics;
+/** A contiguous run of inline text sharing one font/color/link. */
+export interface InlineRun {
+    text: string;
+    font: FontSpec;
+    color?: string;
+    link?: string;
+    underline?: boolean;
+    strike?: boolean;
+    /** Highlight / shading background color, e.g. "#FFFF00". */
+    background?: string;
+    /** Superscript / subscript (font already reduced; painter shifts baseline). */
+    vertAlign?: 'super' | 'sub';
+    /** Footnote reference number (w:footnoteReference): the run's text is the
+     *  superscript mark; the body is laid out at the bottom of its page. */
+    footnoteRef?: number;
+    /** Comment ids covering this run (w:commentRangeStart/End) — painted with a
+     *  comment tint; the sidebar locates the range by these ids. */
+    commentIds?: number[];
+    /** Absolute ProseMirror position of the run's first character. */
+    pos?: number;
+}
+/** A vector shape riding an image box (drawn, not a bitmap — `src` stays '').
+ *  Word drawing shapes (wps/VML rect + straight connector) map to this: same
+ *  layout semantics as an image (atomic box, inline or anchored), different
+ *  paint. Dimensions live on the carrying image; colors are CSS. */
+export interface ShapeSpec {
+    /** Preset geometry. Names mirror OOXML prstGeom tokens: 'line' is a
+     *  corner-to-corner straight connector; 'rightArrow' a block arrow;
+     *  'horizontalScroll' paints as a stylized banner with rolled ends. */
+    kind: 'rect' | 'line' | 'ellipse' | 'roundRect' | 'rightArrow' | 'horizontalScroll';
+    /** Stroke color; absent = no stroke (a:noFill on the outline). */
+    stroke?: string;
+    /** Stroke width in px (defaults to 1 when a stroke is drawn). */
+    strokeWidth?: number;
+    /** Rect fill; absent = transparent (outline only). */
+    fill?: string;
+    /** Line drawn bottom-left → top-right instead (a:xfrm flipV). */
+    flipV?: boolean;
+}
+/** An atomic inline image laid out inline with text. Dimensions are CSS px. */
+export interface InlineImage {
+    src: string;
+    width: number;
+    height: number;
+    link?: string;
+    /** Present when this box is a drawn vector shape instead of a bitmap. */
+    shape?: ShapeSpec;
+    /** Clockwise degrees around the box center — paint-only: the layout box
+     *  stays axis-aligned (Word re-wraps only on commit, not live). */
+    rotation?: number;
+    /** Absolute ProseMirror position of the image node (occupies 1 position). */
+    pos?: number;
+}
+/** A dynamic field whose text is substituted at paint time (page numbers).
+ *  Occupies one PM position, like an image atom. */
+export interface InlineField {
+    field: 'pageNumber' | 'pageCount';
+    font: FontSpec;
+    color?: string;
+    pos?: number;
+}
+/** A forced line break inside a paragraph (w:br). Occupies one PM position. */
+export interface InlineBreak {
+    break: true;
+    pos?: number;
+}
+/** One piece of a paragraph's inline content. Distinguish with `'src' in x`
+ *  (image) / `'field' in x` (field) / `'break' in x` / otherwise text run. */
+export type FlowInline = InlineRun | InlineImage | InlineField | InlineBreak;
+/** A floating image (wp:anchor) anchored to a paragraph. Text flows around
+ *  its rectangle ('square'), skips below it ('topAndBottom'), or ignores it
+ *  ('none' — painted only). All values are CSS px. */
+export interface FlowFloat {
+    src: string;
+    width: number;
+    height: number;
+    /** Present when this float is a drawn vector shape instead of a bitmap. */
+    shape?: ShapeSpec;
+    wrap: 'square' | 'topAndBottom' | 'none';
+    /** Horizontal: alignment within hRel, or an offset from its left edge. */
+    hAlign?: 'left' | 'right' | 'center';
+    hOffset?: number;
+    hRel?: 'margin' | 'page';
+    /** Vertical: offset from the anchor paragraph top / margin / page top. */
+    vOffset?: number;
+    vRel?: 'paragraph' | 'margin' | 'page';
+    /** Text-to-image gaps. */
+    distL?: number;
+    distR?: number;
+    distT?: number;
+    distB?: number;
+    /** Textbox (wps:txbx) paragraphs laid out inside the shape's box. */
+    content?: FlowParagraph[];
+    /** Textbox interior padding (wps:bodyPr lIns…), px. Absent → Word defaults. */
+    inset?: {
+        l: number;
+        t: number;
+        r: number;
+        b: number;
+    };
+    /** Clockwise degrees around the box center — paint-only: wrap exclusions
+     *  keep the axis-aligned box. */
+    rotation?: number;
+    /** Absolute PM position of the carrying image node — lets the editor map a
+     *  resolved float back to its node (resize). Absent in chrome (not
+     *  caret-addressable). */
+    pos?: number;
+}
+/** Paragraph horizontal alignment (mirrors w:jc / CSS text-align). */
+export type Align = 'left' | 'center' | 'right' | 'justify';
+/** A custom tab stop (w:tabs/w:tab). `pos` is px from the paragraph's content
+ *  left edge. `val` says how the following text aligns at the stop; `leader`
+ *  fills the jumped-over gap (TOC dots etc.). */
+export interface TabStop {
+    pos: number;
+    val: 'left' | 'right' | 'center' | 'decimal';
+    leader?: 'dot' | 'hyphen' | 'underscore' | 'middleDot';
+}
+/** Paragraph indentation in CSS px (mirrors w:ind). `firstLine` and `hanging`
+ *  are mutually exclusive; if both are present, `hanging` takes precedence. */
+export interface ParagraphIndent {
+    left?: number;
+    right?: number;
+    firstLine?: number;
+    hanging?: number;
+}
+/** Paragraph spacing (mirrors w:spacing). `before`/`after` are px gaps around
+ *  the paragraph; `line` is the inter-line measure interpreted by `lineRule`:
+ *  'auto' → multiple of the natural line height, 'exact'/'atLeast' → px. */
+export interface ParagraphSpacing {
+    before?: number;
+    after?: number;
+    line?: number;
+    lineRule?: 'auto' | 'exact' | 'atLeast';
+}
+/** A block flattened and ready for layout (paragraph only, for now). */
+export interface FlowParagraph {
+    type: 'paragraph';
+    /** Ordered inline content: text runs and atomic images. */
+    runs: FlowInline[];
+    /** List marker text (e.g. "1.", "•") if this paragraph is a list item. */
+    marker?: string;
+    /** Horizontal alignment; defaults to 'left' when omitted. */
+    align?: Align;
+    /** Indentation in CSS px; defaults to no indent when omitted. */
+    indent?: ParagraphIndent;
+    /** Line spacing + space before/after; defaults to single, no gaps. */
+    spacing?: ParagraphSpacing;
+    /** Force this paragraph to start a new page (w:pageBreakBefore / a page
+     *  break run at its head). */
+    pageBreakBefore?: boolean;
+    /** Absolute PM position where the paragraph's content starts (nodePos + 1). */
+    pos?: number;
+    /** Absolute PM position after the paragraph's last character. */
+    end?: number;
+    /** Floating images anchored to this paragraph. */
+    floats?: FlowFloat[];
+    /** Custom tab stops; tabs past the last stop use the default grid. */
+    tabs?: TabStop[];
+}
+/** A table cell, holding nested flow content (paragraphs / tables). */
+export interface FlowTableCell {
+    colspan: number;
+    rowspan: number;
+    /** Px widths of the spanned grid columns, or null to derive equally. */
+    colwidth: number[] | null;
+    /** Cell fill color (w:shd), e.g. "#D9E2F3". */
+    background?: string;
+    /** Vertical alignment of content within the cell (w:vAlign); top default. */
+    vAlign?: 'center' | 'bottom';
+    /** Per-cell border overrides (w:tcBorders); each side overrides the table. */
+    borders?: TableBorders;
+    content: FlowBlock[];
+}
+export interface FlowTableRow {
+    cells: FlowTableCell[];
+    /** Repeat this row at the top of every page the table spans (w:tblHeader).
+     *  Only honored for contiguous header rows at the top of the table. */
+    header?: boolean;
+    /** w:cantSplit — never break this row across pages (Word default allows). */
+    cantSplit?: boolean;
+    /** Explicit row height (w:trHeight): a floor, or `exact` to force it. */
+    height?: {
+        value: number;
+        exact: boolean;
+    };
+}
+/** Which table borders are visible (w:tblBorders). OOXML tables have NO
+ *  borders unless declared — absence of this object means draw nothing. */
+/** Stroke style of a visible border edge (maps to/from w:val). */
+export type BorderStyle = 'solid' | 'dashed' | 'dotted' | 'double';
+/** Appearance of one visible border edge. */
+export interface BorderSide {
+    /** Stroke width in CSS px. */
+    width: number;
+    style: BorderStyle;
+    /** Hex colour, e.g. "#000000". */
+    color: string;
+}
+/**
+ * Per-side border appearance. A side holding a {@link BorderSide} is visible
+ * with that width/style/colour; `false` is an explicit "no border"; an absent
+ * side inherits (a cell falls back to the table's outer/inside border).
+ */
+export interface TableBorders {
+    top?: BorderSide | false;
+    bottom?: BorderSide | false;
+    left?: BorderSide | false;
+    right?: BorderSide | false;
+    insideH?: BorderSide | false;
+    insideV?: BorderSide | false;
+}
+/** Cell padding overrides (px) from w:tblCellMar; unset sides use defaults. */
+export interface CellPadding {
+    left?: number;
+    right?: number;
+    top?: number;
+    bottom?: number;
+}
+/** A table flattened and ready for layout. */
+export interface FlowTable {
+    type: 'table';
+    rows: FlowTableRow[];
+    cellPadding?: CellPadding;
+    borders?: TableBorders;
+    /** Table alignment within the content area (w:jc); left default. */
+    align?: 'center' | 'right';
+}
+export type FlowBlock = FlowParagraph | FlowTable;
+export interface LayoutConfig {
+    page: PageConfig;
+    measureText: MeasureText;
+    /** Optional vertical metrics. When provided, line boxes use real
+     *  ascent/descent; otherwise a font-size factor approximates them. */
+    measureMetrics?: MeasureMetrics;
+    /** Default tab-stop interval in px (Word's default is 48px = 0.5in). */
+    tabWidth?: number;
+    /** Defaults for runs that don't specify a value. */
+    defaultFont?: Partial<FontSpec>;
+    /** Whole-document column config for the flat (FlowBlock) layout path. The PM
+     *  doc path reads per-section columns from the doc instead. */
+    columns?: ColumnConfig;
+}
+/** One painted text segment, positioned in page coordinates (px). */
+export interface LayoutSegment {
+    x: number;
+    text: string;
+    font: FontSpec;
+    color?: string;
+    link?: string;
+    underline?: boolean;
+    strike?: boolean;
+    /** Highlight / shading background painted behind the text. */
+    background?: string;
+    /** Superscript / subscript: the painter shifts the baseline (font is
+     *  already the reduced size). */
+    vertAlign?: 'super' | 'sub';
+    /** Measured width (px) — lets the painter draw text decorations without
+     *  re-measuring at paint time. */
+    width?: number;
+    /** Dynamic field: the painter substitutes the page number / page count for
+     *  `text` while painting. The segment occupies ONE PM position. */
+    field?: 'pageNumber' | 'pageCount';
+    /** Footnote reference number: the placer counts which notes land on each
+     *  page so it can reserve bottom space and lay their bodies out there. */
+    footnoteRef?: number;
+    /** Comment ids covering this segment (w:commentRangeStart/End) — the painter
+     *  tints it; null/absent means no comment. */
+    commentIds?: number[];
+    /** Absolute PM position of the segment's first character. Segments without
+     *  a position (list markers) are decoration — not addressable by a caret. */
+    pos?: number;
+}
+/** A painted inline image; (x) is its left edge, sitting on the line baseline.
+ *  width/height are CSS px. */
+export interface LayoutImageSegment {
+    x: number;
+    src: string;
+    width: number;
+    height: number;
+    link?: string;
+    /** Present when this box is a drawn vector shape instead of a bitmap. */
+    shape?: ShapeSpec;
+    /** Clockwise degrees around the box center (paint-only). */
+    rotation?: number;
+    /** Absolute PM position of the image node (occupies 1 position). */
+    pos?: number;
+}
+/** A laid-out line; (x, y) is its top-left in page coordinates (px). */
+export interface LayoutLine {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Baseline offset from the line's top (px). */
+    baseline: number;
+    segments: LayoutSegment[];
+    /** Inline images on this line, positioned like segments. */
+    images?: LayoutImageSegment[];
+    /** PM position of the line's first caret slot. */
+    from?: number;
+    /** PM position after the line's last painted content. */
+    to?: number;
+}
+/** A laid-out table cell. All coordinates are page-absolute (px); `lines` and
+ *  `tables` are the cell's content, already positioned inside the cell box. */
+export interface ResolvedCell {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    colspan: number;
+    rowspan: number;
+    lines: LayoutLine[];
+    /** Cell fill color, painted behind the content. */
+    background?: string;
+    /** Per-cell border overrides; each side overrides the table's edge. */
+    borders?: TableBorders;
+    /** Tables nested inside this cell. */
+    tables?: ResolvedTable[];
+    /** Anchored images/shapes positioned within this cell (v1: painted at their
+     *  anchor offsets; cell text does not wrap around them). */
+    floats?: ResolvedFloat[];
+}
+/** A laid-out table; (x, y) is its top-left in page coordinates (px). */
+export interface ResolvedTable {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    cells: ResolvedCell[];
+    /** Bottom edge (px from the table top) of the repeating header band, when
+     *  the table's leading rows are marked as header rows. */
+    headerBottom?: number;
+    /** Vertical bands (px from the table top) of rows marked w:cantSplit — the
+     *  paginator moves these whole instead of splitting them mid-content. */
+    cantSplitBands?: {
+        top: number;
+        bottom: number;
+    }[];
+    /** Visible borders; absent → the table paints borderless (OOXML default). */
+    borders?: TableBorders;
+}
+/** A floating image placed on a page (page-local coordinates, px). */
+export interface ResolvedFloat {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    src: string;
+    /** Present when this float is a drawn vector shape instead of a bitmap. */
+    shape?: ShapeSpec;
+    /** Textbox text laid out inside the shape, in BOX-LOCAL coordinates
+     *  (origin at the float's top-left) — the painter translates by (x, y).
+     *  Never caret-addressable; PM positions are stripped. */
+    lines?: LayoutLine[];
+    /** Clockwise degrees around the box center (paint-only). */
+    rotation?: number;
+    /** Absolute PM position of the carrying image node (absent in chrome). */
+    pos?: number;
+}
+export interface ResolvedPage {
+    index: number;
+    width: number;
+    height: number;
+    lines: LayoutLine[];
+    /** Tables on this page, positioned in page coordinates. */
+    tables?: ResolvedTable[];
+    /** Floating images on this page (painted behind the text). */
+    floats?: ResolvedFloat[];
+    /** Footnote bodies whose references fall on this page, laid out at the
+     *  bottom above the footer. Absent when the page has no footnotes. */
+    footnotes?: ResolvedFootnotes;
+}
+/** Footnote bodies reserved at the bottom of a page. `separatorY` is where the
+ *  short rule above the notes is drawn; `lines` are the note bodies, already
+ *  positioned in page coordinates (px). */
+export interface ResolvedFootnotes {
+    separatorY: number;
+    lines: LayoutLine[];
+}
+/** Repeating page furniture (a header or footer band). Coordinates are
+ *  page-local; the painter stamps it onto every page. Not caret-addressable —
+ *  PM positions are stripped (the band belongs to a separate document). */
+export interface ResolvedChrome {
+    lines: LayoutLine[];
+    tables: ResolvedTable[];
+    /** Anchored images/shapes positioned within the band (e.g. the horizontal
+     *  rule real headers draw under their contact block). Painted only — the
+     *  chrome text does not wrap around them. */
+    floats?: ResolvedFloat[];
+    height: number;
+}
+/** The paint-ready result the canvas painter consumes (M3). */
+export interface ResolvedLayout {
+    pages: ResolvedPage[];
+    /** Default (odd-page) header/footer, stamped on every page unless a
+     *  first/even variant applies (see chromeSelect). */
+    pageHeader?: ResolvedChrome;
+    pageFooter?: ResolvedChrome;
+    /** Title-page header/footer (w:type="first"), shown on page 1 when
+     *  chromeSelect.titlePg is set. */
+    pageHeaderFirst?: ResolvedChrome;
+    pageFooterFirst?: ResolvedChrome;
+    /** Even-page header/footer (w:type="even"), shown on even pages when
+     *  chromeSelect.evenAndOdd is set. */
+    pageHeaderEven?: ResolvedChrome;
+    pageFooterEven?: ResolvedChrome;
+    /** Which chrome variant applies per page. `titlePg` → page 1 uses the first
+     *  variant (blank if none); `evenAndOdd` → even pages use the even variant. */
+    chromeSelect?: {
+        titlePg: boolean;
+        evenAndOdd: boolean;
+    };
+}
+/** A point in page-local coordinates (px), tagged with its page. */
+export interface PagePoint {
+    pageIndex: number;
+    x: number;
+    y: number;
+}
+/** Caret placement in page-local coordinates (px). */
+export interface CaretRect {
+    pageIndex: number;
+    x: number;
+    y: number;
+    height: number;
+}
+/** One highlighted rectangle of a selection, in page-local coordinates. */
+export interface SelectionRect {
+    pageIndex: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/lib/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/lib/contracts.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAED;4DAC4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;kDAGkD;AAClD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;iFACiF;AACjF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;gEACgE;AAChE,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;gCAGgC;AAChC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,4DAA4D;AAC5D,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAC;AAEnE,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,QAAQ,KAAK,WAAW,CAAC;AAI7D,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC5B;4EACwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;oEACgE;IAChE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;oEAGoE;AACpE,MAAM,WAAW,SAAS;IACxB;;2EAEuE;IACvE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,kBAAkB,CAAC;IACpF,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;uEACmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;oDACoD;AACpD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,YAAY,GAAG,WAAW,CAAC;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;8EAC8E;AAC9E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;AAE7E;;sDAEsD;AACtD,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,MAAM,CAAC;IACzC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,+EAA+E;IAC/E,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD;qCACiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;8BAE0B;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,sEAAsE;AACtE,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5D;;iDAEiD;AACjD,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC7C,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,CAAC;CACxD;AAED;+EAC+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;4EAE4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACzC;AAED,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,2DAA2D;IAC3D,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,iEAAiE;IACjE,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,sEAAsE;IACtE,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B;kCAC8B;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB;2EACuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yEAAyE;IACzE,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5C;AAED;2EAC2E;AAC3E,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnE,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,CAAC;IACnB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IAC5B,IAAI,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IAC1B,KAAK,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IAC3B,OAAO,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IAC7B,OAAO,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CAC9B;AAED,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,oEAAoE;IACpE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB;0EACsE;IACtE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,WAAW,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC;mEAC+D;IAC/D,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAID,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;qCACiC;IACjC,SAAS,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC5B;sCACkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;uEACmE;IACnE,KAAK,CAAC,EAAE,YAAY,GAAG,WAAW,CAAC;IACnC;8EAC0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;kDAC8C;IAC9C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;iFAC6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;+BAC+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wEAAwE;AACxE,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC9B,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;+EAC+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,sCAAsC;IACtC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB;gEAC4D;IAC5D,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB;8DAC0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;6EACyE;IACzE,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnD,6EAA6E;IAC7E,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;8DAE0D;IAC1D,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB;0EACsE;IACtE,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED;;2CAE2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;2EAE2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB;;iDAE6C;IAC7C,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB;yDACqD;IACrD,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;uCACmC;IACnC,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC;0CACsC;IACtC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;mFAC+E;IAC/E,YAAY,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1D;AAID,oEAAoE;AACpE,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,sDAAsD;AACtD,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/lib/plugin.d.ts

@@ -0,0 +1,185 @@
+import type { EditorState, Transaction } from 'prosemirror-state';
+import type { MarkSpec, NodeSpec } from 'prosemirror-model';
+import type { CaretRect, PagePoint, ResolvedLayout, SelectionRect } from './contracts.js';
+/** A decoration a plugin paints over a document range (comment tint, find
+ *  highlight, track-change underline…). Doc positions; the editor resolves them
+ *  to page geometry before painting. */
+export interface RangeDecoration {
+    from: number;
+    to: number;
+    kind: 'background' | 'underline' | 'strike';
+    color: string;
+}
+/** A {@link RangeDecoration} resolved to page-local rects — what the painter
+ *  consumes (it never maps doc positions itself). */
+export interface PaintDecoration {
+    rects: SelectionRect[];
+    kind: 'background' | 'underline' | 'strike';
+    color: string;
+}
+/**
+ * Emitted after every editor layout/paint cycle so a host (any framework) and
+ * plugins can mirror document state — page count, comment threads (on
+ * doc.attrs), selection.
+ */
+export interface EditorChange {
+    /** The current editor state (doc + selection). */
+    state: EditorState;
+    /** Number of laid-out pages. */
+    pageCount: number;
+    /** Whether the doc changed this cycle (false = selection-only). Consumers use
+     *  it to skip rebuilding doc-derived UI (comment sidebars, JSON panels). */
+    docChanged: boolean;
+}
+/**
+ * A pointer event on the canvas, offered to plugins (via
+ * {@link EditorPlugin.onPointer}) before the editor's own caret/selection
+ * handling. `point` is page-local geometry; `pos` is the document position under
+ * it (computed for `down`/`up`/`contextmenu` — null for `move`, which fires on
+ * every hover, to keep hover cheap). A plugin returns true to claim the event.
+ */
+export interface EditorPointerEvent {
+    type: 'down' | 'move' | 'up' | 'contextmenu';
+    /** Page-local point under the pointer, or null if outside any page. */
+    point: PagePoint | null;
+    /** Document position under the point (null for `move`). */
+    pos: number | null;
+    /** Viewport coordinates (for positioning UI like a context menu). */
+    clientX: number;
+    clientY: number;
+    /** Mouse buttons bitmask. */
+    buttons: number;
+    /** Modifier keys held — e.g. Ctrl/Cmd-click to open a hyperlink. */
+    ctrlKey: boolean;
+    metaKey: boolean;
+    shiftKey: boolean;
+    altKey: boolean;
+}
+/** A keyboard event offered to plugins (via {@link EditorPlugin.onKey})
+ *  before the editor's own keymaps see it. */
+export interface EditorKeyEvent {
+    /** `KeyboardEvent.key` — e.g. "Escape", "Enter", "a". */
+    key: string;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    shiftKey: boolean;
+    altKey: boolean;
+}
+/** A transient vertical guide line shown during a drag (page-local geometry) —
+ *  e.g. a column-resize preview. The editor positions it on the canvas. */
+export interface OverlayGuide {
+    pageIndex: number;
+    x: number;
+    y: number;
+    height: number;
+}
+/** A selection frame around an object (image resize): border + 8 resize
+ *  handles + a rotate knob above the top edge, rotated by `rotation` degrees
+ *  around the rect center. Page-local geometry; purely visual — the plugin
+ *  hit-tests handles itself from the same numbers. */
+export interface OverlayFrame {
+    pageIndex: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Clockwise degrees around the rect center (default 0). */
+    rotation?: number;
+    /** Small readout above the frame (e.g. "320 × 214" during a resize). */
+    label?: string;
+}
+/** A page-local rect the editor fills as a translucent highlight (e.g. a
+ *  selected table-cell block). */
+export interface OverlayRect {
+    pageIndex: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * The controlled surface an {@link EditorPlugin} gets onto the editor core:
+ * read/dispatch document state plus the geometry + paint helpers it needs to
+ * anchor UI. The editor hands one of these to each plugin's `setup`.
+ */
+export interface PluginContext {
+    /** Current editor state (doc + selection). Live — read it each time. */
+    readonly state: EditorState;
+    /** Apply a ProseMirror transaction. */
+    dispatch(tr: Transaction): void;
+    /** Caret geometry at a doc position (page-local), or null. */
+    caretRect(pos: number): CaretRect | null;
+    /** Map a page-local point to canvas-stack coordinates, or null. */
+    pageToCanvas(p: {
+        pageIndex: number;
+        x: number;
+        y: number;
+    }): {
+        x: number;
+        y: number;
+    } | null;
+    /** Move the selection (caret if `to` omitted). */
+    setSelection(from: number, to?: number): void;
+    /** Scroll the viewport so the caret at `pos` sits `topMargin` px from the top. */
+    scrollToPos(pos: number, topMargin?: number): void;
+    /** Force a content repaint (e.g. after a plugin's decorations change). */
+    requestPaint(): void;
+    /** The current paint-ready layout (page/table/cell geometry), or null before
+     *  a document loads. Lets pointer plugins hit-test tables/columns. */
+    readonly layout: ResolvedLayout | null;
+    /** Set the canvas cursor (e.g. `'col-resize'`); null restores the default. */
+    setCursor(cursor: string | null): void;
+    /** Show a transient vertical guide (e.g. a column-resize preview), or null to
+     *  clear it. Page-local geometry; the editor positions it on the canvas. */
+    setGuide(guide: OverlayGuide | null): void;
+    /** Fill these page-local rects as a translucent highlight (e.g. a selected
+     *  table-cell block), or null to clear. The editor renders them on the canvas. */
+    setHighlight(rects: OverlayRect[] | null): void;
+    /** Show an object-selection frame (border + resize handles + rotate knob),
+     *  or null to clear. Page-local geometry; the editor renders it as DOM
+     *  overlay in the canvas stack — no canvas repaint. */
+    setFrame(frame: OverlayFrame | null): void;
+    /** Show a small action button straddling a page-local point (e.g. a selected
+     *  cell block's top-right), invoking `onActivate` on click/tap; null clears it.
+     *  A touch-friendly trigger where hover/right-click aren't available. */
+    setActionButton(at: PagePoint | null, onActivate?: () => void): void;
+}
+/**
+ * A framework-agnostic editor extension. The editor invokes these hooks; the
+ * plugin reaches back through {@link PluginContext}. Every hook is optional — a
+ * plugin implements only what it needs.
+ *
+ * This is the stable contract both the editor (which calls the hooks) and
+ * plugin packages (which implement them) depend on, so neither needs to import
+ * the other. Decoration / schema / docx-part hooks are introduced in later
+ * phases; adding them is purely additive.
+ */
+export interface EditorPlugin {
+    /** Stable identifier (also used for diagnostics). */
+    readonly name: string;
+    /** Schema contributions merged into the editor's document schema, so a plugin
+     *  can own its marks/nodes. Composed once when a document loads. */
+    schema?: {
+        marks?: Record<string, MarkSpec>;
+        nodes?: Record<string, NodeSpec>;
+    };
+    /** Called once when the editor is constructed; may return a teardown fn. */
+    setup?(ctx: PluginContext): void | (() => void);
+    /** Called after every editor layout/paint cycle. */
+    onChange?(change: EditorChange): void;
+    /** Called when a pointerdown places the caret at doc position `pos`. */
+    onCaretPick?(pos: number): void;
+    /** Decorations to paint this content frame (collected on every content
+     *  repaint; call `ctx.requestPaint()` when they change). */
+    decorations?(ctx: PluginContext): RangeDecoration[];
+    /** Pointer activity on the canvas, offered before the editor's own
+     *  caret/selection handling. Return true to claim the event (the editor then
+     *  preventDefaults it, captures the pointer on `down`, and skips its default).
+     *  `move` fires on every hover (for cursor feedback / drag). */
+    onPointer?(ev: EditorPointerEvent): boolean;
+    /** Keyboard input, offered before the editor's keymaps (typing, undo,
+     *  arrows) — e.g. Escape cancelling an in-flight drag gesture. Return true
+     *  to claim (the editor preventDefaults and stops the event). */
+    onKey?(ev: EditorKeyEvent): boolean;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/lib/plugin.d.ts.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@shadow-garden/bapbong-contracts",
+  "version": "0.1.0",
+  "description": "bapbong — shared layout + plugin contracts/types (type-only deps)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shadowgarden-app/bapbong.git",
+    "directory": "packages/contracts"
+  },
+  "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:pure"
+    ],
+    "targets": {
+      "build": {
+        "executor": "@nx/esbuild:esbuild",
+        "outputs": [
+          "{options.outputPath}"
+        ],
+        "options": {
+          "outputPath": "packages/contracts/dist",
+          "main": "packages/contracts/src/index.ts",
+          "tsConfig": "packages/contracts/tsconfig.lib.json",
+          "format": [
+            "esm",
+            "cjs"
+          ],
+          "declarationRootDir": "packages/contracts/src"
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "prosemirror-model": "^1.25.7",
+    "prosemirror-state": "^1.4.4"
+  }
+}