azul-sync 1.3.0

package/dist/cli.js

@@ -0,0 +1,397 @@
+#!/usr/bin/env node
+import { resolve, dirname } from "node:path";
+import fs from "node:fs";
+import { spawn } from "node:child_process";
+import { SyncDaemon } from "./index.js"; // or refactor to export the class
+import { config, getUserConfigPath, initializeConfig } from "./config.js";
+import { log } from "./util/log.js";
+import * as ReadLine from "readline";
+import { BuildCommand } from "./build.js";
+import { PushCommand } from "./push.js";
+import { PackCommand } from "./pack.js";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(fs.readFileSync(resolve(__dirname, "../package.json"), "utf8"));
+const { version } = pkg;
+const args = process.argv.slice(2);
+const commandIndex = args.findIndex((a) => !a.startsWith("--"));
+const command = commandIndex >= 0 ? args[commandIndex] : null;
+const syncDirFlag = args.find((a) => a.startsWith("--sync-dir="));
+const portFlag = args.find((a) => a.startsWith("--port="));
+const debugFlag = args.find((a) => a === "--debug");
+const noWarnFlag = args.find((a) => a === "--no-warn");
+const rojoFlag = args.includes("--rojo");
+const rojoProjectFlag = getFlagValue(["--rojo-project"], args);
+const fromSourcemapValue = getFlagValue(["--from-sourcemap"], args);
+const fromSourcemapFlag = args.includes("--from-sourcemap") || fromSourcemapValue !== null;
+if (args.includes("--help") || args.includes("-h")) {
+    console.log(`
+Usage:
+  azul <command> [options]
+  azul build [--from-sourcemap <file>] [--rojo] [--rojo-project <file>]
+  azul push [options] [--rojo] [--rojo-project <file>] [--from-sourcemap <file>]
+  azul pack [-o <file>] [--scripts-only]
+  azul config [--path]
+
+Commands:
+  (no command)            Start live sync daemon
+  build                   One-time push from filesystem into Studio
+  push                    Selective push using mappings (place config or -s/-d)
+  pack                    Serialize Studio instance properties into sourcemap.json
+  config                  Open the Azul config file in your default editor
+
+Global Options:
+  -h, --help              Show this help message
+  --version               Show Azul version
+  --debug                 Print verbose debug output
+  --no-warn               Disable confirmation prompts for dangerous operations
+  --sync-dir [PATH]       Directory to sync (default: current directory)
+  --port [NUMBER]         Studio connection port
+
+Build Options:
+  --from-sourcemap [FILE] Build from sourcemap
+  --rojo                  Enable Rojo-compatible parsing
+  --rojo-project [FILE]   Use a Rojo project file
+
+Push Options:
+  -s, --source [DIR]      Source folder to push
+  -d, --destination [PATH] Studio destination path (i.e "ReplicatedStorage.Packages")
+  --from-sourcemap [FILE] Push from sourcemap
+  --no-place-config       Ignore push mappings from place ModuleScript
+  --destructive           Wipe destination children before pushing
+  --rojo                  Enable Rojo-compatible parsing
+  --rojo-project [FILE]   Use a Rojo project file
+
+Pack Options:
+  -o, --output            Sourcemap path to write (default: config.sourcemapPath)
+  --scripts-only          Serialize only scripts and their descendants
+
+Config Options:
+  --path                  Print config file path
+  `);
+    process.exit(0);
+}
+if (args.includes("--version")) {
+    log.info(`Azul version: ${version}`);
+    process.exit(0);
+}
+initializeConfig();
+log.debug(`Loaded user config from: ${getUserConfigPath()}`);
+if (command === "config") {
+    const userConfigPath = getUserConfigPath();
+    if (args.includes("--path")) {
+        console.log(userConfigPath);
+        process.exit(0);
+    }
+    try {
+        await openWithDefaultEditor(userConfigPath);
+        log.info(`Opened Azul config: ${userConfigPath}`);
+    }
+    catch (error) {
+        log.error(`Failed to open config file: ${error}`);
+        process.exit(1);
+    }
+    process.exit(0);
+}
+// get current running path
+const currentPath = process.cwd();
+if ((currentPath.includes(`\\${config.syncDir}`) ||
+    currentPath.includes(`/${config.syncDir}`)) &&
+    !noWarnFlag) {
+    log.warn(`Looks like you're trying to run Azul from within a '${config.syncDir}' directory. Continuing to run Azul will create a directory like "/${config.syncDir}/${config.syncDir}/".`);
+    log.userInput("Continue? (Y/N)");
+    await new Promise((resolve) => {
+        process.stdin.setEncoding("utf-8");
+        const rl = ReadLine.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.on("line", (input) => {
+            const answer = input.trim().toLowerCase();
+            if (answer === "y" || answer === "yes") {
+                rl.close();
+                resolve();
+            }
+            else if (answer === "n" || answer === "no") {
+                log.info("Exiting. Please run azul from your project root.");
+                process.exit(0);
+            }
+            else {
+                log.userInput("Please answer Y (yes) or N (no). Are you sure? (Y/N)");
+            }
+        });
+    });
+}
+log.info(`Running azul from: ${currentPath}`);
+if (syncDirFlag)
+    config.syncDir = resolve(syncDirFlag.split("=")[1]);
+if (portFlag)
+    config.port = Number(portFlag.split("=")[1]);
+if (debugFlag)
+    config.debugMode = true;
+log.debug(`Debug mode is on!`);
+if (command === "build") {
+    if (!rojoFlag && fs.existsSync("default.project.json")) {
+        log.warn('Detected default.project.json! You can enable Rojo compatibility mode by passing the "--rojo" flag.');
+    }
+    const hasBuildSpecificOptions = rojoFlag || Boolean(rojoProjectFlag) || fromSourcemapFlag;
+    let applySourcemap = !fromSourcemapFlag;
+    let fromSourcemap = fromSourcemapFlag;
+    if (!hasBuildSpecificOptions) {
+        const sourcemapExists = fs.existsSync(config.sourcemapPath);
+        if (sourcemapExists) {
+            log.userInput(`Build directly from ${config.sourcemapPath} (includes non-script instances)? (Y/N)`);
+            const useFull = await promptYesNo();
+            if (useFull) {
+                fromSourcemap = true;
+                applySourcemap = false;
+            }
+            else {
+                log.userInput(`Use packed properties/attributes from ${config.sourcemapPath}? (Y/N)`);
+                applySourcemap = await promptYesNo();
+            }
+        }
+        else {
+            applySourcemap = false;
+            log.info(`No sourcemap found at ${config.sourcemapPath}. Build will recreate instances as scripts/folders.`);
+        }
+    }
+    if (!noWarnFlag) {
+        log.warn("WARNING: Building will overwrite matching Studio scripts and create new ones from your local environment. Existing Studio instances will not be deleted. Proceed with caution!");
+        log.userInput("Continue with build? (Y/N)");
+        await new Promise((resolve) => {
+            process.stdin.setEncoding("utf-8");
+            const rl = ReadLine.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            rl.on("line", (input) => {
+                const answer = input.trim().toLowerCase();
+                if (answer === "y" || answer === "yes") {
+                    rl.close();
+                    resolve();
+                }
+                else if (answer === "n" || answer === "no") {
+                    log.info("Exiting build command...");
+                    process.exit(0);
+                }
+                else {
+                    log.userInput("Please answer Y (yes) or N (no). Continue with build? (Y/N)");
+                }
+            });
+        });
+    }
+    await new BuildCommand({
+        syncDir: config.syncDir,
+        rojoMode: rojoFlag,
+        rojoProjectFile: rojoProjectFlag ?? undefined,
+        applySourcemap,
+        fromSourcemap,
+    }).run();
+    log.info("Build command completed.");
+    log.info("Run 'azul' to resume live sync if needed.");
+    log.info("Exiting...");
+    process.exit(0);
+}
+if (command === "push") {
+    const sourceValue = getFlagValue(["-s", "--source"], args);
+    const destValue = getFlagValue(["-d", "--destination"], args);
+    const destructive = args.includes("--destructive");
+    const usePlaceConfig = !args.includes("--no-place-config");
+    const hasPushSpecificOptions = Boolean(sourceValue ||
+        destValue ||
+        destructive ||
+        !usePlaceConfig ||
+        rojoFlag ||
+        rojoProjectFlag ||
+        fromSourcemapFlag);
+    let interactiveSource = sourceValue ?? undefined;
+    let interactiveDest = destValue ?? undefined;
+    let interactiveDestructive = destructive;
+    let interactiveUsePlaceConfig = usePlaceConfig;
+    let applySourcemap = !rojoFlag && !fromSourcemapFlag;
+    let fromSourcemap = !rojoFlag && fromSourcemapFlag;
+    if (!hasPushSpecificOptions && !rojoFlag) {
+        log.userInput("Use place config from Studio (ServerStorage.Azul.Config)? (Y/N)");
+        const useConfig = await promptYesNo();
+        interactiveUsePlaceConfig = useConfig;
+        if (!useConfig) {
+            log.userInput("Source folder to push (e.g., src)?");
+            interactiveSource = (await promptLine()).trim() || undefined;
+            log.userInput("Destination path (dot or slash separated, e.g., ReplicatedStorage.Packages)?");
+            interactiveDest = (await promptLine()).trim() || undefined;
+            log.userInput("Destructive push (wipe destination children)? (Y/N)");
+            interactiveDestructive = await promptYesNo();
+        }
+    }
+    if (!rojoFlag && !fromSourcemapFlag) {
+        log.userInput(`Build push snapshot directly from ${config.sourcemapPath} (includes non-script descendants and ancestors)? (Y/N)`);
+        fromSourcemap = await promptYesNo();
+        if (fromSourcemap) {
+            if (fs.existsSync(config.sourcemapPath)) {
+                log.userInput(`Apply packed properties/attributes from ${config.sourcemapPath}? (Y/N)`);
+                applySourcemap = await promptYesNo();
+            }
+            else {
+                fromSourcemap = false;
+                applySourcemap = false;
+                log.warn(`No sourcemap found at "${config.sourcemapPath}"! Please create one or provide it using the "--from-sourcemap" flag.`);
+                process.exit(1);
+            }
+        }
+        else {
+            fromSourcemap = false;
+            applySourcemap = false;
+            log.info(`Not using sourcemap. Azul will recreate instances as scripts/folders based on your local filesystem structure with default Properties/Attributes.`);
+        }
+    }
+    if (!rojoFlag && fs.existsSync("default.project.json")) {
+        log.info("Detected default.project.json. Azul stays in native mode unless you pass --rojo.");
+    }
+    if (destructive && !noWarnFlag) {
+        log.warn("WARNING: Destructive push will wipe destination children before applying snapshot. Proceed? (Y/N)");
+        await new Promise((resolve) => {
+            process.stdin.setEncoding("utf-8");
+            const rl = ReadLine.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            rl.on("line", (input) => {
+                const answer = input.trim().toLowerCase();
+                if (answer === "y" || answer === "yes") {
+                    rl.close();
+                    resolve();
+                }
+                else if (answer === "n" || answer === "no") {
+                    log.info("Exiting push command...");
+                    process.exit(0);
+                }
+                else {
+                    log.userInput("Please answer Y (yes) or N (no). Continue with destructive push? (Y/N)");
+                }
+            });
+        });
+    }
+    await new PushCommand({
+        source: interactiveSource ?? undefined,
+        destination: interactiveDest ?? undefined,
+        destructive: interactiveDestructive,
+        usePlaceConfig: rojoFlag ? false : interactiveUsePlaceConfig,
+        rojoMode: rojoFlag,
+        rojoProjectFile: rojoProjectFlag ?? undefined,
+        applySourcemap,
+        fromSourcemap,
+        sourcemapPath: fromSourcemapValue && !fromSourcemapValue.startsWith("--")
+            ? fromSourcemapValue
+            : undefined,
+    }).run();
+    log.info("Push command completed.");
+    log.info("Run 'azul' to resume live sync if needed.");
+    process.exit(0);
+}
+if (command === "pack") {
+    const outputValue = getFlagValue(["-o", "--output"], args);
+    let scriptsOnly = args.includes("--scripts-only");
+    const hasPackSpecificOptions = outputValue !== null || args.includes("--scripts-only");
+    let finalOutputPath = outputValue ?? config.sourcemapPath;
+    if (!hasPackSpecificOptions) {
+        const interactive = await promptPackInteractive(config.sourcemapPath);
+        finalOutputPath = interactive.outputPath;
+        scriptsOnly = interactive.scriptsOnly;
+    }
+    await new PackCommand({
+        outputPath: finalOutputPath,
+        scriptsAndDescendantsOnly: scriptsOnly,
+    }).run();
+    log.info("Pack command completed.");
+    process.exit(0);
+}
+new SyncDaemon().start();
+function getFlagValue(flags, argv) {
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        for (const flag of flags) {
+            if (arg === flag) {
+                return argv[i + 1] ?? null;
+            }
+            if (arg.startsWith(`${flag}=`)) {
+                return arg.split("=")[1] ?? null;
+            }
+        }
+    }
+    return null;
+}
+function openWithDefaultEditor(targetPath) {
+    return new Promise((resolvePromise, rejectPromise) => {
+        const currentPlatform = process.platform;
+        const argsByPlatform = {
+            win32: ["/c", "start", "", targetPath],
+            darwin: [targetPath],
+            linux: [targetPath],
+        };
+        const commandByPlatform = {
+            win32: "cmd",
+            darwin: "open",
+            linux: "xdg-open",
+        };
+        const commandName = commandByPlatform[currentPlatform];
+        const commandArgs = argsByPlatform[currentPlatform];
+        if (!commandName || !commandArgs) {
+            rejectPromise(new Error(`Unsupported platform: ${currentPlatform}`));
+            return;
+        }
+        const child = spawn(commandName, commandArgs, {
+            detached: true,
+            stdio: "ignore",
+        });
+        child.on("error", (error) => {
+            if (currentPlatform === "linux" && error.code === "ENOENT") {
+                rejectPromise(new Error("Could not open config file because 'xdg-open' is not installed. Install it (i.e: 'sudo apt install xdg-utils' or 'sudo dnf install xdg-utils') and try again."));
+                return;
+            }
+            rejectPromise(error);
+        });
+        child.unref();
+        resolvePromise();
+    });
+}
+async function promptPackInteractive(defaultOutputPath) {
+    log.info("Interactive mode: configuring 'azul pack'.");
+    log.userInput("Serialize everything? (Y/N)");
+    const scriptsOnly = !(await promptYesNo());
+    if (scriptsOnly) {
+        log.info("Scripts-only mode will only serialize Script, LocalScript, and ModuleScript instances and their descendants.");
+    }
+    log.userInput(`Output sourcemap path? (press Enter for '${defaultOutputPath}')`);
+    const outputInput = await promptLine();
+    const outputPath = outputInput.trim() === "" ? defaultOutputPath : outputInput.trim();
+    return {
+        outputPath,
+        scriptsOnly,
+    };
+}
+function promptLine() {
+    return new Promise((resolve) => {
+        const rl = ReadLine.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.once("line", (input) => {
+            rl.close();
+            resolve(input);
+        });
+    });
+}
+async function promptYesNo() {
+    while (true) {
+        const input = (await promptLine()).trim().toLowerCase();
+        if (input === "y" || input === "yes") {
+            return true;
+        }
+        if (input === "n" || input === "no") {
+            return false;
+        }
+        log.userInput("Please answer Y (yes) or N (no).");
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Configuration for the sync daemon
+ */
+export interface AzulConfig {
+    /** WebSocket server port */
+    port: number;
+    /** Enable debug mode */
+    debugMode: boolean;
+    /** Directory where synced files will be stored (relative to project root) */
+    syncDir: string;
+    /** Path where sourcemap.json is written (relative to project root) */
+    sourcemapPath: string;
+    /** File extension for scripts */
+    scriptExtension: string;
+    /** Debounce delay for file watching (ms) */
+    fileWatchDebounce: number;
+    /** Delete unmapped files in syncDir after a new connection/full snapshot */
+    deleteOrphansOnConnect: boolean;
+    /** Suffix ModuleScript names with ".module"? */
+    suffixModuleScripts: boolean;
+}
+export declare const defaultConfig: Readonly<AzulConfig>;
+export declare const config: AzulConfig;
+export declare function getUserConfigPath(): string;
+export declare function initializeConfig(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,MAAM,WAAW,UAAU;IAGzB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,SAAS,EAAE,OAAO,CAAC;IAInB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAEhB,sEAAsE;IACtE,aAAa,EAAE,MAAM,CAAC;IAEtB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IAExB,4CAA4C;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAE1B,4EAA4E;IAC5E,sBAAsB,EAAE,OAAO,CAAC;IAEhC,gDAAgD;IAChD,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,UAAU,CAS9C,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,UAAiC,CAAC;AAIvD,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAgBvC"}

package/dist/config.js

@@ -0,0 +1,105 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export const defaultConfig = {
+    port: 8080,
+    debugMode: false,
+    syncDir: "./sync",
+    sourcemapPath: "./sourcemap.json",
+    scriptExtension: ".luau",
+    fileWatchDebounce: 100,
+    deleteOrphansOnConnect: true,
+    suffixModuleScripts: false,
+};
+export const config = { ...defaultConfig };
+let initialized = false;
+export function getUserConfigPath() {
+    const configRoot = getPlatformConfigRoot();
+    return path.join(configRoot, "azul", "config.json");
+}
+export function initializeConfig() {
+    if (initialized) {
+        return;
+    }
+    initialized = true;
+    const configPath = getUserConfigPath();
+    ensureUserConfigExists(configPath);
+    const userConfig = readUserConfig(configPath);
+    if (!userConfig) {
+        return;
+    }
+    Object.assign(config, userConfig);
+}
+function getPlatformConfigRoot() {
+    if (process.platform === "win32") {
+        return process.env.APPDATA ?? path.join(os.homedir(), "AppData", "Roaming");
+    }
+    if (process.platform === "darwin") {
+        return path.join(os.homedir(), "Library", "Application Support");
+    }
+    return process.env.XDG_CONFIG_HOME ?? path.join(os.homedir(), ".config");
+}
+function ensureUserConfigExists(configPath) {
+    try {
+        const configDir = path.dirname(configPath);
+        fs.mkdirSync(configDir, { recursive: true });
+        if (!fs.existsSync(configPath)) {
+            fs.writeFileSync(configPath, `${JSON.stringify(defaultConfig, null, 2)}\n`, "utf8");
+        }
+    }
+    catch (error) {
+        console.warn("Failed to initialize Azul user config file:", error);
+    }
+}
+function readUserConfig(configPath) {
+    try {
+        const raw = fs.readFileSync(configPath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!isRecord(parsed)) {
+            return null;
+        }
+        return sanitizeConfig(parsed);
+    }
+    catch (error) {
+        console.warn("Failed to read Azul user config file:", error);
+        return null;
+    }
+}
+function sanitizeConfig(input) {
+    const sanitized = {};
+    if (isPositiveInteger(input.port)) {
+        sanitized.port = input.port;
+    }
+    if (typeof input.debugMode === "boolean") {
+        sanitized.debugMode = input.debugMode;
+    }
+    if (isNonEmptyString(input.syncDir)) {
+        sanitized.syncDir = input.syncDir;
+    }
+    if (isNonEmptyString(input.sourcemapPath)) {
+        sanitized.sourcemapPath = input.sourcemapPath;
+    }
+    if (isNonEmptyString(input.scriptExtension)) {
+        sanitized.scriptExtension = input.scriptExtension;
+    }
+    if (isPositiveInteger(input.fileWatchDebounce)) {
+        sanitized.fileWatchDebounce = input.fileWatchDebounce;
+    }
+    if (typeof input.deleteOrphansOnConnect === "boolean") {
+        sanitized.deleteOrphansOnConnect = input.deleteOrphansOnConnect;
+    }
+    if (typeof input.suffixModuleScripts === "boolean") {
+        sanitized.suffixModuleScripts = input.suffixModuleScripts;
+    }
+    return sanitized;
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isPositiveInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0;
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/fs/fileWriter.d.ts

@@ -0,0 +1,100 @@
+import { TreeNode } from "./treeManager.js";
+/**
+ * Mapping of GUID to file path
+ */
+export interface FileMapping {
+    guid: string;
+    filePath: string;
+    className: string;
+}
+/**
+ * Handles writing the virtual tree to the filesystem
+ */
+export declare class FileWriter {
+    private baseDir;
+    private fileMappings;
+    private pathToGuid;
+    constructor(baseDir?: string);
+    /**
+     * Write all script nodes to the filesystem
+     */
+    writeTree(nodes: Map<string, TreeNode>): void;
+    /**
+     * Write multiple scripts in a batch for improved I/O efficiency
+     */
+    writeBatch(nodes: TreeNode[]): void;
+    /**
+     * Write or update a single script
+     */
+    writeScript(node: TreeNode): string | null;
+    /**
+     * Delete a script file
+     */
+    deleteScript(guid: string): boolean;
+    /**
+     * Delete a script file by path even if the mapping is missing
+     */
+    deleteFilePath(filePath: string): boolean;
+    /**
+     * Get the filesystem path for a node
+     */
+    getFilePath(node: TreeNode): string;
+    /**
+     * Get the filesystem path for a node, with optional collision map for batch operations
+     */
+    private getFilePathWithCollisionMap;
+    /**
+     * Get the appropriate filename for a script node
+     */
+    private getScriptFileName;
+    /**
+     * Sanitize a name for use in filesystem
+     */
+    private sanitizeName;
+    /**
+     * Check if a node is a script
+     */
+    private isScriptNode;
+    /**
+     * Ensure a directory exists
+     */
+    private ensureDirectory;
+    /**
+     * Internal helper to remove a file and clean mapping
+     */
+    private deleteFilePathInternal;
+    /**
+     * Find the GUID that currently owns a file path, if any
+     */
+    private findGuidByFilePath;
+    /**
+     * Get path relative to base directory
+     */
+    private getRelativePath;
+    /**
+     * Get file mapping by GUID
+     */
+    getMapping(guid: string): FileMapping | undefined;
+    /**
+     * Get GUID by file path
+     */
+    getGuidByPath(filePath: string): string | undefined;
+    /**
+     * Get all file mappings
+     */
+    getAllMappings(): Map<string, FileMapping>;
+    /**
+     * Get the base directory
+     */
+    getBaseDir(): string;
+    /**
+     * Clean up empty directories
+     */
+    cleanupEmptyDirectories(): void;
+    private cleanupEmptyDirsRecursive;
+    /**
+     * Walk up from a directory and remove empty parents until baseDir is reached.
+     */
+    private cleanupParentsIfEmpty;
+}
+//# sourceMappingURL=fileWriter.d.ts.map

package/dist/fs/fileWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWriter.d.ts","sourceRoot":"","sources":["../../src/fs/fileWriter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAI5C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,UAAU,CAAkC;gBAExC,OAAO,GAAE,MAAuB;IAK5C;;OAEG;IACI,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI;IAoBpD;;OAEG;IACI,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAyC1C;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI;IA8CjD;;OAEG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAiB1C;;OAEG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAShD;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM;IAI1C;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA6CnC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIxD;;OAEG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1D;;OAEG;IACI,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC;IAIjD;;OAEG;IACI,UAAU,IAAI,MAAM;IAI3B;;OAEG;IACI,uBAAuB,IAAI,IAAI;IAItC,OAAO,CAAC,yBAAyB;IAyBjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAqB9B"}