legal-markdown-js 2.15.0 → 2.16.0

package/dist/cli/interactive/index.js

@@ -29,8 +29,85 @@ import { selectCssFile } from './prompts/css-selector.js';
 import { promptOutputFilename } from './prompts/filename.js';
 import { promptArchiveOptions } from './prompts/archive-options.js';
 import { confirmConfiguration } from './prompts/confirmation.js';
+import { handleFirstTimeUserExperience } from './prompts/ftux-handler.js';
 import { InteractiveService } from './service.js';
 import { formatSuccessMessage, formatErrorMessage } from './utils/format-helpers.js';
+/**
+ * Run FTUX (First-Time User Experience) mode
+ *
+ * Provides a guided onboarding experience for new users with options to:
+ * - Set up configuration files
+ * - Try demo examples
+ * - Get help and tutorials
+ * - Browse for files manually
+ *
+ * @returns Promise that resolves when FTUX completes
+ * @throws Error when FTUX fails or user cancels
+ */
+async function runFtuxMode() {
+    try {
+        console.log(chalk.bold.blue('\n🌟 Legal Markdown - First-Time User Experience\n'));
+        console.log(chalk.gray("Welcome! Let's get you started with Legal Markdown processing.\n"));
+        // Run the FTUX flow
+        const selectedFile = await handleFirstTimeUserExperience();
+        // If a file was selected from FTUX, continue with normal processing
+        if (selectedFile) {
+            console.log(chalk.green(`\n✅ Selected: ${selectedFile}`));
+            console.log(chalk.gray('Continuing with normal processing flow...\n'));
+            // Continue with the normal interactive flow starting from step 2
+            await continueInteractiveFlow(selectedFile);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('User force closed')) {
+            console.log(chalk.yellow('\n👋 Thanks for trying Legal Markdown!\n'));
+            return;
+        }
+        console.log(formatErrorMessage(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+}
+/**
+ * Continue interactive flow from a selected file (used after FTUX)
+ *
+ * @param inputFile - The file selected from FTUX
+ */
+async function continueInteractiveFlow(inputFile) {
+    // Step 2: Select output formats
+    const outputFormats = await selectOutputFormats();
+    // Step 3: Configure processing options
+    const processingOptions = await promptProcessingOptions(outputFormats);
+    // Step 4: Select CSS file (if needed)
+    const cssFile = await selectCssFile(outputFormats);
+    // Step 5: Enter output filename
+    const outputFilename = await promptOutputFilename(inputFile);
+    // Step 6: Configure archive options
+    const archiveResult = await promptArchiveOptions();
+    const archiveOptions = {
+        enabled: archiveResult.enableArchiving,
+        directory: archiveResult.archiveDirectory,
+    };
+    // Build configuration
+    const config = {
+        inputFile,
+        outputFilename,
+        outputFormats,
+        processingOptions,
+        archiveOptions,
+        cssFile,
+    };
+    // Step 7: Confirm configuration
+    const confirmed = await confirmConfiguration(config);
+    if (!confirmed) {
+        console.log(chalk.yellow('\n❌ Operation cancelled.\n'));
+        return;
+    }
+    // Step 8: Process files
+    const service = new InteractiveService(config);
+    const result = await service.processFile(inputFile);
+    // Step 9: Show results
+    console.log(formatSuccessMessage(result.outputFiles, result.archiveResult));
+}
 /**
  * Main interactive flow that guides users through the complete Legal Markdown processing workflow
  *
@@ -53,40 +130,8 @@ async function runInteractiveMode() {
         console.log(chalk.gray('Follow the prompts to configure your document processing.\n'));
         // Step 1: Select input file
         const inputFile = await selectInputFile();
-        // Step 2: Select output formats
-        const outputFormats = await selectOutputFormats();
-        // Step 3: Configure processing options
-        const processingOptions = await promptProcessingOptions(outputFormats);
-        // Step 4: Select CSS file (if needed)
-        const cssFile = await selectCssFile(outputFormats);
-        // Step 5: Enter output filename
-        const outputFilename = await promptOutputFilename(inputFile);
-        // Step 6: Configure archive options
-        const archiveResult = await promptArchiveOptions();
-        const archiveOptions = {
-            enabled: archiveResult.enableArchiving,
-            directory: archiveResult.archiveDirectory,
-        };
-        // Build configuration
-        const config = {
-            inputFile,
-            outputFilename,
-            outputFormats,
-            processingOptions,
-            archiveOptions,
-            cssFile,
-        };
-        // Step 7: Confirm configuration
-        const confirmed = await confirmConfiguration(config);
-        if (!confirmed) {
-            console.log(chalk.yellow('\n❌ Operation cancelled.\n'));
-            return;
-        }
-        // Step 8: Process files
-        const service = new InteractiveService(config);
-        const result = await service.processFile(inputFile);
-        // Step 9: Show results
-        console.log(formatSuccessMessage(result.outputFiles, result.archiveResult));
+        // Continue with the rest of the flow
+        await continueInteractiveFlow(inputFile);
     }
     catch (error) {
         if (error instanceof Error && error.message.includes('User force closed')) {
@@ -104,7 +149,15 @@ program
     .name('legal-md-ui')
     .description('Interactive CLI for Legal Markdown document processing')
     .version('0.1.0')
-    .action(runInteractiveMode);
+    .option('--ftux', 'Launch First-Time User Experience (setup wizard)')
+    .action(async (options) => {
+    if (options.ftux) {
+        await runFtuxMode();
+    }
+    else {
+        await runInteractiveMode();
+    }
+});
 // Parse command line arguments
 program.parse();
 //# sourceMappingURL=index.js.map

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

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

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

@@ -7,13 +7,13 @@
  *
  * @module
  */
-import { select, input } from '@inquirer/prompts';
-import * as path from 'path';
-import * as fs from 'fs';
+import { select } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { RESOLVED_PATHS } from '../../../constants/index.js';
-import { scanDirectory, isValidFile } from '../utils/file-scanner.js';
+import { scanDirectory } from '../utils/file-scanner.js';
 import { formatWarningMessage } from '../utils/format-helpers.js';
+import { handleFirstTimeUserExperience } from './ftux-handler.js';
+import { handleBrowseFolder, handleManualInput } from '../utils/file-input-helpers.js';
 /** Option for browsing alternative directories */
 const BROWSE_OPTION = '📁 Browse other folder...';
 /** Option for manual path entry */
@@ -35,7 +35,7 @@ export async function selectInputFile() {
     const files = scanDirectory(RESOLVED_PATHS.DEFAULT_INPUT_DIR);
     if (files.length === 0) {
         console.log(formatWarningMessage('No supported files found in the default directory.'));
-        return await handleManualInput();
+        return await handleFirstTimeUserExperience();
     }
     const choices = [
         ...files.map(file => ({
@@ -63,79 +63,4 @@ export async function selectInputFile() {
             return selectedFile;
     }
 }
-/**
- * Handle browsing to a different folder
- */
-async function handleBrowseFolder() {
-    const folderPath = await input({
-        message: 'Enter folder path to browse:',
-        default: RESOLVED_PATHS.DEFAULT_INPUT_DIR,
-        validate: (value) => {
-            const resolvedPath = path.resolve(value);
-            try {
-                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.cyan(`🔍 Searching for files in: ${resolvedPath}\n`));
-    const files = scanDirectory(resolvedPath);
-    if (files.length === 0) {
-        console.log(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 select({
-        message: 'Select an input file:',
-        choices,
-    });
-    if (selectedFile === MANUAL_OPTION) {
-        return await handleManualInput();
-    }
-    if (selectedFile === EXIT_OPTION) {
-        console.log(chalk.yellow('👋 Goodbye!'));
-        process.exit(0);
-    }
-    return selectedFile;
-}
-/**
- * Handle manual file path input
- */
-async function handleManualInput() {
-    const filePath = await input({
-        message: 'Enter file path:',
-        validate: (value) => {
-            if (!value.trim()) {
-                return 'File path is required';
-            }
-            const resolvedPath = path.resolve(value.trim());
-            if (!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

@@ -1 +1 @@
-{"version":3,"file":"file-selector.js","sourceRoot":"","sources":["../../../../src/cli/interactive/prompts/file-selector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"file-selector.js","sourceRoot":"","sources":["../../../../src/cli/interactive/prompts/file-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEpF,kDAAkD;AAClD,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAClD,mCAAmC;AACnC,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAClD,yCAAyC;AACzC,MAAM,WAAW,GAAG,QAAQ,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,8BAA8B,cAAc,CAAC,iBAAiB,IAAI,CAAC,CAAC,CAAC;IAE5F,MAAM,KAAK,GAAG,aAAa,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAE9D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,oDAAoD,CAAC,CAAC,CAAC;QACxF,OAAO,MAAM,6BAA6B,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,OAAO,GAAG;QACd,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,IAAI;SACjB,CAAC,CAAC;QACH,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;QAC7C,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;QAC7C,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;KAC1C,CAAC;IAEF,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC;QAChC,OAAO,EAAE,uBAAuB;QAChC,OAAO;KACR,CAAC,CAAC;IAEH,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,aAAa;YAChB,OAAO,MAAM,kBAAkB,EAAE,CAAC;QACpC,KAAK,aAAa;YAChB,OAAO,MAAM,iBAAiB,EAAE,CAAC;QACnC,KAAK,WAAW;YACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,MAAM;QACR;YACE,OAAO,YAAY,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/cli/interactive/prompts/ftux-handler.d.ts

@@ -0,0 +1,20 @@
+/**
+ * First Time User Experience (FTUX) handler for Interactive CLI
+ *
+ * This module provides an improved onboarding experience for new users
+ * when no files are found in the default directory, offering setup
+ * assistance, demo examples, and guided configuration.
+ *
+ * @module
+ */
+/**
+ * Handle first-time user experience when no files are found
+ *
+ * Provides a friendly onboarding flow with multiple options to help
+ * new users get started with Legal Markdown processing.
+ *
+ * @returns Promise resolving to the selected input file path
+ * @throws Error when user cancels or no valid option is selected
+ */
+export declare function handleFirstTimeUserExperience(): Promise<string>;
+//# sourceMappingURL=ftux-handler.d.ts.map

package/dist/cli/interactive/prompts/ftux-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ftux-handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/interactive/prompts/ftux-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwCH;;;;;;;;GAQG;AACH,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,MAAM,CAAC,CAuCrE"}

package/dist/cli/interactive/prompts/ftux-handler.js

@@ -0,0 +1,356 @@
+/**
+ * First Time User Experience (FTUX) handler for Interactive CLI
+ *
+ * This module provides an improved onboarding experience for new users
+ * when no files are found in the default directory, offering setup
+ * assistance, demo examples, and guided configuration.
+ *
+ * @module
+ */
+import { select, input, confirm } from '@inquirer/prompts';
+import * as path from 'path';
+import * as fs from 'fs';
+import chalk from 'chalk';
+// import { RESOLVED_PATHS } from '../../../constants/index.js';
+import { scanDirectory } from '../utils/file-scanner.js';
+import { formatWarningMessage } from '../utils/format-helpers.js';
+import { handleBrowseFolder, handleManualInput } from '../utils/file-input-helpers.js';
+import { getEnvFilePath, getInstallationDescription } from '../utils/installation-detector.js';
+/**
+ * Get current directory path in a way that works for both ESM and CJS
+ * Since we're building from dist, we can use relative paths from the script location
+ */
+function getCurrentDir() {
+    // Use process.argv[1] to determine script location - works for both ESM and CJS
+    const scriptPath = process.argv[1] || process.cwd();
+    return path.dirname(scriptPath);
+}
+/** Option for setting up configuration */
+const SETUP_CONFIG_OPTION = '🛠️  Setup configuration (.env)';
+/** Option for trying a demo example */
+const TRY_DEMO_OPTION = '🎯 Try a demo example';
+/** Option for browsing different folder */
+const BROWSE_FOLDER_OPTION = '📁 Browse different folder';
+/** Option for manual file input */
+const MANUAL_INPUT_OPTION = '📝 Enter file path manually';
+/** Option for getting help/tutorial */
+const GET_HELP_OPTION = '📖 Show help & tutorial';
+/** Option for exiting */
+const EXIT_OPTION = '❌ Exit';
+/**
+ * Handle first-time user experience when no files are found
+ *
+ * Provides a friendly onboarding flow with multiple options to help
+ * new users get started with Legal Markdown processing.
+ *
+ * @returns Promise resolving to the selected input file path
+ * @throws Error when user cancels or no valid option is selected
+ */
+export async function handleFirstTimeUserExperience() {
+    console.log(chalk.yellow('\n🌟 Welcome to Legal Markdown!'));
+    console.log(chalk.gray("It looks like you're getting started. Let me help you with that.\n"));
+    const choice = await select({
+        message: 'What would you like to do?',
+        choices: [
+            { name: SETUP_CONFIG_OPTION, value: 'setup' },
+            { name: TRY_DEMO_OPTION, value: 'demo' },
+            { name: BROWSE_FOLDER_OPTION, value: 'browse' },
+            { name: MANUAL_INPUT_OPTION, value: 'manual' },
+            { name: GET_HELP_OPTION, value: 'help' },
+            { name: EXIT_OPTION, value: 'exit' },
+        ],
+    });
+    switch (choice) {
+        case 'setup':
+            return await handleSetupConfiguration();
+        case 'demo':
+            return await handleDemoExample();
+        case 'browse':
+            return await handleBrowseFolder();
+        case 'manual':
+            return await handleManualInput();
+        case 'help':
+            await showHelpAndTutorial();
+            // After showing help, ask again
+            return await handleFirstTimeUserExperience();
+        case 'exit':
+            console.log(chalk.yellow('\n👋 Thanks for trying Legal Markdown!'));
+            console.log(chalk.gray('Run ') + chalk.cyan('legal-md-ui') + chalk.gray(" again when you're ready."));
+            process.exit(0);
+            break;
+        default:
+            throw new Error('Invalid option selected');
+    }
+}
+/**
+ * Handle setup configuration workflow
+ */
+async function handleSetupConfiguration() {
+    console.log(chalk.cyan('\n🛠️  Configuration Setup'));
+    console.log(chalk.gray("Let's set up your preferred directories for Legal Markdown processing."));
+    console.log(chalk.gray(getInstallationDescription() + '\n'));
+    // Ask for input directory
+    const inputDir = await input({
+        message: 'Where do you keep your markdown files? (input directory)',
+        default: process.cwd(),
+        validate: value => {
+            const resolvedPath = path.resolve(value);
+            if (!fs.existsSync(resolvedPath)) {
+                return 'Directory does not exist. Please enter a valid path.';
+            }
+            if (!fs.statSync(resolvedPath).isDirectory()) {
+                return 'Path is not a directory.';
+            }
+            return true;
+        },
+    });
+    // Ask for output directory
+    const outputDir = await input({
+        message: 'Where should processed files be saved? (output directory)',
+        default: path.join(path.resolve(inputDir), 'output'),
+        validate: value => {
+            const resolvedPath = path.resolve(value);
+            const parentDir = path.dirname(resolvedPath);
+            if (!fs.existsSync(parentDir)) {
+                return 'Parent directory does not exist.';
+            }
+            return true;
+        },
+    });
+    // Create .env configuration using installation-aware path
+    const envPath = getEnvFilePath();
+    const envContent = `# Legal Markdown Configuration
+# Generated by interactive setup
+
+LEGALMD_INPUT_DIR="${path.resolve(inputDir)}"
+LEGALMD_OUTPUT_DIR="${path.resolve(outputDir)}"
+LEGALMD_STYLES_DIR="${path.resolve(inputDir, 'styles')}"
+LEGALMD_ARCHIVE_DIR="${path.resolve(outputDir, 'archive')}"
+`;
+    // Check if .env already exists
+    if (fs.existsSync(envPath)) {
+        const overwrite = await confirm({
+            message: 'A .env file already exists. Overwrite it?',
+            default: false,
+        });
+        if (!overwrite) {
+            console.log(chalk.yellow('⚠️  Setup cancelled. Using existing configuration.'));
+        }
+        else {
+            fs.writeFileSync(envPath, envContent);
+            console.log(chalk.green(`✅ Configuration saved to ${envPath}`));
+        }
+    }
+    else {
+        fs.writeFileSync(envPath, envContent);
+        console.log(chalk.green(`✅ Configuration saved to ${envPath}`));
+    }
+    // Create output directory if it doesn't exist
+    const resolvedOutputDir = path.resolve(outputDir);
+    if (!fs.existsSync(resolvedOutputDir)) {
+        fs.mkdirSync(resolvedOutputDir, { recursive: true });
+        console.log(chalk.green(`✅ Created output directory: ${resolvedOutputDir}`));
+    }
+    // Now scan for files in the configured input directory
+    console.log(chalk.cyan(`\n🔍 Scanning for files in: ${path.resolve(inputDir)}\n`));
+    const files = scanDirectory(path.resolve(inputDir));
+    if (files.length === 0) {
+        console.log(formatWarningMessage('No supported files found in the configured directory.'));
+        console.log(chalk.gray('You can add .md, .markdown, .rst, .tex, or .txt files to get started.\n'));
+        const nextAction = await select({
+            message: 'What would you like to do next?',
+            choices: [
+                { name: TRY_DEMO_OPTION, value: 'demo' },
+                { name: MANUAL_INPUT_OPTION, value: 'manual' },
+                { name: EXIT_OPTION, value: 'exit' },
+            ],
+        });
+        switch (nextAction) {
+            case 'demo':
+                return await handleDemoExample();
+            case 'manual':
+                return await handleManualInput();
+            case 'exit':
+                process.exit(0);
+        }
+    }
+    // Show available files
+    const choices = [
+        ...files.map(file => ({
+            name: file.name,
+            value: file.path,
+        })),
+        { name: TRY_DEMO_OPTION, value: 'demo' },
+        { name: EXIT_OPTION, value: 'exit' },
+    ];
+    const selectedFile = await select({
+        message: 'Select a file to process:',
+        choices,
+    });
+    if (selectedFile === 'demo') {
+        return await handleDemoExample();
+    }
+    if (selectedFile === 'exit') {
+        process.exit(0);
+    }
+    return selectedFile;
+}
+/**
+ * Handle demo example selection
+ */
+async function handleDemoExample() {
+    console.log(chalk.cyan('\n🎯 Demo Examples'));
+    console.log(chalk.gray('Try Legal Markdown with these built-in examples.\n'));
+    // Get examples from the package - try multiple locations
+    const currentDir = getCurrentDir();
+    const possibleExamplesDirs = [
+        // In dist for development or when running from source
+        path.join(currentDir, '../../..', 'dist', 'examples'),
+        // In node_modules for installed package
+        path.join(process.cwd(), 'node_modules', 'legal-markdown-js', 'dist', 'examples'),
+        path.join(process.cwd(), 'node_modules', 'legal-markdown-js', 'examples'),
+        // Global installation paths
+        path.join(path.dirname(process.argv[1] || ''), '..', 'examples'),
+        path.join(path.dirname(process.argv[1] || ''), '..', 'dist', 'examples'),
+    ];
+    const availableExamples = [];
+    let examplesDir = '';
+    // Find the first existing examples directory
+    for (const dir of possibleExamplesDirs) {
+        if (fs.existsSync(dir)) {
+            examplesDir = dir;
+            break;
+        }
+    }
+    if (examplesDir) {
+        const basicExample = path.join(examplesDir, 'basic-processing', 'simple-document', 'example.md');
+        const advancedExample = path.join(examplesDir, 'advanced', 'complex-nda', 'nda-with-data.md');
+        if (fs.existsSync(basicExample)) {
+            availableExamples.push({
+                name: '📝 Basic Document Processing',
+                path: basicExample,
+                description: 'Simple markdown with template fields',
+            });
+        }
+        if (fs.existsSync(advancedExample)) {
+            availableExamples.push({
+                name: '📋 Advanced NDA Contract',
+                path: advancedExample,
+                description: 'Complex contract with conditional clauses',
+            });
+        }
+    }
+    // Fallback: create a simple demo file in current directory
+    if (availableExamples.length === 0) {
+        const demoPath = path.join(process.cwd(), 'legal-markdown-demo.md');
+        const demoContent = `---
+title: "Sample Legal Document"
+party1: "Acme Corporation"
+party2: "[Enter Client Name]"
+date: "{{formatDate(today, 'MMMM dd, yyyy')}}"
+jurisdiction: "California"
+---
+
+# {{title}}
+
+This agreement is entered into on {{date}} between {{party1}} and {{party2}}.
+
+## 1. Terms and Conditions
+
+l. **Effective Date**: This agreement becomes effective on {{date}}.
+
+l. **Jurisdiction**: This agreement shall be governed by the laws of {{jurisdiction}}.
+
+{{#if party2}}
+l. **Parties**: The contracting parties are {{party1}} and {{party2}}.
+{{else}}
+l. **Party**: The contracting party is {{party1}}.
+{{/if}}
+
+---
+
+*This is a demo document showing Legal Markdown features:*
+- *Template fields: {{party1}}, {{party2}}*
+- *Date formatting: {{date}}*
+- *Conditional clauses: {{#if party2}}*
+- *Automatic numbering: l.*
+`;
+        try {
+            fs.writeFileSync(demoPath, demoContent);
+            availableExamples.push({
+                name: '🎯 Generated Demo Document',
+                path: demoPath,
+                description: 'A sample document created just for you',
+            });
+            console.log(chalk.green(`✅ Created demo file: ${demoPath}`));
+        }
+        catch (error) {
+            console.log(chalk.yellow(`⚠️  Could not create demo file: ${error instanceof Error ? error.message : String(error)}`));
+        }
+    }
+    if (availableExamples.length === 0) {
+        console.log(chalk.red('❌ No demo examples available.'));
+        return await handleManualInput();
+    }
+    const choices = [
+        ...availableExamples.map(example => ({
+            name: `${example.name}\n   ${chalk.gray(example.description)}`,
+            value: example.path,
+        })),
+        { name: '← Back to main menu', value: 'back' },
+    ];
+    const selectedExample = await select({
+        message: 'Choose a demo example:',
+        choices,
+    });
+    if (selectedExample === 'back') {
+        return await handleFirstTimeUserExperience();
+    }
+    console.log(chalk.green(`\n✅ Selected demo: ${selectedExample}`));
+    console.log(chalk.gray('You can examine this file after processing to see how Legal Markdown works.\n'));
+    return selectedExample;
+}
+/**
+ * Show help and tutorial information
+ */
+async function showHelpAndTutorial() {
+    console.log(chalk.cyan('\n📖 Legal Markdown Help & Tutorial\n'));
+    console.log(chalk.bold('What is Legal Markdown?'));
+    console.log(chalk.gray('Legal Markdown is a tool for processing legal documents written in Markdown'));
+    console.log(chalk.gray('with YAML metadata and template fields.\n'));
+    console.log(chalk.bold('Key Features:'));
+    console.log(chalk.gray('• 📝 Template fields: {{party1}}, {{date}}, etc.'));
+    console.log(chalk.gray('• 🔢 Auto-numbering: l. for numbered clauses'));
+    console.log(chalk.gray('• ❓ Conditional clauses: {{#if condition}}...{{/if}}'));
+    console.log(chalk.gray('• 📅 Date formatting: {{formatDate(date, "MMM dd, yyyy")}}'));
+    console.log(chalk.gray('• 📄 Multiple output formats: HTML, PDF, Markdown'));
+    console.log(chalk.gray('• 🎨 Custom styling with CSS\n'));
+    console.log(chalk.bold('Example Document Structure:'));
+    console.log(chalk.gray('```'));
+    console.log(chalk.gray('---'));
+    console.log(chalk.gray('title: "My Contract"'));
+    console.log(chalk.gray('party1: "Company A"'));
+    console.log(chalk.gray('date: "2024-01-15"'));
+    console.log(chalk.gray('---'));
+    console.log(chalk.gray(''));
+    console.log(chalk.gray('# {{title}}'));
+    console.log(chalk.gray(''));
+    console.log(chalk.gray('Agreement between {{party1}} dated {{formatDate(date, "MMMM dd, yyyy")}}.'));
+    console.log(chalk.gray(''));
+    console.log(chalk.gray('l. First clause'));
+    console.log(chalk.gray('l. Second clause'));
+    console.log(chalk.gray('```\n'));
+    console.log(chalk.bold('Getting Started:'));
+    console.log(chalk.gray('1. 🛠️  Setup: Configure your input/output directories'));
+    console.log(chalk.gray('2. 📁 Files: Create .md files with YAML frontmatter'));
+    console.log(chalk.gray('3. 🎯 Process: Use this interactive CLI to convert documents'));
+    console.log(chalk.gray('4. 📄 Output: Get HTML, PDF, or processed Markdown\n'));
+    console.log(chalk.bold('Useful Commands:'));
+    console.log(chalk.gray('• ') + chalk.cyan('legal-md-ui') + chalk.gray(' - Interactive processing'));
+    console.log(chalk.gray('• ') + chalk.cyan('legal-md input.md') + chalk.gray(' - Direct processing'));
+    console.log(chalk.gray('• ') + chalk.cyan('legal-md --help') + chalk.gray(' - Command line help\n'));
+    await input({
+        message: 'Press Enter to continue...',
+    });
+}
+//# sourceMappingURL=ftux-handler.js.map