@react-x11/components 0.8.0 → 0.10.0

package/dist/html/layout/grid.d.ts

@@ -0,0 +1,53 @@
+import type { Box } from './boxes.js';
+export interface Cell {
+    box: Box;
+    row: number;
+    column: number;
+    colSpan: number;
+    rowSpan: number;
+}
+/** A table's rows in order, with the row group each is in, and its
+ *  captions. */
+export interface TableRows {
+    rows: Box[];
+    /** Per row, the row group it is in, or null for a row of the table's
+     *  own. */
+    groups: (Box | null)[];
+    captions: Box[];
+}
+/**
+ * A table's rows in the order they are drawn: a header group's first,
+ * wherever it stands, and a footer group's last (CSS 2.1 17.2) — HTML 4
+ * put `<tfoot>` before `<tbody>`, and a document that did would draw its
+ * totals mid-table. Only the first of each is set apart; any other is a
+ * body group.
+ */
+export declare function rowsOf(table: Box): TableRows;
+/** A table's rows, as `rowsOf` gives them, and its grid. */
+export interface TableGrid extends TableRows {
+    cells: Cell[];
+    columnCount: number;
+    /** Per column, the column box it is in, or null. */
+    columnBoxes: (Box | null)[];
+    /** Per column, the column group it is in, or null. */
+    columnGroups: (Box | null)[];
+}
+/**
+ * A table's rows and grid, worked out once per box tree: they come from the
+ * markup alone — a restyle builds the boxes again — while the layout asks
+ * on every pass, at every width a resize goes through, and the collapsing
+ * border model asks too.
+ */
+export declare function tableGrid(table: Box): TableGrid;
+/**
+ * Assign every cell a row and a column, honouring `colspan` and `rowspan`.
+ * The occupancy grid is what makes a `rowspan` in an earlier row push a
+ * later row's cells to the right, which is the bug every naive table
+ * renderer ships with.
+ */
+export declare function gridOf(rows: Box[]): {
+    cells: Cell[];
+    columnCount: number;
+};
+export declare function spanAttr(box: Box, name: string): number;
+//# sourceMappingURL=grid.d.ts.map

package/dist/html/layout/grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../src/html/layout/grid.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,WAAW,IAAI;IACnB,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;gBACgB;AAChB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ;eACW;IACX,MAAM,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC;IACvB,QAAQ,EAAE,GAAG,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,SAAS,CA+B5C;AAED,4DAA4D;AAC5D,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,WAAW,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC;IAC5B,sDAAsD;IACtD,YAAY,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC;CAC9B;AAID;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,SAAS,CA2B/C;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG;IAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CA0B1E;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD"}

package/dist/html/layout/grid.js

@@ -0,0 +1,153 @@
+/**
+ * A table's rows in the order they are drawn: a header group's first,
+ * wherever it stands, and a footer group's last (CSS 2.1 17.2) — HTML 4
+ * put `<tfoot>` before `<tbody>`, and a document that did would draw its
+ * totals mid-table. Only the first of each is set apart; any other is a
+ * body group.
+ */
+export function rowsOf(table) {
+    const rows = [];
+    const groups = [];
+    const captions = [];
+    let header = null;
+    let footer = null;
+    for (const child of table.children) {
+        if (child.kind !== 'table-row-group')
+            continue;
+        const display = child.style.display;
+        if (display === 'table-header-group')
+            header ??= child;
+        else if (display === 'table-footer-group')
+            footer ??= child;
+    }
+    const take = (group) => {
+        for (const row of group.children) {
+            if (row.kind !== 'table-row')
+                continue;
+            rows.push(row);
+            groups.push(group);
+        }
+    };
+    if (header)
+        take(header);
+    for (const child of table.children) {
+        if (child.kind === 'table-caption')
+            captions.push(child);
+        else if (child.kind === 'table-row-group') {
+            if (child !== header && child !== footer)
+                take(child);
+        }
+        else if (child.kind === 'table-row') {
+            rows.push(child);
+            groups.push(null);
+        }
+    }
+    if (footer)
+        take(footer);
+    return { rows, groups, captions };
+}
+const GRIDS = new WeakMap();
+/**
+ * A table's rows and grid, worked out once per box tree: they come from the
+ * markup alone — a restyle builds the boxes again — while the layout asks
+ * on every pass, at every width a resize goes through, and the collapsing
+ * border model asks too.
+ */
+export function tableGrid(table) {
+    let grid = GRIDS.get(table);
+    if (!grid) {
+        const rows = rowsOf(table);
+        const cells = gridOf(rows.rows);
+        const { column, group } = columnsOf(table, cells.columnCount);
+        if (table.style.direction === 'rtl') {
+            // A table right to left has its first column at the right (CSS 2.1
+            // 17.2). The grid is turned round once, here, so the layout, the
+            // collapsing borders and the column backgrounds, which all read it
+            // from the left, agree about where a cell is.
+            const count = cells.columnCount;
+            for (const cell of cells.cells) {
+                cell.column = count - cell.column - cell.colSpan;
+            }
+            column.reverse();
+            group.reverse();
+        }
+        grid = {
+            ...rows,
+            ...cells,
+            columnBoxes: column,
+            columnGroups: group,
+        };
+        GRIDS.set(table, grid);
+    }
+    return grid;
+}
+/**
+ * Assign every cell a row and a column, honouring `colspan` and `rowspan`.
+ * The occupancy grid is what makes a `rowspan` in an earlier row push a
+ * later row's cells to the right, which is the bug every naive table
+ * renderer ships with.
+ */
+export function gridOf(rows) {
+    const cells = [];
+    const occupied = [];
+    let columnCount = 0;
+    const mark = (r, c) => {
+        (occupied[r] ??= [])[c] = true;
+    };
+    const taken = (r, c) => occupied[r]?.[c] === true;
+    for (let r = 0; r < rows.length; r += 1) {
+        let c = 0;
+        for (const box of rows[r].children) {
+            if (box.kind !== 'table-cell')
+                continue;
+            while (taken(r, c))
+                c += 1;
+            const colSpan = Math.max(1, spanAttr(box, 'colspan'));
+            const rowSpan = Math.max(1, spanAttr(box, 'rowspan'));
+            cells.push({ box, row: r, column: c, colSpan, rowSpan });
+            for (let dr = 0; dr < rowSpan; dr += 1) {
+                for (let dc = 0; dc < colSpan; dc += 1)
+                    mark(r + dr, c + dc);
+            }
+            c += colSpan;
+            columnCount = Math.max(columnCount, c);
+        }
+    }
+    return { cells, columnCount };
+}
+export function spanAttr(box, name) {
+    const raw = box.el?.attribs?.[name];
+    if (!raw)
+        return 1;
+    const n = parseInt(raw, 10);
+    return Number.isFinite(n) && n > 0 ? Math.min(n, 1000) : 1;
+}
+/** Which column box and column group each column of the grid is in. */
+function columnsOf(table, count) {
+    const column = new Array(count).fill(null);
+    const group = new Array(count).fill(null);
+    let at = 0;
+    const place = (box, owner, span) => {
+        for (let i = 0; i < span && at < count; i += 1, at += 1) {
+            column[at] = box;
+            group[at] = owner;
+        }
+    };
+    for (const child of table.children) {
+        if (at >= count)
+            break;
+        const display = child.style.display;
+        if (display === 'table-column') {
+            place(child, null, spanAttr(child, 'span'));
+        }
+        else if (display === 'table-column-group') {
+            const columns = child.children.filter((c) => c.style.display === 'table-column');
+            if (!columns.length)
+                place(null, child, spanAttr(child, 'span'));
+            for (const c of columns)
+                place(c, child, spanAttr(c, 'span'));
+        }
+    }
+    return { column, group };
+}
+//# sourceMappingURL=grid.js.map

package/dist/html/layout/grid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.js","sourceRoot":"","sources":["../../../src/html/layout/grid.ts"],"names":[],"mappings":"AAwBA;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,KAAU;IAC/B,MAAM,IAAI,GAAU,EAAE,CAAC;IACvB,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAU,EAAE,CAAC;IAC3B,IAAI,MAAM,GAAe,IAAI,CAAC;IAC9B,IAAI,MAAM,GAAe,IAAI,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB;YAAE,SAAS;QAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;QACpC,IAAI,OAAO,KAAK,oBAAoB;YAAE,MAAM,KAAK,KAAK,CAAC;aAClD,IAAI,OAAO,KAAK,oBAAoB;YAAE,MAAM,KAAK,KAAK,CAAC;IAC9D,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,KAAU,EAAQ,EAAE;QAChC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;gBAAE,SAAS;YACvC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;IACF,IAAI,MAAM;QAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;YAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;aACpD,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAC1C,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM;gBAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACxD,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,IAAI,MAAM;QAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACpC,CAAC;AAYD,MAAM,KAAK,GAAG,IAAI,OAAO,EAAkB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAU;IAClC,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QAC9D,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;YACpC,mEAAmE;YACnE,iEAAiE;YACjE,mEAAmE;YACnE,8CAA8C;YAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC;YAChC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;YACnD,CAAC;YACD,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;QACD,IAAI,GAAG;YACL,GAAG,IAAI;YACP,GAAG,KAAK;YACR,WAAW,EAAE,MAAM;YACnB,YAAY,EAAE,KAAK;SACpB,CAAC;QACF,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,IAAW;IAChC,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,MAAM,QAAQ,GAAgB,EAAE,CAAC;IACjC,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,CAAS,EAAQ,EAAE;QAC1C,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACjC,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,CAAS,EAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAE3E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;gBAAE,SAAS;YACxC,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBAAE,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;YACtD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YACzD,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;gBACvC,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC;oBAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,CAAC,IAAI,OAAO,CAAC;YACb,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAQ,EAAE,IAAY;IAC7C,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG;QAAE,OAAO,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,uEAAuE;AACvE,SAAS,SAAS,CAChB,KAAU,EACV,KAAa;IAEb,MAAM,MAAM,GAAmB,IAAI,KAAK,CAAa,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvE,MAAM,KAAK,GAAmB,IAAI,KAAK,CAAa,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,MAAM,KAAK,GAAG,CAAC,GAAe,EAAE,KAAiB,EAAE,IAAY,EAAQ,EAAE;QACvE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;YACxD,MAAM,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;YACjB,KAAK,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,EAAE,IAAI,KAAK;YAAE,MAAM;QACvB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;QACpC,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;YAC/B,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9C,CAAC;aAAM,IAAI,OAAO,KAAK,oBAAoB,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CACnC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,cAAc,CAC1C,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;YACjE,KAAK,MAAM,CAAC,IAAI,OAAO;gBAAE,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/html/layout/inline.d.ts

@@ -1,5 +1,6 @@
 import type { TextRun } from '../../richtext/index.js';
-import type { Box, LineBox, TextLayoutLike } from './boxes.js';
+import type { ComputedStyle } from '../css/style.js';
+import type { Box, FirstLineStyler, InlineDecoration, LineBox, LineText, TextLayoutLike } from './boxes.js';
 import type { FloatContext } from './floats.js';
 /** The slice of ntk's font manager this needs. Structural, as everywhere. */
 export interface FontsLike {
@@ -9,6 +10,15 @@ export interface FontsLike {
         align?: string;
         direction?: string;
         maxLines?: number;
+        /** What a `maxLines` cut looks like: an ellipsis, or nothing. */
+        overflow?: 'clip' | 'ellipsis';
+        /** A word too long for its line kept whole, past the line's end, or
+         *  cut inside itself — ntk's option, which an engine without it
+         *  leaves at cutting. */
+        overflowWrap?: 'normal' | 'break-word';
+        /** Whether soft wraps are made at all: false is a line to each
+         *  forced break, cut at `maxWidth` where `overflow` says so. ntk's. */
+        wrap?: boolean;
     }): TextLayoutLike;
     match(family: string, style: Record<string, unknown>): {
         metrics(size: number): {
@@ -18,6 +28,25 @@ export interface FontsLike {
         };
     };
 }
+/**
+ * The widest word between spaces in a layout's text: its runs laid out
+ * again with every space a line break, at no width limit. Where a text's
+ * only breaks are spaces that is its min-content width, and where it has
+ * others — a hyphen, a slash — more: an upper bound of it either way. The
+ * other way to ask, a layout of no width, has ntk search every word for a
+ * place to cut it, since none fits, which costs fifteen layouts of this
+ * one. Infinity where the runs are no longer kept.
+ */
+export declare function widestWord(fonts: FontsLike, layout: TextLayoutLike, measured?: boolean): number;
+/**
+ * Whether a layout's text breaks only at its spaces: letters and digits of
+ * the Latin, Greek and Cyrillic scripts, and the punctuation that UAX #14
+ * never breaks after between two letters — no hyphen, slash, `!`, `?`,
+ * `|`, `}`, soft hyphen or ellipsis, and nothing of a script that breaks
+ * between its letters or by dictionary. Where it does, its widest word
+ * (`widestWord`) is exactly its min-content width.
+ */
+export declare function spaceBreaksOnly(layout: TextLayoutLike): boolean;
 /** Code-unit → code-point offsets for a layout's text, built once. */
 export declare function layoutOffsets(layout: TextLayoutLike): number[];
 export interface InlineResult {
@@ -25,6 +54,12 @@ export interface InlineResult {
     height: number;
     /** The widest line — what a shrink-to-fit width takes. */
     width: number;
+    /** The widest row of floats the paragraph placed beside none of its
+     *  lines — all of them, where it has nothing else — side by side. */
+    floatRow?: number;
+    /** Whether a clamp cut the text short: there was more of it than the
+     *  lines it left (`InlineOptions.clamp`). */
+    cut?: boolean;
 }
 export interface InlineOptions {
     fonts: FontsLike | null;
@@ -35,10 +70,125 @@ export interface InlineOptions {
     floats: FloatContext | null;
     /** The block's content-box left edge, in the float context's space. */
     originX: number;
+    /** A `::first-line` colour, for the text before `end` — the first line's
+     *  end, in the document index — whose colour is `from`, the block's. */
+    firstLine?: {
+        color: string;
+        from: string;
+        end: number;
+    };
+    /**
+     * A `::first-line` that sets the first line's fonts, which move where it
+     * breaks: its style, and each box's style on the line (`FirstLineStyler`)
+     * — which the line is found in, a piece at a time (CSS 2.1 5.12.1).
+     */
+    firstLineStyle?: {
+        style: ComputedStyle;
+        styler: FirstLineStyler;
+    };
+    /** Whether any box in the document paints its background through its
+     *  text (`BoxTree.clipText`). */
+    clipText?: boolean;
+    /**
+     * The lines a line-clamp container leaves the block (CSS Overflow 4,
+     * 5.3.1): no more than `lines` of them show, and the last of a cut ends
+     * in an ellipsis where `ellipsis` says — as it does where they are all
+     * the block has and more of the container `follows` them, the clamp
+     * point just after them (4.2).
+     */
+    clamp?: {
+        lines: number;
+        ellipsis: boolean;
+        follows: boolean;
+    };
+    /**
+     * The floats in the content, placed as the lines reach them: `size` lays
+     * one out and answers its outer width, `place` puts it at a height in the
+     * float context's space. Absent, the floats are not the lines' to place —
+     * they were, by an earlier pass over the same lines.
+     */
+    floatBoxes?: {
+        size(box: Box): number;
+        place(box: Box, y: number): void;
+    };
 }
 /**
  * Lay out one inline formatting context. Coordinates in the result are
  * relative to the containing block's content box; the caller translates.
  */
 export declare function layoutInline(block: Box, options: InlineOptions): InlineResult;
+/**
+ * A code-unit offset in a line's layout as a document index, and back:
+ * `textStart` is `layoutStart`, and every spacer before the offset is a
+ * unit of the layout that is no text of the document's. A document offset
+ * with a spacer right at it is past the spacer, where a caret or a range's
+ * start goes — inside a padded box, after its padding — and before it as
+ * a range's `end`, so a selection does not take in the padding after it.
+ */
+export declare function documentOffsetOf(text: LineText, units: number): number;
+export declare function layoutOffsetOf(text: LineText, doc: number, end?: boolean): number;
+/** How deep a box is in the tree — an element inside another is deeper. */
+export declare function depthOf(box: Box): number;
+/** The same, from the first line box or child: a table's baseline is its
+ *  first row's, and so is a table cell's. */
+export declare function firstBaselineIn(box: Box): number | null;
+/**
+ * What an inline box draws around its text, in `s`: the extent of its face
+ * where it has a background, a border or an outline, and null where it
+ * draws none. Its borders are the ones `inlineEdges` just used. Shared with
+ * a pointer move that gives a link a background (`HtmlViewNode`).
+ */
+export declare function inlineDecoration(fonts: FontsLike | null, box: Box, s: ComputedStyle): InlineDecoration | null;
+/** A style's face's ascent and descent, which an inline box's background
+ *  is painted over. */
+export declare function faceExtentOf(fonts: FontsLike, style: ComputedStyle): InlineDecoration;
+/**
+ * The OpenType features a style's text is shaped with: the `font-variant`
+ * longhands' and `font-kerning`'s, then `font-feature-settings`, which has
+ * the last word (CSS Fonts 3, 7.2). One object for each set of them, kept,
+ * because a run's fields are compared by identity — a new object a pass
+ * would find no layout the last pass made.
+ */
+export declare function featuresOf(style: ComputedStyle): Readonly<Record<string, number>> | null;
+/** A run of `text` in `style`: its face, its ink and its rules. Every
+ *  paint field of a run of the document's text is this function's, which
+ *  is what lets a pointer move re-ink a paragraph without laying it out
+ *  again (`HtmlViewNode._hoverInPlace`). */
+export declare function runFor(text: string, style: ComputedStyle): TextRun;
+export declare function hungSpaces(fonts: FontsLike, run: TextRun): RegExp;
+/** The blocks whose lines hold text a box's background shows through. */
+export declare const CLIPPED_TEXT: WeakSet<Box>;
+/**
+ * A layout of the same text with no ink of its own, which an engine draws
+ * in the context's fill — a gradient's, for text a background shows
+ * through; the same runs, so the same glyphs where the first put them.
+ * Null for a layout that was not recorded.
+ */
+export declare function inklessLayout(layout: object): TextLayoutLike | null;
+/** The box whose background a text box's glyphs show: the nearest element
+ *  box from it up to the block its lines are in with `background-clip:
+ *  text`, or null. */
+export declare function clipBoxOf(box: Box | null, block: Box): Box | null;
+/**
+ * CSS's `line-height` expressed as ntk's multiplier.
+ *
+ * ntk multiplies the **font's natural line height** (metrics, line gap
+ * included); CSS's number form multiplies the **font size**. Converting here
+ * rather than passing the CSS number through is the difference between
+ * `line-height: 1.5` meaning 1.5 × 16px and it meaning 1.5 × 19px, which is
+ * a visibly looser document than the author asked for.
+ *
+ * `line-height: 0` is legal and means what it says — lines of no height,
+ * the glyphs overflowing evenly — and ntk's half-leading does exactly that
+ * with a multiplier of 0. The floor is a hair above it rather than the 0.1
+ * it was, which set such lines a tenth of a line apart: the Cocoa engine
+ * takes a zero multiple for none at all.
+ */
+export declare function lineHeightMultiplier(fonts: FontsLike, style: ComputedStyle): number;
+/**
+ * A block's strut: the ascent and descent of a line of nothing in its face,
+ * the half-leading its `line-height` adds shared above and below, as the
+ * text engines set a line (CSS 2.1 10.8.1).
+ */
+export declare function strutOf(fonts: FontsLike, style: ComputedStyle): InlineDecoration;
 //# sourceMappingURL=inline.d.ts.map

package/dist/html/layout/inline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../../../src/html/layout/inline.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGvD,OAAO,KAAK,EAEV,GAAG,EACH,OAAO,EAEP,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,MAAM,CACJ,OAAO,EAAE,OAAO,EAAE,EAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,cAAc,CAAC;IAClB,KAAK,CACH,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B;QACD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG;YACrB,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;YAChB,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;CACH;AAcD,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAS9D;AASD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,GAAG,YAAY,CAkP7E"}
+{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../../../src/html/layout/inline.ts"],"names":[],"mappings":"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"}