@vectojs/markdown 0.21.1 → 0.22.0

package/dist/Markdown.d.ts

@@ -100,6 +100,33 @@ export interface MarkdownOptions {
     virtualize?: boolean | {
         overscan?: number;
     };
+    /**
+     * Give every table body a fixed pixel viewport, so `Table` virtualizes its
+     * rows: only the rows inside that viewport (plus overscan) mount cells and
+     * project `row`/`gridcell` semantics. Off by default.
+     *
+     * This is **not** {@link MarkdownOptions.virtualize}, and the two are
+     * independent. That one windows top-level *blocks* and cannot be combined with
+     * streaming; this one windows the *rows inside one table* and works while
+     * streaming, because `Table.appendRows` already mounts lazily when virtualized.
+     * A streaming reader whose cost is dominated by wide tables wants this one.
+     *
+     * Opt-in rather than automatic because it is a layout change, not just a
+     * performance one: a virtualized `Table` sets its height to exactly this value
+     * and turns its body into an internally scrolling region, so a 200-row table
+     * stops being a 200-row-tall block in the document flow. Applying it past some
+     * row-count threshold would silently reshape long tables.
+     *
+     * Applies to **every** table in the document, short ones included — so a
+     * two-row table is also fixed to this height. That is deliberate: `Table` takes
+     * `viewportHeight` as `readonly` and builds its body clip in the constructor, so
+     * a table cannot start plain and become virtualized once it grows. Every
+     * streamed table is lexed with zero rows the moment its delimiter row arrives,
+     * so a row-count condition would exclude precisely the streaming documents this
+     * option exists for. Choose a height that suits the document's tables, or leave
+     * it unset for mixed content where a few short tables are the whole cost.
+     */
+    tableViewportHeight?: number;
 }
 /**
  * Renders Markdown content into a VectoJS entity tree using {@link marked}.
@@ -159,6 +186,15 @@ export declare class Markdown extends UIComponent {
     private readonly virtualizeBlocks;
     /** Overscan margin (px) added above/below the visible window before mounting. */
     private readonly virtualOverscan;
+    /**
+     * Fixed body viewport for table blocks, from `opts.tableViewportHeight`; `0`
+     * leaves every table in `Table`'s classic grow-to-fit mode.
+     *
+     * Independent of {@link virtualizeBlocks}: that windows top-level blocks and
+     * is incompatible with streaming, whereas `Table`'s row virtualization works
+     * mid-stream because `appendRows` mounts lazily when virtualized.
+     */
+    private readonly tableViewportHeight;
     /** Top-level tokens that produce a child entity, in document order. */
     private virtualTokens;
     /** Fenwick tree over per-block strides (height + blockGap) when virtualizing. */

package/dist/index.js

@@ -3503,6 +3503,15 @@ var Markdown = class _Markdown extends import_ui4.UIComponent {
   virtualizeBlocks;
   /** Overscan margin (px) added above/below the visible window before mounting. */
   virtualOverscan;
+  /**
+   * Fixed body viewport for table blocks, from `opts.tableViewportHeight`; `0`
+   * leaves every table in `Table`'s classic grow-to-fit mode.
+   *
+   * Independent of {@link virtualizeBlocks}: that windows top-level blocks and
+   * is incompatible with streaming, whereas `Table`'s row virtualization works
+   * mid-stream because `appendRows` mounts lazily when virtualized.
+   */
+  tableViewportHeight;
   /** Top-level tokens that produce a child entity, in document order. */
   virtualTokens = null;
   /** Fenwick tree over per-block strides (height + blockGap) when virtualizing. */
@@ -3800,6 +3809,8 @@ var Markdown = class _Markdown extends import_ui4.UIComponent {
     const virt = opts.virtualize;
     this.virtualizeBlocks = virt === true || typeof virt === "object" && virt !== null;
     this.virtualOverscan = typeof virt === "object" && virt !== null && typeof virt.overscan === "number" ? virt.overscan : 800;
+    const tableViewport = opts.tableViewportHeight;
+    this.tableViewportHeight = typeof tableViewport === "number" && Number.isFinite(tableViewport) && tableViewport > 0 ? tableViewport : 0;
     this.content = new import_ui4.Stack({
       direction: "vertical",
       gap: this.theme.blockGap,
@@ -6266,7 +6277,15 @@ var Markdown = class _Markdown extends import_ui4.UIComponent {
             borderColor: t.hrColor,
             bg: t.tableBgColor,
             headerBg: t.tableHeaderBgColor,
-            selectable: this.selectable
+            selectable: this.selectable,
+            // 0 = Table's classic grow-to-fit mode, so the default is unchanged.
+            // Applied unconditionally when set, including to a table that lexes
+            // with zero rows: `Table.viewportHeight` is readonly and its body clip
+            // is built in the constructor, so a table cannot become virtualized
+            // later — and every streamed table starts empty and grows through
+            // `appendRows`. Deciding by row count here would leave exactly the
+            // streaming case this exists for permanently unvirtualized.
+            viewportHeight: this.tableViewportHeight
           }),
           () => this.tableAffordances(tblToken)
         );

package/dist/index.mjs

@@ -3457,6 +3457,15 @@ var Markdown = class _Markdown extends UIComponent3 {
   virtualizeBlocks;
   /** Overscan margin (px) added above/below the visible window before mounting. */
   virtualOverscan;
+  /**
+   * Fixed body viewport for table blocks, from `opts.tableViewportHeight`; `0`
+   * leaves every table in `Table`'s classic grow-to-fit mode.
+   *
+   * Independent of {@link virtualizeBlocks}: that windows top-level blocks and
+   * is incompatible with streaming, whereas `Table`'s row virtualization works
+   * mid-stream because `appendRows` mounts lazily when virtualized.
+   */
+  tableViewportHeight;
   /** Top-level tokens that produce a child entity, in document order. */
   virtualTokens = null;
   /** Fenwick tree over per-block strides (height + blockGap) when virtualizing. */
@@ -3754,6 +3763,8 @@ var Markdown = class _Markdown extends UIComponent3 {
     const virt = opts.virtualize;
     this.virtualizeBlocks = virt === true || typeof virt === "object" && virt !== null;
     this.virtualOverscan = typeof virt === "object" && virt !== null && typeof virt.overscan === "number" ? virt.overscan : 800;
+    const tableViewport = opts.tableViewportHeight;
+    this.tableViewportHeight = typeof tableViewport === "number" && Number.isFinite(tableViewport) && tableViewport > 0 ? tableViewport : 0;
     this.content = new Stack({
       direction: "vertical",
       gap: this.theme.blockGap,
@@ -6220,7 +6231,15 @@ var Markdown = class _Markdown extends UIComponent3 {
             borderColor: t.hrColor,
             bg: t.tableBgColor,
             headerBg: t.tableHeaderBgColor,
-            selectable: this.selectable
+            selectable: this.selectable,
+            // 0 = Table's classic grow-to-fit mode, so the default is unchanged.
+            // Applied unconditionally when set, including to a table that lexes
+            // with zero rows: `Table.viewportHeight` is readonly and its body clip
+            // is built in the constructor, so a table cannot become virtualized
+            // later — and every streamed table starts empty and grows through
+            // `appendRows`. Deciding by row count here would leave exactly the
+            // streaming case this exists for permanently unvirtualized.
+            viewportHeight: this.tableViewportHeight
           }),
           () => this.tableAffordances(tblToken)
         );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectojs/markdown",
-  "version": "0.21.1",
+  "version": "0.22.0",
   "publishConfig": {
     "access": "public"
   },
@@ -56,7 +56,7 @@
     "@vectojs/ui": "workspace:*",
     "esbuild": "^0.28.1",
     "prettier": "^3.9.6",
-    "puppeteer-core": "^25.4.0",
+    "puppeteer-core": "^25.7.0",
     "tsup": "^8.3.5",
     "vitest": "^4.1.10"
   }