@rohal12/twee-ts 1.8.0 → 1.10.0

package/dist/index.d.cts

@@ -161,6 +161,11 @@ interface SFAIndex {
     twine1: SFAIndexEntry[];
     twine2: SFAIndexEntry[];
 }
+interface FileCacheEntry {
+    readonly mtimeMs: number;
+    readonly passages: readonly Passage[];
+    readonly diagnostics: readonly Diagnostic[];
+}
 interface TweeTsConfig {
     sources?: string[];
     output?: string;
@@ -193,6 +198,11 @@ declare function compile(options: CompileOptions): Promise<CompileResult>;
  * Compile and write to a file.
  */
 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>;
 /**
  * Watch for file changes and recompile.
  */
@@ -428,4 +438,4 @@ declare function getCacheSize(): {
     count: number;
 };
 
-export { type BrokenLink, CONFIG_FILENAME, type CachedFormatEntry, type CompileOptions, type CompileResult, type CompileStats, type CompileToFileOptions, type Diagnostic, type InlineSource, ItemType, type LexerItem, type LintResult, type OutputMode, type Passage, type PassageMetadata, type SFAIndex, type SFAIndexEntry, type SourceInput, type SourceLocation, type Story, type StoryFormatInfo, type StoryMap, TweeLexer, type TweeTsConfig, TweeTsError, type WatchOptions, applyTagAliases, clearCachedFormats, compile, compileToFile, discoverCachedFormats, discoverFormats, fetchAndCacheFormat, fetchDirectFormat, formatLintReport, generateIFID, getCacheDir, getCacheSize, getFormatSearchDirs, lint, listCachedFormats, loadConfig, loadConfigFile, parseFormatJSON, parseSemver, parseTwee, resolveRemoteFormat, scaffoldConfig, semverCompare, storyInspect, tweeLexer, validateConfig, validateIFID, watch };
+export { type BrokenLink, CONFIG_FILENAME, type CachedFormatEntry, type CompileOptions, type CompileResult, type CompileStats, type CompileToFileOptions, type Diagnostic, type FileCacheEntry, type InlineSource, ItemType, type LexerItem, type LintResult, type OutputMode, type Passage, type PassageMetadata, type SFAIndex, type SFAIndexEntry, type SourceInput, type SourceLocation, type Story, type StoryFormatInfo, type StoryMap, TweeLexer, type TweeTsConfig, TweeTsError, type WatchOptions, applyTagAliases, clearCachedFormats, compile, compileIncremental, compileToFile, discoverCachedFormats, discoverFormats, fetchAndCacheFormat, fetchDirectFormat, formatLintReport, generateIFID, getCacheDir, getCacheSize, getFormatSearchDirs, lint, listCachedFormats, loadConfig, loadConfigFile, parseFormatJSON, parseSemver, parseTwee, resolveRemoteFormat, scaffoldConfig, semverCompare, storyInspect, tweeLexer, validateConfig, validateIFID, watch };

package/dist/index.d.ts

@@ -161,6 +161,11 @@ interface SFAIndex {
     twine1: SFAIndexEntry[];
     twine2: SFAIndexEntry[];
 }
+interface FileCacheEntry {
+    readonly mtimeMs: number;
+    readonly passages: readonly Passage[];
+    readonly diagnostics: readonly Diagnostic[];
+}
 interface TweeTsConfig {
     sources?: string[];
     output?: string;
@@ -193,6 +198,11 @@ declare function compile(options: CompileOptions): Promise<CompileResult>;
  * Compile and write to a file.
  */
 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>;
 /**
  * Watch for file changes and recompile.
  */
@@ -428,4 +438,4 @@ declare function getCacheSize(): {
     count: number;
 };
 
-export { type BrokenLink, CONFIG_FILENAME, type CachedFormatEntry, type CompileOptions, type CompileResult, type CompileStats, type CompileToFileOptions, type Diagnostic, type InlineSource, ItemType, type LexerItem, type LintResult, type OutputMode, type Passage, type PassageMetadata, type SFAIndex, type SFAIndexEntry, type SourceInput, type SourceLocation, type Story, type StoryFormatInfo, type StoryMap, TweeLexer, type TweeTsConfig, TweeTsError, type WatchOptions, applyTagAliases, clearCachedFormats, compile, compileToFile, discoverCachedFormats, discoverFormats, fetchAndCacheFormat, fetchDirectFormat, formatLintReport, generateIFID, getCacheDir, getCacheSize, getFormatSearchDirs, lint, listCachedFormats, loadConfig, loadConfigFile, parseFormatJSON, parseSemver, parseTwee, resolveRemoteFormat, scaffoldConfig, semverCompare, storyInspect, tweeLexer, validateConfig, validateIFID, watch };
+export { type BrokenLink, CONFIG_FILENAME, type CachedFormatEntry, type CompileOptions, type CompileResult, type CompileStats, type CompileToFileOptions, type Diagnostic, type FileCacheEntry, type InlineSource, ItemType, type LexerItem, type LintResult, type OutputMode, type Passage, type PassageMetadata, type SFAIndex, type SFAIndexEntry, type SourceInput, type SourceLocation, type Story, type StoryFormatInfo, type StoryMap, TweeLexer, type TweeTsConfig, TweeTsError, type WatchOptions, applyTagAliases, clearCachedFormats, compile, compileIncremental, compileToFile, discoverCachedFormats, discoverFormats, fetchAndCacheFormat, fetchDirectFormat, formatLintReport, generateIFID, getCacheDir, getCacheSize, getFormatSearchDirs, lint, listCachedFormats, loadConfig, loadConfigFile, parseFormatJSON, parseSemver, parseTwee, resolveRemoteFormat, scaffoldConfig, semverCompare, storyInspect, tweeLexer, validateConfig, validateIFID, watch };

package/dist/index.js

@@ -2173,6 +2173,9 @@ async function compileToFile(options) {
   writeFileSync2(options.outFile, result.output, "utf-8");
   return result;
 }
+async function compileIncremental(options, cache, changedFiles) {
+  return buildOutput(options, cache, changedFiles);
+}
 async function watch(options) {
   const controller = new AbortController();
   const cache = /* @__PURE__ */ new Map();
@@ -2613,6 +2616,7 @@ function validateConfig(data) {
 }
 function scaffoldConfig() {
   const config = {
+    $schema: "https://unpkg.com/@rohal12/twee-ts/schemas/twee-ts.config.schema.json",
     sources: ["src/"],
     output: "story.html"
   };
@@ -2625,6 +2629,7 @@ export {
   applyTagAliases,
   clearCachedFormats,
   compile,
+  compileIncremental,
   compileToFile,
   discoverCachedFormats,
   discoverFormats,