saterminal 0.1.0

package/test/text.test.ts

@@ -0,0 +1,72 @@
+import { describe, expect, test } from "bun:test";
+import { hasHtmlTable, htmlToText, parseHtmlSegments, wrapSegments, wrapText } from "../src/text.ts";
+
+describe("text", () => {
+  test("converts the API html subset into terminal text", () => {
+    expect(htmlToText("<p><strong>Text 1</strong></p><p>Alice&rsquo;s claim&mdash;briefly.</p>")).toBe(
+      "Text 1\nAlice's claim-briefly.",
+    );
+  });
+
+  test("uses media labels instead of leaking svg internals", () => {
+    expect(
+      htmlToText(
+        '<figure><svg aria-label="Line graph titled Exports"><text>90807060</text></svg></figure><p>Read the graph.</p>',
+      ),
+    ).toBe("[Graph: Line graph titled Exports]\nRead the graph.");
+  });
+
+  test("keeps image alt text visible", () => {
+    expect(htmlToText('<p><img alt="Triangle ABC" src="/triangle.png"></p>')).toBe("[Image: Triangle ABC]");
+  });
+
+  test("detects html tables", () => {
+    expect(hasHtmlTable("<p>Text</p>", "<table><tr><td>1</td></tr></table>")).toBe(true);
+    expect(hasHtmlTable("<p>Text</p>")).toBe(false);
+  });
+
+  test("normalizes SAT blank markers", () => {
+    expect(htmlToText("<p>The answer is ______blank because of the data.</p>")).toBe(
+      "The answer is _______ because of the data.",
+    );
+  });
+
+  test("wraps text without dropping words", () => {
+    expect(wrapText("one two three four", 8)).toEqual(["one two", "three", "four"]);
+  });
+
+  test("preserves underline segments from u tags", () => {
+    const segments = parseHtmlSegments("<p>Before <u>underlined claim</u> after.</p>");
+    expect(segments.some((segment) => segment.style.underline && segment.text.includes("underlined claim"))).toBe(true);
+    expect(htmlToText("<p>Before <u>underlined claim</u> after.</p>")).toBe("Before underlined claim after.");
+  });
+
+  test("normalizes API blank spans in parsed segments", () => {
+    const html =
+      '<p>The answer is <span aria-hidden="true">______</span><span class="sr-only">blank</span> because of the data.</p>';
+    const text = parseHtmlSegments(html)
+      .map((segment) => segment.text)
+      .join("")
+      .trim();
+    expect(text).toBe("The answer is _______ because of the data.");
+  });
+
+  test("wraps styled segments without losing underline spans", () => {
+    const segments = parseHtmlSegments("<u>This insightful depiction of a preteen girl</u>");
+    const lines = wrapSegments(segments, 20);
+    expect(lines.flat().some((segment) => segment.style.underline)).toBe(true);
+  });
+
+  test("collapses spacer paragraphs and decodes accented entities in dual-text stimuli", () => {
+    const html = `<p><strong><span role="heading">Text 1</span></strong></p>
+<p>the object that struck the Yucat&aacute;n Peninsula</p>
+<p>&nbsp;</p>
+<p><strong><span role="heading">Text 2</span></strong></p>
+<p>Artemieva argues that an asteroid is plausible.</p>`;
+    const lines = wrapSegments(parseHtmlSegments(html), 40).map((line) => line.map((segment) => segment.text).join(""));
+    const blankLines = lines.filter((line) => !line.trim()).length;
+    expect(blankLines).toBeLessThanOrEqual(2);
+    expect(lines.join("\n")).toContain("Yucatán");
+    expect(lines.join("\n")).not.toContain("&aacute;");
+  });
+});

package/test/viewport.test.ts

@@ -0,0 +1,39 @@
+import { describe, expect, test } from "bun:test";
+import {
+  clampScroll,
+  ensureRangeVisible,
+  ensureRowVisible,
+  maxScroll,
+  scrollBy,
+  scrollPage,
+  scrollToEdge,
+} from "../src/tui/viewport.ts";
+
+describe("viewport", () => {
+  test("clamps scroll to the available content", () => {
+    expect(maxScroll({ scroll: 0, height: 5, contentRows: 12 })).toBe(7);
+    expect(clampScroll({ scroll: -3, height: 5, contentRows: 12 })).toBe(0);
+    expect(clampScroll({ scroll: 20, height: 5, contentRows: 12 })).toBe(7);
+    expect(clampScroll({ scroll: 20, height: 5, contentRows: 3 })).toBe(0);
+  });
+
+  test("scrolls by lines and pages", () => {
+    const viewport = { scroll: 4, height: 5, contentRows: 20 };
+
+    expect(scrollBy(viewport, 2)).toBe(6);
+    expect(scrollBy(viewport, -10)).toBe(0);
+    expect(scrollPage(viewport, 1)).toBe(8);
+    expect(scrollPage(viewport, -1)).toBe(0);
+    expect(scrollToEdge(viewport, "bottom")).toBe(15);
+  });
+
+  test("keeps a selected row or wrapped range visible", () => {
+    const viewport = { scroll: 4, height: 5, contentRows: 20 };
+
+    expect(ensureRowVisible(viewport, 3)).toBe(3);
+    expect(ensureRowVisible(viewport, 8)).toBe(4);
+    expect(ensureRowVisible(viewport, 12)).toBe(8);
+    expect(ensureRangeVisible(viewport, 11, 13)).toBe(9);
+    expect(ensureRangeVisible(viewport, 5, 7)).toBe(4);
+  });
+});

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "types": ["bun"],
+    "allowImportingTsExtensions": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*.ts", "src/**/*.d.ts", "test/**/*.ts"]
+}