@peaske7/readit 0.1.7 → 0.2.0

package/src/hooks/useThemePreference.ts

@@ -1,66 +0,0 @@
-import { useCallback, useEffect, useState } from "react";
-import { type ThemeMode, ThemeModes } from "../types";
-
-const STORAGE_KEY = "readit:theme";
-
-const DARK_MQ = "(prefers-color-scheme: dark)";
-
-function getStoredTheme(): ThemeMode {
-  try {
-    const stored = localStorage.getItem(STORAGE_KEY);
-    if (
-      stored === ThemeModes.LIGHT ||
-      stored === ThemeModes.DARK ||
-      stored === ThemeModes.SYSTEM
-    ) {
-      return stored;
-    }
-  } catch {
-    // localStorage may be unavailable
-  }
-  return ThemeModes.SYSTEM;
-}
-
-function applyTheme(mode: ThemeMode): void {
-  const isDark =
-    mode === ThemeModes.DARK ||
-    (mode === ThemeModes.SYSTEM && window.matchMedia(DARK_MQ).matches);
-
-  document.documentElement.classList.toggle("dark", isDark);
-}
-
-interface UseThemePreferenceResult {
-  themeMode: ThemeMode;
-  setThemeMode: (mode: ThemeMode) => void;
-}
-
-export function useThemePreference(): UseThemePreferenceResult {
-  const [themeMode, setThemeModeState] = useState<ThemeMode>(getStoredTheme);
-
-  // Apply theme class whenever mode changes
-  useEffect(() => {
-    applyTheme(themeMode);
-  }, [themeMode]);
-
-  // Listen for system preference changes when in "system" mode
-  useEffect(() => {
-    if (themeMode !== ThemeModes.SYSTEM) return;
-
-    const mq = window.matchMedia(DARK_MQ);
-    const handler = () => applyTheme(ThemeModes.SYSTEM);
-
-    mq.addEventListener("change", handler);
-    return () => mq.removeEventListener("change", handler);
-  }, [themeMode]);
-
-  const setThemeMode = useCallback((mode: ThemeMode) => {
-    setThemeModeState(mode);
-    try {
-      localStorage.setItem(STORAGE_KEY, mode);
-    } catch {
-      // localStorage may be unavailable
-    }
-  }, []);
-
-  return { themeMode, setThemeMode };
-}

package/src/lib/comment-storage.bench.ts

@@ -1,63 +0,0 @@
-import { bench, describe } from "vitest";
-import {
-  COMMENT_FILE_LARGE,
-  COMMENT_FILE_MEDIUM,
-  COMMENT_FILE_OBJ_LARGE,
-  COMMENT_FILE_OBJ_MEDIUM,
-  COMMENT_FILE_SMALL,
-  LARGE_DOC,
-} from "./__fixtures__/bench-data";
-import {
-  computeHash,
-  createComment,
-  parseCommentFile,
-  serializeComments,
-} from "./comment-storage";
-
-describe("parseCommentFile", () => {
-  bench("1 comment", () => {
-    parseCommentFile(COMMENT_FILE_SMALL);
-  });
-
-  bench("10 comments", () => {
-    parseCommentFile(COMMENT_FILE_MEDIUM);
-  });
-
-  bench("50 comments", () => {
-    parseCommentFile(COMMENT_FILE_LARGE);
-  });
-});
-
-describe("serializeComments", () => {
-  bench("10 comments", () => {
-    serializeComments(COMMENT_FILE_OBJ_MEDIUM);
-  });
-
-  bench("50 comments", () => {
-    serializeComments(COMMENT_FILE_OBJ_LARGE);
-  });
-});
-
-describe("computeHash", () => {
-  const shortString = "x".repeat(100);
-
-  bench("short string (100 chars)", () => {
-    computeHash(shortString);
-  });
-
-  bench("large doc (~10k chars)", () => {
-    computeHash(LARGE_DOC);
-  });
-});
-
-describe("createComment", () => {
-  bench("short selection", () => {
-    createComment("selected text here", "my comment", 100, 118, LARGE_DOC);
-  });
-
-  const longSelection = "a".repeat(2000);
-
-  bench("long selection (triggers truncation)", () => {
-    createComment(longSelection, "my comment", 0, 2000, LARGE_DOC);
-  });
-});

package/src/lib/context.bench.ts

@@ -1,41 +0,0 @@
-import { bench, describe } from "vitest";
-import { HTML_DOC, LARGE_DOC } from "./__fixtures__/bench-data";
-import { extractContext, formatForLLM, stripHtmlTags } from "./context";
-
-describe("stripHtmlTags", () => {
-  bench("200-line HTML document", () => {
-    stripHtmlTags(HTML_DOC);
-  });
-
-  bench("short HTML string", () => {
-    stripHtmlTags(
-      "<p>Hello &amp; <strong>world</strong> with &#60;entities&#62;</p>",
-    );
-  });
-});
-
-describe("extractContext", () => {
-  bench("single-line selection, markdown", () => {
-    extractContext({ content: LARGE_DOC, startOffset: 500, endOffset: 530 });
-  });
-
-  bench("multi-line selection, markdown", () => {
-    extractContext({ content: LARGE_DOC, startOffset: 500, endOffset: 800 });
-  });
-
-  bench("HTML content (triggers stripHtmlTags)", () => {
-    extractContext({ content: HTML_DOC, startOffset: 100, endOffset: 200 });
-  });
-});
-
-describe("formatForLLM", () => {
-  const ctx = extractContext({
-    content: LARGE_DOC,
-    startOffset: 500,
-    endOffset: 530,
-  });
-
-  bench("format with comment", () => {
-    formatForLLM({ context: ctx, fileName: "doc.md", comment: "Needs review" });
-  });
-});

package/src/lib/context.test.ts

@@ -1,224 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { extractContext, formatForLLM, stripHtmlTags } from "./context";
-
-describe("stripHtmlTags", () => {
-  it("removes simple HTML tags", () => {
-    expect(stripHtmlTags("<p>Hello</p>")).toBe("Hello");
-    expect(stripHtmlTags("<div><span>Nested</span></div>")).toBe("Nested");
-  });
-
-  it("removes script and style content entirely", () => {
-    expect(stripHtmlTags('<script>alert("xss")</script>text')).toBe("text");
-    expect(stripHtmlTags("<style>.foo { color: red }</style>text")).toBe(
-      "text",
-    );
-  });
-
-  it("decodes common named entities", () => {
-    expect(stripHtmlTags("&lt;tag&gt;")).toBe("<tag>");
-    expect(stripHtmlTags("&amp;&nbsp;&quot;&#39;")).toBe("& \"'");
-  });
-
-  it("decodes numeric entities (decimal)", () => {
-    expect(stripHtmlTags("&#65;&#66;&#67;")).toBe("ABC");
-  });
-
-  it("decodes numeric entities (hex)", () => {
-    expect(stripHtmlTags("&#x41;&#x42;&#x43;")).toBe("ABC");
-    expect(stripHtmlTags("&#X41;&#X42;&#X43;")).toBe("ABC"); // case-insensitive
-  });
-
-  it("handles mixed content", () => {
-    const html = "<p>Hello &amp; <strong>World</strong>!</p>";
-    expect(stripHtmlTags(html)).toBe("Hello & World!");
-  });
-
-  it("preserves plain text", () => {
-    expect(stripHtmlTags("plain text")).toBe("plain text");
-  });
-});
-
-describe("extractContext", () => {
-  it("extracts single-line selection with markers", () => {
-    const content = "line1\nline2\nline3\nline4\nline5";
-    // "line2" starts at offset 6, ends at 11
-    const result = extractContext({ content, startOffset: 6, endOffset: 11 });
-
-    expect(result.startLine).toBe(2);
-    expect(result.endLine).toBe(2);
-    // Should have >>> and <<< markers around "line2"
-    expect(result.lines.some((l) => l.includes(">>> line2 <<<"))).toBe(true);
-  });
-
-  it("includes context lines before and after", () => {
-    const content = "line1\nline2\nline3\nline4\nline5";
-    // Select "line3" at offset 12
-    const result = extractContext({
-      content,
-      startOffset: 12,
-      endOffset: 17,
-      contextLines: 2,
-    });
-
-    expect(result.startLine).toBe(3);
-    expect(result.endLine).toBe(3);
-    // Should include 2 lines before (line1, line2) and 2 after (line4, line5)
-    expect(result.lines.length).toBe(5);
-  });
-
-  it("handles multi-line selection", () => {
-    const content = "line1\nline2\nline3\nline4\nline5";
-    // Select from "line2" to "line3" (offset 6 to 17)
-    const result = extractContext({ content, startOffset: 6, endOffset: 17 });
-
-    expect(result.startLine).toBe(2);
-    expect(result.endLine).toBe(3);
-    // Start line should have >>> marker
-    expect(result.lines.some((l) => l.includes(">>>"))).toBe(true);
-    // End line should have <<< marker
-    expect(result.lines.some((l) => l.includes("<<<"))).toBe(true);
-  });
-
-  it("handles selection at start of document", () => {
-    const content = "line1\nline2\nline3";
-    // Select "line1" at start
-    const result = extractContext({ content, startOffset: 0, endOffset: 5 });
-
-    expect(result.startLine).toBe(1);
-    expect(result.endLine).toBe(1);
-    expect(result.lines[0]).toContain(">>> line1 <<<");
-  });
-
-  it("handles selection at end of document", () => {
-    const content = "line1\nline2\nline3";
-    // Select "line3" (offset 12 to 17)
-    const result = extractContext({ content, startOffset: 12, endOffset: 17 });
-
-    expect(result.startLine).toBe(3);
-    expect(result.endLine).toBe(3);
-    expect(result.lines.some((l) => l.includes(">>> line3 <<<"))).toBe(true);
-  });
-
-  it("truncates very long lines", () => {
-    const longLine = "a".repeat(250);
-    const content = `short\n${longLine}\nshort`;
-    // Select part of the long line
-    const result = extractContext({ content, startOffset: 6, endOffset: 256 });
-
-    // Long line should be truncated with ...
-    const longLineOutput = result.lines.find((l) => l.length > 100);
-    expect(longLineOutput?.endsWith("...")).toBe(true);
-  });
-
-  it("handles HTML content by stripping tags", () => {
-    const html = "<p>paragraph</p>\n<div>div content</div>";
-    // After stripping: "paragraph\ndiv content"
-    // Select "paragraph" at offset 0-9
-    const result = extractContext({
-      content: html,
-      startOffset: 0,
-      endOffset: 9,
-    });
-
-    expect(result.lines.some((l) => l.includes(">>> paragraph <<<"))).toBe(
-      true,
-    );
-  });
-
-  it("normalizes CRLF to LF", () => {
-    const content = "line1\r\nline2\r\nline3";
-    // After normalization: "line1\nline2\nline3"
-    // Select "line2" at offset 6
-    const result = extractContext({ content, startOffset: 6, endOffset: 11 });
-
-    expect(result.startLine).toBe(2);
-    expect(result.lines.some((l) => l.includes(">>> line2 <<<"))).toBe(true);
-  });
-
-  it("limits context lines to document bounds", () => {
-    const content = "only\ntwo\nlines";
-    // Select middle line with 5 context lines requested
-    const result = extractContext({
-      content,
-      startOffset: 5,
-      endOffset: 8,
-      contextLines: 5,
-    });
-
-    // Should not go beyond document bounds
-    expect(result.lines.length).toBeLessThanOrEqual(3);
-  });
-
-  it("truncates very long selections with ellipsis", () => {
-    // Create content with more than MAX_SELECTION_LINES (10) lines
-    const lines = Array.from({ length: 15 }, (_, i) => `line${i + 1}`);
-    const content = lines.join("\n");
-    // Select all content
-    const result = extractContext({
-      content,
-      startOffset: 0,
-      endOffset: content.length,
-      contextLines: 0,
-    });
-
-    // Should include ... for truncated middle
-    expect(result.lines.some((l) => l === "...")).toBe(true);
-  });
-});
-
-describe("formatForLLM", () => {
-  it("formats context with header and line range", () => {
-    const context = {
-      lines: ["before", ">>> selected <<<", "after"],
-      startLine: 5,
-      endLine: 5,
-    };
-
-    const result = formatForLLM({ context, fileName: "test.md" });
-
-    expect(result).toContain("# From: test.md");
-    expect(result).toContain("Lines 5-5:");
-    expect(result).toContain("---");
-    expect(result).toContain(">>> selected <<<");
-  });
-
-  it("includes optional comment", () => {
-    const context = {
-      lines: ["text"],
-      startLine: 1,
-      endLine: 1,
-    };
-
-    const result = formatForLLM({
-      context,
-      fileName: "test.md",
-      comment: "This needs review",
-    });
-
-    expect(result).toContain("Comment: This needs review");
-  });
-
-  it("omits comment section when not provided", () => {
-    const context = {
-      lines: ["text"],
-      startLine: 1,
-      endLine: 1,
-    };
-
-    const result = formatForLLM({ context, fileName: "test.md" });
-
-    expect(result).not.toContain("Comment:");
-  });
-
-  it("formats multi-line range correctly", () => {
-    const context = {
-      lines: [">>> start", "middle", "end <<<"],
-      startLine: 10,
-      endLine: 12,
-    };
-
-    const result = formatForLLM({ context, fileName: "doc.html" });
-
-    expect(result).toContain("Lines 10-12:");
-  });
-});

package/src/lib/context.ts

@@ -1,193 +0,0 @@
-/**
- * Context extraction and formatting utilities for LLM clipboard copy.
- */
-
-interface ContextResult {
-  lines: string[]; // Lines with >>> markers inserted
-  startLine: number; // 1-based line number
-  endLine: number; // 1-based line number
-}
-
-interface FormatOptions {
-  context: ContextResult;
-  fileName: string;
-  comment?: string;
-}
-
-/**
- * Parameters for context extraction.
- * Using object destructuring per style guide §3.5 for clarity.
- */
-export interface ExtractContextParams {
-  content: string;
-  startOffset: number;
-  endOffset: number;
-  contextLines?: number;
-}
-
-const DEFAULT_CONTEXT_LINES = 2;
-const MAX_SELECTION_LINES = 10;
-const MAX_LINE_LENGTH = 200;
-
-/**
- * Strip HTML tags to get plain text matching TreeWalker offset calculation.
- */
-export function stripHtmlTags(html: string): string {
-  // Remove script/style content entirely
-  let text = html.replace(/<(script|style)[^>]*>[\s\S]*?<\/\1>/gi, "");
-  // Remove all HTML tags
-  text = text.replace(/<[^>]+>/g, "");
-  // Decode common named entities
-  text = text.replace(/&nbsp;/g, " ");
-  text = text.replace(/&lt;/g, "<");
-  text = text.replace(/&gt;/g, ">");
-  text = text.replace(/&amp;/g, "&");
-  text = text.replace(/&quot;/g, '"');
-  text = text.replace(/&#39;/g, "'");
-  // Decode numeric entities (decimal and hex)
-  text = text.replace(/&#(\d+);/g, (_, code) =>
-    String.fromCharCode(Number.parseInt(code, 10)),
-  );
-  text = text.replace(/&#x([0-9a-f]+);/gi, (_, code) =>
-    String.fromCharCode(Number.parseInt(code, 16)),
-  );
-  return text;
-}
-
-/**
- * Detect if content is HTML based on presence of HTML tags.
- */
-function isHtml(content: string): boolean {
-  return /<[a-z][\s\S]*>/i.test(content);
-}
-
-/**
- * Truncate a line if it exceeds max length.
- */
-function truncateLine(
-  line: string,
-  maxLength: number = MAX_LINE_LENGTH,
-): string {
-  if (line.length <= maxLength) return line;
-  return `${line.slice(0, maxLength - 3)}...`;
-}
-
-/**
- * Extract context around a selection using character offsets.
- * Returns lines with >>> and <<< markers inserted at selection boundaries.
- */
-export function extractContext({
-  content,
-  startOffset,
-  endOffset,
-  contextLines = DEFAULT_CONTEXT_LINES,
-}: ExtractContextParams): ContextResult {
-  // For HTML, strip tags to match offset calculation
-  const textContent = isHtml(content) ? stripHtmlTags(content) : content;
-  // Normalize CRLF to LF for consistent offset calculation
-  const normalizedContent = textContent.replace(/\r\n/g, "\n");
-
-  const lines = normalizedContent.split("\n");
-  let currentOffset = 0;
-  let startLineIndex = -1;
-  let endLineIndex = -1;
-  let startCharInLine = 0;
-  let endCharInLine = 0;
-
-  // Find lines containing the selection
-  for (let i = 0; i < lines.length; i++) {
-    const lineLength = lines[i].length;
-    const lineEnd = currentOffset + lineLength;
-
-    if (startLineIndex === -1 && lineEnd >= startOffset) {
-      startLineIndex = i;
-      startCharInLine = startOffset - currentOffset;
-    }
-
-    if (lineEnd >= endOffset) {
-      endLineIndex = i;
-      endCharInLine = endOffset - currentOffset;
-      break;
-    }
-
-    currentOffset += lineLength + 1; // +1 for newline
-  }
-
-  // Handle edge case: couldn't find lines
-  if (startLineIndex === -1) startLineIndex = 0;
-  if (endLineIndex === -1) endLineIndex = lines.length - 1;
-
-  // Calculate context range
-  const contextStart = Math.max(0, startLineIndex - contextLines);
-  const contextEnd = Math.min(lines.length - 1, endLineIndex + contextLines);
-
-  // Build output lines with markers
-  const outputLines: string[] = [];
-  const selectionSpan = endLineIndex - startLineIndex + 1;
-  const shouldTruncateMiddle = selectionSpan > MAX_SELECTION_LINES;
-
-  for (let i = contextStart; i <= contextEnd; i++) {
-    let line = lines[i];
-
-    // Handle truncation for very long selections
-    if (shouldTruncateMiddle) {
-      const showStart = startLineIndex + 2;
-      const showEnd = endLineIndex - 2;
-
-      if (i > showStart && i < showEnd) {
-        if (i === showStart + 1) {
-          outputLines.push("...");
-        }
-        continue;
-      }
-    }
-
-    // Insert markers for selection boundaries
-    if (i === startLineIndex && i === endLineIndex) {
-      // Single line selection
-      const before = line.slice(0, startCharInLine);
-      const selected = line.slice(startCharInLine, endCharInLine);
-      const after = line.slice(endCharInLine);
-      line = `${before}>>> ${selected} <<<${after}`;
-    } else if (i === startLineIndex) {
-      // Start of multi-line selection
-      const before = line.slice(0, startCharInLine);
-      const selected = line.slice(startCharInLine);
-      line = `${before}>>> ${selected}`;
-    } else if (i === endLineIndex) {
-      // End of multi-line selection
-      const selected = line.slice(0, endCharInLine);
-      const after = line.slice(endCharInLine);
-      line = `${selected} <<<${after}`;
-    }
-
-    outputLines.push(truncateLine(line));
-  }
-
-  return {
-    lines: outputLines,
-    startLine: startLineIndex + 1, // 1-based
-    endLine: endLineIndex + 1, // 1-based
-  };
-}
-
-/**
- * Format extracted context for LLM clipboard copy.
- */
-export function formatForLLM({
-  context,
-  fileName,
-  comment,
-}: FormatOptions): string {
-  const header = `# From: ${fileName}`;
-  const lineRange = `Lines ${context.startLine}-${context.endLine}:`;
-  const body = ["---", ...context.lines, "---"].join("\n");
-
-  const parts = [header, "", lineRange, body];
-
-  if (comment) {
-    parts.push("", `Comment: ${comment}`);
-  }
-
-  return parts.join("\n");
-}

package/src/lib/editor-links.ts

@@ -1,59 +0,0 @@
-import { type EditorScheme, EditorSchemes } from "../types";
-
-// Known source file extensions — kept broad to cover common languages
-const EXTENSIONS =
-  "ts|tsx|js|jsx|mjs|cjs|json|md|mdx|css|scss|html|htm|py|rs|go|rb|java|kt|yml|yaml|toml|sh|bash|zsh|sql|graphql|gql|vue|svelte|astro|c|cpp|h|hpp|cs|swift|zig|lua|ex|exs|erl|hrl|elm|clj|cljs|ml|mli|fs|fsx|r|jl|dart|tf|hcl|proto|xml|svg";
-
-// Match file paths with known extensions and optional :line[:col] suffix
-// Requires at least one `/` to avoid matching bare filenames like "README.md"
-const FILE_PATH_RE = new RegExp(
-  `^(?:\\.\\.\\/|\\.\\/)?((?:[\\w@.-]+\\/)+[\\w.-]+\\.(?:${EXTENSIONS}))(?::(\\d+)(?::(\\d+))?)?$`,
-);
-
-export interface FilePathMatch {
-  path: string;
-  line?: number;
-  col?: number;
-}
-
-export function parseFilePath(text: string): FilePathMatch | undefined {
-  const match = FILE_PATH_RE.exec(text.trim());
-  if (!match) return undefined;
-
-  return {
-    path: match[1],
-    line: match[2] ? Number.parseInt(match[2], 10) : undefined,
-    col: match[3] ? Number.parseInt(match[3], 10) : undefined,
-  };
-}
-
-export function buildEditorUri(
-  scheme: EditorScheme,
-  absolutePath: string,
-  line?: number,
-  col?: number,
-): string {
-  if (scheme === EditorSchemes.NONE) return "";
-
-  // vscode://file/path:line:col
-  let uri = `${scheme}://file/${absolutePath}`;
-  if (line !== undefined) {
-    uri += `:${line}`;
-    if (col !== undefined) {
-      uri += `:${col}`;
-    }
-  }
-  return uri;
-}
-
-export function resolveAbsolutePath(
-  relativePath: string,
-  workingDirectory: string,
-): string {
-  if (relativePath.startsWith("/")) return relativePath;
-
-  const base = workingDirectory.endsWith("/")
-    ? workingDirectory
-    : `${workingDirectory}/`;
-  return `${base}${relativePath}`;
-}

package/src/lib/export.bench.ts

@@ -1,35 +0,0 @@
-import { bench, describe } from "vitest";
-import {
-  COMMENTS_1,
-  COMMENTS_10,
-  COMMENTS_50,
-} from "./__fixtures__/bench-data";
-import { generatePrompt, generateRawText } from "./export";
-
-describe("generatePrompt", () => {
-  bench("1 comment", () => {
-    generatePrompt(COMMENTS_1, "test.md");
-  });
-
-  bench("10 comments", () => {
-    generatePrompt(COMMENTS_10, "test.md");
-  });
-
-  bench("50 comments", () => {
-    generatePrompt(COMMENTS_50, "test.md");
-  });
-});
-
-describe("generateRawText", () => {
-  bench("1 comment", () => {
-    generateRawText(COMMENTS_1);
-  });
-
-  bench("10 comments", () => {
-    generateRawText(COMMENTS_10);
-  });
-
-  bench("50 comments", () => {
-    generateRawText(COMMENTS_50);
-  });
-});