@orz/ui-ansi 0.0.0-stage → 0.0.0

package/dist/view/use-search.js

@@ -0,0 +1,205 @@
+import { useEffect, useState, useSyncExternalStore } from "react";
+import { compileQuery, createMatchSink, growMatchLines, scanLines, } from "./search.js";
+import { runSlices } from "./time-slices.js";
+/** How long the query and flags must stay unchanged before a scan starts. */
+export const SEARCH_DEBOUNCE_MS = 150;
+// Lines scanned between deadline checks.
+const CHUNK = 256;
+/**
+ * True when `next` keeps the first `scanned` ids of `prev`, so the scan can
+ * carry on. `appendShownLines` writes into its spare capacity, so a shared
+ * buffer settles it at once; otherwise the scanned prefix is compared.
+ */
+function extendsShown(prev, next, scanned) {
+    if (!prev || !next)
+        return prev === next;
+    if (next.length < scanned)
+        return false;
+    if (next.buffer === prev.buffer && next.byteOffset === prev.byteOffset) {
+        return true;
+    }
+    for (let i = 0; i < scanned; i++)
+        if (next[i] !== prev[i])
+            return false;
+    return true;
+}
+class SearchStore {
+    listeners = new Set();
+    input = null;
+    re = null;
+    error = null;
+    sink = createMatchSink();
+    // The lines and shown list the scan has read from; `cursor` positions in them.
+    lines = [];
+    shown = null;
+    cursor = 0;
+    timer;
+    stopSlices = null;
+    generation = 0;
+    snapshot = {
+        matches: new Uint32Array(0),
+        count: 0,
+        capped: false,
+        scanning: false,
+        matchLines: this.sink.matchLines,
+        error: null,
+        generation: 0,
+    };
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    };
+    getSnapshot = () => this.snapshot;
+    update(next) {
+        const prev = this.input;
+        this.input = next;
+        if (next.query === "") {
+            this.halt();
+            this.re = null;
+            this.error = null;
+            if (this.sink.count > 0 || this.sink.capped) {
+                this.sink = createMatchSink(next.count);
+            }
+        }
+        else {
+            const retyped = !prev ||
+                prev.query !== next.query ||
+                prev.caseSensitive !== next.caseSensitive ||
+                prev.regex !== next.regex;
+            // Results scanned from other text, or from lines the filter now hides,
+            // must not outlive the wait: their ids no longer point where they did.
+            const stale = this.re !== null &&
+                (next.lines !== this.lines ||
+                    !extendsShown(this.shown, next.shown, this.cursor));
+            if (retyped || (stale && this.timer !== undefined)) {
+                // Typing restarts the wait; the last results stay up until it ends.
+                if (retyped)
+                    this.halt();
+                if (stale)
+                    this.drop(next);
+                if (retyped) {
+                    this.timer = setTimeout(() => {
+                        this.timer = undefined;
+                        this.begin();
+                    }, SEARCH_DEBOUNCE_MS);
+                }
+            }
+            else if (stale) {
+                this.begin();
+                return;
+            }
+            else if (this.re) {
+                this.shown = next.shown;
+                if (this.timer === undefined)
+                    this.kick();
+            }
+        }
+        this.publish();
+    }
+    /** Stops the wait and the scan; the next {@link update} starts afresh. */
+    stop() {
+        this.halt();
+        this.input = null;
+    }
+    halt() {
+        clearTimeout(this.timer);
+        this.timer = undefined;
+        this.stopSlices?.();
+        this.stopSlices = null;
+    }
+    drop(next) {
+        this.generation++;
+        this.sink = createMatchSink(next.count);
+        this.lines = next.lines;
+        this.shown = next.shown;
+        this.cursor = 0;
+    }
+    total() {
+        return this.shown ? this.shown.length : (this.input?.count ?? 0);
+    }
+    begin() {
+        const input = this.input;
+        if (!input)
+            return;
+        this.halt();
+        const re = compileQuery(input.query, input);
+        this.re = re instanceof RegExp ? re : null;
+        this.generation++;
+        this.error = re === "invalid" ? "invalid" : null;
+        this.sink = createMatchSink(input.count);
+        this.lines = input.lines;
+        this.shown = input.shown;
+        this.cursor = 0;
+        this.kick();
+        this.publish();
+    }
+    kick() {
+        const re = this.re;
+        if (!re || this.stopSlices || this.sink.capped)
+            return;
+        if (this.cursor >= this.total())
+            return;
+        const sink = this.sink;
+        const step = (deadline) => {
+            for (;;) {
+                const end = Math.min(this.cursor + CHUNK, this.total());
+                scanLines(re, this.lines, this.shown, this.cursor, end, sink);
+                this.cursor = end;
+                if (sink.capped || end >= this.total()) {
+                    this.stopSlices = null;
+                    return true;
+                }
+                if (performance.now() >= deadline)
+                    return false;
+            }
+        };
+        this.stopSlices = runSlices(step, () => this.publish());
+    }
+    publish() {
+        const sink = this.sink;
+        growMatchLines(sink, this.input?.count ?? 0);
+        const scanning = this.timer !== undefined ||
+            (this.re !== null &&
+                !sink.capped &&
+                (this.cursor < this.total() || !this.input?.done));
+        const prev = this.snapshot;
+        if (prev.count === sink.count &&
+            prev.capped === sink.capped &&
+            prev.scanning === scanning &&
+            prev.matchLines === sink.matchLines &&
+            prev.error === this.error &&
+            prev.generation === this.generation &&
+            prev.matches.buffer === sink.matches.buffer) {
+            return;
+        }
+        this.snapshot = {
+            matches: sink.matches.subarray(0, sink.count * 3),
+            count: sink.count,
+            capped: sink.capped,
+            scanning,
+            matchLines: sink.matchLines,
+            error: this.error,
+            generation: this.generation,
+        };
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+/**
+ * Every match of `query` in the lines `shown` lists, found in time slices
+ * {@link SEARCH_DEBOUNCE_MS} after the query or flags last changed. Lines that
+ * arrive while parsing, and ids appended to `shown`, are scanned as they come;
+ * any other change to `lines` or `shown` starts the scan over.
+ */
+export function useSearch(input) {
+    const [store] = useState(() => new SearchStore());
+    const { query, caseSensitive, regex, lines, count, done, shown } = input;
+    useEffect(() => {
+        store.update({ query, caseSensitive, regex, lines, count, done, shown });
+    }, [store, query, caseSensitive, regex, lines, count, done, shown]);
+    useEffect(() => () => store.stop(), [store]);
+    return useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+}
+//# sourceMappingURL=use-search.js.map

package/dist/view/use-search.js.map

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

package/dist/view/virtual-rows.d.ts

@@ -0,0 +1,36 @@
+import { type CSSProperties, type ReactNode, type RefObject } from "react";
+/** Rows mounted beyond each edge of the viewport. */
+export declare const OVERSCAN = 20;
+/** Scrolling driven from outside, e.g. going to a search match. */
+export interface VirtualRowsHandle {
+    /** The row at the top of the viewport. */
+    topRow(): number;
+    /** Scrolls so that `row` sits at the top of the viewport, or mid-way down it. */
+    scrollToRow(row: number, align: "top" | "center"): void;
+}
+export interface VirtualRowsProps<L> {
+    /** The element that scrolls; the rows mount inside it. */
+    scrollRef: RefObject<HTMLElement | null>;
+    totalRows: number;
+    rowHeight: number;
+    viewportHeight: number;
+    /** The rows' layout width; omitted, the scroll container's. */
+    width?: number;
+    renderRow: (row: number) => ReactNode;
+    /** What the rows are laid out by; a new value may move a line to new rows. */
+    layout: L;
+    /** Where the content at `row` of layout `from` sits in layout `to`. */
+    carryRow: (row: number, from: L, to: L) => number;
+    /** Empty space above the first row and below the last, in px. */
+    padding?: number;
+    /** Merged into the spacer's style, e.g. a background drawn along the rows. */
+    style?: CSSProperties;
+    handle?: RefObject<VirtualRowsHandle | null>;
+}
+/**
+ * Fixed-height rows of which only the visible ones, plus {@link OVERSCAN},
+ * are mounted, under a spacer sized by `scroll-map`. Past its pixel cap the
+ * scroll position maps to rows proportionally.
+ */
+export declare function VirtualRows<L>({ scrollRef, totalRows, rowHeight, viewportHeight, width, renderRow, layout, carryRow, padding, style, handle, }: VirtualRowsProps<L>): import("react").JSX.Element;
+//# sourceMappingURL=virtual-rows.d.ts.map

package/dist/view/virtual-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-rows.d.ts","sourceRoot":"","sources":["../../src/view/virtual-rows.tsx"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,SAAS,EACd,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AAEf,qDAAqD;AACrD,eAAO,MAAM,QAAQ,KAAK,CAAC;AAE3B,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,MAAM,IAAI,MAAM,CAAC;IACjB,iFAAiF;IACjF,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,0DAA0D;IAC1D,SAAS,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;IACtC,8EAA8E;IAC9E,MAAM,EAAE,CAAC,CAAC;IACV,uEAAuE;IACvE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC;IAClD,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CAC9C;AAqBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAC7B,SAAS,EACT,SAAS,EACT,SAAS,EACT,cAAc,EACd,KAAK,EACL,SAAS,EACT,MAAM,EACN,QAAQ,EACR,OAAW,EACX,KAAK,EACL,MAAM,GACP,EAAE,gBAAgB,CAAC,CAAC,CAAC,+BAyJrB"}

package/dist/view/virtual-rows.js

@@ -0,0 +1,156 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { clampTopRow, scrollFromTopRow, scrollGeometry, topRowFromScroll, } from "@orz/ui/lib/scroll-map";
+import { Fragment, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState, } from "react";
+/** Rows mounted beyond each edge of the viewport. */
+export const OVERSCAN = 20;
+/**
+ * `scroll-map` knows only the rows; the padding sits outside them, so the
+ * scroll position is shifted by the top padding before it is mapped.
+ */
+function rowFromScroll(scrollTop, g, padding) {
+    return topRowFromScroll(scrollTop - padding, g);
+}
+/**
+ * The first and last rows map to the very ends, so reaching either shows its
+ * padding too.
+ */
+function scrollFromRow(row, g, padding) {
+    const top = clampTopRow(row, g);
+    if (top === 0)
+        return 0;
+    const scrollTop = scrollFromTopRow(top, g);
+    return top === g.maxTopRow ? scrollTop + 2 * padding : scrollTop + padding;
+}
+/**
+ * Fixed-height rows of which only the visible ones, plus {@link OVERSCAN},
+ * are mounted, under a spacer sized by `scroll-map`. Past its pixel cap the
+ * scroll position maps to rows proportionally.
+ */
+export function VirtualRows({ scrollRef, totalRows, rowHeight, viewportHeight, width, renderRow, layout, carryRow, padding = 0, style, handle, }) {
+    const geometry = useMemo(() => scrollGeometry(totalRows, rowHeight, viewportHeight), [totalRows, rowHeight, viewportHeight]);
+    const geometryRef = useRef(geometry);
+    geometryRef.current = geometry;
+    const layoutRef = useRef(layout);
+    layoutRef.current = layout;
+    const paddingRef = useRef(padding);
+    paddingRef.current = padding;
+    // The top row is kept with the layout it was read in, so a re-wrap keeps
+    // the reader on the same line rather than the same row number. Mounted once
+    // a streamed log passes the threshold, it keeps the place already scrolled to.
+    const [top, setTop] = useState(() => {
+        const el = scrollRef.current;
+        return {
+            row: el ? rowFromScroll(el.scrollTop, geometry, padding) : 0,
+            layout,
+        };
+    });
+    const topRow = clampTopRow(top.layout === layout ? top.row : carryRow(top.row, top.layout, layout), geometry);
+    const topRowRef = useRef(topRow);
+    topRowRef.current = topRow;
+    // Scaled, the element's own scrollTop after a write is rounded; a scroll
+    // event echoing it must not move the top row again.
+    const lastWritten = useRef(-1);
+    const wheelRows = useRef(0);
+    useEffect(() => {
+        const el = scrollRef.current;
+        if (!el)
+            return;
+        const onScroll = () => {
+            const g = geometryRef.current;
+            const scrollTop = el.scrollTop;
+            if (g.scaled && Math.abs(scrollTop - lastWritten.current) <= 1)
+                return;
+            lastWritten.current = scrollTop;
+            const next = rowFromScroll(scrollTop, g, paddingRef.current);
+            topRowRef.current = next;
+            setTop({ row: next, layout: layoutRef.current });
+        };
+        el.addEventListener("scroll", onScroll, { passive: true });
+        return () => el.removeEventListener("scroll", onScroll);
+    }, [scrollRef]);
+    // Scaled, one wheel notch would otherwise cross megabytes of rows.
+    useEffect(() => {
+        const el = scrollRef.current;
+        if (!el || !geometry.scaled)
+            return;
+        const onWheel = (event) => {
+            if (event.ctrlKey || event.deltaY === 0)
+                return;
+            event.preventDefault();
+            const g = geometryRef.current;
+            const unit = event.deltaMode === 1
+                ? g.rowHeight
+                : event.deltaMode === 2
+                    ? g.viewportRows * g.rowHeight
+                    : 1;
+            // Trackpads send a few pixels at a time; they add up to whole rows.
+            wheelRows.current += (event.deltaY * unit) / g.rowHeight;
+            const step = Math.trunc(wheelRows.current);
+            wheelRows.current -= step;
+            if (step) {
+                const next = clampTopRow(topRowRef.current + step, g);
+                topRowRef.current = next;
+                setTop({ row: next, layout: layoutRef.current });
+                const scrollTop = scrollFromRow(next, g, paddingRef.current);
+                lastWritten.current = scrollTop;
+                el.scrollTop = scrollTop;
+            }
+            if (event.deltaX)
+                el.scrollLeft += event.deltaX * unit;
+        };
+        el.addEventListener("wheel", onWheel, { passive: false });
+        return () => el.removeEventListener("wheel", onWheel);
+    }, [geometry.scaled, scrollRef]);
+    useImperativeHandle(handle, () => ({
+        topRow: () => topRowRef.current,
+        scrollToRow(row, align) {
+            const el = scrollRef.current;
+            const g = geometryRef.current;
+            const next = clampTopRow(align === "top" ? row : row - Math.floor((g.viewportRows - 1) / 2), g);
+            topRowRef.current = next;
+            setTop({ row: next, layout: layoutRef.current });
+            if (!el)
+                return;
+            const scrollTop = scrollFromRow(next, g, paddingRef.current);
+            lastWritten.current = scrollTop;
+            el.scrollTop = scrollTop;
+        },
+    }), [scrollRef]);
+    // A resize, more rows, a re-wrap or a switch between 1:1 and scaled moves
+    // the mapping under the top row; the element keeps its old scrollTop.
+    useLayoutEffect(() => {
+        const el = scrollRef.current;
+        if (!el)
+            return;
+        const current = el.scrollTop;
+        if (rowFromScroll(current, geometry, padding) === topRow)
+            return;
+        // 1:1 the rows never move in the spacer. Left at the old bottom, where
+        // the top row sits a padding higher than its mapped place, the view stays
+        // put rather than jump when more rows extend the range.
+        if (!geometry.scaled &&
+            Math.abs(current - scrollFromTopRow(topRow, geometry) - 2 * padding) < 1) {
+            return;
+        }
+        const scrollTop = scrollFromRow(topRow, geometry, padding);
+        lastWritten.current = scrollTop;
+        el.scrollTop = scrollTop;
+    }, [geometry, topRow, scrollRef, padding]);
+    const first = Math.max(0, topRow - OVERSCAN);
+    const end = Math.min(totalRows, topRow + geometry.viewportRows + OVERSCAN);
+    // 1:1 this is padding + first × rowHeight, so the browser scrolls the rows
+    // smoothly; scaled, the top row is pinned to the viewport's top edge.
+    const offset = padding + scrollFromTopRow(topRow, geometry) - (topRow - first) * rowHeight;
+    const rows = [];
+    for (let row = first; row < end; row++) {
+        rows.push(_jsx(Fragment, { children: renderRow(row) }, row));
+    }
+    return (_jsx("div", { className: "relative min-w-full", style: {
+            ...style,
+            height: geometry.spacerHeight + 2 * padding,
+            width,
+            // The overscan below the last rows must not extend the scroll range.
+            overflowY: "clip",
+        }, children: _jsx("div", { className: "absolute top-0 left-0 w-full", style: { transform: `translateY(${offset}px)` }, children: rows }) }));
+}
+//# sourceMappingURL=virtual-rows.js.map

package/dist/view/virtual-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-rows.js","sourceRoot":"","sources":["../../src/view/virtual-rows.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@orz/ui-ansi",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.0",
+  "description": "Text with ANSI escape sequences drawn in the active @orz/ui terminal colours, contributed to the @orz/ui-content registry",
+  "license": "BSD-3-Clause",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/orzFly/ui.git",
+    "directory": "packages/ui-ansi"
+  },
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "exports": {
+    ".": {
+      "@orz/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./parse": {
+      "@orz/source": "./src/parse/index.ts",
+      "types": "./dist/parse/index.d.ts",
+      "default": "./dist/parse/index.js"
+    },
+    "./styles.css": "./styles.css"
+  },
+  "files": [
+    "dist",
+    "styles.css"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "lucide-react": "^1",
+    "react": "^19",
+    "react-dom": "^19",
+    "@orz/ui": "^0.0.0",
+    "@orz/ui-content": "^0.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
+    "happy-dom": "^21.0.3",
+    "lucide-react": "^1.31.0",
+    "radix-ui": "^1.6.7",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "vitest": "^5.0.5",
+    "@orz/themes": "0.0.0",
+    "@orz/ui-content": "0.0.0",
+    "@orz/ui": "0.0.0"
+  },
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
 }

package/styles.css

@@ -0,0 +1,110 @@
+/* Tailwind resolves an imported file's @source against that file, so a
+   consumer importing this stylesheet scans the classes in the package's
+   shipped JS without writing an @source of its own. */
+@source "./dist";
+
+@layer components {
+  .ansi-view ::selection {
+    background: var(--terminal-selection);
+  }
+
+  .ansi-view [data-level="fatal"] {
+    --log-level: var(--ansi-bright-red);
+  }
+  .ansi-view [data-level="error"] {
+    --log-level: var(--ansi-red);
+  }
+  .ansi-view [data-level="warn"] {
+    --log-level: var(--ansi-yellow);
+  }
+  .ansi-view [data-level="info"] {
+    --log-level: var(--ansi-green);
+  }
+  .ansi-view [data-level="debug"] {
+    --log-level: var(--ansi-blue);
+  }
+  .ansi-view [data-level="trace"] {
+    --log-level: var(--ansi-bright-black);
+  }
+
+  /* A background, so the text and run backgrounds paint over it. */
+  .ansi-view
+  [data-line]:is(
+    [data-level="fatal"],
+    [data-level="error"],
+    [data-level="warn"]
+  ) {
+    --log-stripe: var(--log-level);
+    background-color: color-mix(in srgb, var(--log-level) 12%, transparent);
+  }
+  /* In the scroll container's left padding (its px-3): on the row itself it
+     would cover the first glyph of a pane, or of a one-digit gutter. */
+  .ansi-view
+  [data-line]:is(
+    [data-level="fatal"],
+    [data-level="error"],
+    [data-level="warn"]
+  )::after {
+    content: "";
+    position: absolute;
+    inset-block: 0;
+    left: -0.75rem;
+    width: 3px;
+    background: var(--log-stripe);
+    pointer-events: none;
+  }
+  .ansi-view [data-line][data-level="warn"] {
+    background-color: color-mix(in srgb, var(--log-level) 10%, transparent);
+  }
+  .ansi-view [data-line][data-inherited] {
+    --log-stripe: color-mix(in srgb, var(--log-level) 50%, transparent);
+  }
+
+  /* On the row, so that only runs without a colour of their own take it. */
+  .ansi-view
+  [data-line]:is([data-level="debug"], [data-level="trace"]):not(
+    [data-coloured]
+  ) {
+    color: color-mix(
+      in oklab,
+      var(--terminal-foreground) 60%,
+      var(--terminal-background)
+    );
+  }
+
+  .ansi-view [data-level-word] {
+    color: var(--log-level);
+    font-weight: 600;
+  }
+  .ansi-view [data-level="fatal"] [data-level-word] {
+    background-color: var(--log-level);
+    color: var(--terminal-background);
+  }
+
+  /* biome-ignore-start lint/complexity/noImportantStyles: run colours are inline styles, which only !important overrides */
+  .ansi-view [data-match] {
+    background-color: color-mix(
+      in srgb,
+      var(--ansi-yellow) 40%,
+      transparent
+    ) !important;
+  }
+  .ansi-view [data-match][data-level-word] {
+    color: inherit;
+  }
+  .ansi-view [data-match="current"] {
+    background-color: var(--ansi-yellow) !important;
+    color: var(--terminal-background) !important;
+  }
+  /* biome-ignore-end lint/complexity/noImportantStyles: run colours are inline styles */
+
+  /* A pseudo-element, so the fixed row height is unchanged. */
+  .ansi-view [data-gap]::before {
+    content: "";
+    position: absolute;
+    inset-inline: 0;
+    top: 0;
+    border-top: 1px dashed var(--ansi-bright-black);
+    pointer-events: none;
+  }
+}