npm - joplin-plugin-minimap - Versions diffs - 1.1.8 → 1.1.10 - Mend

joplin-plugin-minimap 1.1.8 → 1.1.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/LICENSE +21 -21
package/README.md +71 -69
package/package.json +1 -1
package/publish/index.js +182 -145
package/publish/manifest.json +17 -3
package/publish/minimap-view.js +325 -283
package/publish/minimapContentScript.js +22 -22
package/publish/plugin.jpl +0 -0

package/LICENSE CHANGED Viewed

@@ -1,21 +1,21 @@
-MIT License
-Copyright (c) 2026 lim0513
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+Copyright (c) 2026 lim0513
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md CHANGED Viewed

@@ -1,69 +1,71 @@
-# Joplin Minimap
-A hover-to-expand table of contents minimap for the [Joplin](https://joplinapp.org/) note viewer — heading tick marks on the right edge that expand into a clickable outline.
-[中文说明](README-CN.md) | [日本語](README-JA.md)
-## Features
-- **Tick Bar Minimap** — Each heading is shown as a small horizontal bar on the right edge of the note viewer; bar length reflects the heading level (H1 longest)
-- **Hover to Expand** — Move the mouse over the bars and they expand into a full table of contents overlay, indented by level, with long titles ellipsized
-- **Click to Jump** — Click any entry to smooth-scroll to that heading
-- **Reading Position** — The section currently in view is highlighted automatically
-- **Live Rebuild** — Rebuilds itself when you switch notes or edit content (listens to `joplin-noteDidUpdate` with a MutationObserver fallback)
-- **Theme Aware** — Follows light and dark themes automatically (colors derive from `currentColor`)
-- **Unobtrusive** — Hidden for notes with fewer than 2 headings, hidden when printing/exporting, never steals focus or keyboard input
-## Install
-### From the Joplin plugin repository (once published)
-1. In Joplin, go to **Tools → Options → Plugins**
-2. Search for **Joplin Minimap**
-3. Install and restart Joplin
-### From file
-1. Download `plugin.jpl` from the [latest release](https://github.com/lim0513/joplin-minimap/releases/latest)
-2. In Joplin, go to **Tools → Options → Plugins**
-3. Click the gear icon and select **Install from file**
-4. Choose the downloaded `.jpl` file
-5. Restart Joplin
-## Usage
-Open any note with 2 or more headings in the **rendered Markdown viewer** (reading view, or the preview side of the split editor):
-- A column of tick bars appears at the right edge
-- **Hover** over it to expand the full table of contents
-- **Click** an entry to jump to that heading
-Note: the minimap only appears in the rendered viewer, not in the plain Markdown editor or the Rich Text editor.
-## How It Works
-A markdown-it content script injects two assets into the rendered viewer: `minimap-view.js` builds the minimap dynamically from the rendered `h1`–`h6` elements after each render, and `minimap.css` handles the collapsed/expanded styling. The Markdown rendering itself is untouched.
-## Settings
-Configurable in **Tools → Options → Joplin Minimap**:
-- **Minimum headings** — hide the minimap when the note has fewer headings than this (default 2)
-- **Expanded panel width (px)** — maximum width of the hover-expanded table of contents (default 240)
-- **Distance from right edge (px)** — gap between the minimap and the viewer's right edge (default 6)
-Changed settings apply on the next render (switch notes or edit the note).
-## Development
-Zero dependencies — no `npm install` needed:
-```bash
-npm run dist
-```
-This builds `dist/` (loadable via Joplin's **Development plugins** setting pointed at the project root) and `publish/` including `publish/plugin.jpl`.
-## License
-MIT
+# Joplin Minimap
+A hover-to-expand table of contents minimap for the [Joplin](https://joplinapp.org/) note viewer — heading tick marks on the right edge that expand into a clickable outline.
+[中文说明](README-CN.md) | [日本語](README-JA.md)
+## Features
+- **Tick Bar Minimap** — Each heading is shown as a small horizontal bar on the right edge of the note viewer; bar length reflects the heading level (H1 longest)
+- **Hover to Expand** — Move the mouse over the bars and they expand into a full table of contents overlay, indented by level, with long titles ellipsized
+- **Click to Jump** — Click any entry to smooth-scroll to that heading
+- **Reading Position** — The section currently in view is highlighted automatically
+- **Live Rebuild** — Rebuilds itself when you switch notes or edit content (listens to `joplin-noteDidUpdate` with a MutationObserver fallback)
+- **RTL Aware** — Headings in right-to-left scripts (Persian, Arabic, Hebrew) are right-aligned in the expanded panel and indent inward from the right; direction is detected per heading, so mixed notes stay readable
+- **Theme Aware** — Follows light and dark themes automatically (colors derive from `currentColor`)
+- **Unobtrusive** — Hidden for notes with fewer than 2 headings, hidden when printing/exporting, never steals focus or keyboard input
+## Install
+### From the Joplin plugin repository (once published)
+1. In Joplin, go to **Tools → Options → Plugins**
+2. Search for **Joplin Minimap**
+3. Install and restart Joplin
+### From file
+1. Download `plugin.jpl` from the [latest release](https://github.com/lim0513/joplin-minimap/releases/latest)
+2. In Joplin, go to **Tools → Options → Plugins**
+3. Click the gear icon and select **Install from file**
+4. Choose the downloaded `.jpl` file
+5. Restart Joplin
+## Usage
+Open any note with 2 or more headings in the **rendered Markdown viewer** (reading view, or the preview side of the split editor):
+- A column of tick bars appears at the right edge
+- **Hover** over it to expand the full table of contents
+- **Click** an entry to jump to that heading
+Note: the minimap only appears in the rendered viewer, not in the plain Markdown editor or the Rich Text editor.
+## How It Works
+A markdown-it content script injects two assets into the rendered viewer: `minimap-view.js` builds the minimap dynamically from the rendered `h1`–`h6` elements after each render, and `minimap.css` handles the collapsed/expanded styling. The Markdown rendering itself is untouched.
+## Settings
+Configurable in **Tools → Options → Joplin Minimap**:
+- **Minimum headings** — hide the minimap when the note has fewer headings than this (default 2)
+- **Expanded panel width (px)** — maximum width of the hover-expanded table of contents (default 240)
+- **Minimap side** — which edge of the viewer the minimap docks to, right or left (default right)
+- **Edge distance (px)** — gap between the minimap and the viewer edge it sits on (default 6)
+Changed settings apply on the next render (switch notes or edit the note).
+## Development
+Zero dependencies — no `npm install` needed:
+```bash
+npm run dist
+```
+This builds `dist/` (loadable via Joplin's **Development plugins** setting pointed at the project root) and `publish/` including `publish/plugin.jpl`.
+## License
+MIT

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "joplin-plugin-minimap",
-  "version": "1.1.8",
+  "version": "1.1.10",
   "description": "A hover-to-expand table of contents minimap for the Joplin note viewer",
   "author": "lim0513",
   "homepage": "https://github.com/lim0513/joplin-minimap",

package/publish/index.js CHANGED Viewed

@@ -1,145 +1,182 @@
-/* Joplin Minimap — plugin entry (runs in the plugin host, Node context).
- * Registers the settings UI and a markdown-it content script whose only job
- * is to inject the minimap assets (JS + CSS) into the rendered note viewer.
- * The viewer asset fetches settings via webviewApi.postMessage -> onMessage.
- */
-// SettingItemType numeric values: Int=1, String=2, Bool=3 (no 'api' import in plain JS)
-const TYPE_INT = 1;
-const TYPE_BOOL = 3;
-// Settings-screen strings, resolved from the app locale at registration time
-// (matching Joplin's own restart-on-language-switch behavior).
-const SETTINGS_I18N = {
-	en_US: {
-		minHeadings: 'Minimum headings',
-		minHeadingsDesc: 'Hide the minimap when the note has fewer headings than this. Default: 2.',
-		panelWidth: 'Expanded panel width (px)',
-		panelWidthDesc: 'Maximum width of the hover-expanded table of contents. Default: 240.',
-		rightOffset: 'Distance from right edge (px)',
-		rightOffsetDesc: 'Gap between the minimap and the right edge of the viewer. Default: 6.',
-		showTodos: 'Show to-do markers',
-		showTodosDesc: 'Show a small red dot before a section\'s tick bar when it contains open to-dos. Default: on.',
-	},
-	zh_CN: {
-		minHeadings: '最少标题数',
-		minHeadingsDesc: '笔记标题数少于此值时隐藏小地图。默认 2。',
-		panelWidth: '展开面板宽度（px）',
-		panelWidthDesc: '悬停展开的目录面板最大宽度。默认 240。',
-		rightOffset: '距右边缘距离（px）',
-		rightOffsetDesc: '小地图与阅读器右边缘的间距。默认 6。',
-		showTodos: '显示待办标记',
-		showTodosDesc: '当章节内含未完成待办时，在该章节横线前显示一个小红点提醒。默认开启。',
-	},
-	zh_TW: {
-		minHeadings: '最少標題數',
-		minHeadingsDesc: '筆記標題數少於此值時隱藏小地圖。預設 2。',
-		panelWidth: '展開面板寬度（px）',
-		panelWidthDesc: '懸停展開的目錄面板最大寬度。預設 240。',
-		rightOffset: '距右邊緣距離（px）',
-		rightOffsetDesc: '小地圖與檢視器右邊緣的間距。預設 6。',
-		showTodos: '顯示待辦標記',
-		showTodosDesc: '當章節內含未完成待辦時，在該章節橫線前顯示一個小紅點提醒。預設開啟。',
-	},
-	ru: {
-		minHeadings: 'Минимум заголовков',
-		minHeadingsDesc: 'Скрывать миникарту, если заголовков в заметке меньше. По умолчанию: 2.',
-		panelWidth: 'Ширина развёрнутой панели (px)',
-		panelWidthDesc: 'Максимальная ширина оглавления при наведении. По умолчанию: 240.',
-		rightOffset: 'Отступ от правого края (px)',
-		rightOffsetDesc: 'Зазор между миникартой и правым краем просмотра. По умолчанию: 6.',
-		showTodos: 'Показывать метки задач',
-		showTodosDesc: 'Показывать маленькую красную точку перед линией раздела, если в нём есть открытые задачи. По умолчанию: вкл.',
-	},
-	ja_JP: {
-		minHeadings: '最小見出し数',
-		minHeadingsDesc: 'ノートの見出しがこの数より少ない場合はミニマップを隠します。既定値：2。',
-		panelWidth: '展開パネルの幅（px）',
-		panelWidthDesc: 'ホバーで展開する目次の最大幅。既定値：240。',
-		rightOffset: '右端からの距離（px）',
-		rightOffsetDesc: 'ミニマップとビューアー右端の間隔。既定値：6。',
-		showTodos: 'ToDoマーカーを表示',
-		showTodosDesc: '未完了のToDoを含むセクションの線の前に小さな赤い点を表示します。既定値：オン。',
-	},
-};
-function settingsI18n(locale) {
-	if (SETTINGS_I18N[locale]) return SETTINGS_I18N[locale];
-	const lang = String(locale || '').split('_')[0];
-	if (lang === 'zh') return SETTINGS_I18N.zh_CN;
-	if (lang === 'ru') return SETTINGS_I18N.ru;
-	if (lang === 'ja') return SETTINGS_I18N.ja_JP;
-	return SETTINGS_I18N.en_US;
-}
-joplin.plugins.register({
-	onStart: async function () {
-		const locale = (await joplin.settings.globalValue('locale')) || 'en_US';
-		const t = settingsI18n(locale);
-		await joplin.settings.registerSection('minimap', {
-			label: 'Joplin Minimap',
-			iconName: 'fas fa-list',
-		});
-		try {
-			await joplin.settings.registerSettings({
-			'minimapMinHeadings': {
-				value: 2,
-				minimum: 1,
-				type: TYPE_INT,
-				section: 'minimap',
-				public: true,
-				label: t.minHeadings,
-				description: t.minHeadingsDesc,
-			},
-			'minimapPanelWidth': {
-				value: 240,
-				minimum: 120,
-				type: TYPE_INT,
-				section: 'minimap',
-				public: true,
-				label: t.panelWidth,
-				description: t.panelWidthDesc,
-			},
-			'minimapRightOffset': {
-				value: 6,
-				minimum: 0,
-				type: TYPE_INT,
-				section: 'minimap',
-				public: true,
-				label: t.rightOffset,
-				description: t.rightOffsetDesc,
-			},
-			'minimapShowTodos': {
-				value: true,
-				type: TYPE_BOOL,
-				section: 'minimap',
-				public: true,
-				label: t.showTodos,
-				description: t.showTodosDesc,
-			},
-			});
-		} catch (error) {
-			console.error('Joplin Minimap: registerSettings failed:', error);
-		}
-		await joplin.contentScripts.register(
-			'markdownItPlugin',
-			'joplin-minimap',
-			'./minimapContentScript.js'
-		);
-		await joplin.contentScripts.onMessage('joplin-minimap', async function (message) {
-			if (message === 'getSettings') {
-				return {
-					minHeadings: await joplin.settings.value('minimapMinHeadings'),
-					panelWidth: await joplin.settings.value('minimapPanelWidth'),
-					rightOffset: await joplin.settings.value('minimapRightOffset'),
-					showTodos: await joplin.settings.value('minimapShowTodos'),
-				};
-			}
-			return null;
-		});
-	},
-});
+/* Joplin Minimap — plugin entry (runs in the plugin host, Node context).
+ * Registers the settings UI and a markdown-it content script whose only job
+ * is to inject the minimap assets (JS + CSS) into the rendered note viewer.
+ * The viewer asset fetches settings via webviewApi.postMessage -> onMessage.
+ */
+// SettingItemType numeric values: Int=1, String=2, Bool=3 (no 'api' import in plain JS)
+const TYPE_INT = 1;
+const TYPE_STRING = 2;
+const TYPE_BOOL = 3;
+// Settings-screen strings, resolved from the app locale at registration time
+// (matching Joplin's own restart-on-language-switch behavior).
+const SETTINGS_I18N = {
+	en_US: {
+		minHeadings: 'Minimum headings',
+		minHeadingsDesc: 'Hide the minimap when the note has fewer headings than this. Default: 2.',
+		panelWidth: 'Expanded panel width (px)',
+		panelWidthDesc: 'Maximum width of the hover-expanded table of contents. Default: 240.',
+		edgeOffset: 'Edge distance (px)',
+		edgeOffsetDesc: 'Gap between the minimap and the viewer edge it sits on. Default: 6.',
+		side: 'Minimap side',
+		sideDesc: 'Which edge of the viewer the minimap sits on. Default: right.',
+		sideRight: 'Right',
+		sideLeft: 'Left',
+		showTodos: 'Show to-do markers',
+		showTodosDesc: 'Show a small red dot before a section\'s tick bar when it contains open to-dos. Default: on.',
+	},
+	zh_CN: {
+		minHeadings: '最少标题数',
+		minHeadingsDesc: '笔记标题数少于此值时隐藏小地图。默认 2。',
+		panelWidth: '展开面板宽度（px）',
+		panelWidthDesc: '悬停展开的目录面板最大宽度。默认 240。',
+		edgeOffset: '边缘距离（px）',
+		edgeOffsetDesc: '小地图与阅读器边缘的间距。默认 6。',
+		side: '小地图位置',
+		sideDesc: '小地图停靠在阅读器的哪一侧边缘。默认靠右。',
+		sideRight: '右侧',
+		sideLeft: '左侧',
+		showTodos: '显示待办标记',
+		showTodosDesc: '当章节内含未完成待办时，在该章节横线前显示一个小红点提醒。默认开启。',
+	},
+	zh_TW: {
+		minHeadings: '最少標題數',
+		minHeadingsDesc: '筆記標題數少於此值時隱藏小地圖。預設 2。',
+		panelWidth: '展開面板寬度（px）',
+		panelWidthDesc: '懸停展開的目錄面板最大寬度。預設 240。',
+		edgeOffset: '邊緣距離（px）',
+		edgeOffsetDesc: '小地圖與檢視器邊緣的間距。預設 6。',
+		side: '小地圖位置',
+		sideDesc: '小地圖停靠在檢視器的哪一側邊緣。預設靠右。',
+		sideRight: '右側',
+		sideLeft: '左側',
+		showTodos: '顯示待辦標記',
+		showTodosDesc: '當章節內含未完成待辦時，在該章節橫線前顯示一個小紅點提醒。預設開啟。',
+	},
+	ru: {
+		minHeadings: 'Минимум заголовков',
+		minHeadingsDesc: 'Скрывать миникарту, если заголовков в заметке меньше. По умолчанию: 2.',
+		panelWidth: 'Ширина развёрнутой панели (px)',
+		panelWidthDesc: 'Максимальная ширина оглавления при наведении. По умолчанию: 240.',
+		edgeOffset: 'Отступ от края (px)',
+		edgeOffsetDesc: 'Зазор между миникартой и краем просмотра. По умолчанию: 6.',
+		side: 'Сторона миникарты',
+		sideDesc: 'У какого края области просмотра располагается миникарта. По умолчанию: справа.',
+		sideRight: 'Справа',
+		sideLeft: 'Слева',
+		showTodos: 'Показывать метки задач',
+		showTodosDesc: 'Показывать маленькую красную точку перед линией раздела, если в нём есть открытые задачи. По умолчанию: вкл.',
+	},
+	ja_JP: {
+		minHeadings: '最小見出し数',
+		minHeadingsDesc: 'ノートの見出しがこの数より少ない場合はミニマップを隠します。既定値：2。',
+		panelWidth: '展開パネルの幅（px）',
+		panelWidthDesc: 'ホバーで展開する目次の最大幅。既定値：240。',
+		edgeOffset: '端からの距離（px）',
+		edgeOffsetDesc: 'ミニマップとビューアー端の間隔。既定値：6。',
+		side: 'ミニマップの位置',
+		sideDesc: 'ミニマップをビューアーのどちら側の端に表示するか。既定値：右。',
+		sideRight: '右',
+		sideLeft: '左',
+		showTodos: 'ToDoマーカーを表示',
+		showTodosDesc: '未完了のToDoを含むセクションの線の前に小さな赤い点を表示します。既定値：オン。',
+	},
+};
+function settingsI18n(locale) {
+	if (SETTINGS_I18N[locale]) return SETTINGS_I18N[locale];
+	const lang = String(locale || '').split('_')[0];
+	if (lang === 'zh') return SETTINGS_I18N.zh_CN;
+	if (lang === 'ru') return SETTINGS_I18N.ru;
+	if (lang === 'ja') return SETTINGS_I18N.ja_JP;
+	return SETTINGS_I18N.en_US;
+}
+joplin.plugins.register({
+	onStart: async function () {
+		const locale = (await joplin.settings.globalValue('locale')) || 'en_US';
+		const t = settingsI18n(locale);
+		await joplin.settings.registerSection('minimap', {
+			label: 'Joplin Minimap',
+			iconName: 'fas fa-list',
+		});
+		try {
+			await joplin.settings.registerSettings({
+			'minimapMinHeadings': {
+				value: 2,
+				minimum: 1,
+				type: TYPE_INT,
+				section: 'minimap',
+				public: true,
+				label: t.minHeadings,
+				description: t.minHeadingsDesc,
+			},
+			'minimapPanelWidth': {
+				value: 240,
+				minimum: 120,
+				type: TYPE_INT,
+				section: 'minimap',
+				public: true,
+				label: t.panelWidth,
+				description: t.panelWidthDesc,
+			},
+			// Stored key stays 'minimapRightOffset' even though the label is now
+			// side-neutral: renaming a setting key orphans the saved value.
+			'minimapRightOffset': {
+				value: 6,
+				minimum: 0,
+				type: TYPE_INT,
+				section: 'minimap',
+				public: true,
+				label: t.edgeOffset,
+				description: t.edgeOffsetDesc,
+			},
+			// Enum rather than a bool: 'Left'/'Right' reads unambiguously in the
+			// settings screen, and leaves room for a future 'auto' that follows
+			// the note's own text direction.
+			'minimapSide': {
+				value: 'right',
+				type: TYPE_STRING,
+				isEnum: true,
+				options: { right: t.sideRight, left: t.sideLeft },
+				section: 'minimap',
+				public: true,
+				label: t.side,
+				description: t.sideDesc,
+			},
+			'minimapShowTodos': {
+				value: true,
+				type: TYPE_BOOL,
+				section: 'minimap',
+				public: true,
+				label: t.showTodos,
+				description: t.showTodosDesc,
+			},
+			});
+		} catch (error) {
+			console.error('Joplin Minimap: registerSettings failed:', error);
+		}
+		await joplin.contentScripts.register(
+			'markdownItPlugin',
+			'joplin-minimap',
+			'./minimapContentScript.js'
+		);
+		await joplin.contentScripts.onMessage('joplin-minimap', async function (message) {
+			if (message === 'getSettings') {
+				return {
+					minHeadings: await joplin.settings.value('minimapMinHeadings'),
+					panelWidth: await joplin.settings.value('minimapPanelWidth'),
+					rightOffset: await joplin.settings.value('minimapRightOffset'),
+					side: await joplin.settings.value('minimapSide'),
+					showTodos: await joplin.settings.value('minimapShowTodos'),
+				};
+			}
+			return null;
+		});
+	},
+});

package/publish/manifest.json CHANGED Viewed

@@ -2,12 +2,26 @@
 	"manifest_version": 1,
 	"id": "com.github.joplin-minimap",
 	"app_min_version": "2.8",
-	"version": "1.1.8",
+	"version": "1.1.10",
 	"name": "Joplin Minimap",
 	"description": "A hover-to-expand table of contents minimap for the note viewer. Shows heading tick marks on the right edge; hover to expand into a full ToC, click to jump.",
 	"author": "lim0513",
 	"homepage_url": "https://github.com/lim0513/joplin-minimap",
 	"repository_url": "https://github.com/lim0513/joplin-minimap",
-	"keywords": ["toc", "outline", "minimap", "table-of-contents"],
-	"categories": ["appearance", "viewer"]
+	"keywords": [
+		"toc",
+		"outline",
+		"minimap",
+		"table-of-contents"
+	],
+	"categories": [
+		"appearance",
+		"viewer"
+	],
+	"icons": {
+		"16": "assets/icons/icon16.png",
+		"32": "assets/icons/icon32.png",
+		"48": "assets/icons/icon48.png",
+		"128": "assets/icons/icon128.png"
+	}
 }

package/publish/minimap-view.js CHANGED Viewed

@@ -1,283 +1,325 @@
-/* Joplin Minimap - runs inside the rendered note viewer.
- * Collects h1-h6 from the rendered DOM, draws collapsed tick bars on the
- * right edge, expands into a full ToC on hover, and jumps on click.
- * Rebuilds itself whenever the note content changes (note switch, edit).
- */
-(function () {
-	'use strict';
-	// Defaults; overridden from Joplin's plugin settings (Tools > Options > Minimap)
-	// when webviewApi is available in this webview.
-	var settings = { minHeadings: 2, panelWidth: 240, rightOffset: 6, showTodos: true };
-	function loadSettings() {
-		if (typeof webviewApi === 'undefined' || !webviewApi.postMessage) {
-			return Promise.resolve();
-		}
-		return webviewApi.postMessage('joplin-minimap', 'getSettings').then(function (s) {
-			if (s && typeof s.minHeadings === 'number') settings = s;
-		}).catch(function () { /* keep defaults (e.g. print/export context) */ });
-	}
-	// NEVER run inside an editable context (the Rich Text editor renders
-	// notes through the same pipeline and would execute this asset). If the
-	// nav lands in the RTE document, Joplin's HTML->markdown round-trip
-	// SERIALIZES it into the note body on save - the heading list becomes
-	// real note content and syncs to every device. This was the true root
-	// cause of the "outline below the document" reports.
-	function isEditableContext() {
-		var b = document.body;
-		if (!b) return false;
-		if (b.isContentEditable) return true;
-		if (b.id === 'tinymce') return true;
-		if (b.classList && b.classList.contains('mce-content-body')) return true;
-		return false;
-	}
-	if (isEditableContext()) return;
-	// Only ever install one instance of the watcher per webview session.
-	if (window.__jpMinimapInstalled) return;
-	window.__jpMinimapInstalled = true;
-	var cleanup = null; // removes listeners belonging to the current build
-	// The stylesheet is injected BY THIS SCRIPT and re-checked on every build.
-	// Rationale: Joplin can re-render the document in ways that drop injected
-	// asset stylesheets while this script's watcher survives - the rebuilt nav
-	// then renders UNSTYLED as flow content below the note (looks like a
-	// duplicated outline under the document). Keeping the CSS inline and
-	// re-injecting guarantees the nav and its styling live and die together.
-	var MINIMAP_CSS = "/* Joplin Minimap \u2014 collapsed tick bars, hover-expanded ToC panel.\n * Colors use currentColor / rgba so it follows both light and dark themes.\n */\n\n#jp-minimap {\n\tuser-select: none;\n\t-webkit-user-select: none;\n\tcaret-color: transparent;\n\tcursor: default;\n\tposition: fixed;\n\ttop: 50%;\n\tright: 6px;\n\ttransform: translateY(-50%);\n\tz-index: 9999;\n\tfont-size: 12.5px;\n\tline-height: 1.35;\n\tcolor: inherit;\n}\n\n.jp-mm-list {\n\tdisplay: flex;\n\tflex-direction: column;\n\talign-items: flex-end;\n\tpadding: 8px 6px;\n\tmax-height: 84vh;\n\toverflow: hidden;\n\tborder-radius: 10px;\n\ttransition: background 0.15s ease, box-shadow 0.15s ease;\n}\n\n.jp-mm-item {\n\tdisplay: flex;\n\talign-items: center;\n\tjustify-content: flex-end;\n\tpadding: 3px 4px;\n\tborder-radius: 6px;\n\ttext-decoration: none;\n\tcolor: inherit;\n\topacity: 0.5;\n\tcursor: pointer;\n\toutline: none;\n}\n\n/* ---- collapsed state: tick bars, width by heading level ---- */\n\n.jp-mm-bar {\n\tdisplay: block;\n\theight: 2px;\n\tborder-radius: 1px;\n\tbackground: currentColor;\n}\n\n.jp-mm-l1 .jp-mm-bar { width: 18px; }\n.jp-mm-l2 .jp-mm-bar { width: 13px; }\n.jp-mm-l3 .jp-mm-bar { width: 9px; }\n.jp-mm-l4 .jp-mm-bar { width: 7px; }\n.jp-mm-l5 .jp-mm-bar { width: 5px; }\n.jp-mm-l6 .jp-mm-bar { width: 5px; }\n\n.jp-mm-label { display: none; }\n\n/* ---- expanded state (hover) ---- */\n\n#jp-minimap:hover .jp-mm-list {\n\talign-items: stretch;\n\toverflow-y: auto;\n\toverscroll-behavior: contain;\n\tbackground: rgba(127, 127, 127, 0.16);\n\tbackdrop-filter: blur(10px);\n\t-webkit-backdrop-filter: blur(10px);\n\tbox-shadow: 0 6px 28px rgba(0, 0, 0, 0.28);\n}\n\n#jp-minimap:hover .jp-mm-bar { display: none; }\n\n#jp-minimap:hover .jp-mm-item { justify-content: flex-start; }\n\n#jp-minimap:hover .jp-mm-label {\n\tdisplay: block;\n\tmax-width: var(--jp-mm-width, 240px);\n\twhite-space: nowrap;\n\toverflow: hidden;\n\ttext-overflow: ellipsis;\n}\n\n/* indent by heading level when expanded */\n#jp-minimap:hover .jp-mm-l2 { padding-left: 16px; }\n#jp-minimap:hover .jp-mm-l3 { padding-left: 28px; }\n#jp-minimap:hover .jp-mm-l4 { padding-left: 40px; }\n#jp-minimap:hover .jp-mm-l5 { padding-left: 52px; }\n#jp-minimap:hover .jp-mm-l6 { padding-left: 52px; }\n\n/* ---- shared states ---- */\n\n.jp-mm-item:hover {\n\topacity: 1;\n\tbackground: rgba(127, 127, 127, 0.22);\n}\n\n.jp-mm-active { opacity: 1; }\n\n#jp-minimap:hover .jp-mm-active {\n\tbackground: rgba(127, 127, 127, 0.18);\n}\n\n/* No scrollbar in the expanded panel: the wheel handler owns scrolling,\n * and a visible scrollbar at the panel edge invites overlay-scrollbar\n * style hover/click interference. */\n.jp-mm-list::-webkit-scrollbar { display: none; }\n.jp-mm-list { scrollbar-width: none; }\n\n/* ---- open-to-do section dot: one muted red dot before the tick bar of\n * any section that contains at least one unchecked checkbox ---- */\n.jp-mm-dot {\n\tdisplay: block;\n\twidth: 4px;\n\theight: 4px;\n\tborder-radius: 50%;\n\tbackground: rgba(205, 97, 85, 0.85);\n\tmargin-right: 5px;\n\tflex: none;\n}\n\n/* don't show over printed/exported output */\n@media print {\n\t#jp-minimap { display: none; }\n}\n";
-	function ensureStyle() {
-		if (document.getElementById('jp-minimap-style')) return;
-		var styleEl = document.createElement('style');
-		styleEl.id = 'jp-minimap-style';
-		styleEl.textContent = MINIMAP_CSS;
-		(document.head || document.documentElement).appendChild(styleEl);
-	}
-	// Clicking the minimap gives the webview focus, which can make Joplin
-	// re-render the whole note. That detaches every heading element we hold,
-	// and scrollIntoView on a detached node is a silent no-op. So jumps are
-	// index/text-based against the LIVE DOM, and if a rebuild happens right
-	// after a click (the re-render case), the jump is re-applied afterwards.
-	var pendingJump = null; // { index, text, until }
-	function liveHeadings() {
-		var root = document.getElementById('rendered-md') || document.body;
-		return Array.prototype.slice.call(root.querySelectorAll('h1, h2, h3, h4, h5, h6'));
-	}
-	function jumpTo(index, text) {
-		var hs = liveHeadings();
-		var h = hs[index];
-		if (!h || (text && (h.textContent || '').trim() !== text)) {
-			for (var i = 0; i < hs.length; i++) {
-				if ((hs[i].textContent || '').trim() === text) { h = hs[i]; break; }
-			}
-		}
-		if (h && h.isConnected) h.scrollIntoView({ behavior: 'smooth', block: 'start' });
-	}
-	// Width of the note viewer's right-edge scrollbar zone. Overlay scrollbars
-	// (e.g. Windows 11) reserve no layout space but still intercept clicks with
-	// priority over page content, so when nothing is measurable we keep a safety
-	// gap anyway. The minimap must stay clear of that zone or clicks on the
-	// rightmost part of the panel silently hit the scrollbar instead.
-	function scrollbarGap(root) {
-		var gap = 0;
-		var node = root;
-		while (node && node !== document.documentElement) {
-			if (node.scrollHeight > node.clientHeight + 1) {
-				var w = node.offsetWidth - node.clientWidth;
-				if (w > gap) gap = w;
-			}
-			node = node.parentElement;
-		}
-		return gap > 0 ? gap : 14;
-	}
-	function build() {
-		if (cleanup) { cleanup(); cleanup = null; }
-		if (isEditableContext()) {
-			var stale = document.getElementById('jp-minimap');
-			if (stale) stale.remove();
-			return;
-		}
-		ensureStyle();
-		var old = document.getElementById('jp-minimap');
-		if (old) old.remove();
-		var root = document.getElementById('rendered-md') || document.body;
-		var headings = Array.prototype.slice.call(
-			root.querySelectorAll('h1, h2, h3, h4, h5, h6')
-		);
-		if (headings.length < settings.minHeadings) return;
-		// Which sections contain at least one OPEN checkbox: walk headings and
-		// checkboxes in one document-ordered pass, attributing each unchecked
-		// box to the nearest preceding heading. One dot per section, however
-		// many open to-dos it holds.
-		var sectionHasTodo = {};
-		if (settings.showTodos !== false) {
-			var walk = Array.prototype.slice.call(
-				root.querySelectorAll('h1, h2, h3, h4, h5, h6, input[type="checkbox"]')
-			);
-			var lastHeading = -1;
-			for (var wi = 0; wi < walk.length; wi++) {
-				var wn = walk[wi];
-				if (/^H[1-6]$/.test(wn.tagName)) lastHeading++;
-				else if (!wn.checked && lastHeading >= 0) sectionHasTodo[lastHeading] = true;
-			}
-		}
-		var nav = document.createElement('nav');
-		nav.id = 'jp-minimap';
-		// Applied in BOTH collapsed and expanded states: shifting only on hover
-		// would move the panel out from under the cursor and cause a
-		// hover/unhover flicker loop.
-		nav.style.right = (settings.rightOffset + scrollbarGap(root)) + 'px';
-		nav.style.setProperty('--jp-mm-width', settings.panelWidth + 'px');
-		// The viewer DOM can be editable in some contexts; make sure the
-		// minimap never shows a caret or accepts keyboard input.
-		// NOTE: no preventDefault on mousedown! Blocking the default mouse-focus
-		// path makes Joplin's later programmatic focus count as keyboard-like,
-		// and the browser then draws a :focus-visible ring on the scroll
-		// container. Natural mouse focus never shows a ring.
-		nav.setAttribute('contenteditable', 'false');
-		// Own the wheel entirely while the cursor is over the minimap:
-		// scroll the ToC list ourselves and never let the event chain
-		// through to the note underneath (scroll chaining feels erratic).
-		nav.addEventListener('wheel', function (e) {
-			e.preventDefault();
-			list.scrollTop += e.deltaY;
-		}, { passive: false });
-		var list = document.createElement('div');
-		list.className = 'jp-mm-list';
-		var items = headings.map(function (h, index) {
-			var level = Number(h.tagName.charAt(1));
-			// NOT an <a>: Joplin's viewer shows a "Ctrl+click to open" tooltip
-			// on anchors and treats them as external links.
-			var item = document.createElement('div');
-			item.className = 'jp-mm-item jp-mm-l' + level;
-			var bar = document.createElement('span');
-			bar.className = 'jp-mm-bar';
-			var label = document.createElement('span');
-			label.className = 'jp-mm-label';
-			label.textContent = (h.textContent || '').trim();
-			// Muted red reminder dot before the bar (and before the label when
-			// expanded - same element, flex order does the work).
-			if (sectionHasTodo[index]) {
-				var dot = document.createElement('span');
-				dot.className = 'jp-mm-dot';
-				item.appendChild(dot);
-			}
-			item.appendChild(bar);
-			item.appendChild(label);
-			// MOUSEDOWN, not click: the press gives the webview focus, Joplin may
-			// re-render the note, and our panel gets rebuilt BETWEEN mousedown and
-			// mouseup - so the click event (which needs the same target for both)
-			// never fires. mousedown runs before any of that can happen.
-			item.addEventListener('mousedown', function (e) {
-				if (e.button !== 0) return;
-				var text = (label.textContent || '').trim();
-				// If the press triggers a note re-render, the rebuild will
-				// re-apply this jump against the fresh DOM.
-				pendingJump = { index: index, text: text, until: Date.now() + 1200 };
-				jumpTo(index, text);
-			});
-			list.appendChild(item);
-			return item;
-		});
-		nav.appendChild(list);
-		document.body.appendChild(nav);
-		function updateActive() {
-			var activeIndex = 0;
-			for (var i = 0; i < headings.length; i++) {
-				if (headings[i].getBoundingClientRect().top <= 90) activeIndex = i;
-			}
-			for (var j = 0; j < items.length; j++) {
-				items[j].classList.toggle('jp-mm-active', j === activeIndex);
-			}
-		}
-		document.addEventListener('scroll', updateActive, { passive: true, capture: true });
-		updateActive();
-		// A rebuild arriving right after a click means the note was re-rendered
-		// and the original scrollIntoView hit a detached node - redo the jump.
-		if (pendingJump && Date.now() < pendingJump.until) {
-			jumpTo(pendingJump.index, pendingJump.text);
-			pendingJump = null;
-		}
-		cleanup = function () {
-			document.removeEventListener('scroll', updateActive, { capture: true });
-		};
-	}
-	function settingsAndBuild() {
-		loadSettings().then(build);
-	}
-	var timer = null;
-	function scheduleBuild() {
-		clearTimeout(timer);
-		timer = setTimeout(settingsAndBuild, 150);
-	}
-	// True if a mutation was caused by the minimap itself (avoid rebuild loops).
-	function isOwnMutation(m) {
-		if (m.target && m.target.closest && m.target.closest('#jp-minimap')) return true;
-		var nodes = Array.prototype.slice.call(m.addedNodes)
-			.concat(Array.prototype.slice.call(m.removedNodes));
-		if (!nodes.length) return false;
-		return nodes.every(function (n) {
-			return n.id === 'jp-minimap' || (n.closest && n.closest('#jp-minimap'));
-		});
-	}
-	function watch() {
-		// Joplin fires this after each note render/update.
-		document.addEventListener('joplin-noteDidUpdate', scheduleBuild);
-		// Joplin's asset cleanup can remove our <style> from <head> AFTER the
-		// last body mutation - nothing rebuilds, and the nav sits unstyled in
-		// the page (the "outline below the document" bug, second incarnation:
-		// v1.1.4 only re-checked the style during rebuilds). Watch the head
-		// and re-inject immediately.
-		var headObserver = new MutationObserver(function () {
-			if (!document.getElementById('jp-minimap-style')) ensureStyle();
-		});
-		if (document.head) headObserver.observe(document.head, { childList: true });
-		// Fallback: watch for the rendered content being swapped out
-		// (note switch replaces the DOM without re-running this script).
-		var mo = new MutationObserver(function (mutations) {
-			for (var i = 0; i < mutations.length; i++) {
-				if (!isOwnMutation(mutations[i])) { scheduleBuild(); return; }
-			}
-		});
-		mo.observe(document.body, { childList: true, subtree: true });
-		settingsAndBuild();
-	}
-	if (document.readyState === 'loading') {
-		document.addEventListener('DOMContentLoaded', watch);
-	} else {
-		watch();
-	}
-})();
+/* Joplin Minimap - runs inside the rendered note viewer.
+ * Collects h1-h6 from the rendered DOM, draws collapsed tick bars on the
+ * right edge, expands into a full ToC on hover, and jumps on click.
+ * Rebuilds itself whenever the note content changes (note switch, edit).
+ */
+(function () {
+	'use strict';
+	// Defaults; overridden from Joplin's plugin settings (Tools > Options > Minimap)
+	// when webviewApi is available in this webview.
+	var settings = { minHeadings: 2, panelWidth: 240, rightOffset: 6, side: 'right', showTodos: true };
+	function loadSettings() {
+		if (typeof webviewApi === 'undefined' || !webviewApi.postMessage) {
+			return Promise.resolve();
+		}
+		return webviewApi.postMessage('joplin-minimap', 'getSettings').then(function (s) {
+			if (s && typeof s.minHeadings === 'number') settings = s;
+		}).catch(function () { /* keep defaults (e.g. print/export context) */ });
+	}
+	// NEVER run inside an editable context (the Rich Text editor renders
+	// notes through the same pipeline and would execute this asset). If the
+	// nav lands in the RTE document, Joplin's HTML->markdown round-trip
+	// SERIALIZES it into the note body on save - the heading list becomes
+	// real note content and syncs to every device. This was the true root
+	// cause of the "outline below the document" reports.
+	function isEditableContext() {
+		var b = document.body;
+		if (!b) return false;
+		if (b.isContentEditable) return true;
+		if (b.id === 'tinymce') return true;
+		if (b.classList && b.classList.contains('mce-content-body')) return true;
+		return false;
+	}
+	if (isEditableContext()) return;
+	// Only ever install one instance of the watcher per webview session.
+	if (window.__jpMinimapInstalled) return;
+	window.__jpMinimapInstalled = true;
+	var cleanup = null; // removes listeners belonging to the current build
+	// The stylesheet is injected BY THIS SCRIPT and re-checked on every build.
+	// Rationale: Joplin can re-render the document in ways that drop injected
+	// asset stylesheets while this script's watcher survives - the rebuilt nav
+	// then renders UNSTYLED as flow content below the note (looks like a
+	// duplicated outline under the document). Keeping the CSS inline and
+	// re-injecting guarantees the nav and its styling live and die together.
+	var MINIMAP_CSS = "/* Joplin Minimap \u2014 collapsed tick bars, hover-expanded ToC panel.\n * Colors use currentColor / rgba so it follows both light and dark themes.\n */\n\n#jp-minimap {\n\tuser-select: none;\n\t-webkit-user-select: none;\n\tcaret-color: transparent;\n\tcursor: default;\n\tposition: fixed;\n\ttop: 50%;\n\tright: 6px;\n\ttransform: translateY(-50%);\n\tz-index: 9999;\n\tfont-size: 12.5px;\n\tline-height: 1.35;\n\tcolor: inherit;\n\t/* Collapsed geometry is direction-independent: the tick bars always\n\t * hug the docked edge, whichever side that is, even in an RTL note. Per-item direction applies\n\t * to the expanded panel only (see the dir=rtl rule below). */\n\tdirection: ltr;\n}\n\n.jp-mm-list {\n\tdisplay: flex;\n\tflex-direction: column;\n\talign-items: flex-end;\n\tpadding: 8px 6px;\n\tmax-height: 84vh;\n\toverflow: hidden;\n\tborder-radius: 10px;\n\ttransition: background 0.15s ease, box-shadow 0.15s ease;\n}\n\n.jp-mm-item {\n\tdisplay: flex;\n\talign-items: center;\n\tjustify-content: flex-end;\n\tpadding: 3px 4px;\n\tborder-radius: 6px;\n\ttext-decoration: none;\n\tcolor: inherit;\n\topacity: 0.5;\n\tcursor: pointer;\n\toutline: none;\n\tdirection: ltr;\n}\n\n/* ---- collapsed state: tick bars, width by heading level ---- */\n\n.jp-mm-bar {\n\tdisplay: block;\n\theight: 2px;\n\tborder-radius: 1px;\n\tbackground: currentColor;\n}\n\n.jp-mm-l1 .jp-mm-bar { width: 18px; }\n.jp-mm-l2 .jp-mm-bar { width: 13px; }\n.jp-mm-l3 .jp-mm-bar { width: 9px; }\n.jp-mm-l4 .jp-mm-bar { width: 7px; }\n.jp-mm-l5 .jp-mm-bar { width: 5px; }\n.jp-mm-l6 .jp-mm-bar { width: 5px; }\n\n.jp-mm-label { display: none; }\n\n/* ---- docked on the left edge ---- */\n\n/* Mirror the collapsed alignment so the tick bars hug the left border.\n * direction is pinned to ltr above, so flex-start is unambiguously the left\n * side whatever language the note is in. Placed BEFORE the :hover rules on\n * purpose: they carry the same specificity, so source order decides. */\n#jp-minimap.jp-mm-left .jp-mm-list { align-items: flex-start; }\n#jp-minimap.jp-mm-left .jp-mm-item { justify-content: flex-start; }\n\n/* The to-do dot mirrors too: docked right it hangs left of the tick bar,\n * docked left it must hang RIGHT of it - otherwise a dotted row pushes its\n * bar 9px inward (4px dot + 5px gap) and the flush bar column goes ragged.\n * order= reorders the flex row without touching the DOM, so the expanded\n * panel can put the dot back in front of the label. */\n#jp-minimap.jp-mm-left .jp-mm-dot {\n\torder: 1;\n\tmargin-inline-start: 5px;\n\tmargin-inline-end: 0;\n}\n\n/* ---- expanded state (hover) ---- */\n\n#jp-minimap:hover .jp-mm-list {\n\talign-items: stretch;\n\toverflow-y: auto;\n\toverscroll-behavior: contain;\n\tbackground: rgba(127, 127, 127, 0.16);\n\tbackdrop-filter: blur(10px);\n\t-webkit-backdrop-filter: blur(10px);\n\tbox-shadow: 0 6px 28px rgba(0, 0, 0, 0.28);\n}\n\n#jp-minimap:hover .jp-mm-bar { display: none; }\n\n#jp-minimap:hover .jp-mm-item { justify-content: flex-start; }\n\n#jp-minimap:hover .jp-mm-label {\n\tdisplay: block;\n\tmax-width: var(--jp-mm-width, 240px);\n\twhite-space: nowrap;\n\toverflow: hidden;\n\ttext-overflow: ellipsis;\n\ttext-align: start;\n}\n\n/* RTL headings (Persian/Arabic/Hebrew) read right-to-left in the expanded\n * panel: justify-content, padding-inline-start and text-align:start all flip\n * with the row direction, so the label hugs the right edge and nested levels\n * indent inward from the right. build() sets dir per row (first strong char). */\n#jp-minimap:hover .jp-mm-item[dir=\"rtl\"] { direction: rtl; }\n\n/* indent by heading level when expanded (logical: left in LTR, right in RTL) */\n#jp-minimap:hover .jp-mm-l2 { padding-inline-start: 16px; }\n#jp-minimap:hover .jp-mm-l3 { padding-inline-start: 28px; }\n#jp-minimap:hover .jp-mm-l4 { padding-inline-start: 40px; }\n#jp-minimap:hover .jp-mm-l5 { padding-inline-start: 52px; }\n#jp-minimap:hover .jp-mm-l6 { padding-inline-start: 52px; }\n\n/* Expanded, the dot reads as a marker BEFORE the title on either edge. */\n#jp-minimap.jp-mm-left:hover .jp-mm-dot {\n\torder: 0;\n\tmargin-inline-start: 0;\n\tmargin-inline-end: 5px;\n}\n\n/* ---- shared states ---- */\n\n.jp-mm-item:hover {\n\topacity: 1;\n\tbackground: rgba(127, 127, 127, 0.22);\n}\n\n.jp-mm-active { opacity: 1; }\n\n#jp-minimap:hover .jp-mm-active {\n\tbackground: rgba(127, 127, 127, 0.18);\n}\n\n/* No scrollbar in the expanded panel: the wheel handler owns scrolling,\n * and a visible scrollbar at the panel edge invites overlay-scrollbar\n * style hover/click interference. */\n.jp-mm-list::-webkit-scrollbar { display: none; }\n.jp-mm-list { scrollbar-width: none; }\n\n/* ---- open-to-do section dot: one muted red dot before the tick bar of\n * any section that contains at least one unchecked checkbox ---- */\n.jp-mm-dot {\n\tdisplay: block;\n\twidth: 4px;\n\theight: 4px;\n\tborder-radius: 50%;\n\tbackground: rgba(205, 97, 85, 0.85);\n\tmargin-inline-end: 5px;\n\tflex: none;\n}\n\n/* don't show over printed/exported output */\n@media print {\n\t#jp-minimap { display: none; }\n}\n";
+	function ensureStyle() {
+		if (document.getElementById('jp-minimap-style')) return;
+		var styleEl = document.createElement('style');
+		styleEl.id = 'jp-minimap-style';
+		styleEl.textContent = MINIMAP_CSS;
+		(document.head || document.documentElement).appendChild(styleEl);
+	}
+	// Bidi: the panel hangs off the right edge, so RTL headings (Persian,
+	// Arabic, Hebrew) must read right-to-left inside it - otherwise their text
+	// is forced left and the level indent grows from the wrong side. Resolve
+	// each heading the way dir="auto" does: the FIRST strong character wins.
+	// Ranges are deliberately coarse but disjoint (RTL blocks 0590-08FF plus the
+	// Arabic/Hebrew presentation forms; everything else strong counts as LTR).
+	var RTL_STRONG = /[\u0590-\u08FF\uFB1D-\uFDFF\uFE70-\uFEFF]/;
+	var LTR_STRONG = /[A-Za-z\u00C0-\u058F\u0900-\u1FFF\u2C00-\uD7FF\uF900-\uFAFF]/;
+	function textDirection(text, heading) {
+		var s = String(text || '');
+		for (var i = 0; i < s.length; i++) {
+			var c = s.charAt(i);
+			if (RTL_STRONG.test(c)) return 'rtl';
+			if (LTR_STRONG.test(c)) return 'ltr';
+		}
+		// No strong character at all (digits, punctuation, emoji): inherit the
+		// direction the rendered heading itself got from the note.
+		try {
+			return window.getComputedStyle(heading).direction === 'rtl' ? 'rtl' : 'ltr';
+		} catch (e) {
+			return 'ltr';
+		}
+	}
+	// Clicking the minimap gives the webview focus, which can make Joplin
+	// re-render the whole note. That detaches every heading element we hold,
+	// and scrollIntoView on a detached node is a silent no-op. So jumps are
+	// index/text-based against the LIVE DOM, and if a rebuild happens right
+	// after a click (the re-render case), the jump is re-applied afterwards.
+	var pendingJump = null; // { index, text, until }
+	function liveHeadings() {
+		var root = document.getElementById('rendered-md') || document.body;
+		return Array.prototype.slice.call(root.querySelectorAll('h1, h2, h3, h4, h5, h6'));
+	}
+	function jumpTo(index, text) {
+		var hs = liveHeadings();
+		var h = hs[index];
+		if (!h || (text && (h.textContent || '').trim() !== text)) {
+			for (var i = 0; i < hs.length; i++) {
+				if ((hs[i].textContent || '').trim() === text) { h = hs[i]; break; }
+			}
+		}
+		if (h && h.isConnected) h.scrollIntoView({ behavior: 'smooth', block: 'start' });
+	}
+	// Width of the note viewer's right-edge scrollbar zone. Overlay scrollbars
+	// (e.g. Windows 11) reserve no layout space but still intercept clicks with
+	// priority over page content, so when nothing is measurable we keep a safety
+	// gap anyway. The minimap must stay clear of that zone or clicks on the
+	// rightmost part of the panel silently hit the scrollbar instead.
+	function scrollbarGap(root) {
+		var gap = 0;
+		var node = root;
+		while (node && node !== document.documentElement) {
+			if (node.scrollHeight > node.clientHeight + 1) {
+				var w = node.offsetWidth - node.clientWidth;
+				if (w > gap) gap = w;
+			}
+			node = node.parentElement;
+		}
+		return gap > 0 ? gap : 14;
+	}
+	function build() {
+		if (cleanup) { cleanup(); cleanup = null; }
+		if (isEditableContext()) {
+			var stale = document.getElementById('jp-minimap');
+			if (stale) stale.remove();
+			return;
+		}
+		ensureStyle();
+		var old = document.getElementById('jp-minimap');
+		if (old) old.remove();
+		var root = document.getElementById('rendered-md') || document.body;
+		var headings = Array.prototype.slice.call(
+			root.querySelectorAll('h1, h2, h3, h4, h5, h6')
+		);
+		if (headings.length < settings.minHeadings) return;
+		// Which sections contain at least one OPEN checkbox: walk headings and
+		// checkboxes in one document-ordered pass, attributing each unchecked
+		// box to the nearest preceding heading. One dot per section, however
+		// many open to-dos it holds.
+		var sectionHasTodo = {};
+		if (settings.showTodos !== false) {
+			var walk = Array.prototype.slice.call(
+				root.querySelectorAll('h1, h2, h3, h4, h5, h6, input[type="checkbox"]')
+			);
+			var lastHeading = -1;
+			for (var wi = 0; wi < walk.length; wi++) {
+				var wn = walk[wi];
+				if (/^H[1-6]$/.test(wn.tagName)) lastHeading++;
+				else if (!wn.checked && lastHeading >= 0) sectionHasTodo[lastHeading] = true;
+			}
+		}
+		var nav = document.createElement('nav');
+		nav.id = 'jp-minimap';
+		// Applied in BOTH collapsed and expanded states: shifting only on hover
+		// would move the panel out from under the cursor and cause a
+		// hover/unhover flicker loop.
+		// Docking side. ALWAYS clear the opposite offset: a fixed box with both
+		// left and right set stretches between them instead of hugging one edge.
+		// The scrollbar gap is a right-edge concern only - the viewer's scrollbar
+		// never sits on the left, so no gap is added there.
+		if (settings.side === 'left') {
+			nav.className = 'jp-mm-left';
+			nav.style.left = settings.rightOffset + 'px';
+			nav.style.right = 'auto';
+		} else {
+			nav.style.right = (settings.rightOffset + scrollbarGap(root)) + 'px';
+			nav.style.left = 'auto';
+		}
+		nav.style.setProperty('--jp-mm-width', settings.panelWidth + 'px');
+		// The viewer DOM can be editable in some contexts; make sure the
+		// minimap never shows a caret or accepts keyboard input.
+		// NOTE: no preventDefault on mousedown! Blocking the default mouse-focus
+		// path makes Joplin's later programmatic focus count as keyboard-like,
+		// and the browser then draws a :focus-visible ring on the scroll
+		// container. Natural mouse focus never shows a ring.
+		nav.setAttribute('contenteditable', 'false');
+		// Own the wheel entirely while the cursor is over the minimap:
+		// scroll the ToC list ourselves and never let the event chain
+		// through to the note underneath (scroll chaining feels erratic).
+		nav.addEventListener('wheel', function (e) {
+			e.preventDefault();
+			list.scrollTop += e.deltaY;
+		}, { passive: false });
+		var list = document.createElement('div');
+		list.className = 'jp-mm-list';
+		var items = headings.map(function (h, index) {
+			var level = Number(h.tagName.charAt(1));
+			// NOT an <a>: Joplin's viewer shows a "Ctrl+click to open" tooltip
+			// on anchors and treats them as external links.
+			var item = document.createElement('div');
+			item.className = 'jp-mm-item jp-mm-l' + level;
+			var bar = document.createElement('span');
+			bar.className = 'jp-mm-bar';
+			var label = document.createElement('span');
+			label.className = 'jp-mm-label';
+			label.textContent = (h.textContent || '').trim();
+			// Explicit on BOTH directions, not just RTL: dir also turns on bidi
+			// isolation, which keeps an LTR title readable inside an RTL note
+			// (and vice versa). CSS pins the collapsed rows back to ltr so the
+			// tick bars stay flush with the docked edge either way.
+			item.setAttribute('dir', textDirection(label.textContent, h));
+			// Muted red reminder dot before the bar (and before the label when
+			// expanded - same element, flex order does the work).
+			if (sectionHasTodo[index]) {
+				var dot = document.createElement('span');
+				dot.className = 'jp-mm-dot';
+				item.appendChild(dot);
+			}
+			item.appendChild(bar);
+			item.appendChild(label);
+			// MOUSEDOWN, not click: the press gives the webview focus, Joplin may
+			// re-render the note, and our panel gets rebuilt BETWEEN mousedown and
+			// mouseup - so the click event (which needs the same target for both)
+			// never fires. mousedown runs before any of that can happen.
+			item.addEventListener('mousedown', function (e) {
+				if (e.button !== 0) return;
+				var text = (label.textContent || '').trim();
+				// If the press triggers a note re-render, the rebuild will
+				// re-apply this jump against the fresh DOM.
+				pendingJump = { index: index, text: text, until: Date.now() + 1200 };
+				jumpTo(index, text);
+			});
+			list.appendChild(item);
+			return item;
+		});
+		nav.appendChild(list);
+		document.body.appendChild(nav);
+		function updateActive() {
+			var activeIndex = 0;
+			for (var i = 0; i < headings.length; i++) {
+				if (headings[i].getBoundingClientRect().top <= 90) activeIndex = i;
+			}
+			for (var j = 0; j < items.length; j++) {
+				items[j].classList.toggle('jp-mm-active', j === activeIndex);
+			}
+		}
+		document.addEventListener('scroll', updateActive, { passive: true, capture: true });
+		updateActive();
+		// A rebuild arriving right after a click means the note was re-rendered
+		// and the original scrollIntoView hit a detached node - redo the jump.
+		if (pendingJump && Date.now() < pendingJump.until) {
+			jumpTo(pendingJump.index, pendingJump.text);
+			pendingJump = null;
+		}
+		cleanup = function () {
+			document.removeEventListener('scroll', updateActive, { capture: true });
+		};
+	}
+	function settingsAndBuild() {
+		loadSettings().then(build);
+	}
+	var timer = null;
+	function scheduleBuild() {
+		clearTimeout(timer);
+		timer = setTimeout(settingsAndBuild, 150);
+	}
+	// True if a mutation was caused by the minimap itself (avoid rebuild loops).
+	function isOwnMutation(m) {
+		if (m.target && m.target.closest && m.target.closest('#jp-minimap')) return true;
+		var nodes = Array.prototype.slice.call(m.addedNodes)
+			.concat(Array.prototype.slice.call(m.removedNodes));
+		if (!nodes.length) return false;
+		return nodes.every(function (n) {
+			return n.id === 'jp-minimap' || (n.closest && n.closest('#jp-minimap'));
+		});
+	}
+	function watch() {
+		// Joplin fires this after each note render/update.
+		document.addEventListener('joplin-noteDidUpdate', scheduleBuild);
+		// Joplin's asset cleanup can remove our <style> from <head> AFTER the
+		// last body mutation - nothing rebuilds, and the nav sits unstyled in
+		// the page (the "outline below the document" bug, second incarnation:
+		// v1.1.4 only re-checked the style during rebuilds). Watch the head
+		// and re-inject immediately.
+		var headObserver = new MutationObserver(function () {
+			if (!document.getElementById('jp-minimap-style')) ensureStyle();
+		});
+		if (document.head) headObserver.observe(document.head, { childList: true });
+		// Fallback: watch for the rendered content being swapped out
+		// (note switch replaces the DOM without re-running this script).
+		var mo = new MutationObserver(function (mutations) {
+			for (var i = 0; i < mutations.length; i++) {
+				if (!isOwnMutation(mutations[i])) { scheduleBuild(); return; }
+			}
+		});
+		mo.observe(document.body, { childList: true, subtree: true });
+		settingsAndBuild();
+	}
+	if (document.readyState === 'loading') {
+		document.addEventListener('DOMContentLoaded', watch);
+	} else {
+		watch();
+	}
+})();

package/publish/minimapContentScript.js CHANGED Viewed

@@ -1,22 +1,22 @@
-/* Content script: no markdown transformation needed.
- * We only ship two assets into the rendered viewer:
- *   - minimap-view.js  builds the minimap from the rendered DOM
- *   - minimap.css      collapsed tick bars + hover-expanded ToC panel
- */
-module.exports = {
-	default: function (_context) {
-		return {
-			plugin: function (_markdownIt, _options) {
-				// intentionally empty — rendering is untouched
-			},
-			assets: function () {
-				// CSS is injected by minimap-view.js itself (see ensureStyle) so
-				// that a re-render which drops asset stylesheets cannot leave an
-				// unstyled nav in the document flow.
-				return [
-					{ name: 'minimap-view.js' },
-				];
-			},
-		};
-	},
-};
+/* Content script: no markdown transformation needed.
+ * We only ship two assets into the rendered viewer:
+ *   - minimap-view.js  builds the minimap from the rendered DOM
+ *   - minimap.css      collapsed tick bars + hover-expanded ToC panel
+ */
+module.exports = {
+	default: function (_context) {
+		return {
+			plugin: function (_markdownIt, _options) {
+				// intentionally empty — rendering is untouched
+			},
+			assets: function () {
+				// CSS is injected by minimap-view.js itself (see ensureStyle) so
+				// that a re-render which drops asset stylesheets cannot leave an
+				// unstyled nav in the document flow.
+				return [
+					{ name: 'minimap-view.js' },
+				];
+			},
+		};
+	},
+};

package/publish/plugin.jpl CHANGED Viewed

Binary file