Merge pull request #4 from ongaeshi/develop-0.2.0

0.2.0

Author: ongaeshi

.agent/rules/project-rules.md

@@ -0,0 +1,24 @@
+---
+trigger: always_on
+---
+
+# Language Usage
+
+- Task (`task.md`), Implementation Plan (`implementation_plan.md`), and Walkthrough (`walkthrough.md`) must ALWAYS be written in **Japanese**.
+
+# Commit Message Guidelines
+
+1. English is preferred (standard convention).
+2. All commit messages must be written in English.
+3. The first letter immediately following the commit prefix (e.g., `feat: `, `fix: `) must be capitalized.
+
+# Writing Style Guidelines
+
+The style and tone of comments and commit messages should adhere to the following guides:
+- [Google Technical Writing Guidelines](https://developers.google.com/tech-writing)
+- [GitLab Technical Writing Fundamentals](https://docs.gitlab.com/ee/development/documentation/styleguide/word_choice.html)
+
+Key principles include:
+- Be clear, concise, and direct.
+- Use active voice.
+- Avoid unnecessary jargon or overly complex phrasing.

.gitattributes

@@ -0,0 +1,2 @@
+# Enforce LF for test vault files
+tests/vault/** text eol=lf

HISTORY.md

@@ -0,0 +1,15 @@
+# History
+
+## 0.2.0 (2026-03-02)
+- **Insert note**: Insert the selected note into the sequence.
+- **Insert note to first**: Insert the selected note at the beginning of the sequence.
+- **Insert note to last**: Insert the selected note at the end of the sequence.
+- **Detach note**: Detaches a note by setting its `previous` property to `ROOT`.
+
+## 0.1.0 (2025-12-05)
+- **Go to previous note**: Jump to the note specified in the `previous` property of the current note's frontmatter.
+- **Go to next note**: Move to notes that backlink to the current note and have their `previous` property pointing to it.  
+If multiple candidates exist, a suggestion modal will appear for selection.
+- **Go to first note**: Follow the `previous` property chain to reach the first note in the sequence.
+- **Go to last note**: Use backlinks to find the last note in the sequence.  
+If multiple candidates exist, a suggestion modal will appear for selection.

README.ja.md

@@ -1,33 +1,42 @@
-# Previous River
-
-Obsidian のノートに前後関係を設定することができるプラグインです。  
-ユーザーがフロントマターに設定した`previous` プロパティとバックリンクに基づいてノート間を移動できます。
-
-<img width="640" src="https://github.com/user-attachments/assets/db3d5466-affd-43de-aebe-b5d4757e08ac" />
-
-## 機能
-### 前のノートに移動(Go to Previous Note)
-現在のノートのフロントマターにある `previous` プロパティでリンクされたノートに移動します。
-
-### 次のノートに移動(Go to Next Note)
-現在のノートにバックリンクを持ち、かつその `previous` プロパティが現在のノートを指しているノートに移動します。  
-候補が複数ある場合は、選択用のモーダルが表示されます。
-
-### 最初のノートに移動(Go to First Note)
-`previous` プロパティのチェーンをたどり、シーケンス内の最初のノートに移動します。
-
-### 最後のノートに移動(Go to Last Note)
-次のノートをたどり、シーケンス内の最後のノートに移動します。  
-候補が複数ある場合は、選択用のモーダルが表示されます。
-
-## ホットキーの例
-特に「前のノートに移動」と「次のノートに移動」にホットキーを設定しておくことをおすすめします！
-
-- **前のノートに移動**: `Alt+,`
-- **次のノートに移動**: `Alt+.`
-- **最初のノートに移動**: `Alt+Shift+,`
-- **最後のノートに移動**: `Alt+Shift+.`
-
-### コントリビュート
-
+# Previous River
+
+Obsidian のノートに前後関係を設定することができるプラグインです。  
+ユーザーがフロントマターに設定した`previous` プロパティとバックリンクに基づいてノート間を移動できます。
+
+<img width="640" src="https://github.com/user-attachments/assets/db3d5466-affd-43de-aebe-b5d4757e08ac" />
+
+## 機能
+### Go to previous note(前のノートに移動)
+現在のノートのフロントマターにある `previous` プロパティでリンクされたノートに移動します。
+
+### Go to next note(次のノートに移動)
+現在のノートにバックリンクを持ち、かつその `previous` プロパティが現在のノートを指しているノートに移動します。  
+候補が複数ある場合は、選択用のモーダルが表示されます。
+
+### Go to first note(最初のノートに移動)
+`previous` プロパティのチェーンをたどり、シーケンス内の最初のノートに移動します。
+
+### Go to last note(最後のノートに移動)
+次のノートをたどり、シーケンス内の最後のノートに移動します。  
+候補が複数ある場合は、選択用のモーダルが表示されます。
+
+### Insert notes(ノートの挿入)
+ノートを現在の連続したシーケンスに挿入します。
+- **Insert note**: 選択したノートをシーケンスに挿入します。
+- **Insert note to first**: 選択したノートをシーケンスの先頭に挿入します。
+- **Insert note to last**: 選択したノートをシーケンスの最後に挿入します。
+
+### Detach note(ノートの切り離し)
+現在のノートの `previous` プロパティを `ROOT` に設定することで、シーケンスから切り離します。
+
+## ホットキーの例
+特に「前のノートに移動」と「次のノートに移動」にホットキーを設定しておくことをおすすめします！
+
+- **Go to previous note**: `Alt+,`
+- **Go to next note**: `Alt+.`
+- **Go to first note**: `Alt+Shift+,`
+- **Go to last note**: `Alt+Shift+.`
+
+### コントリビュート
+
 バグ報告や機能リクエストは Issues で受け付けています。プルリクエストも歓迎します！

README.md

@@ -1,32 +1,41 @@
-# Previous River
-
-An Obsidian plugin that enables navigation between notes using the `previous` property in frontmatter or backlinks.
-
-<img width="640" src="https://github.com/user-attachments/assets/db3d5466-affd-43de-aebe-b5d4757e08ac" />
-
-## Features
-
-### Go to previous note
-Jump to the note specified in the `previous` property of the current note's frontmatter.
-
-### Go to next note
-Move to notes that backlink to the current note and have their `previous` property pointing to it.  
-If multiple candidates exist, a suggestion modal will allow you to choose.
-
-### Go to first note
-Follow the `previous` property chain to reach the first note in the sequence.
-
-### Go to last note
-Use backlinks to find the last note in the sequence.  
-If there are multiple candidates, a suggestion modal will appear for selection.
-
-## Recommended Hotkeys
-
-- **Go to previous note**: `Alt+,`
-- **Go to next note**: `Alt+.`
-- **Go to first note**: `Alt+Shift+,`
-- **Go to last note**: `Alt+Shift+.`
-
-## Contributing
-
+# Previous River
+
+An Obsidian plugin that enables navigation between notes using the `previous` property in frontmatter or backlinks.
+
+<img width="640" src="https://github.com/user-attachments/assets/db3d5466-affd-43de-aebe-b5d4757e08ac" />
+
+## Features
+
+### Go to previous note
+Jump to the note specified in the `previous` property of the current note's frontmatter.
+
+### Go to next note
+Move to notes that backlink to the current note and have their `previous` property pointing to it.  
+If multiple candidates exist, a suggestion modal will allow you to choose.
+
+### Go to first note
+Follow the `previous` property chain to reach the first note in the sequence.
+
+### Go to last note
+Use backlinks to find the last note in the sequence.  
+If there are multiple candidates, a suggestion modal will appear for selection.
+
+### Insert notes
+Insert notes into the current backlink sequence.
+- **Insert note**: Insert the selected note into the sequence.
+- **Insert note to first**: Insert the selected note at the beginning of the sequence.
+- **Insert note to last**: Insert the selected note at the end of the sequence.
+
+### Detach note
+Detach the current note from the sequence by setting its `previous` property to `ROOT`.
+
+## Recommended Hotkeys
+
+- **Go to previous note**: `Alt+,`
+- **Go to next note**: `Alt+.`
+- **Go to first note**: `Alt+Shift+,`
+- **Go to last note**: `Alt+Shift+.`
+
+## Contributing
+
 Feel free to submit bug reports and feature requests via Issues. Contributions through pull requests are also highly appreciated!

lib/ConfirmModal.ts

@@ -0,0 +1,41 @@
+import { App, Modal, Setting } from "obsidian";
+
+export class ConfirmModal extends Modal {
+    constructor(
+        app: App,
+        private title: string,
+        private message: string,
+        private onConfirm: () => void
+    ) {
+        super(app);
+    }
+
+    onOpen() {
+        const { contentEl } = this;
+        contentEl.createEl("h2", { text: this.title });
+        contentEl.createEl("p", { text: this.message });
+
+        new Setting(contentEl)
+            .addButton((btn) =>
+                btn
+                    .setButtonText("Cancel")
+                    .onClick(() => {
+                        this.close();
+                    })
+            )
+            .addButton((btn) =>
+                btn
+                    .setButtonText("Confirm")
+                    .setCta()
+                    .onClick(() => {
+                        this.close();
+                        this.onConfirm();
+                    })
+            );
+    }
+
+    onClose() {
+        const { contentEl } = this;
+        contentEl.empty();
+    }
+}

lib/NextNoteSuggestModal.ts

@@ -1,20 +1,22 @@
-import { SuggestModal, App, TFile } from "obsidian";
-
-export class NextNoteSuggestModal extends SuggestModal<TFile> {
-  constructor(app: App, private options: TFile[], private onSelect: (file: TFile) => void) {
-    super(app);
-  }
-
-  getSuggestions(query: string): TFile[] {
-    // query に部分一致するものだけ返す（簡易絞り込み）
-    return this.options.filter(file => file.basename.toLowerCase().includes(query.toLowerCase()));
-  }
-
-  renderSuggestion(file: TFile, el: HTMLElement) {
-    el.createEl("div", { text: file.basename });
-  }
-
-  onChooseSuggestion(file: TFile, evt: MouseEvent | KeyboardEvent) {
-    this.onSelect(file);
-  }
-}
+import { FuzzySuggestModal, App, TFile } from "obsidian";
+
+export class NextNoteSuggestModal extends FuzzySuggestModal<TFile> {
+  constructor(app: App, private options: TFile[], private onSelect: (file: TFile) => void, placeholderText?: string) {
+    super(app);
+    if (placeholderText) {
+      this.setPlaceholder(placeholderText);
+    }
+  }
+
+  getItems(): TFile[] {
+    return this.options;
+  }
+
+  getItemText(file: TFile): string {
+    return file.path.endsWith(".md") ? file.path.slice(0, -3) : file.path;
+  }
+
+  onChooseItem(file: TFile, evt: MouseEvent | KeyboardEvent) {
+    this.onSelect(file);
+  }
+}