@vyaz/core 0.1.0 → 0.4.0

package/dist/layout/TableLayoutEngine.d.ts

@@ -0,0 +1,174 @@
+/**
+ * TableLayoutEngine.ts — TableFrame → positioned grid.
+ *
+ * Column widths and row heights are *measured*, not required from the caller
+ * (unlike svg-table-core, whose `calculateRows` takes them as input — see
+ * TableTypes.ts header): each cell's `TextFrame` content is laid out twice —
+ * once unconstrained to get its natural width, once at the final column width
+ * to get its wrapped height.
+ *
+ * Pipeline:
+ *   1. placeCells    — colSpan/rowSpan → each cell's (startRow, startCol),
+ *                       borrowing svg-table-core's "occupied slot" idea
+ *                       (calculateRows' insertIgnoredCell), done natively.
+ *   2. column widths  — span-1 cells set the per-column max; span>N cells only
+ *                       *widen* their spanned columns, evenly, if their own
+ *                       natural width doesn't already fit (never shrink).
+ *   3. per-cell content — laid out once at its final (possibly multi-column)
+ *                       width, inset by padding *and* border width (border-box
+ *                       model — a border never overlaps the text); same
+ *                       deficit-widen rule for row heights and rowSpan cells.
+ *   4. position        — column/row offsets accumulated from final sizes.
+ *
+ * `table.width`/`table.height` (both optional) scale the *final* colWidths/
+ * rowHeights arrays proportionally to fit, applied after whichever source
+ * produced them (measured or an explicit `columnWidths`/`rowHeights`
+ * override) — symmetric, but width-shrink reflows text via wrapping while
+ * height-shrink has no equivalent and simply overflows the row.
+ *
+ * Border dash patterns (`borderPatterns`) and per-side `stroke-linecap`
+ * (`borderShapes`) resolve here (`resolveBorder`) but paint in
+ * `@vyaz/renderer`'s `TableRenderer.ts` (`borderMarkup`) — this engine only
+ * produces the resolved per-side values. Asymmetric corner radii (only a
+ * uniform `rx`/`ry` today) remain a possible future addition.
+ *
+ * Nested tables: `TableCell.content` can be a `TableFrame` instead of a
+ * `TextFrame` (`isNestedTable`). Both the natural-width pass and the final
+ * layout pass then call `layoutTableFrame` recursively instead of
+ * `layoutTextFrame` — meaning a nested cell's own two-pass layout happens
+ * *twice* (once per outer pass), so cost roughly doubles per nesting depth.
+ * The nested `TableLayoutResult` is exposed as `TableCellLayoutResult.
+ * nestedTable`; `content` still gets a placeholder `TextFrameLayoutResult`
+ * (zero lines, sized to the nested table) so every existing consumer that
+ * reads cell dimensions off `content.content.{width,height}` keeps working
+ * unchanged — `TableRenderer.ts` checks `nestedTable` first and renders that
+ * instead of `content` when present. `_depth` is an internal recursion
+ * counter (not meant to be set by callers) — past 50 levels this throws
+ * instead of hanging, on the assumption that's a cyclic/pathological input,
+ * not a real document.
+ */
+import type { TableFrame, BorderLineCap } from '../types/TableTypes.js';
+import type { TextFrameLayoutResult } from './TextFrameLayoutEngine.js';
+import { type Side } from '../utils/sides.js';
+/** A resolved, ready-to-paint border. Absent when every side's width is `0`. */
+export interface ResolvedBorder {
+    widths: Record<Side, number>;
+    colors: Record<Side, string>;
+    /** Present only when at least one side has a non-empty dash pattern. */
+    patterns?: Record<Side, number[] | undefined>;
+    /** Present only when `borderShapes` was set anywhere in the style cascade. */
+    shapes?: Record<Side, BorderLineCap>;
+    /** Present only when `rx`/`ry` was set anywhere in the style cascade. */
+    rx?: number;
+    ry?: number;
+}
+export interface TableCellLayoutResult {
+    /** Absolute X of the cell box (border-box) within the table. */
+    x: number;
+    /** Absolute Y of the cell box within the table. */
+    y: number;
+    /** Full box width — sums every spanned column + the gaps between them. */
+    width: number;
+    /** Full box height — sums every spanned row + the gaps between them. */
+    height: number;
+    /** Resolved padding box (inside the border, if any). */
+    padding: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    /** Extra Y offset inside the padding box from `verticalAlign` (0 for `'top'`). */
+    verticalOffset: number;
+    /** `TableCellStyle.cx`/`cy` — an additional px nudge on top of padding/alignment. Default `0`. */
+    cx: number;
+    /** @see cx */
+    cy: number;
+    /** `TableCellStyle.allowOverflow` — let content paint past the cell's padding box. Default `false`. */
+    allowOverflow: boolean;
+    bgColor?: string;
+    border?: ResolvedBorder;
+    /**
+     * The cell's laid-out content — same shape a lone `TextFrame` produces.
+     * When `TableCell.content` was a `TableFrame` (see `nestedTable`), this is
+     * a zero-line placeholder sized to match it — a renderer should check
+     * `nestedTable` first and use that instead of painting `content` as text.
+     */
+    content: TextFrameLayoutResult;
+    /**
+     * Present when `TableCell.content` was a `TableFrame` — a table nested
+     * inside this cell, already laid out at the cell's own content width.
+     * `content` (above) is a same-sized placeholder in this case, not real
+     * text — paint this instead.
+     */
+    nestedTable?: TableLayoutResult;
+    /**
+     * `TableCell.before`, laid out unwrapped at its own natural size and
+     * positioned absolute-within-the-table, already vertically centered.
+     * Absent when the cell has no `before`.
+     */
+    before?: {
+        content: TextFrameLayoutResult;
+        x: number;
+        y: number;
+    };
+    /** @see before — from `TableCell.after`, right-anchored instead. */
+    after?: {
+        content: TextFrameLayoutResult;
+        x: number;
+        y: number;
+    };
+    /** Columns this cell occupies (>1 for `colSpan`). */
+    colSpan: number;
+    /** Rows this cell occupies (>1 for `rowSpan`). */
+    rowSpan: number;
+}
+export interface TableRowLayoutResult {
+    y: number;
+    height: number;
+    bgColor?: string;
+    border?: ResolvedBorder;
+    /** Only cells that *start* in this row (a rowSpan cell from above is not repeated here). */
+    cells: TableCellLayoutResult[];
+}
+export interface TableLayoutResult {
+    /** Full outer box width, margins included. */
+    width: number;
+    /** Full outer box height, margins included. */
+    height: number;
+    bgColor?: string;
+    /** The table's own outer border (`TableStyle`), distinct from row/cell borders. */
+    border?: ResolvedBorder;
+    /**
+     * The border-box — the outer box with `TableStyle.margins` excluded. Rows
+     * span its full width; `border` (above) is drawn at this box. A renderer
+     * uses it directly instead of re-deriving margins from row/cell positions.
+     */
+    contentBox: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    rows: TableRowLayoutResult[];
+}
+export interface TableLayoutOptions {
+    mode?: 'browser' | 'office';
+    /**
+     * What to do when a cell's `fontFamily` isn't registered — forwarded to
+     * every cell's own `layoutTextFrame` call. `'throw'` (default) raises
+     * `FontNotFoundError`; `'substitute'` uses any registered family and folds
+     * the cell's own warnings into the table's (none surfaced directly here —
+     * a caller wanting them should lay out a cell's `TextFrame` itself).
+     */
+    onMissingFont?: 'throw' | 'substitute';
+    /**
+     * Internal nested-table recursion counter — do not set this yourself.
+     * `layoutTableFrame` increments it on every recursive call (a `TableCell`
+     * whose `content` is itself a `TableFrame`) and throws past 50 levels.
+     * @internal
+     */
+    _depth?: number;
+}
+export declare function layoutTableFrame(table: TableFrame, options?: TableLayoutOptions): TableLayoutResult;
+//# sourceMappingURL=TableLayoutEngine.d.ts.map

package/dist/layout/TableLayoutEngine.d.ts.map

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

package/dist/layout/TextFrameLayoutEngine.d.ts

@@ -20,7 +20,7 @@
  *   4. If frame.height is set, lines overflow to next column when colHeight exceeded
  *   5. If no frame.height, columns are infinite (all lines stay in column 0)
  */
-import type { TextFrame } from '../types/Document.js';
+import type { TextFrame, WritingMode } from '../types/Document.js';
 import type { Line, LayoutWarning } from '../types/LayoutTypes.js';
 import { ParagraphLayoutEngine } from './ParagraphLayoutEngine.js';
 /**
@@ -60,9 +60,39 @@ export interface TextFrameLayoutResult {
     };
     /** Present when autofit ran — the scale applied and whether it bottomed out. */
     autofit?: AutofitOutcome;
+    /**
+     * Block flow direction this layout was produced for — echoes
+     * `TextFrame.writingMode`, defaulting to `'horizontal-tb'`.
+     */
+    writingMode: WritingMode;
+    /**
+     * Post-layout rigid transform to realise `writingMode: 'sideways-*'` and/or
+     * `TextFrame.rotation`. Omitted when the net rotation is a multiple of 360°
+     * (nothing to apply). `lines`, `content` bbox aside, live in pre-rotation
+     * layout space; `content` / `overflow` are reported in **visual** space.
+     */
+    transform?: FrameTransform;
     /** Non-fatal issues (font fallback / substitution). Omitted when empty. */
     warnings?: LayoutWarning[];
 }
+/**
+ * Rigid transform a renderer applies to {@link TextFrameLayoutResult.lines} so a
+ * `sideways-*` writing mode or an explicit `rotation` takes visual effect. The
+ * layout math itself (line breaking, measuring, positioning) is unchanged.
+ */
+export interface FrameTransform {
+    /** Net clockwise rotation in degrees, normalised to `[0, 360)`. */
+    rotate: number;
+    /**
+     * The box `lines` occupy in their own pre-rotation coordinate space. The
+     * renderer rotates this box about its centre; for `rotate` of 90 / 270 the
+     * visible canvas is this box with width and height swapped.
+     */
+    layoutBox: {
+        width: number;
+        height: number;
+    };
+}
 /** Options for {@link layoutTextFrame}. */
 export interface LayoutOptions {
     /**

package/dist/layout/TextFrameLayoutEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextFrameLayoutEngine.d.ts","sourceRoot":"","sources":["../../src/layout/TextFrameLayoutEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,SAAS,EAA2C,MAAM,sBAAsB,CAAC;AAC/F,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAyB,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAM1F;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,qDAAqD;IACrD,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,qFAAqF;IACrF,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C;;;OAGG;IACH,QAAQ,EAAE;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IACrD;;;OAGG;IACH,GAAG,EAAE;QAAE,UAAU,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,CAAC;IACxE,gFAAgF;IAChF,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAmED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IACvC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,yFAAyF;AACzF,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,aAAkB,GAAG,qBAAqB,CAEpG;AAED,6EAA6E;AAC7E,wBAAgB,OAAO,CACrB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,qBAAqB,GAC5B,qBAAqB,CA0SvB"}
+{"version":3,"file":"TextFrameLayoutEngine.d.ts","sourceRoot":"","sources":["../../src/layout/TextFrameLayoutEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,SAAS,EAA2C,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC5G,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAyB,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAM1F;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,qDAAqD;IACrD,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,qFAAqF;IACrF,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C;;;OAGG;IACH,QAAQ,EAAE;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IACrD;;;OAGG;IACH,GAAG,EAAE;QAAE,UAAU,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,CAAC;IACxE,gFAAgF;IAChF,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;;OAGG;IACH,WAAW,EAAE,WAAW,CAAC;IACzB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAyED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IACvC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,yFAAyF;AACzF,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,aAAkB,GAAG,qBAAqB,CAEpG;AAED,6EAA6E;AAC7E,wBAAgB,OAAO,CACrB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,qBAAqB,GAC5B,qBAAqB,CAoVvB"}

package/dist/types/Document.d.ts

@@ -18,17 +18,29 @@
  *
  * Determines how lines stack relative to each other:
  * - `horizontal-tb`: lines flow horizontally top-to-bottom (Latin, Cyrillic, default).
- * - `vertical-rl`: lines flow vertically right-to-left (traditional CJK).
+ * - `vertical-rl`: lines flow vertically right-to-left (traditional CJK, per-glyph
+ *   upright/rotated via {@link TextOrientation}).
  * - `vertical-lr`: lines flow vertically left-to-right (Mongolian, some UI scenarios).
+ * - `sideways-rl`: the whole text block is laid out horizontally, then rotated
+ *   90° **clockwise** as a rigid unit; wrapped lines stack right-to-left. A single
+ *   line reads top-to-bottom. Matches PowerPoint `bodyPr vert="vert"`.
+ * - `sideways-lr`: same, rotated 90° **counter-clockwise**; wrapped lines stack
+ *   left-to-right, a line reads bottom-to-top. Matches PowerPoint `vert="vert270"`.
  *
  * **Layout impact:**
  *  Under `horizontal-tb`, `wrap` clips by **width**, `autofit` shrinks by **height**.
- *  Under `vertical-*`, `wrap` clips by **height**, `autofit` shrinks by **width**
- *  (width and height swap roles).
+ *  Under `vertical-*` / `sideways-*`, `wrap` clips by **height**, `autofit` shrinks
+ *  by **width** (width and height swap roles).
  *
- * @see {@link https://www.w3.org/TR/css-writing-modes-3/#block-flow | CSS Writing Modes: block flow}
+ * **Implementation status:** `sideways-rl` / `sideways-lr` are implemented as a
+ * post-layout affine transform (the engine reports it on
+ * `TextFrameLayoutResult.transform`; the renderer applies it). `vertical-rl` /
+ * `vertical-lr` with per-glyph orientation are **not yet implemented** — they are
+ * accepted by the type but currently laid out as `horizontal-tb`.
+ *
+ * @see {@link https://www.w3.org/TR/css-writing-modes-4/#block-flow | CSS Writing Modes: block flow}
  */
-export type WritingMode = 'horizontal-tb' | 'vertical-rl' | 'vertical-lr';
+export type WritingMode = 'horizontal-tb' | 'vertical-rl' | 'vertical-lr' | 'sideways-rl' | 'sideways-lr';
 /**
  * Character orientation inside a vertical line.
  *
@@ -263,6 +275,18 @@ export interface TextRun {
     fullWidth?: boolean;
     /** Convert small kana to full-size kana. @experimental Accepted in the type but ignored by the layout engine (no-op until implemented). */
     fullSizeKana?: boolean;
+    /**
+     * Free-form metadata for features the layout engine itself never
+     * interprets — e.g. `@vyaz/converters` carrying an `<a>`'s `href` through
+     * to `@vyaz/renderer`, which wraps the run's painted output in `<a
+     * href="…">` for the `browser`/`preserve` presets. A key's meaning is a
+     * contract between whichever writer sets it and whichever reader consumes
+     * it; layout treats this purely as opaque pass-through (no effect on
+     * measurement, wrapping, or positioning). Modelled on unist's `data` node
+     * field (the remark/rehype AST spec) for the same reason: keep the base
+     * type lean instead of growing a named field per cross-cutting feature.
+     */
+    data?: Record<string, string>;
 }
 /**
  * A `TextRun` after the layout engine has resolved its `fontFamily` fallback
@@ -295,6 +319,12 @@ export interface InlineWidget {
      * Negative = widget ascends above the baseline.
      */
     baselineOffset?: number;
+    /**
+     * Opaque key a renderer can use to look up the widget's actual content
+     * (e.g. `renderToSVG`'s `inlineBoxes[id]` SVG fragment). The layout engine
+     * only reserves the `width` × `height` box; it never reads this.
+     */
+    id?: string;
 }
 /**
  * Configuration for list markers (bullet or numbered).
@@ -556,6 +586,20 @@ export interface TextFrame {
      * Ignored when `writingMode === 'horizontal-tb'`.
      */
     textOrientation?: TextOrientation;
+    /**
+     * Rigid clockwise rotation of the **whole** text block, in degrees, applied
+     * after layout as an affine transform about the frame-box centre. This does
+     * **not** affect line breaking, measurement or positioning — only the final
+     * render transform. Mirrors PowerPoint's shape rotation (`<a:xfrm rot>`).
+     *
+     * Composes with `writingMode: 'sideways-*'` (which contributes its own ±90°).
+     * `0`, `90`, `180`, `270` are the exercised values; other angles are accepted
+     * and rotate about the centre without expanding the canvas bounding box.
+     *
+     * The engine folds this together with the writing-mode rotation and reports
+     * the result on `TextFrameLayoutResult.transform`.
+     */
+    rotation?: number;
     /**
      * Base text direction (important for bidi).
      * `'ltr'` = left-to-right, `'rtl'` = right-to-left.

package/dist/types/Document.d.ts.map

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

package/dist/types/TableTypes.d.ts

@@ -0,0 +1,198 @@
+/**
+ * TableTypes.ts — TableFrame input types (Logical level), alongside TextFrame.
+ *
+ * Hierarchy: TableFrame → TableRow[] → TableCell[] → TextFrame (recursive —
+ * a cell's content is laid out and rendered exactly like a normal text box).
+ *
+ * The style surface (per-side widths/colors/patterns, CSS-style 1/2/4-value
+ * shorthand) is deliberately modelled on `svg-table-core`'s `common-types.ts` /
+ * `private-types.ts` (github.com/wootra/svg-table) — a well-shaped API for this
+ * exact problem — adapted so cell content is a `TextFrame` instead of a render
+ * callback, and column/row sizing is measured from that content rather than
+ * required from the caller.
+ *
+ * T0/T1 (this file + TableLayoutEngine.ts): grid sizing + colSpan/rowSpan.
+ * T2: solid per-side borders + uniform corner radius. T3 (this update): dash
+ * patterns + per-side stroke-linecap. Asymmetric corner radii remain a
+ * possible future addition.
+ */
+import type { TextFrame, VerticalAlignment } from './Document.js';
+/**
+ * CSS-style shorthand for a per-side value of type `T`.
+ * `v` = all four sides; `[tb, lr]` = top/bottom, left/right; `[t, r, b, l]` =
+ * one per side (CSS clockwise order).
+ */
+export type Sides<T> = T | [T, T] | [T, T, T, T];
+/** `Sides<number>` — paddings, margins, border widths. */
+export type Widths = Sides<number>;
+/** `Sides<string>` — border colors. */
+export type ColorsOnWidth = Sides<string>;
+/** SVG `stroke-linecap` for a border's dash pattern (or its solid ends). */
+export type BorderLineCap = 'butt' | 'round' | 'square';
+/**
+ * Per-side SVG `stroke-dasharray`. Not a `Sides<number[]>` — a flat
+ * `number[]` (one pattern for every side) is structurally indistinguishable
+ * from a 2- or 4-element `Sides` tuple once the element type is itself an
+ * array, so this is its own explicit union (same shape svg-table-core's
+ * `PatternArrays` uses, for the same reason): `[a, b]` = one pattern on all
+ * four sides; `[[tb], [lr]]` = top/bottom, left/right; `[[t], [r], [b], [l]]`
+ * = one per side (CSS clockwise order). `undefined` (or an absent side) =
+ * solid.
+ */
+export type BorderPatterns = number[] | [number[], number[]] | [number[], number[], number[], number[]];
+/**
+ * Solid per-side border + a uniform corner radius. Shared by `TableStyle`
+ * (the table's own outer border), `TableRowStyle` and `TableCellStyle`.
+ *
+ * @see TableTypes.ts header — modelled on svg-table-core's `BorderStyles`.
+ *      Asymmetric corner radii are a possible future addition; everything
+ *      else in svg-table-core's `BorderStyles` is covered.
+ */
+export interface BorderStyles {
+    /** Per-side border width, CSS shorthand. `0` (absent) = no border on that side. */
+    borderWidths?: Widths;
+    /** Per-side border color, CSS shorthand. Default `'#000'` when a width is set. */
+    borderColors?: ColorsOnWidth;
+    /**
+     * Per-side SVG `stroke-dasharray`. A side with no pattern (or the whole
+     * property absent) is a solid line. `[4, 2]` = 4px dash, 2px gap, repeating.
+     */
+    borderPatterns?: BorderPatterns;
+    /** Per-side `stroke-linecap` for that side's (dashed or solid) line. Default `'butt'`. */
+    borderShapes?: Sides<BorderLineCap>;
+    /** Uniform corner radius (all four corners). Asymmetric radii are a future addition. */
+    rx?: number;
+    /** Uniform corner radius; defaults to `rx` when only one is given. */
+    ry?: number;
+}
+/** Style for a single `TableCell`. Falls back to `TableFrame.defaultCellStyle`. */
+export interface TableCellStyle extends BorderStyles {
+    /** Cell background fill. */
+    bgColor?: string;
+    /** Inner padding, CSS shorthand. Default `8` on all sides. */
+    paddings?: Widths;
+    /** Vertical alignment of the cell's content within its row height. Default `'top'`. */
+    verticalAlign?: VerticalAlignment;
+    /**
+     * Fine-tuning nudge applied to the cell's content position, in px, on top of
+     * padding/alignment/`verticalAlign`. Positive `cx` moves right, positive
+     * `cy` moves down. Default `0`.
+     */
+    cx?: number;
+    /** @see cx */
+    cy?: number;
+    /**
+     * Let content wider/taller than the cell's padding box paint past its
+     * edges instead of being clipped. Default `false` (clipped) — matches
+     * `svg-table-core`'s default.
+     */
+    allowOverflow?: boolean;
+}
+/**
+ * One table cell. `content` is usually a full `TextFrame` — the same
+ * recursive shape as everywhere else in vyaz, laid out and rendered like any
+ * other text box — but can also be a `TableFrame`, nesting a table inside
+ * this cell (distinguished by shape: a `TableFrame` has `rows`, a `TextFrame`
+ * has `paragraphs` — see `isNestedTable` in `TableLayoutEngine.ts`).
+ *
+ * `content.width` and `content.wrap` (`TextFrame`) / `content.width`
+ * (`TableFrame`) are overridden by the table layout (the column width
+ * decides them); set everything else as usual.
+ *
+ * Nesting depth is unbounded here (a `TableFrame` cell can itself contain a
+ * cell with a `TableFrame`, and so on) but `layoutTableFrame` throws past a
+ * hard ceiling (50) as a guard against a pathological/cyclic structure — see
+ * `TableLayoutOptions._depth`. `@vyaz/converters`'s own HTML `<table>`-in-`<table>`
+ * conversion does not yet build this shape (still a follow-up); this is the
+ * `TableFrame`-level primitive it would build on.
+ */
+export interface TableCell {
+    content: TextFrame | TableFrame;
+    /**
+     * Columns this cell spans. Default `1`. `'auto'` — only honoured on the
+     * *last* cell of a row — stretches it to fill every remaining column, so a
+     * ragged/short row lines its trailing border up with the widest row
+     * instead of leaving a gap. Unlike svg-table-core (where the last cell of
+     * *every* row does this implicitly), this is opt-in: a genuinely short
+     * last cell keeps `colSpan: 1` unless you ask for `'auto'`. Elsewhere in a
+     * row (not the last cell) `'auto'` is a no-op (`colSpan: 1`) — expanding a
+     * non-trailing cell would overlap the cells after it.
+     */
+    colSpan?: number | 'auto';
+    /** Rows this cell spans. Default `1`. */
+    rowSpan?: number;
+    style?: Partial<TableCellStyle>;
+    /**
+     * Decorative content anchored to the cell's left edge, vertically centered
+     * in the cell's full height — independent of `content`'s own alignment
+     * (an icon glyph, a status marker, a leading label). Laid out unwrapped at
+     * its own natural size and does *not* contribute to column-width
+     * measurement — a narrow column can make `before`/`after` overlap
+     * `content`, same tradeoff as `allowOverflow`. svg-table-core's `before`
+     * accepts arbitrary render callbacks; this is a `TextFrame` like every
+     * other content slot in vyaz, not an arbitrary-content callback.
+     */
+    before?: TextFrame;
+    /** @see before — anchored to the right edge instead. */
+    after?: TextFrame;
+}
+/** Style for a `TableRow`. Falls back to `TableFrame.defaultRowStyle`. */
+export interface TableRowStyle extends BorderStyles {
+    /** Explicit row height override, in px. Auto (tallest cell) when absent. */
+    height?: number;
+    /** Row background fill, painted under `TableCellStyle.bgColor`. */
+    bgColor?: string;
+}
+export interface TableRow {
+    cells: TableCell[];
+    style?: Partial<TableRowStyle>;
+    /** Informational — a header row (`<thead>`/`<th>`). No layout effect yet. */
+    isHeader?: boolean;
+}
+/** Table-wide style. */
+export interface TableStyle extends BorderStyles {
+    /** Outer margin around the whole table, CSS shorthand. Default `0`. */
+    margins?: Widths;
+    /** Table background fill, painted under row/cell backgrounds. */
+    bgColor?: string;
+    /** Gap between columns, in px. Default `0`. */
+    colGaps?: number;
+    /** Gap between rows, in px. Default `0`. */
+    rowGaps?: number;
+}
+/**
+ * Root table container — sibling of `TextFrame`.
+ *
+ * Column widths are measured from cell content (each cell's natural,
+ * unwrapped width) unless `columnWidths` is given; row heights are measured
+ * from the laid-out cell content unless `rowHeights` is given.
+ */
+export interface TableFrame {
+    rows: TableRow[];
+    /**
+     * Total table width in px. When set and narrower than the natural column
+     * widths, columns shrink proportionally and cell text wraps; when wider,
+     * the extra space is distributed across columns. Auto (sum of natural
+     * column widths) when absent.
+     */
+    width?: number;
+    /**
+     * Total table height in px. When set, row heights (whichever way they
+     * were determined — measured or `rowHeights` below) scale proportionally
+     * to fit it: taller gives every row extra room; shorter shrinks them,
+     * which (unlike `width`) can't be absorbed by reflowing text — content
+     * simply overflows its row past a certain point (see `TableCellStyle.
+     * allowOverflow`). Auto (sum of row heights) when absent.
+     */
+    height?: number;
+    /** Explicit per-column width override, in px. Overrides measurement. */
+    columnWidths?: number[];
+    /** Explicit per-row height override, in px. Overrides measurement. */
+    rowHeights?: number[];
+    style?: Partial<TableStyle>;
+    /** Default style merged under every `TableCell.style`. */
+    defaultCellStyle?: Partial<TableCellStyle>;
+    /** Default style merged under every `TableRow.style`. */
+    defaultRowStyle?: Partial<TableRowStyle>;
+}
+//# sourceMappingURL=TableTypes.d.ts.map

package/dist/types/TableTypes.d.ts.map

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

package/dist/utils/sides.d.ts

@@ -0,0 +1,26 @@
+/**
+ * sides.ts — resolve the CSS-style 1/2/4-value `Sides<T>` shorthand used by
+ * `TableTypes.ts` (`v` | `[tb, lr]` | `[t, r, b, l]`, CSS clockwise order).
+ * `Widths` (numbers — paddings/margins/border widths) and `ColorsOnWidth`
+ * (strings — border colors) are both instances of `Sides<T>`.
+ */
+import type { Sides, Widths, ColorsOnWidth, BorderLineCap, BorderPatterns } from '../types/TableTypes.js';
+export type Side = 'top' | 'right' | 'bottom' | 'left';
+/** Resolve one side of a `Sides<T>` shorthand. `undefined` → `fallback`. */
+export declare function resolveSide<T>(v: Sides<T> | undefined, side: Side, fallback: T): T;
+/** Resolve all four sides of a `Sides<T>` shorthand at once. */
+export declare function resolveAllSides<T>(v: Sides<T> | undefined, fallback: T): Record<Side, T>;
+/** `resolveAllSides` for `Widths` (numbers). Default fallback `0`. */
+export declare function resolveWidths(w: Widths | undefined, fallback?: number): Record<Side, number>;
+/** `resolveAllSides` for `ColorsOnWidth` (strings). Default fallback `'#000'`. */
+export declare function resolveColors(c: ColorsOnWidth | undefined, fallback?: string): Record<Side, string>;
+/**
+ * Resolve `borderPatterns` per side. Not `resolveAllSides` — `BorderPatterns`
+ * isn't a `Sides<number[]>` (see its doc comment): a flat `number[]` (one
+ * pattern for every side) is disambiguated from a 2/4-element tuple of
+ * patterns by inspecting the element type instead.
+ */
+export declare function resolvePatterns(p: BorderPatterns | undefined): Record<Side, number[] | undefined>;
+/** `resolveAllSides` for `borderShapes` (stroke-linecap). Default fallback `'butt'`. */
+export declare function resolveShapes(s: Sides<BorderLineCap> | undefined, fallback?: BorderLineCap): Record<Side, BorderLineCap>;
+//# sourceMappingURL=sides.d.ts.map

package/dist/utils/sides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sides.d.ts","sourceRoot":"","sources":["../../src/utils/sides.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE1G,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvD,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CASlF;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAOxF;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,SAAI,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAEvF;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,QAAQ,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAEnG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,CAajG;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,SAAS,EAAE,QAAQ,GAAE,aAAsB,GAAG,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAEhI"}

package/dist/utils/widths.d.ts

@@ -0,0 +1,16 @@
+/**
+ * widths.ts — resolve the CSS-style 1/2/4-value `Widths` shorthand used by
+ * `TableTypes.ts` (`n` | `[tb, lr]` | `[t, r, b, l]`, CSS clockwise order).
+ */
+import type { Widths } from '../types/TableTypes.js';
+export type Side = 'top' | 'right' | 'bottom' | 'left';
+/** Resolve one side of a `Widths` shorthand. `undefined` → `fallback` (default `0`). */
+export declare function resolveWidth(w: Widths | undefined, side: Side, fallback?: number): number;
+/** Resolve all four sides at once. */
+export declare function resolveWidths(w: Widths | undefined, fallback?: number): {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+//# sourceMappingURL=widths.d.ts.map

package/dist/utils/widths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widths.d.ts","sourceRoot":"","sources":["../../src/utils/widths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvD,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,SAAI,GAAG,MAAM,CASpF;AAED,sCAAsC;AACtC,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,SAAI,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAO/H"}

package/package.json

@@ -1,6 +1,15 @@
 {
   "name": "@vyaz/core",
-  "version": "0.1.0",
+  "version": "0.4.0",
+  "description": "Rich-text layout engine — TypeScript, isomorphic (browser + Bun/Node.js), pixel-perfect typography. TextFrame/paragraph layout plus a TableFrame grid layout (colSpan/rowSpan, borders, nested tables).",
+  "keywords": ["text-layout", "typography", "svg", "table-layout", "rich-text", "font-metrics", "canvas-text"],
+  "license": "MIT",
+  "homepage": "https://sedrew.github.io/vyaz/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sedrew/vyaz.git",
+    "directory": "packages/core"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",