gsd-pi 2.10.0 → 2.10.2

package/packages/native/dist/highlight/index.js

@@ -0,0 +1,33 @@
+/**
+ * Syntect-based syntax highlighting via N-API.
+ *
+ * Provides ANSI-colored output for code blocks using semantic scope matching
+ * across 11 token categories.
+ */
+import { native } from "../native.js";
+/**
+ * Highlight source code and return ANSI-colored output.
+ *
+ * @param code - The source code to highlight
+ * @param lang - Language identifier (e.g., "rust", "typescript", "python"), or null for plain text
+ * @param colors - Theme colors as ANSI escape sequences
+ * @returns Highlighted code with ANSI color codes
+ */
+export function highlightCode(code, lang, colors) {
+    return native.highlightCode(code, lang, colors);
+}
+/**
+ * Check if a language is supported for highlighting.
+ *
+ * Returns true if the language has either direct syntect support or a
+ * fallback alias mapping.
+ */
+export function supportsLanguage(lang) {
+    return native.supportsLanguage(lang);
+}
+/**
+ * Get list of all supported language names from syntect's default syntax set.
+ */
+export function getSupportedLanguages() {
+    return native.getSupportedLanguages();
+}

package/packages/native/dist/highlight/types.d.ts

@@ -0,0 +1,25 @@
+/** Theme colors for syntax highlighting as ANSI escape sequences. */
+export interface HighlightColors {
+    /** ANSI color for comments. */
+    comment: string;
+    /** ANSI color for keywords. */
+    keyword: string;
+    /** ANSI color for function names. */
+    function: string;
+    /** ANSI color for variables and identifiers. */
+    variable: string;
+    /** ANSI color for string literals. */
+    string: string;
+    /** ANSI color for numeric literals. */
+    number: string;
+    /** ANSI color for type identifiers. */
+    type: string;
+    /** ANSI color for operators. */
+    operator: string;
+    /** ANSI color for punctuation tokens. */
+    punctuation: string;
+    /** ANSI color for diff inserted lines. */
+    inserted?: string;
+    /** ANSI color for diff deleted lines. */
+    deleted?: string;
+}

package/packages/native/dist/highlight/types.js

@@ -0,0 +1 @@
+export {};

package/packages/native/dist/html/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * HTML to Markdown conversion via native Rust bindings.
+ *
+ * Uses `html-to-markdown-rs` under the hood for high-performance
+ * conversion with optional content cleaning (stripping nav, forms, etc.).
+ */
+import type { HtmlToMarkdownOptions } from "./types.js";
+export type { HtmlToMarkdownOptions };
+/**
+ * Convert an HTML string to Markdown.
+ *
+ * When `cleanContent` is true, boilerplate elements (nav, forms, headers,
+ * footers) are stripped before conversion.
+ */
+export declare function htmlToMarkdown(html: string, options?: HtmlToMarkdownOptions): string;

package/packages/native/dist/html/index.js

@@ -0,0 +1,16 @@
+/**
+ * HTML to Markdown conversion via native Rust bindings.
+ *
+ * Uses `html-to-markdown-rs` under the hood for high-performance
+ * conversion with optional content cleaning (stripping nav, forms, etc.).
+ */
+import { native } from "../native.js";
+/**
+ * Convert an HTML string to Markdown.
+ *
+ * When `cleanContent` is true, boilerplate elements (nav, forms, headers,
+ * footers) are stripped before conversion.
+ */
+export function htmlToMarkdown(html, options) {
+    return native.htmlToMarkdown(html, options ?? {});
+}

package/packages/native/dist/html/types.d.ts

@@ -0,0 +1,7 @@
+/** Options for HTML to Markdown conversion. */
+export interface HtmlToMarkdownOptions {
+    /** Remove navigation elements, forms, headers, footers. */
+    cleanContent?: boolean;
+    /** Skip images during conversion. */
+    skipImages?: boolean;
+}

package/packages/native/dist/html/types.js

@@ -0,0 +1 @@
+export {};

package/packages/native/dist/image/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Native image processing module using N-API.
+ *
+ * High-performance image decode/encode/resize backed by the Rust `image` crate.
+ */
+import type { NativeImageHandle } from "./types.js";
+import { ImageFormat, SamplingFilter } from "./types.js";
+export { ImageFormat, SamplingFilter };
+export type { NativeImageHandle };
+/**
+ * Decode image bytes (PNG, JPEG, WebP, GIF) into a NativeImage handle.
+ *
+ * Format is auto-detected from the byte content.
+ */
+export declare function parseImage(bytes: Uint8Array): Promise<NativeImageHandle>;

package/packages/native/dist/image/index.js

@@ -0,0 +1,18 @@
+/**
+ * Native image processing module using N-API.
+ *
+ * High-performance image decode/encode/resize backed by the Rust `image` crate.
+ */
+import { native } from "../native.js";
+import { ImageFormat, SamplingFilter } from "./types.js";
+export { ImageFormat, SamplingFilter };
+const NativeImageClass = native
+    .NativeImage;
+/**
+ * Decode image bytes (PNG, JPEG, WebP, GIF) into a NativeImage handle.
+ *
+ * Format is auto-detected from the byte content.
+ */
+export function parseImage(bytes) {
+    return NativeImageClass.parse(bytes);
+}

package/packages/native/dist/image/types.d.ts

@@ -0,0 +1,35 @@
+/** Sampling filter for resize operations. */
+export declare enum SamplingFilter {
+    /** Nearest-neighbor sampling (fast, low quality). */
+    Nearest = 1,
+    /** Triangle filter (linear interpolation). */
+    Triangle = 2,
+    /** Catmull-Rom filter with sharper edges. */
+    CatmullRom = 3,
+    /** Gaussian filter for smoother results. */
+    Gaussian = 4,
+    /** Lanczos3 filter for high-quality downscaling. */
+    Lanczos3 = 5
+}
+/** Output image format for encoding. */
+export declare enum ImageFormat {
+    /** PNG (lossless, quality ignored). */
+    PNG = 0,
+    /** JPEG (lossy, quality 0-100). */
+    JPEG = 1,
+    /** WebP (lossless, quality ignored). */
+    WebP = 2,
+    /** GIF (quality ignored). */
+    GIF = 3
+}
+/** Native image handle returned from parse(). */
+export interface NativeImageHandle {
+    /** Image width in pixels. */
+    readonly width: number;
+    /** Image height in pixels. */
+    readonly height: number;
+    /** Encode to bytes in the specified format. Returns a Promise. */
+    encode(format: number, quality: number): Promise<number[]>;
+    /** Resize to the specified dimensions. Returns a new NativeImage Promise. */
+    resize(width: number, height: number, filter: SamplingFilter): Promise<NativeImageHandle>;
+}

package/packages/native/dist/image/types.js

@@ -0,0 +1,26 @@
+/** Sampling filter for resize operations. */
+export var SamplingFilter;
+(function (SamplingFilter) {
+    /** Nearest-neighbor sampling (fast, low quality). */
+    SamplingFilter[SamplingFilter["Nearest"] = 1] = "Nearest";
+    /** Triangle filter (linear interpolation). */
+    SamplingFilter[SamplingFilter["Triangle"] = 2] = "Triangle";
+    /** Catmull-Rom filter with sharper edges. */
+    SamplingFilter[SamplingFilter["CatmullRom"] = 3] = "CatmullRom";
+    /** Gaussian filter for smoother results. */
+    SamplingFilter[SamplingFilter["Gaussian"] = 4] = "Gaussian";
+    /** Lanczos3 filter for high-quality downscaling. */
+    SamplingFilter[SamplingFilter["Lanczos3"] = 5] = "Lanczos3";
+})(SamplingFilter || (SamplingFilter = {}));
+/** Output image format for encoding. */
+export var ImageFormat;
+(function (ImageFormat) {
+    /** PNG (lossless, quality ignored). */
+    ImageFormat[ImageFormat["PNG"] = 0] = "PNG";
+    /** JPEG (lossy, quality 0-100). */
+    ImageFormat[ImageFormat["JPEG"] = 1] = "JPEG";
+    /** WebP (lossless, quality ignored). */
+    ImageFormat[ImageFormat["WebP"] = 2] = "WebP";
+    /** GIF (quality ignored). */
+    ImageFormat[ImageFormat["GIF"] = 3] = "GIF";
+})(ImageFormat || (ImageFormat = {}));

package/packages/native/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @gsd/native — High-performance Rust modules exposed via N-API.
+ *
+ * Modules:
+ * - clipboard: native clipboard access (text + image)
+ * - grep: ripgrep-backed regex search (content + filesystem)
+ * - ps: cross-platform process tree management
+ * - glob: gitignore-respecting filesystem discovery with scan caching
+ * - highlight: syntect-based syntax highlighting
+ * - html: HTML to Markdown conversion
+ * - text: ANSI-aware text measurement and slicing
+ * - fd: fuzzy file path discovery
+ * - image: decode, encode, and resize images
+ for autocomplete and @-mention resolution
+ */
+export { copyToClipboard, readTextFromClipboard, readImageFromClipboard, } from "./clipboard/index.js";
+export type { ClipboardImage } from "./clipboard/index.js";
+export { highlightCode, supportsLanguage, getSupportedLanguages, } from "./highlight/index.js";
+export type { HighlightColors } from "./highlight/index.js";
+export { searchContent, grep } from "./grep/index.js";
+export type { ContextLine, GrepMatch, GrepOptions, GrepResult, SearchMatch, SearchOptions, SearchResult, } from "./grep/index.js";
+export { killTree, listDescendants, processGroupId, killProcessGroup, } from "./ps/index.js";
+export { glob, invalidateFsScanCache } from "./glob/index.js";
+export type { FileType, GlobMatch, GlobOptions, GlobResult, } from "./glob/index.js";
+export { astGrep, astEdit } from "./ast/index.js";
+export type { AstFindMatch, AstFindOptions, AstFindResult, AstReplaceChange, AstReplaceFileChange, AstReplaceOptions, AstReplaceResult, } from "./ast/index.js";
+export { htmlToMarkdown } from "./html/index.js";
+export type { HtmlToMarkdownOptions } from "./html/index.js";
+export { wrapTextWithAnsi, truncateToWidth, sliceWithWidth, extractSegments, sanitizeText, visibleWidth, EllipsisKind, } from "./text/index.js";
+export type { SliceResult, ExtractSegmentsResult } from "./text/index.js";
+export { normalizeForFuzzyMatch, fuzzyFindText, generateDiff, } from "./diff/index.js";
+export type { FuzzyMatchResult, DiffResult } from "./diff/index.js";
+export { fuzzyFind } from "./fd/index.js";
+export type { FuzzyFindMatch, FuzzyFindOptions, FuzzyFindResult, } from "./fd/index.js";
+export { parseImage, ImageFormat, SamplingFilter } from "./image/index.js";
+export type { NativeImageHandle } from "./image/index.js";
+export { ttsrCompileRules, ttsrCheckBuffer, ttsrFreeRules } from "./ttsr/index.js";
+export type { TtsrHandle, TtsrRuleInput } from "./ttsr/index.js";
+export { parseFrontmatter, extractSection as nativeExtractSection, extractAllSections, batchParseGsdFiles, parseRoadmapFile, } from "./gsd-parser/index.js";
+export type { BatchParseResult, FrontmatterResult, NativeBoundaryMapEntry, NativeRoadmap, NativeRoadmapSlice, ParsedGsdFile, SectionResult, } from "./gsd-parser/index.js";

package/packages/native/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * @gsd/native — High-performance Rust modules exposed via N-API.
+ *
+ * Modules:
+ * - clipboard: native clipboard access (text + image)
+ * - grep: ripgrep-backed regex search (content + filesystem)
+ * - ps: cross-platform process tree management
+ * - glob: gitignore-respecting filesystem discovery with scan caching
+ * - highlight: syntect-based syntax highlighting
+ * - html: HTML to Markdown conversion
+ * - text: ANSI-aware text measurement and slicing
+ * - fd: fuzzy file path discovery
+ * - image: decode, encode, and resize images
+ for autocomplete and @-mention resolution
+ */
+export { copyToClipboard, readTextFromClipboard, readImageFromClipboard, } from "./clipboard/index.js";
+export { highlightCode, supportsLanguage, getSupportedLanguages, } from "./highlight/index.js";
+export { searchContent, grep } from "./grep/index.js";
+export { killTree, listDescendants, processGroupId, killProcessGroup, } from "./ps/index.js";
+export { glob, invalidateFsScanCache } from "./glob/index.js";
+export { astGrep, astEdit } from "./ast/index.js";
+export { htmlToMarkdown } from "./html/index.js";
+export { wrapTextWithAnsi, truncateToWidth, sliceWithWidth, extractSegments, sanitizeText, visibleWidth, EllipsisKind, } from "./text/index.js";
+export { normalizeForFuzzyMatch, fuzzyFindText, generateDiff, } from "./diff/index.js";
+export { fuzzyFind } from "./fd/index.js";
+export { parseImage, ImageFormat, SamplingFilter } from "./image/index.js";
+export { ttsrCompileRules, ttsrCheckBuffer, ttsrFreeRules } from "./ttsr/index.js";
+export { parseFrontmatter, extractSection as nativeExtractSection, extractAllSections, batchParseGsdFiles, parseRoadmapFile, } from "./gsd-parser/index.js";

package/packages/native/dist/native.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Native addon loader.
+ *
+ * Locates and loads the compiled Rust N-API addon (`.node` file).
+ * Tries platform-tagged release builds first, then falls back to dev builds.
+ */
+export declare const native: {
+    search: (content: Buffer | Uint8Array, options: unknown) => unknown;
+    grep: (options: unknown) => unknown;
+    killTree: (pid: number, signal: number) => number;
+    listDescendants: (pid: number) => number[];
+    processGroupId: (pid: number) => number | null;
+    killProcessGroup: (pgid: number, signal: number) => boolean;
+    glob: (options: unknown, onMatch?: ((match: unknown) => void) | undefined | null) => Promise<unknown>;
+    invalidateFsScanCache: (path?: string) => void;
+    highlightCode: (code: string, lang: string | null, colors: unknown) => unknown;
+    supportsLanguage: (lang: string) => unknown;
+    getSupportedLanguages: () => unknown;
+    copyToClipboard: (text: string) => void;
+    readTextFromClipboard: () => string | null;
+    readImageFromClipboard: () => Promise<unknown>;
+    astGrep: (options: unknown) => unknown;
+    astEdit: (options: unknown) => unknown;
+    htmlToMarkdown: (html: string, options: unknown) => unknown;
+    wrapTextWithAnsi: (text: string, width: number, tabWidth?: number) => string[];
+    truncateToWidth: (text: string, maxWidth: number, ellipsisKind: number, pad: boolean, tabWidth?: number) => string;
+    sliceWithWidth: (line: string, startCol: number, length: number, strict: boolean, tabWidth?: number) => unknown;
+    extractSegments: (line: string, beforeEnd: number, afterStart: number, afterLen: number, strictAfter: boolean, tabWidth?: number) => unknown;
+    sanitizeText: (text: string) => string;
+    visibleWidth: (text: string, tabWidth?: number) => number;
+    fuzzyFind: (options: unknown) => unknown;
+    normalizeForFuzzyMatch: (text: string) => string;
+    fuzzyFindText: (content: string, oldText: string) => unknown;
+    generateDiff: (oldContent: string, newContent: string, contextLines?: number) => unknown;
+    NativeImage: unknown;
+    ttsrCompileRules: (rules: unknown[]) => number;
+    ttsrCheckBuffer: (handle: number, buffer: string) => string[];
+    ttsrFreeRules: (handle: number) => void;
+    parseFrontmatter: (content: string) => unknown;
+    extractSection: (content: string, heading: string, level?: number) => unknown;
+    extractAllSections: (content: string, level?: number) => string;
+    batchParseGsdFiles: (directory: string) => unknown;
+    parseRoadmapFile: (content: string) => unknown;
+};

package/packages/native/dist/native.js

@@ -0,0 +1,34 @@
+/**
+ * Native addon loader.
+ *
+ * Locates and loads the compiled Rust N-API addon (`.node` file).
+ * Tries platform-tagged release builds first, then falls back to dev builds.
+ */
+import { createRequire } from "node:module";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const addonDir = path.resolve(__dirname, "..", "..", "..", "native", "addon");
+const platformTag = `${process.platform}-${process.arch}`;
+const candidates = [
+    path.join(addonDir, `gsd_engine.${platformTag}.node`),
+    path.join(addonDir, "gsd_engine.dev.node"),
+];
+function loadNative() {
+    const errors = [];
+    for (const candidate of candidates) {
+        try {
+            return require(candidate);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            errors.push(`${candidate}: ${message}`);
+        }
+    }
+    const details = errors.map((e) => `  - ${e}`).join("\n");
+    throw new Error(`Failed to load gsd_engine native addon for ${platformTag}.\n\n` +
+        `Tried:\n${details}\n\n` +
+        `Build with: npm run build:native -w @gsd/native`);
+}
+export const native = loadNative();

package/packages/native/dist/ps/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Cross-platform process tree management via N-API.
+ *
+ * Provides efficient process tree enumeration and termination
+ * using platform-native APIs (libproc on macOS, /proc on Linux,
+ * Toolhelp32 on Windows).
+ */
+/**
+ * Kill a process tree (the process and all its descendants).
+ *
+ * Kills children first (bottom-up) to prevent orphan re-parenting issues.
+ * @param pid - Root process ID
+ * @param signal - Signal to send (e.g. 9 for SIGKILL, 15 for SIGTERM). Ignored on Windows.
+ * @returns Number of processes successfully killed.
+ */
+export declare function killTree(pid: number, signal: number): number;
+/**
+ * List all descendant PIDs of a process.
+ *
+ * @param pid - Parent process ID
+ * @returns Array of descendant PIDs (empty if no children or process doesn't exist).
+ */
+export declare function listDescendants(pid: number): number[];
+/**
+ * Get the process group ID for a process.
+ *
+ * @param pid - Process ID
+ * @returns Process group ID, or null if the process doesn't exist or on Windows.
+ */
+export declare function processGroupId(pid: number): number | null;
+/**
+ * Kill an entire process group.
+ *
+ * @param pgid - Process group ID
+ * @param signal - Signal to send
+ * @returns true if the signal was delivered, false on failure or Windows.
+ */
+export declare function killProcessGroup(pgid: number, signal: number): boolean;

package/packages/native/dist/ps/index.js

@@ -0,0 +1,47 @@
+/**
+ * Cross-platform process tree management via N-API.
+ *
+ * Provides efficient process tree enumeration and termination
+ * using platform-native APIs (libproc on macOS, /proc on Linux,
+ * Toolhelp32 on Windows).
+ */
+import { native } from "../native.js";
+/**
+ * Kill a process tree (the process and all its descendants).
+ *
+ * Kills children first (bottom-up) to prevent orphan re-parenting issues.
+ * @param pid - Root process ID
+ * @param signal - Signal to send (e.g. 9 for SIGKILL, 15 for SIGTERM). Ignored on Windows.
+ * @returns Number of processes successfully killed.
+ */
+export function killTree(pid, signal) {
+    return native.killTree(pid, signal);
+}
+/**
+ * List all descendant PIDs of a process.
+ *
+ * @param pid - Parent process ID
+ * @returns Array of descendant PIDs (empty if no children or process doesn't exist).
+ */
+export function listDescendants(pid) {
+    return native.listDescendants(pid);
+}
+/**
+ * Get the process group ID for a process.
+ *
+ * @param pid - Process ID
+ * @returns Process group ID, or null if the process doesn't exist or on Windows.
+ */
+export function processGroupId(pid) {
+    return native.processGroupId(pid);
+}
+/**
+ * Kill an entire process group.
+ *
+ * @param pgid - Process group ID
+ * @param signal - Signal to send
+ * @returns true if the signal was delivered, false on failure or Windows.
+ */
+export function killProcessGroup(pgid, signal) {
+    return native.killProcessGroup(pgid, signal);
+}

package/packages/native/dist/ps/types.d.ts

@@ -0,0 +1,5 @@
+/** Result of a process tree kill operation. */
+export interface KillTreeResult {
+    /** Number of processes successfully killed. */
+    killed: number;
+}

package/packages/native/dist/ps/types.js

@@ -0,0 +1 @@
+export {};

package/packages/native/dist/text/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ANSI-aware text measurement and slicing.
+ *
+ * High-performance UTF-16 native implementation with ASCII fast-paths,
+ * single-pass ANSI scanning, and proper Unicode grapheme cluster support.
+ */
+import type { ExtractSegmentsResult, SliceResult } from "./types.js";
+export type { ExtractSegmentsResult, SliceResult };
+export { EllipsisKind } from "./types.js";
+/**
+ * Word-wrap text to a visible width, preserving ANSI escape codes across
+ * line breaks.
+ *
+ * Active SGR codes (colors, bold, etc.) are carried to continuation lines.
+ * Underline and strikethrough are reset at line ends and restored on the
+ * next line.
+ */
+export declare function wrapTextWithAnsi(text: string, width: number, tabWidth?: number): string[];
+/**
+ * Truncate text to a visible width with an optional ellipsis.
+ *
+ * @param text       Input string (may contain ANSI codes).
+ * @param maxWidth   Maximum visible width in terminal cells.
+ * @param ellipsisKind  0 = "\u2026", 1 = "...", 2 = none.
+ * @param pad        When true, pad with spaces to exactly `maxWidth`.
+ * @param tabWidth   Tab stop width (default 3, range 1-16).
+ */
+export declare function truncateToWidth(text: string, maxWidth: number, ellipsisKind: number, pad: boolean, tabWidth?: number): string;
+/**
+ * Slice a range of visible columns from a line.
+ *
+ * Counts terminal cells (skipping ANSI escapes). When `strict` is true,
+ * wide characters that would exceed the range are excluded.
+ */
+export declare function sliceWithWidth(line: string, startCol: number, length: number, strict: boolean, tabWidth?: number): SliceResult;
+/**
+ * Extract the before/after segments around an overlay region.
+ *
+ * ANSI state is tracked so the `after` segment renders correctly even when
+ * the overlay truncates styled text.
+ */
+export declare function extractSegments(line: string, beforeEnd: number, afterStart: number, afterLen: number, strictAfter: boolean, tabWidth?: number): ExtractSegmentsResult;
+/**
+ * Strip ANSI escape sequences, remove control characters and lone
+ * surrogates, and normalize line endings (CR removed).
+ *
+ * Returns the original string when no changes are needed (zero-copy).
+ */
+export declare function sanitizeText(text: string): string;
+/**
+ * Calculate visible width of text excluding ANSI escape sequences.
+ *
+ * Tabs count as `tabWidth` cells (default 3).
+ */
+export declare function visibleWidth(text: string, tabWidth?: number): number;

package/packages/native/dist/text/index.js

@@ -0,0 +1,66 @@
+/**
+ * ANSI-aware text measurement and slicing.
+ *
+ * High-performance UTF-16 native implementation with ASCII fast-paths,
+ * single-pass ANSI scanning, and proper Unicode grapheme cluster support.
+ */
+import { native } from "../native.js";
+export { EllipsisKind } from "./types.js";
+/**
+ * Word-wrap text to a visible width, preserving ANSI escape codes across
+ * line breaks.
+ *
+ * Active SGR codes (colors, bold, etc.) are carried to continuation lines.
+ * Underline and strikethrough are reset at line ends and restored on the
+ * next line.
+ */
+export function wrapTextWithAnsi(text, width, tabWidth) {
+    return native.wrapTextWithAnsi(text, width, tabWidth);
+}
+/**
+ * Truncate text to a visible width with an optional ellipsis.
+ *
+ * @param text       Input string (may contain ANSI codes).
+ * @param maxWidth   Maximum visible width in terminal cells.
+ * @param ellipsisKind  0 = "\u2026", 1 = "...", 2 = none.
+ * @param pad        When true, pad with spaces to exactly `maxWidth`.
+ * @param tabWidth   Tab stop width (default 3, range 1-16).
+ */
+export function truncateToWidth(text, maxWidth, ellipsisKind, pad, tabWidth) {
+    return native.truncateToWidth(text, maxWidth, ellipsisKind, pad, tabWidth);
+}
+/**
+ * Slice a range of visible columns from a line.
+ *
+ * Counts terminal cells (skipping ANSI escapes). When `strict` is true,
+ * wide characters that would exceed the range are excluded.
+ */
+export function sliceWithWidth(line, startCol, length, strict, tabWidth) {
+    return native.sliceWithWidth(line, startCol, length, strict, tabWidth);
+}
+/**
+ * Extract the before/after segments around an overlay region.
+ *
+ * ANSI state is tracked so the `after` segment renders correctly even when
+ * the overlay truncates styled text.
+ */
+export function extractSegments(line, beforeEnd, afterStart, afterLen, strictAfter, tabWidth) {
+    return native.extractSegments(line, beforeEnd, afterStart, afterLen, strictAfter, tabWidth);
+}
+/**
+ * Strip ANSI escape sequences, remove control characters and lone
+ * surrogates, and normalize line endings (CR removed).
+ *
+ * Returns the original string when no changes are needed (zero-copy).
+ */
+export function sanitizeText(text) {
+    return native.sanitizeText(text);
+}
+/**
+ * Calculate visible width of text excluding ANSI escape sequences.
+ *
+ * Tabs count as `tabWidth` cells (default 3).
+ */
+export function visibleWidth(text, tabWidth) {
+    return native.visibleWidth(text, tabWidth);
+}

package/packages/native/dist/text/types.d.ts

@@ -0,0 +1,27 @@
+/** Result of slicing a line by visible column range. */
+export interface SliceResult {
+    /** The extracted text (may include ANSI codes). */
+    text: string;
+    /** Visible width of the extracted slice in terminal cells. */
+    width: number;
+}
+/** Result of extracting before/after segments around an overlay. */
+export interface ExtractSegmentsResult {
+    /** Text content before the overlay region. */
+    before: string;
+    /** Visible width of the `before` segment. */
+    beforeWidth: number;
+    /** Text content after the overlay region. */
+    after: string;
+    /** Visible width of the `after` segment. */
+    afterWidth: number;
+}
+/** Ellipsis style for truncation. */
+export declare enum EllipsisKind {
+    /** Unicode ellipsis character: \u2026 (width 1) */
+    Unicode = 0,
+    /** ASCII ellipsis: "..." (width 3) */
+    Ascii = 1,
+    /** No ellipsis (hard truncate) */
+    None = 2
+}

package/packages/native/dist/text/types.js

@@ -0,0 +1,10 @@
+/** Ellipsis style for truncation. */
+export var EllipsisKind;
+(function (EllipsisKind) {
+    /** Unicode ellipsis character: \u2026 (width 1) */
+    EllipsisKind[EllipsisKind["Unicode"] = 0] = "Unicode";
+    /** ASCII ellipsis: "..." (width 3) */
+    EllipsisKind[EllipsisKind["Ascii"] = 1] = "Ascii";
+    /** No ellipsis (hard truncate) */
+    EllipsisKind[EllipsisKind["None"] = 2] = "None";
+})(EllipsisKind || (EllipsisKind = {}));

package/packages/native/dist/ttsr/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Native TTSR regex engine.
+ *
+ * Pre-compiles all rule condition patterns into a single Rust RegexSet for
+ * O(1)-style matching per buffer check, replacing per-rule JS regex iteration.
+ */
+import type { TtsrHandle, TtsrRuleInput } from "./types.js";
+export type { TtsrHandle, TtsrRuleInput };
+/**
+ * Compile TTSR rules into an optimized native regex engine.
+ *
+ * Returns an opaque handle for use with `ttsrCheckBuffer` and `ttsrFreeRules`.
+ */
+export declare function ttsrCompileRules(rules: TtsrRuleInput[]): TtsrHandle;
+/**
+ * Check a buffer against compiled TTSR rules.
+ *
+ * Returns an array of unique rule names whose conditions matched.
+ * All patterns are tested in a single pass via Rust's RegexSet.
+ */
+export declare function ttsrCheckBuffer(handle: TtsrHandle, buffer: string): string[];
+/**
+ * Free a compiled TTSR rule set, releasing native memory.
+ *
+ * Call when rules are no longer needed (e.g., session end).
+ */
+export declare function ttsrFreeRules(handle: TtsrHandle): void;