@rohal12/twee-ts 1.1.1

package/dist/index.d.cts

@@ -0,0 +1,352 @@
+/**
+ * All public interfaces for twee-ts.
+ */
+type OutputMode = 'html' | 'twee3' | 'twee1' | 'twine2-archive' | 'twine1-archive' | 'json';
+type InlineSource = {
+    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>;
+}
+interface CompileToFileOptions extends CompileOptions {
+    /** 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;
+}
+interface Diagnostic {
+    level: 'warning' | 'error';
+    message: string;
+    file?: string;
+    line?: number;
+}
+interface CompileResult {
+    /** The compiled output string (HTML, Twee, JSON, etc.). */
+    output: string;
+    /** The parsed story model. */
+    story: Story;
+    /** 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[];
+}
+interface PassageMetadata {
+    position?: string;
+    size?: string;
+}
+interface Passage {
+    name: string;
+    tags: string[];
+    text: string;
+    metadata?: PassageMetadata;
+}
+interface Twine1Metadata {
+    settings: Map<string, string>;
+}
+interface Twine2Metadata {
+    format: string;
+    formatVersion: string;
+    options: Map<string, boolean>;
+    start: string;
+    tagColors: Map<string, string>;
+    zoom: number;
+}
+interface Story {
+    name: string;
+    ifid: string;
+    passages: Passage[];
+    legacyIFID: string;
+    twine1: Twine1Metadata;
+    twine2: Twine2Metadata;
+}
+interface StoryFormatInfo {
+    id: string;
+    filename: string;
+    isTwine2: boolean;
+    name: string;
+    version: string;
+    proofing: boolean;
+}
+interface Twine2FormatJSON {
+    name: string;
+    version: string;
+    proofing?: boolean;
+    source: string;
+}
+declare const enum ItemType {
+    Error = 0,
+    EOF = 1,
+    Header = 2,
+    Name = 3,
+    Tags = 4,
+    Metadata = 5,
+    Content = 6
+}
+interface LexerItem {
+    type: ItemType;
+    line: number;
+    pos: number;
+    val: string;
+}
+interface SFAIndexEntry {
+    name: string;
+    version: string;
+    proofing: boolean;
+    files: string[];
+    checksums: Record<string, string>;
+}
+interface SFAIndex {
+    twine1: SFAIndexEntry[];
+    twine2: SFAIndexEntry[];
+}
+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>;
+}
+
+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>;
+/**
+ * Compile and write to a file.
+ */
+declare function compileToFile(options: CompileToFileOptions): 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);
+ */
+
+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;
+}
+interface BrokenLink {
+    from: string;
+    to: string;
+}
+/**
+ * Inspect a story and return its full structural map.
+ *
+ * Designed for story authors to use in unit tests:
+ * ```ts
+ * const result = await compile({ sources: ['./story'] });
+ * const map = storyInspect(result.story);
+ *
+ * // Assert structure
+ * expect(map.passages).toContain('Start');
+ * expect(map.tags).toContain('location');
+ * expect(map.passagesByTag.get('location')).toContain('Kitchen');
+ * expect(map.brokenLinks).toEqual([]);
+ * expect(map.deadEnds).not.toContain('Start');
+ * ```
+ */
+declare function storyInspect(story: Story): StoryMap;
+
+/**
+ * Passage helpers and output methods.
+ * Ported from passage.go / passagedata.go.
+ */
+
+/**
+ * Apply tag aliases: for each passage carrying an alias tag, add the canonical
+ * tag if not already present. Idempotent — safe to call multiple times.
+ */
+declare function applyTagAliases(passages: Passage[], aliases: Record<string, string>): void;
+
+/**
+ * Twee 3 state-machine lexer implemented as a synchronous generator.
+ * Ported from tweelexer.go — Go channels become `yield`.
+ */
+
+/**
+ * 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>;
+/** 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>;
+}
+
+/**
+ * Parse lexer items into Passage[].
+ * Ported from storyload.go:loadTwee().
+ */
+
+interface ParseOptions {
+    /** 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[];
+}
+/**
+ * Parse Twee source text into passages.
+ */
+declare function parseTwee(source: string, options?: ParseOptions): ParseResult;
+
+/**
+ * Parse the Twine 2 format.js JSON chunk.
+ * Handles Harlowe's malformed JSON by stripping the "setup" function property.
+ */
+declare function parseFormatJSON(source: string, formatId: string): Twine2FormatJSON | null;
+/**
+ * Discover all story formats in the given search directories.
+ */
+declare function discoverFormats(searchDirs: string[]): Map<string, StoryFormatInfo>;
+/**
+ * Get the default format search directories.
+ */
+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;
+
+/** Generate a new IFID (UUID v4, uppercase). */
+declare function generateIFID(): string;
+/**
+ * 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";
+/** Load a config file from the given directory (default: cwd). Returns null if not found. */
+declare function loadConfig(dir?: string): TweeTsConfig | null;
+/** Load a config from a specific file path. */
+declare function loadConfigFile(filePath: string): TweeTsConfig;
+/** Validate a config object. Returns an array of error strings (empty = valid). */
+declare function validateConfig(data: unknown): string[];
+/** Return a default config JSON string for --init scaffolding. */
+declare function scaffoldConfig(): string;
+
+/** Get the cache directory for downloaded story formats. */
+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>;
+/** Download a direct format.js URL, parse its JSON, cache it, and return StoryFormatInfo. */
+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>;
+/** Discover all cached remote formats. Returns a Map like discoverFormats(). */
+declare function discoverCachedFormats(): Map<string, StoryFormatInfo>;
+
+export { type BrokenLink, CONFIG_FILENAME, type CompileOptions, type CompileResult, type CompileStats, type CompileToFileOptions, type Diagnostic, type InlineSource, ItemType, type LexerItem, type OutputMode, type Passage, type PassageMetadata, type SFAIndex, type SFAIndexEntry, type SourceInput, type Story, type StoryFormatInfo, type StoryMap, TweeLexer, type TweeTsConfig, TweeTsError, type WatchOptions, applyTagAliases, compile, compileToFile, discoverCachedFormats, discoverFormats, fetchAndCacheFormat, fetchDirectFormat, generateIFID, getCacheDir, getFormatSearchDirs, loadConfig, loadConfigFile, parseFormatJSON, parseSemver, parseTwee, resolveRemoteFormat, scaffoldConfig, semverCompare, storyInspect, tweeLexer, validateConfig, validateIFID, watch };

package/dist/index.d.ts

@@ -0,0 +1,352 @@
+/**
+ * All public interfaces for twee-ts.
+ */
+type OutputMode = 'html' | 'twee3' | 'twee1' | 'twine2-archive' | 'twine1-archive' | 'json';
+type InlineSource = {
+    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>;
+}
+interface CompileToFileOptions extends CompileOptions {
+    /** 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;
+}
+interface Diagnostic {
+    level: 'warning' | 'error';
+    message: string;
+    file?: string;
+    line?: number;
+}
+interface CompileResult {
+    /** The compiled output string (HTML, Twee, JSON, etc.). */
+    output: string;
+    /** The parsed story model. */
+    story: Story;
+    /** 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[];
+}
+interface PassageMetadata {
+    position?: string;
+    size?: string;
+}
+interface Passage {
+    name: string;
+    tags: string[];
+    text: string;
+    metadata?: PassageMetadata;
+}
+interface Twine1Metadata {
+    settings: Map<string, string>;
+}
+interface Twine2Metadata {
+    format: string;
+    formatVersion: string;
+    options: Map<string, boolean>;
+    start: string;
+    tagColors: Map<string, string>;
+    zoom: number;
+}
+interface Story {
+    name: string;
+    ifid: string;
+    passages: Passage[];
+    legacyIFID: string;
+    twine1: Twine1Metadata;
+    twine2: Twine2Metadata;
+}
+interface StoryFormatInfo {
+    id: string;
+    filename: string;
+    isTwine2: boolean;
+    name: string;
+    version: string;
+    proofing: boolean;
+}
+interface Twine2FormatJSON {
+    name: string;
+    version: string;
+    proofing?: boolean;
+    source: string;
+}
+declare const enum ItemType {
+    Error = 0,
+    EOF = 1,
+    Header = 2,
+    Name = 3,
+    Tags = 4,
+    Metadata = 5,
+    Content = 6
+}
+interface LexerItem {
+    type: ItemType;
+    line: number;
+    pos: number;
+    val: string;
+}
+interface SFAIndexEntry {
+    name: string;
+    version: string;
+    proofing: boolean;
+    files: string[];
+    checksums: Record<string, string>;
+}
+interface SFAIndex {
+    twine1: SFAIndexEntry[];
+    twine2: SFAIndexEntry[];
+}
+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>;
+}
+
+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>;
+/**
+ * Compile and write to a file.
+ */
+declare function compileToFile(options: CompileToFileOptions): 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);
+ */
+
+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;
+}
+interface BrokenLink {
+    from: string;
+    to: string;
+}
+/**
+ * Inspect a story and return its full structural map.
+ *
+ * Designed for story authors to use in unit tests:
+ * ```ts
+ * const result = await compile({ sources: ['./story'] });
+ * const map = storyInspect(result.story);
+ *
+ * // Assert structure
+ * expect(map.passages).toContain('Start');
+ * expect(map.tags).toContain('location');
+ * expect(map.passagesByTag.get('location')).toContain('Kitchen');
+ * expect(map.brokenLinks).toEqual([]);
+ * expect(map.deadEnds).not.toContain('Start');
+ * ```
+ */
+declare function storyInspect(story: Story): StoryMap;
+
+/**
+ * Passage helpers and output methods.
+ * Ported from passage.go / passagedata.go.
+ */
+
+/**
+ * Apply tag aliases: for each passage carrying an alias tag, add the canonical
+ * tag if not already present. Idempotent — safe to call multiple times.
+ */
+declare function applyTagAliases(passages: Passage[], aliases: Record<string, string>): void;
+
+/**
+ * Twee 3 state-machine lexer implemented as a synchronous generator.
+ * Ported from tweelexer.go — Go channels become `yield`.
+ */
+
+/**
+ * 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>;
+/** 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>;
+}
+
+/**
+ * Parse lexer items into Passage[].
+ * Ported from storyload.go:loadTwee().
+ */
+
+interface ParseOptions {
+    /** 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[];
+}
+/**
+ * Parse Twee source text into passages.
+ */
+declare function parseTwee(source: string, options?: ParseOptions): ParseResult;
+
+/**
+ * Parse the Twine 2 format.js JSON chunk.
+ * Handles Harlowe's malformed JSON by stripping the "setup" function property.
+ */
+declare function parseFormatJSON(source: string, formatId: string): Twine2FormatJSON | null;
+/**
+ * Discover all story formats in the given search directories.
+ */
+declare function discoverFormats(searchDirs: string[]): Map<string, StoryFormatInfo>;
+/**
+ * Get the default format search directories.
+ */
+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;
+
+/** Generate a new IFID (UUID v4, uppercase). */
+declare function generateIFID(): string;
+/**
+ * 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";
+/** Load a config file from the given directory (default: cwd). Returns null if not found. */
+declare function loadConfig(dir?: string): TweeTsConfig | null;
+/** Load a config from a specific file path. */
+declare function loadConfigFile(filePath: string): TweeTsConfig;
+/** Validate a config object. Returns an array of error strings (empty = valid). */
+declare function validateConfig(data: unknown): string[];
+/** Return a default config JSON string for --init scaffolding. */
+declare function scaffoldConfig(): string;
+
+/** Get the cache directory for downloaded story formats. */
+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>;
+/** Download a direct format.js URL, parse its JSON, cache it, and return StoryFormatInfo. */
+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>;
+/** Discover all cached remote formats. Returns a Map like discoverFormats(). */
+declare function discoverCachedFormats(): Map<string, StoryFormatInfo>;
+
+export { type BrokenLink, CONFIG_FILENAME, type CompileOptions, type CompileResult, type CompileStats, type CompileToFileOptions, type Diagnostic, type InlineSource, ItemType, type LexerItem, type OutputMode, type Passage, type PassageMetadata, type SFAIndex, type SFAIndexEntry, type SourceInput, type Story, type StoryFormatInfo, type StoryMap, TweeLexer, type TweeTsConfig, TweeTsError, type WatchOptions, applyTagAliases, compile, compileToFile, discoverCachedFormats, discoverFormats, fetchAndCacheFormat, fetchDirectFormat, generateIFID, getCacheDir, getFormatSearchDirs, loadConfig, loadConfigFile, parseFormatJSON, parseSemver, parseTwee, resolveRemoteFormat, scaffoldConfig, semverCompare, storyInspect, tweeLexer, validateConfig, validateIFID, watch };