legal-markdown-js 2.7.0 → 2.8.0

package/README.md

@@ -37,6 +37,12 @@ imports `@import`, and generate professional PDFs ready to be shared.
 npm install legal-markdown-js
 ```
 
+After installation, you'll have access to these commands:
+
+- **`legal-md`** - Standard command-line interface with options and flags
+- **`legal-md-ui`** - Interactive CLI with guided prompts and smart defaults
+- **`legal2md`** - Alias for `legal-md` (for compatibility)
+
 ## 🚀 Try it Online
 
 **[Live Playground](https://petalo.github.io/legal-markdown-js/)** - Try Legal
@@ -47,6 +53,8 @@ processing.
 
 ### Command Line Usage
 
+#### Standard CLI
+
 ```bash
 # Basic document processing
 legal-md input.md output.md
@@ -58,6 +66,28 @@ legal-md document.md --pdf --highlight
 legal-md document.md --html --css styles.css
 ```
 
+#### Interactive CLI
+
+For a guided, user-friendly experience, use the interactive CLI:
+
+```bash
+# Launch interactive mode
+legal-md-ui
+```
+
+The interactive CLI provides:
+
+- **📁 Smart file discovery**: Automatically scans your input directory for
+  supported files (`.md`, `.markdown`, `.rst`, `.tex`, `.latex`, `.txt`)
+- **🎯 Multiple output formats**: Select any combination of PDF, HTML, Markdown,
+  and metadata export
+- **⚙️ Conditional options**: Processing options adapt based on your selected
+  formats
+- **🎨 CSS selection**: Choose from available stylesheets or proceed without
+  custom styling
+- **📋 Configuration summary**: Review all settings before processing
+- **✅ Clear results**: See exactly which files were generated
+
 ### Programmatic Usage
 
 ```typescript
@@ -106,6 +136,8 @@ All original Legal Markdown features are fully implemented:
 
 Additional features available only in the Node.js version:
 
+- **Interactive CLI**: User-friendly guided interface with smart file discovery
+  and configuration management
 - **Mixins System**: Template substitution and helpers with `{{variable}}`
   syntax
 - **AST-Based Processing**: Modern AST-based mixin processing to prevent text

package/dist/cli/interactive/index.d.ts

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * Interactive CLI for Legal Markdown Processing
+ *
+ * This module provides an interactive command-line interface for Legal Markdown
+ * processing, guiding users through file selection, format options, and processing
+ * configuration with intuitive prompts.
+ *
+ * Features:
+ * - Interactive file selection with recursive directory scanning
+ * - Multiple output format selection (HTML, PDF, Markdown, Metadata)
+ * - Conditional processing options based on selected formats
+ * - CSS file selection for HTML/PDF styling
+ * - Configuration confirmation and summary display
+ * - Integration with existing CliService for processing
+ *
+ * @example
+ * ```bash
+ * # Launch interactive mode
+ * legal-md-ui
+ * ```
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/interactive/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/cli/interactive/index.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Interactive CLI for Legal Markdown Processing
+ *
+ * This module provides an interactive command-line interface for Legal Markdown
+ * processing, guiding users through file selection, format options, and processing
+ * configuration with intuitive prompts.
+ *
+ * Features:
+ * - Interactive file selection with recursive directory scanning
+ * - Multiple output format selection (HTML, PDF, Markdown, Metadata)
+ * - Conditional processing options based on selected formats
+ * - CSS file selection for HTML/PDF styling
+ * - Configuration confirmation and summary display
+ * - Integration with existing CliService for processing
+ *
+ * @example
+ * ```bash
+ * # Launch interactive mode
+ * legal-md-ui
+ * ```
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const file_selector_1 = require("./prompts/file-selector");
+const output_format_1 = require("./prompts/output-format");
+const processing_options_1 = require("./prompts/processing-options");
+const css_selector_1 = require("./prompts/css-selector");
+const filename_1 = require("./prompts/filename");
+const confirmation_1 = require("./prompts/confirmation");
+const service_1 = require("./service");
+const format_helpers_1 = require("./utils/format-helpers");
+/**
+ * Main interactive flow that guides users through the complete Legal Markdown processing workflow
+ *
+ * This function orchestrates the entire interactive experience by:
+ * 1. Displaying welcome message and scanning for input files
+ * 2. Prompting for file selection from available documents
+ * 3. Collecting output format preferences (PDF, HTML, Markdown, Metadata)
+ * 4. Gathering processing options based on selected formats
+ * 5. Optional CSS file selection for styling
+ * 6. Output filename specification
+ * 7. Configuration confirmation and processing execution
+ *
+ * @returns Promise that resolves when the interactive flow completes
+ * @throws Error when processing fails or user cancels operation
+ */
+async function runInteractiveMode() {
+    try {
+        console.log(chalk_1.default.bold.blue('\n🎯 Legal Markdown Interactive CLI\n'));
+        console.log(chalk_1.default.gray('Follow the prompts to configure your document processing.\n'));
+        // Step 1: Select input file
+        const inputFile = await (0, file_selector_1.selectInputFile)();
+        // Step 2: Select output formats
+        const outputFormats = await (0, output_format_1.selectOutputFormats)();
+        // Step 3: Configure processing options
+        const processingOptions = await (0, processing_options_1.promptProcessingOptions)(outputFormats);
+        // Step 4: Select CSS file (if needed)
+        const cssFile = await (0, css_selector_1.selectCssFile)(outputFormats);
+        // Step 5: Enter output filename
+        const outputFilename = await (0, filename_1.promptOutputFilename)(inputFile);
+        // Build configuration
+        const config = {
+            inputFile,
+            outputFilename,
+            outputFormats,
+            processingOptions,
+            cssFile,
+        };
+        // Step 6: Confirm configuration
+        const confirmed = await (0, confirmation_1.confirmConfiguration)(config);
+        if (!confirmed) {
+            console.log(chalk_1.default.yellow('\n❌ Operation cancelled.\n'));
+            return;
+        }
+        // Step 7: Process files
+        console.log(chalk_1.default.cyan('\n⏳ Processing files...\n'));
+        const service = new service_1.InteractiveService(config);
+        const outputFiles = await service.processFile(inputFile);
+        // Step 8: Show results
+        console.log((0, format_helpers_1.formatSuccessMessage)(outputFiles));
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('User force closed')) {
+            console.log(chalk_1.default.yellow('\n👋 Goodbye!\n'));
+            return;
+        }
+        console.log((0, format_helpers_1.formatErrorMessage)(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+}
+// Create program
+const program = new commander_1.Command();
+// Setup CLI information
+program
+    .name('legal-md-ui')
+    .description('Interactive CLI for Legal Markdown document processing')
+    .version('0.1.0')
+    .action(runInteractiveMode);
+// Parse command line arguments
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/interactive/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/interactive/index.ts"],"names":[],"mappings":";;AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;AAEH,yCAAoC;AACpC,kDAA0B;AAC1B,2DAA0D;AAC1D,2DAA8D;AAC9D,qEAAuE;AACvE,yDAAuD;AACvD,iDAA0D;AAC1D,yDAA8D;AAC9D,uCAA+C;AAE/C,2DAAkF;AAElF;;;;;;;;;;;;;;GAcG;AACH,KAAK,UAAU,kBAAkB;IAC/B,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC,CAAC;QAEvF,4BAA4B;QAC5B,MAAM,SAAS,GAAG,MAAM,IAAA,+BAAe,GAAE,CAAC;QAE1C,gCAAgC;QAChC,MAAM,aAAa,GAAG,MAAM,IAAA,mCAAmB,GAAE,CAAC;QAElD,uCAAuC;QACvC,MAAM,iBAAiB,GAAG,MAAM,IAAA,4CAAuB,EAAC,aAAa,CAAC,CAAC;QAEvE,sCAAsC;QACtC,MAAM,OAAO,GAAG,MAAM,IAAA,4BAAa,EAAC,aAAa,CAAC,CAAC;QAEnD,gCAAgC;QAChC,MAAM,cAAc,GAAG,MAAM,IAAA,+BAAoB,EAAC,SAAS,CAAC,CAAC;QAE7D,sBAAsB;QACtB,MAAM,MAAM,GAAsB;YAChC,SAAS;YACT,cAAc;YACd,aAAa;YACb,iBAAiB;YACjB,OAAO;SACR,CAAC;QAEF,gCAAgC;QAChC,MAAM,SAAS,GAAG,MAAM,IAAA,mCAAoB,EAAC,MAAM,CAAC,CAAC;QAErD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QAED,wBAAwB;QACxB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC;QAErD,MAAM,OAAO,GAAG,IAAI,4BAAkB,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAEzD,uBAAuB;QACvB,OAAO,CAAC,GAAG,CAAC,IAAA,qCAAoB,EAAC,WAAW,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC1E,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,IAAA,mCAAkB,EAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,iBAAiB;AACjB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,wBAAwB;AACxB,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,WAAW,CAAC,wDAAwD,CAAC;KACrE,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAE9B,+BAA+B;AAC/B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/cli/interactive/prompts/confirmation.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Confirmation prompt for Interactive CLI
+ */
+import { InteractiveConfig } from '../types';
+/**
+ * Show configuration summary and prompt for confirmation
+ */
+export declare function confirmConfiguration(config: InteractiveConfig): Promise<boolean>;
+//# sourceMappingURL=confirmation.d.ts.map

package/dist/cli/interactive/prompts/confirmation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation.d.ts","sourceRoot":"","sources":["../../../../src/cli/interactive/prompts/confirmation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7C;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAStF"}

package/dist/cli/interactive/prompts/confirmation.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * @fileoverview Confirmation prompt for Interactive CLI
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirmConfiguration = confirmConfiguration;
+const prompts_1 = require("@inquirer/prompts");
+const format_helpers_1 = require("../utils/format-helpers");
+/**
+ * Show configuration summary and prompt for confirmation
+ */
+async function confirmConfiguration(config) {
+    console.log((0, format_helpers_1.formatConfigSummary)(config));
+    const confirmed = await (0, prompts_1.confirm)({
+        message: 'Proceed with this configuration?',
+        default: true,
+    });
+    return confirmed;
+}
+//# sourceMappingURL=confirmation.js.map

package/dist/cli/interactive/prompts/confirmation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation.js","sourceRoot":"","sources":["../../../../src/cli/interactive/prompts/confirmation.ts"],"names":[],"mappings":";AAAA;;GAEG;;AASH,oDASC;AAhBD,+CAA4C;AAE5C,4DAA8D;AAE9D;;GAEG;AACI,KAAK,UAAU,oBAAoB,CAAC,MAAyB;IAClE,OAAO,CAAC,GAAG,CAAC,IAAA,oCAAmB,EAAC,MAAM,CAAC,CAAC,CAAC;IAEzC,MAAM,SAAS,GAAG,MAAM,IAAA,iBAAO,EAAC;QAC9B,OAAO,EAAE,kCAAkC;QAC3C,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/cli/interactive/prompts/css-selector.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview CSS file selection prompt for Interactive CLI
+ */
+import { OutputFormat } from '../types';
+/**
+ * Prompt user to select a CSS file if HTML or PDF formats are selected
+ */
+export declare function selectCssFile(outputFormats: OutputFormat): Promise<string | undefined>;
+//# sourceMappingURL=css-selector.d.ts.map

package/dist/cli/interactive/prompts/css-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-selector.d.ts","sourceRoot":"","sources":["../../../../src/cli/interactive/prompts/css-selector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAIxC;;GAEG;AACH,wBAAsB,aAAa,CAAC,aAAa,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA6B5F"}

package/dist/cli/interactive/prompts/css-selector.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * @fileoverview CSS file selection prompt for Interactive CLI
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectCssFile = selectCssFile;
+const prompts_1 = require("@inquirer/prompts");
+const _constants_1 = require("../../../constants/index.js");
+const file_scanner_1 = require("../utils/file-scanner");
+const format_helpers_1 = require("../utils/format-helpers");
+const NO_CSS_OPTION = 'No custom CSS';
+/**
+ * Prompt user to select a CSS file if HTML or PDF formats are selected
+ */
+async function selectCssFile(outputFormats) {
+    // Only show CSS selection if HTML or PDF is selected
+    if (!outputFormats.html && !outputFormats.pdf) {
+        return undefined;
+    }
+    console.log('\n🎨 CSS Selection:\n');
+    const cssFiles = (0, file_scanner_1.scanCssFiles)(_constants_1.RESOLVED_PATHS.STYLES_DIR);
+    if (cssFiles.length === 0) {
+        console.log((0, format_helpers_1.formatWarningMessage)(`No CSS files found in ${_constants_1.RESOLVED_PATHS.STYLES_DIR}`));
+        return undefined;
+    }
+    const choices = [
+        { name: NO_CSS_OPTION, value: undefined },
+        ...cssFiles.map(file => ({
+            name: file,
+            value: file,
+        })),
+    ];
+    const selectedCss = await (0, prompts_1.select)({
+        message: 'Select a CSS file for styling:',
+        choices,
+    });
+    return selectedCss;
+}
+//# sourceMappingURL=css-selector.js.map

package/dist/cli/interactive/prompts/css-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-selector.js","sourceRoot":"","sources":["../../../../src/cli/interactive/prompts/css-selector.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAaH,sCA6BC;AAxCD,+CAA2C;AAC3C,2CAA4C;AAC5C,wDAAqD;AACrD,4DAA+D;AAG/D,MAAM,aAAa,GAAG,eAAe,CAAC;AAEtC;;GAEG;AACI,KAAK,UAAU,aAAa,CAAC,aAA2B;IAC7D,qDAAqD;IACrD,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC;QAC9C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAErC,MAAM,QAAQ,GAAG,IAAA,2BAAY,EAAC,2BAAc,CAAC,UAAU,CAAC,CAAC;IAEzD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,IAAA,qCAAoB,EAAC,yBAAyB,2BAAc,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QACxF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG;QACd,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE;QACzC,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvB,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;KACJ,CAAC;IAEF,MAAM,WAAW,GAAG,MAAM,IAAA,gBAAM,EAAC;QAC/B,OAAO,EAAE,gCAAgC;QACzC,OAAO;KACR,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/cli/interactive/prompts/file-selector.d.ts

@@ -0,0 +1,19 @@
+/**
+ * File selection prompt for Interactive CLI
+ *
+ * This module handles the file selection process, providing users with
+ * options to select from discovered files, browse directories, or
+ * manually enter file paths.
+ */
+/**
+ * Prompt user to select an input file
+ *
+ * Initiates the file selection process by scanning the default input directory
+ * and presenting available files to the user. If no files are found, falls back
+ * to manual input options.
+ *
+ * @returns Promise resolving to the absolute path of the selected input file
+ * @throws Error when user cancels or no valid file is selected
+ */
+export declare function selectInputFile(): Promise<string>;
+//# sourceMappingURL=file-selector.d.ts.map

package/dist/cli/interactive/prompts/file-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-selector.d.ts","sourceRoot":"","sources":["../../../../src/cli/interactive/prompts/file-selector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH;;;;;;;;;GASG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAqCvD"}

package/dist/cli/interactive/prompts/file-selector.js

@@ -0,0 +1,178 @@
+"use strict";
+/**
+ * File selection prompt for Interactive CLI
+ *
+ * This module handles the file selection process, providing users with
+ * options to select from discovered files, browse directories, or
+ * manually enter file paths.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectInputFile = selectInputFile;
+const prompts_1 = require("@inquirer/prompts");
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const _constants_1 = require("../../../constants/index.js");
+const file_scanner_1 = require("../utils/file-scanner");
+const format_helpers_1 = require("../utils/format-helpers");
+/** Option for browsing alternative directories */
+const BROWSE_OPTION = '📁 Browse other folder...';
+/** Option for manual path entry */
+const MANUAL_OPTION = '📝 Enter path manually...';
+/** Option for exiting the application */
+const EXIT_OPTION = '❌ Exit';
+/**
+ * Prompt user to select an input file
+ *
+ * Initiates the file selection process by scanning the default input directory
+ * and presenting available files to the user. If no files are found, falls back
+ * to manual input options.
+ *
+ * @returns Promise resolving to the absolute path of the selected input file
+ * @throws Error when user cancels or no valid file is selected
+ */
+async function selectInputFile() {
+    console.log(chalk_1.default.cyan(`🔍 Searching for files in: ${_constants_1.RESOLVED_PATHS.DEFAULT_INPUT_DIR}\n`));
+    const files = (0, file_scanner_1.scanDirectory)(_constants_1.RESOLVED_PATHS.DEFAULT_INPUT_DIR);
+    if (files.length === 0) {
+        console.log((0, format_helpers_1.formatWarningMessage)('No supported files found in the default directory.'));
+        return await handleManualInput();
+    }
+    const choices = [
+        ...files.map(file => ({
+            name: file.name,
+            value: file.path,
+        })),
+        { name: BROWSE_OPTION, value: BROWSE_OPTION },
+        { name: MANUAL_OPTION, value: MANUAL_OPTION },
+        { name: EXIT_OPTION, value: EXIT_OPTION },
+    ];
+    const selectedFile = await (0, prompts_1.select)({
+        message: 'Select an input file:',
+        choices,
+    });
+    switch (selectedFile) {
+        case BROWSE_OPTION:
+            return await handleBrowseFolder();
+        case MANUAL_OPTION:
+            return await handleManualInput();
+        case EXIT_OPTION:
+            console.log(chalk_1.default.yellow('👋 Goodbye!'));
+            process.exit(0);
+            break;
+        default:
+            return selectedFile;
+    }
+}
+/**
+ * Handle browsing to a different folder
+ */
+async function handleBrowseFolder() {
+    const folderPath = await (0, prompts_1.input)({
+        message: 'Enter folder path to browse:',
+        default: _constants_1.RESOLVED_PATHS.DEFAULT_INPUT_DIR,
+        validate: (value) => {
+            const resolvedPath = path.resolve(value);
+            try {
+                const fs = require('fs');
+                if (!fs.existsSync(resolvedPath)) {
+                    return 'Folder does not exist';
+                }
+                if (!fs.statSync(resolvedPath).isDirectory()) {
+                    return 'Path is not a directory';
+                }
+                return true;
+            }
+            catch {
+                return 'Invalid folder path';
+            }
+        },
+    });
+    const resolvedPath = path.resolve(folderPath);
+    console.log(chalk_1.default.cyan(`🔍 Searching for files in: ${resolvedPath}\n`));
+    const files = (0, file_scanner_1.scanDirectory)(resolvedPath);
+    if (files.length === 0) {
+        console.log((0, format_helpers_1.formatWarningMessage)('No supported files found in this directory.'));
+        return await handleManualInput();
+    }
+    const choices = [
+        ...files.map(file => ({
+            name: file.name,
+            value: file.path,
+        })),
+        { name: MANUAL_OPTION, value: MANUAL_OPTION },
+        { name: EXIT_OPTION, value: EXIT_OPTION },
+    ];
+    const selectedFile = await (0, prompts_1.select)({
+        message: 'Select an input file:',
+        choices,
+    });
+    if (selectedFile === MANUAL_OPTION) {
+        return await handleManualInput();
+    }
+    if (selectedFile === EXIT_OPTION) {
+        console.log(chalk_1.default.yellow('👋 Goodbye!'));
+        process.exit(0);
+    }
+    return selectedFile;
+}
+/**
+ * Handle manual file path input
+ */
+async function handleManualInput() {
+    const filePath = await (0, prompts_1.input)({
+        message: 'Enter file path:',
+        validate: (value) => {
+            if (!value.trim()) {
+                return 'File path is required';
+            }
+            const resolvedPath = path.resolve(value.trim());
+            if (!(0, file_scanner_1.isValidFile)(resolvedPath)) {
+                return 'File does not exist or is not readable';
+            }
+            const ext = path.extname(resolvedPath).toLowerCase();
+            const supportedExts = ['.md', '.markdown', '.rst', '.tex', '.latex', '.txt'];
+            if (!supportedExts.includes(ext)) {
+                return `Unsupported file type. Supported: ${supportedExts.join(', ')}`;
+            }
+            return true;
+        },
+    });
+    return path.resolve(filePath.trim());
+}
+//# sourceMappingURL=file-selector.js.map

package/dist/cli/interactive/prompts/file-selector.js.map

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

package/dist/cli/interactive/prompts/filename.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Output filename input prompt for Interactive CLI
+ */
+/**
+ * Prompt user for output filename (without extension)
+ */
+export declare function promptOutputFilename(inputFile: string): Promise<string>;
+//# sourceMappingURL=filename.d.ts.map

package/dist/cli/interactive/prompts/filename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename.d.ts","sourceRoot":"","sources":["../../../../src/cli/interactive/prompts/filename.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiC7E"}

package/dist/cli/interactive/prompts/filename.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * @fileoverview Output filename input prompt for Interactive CLI
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptOutputFilename = promptOutputFilename;
+const prompts_1 = require("@inquirer/prompts");
+const path = __importStar(require("path"));
+/**
+ * Prompt user for output filename (without extension)
+ */
+async function promptOutputFilename(inputFile) {
+    const inputBasename = path.basename(inputFile, path.extname(inputFile));
+    const filename = await (0, prompts_1.input)({
+        message: 'Enter output filename (without extension):',
+        default: inputBasename,
+        validate: (value) => {
+            const trimmed = value.trim();
+            if (!trimmed) {
+                return 'Filename is required';
+            }
+            // Check for invalid characters (basic validation)
+            const invalidChars = /[<>:"/\\|?*]/;
+            if (invalidChars.test(trimmed)) {
+                return 'Filename contains invalid characters';
+            }
+            // Check if it starts/ends with spaces or dots
+            if (trimmed !== value) {
+                return 'Filename cannot start or end with spaces';
+            }
+            if (trimmed.startsWith('.') || trimmed.endsWith('.')) {
+                return 'Filename cannot start or end with dots';
+            }
+            return true;
+        },
+    });
+    return filename.trim();
+}
+//# sourceMappingURL=filename.js.map

package/dist/cli/interactive/prompts/filename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename.js","sourceRoot":"","sources":["../../../../src/cli/interactive/prompts/filename.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQH,oDAiCC;AAvCD,+CAA0C;AAC1C,2CAA6B;AAE7B;;GAEG;AACI,KAAK,UAAU,oBAAoB,CAAC,SAAiB;IAC1D,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAExE,MAAM,QAAQ,GAAG,MAAM,IAAA,eAAK,EAAC;QAC3B,OAAO,EAAE,4CAA4C;QACrD,OAAO,EAAE,aAAa;QACtB,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;YAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,sBAAsB,CAAC;YAChC,CAAC;YAED,kDAAkD;YAClD,MAAM,YAAY,GAAG,cAAc,CAAC;YACpC,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,OAAO,sCAAsC,CAAC;YAChD,CAAC;YAED,8CAA8C;YAC9C,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;gBACtB,OAAO,0CAA0C,CAAC;YACpD,CAAC;YAED,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrD,OAAO,wCAAwC,CAAC;YAClD,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/cli/interactive/prompts/output-format.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Output format selection prompt for Interactive CLI
+ */
+import { OutputFormat } from '../types';
+/**
+ * Prompt user to select output formats
+ */
+export declare function selectOutputFormats(): Promise<OutputFormat>;
+//# sourceMappingURL=output-format.d.ts.map

package/dist/cli/interactive/prompts/output-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.d.ts","sourceRoot":"","sources":["../../../../src/cli/interactive/prompts/output-format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,YAAY,CAAC,CAkBjE"}

package/dist/cli/interactive/prompts/output-format.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * @fileoverview Output format selection prompt for Interactive CLI
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectOutputFormats = selectOutputFormats;
+const prompts_1 = require("@inquirer/prompts");
+/**
+ * Prompt user to select output formats
+ */
+async function selectOutputFormats() {
+    const selectedFormats = await (0, prompts_1.checkbox)({
+        message: 'Select output formats:',
+        choices: [
+            { name: '🌐 HTML', value: 'html' },
+            { name: '📄 PDF', value: 'pdf', checked: true }, // Default selected
+            { name: '📝 Markdown', value: 'markdown' },
+            { name: '📊 Export metadata (YAML/JSON)', value: 'metadata' },
+        ],
+        required: true, // This ensures at least one option is selected
+    });
+    return {
+        html: selectedFormats.includes('html'),
+        pdf: selectedFormats.includes('pdf'),
+        markdown: selectedFormats.includes('markdown'),
+        metadata: selectedFormats.includes('metadata'),
+    };
+}
+//# sourceMappingURL=output-format.js.map

package/dist/cli/interactive/prompts/output-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.js","sourceRoot":"","sources":["../../../../src/cli/interactive/prompts/output-format.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAQH,kDAkBC;AAxBD,+CAA6C;AAG7C;;GAEG;AACI,KAAK,UAAU,mBAAmB;IACvC,MAAM,eAAe,GAAG,MAAM,IAAA,kBAAQ,EAAC;QACrC,OAAO,EAAE,wBAAwB;QACjC,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE;YAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,mBAAmB;YACpE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE;YAC1C,EAAE,IAAI,EAAE,gCAAgC,EAAE,KAAK,EAAE,UAAU,EAAE;SAC9D;QACD,QAAQ,EAAE,IAAI,EAAE,+CAA+C;KAChE,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtC,GAAG,EAAE,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC;QACpC,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC9C,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC;KAC/C,CAAC;AACJ,CAAC"}