@avrm/svi 0.0.1

package/dist/src/svi/sviDependencies.js

@@ -0,0 +1,139 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const extractDeclarations_1 = require("./prompts/extractDeclarations");
+const cacheManager_1 = __importDefault(require("../svi/cacheManager"));
+const logger_1 = __importDefault(require("../utils/logger"));
+const file_1 = require("../utils/file");
+// Generated file path: src\svi\sviDependencies.ts
+class SviDependencies {
+    constructor(llmProcessor, config, isPreliminary) {
+        this.dependenciesDeclarations = [];
+        this.llmGeneratedFiles = [];
+        this.cacheUsedFiles = [];
+        this.llmProcessor = llmProcessor;
+        this.config = config;
+        this.isPreliminary = isPreliminary;
+    }
+    async loadDependenciesDeclarations(sviFile) {
+        logger_1.default.trace(`Starting to load dependencies for SVI file: '${sviFile.getSviFileName()}'`);
+        // Clear previous declarations for a fresh load
+        this.dependenciesDeclarations = [];
+        this.llmGeneratedFiles = [];
+        this.cacheUsedFiles = [];
+        const sviFileDirectory = sviFile.getSviFileDirectory();
+        const dependencies = sviFile.dependencies || [];
+        let hasError = false;
+        for (const dependencyFilename of dependencies) {
+            const dependencyFullPath = path_1.default.resolve(sviFileDirectory, dependencyFilename);
+            const relativeDependencyPath = (0, file_1.getRelativePath)(dependencyFullPath, this.config.configDir);
+            logger_1.default.trace(`Processing dependency: '${dependencyFilename}' (Resolved to: '${dependencyFullPath}')`);
+            if (!fs_1.default.existsSync(dependencyFullPath)) {
+                if (this.isPreliminary) {
+                    logger_1.default.trace(`Skipping non-existent dependency file in preliminary run: '${dependencyFullPath}'`);
+                    continue;
+                }
+                else {
+                    logger_1.default.error(`File '${sviFile.getSviFileName()}' from 'Dependencies' section not found at path: '${dependencyFullPath}'.`);
+                    hasError = true;
+                    continue; // Continue to check other dependencies, but flag an error for final return
+                }
+            }
+            const cacheManager = new cacheManager_1.default(path_1.default.dirname(dependencyFullPath));
+            let declarationsContent = null;
+            let declarationSource = 'llm'; // Default to LLM, will be updated if from cache
+            if (cacheManager.isFileExportsCacheValid(dependencyFullPath)) {
+                declarationsContent = cacheManager.getFileExportsFromCache(dependencyFullPath);
+                if (declarationsContent) {
+                    declarationSource = 'cache';
+                    this.cacheUsedFiles.push(relativeDependencyPath);
+                    logger_1.default.trace(`Declarations for '${relativeDependencyPath}' loaded from cache.`);
+                }
+                else {
+                    // Cache was valid but content was null (e.g., empty cache file), proceed to LLM
+                    logger_1.default.trace(`Cache valid for '${relativeDependencyPath}' but content empty. Proceeding to LLM.`);
+                    declarationsContent = null; // Ensure it's null to trigger LLM path below
+                }
+            }
+            if (!declarationsContent) {
+                // If not from cache, or cache was empty, ask LLM
+                logger_1.default.info(`LLM will be called to generate declarations for the following file: '${relativeDependencyPath}'`);
+                try {
+                    const sourceCode = fs_1.default.readFileSync(dependencyFullPath, 'utf-8');
+                    const programmingLanguagePhrase = this.config.programmingLanguage
+                        ? `programming language ${this.config.programmingLanguage}`
+                        : '';
+                    const prompt = extractDeclarations_1.extractDeclarationsPromptTemplate
+                        .replace('{{programmingLanguage}}', programmingLanguagePhrase)
+                        .replace('{{sourceCode}}', sourceCode);
+                    const promptDescription = `Declarations extraction from ${relativeDependencyPath}`;
+                    const llmResult = await this.llmProcessor.ask(prompt, undefined, promptDescription);
+                    if (!llmResult) {
+                        logger_1.default.error(`LLM returned no declarations for file: '${relativeDependencyPath}'.`);
+                        hasError = true;
+                        continue; // Continue to check other dependencies, but flag an error
+                    }
+                    declarationsContent = llmResult;
+                    declarationSource = 'llm';
+                    this.llmGeneratedFiles.push(relativeDependencyPath);
+                    cacheManager.updateFileExportsInCache(dependencyFullPath, declarationsContent);
+                    logger_1.default.trace(`Declarations for '${relativeDependencyPath}' generated by LLM and cached.`);
+                }
+                catch (error) {
+                    logger_1.default.error(`Error processing dependency '${relativeDependencyPath}' with LLM: ${error.message}`);
+                    hasError = true;
+                    continue; // Continue on error
+                }
+            }
+            if (declarationsContent) {
+                this.dependenciesDeclarations.push({
+                    relativePath: relativeDependencyPath,
+                    content: declarationsContent,
+                    source: declarationSource,
+                });
+            }
+        }
+        if (hasError && !this.isPreliminary) {
+            logger_1.default.info(`Dependencies declarations retrieval completed with errors for '${sviFile.getSviFileName()}'.`);
+            return false;
+        }
+        else {
+            logger_1.default.info(`Dependencies declarations retrieved for '${sviFile.getSviFileName()}'.`);
+            if (this.llmGeneratedFiles.length > 0) {
+                logger_1.default.info(`  Generated by LLM: ${this.llmGeneratedFiles.join(', ')}`);
+            }
+            if (this.cacheUsedFiles.length > 0) {
+                logger_1.default.info(`  From cache: ${this.cacheUsedFiles.join(', ')}`);
+            }
+            return true;
+        }
+    }
+    getDependenciesDeclarationsAsString() {
+        if (this.dependenciesDeclarations.length === 0) {
+            return '';
+        }
+        const declarationStrings = this.dependenciesDeclarations.map(dep => {
+            // Format: "Declarations from file: <path>\n\n<content>\n"
+            return `Declarations from file: ${dep.relativePath}\n\n${dep.content}\n`;
+        });
+        // Join with an empty line between each block, resulting in the format:
+        // Block1\n
+        // \n
+        // Block2\n
+        // Which means:
+        // Header1
+        //
+        // Content1
+        //
+        // Header2
+        //
+        // Content2
+        return declarationStrings.join('\n');
+    }
+}
+exports.default = SviDependencies;
+//# sourceMappingURL=sviDependencies.js.map

package/dist/src/svi/sviDependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sviDependencies.js","sourceRoot":"","sources":["../../../src/svi/sviDependencies.ts"],"names":[],"mappings":";;;;;AAAA,4CAAoB;AACpB,gDAAwB;AAIxB,uEAAkF;AAClF,uEAA+C;AAC/C,6DAAqC;AACrC,wCAAgD;AAEhD,kDAAkD;AAClD,MAAqB,eAAe;IASlC,YAAY,YAA0B,EAAE,MAAiB,EAAE,aAAsB;QAJzE,6BAAwB,GAAyE,EAAE,CAAC;QACpG,sBAAiB,GAAa,EAAE,CAAC;QACjC,mBAAc,GAAa,EAAE,CAAC;QAGpC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAEM,KAAK,CAAC,4BAA4B,CAAC,OAAgB;QACxD,gBAAM,CAAC,KAAK,CAAC,gDAAgD,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QAC1F,+CAA+C;QAC/C,IAAI,CAAC,wBAAwB,GAAG,EAAE,CAAC;QACnC,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QAEzB,MAAM,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;QACvD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;QAEhD,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,KAAK,MAAM,kBAAkB,IAAI,YAAY,EAAE,CAAC;YAC9C,MAAM,kBAAkB,GAAG,cAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;YAC9E,MAAM,sBAAsB,GAAG,IAAA,sBAAe,EAAC,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC1F,gBAAM,CAAC,KAAK,CAAC,2BAA2B,kBAAkB,oBAAoB,kBAAkB,IAAI,CAAC,CAAC;YAEtG,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACvC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBACvB,gBAAM,CAAC,KAAK,CAAC,8DAA8D,kBAAkB,GAAG,CAAC,CAAC;oBAClG,SAAS;gBACX,CAAC;qBAAM,CAAC;oBACN,gBAAM,CAAC,KAAK,CACV,SAAS,OAAO,CAAC,cAAc,EAAE,qDAAqD,kBAAkB,IAAI,CAC7G,CAAC;oBACF,QAAQ,GAAG,IAAI,CAAC;oBAChB,SAAS,CAAC,2EAA2E;gBACvF,CAAC;YACH,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,sBAAY,CAAC,cAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACxE,IAAI,mBAAmB,GAAkB,IAAI,CAAC;YAC9C,IAAI,iBAAiB,GAAoB,KAAK,CAAC,CAAC,gDAAgD;YAEhG,IAAI,YAAY,CAAC,uBAAuB,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC7D,mBAAmB,GAAG,YAAY,CAAC,uBAAuB,CAAC,kBAAkB,CAAC,CAAC;gBAC/E,IAAI,mBAAmB,EAAE,CAAC;oBACxB,iBAAiB,GAAG,OAAO,CAAC;oBAC5B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;oBACjD,gBAAM,CAAC,KAAK,CAAC,qBAAqB,sBAAsB,sBAAsB,CAAC,CAAC;gBAClF,CAAC;qBAAM,CAAC;oBACN,gFAAgF;oBAChF,gBAAM,CAAC,KAAK,CAAC,oBAAoB,sBAAsB,yCAAyC,CAAC,CAAC;oBAClG,mBAAmB,GAAG,IAAI,CAAC,CAAC,6CAA6C;gBAC3E,CAAC;YACH,CAAC;YAED,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBACzB,iDAAiD;gBACjD,gBAAM,CAAC,IAAI,CAAC,wEAAwE,sBAAsB,GAAG,CAAC,CAAC;gBAC/G,IAAI,CAAC;oBACH,MAAM,UAAU,GAAG,YAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;oBAChE,MAAM,yBAAyB,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB;wBAC/D,CAAC,CAAC,wBAAwB,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE;wBAC3D,CAAC,CAAC,EAAE,CAAC;oBAEP,MAAM,MAAM,GAAG,uDAAiC;yBAC7C,OAAO,CAAC,yBAAyB,EAAE,yBAAyB,CAAC;yBAC7D,OAAO,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;oBAEzC,MAAM,iBAAiB,GAAG,gCAAgC,sBAAsB,EAAE,CAAC;oBAEnF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;oBAEpF,IAAI,CAAC,SAAS,EAAE,CAAC;wBACf,gBAAM,CAAC,KAAK,CAAC,2CAA2C,sBAAsB,IAAI,CAAC,CAAC;wBACpF,QAAQ,GAAG,IAAI,CAAC;wBAChB,SAAS,CAAC,0DAA0D;oBACtE,CAAC;oBACD,mBAAmB,GAAG,SAAS,CAAC;oBAChC,iBAAiB,GAAG,KAAK,CAAC;oBAC1B,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;oBACpD,YAAY,CAAC,wBAAwB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;oBAC/E,gBAAM,CAAC,KAAK,CAAC,qBAAqB,sBAAsB,gCAAgC,CAAC,CAAC;gBAE5F,CAAC;gBAAC,OAAO,KAAU,EAAE,CAAC;oBACpB,gBAAM,CAAC,KAAK,CAAC,gCAAgC,sBAAsB,eAAe,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;oBACnG,QAAQ,GAAG,IAAI,CAAC;oBAChB,SAAS,CAAC,oBAAoB;gBAChC,CAAC;YACH,CAAC;YAED,IAAI,mBAAmB,EAAE,CAAC;gBACxB,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC;oBACjC,YAAY,EAAE,sBAAsB;oBACpC,OAAO,EAAE,mBAAmB;oBAC5B,MAAM,EAAE,iBAAiB;iBAC1B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACpC,gBAAM,CAAC,IAAI,CAAC,kEAAkE,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;YAC5G,OAAO,KAAK,CAAC;QACf,CAAC;aAAM,CAAC;YACN,gBAAM,CAAC,IAAI,CAAC,4CAA4C,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;YACtF,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtC,gBAAM,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1E,CAAC;YACD,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,gBAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEM,mCAAmC;QACxC,IAAI,IAAI,CAAC,wBAAwB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YACjE,0DAA0D;YAC1D,OAAO,2BAA2B,GAAG,CAAC,YAAY,OAAO,GAAG,CAAC,OAAO,IAAI,CAAC;QAC3E,CAAC,CAAC,CAAC;QAEH,uEAAuE;QACvE,WAAW;QACX,KAAK;QACL,WAAW;QACX,eAAe;QACf,UAAU;QACV,EAAE;QACF,WAAW;QACX,EAAE;QACF,UAAU;QACV,EAAE;QACF,WAAW;QACX,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF;AAjJD,kCAiJC"}

package/dist/src/svi/sviFileClass.js

@@ -0,0 +1,105 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../config/config");
+const file_1 = require("../utils/file");
+class SviFileClass {
+    constructor(data) {
+        this.filePath = data?.filePath;
+        this.destinationFile = data?.destinationFile;
+        this.dependencies = data?.dependencies;
+        this.output = data?.output;
+        this.options = data?.options;
+        this.importPrompts = data?.importPrompts;
+        this.prompt = data?.prompt;
+    }
+    getSviFileName() {
+        if (!this.filePath) {
+            throw new Error("SVIFile filePath is not defined, cannot get file name.");
+        }
+        return path_1.default.basename(this.filePath);
+    }
+    getSviFileDirectory() {
+        if (!this.filePath) {
+            throw new Error("SVIFile filePath is not defined, cannot get file directory.");
+        }
+        return path_1.default.dirname(path_1.default.resolve(this.filePath));
+    }
+    getSviFileRelativePath() {
+        if (!this.filePath) {
+            throw new Error("SVIFile filePath is not defined, cannot get relative path.");
+        }
+        const config = config_1.Config.getInstance();
+        return (0, file_1.getRelativePath)(path_1.default.resolve(this.filePath), config.dir);
+    }
+    getSviFileFullPath() {
+        if (!this.filePath) {
+            throw new Error("SVIFile filePath is not defined, cannot get full path.");
+        }
+        return path_1.default.resolve(this.filePath);
+    }
+    getDestinationFileFullPath() {
+        if (!this.destinationFile) {
+            return undefined;
+        }
+        if (!this.filePath) {
+            // If SVI file path is not defined, we cannot resolve the destination file relative to it.
+            // The interface allows `undefined`, so returning `undefined` is appropriate here.
+            return undefined;
+        }
+        return path_1.default.resolve(this.getSviFileDirectory(), this.destinationFile);
+    }
+    getDestinationFileRelativePath() {
+        const fullPath = this.getDestinationFileFullPath();
+        if (!fullPath) {
+            return undefined;
+        }
+        const config = config_1.Config.getInstance();
+        return (0, file_1.getRelativePath)(fullPath, config.dir);
+    }
+    getImportPromptsFullPaths() {
+        if (!this.importPrompts || this.importPrompts.length === 0) {
+            return [];
+        }
+        if (!this.filePath) {
+            // Cannot resolve full paths without the base SVI file path.
+            // Returning an empty array to comply with the interface type.
+            return [];
+        }
+        const sviFileDir = this.getSviFileDirectory();
+        const config = config_1.Config.getInstance();
+        return this.importPrompts.map(relativePath => {
+            const fullPath = path_1.default.resolve(sviFileDir, relativePath);
+            const configRelativePath = (0, file_1.getRelativePath)(fullPath, config.dir);
+            return {
+                relativePath: configRelativePath,
+                fullPath: fullPath,
+            };
+        });
+    }
+    getDependenciesFullPaths() {
+        if (!this.dependencies || this.dependencies.length === 0) {
+            return [];
+        }
+        if (!this.filePath) {
+            // Cannot resolve full paths without the base SVI file path.
+            // Returning an empty array to comply with the interface type.
+            return [];
+        }
+        const sviFileDir = this.getSviFileDirectory();
+        const config = config_1.Config.getInstance();
+        return this.dependencies.map(relativePath => {
+            const fullPath = path_1.default.resolve(sviFileDir, relativePath);
+            const configRelativePath = (0, file_1.getRelativePath)(fullPath, config.dir);
+            return {
+                relativePath: configRelativePath,
+                fullPath: fullPath,
+            };
+        });
+    }
+}
+exports.default = SviFileClass;
+//# sourceMappingURL=sviFileClass.js.map

package/dist/src/svi/sviFileClass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sviFileClass.js","sourceRoot":"","sources":["../../../src/svi/sviFileClass.ts"],"names":[],"mappings":"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"}

package/dist/src/svi/sviFileOrderOptimizer/sviDependencyCycleAnalyzer.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class SviDependencyCycleAnalyzer {
+    constructor(sviDependencies) {
+        this._sviDependencies = sviDependencies;
+        this._graph = new Map();
+        this._fileMap = new Map();
+        this._cycles = [];
+        this._fileToCyclesMap = new Map();
+    }
+    /**
+     * Analyzes the sviDependencies[] array to detect dependency cycles.
+     * This method populates internal structures used by `isFileInCycle` and `areFilesInTheSameCycle`.
+     */
+    findCycles() {
+        this._buildGraph(); // Construct the graph representation
+        this._cycles = []; // Reset detected cycles
+        this._fileToCyclesMap = new Map(); // Reset map for file-to-cycle associations
+        const states = new Map(); // Stores the DFS state for each node
+        const path = []; // Stores the current path in the DFS traversal
+        // Initialize all nodes (files) as unvisited
+        for (const fileFullPath of this._fileMap.keys()) {
+            states.set(fileFullPath, 0);
+        }
+        // Iterate over all files to ensure that all connected components of the graph are visited
+        // This allows detection of cycles in disconnected parts of the dependency graph.
+        for (const fileFullPath of this._fileMap.keys()) {
+            if (states.get(fileFullPath) === 0) {
+                this._dfs(fileFullPath, states, path);
+            }
+        }
+    }
+    /**
+     * Recursive Depth-First Search (DFS) function to detect cycles.
+     * @param currentFileFullPath The full path of the SVIFile currently being visited.
+     * @param states A map tracking the state (unvisited, visiting, visited) of each node.
+     * @param path An array representing the current recursion path, used to reconstruct cycles.
+     */
+    _dfs(currentFileFullPath, states, path) {
+        states.set(currentFileFullPath, 1); // Mark current node as 'visiting' (in recursion stack)
+        path.push(currentFileFullPath); // Add current node to the current path
+        const dependencies = this._graph.get(currentFileFullPath) || [];
+        for (const dependentFileFullPath of dependencies) {
+            if (states.get(dependentFileFullPath) === 0) {
+                // Neighbor is unvisited, continue DFS
+                this._dfs(dependentFileFullPath, states, path);
+            }
+            else if (states.get(dependentFileFullPath) === 1) {
+                // Neighbor is 'visiting', meaning it's already in the current recursion stack.
+                // This indicates a back-edge and thus a cycle.
+                this._handleCycleDetection(dependentFileFullPath, path);
+            }
+            // If state is 2 (visited), ignore it as it's already processed and won't lead to new cycles from this path.
+        }
+        path.pop(); // Remove current node from path (backtrack)
+        states.set(currentFileFullPath, 2); // Mark current node as 'visited' (finished processing)
+    }
+    /**
+     * Extracts and stores a detected cycle.
+     * @param cycleStartFileFullPath The full path of the file where the cycle begins (the node that was 'visiting').
+     * @param currentPath The current DFS path, from which the cycle will be extracted.
+     */
+    _handleCycleDetection(cycleStartFileFullPath, currentPath) {
+        const cycleStartIndex = currentPath.indexOf(cycleStartFileFullPath);
+        if (cycleStartIndex === -1) {
+            // This scenario should ideally not occur if the DFS logic is correct.
+            return;
+        }
+        // Extract the file paths that form the cycle from the current DFS path.
+        const cycleFilePaths = currentPath.slice(cycleStartIndex);
+        const newCycle = [];
+        // Convert file paths back to SVIFile objects for storage.
+        for (const filePath of cycleFilePaths) {
+            const sviFile = this._fileMap.get(filePath);
+            if (sviFile) {
+                newCycle.push(sviFile);
+            }
+        }
+        if (newCycle.length > 0) {
+            const cycleIndex = this._cycles.length; // Assign a unique index to the new cycle
+            this._cycles.push(newCycle); // Store the cycle
+            // Update the mapping from each file in the cycle to its corresponding cycle index.
+            for (const fileInCycle of newCycle) {
+                const fileFullPath = fileInCycle.getSviFileFullPath();
+                if (!this._fileToCyclesMap.has(fileFullPath)) {
+                    this._fileToCyclesMap.set(fileFullPath, new Set());
+                }
+                this._fileToCyclesMap.get(fileFullPath)?.add(cycleIndex);
+            }
+        }
+    }
+    /**
+     * Builds the graph representation (adjacency list) and the file map from the provided SviDependency array.
+     * This prepares the data for the cycle detection algorithm.
+     */
+    _buildGraph() {
+        this._graph.clear();
+        this._fileMap.clear();
+        for (const dep of this._sviDependencies) {
+            const currentFileFullPath = dep.SVIFile.getSviFileFullPath();
+            this._fileMap.set(currentFileFullPath, dep.SVIFile);
+            // Ensure an entry exists for the current file in the graph, even if it has no dependencies.
+            if (!this._graph.has(currentFileFullPath)) {
+                this._graph.set(currentFileFullPath, []);
+            }
+            for (const dependentFile of dep.SviFilesItDependsOn) {
+                const dependentFileFullPath = dependentFile.getSviFileFullPath();
+                // Add the dependent file to the file map, in case it hasn't been added as a primary SVIFile yet.
+                this._fileMap.set(dependentFileFullPath, dependentFile);
+                // Add the dependency to the graph's adjacency list.
+                this._graph.get(currentFileFullPath)?.push(dependentFileFullPath);
+            }
+        }
+    }
+    /**
+     * Checks if a given SVIFile is part of at least one dependency cycle.
+     * @param sviFile The SVIFile to check.
+     * @returns True if the file is contained in any cycle, false otherwise.
+     */
+    isFileInCycle(sviFile) {
+        const fileFullPath = sviFile.getSviFileFullPath();
+        // A file is in a cycle if it has an entry in _fileToCyclesMap and that set is not empty.
+        return this._fileToCyclesMap.has(fileFullPath) && (this._fileToCyclesMap.get(fileFullPath)?.size || 0) > 0;
+    }
+    /**
+     * Checks if two SVIFile instances are contained within the same dependency cycle.
+     * @param sviFile1 The first SVIFile.
+     * @param sviFile2 The second SVIFile.
+     * @returns True if both files share at least one common dependency cycle, false otherwise.
+     */
+    areFilesInTheSameCycle(sviFile1, sviFile2) {
+        const file1FullPath = sviFile1.getSviFileFullPath();
+        const file2FullPath = sviFile2.getSviFileFullPath();
+        // If either file is not part of any cycle, they cannot be in the same cycle.
+        if (!this._fileToCyclesMap.has(file1FullPath) || !this._fileToCyclesMap.has(file2FullPath)) {
+            return false;
+        }
+        const cyclesOfFile1 = this._fileToCyclesMap.get(file1FullPath);
+        const cyclesOfFile2 = this._fileToCyclesMap.get(file2FullPath);
+        // This null check provides type safety, though it should logically be true given the check above.
+        if (!cyclesOfFile1 || !cyclesOfFile2) {
+            return false;
+        }
+        // Iterate through the cycles associated with file1 and check if any are also associated with file2.
+        for (const cycleIndex of cyclesOfFile1) {
+            if (cyclesOfFile2.has(cycleIndex)) {
+                return true; // Found a common cycle index, so they are in the same cycle.
+            }
+        }
+        return false; // No common cycle found between the two files.
+    }
+}
+exports.default = SviDependencyCycleAnalyzer;
+//# sourceMappingURL=sviDependencyCycleAnalyzer.js.map

package/dist/src/svi/sviFileOrderOptimizer/sviDependencyCycleAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sviDependencyCycleAnalyzer.js","sourceRoot":"","sources":["../../../../src/svi/sviFileOrderOptimizer/sviDependencyCycleAnalyzer.ts"],"names":[],"mappings":"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"}

package/dist/src/svi/sviFileOrderOptimizer/sviDependencyFinder.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class SviDependencyFinder {
+    constructor(sviFiles) {
+        this.foundDependencies = [];
+        this.destinationFileMap = new Map();
+        this.sviDependencyMap = new Map();
+        this.sviFiles = sviFiles;
+    }
+    findDependencies() {
+        // Step 1. For each SVIFile it detects target file with SVIFile.getDestinationFileFullPath
+        // and stores it in a map for efficient lookup.
+        this.destinationFileMap.clear();
+        for (const sviFile of this.sviFiles) {
+            const destinationFullPath = sviFile.getDestinationFileFullPath();
+            if (destinationFullPath) {
+                this.destinationFileMap.set(destinationFullPath, sviFile);
+            }
+        }
+        // Step 2. Then it loops through all the svi files, then for each file loops
+        // at each file in dependencies (array which is result of SVIFile.getDependenciesFullPaths()),
+        // and if a dependency file is among destination files found at step 1, then the source SVIFile
+        // for the destination is added to this SVI file dependencies (SviDependency.SviFilesItDependsOn).
+        // If no dependencies are found, an empty array is left in the SviDependency interface.
+        // The array of SviDependency elements for each of svi files is stored in class attribute.
+        this.foundDependencies = [];
+        this.sviDependencyMap.clear();
+        for (const sourceSviFile of this.sviFiles) {
+            const currentSviDependency = {
+                SVIFile: sourceSviFile,
+                SviFilesItDependsOn: [],
+            };
+            const declaredDependencies = sourceSviFile.getDependenciesFullPaths();
+            for (const declaredDependency of declaredDependencies) {
+                const dependentSviFile = this.destinationFileMap.get(declaredDependency.fullPath);
+                if (dependentSviFile) {
+                    currentSviDependency.SviFilesItDependsOn.push(dependentSviFile);
+                }
+            }
+            this.foundDependencies.push(currentSviDependency);
+            this.sviDependencyMap.set(sourceSviFile, currentSviDependency);
+        }
+        return this;
+    }
+    getFoundDependencies() {
+        return this.foundDependencies;
+    }
+    fileDependsOnAnother(sviFile, sviFileItDependsOnOrNot) {
+        const dependencyEntry = this.sviDependencyMap.get(sviFile);
+        if (!dependencyEntry) {
+            return false;
+        }
+        return dependencyEntry.SviFilesItDependsOn.includes(sviFileItDependsOnOrNot);
+    }
+}
+exports.default = SviDependencyFinder;
+//# sourceMappingURL=sviDependencyFinder.js.map

package/dist/src/svi/sviFileOrderOptimizer/sviDependencyFinder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sviDependencyFinder.js","sourceRoot":"","sources":["../../../../src/svi/sviFileOrderOptimizer/sviDependencyFinder.ts"],"names":[],"mappings":";;AAIA,MAAqB,mBAAmB;IAMtC,YAAY,QAAmB;QAJvB,sBAAiB,GAAoB,EAAE,CAAC;QACxC,uBAAkB,GAAyB,IAAI,GAAG,EAAE,CAAC;QACrD,qBAAgB,GAAgC,IAAI,GAAG,EAAE,CAAC;QAGhE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,gBAAgB;QACd,0FAA0F;QAC1F,+CAA+C;QAC/C,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;QAChC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,mBAAmB,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;YACjE,IAAI,mBAAmB,EAAE,CAAC;gBACxB,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAED,4EAA4E;QAC5E,8FAA8F;QAC9F,+FAA+F;QAC/F,kGAAkG;QAClG,uFAAuF;QACvF,0FAA0F;QAC1F,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAE9B,KAAK,MAAM,aAAa,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,MAAM,oBAAoB,GAAkB;gBAC1C,OAAO,EAAE,aAAa;gBACtB,mBAAmB,EAAE,EAAE;aACxB,CAAC;YAEF,MAAM,oBAAoB,GAAG,aAAa,CAAC,wBAAwB,EAAE,CAAC;YAEtE,KAAK,MAAM,kBAAkB,IAAI,oBAAoB,EAAE,CAAC;gBACtD,MAAM,gBAAgB,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;gBAClF,IAAI,gBAAgB,EAAE,CAAC;oBACrB,oBAAoB,CAAC,mBAAmB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;YACD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAClD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED,oBAAoB,CAAC,OAAgB,EAAE,uBAAgC;QACrE,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAE3D,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,eAAe,CAAC,mBAAmB,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;IAC/E,CAAC;CACF;AA/DD,sCA+DC"}

package/dist/src/svi/sviFileOrderOptimizer/sviFileOrderOptimizer.js

@@ -0,0 +1,93 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const sviDependencyFinder_1 = __importDefault(require("./sviDependencyFinder"));
+const sviDependencyCycleAnalyzer_1 = __importDefault(require("./sviDependencyCycleAnalyzer")); // Assuming class name is SviDependencyCycleAnalyzer
+class SviFileOrderOptimizer {
+    constructor(sviFiles) {
+        this.optimizedResult = null;
+        this.sviFiles = sviFiles;
+    }
+    computeOptimizedOrder() {
+        // 1. Run SviDependencyFinder class to get an array of dependencies
+        const dependencyFinder = new sviDependencyFinder_1.default(this.sviFiles);
+        dependencyFinder.findDependencies();
+        const dependencies = dependencyFinder.getFoundDependencies();
+        // 2. Create an instance of SviDependencyCycleAnalyzer class and run
+        // the findCycles method to prepare for other methods calls.
+        const cycleAnalyzer = new sviDependencyCycleAnalyzer_1.default(dependencies);
+        cycleAnalyzer.findCycles();
+        let swappedOverall;
+        // Store full paths of files identified for preliminary generation
+        const preliminarySviFilesSet = new Set();
+        // Create a mutable copy of the initial sviFiles array to optimize its order
+        const currentOptimizedOrder = [...this.sviFiles];
+        // 7. If after all loops at least one swap has been done, then repeat these loops.
+        // This do-while loop ensures the entire sorting process is repeated as long as swaps occur.
+        do {
+            swappedOverall = false; // Reset for each full pass of the sorting algorithm
+            // 3. Loop at every svi file in the initial sviFiles array, current file is sviFile1
+            for (let i = 0; i < currentOptimizedOrder.length; i++) {
+                // 4. In each iteration, loop at all files starting from the next after the current
+                // till the last one, let it be sviFile2
+                for (let j = i + 1; j < currentOptimizedOrder.length; j++) {
+                    const sviFile1 = currentOptimizedOrder[i];
+                    const sviFile2 = currentOptimizedOrder[j];
+                    // 5. For each pair of sviFile1 and sviFile2 use the result of
+                    // SviDependencyFinder to check if sviFile1 depends on sviFile2
+                    if (dependencyFinder.fileDependsOnAnother(sviFile1, sviFile2)) {
+                        // 6. If it is true, then check if sviFile1 and sviFile2 are both in a dependency cycle
+                        // by calling SviDependencyCycleAnalyzer.isFileInCycle and if it is the case then
+                        // check if they are in the same cycle by calling
+                        // SviDependencyCycleAnalyzer.areFilesInTheSameCycle.
+                        const isFile1InCycle = cycleAnalyzer.isFileInCycle(sviFile1);
+                        const isFile2InCycle = cycleAnalyzer.isFileInCycle(sviFile2);
+                        if (isFile1InCycle && isFile2InCycle && cycleAnalyzer.areFilesInTheSameCycle(sviFile1, sviFile2)) {
+                            // If true, then add this file to a separate array of files that need a preliminary generation
+                            preliminarySviFilesSet.add(sviFile1.getSviFileFullPath());
+                            preliminarySviFilesSet.add(sviFile2.getSviFileFullPath());
+                        }
+                        else {
+                            // If false (i.e., dependency exists but not in the same cycle, or not in a cycle),
+                            // then swap sviFile1 and sviFile2 in the list of svi files.
+                            [currentOptimizedOrder[i], currentOptimizedOrder[j]] = [currentOptimizedOrder[j], currentOptimizedOrder[i]];
+                            swappedOverall = true;
+                            // A swap occurred, which means the order has changed.
+                            // The algorithm requires repeating "these loops" if any swap has been done.
+                            // To achieve this, we break out of the current nested loops and let the do-while
+                            // condition re-start the entire iteration from the beginning of the `currentOptimizedOrder`.
+                            i = currentOptimizedOrder.length; // Force the outer loop to terminate
+                            break; // Break the inner loop
+                        }
+                    }
+                }
+            }
+        } while (swappedOverall); // Repeat as long as swaps were made in the last full pass
+        // 7. If not [swapped], then add the unique list in preliminarySviFiles array in the beginning with
+        // flag isPreliminary to the result or type SviFileToLoad[].
+        // 8. Save the result
+        this.optimizedResult = [];
+        // Add unique preliminary files first with isPreliminary: true
+        for (const preliminaryFilePath of preliminarySviFilesSet) {
+            this.optimizedResult.push({ filePath: preliminaryFilePath, isPreliminary: true });
+        }
+        // Then, add all files from the final optimized order as non-preliminary.
+        // Files that were identified as preliminary will appear again here, as required
+        // ("If the file is created with a preliminary version, it must be in the array again later
+        // to be regenerated in the final version.").
+        for (const sviFile of currentOptimizedOrder) {
+            this.optimizedResult.push({ filePath: sviFile.getSviFileFullPath(), isPreliminary: false });
+        }
+        return this;
+    }
+    getOptimizedFiles() {
+        if (this.optimizedResult === null) {
+            throw new Error("computeOptimizedOrder must be called before getOptimizedFiles to compute the order.");
+        }
+        return this.optimizedResult;
+    }
+}
+exports.default = SviFileOrderOptimizer;
+//# sourceMappingURL=sviFileOrderOptimizer.js.map

package/dist/src/svi/sviFileOrderOptimizer/sviFileOrderOptimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sviFileOrderOptimizer.js","sourceRoot":"","sources":["../../../../src/svi/sviFileOrderOptimizer/sviFileOrderOptimizer.ts"],"names":[],"mappings":"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"}

package/dist/src/svi/sviFileOrderOptimizer/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/svi/sviFileOrderOptimizer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/svi/sviFileOrderOptimizer/types.ts"],"names":[],"mappings":""}