gsd-pi 2.10.0 → 2.10.2

package/node_modules/@gsd/native/dist/gsd-parser/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * GSD file parser — native Rust implementation.
+ *
+ * Parses `.gsd/` directory markdown files containing YAML-like frontmatter
+ * and structured sections. Replaces the JS regex-based parser for
+ * performance-critical batch operations.
+ */
+import type { BatchParseResult, FrontmatterResult, NativeRoadmap, SectionResult } from "./types.js";
+export type { BatchParseResult, FrontmatterResult, NativeBoundaryMapEntry, NativeRoadmap, NativeRoadmapSlice, ParsedGsdFile, SectionResult, } from "./types.js";
+/**
+ * Parse YAML-like frontmatter from markdown content.
+ *
+ * Returns `{ metadata, body }` where `metadata` is a JSON string
+ * of the parsed frontmatter key-value pairs. Parse it with `JSON.parse()`.
+ */
+export declare function parseFrontmatter(content: string): FrontmatterResult;
+/**
+ * Extract a section from markdown content by heading name.
+ *
+ * @param content  Markdown content to search.
+ * @param heading  Heading text to match (without the `#` prefix).
+ * @param level    Heading level (default 2 for `##`).
+ */
+export declare function extractSection(content: string, heading: string, level?: number): SectionResult;
+/**
+ * Extract all sections at a given heading level.
+ *
+ * Returns a JSON string mapping heading names to their content.
+ * Parse with `JSON.parse()`.
+ */
+export declare function extractAllSections(content: string, level?: number): string;
+/**
+ * Batch-parse all `.md` files in a `.gsd/` directory tree.
+ *
+ * Reads and parses all markdown files under the given directory.
+ * Each file gets frontmatter parsing and section extraction.
+ */
+export declare function batchParseGsdFiles(directory: string): BatchParseResult;
+/**
+ * Parse a roadmap file's content into structured data.
+ *
+ * Extracts title, vision, success criteria, slices (with risk/depends),
+ * and boundary map entries.
+ */
+export declare function parseRoadmapFile(content: string): NativeRoadmap;

package/node_modules/@gsd/native/dist/gsd-parser/index.js

@@ -0,0 +1,54 @@
+/**
+ * GSD file parser — native Rust implementation.
+ *
+ * Parses `.gsd/` directory markdown files containing YAML-like frontmatter
+ * and structured sections. Replaces the JS regex-based parser for
+ * performance-critical batch operations.
+ */
+import { native } from "../native.js";
+/**
+ * Parse YAML-like frontmatter from markdown content.
+ *
+ * Returns `{ metadata, body }` where `metadata` is a JSON string
+ * of the parsed frontmatter key-value pairs. Parse it with `JSON.parse()`.
+ */
+export function parseFrontmatter(content) {
+    return native.parseFrontmatter(content);
+}
+/**
+ * Extract a section from markdown content by heading name.
+ *
+ * @param content  Markdown content to search.
+ * @param heading  Heading text to match (without the `#` prefix).
+ * @param level    Heading level (default 2 for `##`).
+ */
+export function extractSection(content, heading, level) {
+    return native.extractSection(content, heading, level);
+}
+/**
+ * Extract all sections at a given heading level.
+ *
+ * Returns a JSON string mapping heading names to their content.
+ * Parse with `JSON.parse()`.
+ */
+export function extractAllSections(content, level) {
+    return native.extractAllSections(content, level);
+}
+/**
+ * Batch-parse all `.md` files in a `.gsd/` directory tree.
+ *
+ * Reads and parses all markdown files under the given directory.
+ * Each file gets frontmatter parsing and section extraction.
+ */
+export function batchParseGsdFiles(directory) {
+    return native.batchParseGsdFiles(directory);
+}
+/**
+ * Parse a roadmap file's content into structured data.
+ *
+ * Extracts title, vision, success criteria, slices (with risk/depends),
+ * and boundary map entries.
+ */
+export function parseRoadmapFile(content) {
+    return native.parseRoadmapFile(content);
+}

package/node_modules/@gsd/native/dist/gsd-parser/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * GSD file parser type definitions.
+ *
+ * Types for the native Rust parser that handles `.gsd/` directory files
+ * containing YAML-like frontmatter and markdown sections.
+ */
+export interface FrontmatterResult {
+    /** Parsed frontmatter as a JSON string of key-value pairs. */
+    metadata: string;
+    /** Body content after the frontmatter block. */
+    body: string;
+}
+export interface SectionResult {
+    /** The section content, or empty string if not found. */
+    content: string;
+    /** Whether the section was found. */
+    found: boolean;
+}
+export interface ParsedGsdFile {
+    /** Relative path from the base directory. */
+    path: string;
+    /** Parsed frontmatter as JSON string. */
+    metadata: string;
+    /** Body content after frontmatter. */
+    body: string;
+    /** Map of section heading to content, serialized as JSON. */
+    sections: string;
+}
+export interface BatchParseResult {
+    /** All parsed files. */
+    files: ParsedGsdFile[];
+    /** Number of files processed. */
+    count: number;
+}
+export interface NativeRoadmapSlice {
+    id: string;
+    title: string;
+    risk: string;
+    depends: string[];
+    done: boolean;
+    demo: string;
+}
+export interface NativeBoundaryMapEntry {
+    fromSlice: string;
+    toSlice: string;
+    produces: string;
+    consumes: string;
+}
+export interface NativeRoadmap {
+    title: string;
+    vision: string;
+    successCriteria: string[];
+    slices: NativeRoadmapSlice[];
+    boundaryMap: NativeBoundaryMapEntry[];
+}

package/node_modules/@gsd/native/dist/gsd-parser/types.js

@@ -0,0 +1,7 @@
+/**
+ * GSD file parser type definitions.
+ *
+ * Types for the native Rust parser that handles `.gsd/` directory files
+ * containing YAML-like frontmatter and markdown sections.
+ */
+export {};

package/node_modules/@gsd/native/{src/highlight/index.ts → dist/highlight/index.d.ts}

@@ -4,12 +4,8 @@
  * Provides ANSI-colored output for code blocks using semantic scope matching
  * across 11 token categories.
  */
-
-import { native } from "../native.js";
 import type { HighlightColors } from "./types.js";
-
 export type { HighlightColors };
-
 /**
  * Highlight source code and return ANSI-colored output.
  *
@@ -18,27 +14,15 @@ export type { HighlightColors };
  * @param colors - Theme colors as ANSI escape sequences
  * @returns Highlighted code with ANSI color codes
  */
-export function highlightCode(
-  code: string,
-  lang: string | null,
-  colors: HighlightColors,
-): string {
-  return native.highlightCode(code, lang, colors) as string;
-}
-
+export declare function highlightCode(code: string, lang: string | null, colors: HighlightColors): string;
 /**
  * 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: string): boolean {
-  return native.supportsLanguage(lang) as boolean;
-}
-
+export declare function supportsLanguage(lang: string): boolean;
 /**
  * Get list of all supported language names from syntect's default syntax set.
  */
-export function getSupportedLanguages(): string[] {
-  return native.getSupportedLanguages() as string[];
-}
+export declare function getSupportedLanguages(): string[];

package/node_modules/@gsd/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/node_modules/@gsd/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/node_modules/@gsd/native/dist/highlight/types.js

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

package/node_modules/@gsd/native/{src/html/index.ts → dist/html/index.d.ts}

@@ -4,21 +4,12 @@
  * 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";
 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 function htmlToMarkdown(
-  html: string,
-  options?: HtmlToMarkdownOptions,
-): string {
-  return native.htmlToMarkdown(html, options ?? {}) as string;
-}
+export declare function htmlToMarkdown(html: string, options?: HtmlToMarkdownOptions): string;

package/node_modules/@gsd/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/node_modules/@gsd/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/node_modules/@gsd/native/dist/html/types.js

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

package/node_modules/@gsd/native/{src/image/index.ts → dist/image/index.d.ts}

@@ -3,26 +3,13 @@
  *
  * High-performance image decode/encode/resize backed by the Rust `image` crate.
  */
-
-import { native } from "../native.js";
 import type { NativeImageHandle } from "./types.js";
 import { ImageFormat, SamplingFilter } from "./types.js";
-
 export { ImageFormat, SamplingFilter };
 export type { NativeImageHandle };
-
-const NativeImageClass = (native as Record<string, unknown>)
-  .NativeImage as NativeImageConstructor;
-
-interface NativeImageConstructor {
-  parse(bytes: Uint8Array): Promise<NativeImageHandle>;
-}
-
 /**
  * Decode image bytes (PNG, JPEG, WebP, GIF) into a NativeImage handle.
  *
  * Format is auto-detected from the byte content.
  */
-export function parseImage(bytes: Uint8Array): Promise<NativeImageHandle> {
-  return NativeImageClass.parse(bytes);
-}
+export declare function parseImage(bytes: Uint8Array): Promise<NativeImageHandle>;

package/node_modules/@gsd/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/node_modules/@gsd/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/node_modules/@gsd/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/node_modules/@gsd/native/{src/index.ts → dist/index.d.ts}

@@ -13,76 +13,28 @@
  * - image: decode, encode, and resize images
  for autocomplete and @-mention resolution
  */
-
-export {
-  copyToClipboard,
-  readTextFromClipboard,
-  readImageFromClipboard,
-} from "./clipboard/index.js";
+export { copyToClipboard, readTextFromClipboard, readImageFromClipboard, } from "./clipboard/index.js";
 export type { ClipboardImage } from "./clipboard/index.js";
-
-export {
-  highlightCode,
-  supportsLanguage,
-  getSupportedLanguages,
-} from "./highlight/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 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 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 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 { 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 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/node_modules/@gsd/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/node_modules/@gsd/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/node_modules/@gsd/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();