feat(actions): introduce templated actions and generation mode

This commit introduces a major evolution of Actions, enabling dynamic, multi-step workflows and content generation from scratch. The Actions UI is overhauled with bulk-management capabilities, and the application's startup logic is refactored for improved robustness and maintainability.

### Templated Actions with Placeholders
Actions can now include placeholders (e.g., `[language]`) in their instructions, which are filled out via a new step-by-step UI in the floating menu at runtime. This transforms simple prompts into powerful, reusable tools.

- Multiple Input Types: Supports Text, Multiline Text, Choice, Boolean, Number, Date, and File Picker.
- Validation Rules: Enforce requirements like required fields, character limits, or numeric ranges.
- Conditional Logic: Show or hide subsequent steps based on user input in previous steps.
- Smart Defaults: Pre-fill values using dynamic tokens like `{clipboard}`, `{date:yyyy-MM-dd}`, and `{appContext}`.
- New Presets: Adds several new templated actions, including Summarize, Translate, Rephrase, Write an Email, and Create Social Media Post.
- Redesigned Action Editor: The Action Editor UI has been completely redesigned with an intuitive interface for creating and managing placeholders and their advanced properties.

### Generation Mode & Custom Instructions
Actions can now be designated as not requiring selected text (`requiresSelection: false`). This enables a new "Generation Mode" for creating content from scratch.

- When no text is selected, the floating menu filters for generation-capable actions, and the search bar becomes a prompt input field.
- The "Custom Instruction" feature now logs the full instruction to the history and allows these ad-hoc prompts to be saved as new, reusable actions directly from the history view.

### UI and UX Enhancements
- Bulk Action Management: The Actions screen now supports multi-selection with checkboxes. A contextual toolbar appears for bulk operations like Delete, Move to Group, and Export.
- Action Management: Actions can now be easily duplicated or moved up/down within their group from a new context menu.
- Onboarding: A new tutorial step introduces users to the power of templated actions, and the hotkey tutorial is updated to better reflect the Diff View output mode.

### Core Refinements
- Startup Refactoring: The application's main startup logic in `App.axaml.cs` has been decomposed into modular, single-responsibility services (`DatabaseInitializer`, `BackgroundServiceInitializer`, `UiInitializer`, `DependencyInjectionSetup`, etc.) for improved maintainability and more resilient handling of database corruption.
- Document Reader Service: A new `IDocumentReaderService` is introduced that can extract text from various file types (.pdf, .docx, .epub, .xlsx, etc.), enabling the new "File Picker" placeholder type.

Author: LSXPrime

Changelogs/v0.3.0.md

@@ -0,0 +1,94 @@
+# 🎉 ProseFlow v0.3.0 – Release Notes
+
+We are excited to launch **ProseFlow v0.3.0**, a landmark release that transforms how you create and use AI-powered actions. This update introduces **Templated Actions with Placeholders**, a powerful new **Generation Mode** for creating content from scratch, and a completely overhauled **Actions UI** with bulk-management capabilities.
+
+These features turn simple prompts into dynamic, reusable, and shareable tools, elevating ProseFlow from a text processor to a comprehensive AI workflow engine.
+
+---
+
+## 🌟 Highlights
+
+### 1. **Templated Actions with Placeholders**
+Actions are no longer static prompts! You can now create dynamic, multi-step workflows by embedding placeholders (e.g., `[language]`) in your instructions. When you run a templated action, the floating menu guides you through a step-by-step form to fill in the details.
+
+- **Multiple Input Types:** Choose from Text, Multiline Text, Choice (dropdown), Boolean (Yes/No), Number, Date, and even a **File Picker**.
+- **Validation Rules:** Enforce required fields, set character limits, or define numeric ranges to ensure valid input.
+- **Conditional Logic:** Create intelligent workflows by showing or hiding subsequent steps based on user input.
+- **Smart Defaults:** Pre-fill values with dynamic tokens like `{clipboard}`, `{date:yyyy-MM-dd}`, and `{appContext}` to accelerate common tasks.
+- **New Presets:** Get started with powerful new templated actions, including **Summarize**, **Translate**, **Rephrase**, **Write an Email**, and **Create Social Media Post**.
+
+> 💡 This feature transforms simple actions into sophisticated, reusable applications for complex tasks.
+
+<table>
+  <tr>
+    <td align="center"><strong>Advanced Action Editor</strong></td>
+    <td align="center"><strong>Templated Action Menu</strong></td>
+  </tr>
+  <tr>
+    <td><img src="https://raw.githubusercontent.com/LSXPrime/_resources/refs/heads/main/ProseFlow/screenshot-action-editor.gif" alt="Advanced Action Editor"></td>
+    <td><img src="https://raw.githubusercontent.com/LSXPrime/_resources/refs/heads/main/ProseFlow/screenshot-template-menu.gif" alt="Templated Action Menu"></td>
+  </tr>
+</table>
+
+---
+
+### 2. **Generation Mode & Enhanced Custom Instructions**
+ProseFlow now excels at creating content from scratch. Actions can be designated as not requiring selected text (`requiresSelection: false`), enabling a new **Generation Mode**.
+
+- **Generate from Scratch:** When no text is selected, the floating menu filters for generation-capable actions. The search bar becomes a prompt input field, allowing you to describe what you want to create.
+- **Save Custom Instructions:** The "Custom Instruction" feature now logs the full instruction to your history. You can save these ad-hoc prompts as new, reusable actions directly from the history view with a single click.
+
+---
+
+### 3. **Overhauled Actions UI with Bulk Management**
+The Actions screen has been completely redesigned for power users and teams managing large sets of actions.
+
+- **Multi-Selection:** Use checkboxes to select multiple actions at once.
+- **Contextual Toolbar:** A new toolbar appears when items are selected, enabling bulk operations:
+    - **Bulk Delete:** Permanently remove multiple actions.
+    - **Bulk Move:** Move selected actions to another group in one step.
+    - **Bulk Export:** Export only the selected actions to a JSON file.
+- **Action Management:** Actions can now be easily **duplicated** or **moved up/down** within their group from a new context menu.
+
+---
+
+## 🛠️ Core & Infrastructure Improvements
+
+### 📄 **New Document Reader Service**
+A powerful new `IDocumentReaderService` can now extract plain text from various file types, enabling the new "File Picker" placeholder. Supported formats include:
+- `.pdf`
+- `.docx`
+- `.xlsx`, `.xls`
+- `.epub`
+- `.txt`, `.md`, and many other plain-text-like formats.
+
+### 🚀 **Refactored Startup Logic**
+The application's startup process has been decomposed into modular, single-responsibility services (`DatabaseInitializer`, `BackgroundServiceInitializer`, `UiInitializer`, `DependencyInjectionSetup`, etc.).
+
+- **Improved Maintainability:** Cleaner, more organized code makes future development easier.
+- **Resilient Database Handling:** A new recovery flow gracefully handles database corruption by prompting the user to back up the corrupt file and reset the application data, preventing startup failures.
+
+---
+
+## 🎨 UI & UX Refinements
+
+### ✍️ **Redesigned Action Editor**
+The Action Editor has been rebuilt from the ground up to support templated actions:
+- An intuitive interface for adding, configuring, and removing placeholders.
+- Dedicated sections for setting up validation rules and conditional display logic.
+- A smart token inserter for easily adding dynamic default values.
+
+### 🎓 **Enhanced Onboarding**
+- A new tutorial step introduces users to the power of templated actions with an interactive simulation.
+- A visual progress indicator now tracks your journey through the setup process.
+- The hotkey tutorial has been updated to better reflect the Diff View output mode.
+
+---
+
+## ❤️ Thank You
+
+This release is a huge step forward for ProseFlow, making it a more versatile and powerful tool for everyone.
+
+If you encounter any issues or have suggestions, please [open an issue on GitHub](https://github.com/LSXPrime/ProseFlow/issues).
+
+— LSXPrime

ProseFlow.Application/DTOs/ActionDto.cs

@@ -24,6 +24,12 @@ public record ActionDto
     [JsonPropertyName("explain_changes")]
     public bool ExplainChanges { get; init; }
 
+    [JsonPropertyName("requires_selection")]
+    public bool RequiresSelection { get; init; } = true;
+
     [JsonPropertyName("application_context")]
     public IEnumerable<string> ApplicationContext { get; init; } = [];
+
+    [JsonPropertyName("placeholders")]
+    public IEnumerable<ActionPlaceholderDto> Placeholders { get; init; } = [];
 }

ProseFlow.Application/DTOs/ActionPlaceholderDto.cs

@@ -0,0 +1,31 @@
+using System.Text.Json.Serialization;
+using ProseFlow.Core.Enums;
+
+namespace ProseFlow.Application.DTOs;
+
+/// <summary>
+/// Data Transfer Object for an ActionPlaceholder, used in import/export.
+/// </summary>
+public record ActionPlaceholderDto
+{
+    [JsonPropertyName("name")]
+    public string Name { get; init; } = string.Empty;
+
+    [JsonPropertyName("label")]
+    public string Label { get; init; } = string.Empty;
+
+    [JsonPropertyName("type")]
+    public PlaceholderInputType InputType { get; init; }
+
+    [JsonPropertyName("options")]
+    public IEnumerable<string> Options { get; init; } = [];
+
+    [JsonPropertyName("default")]
+    public string? DefaultValue { get; init; }
+
+    [JsonPropertyName("validation_json")]
+    public string? ValidationJson { get; init; }
+
+    [JsonPropertyName("display_condition_json")]
+    public string? DisplayConditionJson { get; init; }
+}

ProseFlow.Application/Events/AppEvents.cs

@@ -63,20 +63,23 @@ public static class AppEvents
     /// The UI layer subscribes to this, shows the menu, and returns the user's selection.
     /// The Func returns a task that resolves to the user's choice, or null if cancelled.
     /// </summary>
-    public static event Func<IEnumerable<Action>, string, Task<ActionExecutionRequest?>>? ShowFloatingMenuRequested;
+    public static event Func<IEnumerable<Action>, string, bool, Task<ActionExecutionRequest?>>? ShowFloatingMenuRequested;
 
     /// <summary>
     /// Invokes the ShowFloatingMenuRequested event.
     /// </summary>
-    public static async Task<ActionExecutionRequest?> RequestFloatingMenuAsync(IEnumerable<Action> availableActions, string activeAppContext)
+    /// <param name="availableActions">The list of actions to display.</param>
+    /// <param name="activeAppContext">The context of the active application.</param>
+    /// <param name="isGenerationMode">True if the menu should be in 'generate from scratch' mode.</param>
+    public static async Task<ActionExecutionRequest?> RequestFloatingMenuAsync(IEnumerable<Action> availableActions, string activeAppContext, bool isGenerationMode)
     {
         if (!IsShowFloatingMenuEnabled) return null;
 
         return ShowFloatingMenuRequested is not null
-            ? await ShowFloatingMenuRequested.Invoke(availableActions, activeAppContext)
+            ? await ShowFloatingMenuRequested.Invoke(availableActions, activeAppContext, isGenerationMode)
             : await Task.FromResult<ActionExecutionRequest?>(null);
     }
-
+    
     /// <summary>
     /// Raised when a result needs to be displayed in a window.
     /// The UI subscribes and is responsible for showing the window and then returning a Task

ProseFlow.Application/Interfaces/IDocumentReaderService.cs

@@ -0,0 +1,16 @@
+namespace ProseFlow.Application.Interfaces;
+
+/// <summary>
+/// Defines a contract for a service that can extract text content from various document types.
+/// </summary>
+public interface IDocumentReaderService
+{
+    /// <summary>
+    /// Asynchronously reads the text content from a file at the specified path.
+    /// </summary>
+    /// <param name="filePath">The absolute path to the file.</param>
+    /// <returns>A string containing the extracted text content of the file.</returns>
+    /// <exception cref="System.IO.FileNotFoundException">Thrown if the file does not exist.</exception>
+    /// <exception cref="System.NotSupportedException">Thrown if the file type is not supported.</exception>
+    Task<string> ReadTextAsync(string filePath);
+}