@rohal12/twee-ts 1.14.0 → 1.15.2

package/dist/index.d.cts

@@ -1,284 +1,274 @@
+//#region src/types.d.ts
 /**
  * All public interfaces for twee-ts.
  */
 type OutputMode = 'html' | 'twee3' | 'twee1' | 'twine2-archive' | 'twine1-archive' | 'json';
 type WordCountMethod = 'tweego' | 'whitespace';
 type InlineSource = {
-    filename: string;
-    content: string | Buffer;
+  filename: string;
+  content: string | Buffer;
 };
 type SourceInput = string | InlineSource;
 interface CompileOptions {
-    /** Files, directories, or inline sources to compile. */
-    sources: SourceInput[];
-    /** Output mode. Default: 'html'. */
-    outputMode?: OutputMode;
-    /** Story format directory ID (e.g. 'sugarcube-2'). */
-    formatId?: string;
-    /** Name of the starting passage. Default: 'Start'. */
-    startPassage?: string;
-    /** Extra directories to search for story formats. */
-    formatPaths?: string[];
-    /** Also search TWEEGO_PATH env for formats. Default: true. */
-    useTweegoPath?: boolean;
-    /** Module files to inject into <head>. */
-    modules?: string[];
-    /** Raw HTML file to append to <head>. */
-    headFile?: string;
-    /** Trim passage whitespace. Default: true. */
-    trim?: boolean;
-    /** Twee2 compatibility mode. Default: false. */
-    twee2Compat?: boolean;
-    /** Enable debug/test mode option. Default: false. */
-    testMode?: boolean;
-    /** URLs to SFA-compatible index.json files for remote format lookup. */
-    formatIndices?: string[];
-    /** Direct URLs to format.js files. */
-    formatUrls?: string[];
-    /** Disable remote format fetching. Default: false. */
-    noRemote?: boolean;
-    /** Map alias tags to canonical special tags (e.g. { library: 'script' }). */
-    tagAliases?: Record<string, string>;
-    /** Emit source file and line as data- attributes on passage elements. Default: false. */
-    sourceInfo?: boolean;
-    /** Word counting method. Default: 'tweego'. */
-    wordCountMethod?: WordCountMethod;
+  /** Files, directories, or inline sources to compile. */
+  sources: SourceInput[];
+  /** Output mode. Default: 'html'. */
+  outputMode?: OutputMode;
+  /** Story format directory ID (e.g. 'sugarcube-2'). */
+  formatId?: string;
+  /** Name of the starting passage. Default: 'Start'. */
+  startPassage?: string;
+  /** Extra directories to search for story formats. */
+  formatPaths?: string[];
+  /** Also search TWEEGO_PATH env for formats. Default: true. */
+  useTweegoPath?: boolean;
+  /** Module files to inject into <head>. */
+  modules?: string[];
+  /** Raw HTML file to append to <head>. */
+  headFile?: string;
+  /** Trim passage whitespace. Default: true. */
+  trim?: boolean;
+  /** Twee2 compatibility mode. Default: false. */
+  twee2Compat?: boolean;
+  /** Enable debug/test mode option. Default: false. */
+  testMode?: boolean;
+  /** URLs to SFA-compatible index.json files for remote format lookup. */
+  formatIndices?: string[];
+  /** Direct URLs to format.js files. */
+  formatUrls?: string[];
+  /** Disable remote format fetching. Default: false. */
+  noRemote?: boolean;
+  /** Map alias tags to canonical special tags (e.g. { library: 'script' }). */
+  tagAliases?: Record<string, string>;
+  /** Emit source file and line as data- attributes on passage elements. Default: false. */
+  sourceInfo?: boolean;
+  /** Word counting method. Default: 'tweego'. */
+  wordCountMethod?: WordCountMethod;
 }
 interface CompileToFileOptions extends CompileOptions {
-    /** Output file path. */
-    outFile: string;
+  /** Output file path. */
+  outFile: string;
 }
 interface WatchOptions extends CompileToFileOptions {
-    /** Called after each successful rebuild. */
-    onBuild?: (result: CompileResult) => void;
-    /** Called on build errors. */
-    onError?: (error: Error) => void;
+  /** Called after each successful rebuild. */
+  onBuild?: (result: CompileResult) => void;
+  /** Called on build errors. */
+  onError?: (error: Error) => void;
 }
 type Diagnostic = {
-    level: 'warning';
-    message: string;
-    file?: string;
-    line?: number;
+  level: 'warning';
+  message: string;
+  file?: string;
+  line?: number;
 } | {
-    level: 'error';
-    message: string;
-    file?: string;
-    line?: number;
-    fatal?: boolean;
+  level: 'error';
+  message: string;
+  file?: string;
+  line?: number;
+  fatal?: boolean;
 };
 interface CompileResult {
-    /** The compiled output string (HTML, Twee, JSON, etc.). */
-    output: string;
-    /** The parsed story model (read-only after compilation). */
-    story: ReadonlyStory;
-    /** The format used for compilation (undefined for non-HTML modes). */
-    format?: StoryFormatInfo;
-    /** Collected diagnostics. */
-    diagnostics: Diagnostic[];
-    /** Compilation statistics. */
-    stats: CompileStats;
+  /** The compiled output string (HTML, Twee, JSON, etc.). */
+  output: string;
+  /** The parsed story model (read-only after compilation). */
+  story: ReadonlyStory;
+  /** The format used for compilation (undefined for non-HTML modes). */
+  format?: StoryFormatInfo;
+  /** Collected diagnostics. */
+  diagnostics: Diagnostic[];
+  /** Compilation statistics. */
+  stats: CompileStats;
 }
 interface CompileStats {
-    passages: number;
-    storyPassages: number;
-    words: number;
-    files: string[];
+  passages: number;
+  storyPassages: number;
+  words: number;
+  files: string[];
 }
 interface SourceLocation {
-    readonly file: string;
-    readonly line: number;
+  readonly file: string;
+  readonly line: number;
 }
 interface PassageMetadata {
-    position?: string;
-    size?: string;
-    [key: string]: string | undefined;
+  position?: string;
+  size?: string;
+  [key: string]: string | undefined;
 }
 interface Passage {
-    name: string;
-    tags: string[];
-    text: string;
-    metadata?: PassageMetadata;
-    source?: SourceLocation;
+  name: string;
+  tags: string[];
+  text: string;
+  metadata?: PassageMetadata;
+  source?: SourceLocation;
 }
 type IFID = string & {
-    readonly __brand: 'IFID';
+  readonly __brand: 'IFID';
 };
 interface Twine1Metadata {
-    settings: Map<string, string>;
+  settings: Map<string, string>;
 }
 interface Twine2Metadata {
-    format: string;
-    formatVersion: string;
-    options: Map<string, boolean>;
-    start: string;
-    tags: string;
-    tagColors: Map<string, string>;
-    zoom: number;
+  format: string;
+  formatVersion: string;
+  options: Map<string, boolean>;
+  start: string;
+  tags: string;
+  tagColors: Map<string, string>;
+  zoom: number;
 }
 interface Story {
-    name: string;
-    ifid: IFID;
-    passages: Passage[];
-    legacyIFID: IFID;
-    twine1: Twine1Metadata;
-    twine2: Twine2Metadata;
+  name: string;
+  ifid: IFID;
+  passages: Passage[];
+  legacyIFID: IFID;
+  twine1: Twine1Metadata;
+  twine2: Twine2Metadata;
 }
 type ReadonlyPassage = Readonly<Passage> & {
-    readonly tags: readonly string[];
+  readonly tags: readonly string[];
 };
 type ReadonlyStory = Readonly<Omit<Story, 'passages' | 'twine1' | 'twine2'>> & {
-    readonly passages: readonly ReadonlyPassage[];
-    readonly twine1: Readonly<Omit<Twine1Metadata, 'settings'>> & {
-        readonly settings: ReadonlyMap<string, string>;
-    };
-    readonly twine2: Readonly<Omit<Twine2Metadata, 'options' | 'tagColors'>> & {
-        readonly options: ReadonlyMap<string, boolean>;
-        readonly tagColors: ReadonlyMap<string, string>;
-    };
+  readonly passages: readonly ReadonlyPassage[];
+  readonly twine1: Readonly<Omit<Twine1Metadata, 'settings'>> & {
+    readonly settings: ReadonlyMap<string, string>;
+  };
+  readonly twine2: Readonly<Omit<Twine2Metadata, 'options' | 'tagColors'>> & {
+    readonly options: ReadonlyMap<string, boolean>;
+    readonly tagColors: ReadonlyMap<string, string>;
+  };
 };
 interface StoryFormatInfo {
-    id: string;
-    filename: string;
-    isTwine2: boolean;
-    name: string;
-    version: string;
-    proofing: boolean;
-    author?: string;
-    description?: string;
-    image?: string;
-    url?: string;
-    license?: string;
+  id: string;
+  filename: string;
+  isTwine2: boolean;
+  name: string;
+  version: string;
+  proofing: boolean;
+  author?: string;
+  description?: string;
+  image?: string;
+  url?: string;
+  license?: string;
 }
 interface Twine2FormatJSON {
-    name: string;
-    version: string;
-    proofing?: boolean;
-    source: string;
-    author?: string;
-    description?: string;
-    image?: string;
-    url?: string;
-    license?: string;
+  name: string;
+  version: string;
+  proofing?: boolean;
+  source: string;
+  author?: string;
+  description?: string;
+  image?: string;
+  url?: string;
+  license?: string;
 }
-declare const ItemType: {
-    readonly Error: 0;
-    readonly EOF: 1;
-    readonly Header: 2;
-    readonly Name: 3;
-    readonly Tags: 4;
-    readonly Metadata: 5;
-    readonly Content: 6;
+export declare const ItemType: {
+  readonly Error: 0;
+  readonly EOF: 1;
+  readonly Header: 2;
+  readonly Name: 3;
+  readonly Tags: 4;
+  readonly Metadata: 5;
+  readonly Content: 6;
 };
-type ItemType = (typeof ItemType)[keyof typeof ItemType];
+export type ItemType = (typeof ItemType)[keyof typeof ItemType];
 interface LexerItem {
-    type: ItemType;
-    line: number;
-    pos: number;
-    val: string;
+  type: ItemType;
+  line: number;
+  pos: number;
+  val: string;
 }
 interface SFAIndexEntry {
-    name: string;
-    version: string;
-    proofing: boolean;
-    files: string[];
-    checksums: Record<string, string>;
+  name: string;
+  version: string;
+  proofing: boolean;
+  files: string[];
+  checksums: Record<string, string>;
 }
 interface SFAIndex {
-    twine1: SFAIndexEntry[];
-    twine2: SFAIndexEntry[];
+  twine1: SFAIndexEntry[];
+  twine2: SFAIndexEntry[];
 }
 interface FileCacheEntry {
-    readonly mtimeMs: number;
-    readonly passages: readonly Passage[];
-    readonly diagnostics: readonly Diagnostic[];
+  readonly mtimeMs: number;
+  readonly passages: readonly Passage[];
+  readonly diagnostics: readonly Diagnostic[];
 }
 interface TweeTsConfig {
-    sources?: string[];
-    output?: string;
-    outputMode?: OutputMode;
-    formatId?: string;
-    startPassage?: string;
-    formatPaths?: string[];
-    formatIndices?: string[];
-    formatUrls?: string[];
-    useTweegoPath?: boolean;
-    modules?: string[];
-    headFile?: string;
-    trim?: boolean;
-    twee2Compat?: boolean;
-    testMode?: boolean;
-    noRemote?: boolean;
-    tagAliases?: Record<string, string>;
-    sourceInfo?: boolean;
-    wordCountMethod?: WordCountMethod;
+  sources?: string[];
+  output?: string;
+  outputMode?: OutputMode;
+  formatId?: string;
+  startPassage?: string;
+  formatPaths?: string[];
+  formatIndices?: string[];
+  formatUrls?: string[];
+  useTweegoPath?: boolean;
+  modules?: string[];
+  headFile?: string;
+  trim?: boolean;
+  twee2Compat?: boolean;
+  testMode?: boolean;
+  noRemote?: boolean;
+  tagAliases?: Record<string, string>;
+  sourceInfo?: boolean;
+  wordCountMethod?: WordCountMethod;
 }
-
-declare class TweeTsError extends Error {
-    diagnostics: Diagnostic[];
-    constructor(message: string, diagnostics?: Diagnostic[]);
+//#endregion
+//#region src/compiler.d.ts
+export declare class TweeTsError extends Error {
+  diagnostics: Diagnostic[];
+  constructor(message: string, diagnostics?: Diagnostic[]);
 }
 /**
  * Compile Twee sources to HTML, Twee, or JSON.
  */
-declare function compile(options: CompileOptions): Promise<CompileResult>;
+export declare function compile(options: CompileOptions): Promise<CompileResult>;
 /**
  * Compile and write to a file.
  */
-declare function compileToFile(options: CompileToFileOptions): Promise<CompileResult>;
+export declare function compileToFile(options: CompileToFileOptions): Promise<CompileResult>;
 /**
  * Compile with incremental caching support.
  * Plugins and advanced users can manage their own cache and changed-file tracking.
  */
-declare function compileIncremental(options: CompileOptions, cache: Map<string, FileCacheEntry>, changedFiles?: ReadonlySet<string>): Promise<CompileResult>;
+export declare function compileIncremental(options: CompileOptions, cache: Map<string, FileCacheEntry>, changedFiles?: ReadonlySet<string>): Promise<CompileResult>;
 /**
  * Watch for file changes and recompile.
  */
-declare function watch(options: WatchOptions): Promise<AbortController>;
-
-/**
- * Story inspection utilities for unit testing.
- *
- * Extracts structural information from a compiled story:
- * passage names, tags, link graph, broken links, dead ends, orphans.
- *
- * Usage:
- *   const result = await compile({ sources: ['./story'] });
- *   const map = storyInspect(result.story);
- *   expect(map.passages).toContain('Start');
- *   expect(map.brokenLinks).toHaveLength(0);
- */
-
+export declare function watch(options: WatchOptions): Promise<AbortController>;
+//#endregion
+//#region src/inspect.d.ts
 interface StoryMap {
-    /** All passage names, in source order. */
-    passages: string[];
-    /** Only story passages (excludes StoryData, StoryTitle, scripts, stylesheets, etc.). */
-    storyPassages: string[];
-    /** Only info/special passages. */
-    infoPassages: string[];
-    /** All unique tags used across the story, sorted alphabetically. */
-    tags: string[];
-    /** Map of tag → passage names that carry that tag. */
-    passagesByTag: Map<string, string[]>;
-    /** Map of passage name → tags on that passage. */
-    tagsByPassage: Map<string, string[]>;
-    /**
-     * Map of passage name → passage names it links to.
-     * Parses `[[target]]`, `[[display->target]]`, `[[display|target]]`,
-     * and SugarCube's `<<goto "target">>` / `<<link "display" "target">>`.
-     */
-    links: Map<string, string[]>;
-    /** Broken links: `{ from, to }` pairs where `to` doesn't exist as a passage. */
-    brokenLinks: BrokenLink[];
-    /** Story passages with no outgoing links (potential dead ends). */
-    deadEnds: string[];
-    /** Story passages that no other passage links to (excluding the start passage). */
-    orphans: string[];
-    /** The configured start passage name, if any. */
-    start: string;
+  /** All passage names, in source order. */
+  passages: string[];
+  /** Only story passages (excludes StoryData, StoryTitle, scripts, stylesheets, etc.). */
+  storyPassages: string[];
+  /** Only info/special passages. */
+  infoPassages: string[];
+  /** All unique tags used across the story, sorted alphabetically. */
+  tags: string[];
+  /** Map of tag → passage names that carry that tag. */
+  passagesByTag: Map<string, string[]>;
+  /** Map of passage name → tags on that passage. */
+  tagsByPassage: Map<string, string[]>;
+  /**
+   * Map of passage name → passage names it links to.
+   * Parses `[[target]]`, `[[display->target]]`, `[[display|target]]`,
+   * and SugarCube's `<<goto "target">>` / `<<link "display" "target">>`.
+   */
+  links: Map<string, string[]>;
+  /** Broken links: `{ from, to }` pairs where `to` doesn't exist as a passage. */
+  brokenLinks: BrokenLink[];
+  /** Story passages with no outgoing links (potential dead ends). */
+  deadEnds: string[];
+  /** Story passages that no other passage links to (excluding the start passage). */
+  orphans: string[];
+  /** The configured start passage name, if any. */
+  start: string;
 }
 interface BrokenLink {
-    from: string;
-    to: string;
+  from: string;
+  to: string;
 }
 /**
  * Inspect a story and return its full structural map.
@@ -296,206 +286,191 @@ interface BrokenLink {
  * expect(map.deadEnds).not.toContain('Start');
  * ```
  */
-declare function storyInspect(story: ReadonlyStory): StoryMap;
-
-/**
- * Story model + StoryData JSON marshal/unmarshal.
- * Ported from story.go + storydata.go.
- */
-
+export declare function storyInspect(story: ReadonlyStory): StoryMap;
+//#endregion
+//#region src/story.d.ts
 /**
  * Builder that separates the mutable construction phase from the immutable consumption phase.
  * During construction, the internal `Story` is mutable via `add()` and direct access.
  * After `build()`, the story is returned as `ReadonlyStory`.
  */
-declare class StoryBuilder {
-    /** The mutable story, accessible during construction for loader functions. */
-    readonly story: Story;
-    constructor();
-    /** Add a passage, handling special passages (StoryData, StoryTitle, etc.). */
-    add(passage: Passage, diagnostics: Diagnostic[]): void;
-    /** Check if a passage name exists. */
-    has(name: string): boolean;
-    /** Finalize and return the story as read-only. */
-    build(): ReadonlyStory;
+export declare class StoryBuilder {
+  /** The mutable story, accessible during construction for loader functions. */
+  readonly story: Story;
+  constructor();
+  /** Add a passage, handling special passages (StoryData, StoryTitle, etc.). */
+  add(passage: Passage, diagnostics: Diagnostic[]): void;
+  /** Check if a passage name exists. */
+  has(name: string): boolean;
+  /** Finalize and return the story as read-only. */
+  build(): ReadonlyStory;
 }
-
+//#endregion
+//#region src/html-parser.d.ts
 interface DecompileResult {
-    story: Story;
-    diagnostics: Diagnostic[];
+  story: Story;
+  diagnostics: Diagnostic[];
 }
 /**
  * Parse a Twine 2 or Twine 1 compiled HTML file back into a Story model.
  */
-declare function decompileHTML(html: string): DecompileResult;
-
-/**
- * Lint mode: compile + inspect story structure without producing output.
- * Surfaces broken links, dead ends, orphans, and compilation diagnostics.
- */
-
+export declare function decompileHTML(html: string): DecompileResult;
+//#endregion
+//#region src/lint.d.ts
 interface LintResult {
-    /** Compilation diagnostics (errors and warnings). */
-    diagnostics: Diagnostic[];
-    /** Compilation statistics. */
-    stats: CompileStats;
-    /** Story format name from StoryData (e.g. "SugarCube"). */
-    formatName: string;
-    /** Story format version from StoryData (e.g. "2.37.3"). */
-    formatVersion: string;
-    /** The configured start passage name. */
-    start: string;
-    /** Total passage count. */
-    passages: number;
-    /** Story passage count (excludes StoryData, StoryTitle, scripts, etc.). */
-    storyPassages: number;
-    /** Info/special passage count. */
-    infoPassages: number;
-    /** Broken links: link targets that don't exist as passages. */
-    brokenLinks: BrokenLink[];
-    /** Story passages with no outgoing links. */
-    deadEnds: string[];
-    /** Story passages that no other passage links to. */
-    orphans: string[];
+  /** Compilation diagnostics (errors and warnings). */
+  diagnostics: Diagnostic[];
+  /** Compilation statistics. */
+  stats: CompileStats;
+  /** Story format name from StoryData (e.g. "SugarCube"). */
+  formatName: string;
+  /** Story format version from StoryData (e.g. "2.37.3"). */
+  formatVersion: string;
+  /** The configured start passage name. */
+  start: string;
+  /** Total passage count. */
+  passages: number;
+  /** Story passage count (excludes StoryData, StoryTitle, scripts, etc.). */
+  storyPassages: number;
+  /** Info/special passage count. */
+  infoPassages: number;
+  /** Broken links: link targets that don't exist as passages. */
+  brokenLinks: BrokenLink[];
+  /** Story passages with no outgoing links. */
+  deadEnds: string[];
+  /** Story passages that no other passage links to. */
+  orphans: string[];
 }
 /**
  * Lint a story: compile without output rendering, then inspect structure.
  * Uses JSON output mode internally to avoid format resolution.
  */
-declare function lint(options: Omit<CompileOptions, 'outputMode'>): Promise<LintResult>;
+export declare function lint(options: Omit<CompileOptions, 'outputMode'>): Promise<LintResult>;
 /**
  * Format a lint result as a human-readable report string.
  */
-declare function formatLintReport(result: LintResult): string;
-
-/**
- * Passage helpers and output methods.
- * Ported from passage.go / passagedata.go.
- */
-
+export declare function formatLintReport(result: LintResult): string;
+//#endregion
+//#region src/passage.d.ts
 /**
  * Apply tag aliases: for each passage carrying an alias tag, add the canonical
  * tag if not already present. Returns new passage objects where tags changed;
  * unchanged passages are returned as-is. Idempotent — safe to call multiple times.
  */
-declare function applyTagAliases(passages: readonly Passage[], aliases: Record<string, string>): Passage[];
-
-/**
- * Twee 3 state-machine lexer implemented as a synchronous generator.
- * Ported from tweelexer.go — Go channels become `yield`.
- */
-
+export declare function applyTagAliases(passages: readonly Passage[], aliases: Record<string, string>): Passage[];
+//#endregion
+//#region src/lexer.d.ts
 /**
  * Twee 3 lexer — yields LexerItem tokens from Twee source text.
  *
  * In the Go reference, this uses goroutines and channels.
  * Here we use a synchronous generator that accumulates items per state step.
  */
-declare function tweeLexer(input: string): Generator<LexerItem, void, undefined>;
+export declare function tweeLexer(input: string): Generator<LexerItem, void, undefined>;
 /** Convenience class wrapper for the lexer generator. */
-declare class TweeLexer {
-    private gen;
-    constructor(input: string);
-    nextItem(): {
-        item: LexerItem;
-        done: boolean;
-    };
-    [Symbol.iterator](): Generator<LexerItem, void, undefined>;
+export declare class TweeLexer {
+  private gen;
+  constructor(input: string);
+  nextItem(): {
+    item: LexerItem;
+    done: boolean;
+  };
+  [Symbol.iterator](): Generator<LexerItem, void, undefined>;
 }
-
-/**
- * Parse lexer items into Passage[].
- * Ported from storyload.go:loadTwee().
- */
-
+//#endregion
+//#region src/parser.d.ts
 interface ParseOptions {
-    /** Filename for diagnostics. */
-    filename?: string;
-    /** Trim whitespace from passage content. Default: true. */
-    trim?: boolean;
-    /** Enable Twee2 compatibility. Default: false. */
-    twee2Compat?: boolean;
+  /** Filename for diagnostics. */
+  filename?: string;
+  /** Trim whitespace from passage content. Default: true. */
+  trim?: boolean;
+  /** Enable Twee2 compatibility. Default: false. */
+  twee2Compat?: boolean;
 }
 interface ParseResult {
-    passages: Passage[];
-    diagnostics: Diagnostic[];
+  passages: Passage[];
+  diagnostics: Diagnostic[];
 }
 /**
  * Parse Twee source text into passages.
  */
-declare function parseTwee(source: string, options?: ParseOptions): ParseResult;
-
+export declare function parseTwee(source: string, options?: ParseOptions): ParseResult;
+//#endregion
+//#region src/formats.d.ts
 /**
  * Parse the Twine 2 format.js JSON chunk.
  * Handles Harlowe's malformed JSON by stripping the "setup" function property.
  * Per spec, the name key is Optional.
  */
-declare function parseFormatJSON(source: string, formatId: string): Twine2FormatJSON | null;
+export declare function parseFormatJSON(source: string, formatId: string): Twine2FormatJSON | null;
 /**
  * Discover all story formats in the given search directories.
  * Implements SemVer-based version pruning: within each (name, major) group,
  * only the highest minor.patch survives.
  */
-declare function discoverFormats(searchDirs: string[]): Map<string, StoryFormatInfo>;
+export declare function discoverFormats(searchDirs: string[]): Map<string, StoryFormatInfo>;
 /**
  * Get the default format search directories.
  */
-declare function getFormatSearchDirs(extraPaths?: string[], useTweegoPath?: boolean): string[];
+export declare function getFormatSearchDirs(extraPaths?: string[], useTweegoPath?: boolean): string[];
 /** Parse a simple semver string into [major, minor, patch]. */
-declare function parseSemver(v: string): [number, number, number] | null;
-declare function semverCompare(a: [number, number, number], b: [number, number, number]): number;
-
+export declare function parseSemver(v: string): [number, number, number] | null;
+export declare function semverCompare(a: [number, number, number], b: [number, number, number]): number;
+//#endregion
+//#region src/ifid.d.ts
 /** Generate a new IFID (UUID v4, uppercase). */
-declare function generateIFID(): IFID;
+export declare function generateIFID(): IFID;
 /** Validate and brand an IFID string. Throws on invalid input. */
-declare function createIFID(value: string): IFID;
+export declare function createIFID(value: string): IFID;
 /**
  * Validate an IFID string.
  * Accepts both bare UUIDs and UUID://...// wrapped format.
  * Returns null if valid, or an error message string.
  */
-declare function validateIFID(ifid: string): string | null;
-
-declare const CONFIG_FILENAME = "twee-ts.config.json";
+export declare function validateIFID(ifid: string): string | null;
+//#endregion
+//#region src/config.d.ts
+export declare const CONFIG_FILENAME = "twee-ts.config.json";
 /** Load a config file from the given directory (default: cwd). Returns null if not found. */
-declare function loadConfig(dir?: string): TweeTsConfig | null;
+export declare function loadConfig(dir?: string): TweeTsConfig | null;
 /** Load a config from a specific file path. */
-declare function loadConfigFile(filePath: string): TweeTsConfig;
+export declare function loadConfigFile(filePath: string): TweeTsConfig;
 /** Validate a config object. Returns an array of error strings (empty = valid). */
-declare function validateConfig(data: unknown): string[];
+export declare function validateConfig(data: unknown): string[];
 /** Return a default config JSON string for --init scaffolding. */
-declare function scaffoldConfig(): string;
-
+export declare function scaffoldConfig(): string;
+//#endregion
+//#region src/remote-formats.d.ts
 /** Get the cache directory for downloaded story formats. */
-declare function getCacheDir(): string;
+export declare function getCacheDir(): string;
 /** Download a format, verify its checksum, write to cache, and return StoryFormatInfo. */
-declare function fetchAndCacheFormat(entry: SFAIndexEntry, downloadUrl: string): Promise<StoryFormatInfo>;
+export declare function fetchAndCacheFormat(entry: SFAIndexEntry, downloadUrl: string): Promise<StoryFormatInfo>;
 /** Download a direct format.js URL, parse its JSON, cache it, and return StoryFormatInfo. */
-declare function fetchDirectFormat(url: string): Promise<StoryFormatInfo>;
+export declare function fetchDirectFormat(url: string): Promise<StoryFormatInfo>;
 /**
  * Try to resolve a remote story format by name and version.
  * 1. Try direct format URLs
  * 2. Try custom index URLs
  * 3. Try default SFA indices
  */
-declare function resolveRemoteFormat(name: string, version: string, indices?: string[], urls?: string[]): Promise<StoryFormatInfo | undefined>;
+export declare function resolveRemoteFormat(name: string, version: string, indices?: string[], urls?: string[]): Promise<StoryFormatInfo | undefined>;
 /** Discover all cached remote formats. Returns a Map like discoverFormats(). */
-declare function discoverCachedFormats(): Map<string, StoryFormatInfo>;
+export declare function discoverCachedFormats(): Map<string, StoryFormatInfo>;
 /** Info about a cached format entry with size and modification date. */
 interface CachedFormatEntry {
-    readonly name: string;
-    readonly version: string;
-    readonly sizeBytes: number;
-    readonly modifiedAt: Date;
+  readonly name: string;
+  readonly version: string;
+  readonly sizeBytes: number;
+  readonly modifiedAt: Date;
 }
 /** List all cached formats with size and modification date. */
-declare function listCachedFormats(): readonly CachedFormatEntry[];
+export declare function listCachedFormats(): readonly CachedFormatEntry[];
 /** Clear all cached formats, or only those matching a given name. Returns the number of entries removed. */
-declare function clearCachedFormats(name?: string): number;
+export declare function clearCachedFormats(name?: string): number;
 /** Get total cache size in bytes and format count. */
-declare function getCacheSize(): {
-    totalBytes: number;
-    count: number;
+export declare function getCacheSize(): {
+  totalBytes: number;
+  count: number;
 };
-
-export { type BrokenLink, CONFIG_FILENAME, type CachedFormatEntry, type CompileOptions, type CompileResult, type CompileStats, type CompileToFileOptions, type DecompileResult, type Diagnostic, type FileCacheEntry, type IFID, type InlineSource, ItemType, type LexerItem, type LintResult, type OutputMode, type Passage, type PassageMetadata, type ReadonlyPassage, type ReadonlyStory, type SFAIndex, type SFAIndexEntry, type SourceInput, type SourceLocation, type Story, StoryBuilder, type StoryFormatInfo, type StoryMap, TweeLexer, type TweeTsConfig, TweeTsError, type WatchOptions, type WordCountMethod, applyTagAliases, clearCachedFormats, compile, compileIncremental, compileToFile, createIFID, decompileHTML, discoverCachedFormats, discoverFormats, fetchAndCacheFormat, fetchDirectFormat, formatLintReport, generateIFID, getCacheDir, getCacheSize, getFormatSearchDirs, lint, listCachedFormats, loadConfig, loadConfigFile, parseFormatJSON, parseSemver, parseTwee, resolveRemoteFormat, scaffoldConfig, semverCompare, storyInspect, tweeLexer, validateConfig, validateIFID, watch };
+//#endregion
+export type { BrokenLink, CachedFormatEntry, CompileOptions, CompileResult, CompileStats, CompileToFileOptions, DecompileResult, Diagnostic, FileCacheEntry, IFID, InlineSource, LexerItem, LintResult, OutputMode, Passage, PassageMetadata, ReadonlyPassage, ReadonlyStory, SFAIndex, SFAIndexEntry, SourceInput, SourceLocation, Story, StoryFormatInfo, StoryMap, TweeTsConfig, WatchOptions, WordCountMethod };