From c3acd209bd066ec992852f2c666cef817984b8d9 Mon Sep 17 00:00:00 2001 From: Tiberiu Ichim Date: Sun, 22 Feb 2026 09:44:11 +0200 Subject: [PATCH] Add specification for new default match behavior --- .../2026-02-22/match_default_behavior.md | 21 +++++++++++++++++++ artifacts/index.md | 1 + 2 files changed, 22 insertions(+) create mode 100644 artifacts/2026-02-22/match_default_behavior.md diff --git a/artifacts/2026-02-22/match_default_behavior.md b/artifacts/2026-02-22/match_default_behavior.md new file mode 100644 index 000000000..09b58431b --- /dev/null +++ b/artifacts/2026-02-22/match_default_behavior.md @@ -0,0 +1,21 @@ +# Match Default Behavior Update + +## Problem Description +Previously, selecting a match in the Edit Modal's Match tab would open a detailed review screen allowing the user to cherry-pick which specific metadata fields to update. When users know a match is correct, they usually want to apply everything quickly, which took extra clicks. + +## Implementation Details + +### Updated Components +1. **`BookMatchCard.vue`**: + - The card itself now acts as an immediate trigger to apply the match. + - The `select` event emitted when clicking the card itself represents this "Direct Apply" action. + - Added a new `Review & Edit` button that appears when hovering over the card. This button emits a new `review` event to preserve the old cherry-picking functionality. + +2. **`Match.vue` (Edit Modal Tab)**: + - Contains new mapping logic `applyMatch` triggered by the `@select` event on the card. + - Extracts parsing logic into `parseMatchData` for shared mapping of properties like series, tags, and narrators safely. + - `applyMatch` forcefully sets all `selectedMatchUsage` checkbox fields to `true` and triggers `submitMatchUpdate`. + - `submitMatchUpdate` now takes an optional boolean flag `closeOnSuccess` which resolves to closing the modal (emitting `@close` to the parent `EditModal.vue`) entirely instead of redirecting the user back to the 'details' tab. + +## Future Considerations +- Allow configuring the default apply behavior in the settings, giving users the choice to swap the direct click action to "Review & Edit" if they prefer being cautious. diff --git a/artifacts/index.md b/artifacts/index.md index 80b5d462b..6389d0442 100644 --- a/artifacts/index.md +++ b/artifacts/index.md @@ -24,6 +24,7 @@ This index provides a quick reference for specification and documentation files | **2026-02-20** | [promote_file_to_book.md](2026-02-20/promote_file_to_book.md) | Specification for "promoting" files from an existing book into a standalone library item, including a "Split Book" wizard. | | **2026-02-20** | [move_to_library_keyboard_shortcuts.md](2026-02-20/move_to_library_keyboard_shortcuts.md) | Specification for keyboard-shortcut-enabled library buttons in the "Move to Library" dialog. | | **2026-02-22** | [centralized_keyboard_shortcuts.md](2026-02-22/centralized_keyboard_shortcuts.md) | Specification for centralizing keyboard shortcut definitions into a single configuration file. | +| **2026-02-22** | [match_default_behavior.md](2026-02-22/match_default_behavior.md) | Specification for the new default "Direct Apply" match behavior and Review & Edit button. | | **General** | [docs/consolidate_feature.md](docs/consolidate_feature.md) | Comprehensive documentation for the "Consolidate" feature, including conflict resolution and technical details. | | **General** | [docs/item_restructuring_guide.md](docs/item_restructuring_guide.md) | Guide for Moving, Merging, and Splitting (Promoting) library items. | | **General** | [docs/metadata_management_tools.md](docs/metadata_management_tools.md) | Documentation for Reset Metadata and Batch Reset operations. |