@14ch/svelte-md-outliner 0.0.24 → 0.0.26

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.
@@ -1,53 +1,45 @@
1
1
  <!--
2
- 最前面へ出すコンテナ。`popover="manual"` で重ね、錨の矩形(AnchorRect)に対して置く。
2
+ 最前面へ出すコンテナの土台。`popover="manual"` で重ね、錨の矩形(AnchorRect)に対して置く。
3
3
  錨を要素ではなく矩形で受けるのは、ポインタの座標と要素の箱を同じ型に落とすため。
4
4
 
5
- 開閉は `open` prop で受ける(状態はエディタ 1 つにつき 1 つのコントローラが持つ)。
6
- スクロール・リサイズで閉じたいことは `onClose` で外へ伝えるだけで、自分では閉じない。
5
+ 持つのは、最前面への出し入れ・見た目・外の動きの通知だけである。**焦点・キー・
6
+ 置き場所は使う側が持つ。** メニューは開くと焦点を移して錨の右上に出るが、リンクの
7
+ 吹き出しは焦点を奪わずにリンクの上へ出る。それぞれの振る舞いは使う側の部品に書く
8
+ (→ `MenuPopup`・`LinkBubble`)。
9
+
10
+ 開閉は `open` prop で受ける。外の動き(スクロール・リサイズ)は `onViewportChange` で
11
+ 知らせるだけで、閉じるか付いていくかは使う側が決める。
7
12
  -->
8
13
  <script lang="ts">
9
14
  import type { Snippet } from 'svelte';
15
+ import type { HTMLAttributes } from 'svelte/elements';
10
16
 
11
17
  import type { AnchorRect } from '../../utils/geometry.types';
12
18
 
13
- interface Props {
19
+ interface Props extends HTMLAttributes<HTMLDivElement> {
14
20
  children: Snippet;
15
- /** 錨の矩形。開くたびに読み直す */
21
+ /** 錨の矩形。変わるたびに置き直す */
16
22
  anchor: AnchorRect | null;
17
23
  open: boolean;
18
- /** コンテナの役割。既定は menu */
19
- role?: string;
20
- ariaLabel?: string;
21
- /** いま選んでいる子要素の id。中身の側は実フォーカスもそこへ移す */
22
- ariaActivedescendant?: string;
23
- class?: string;
24
- /**
25
- * 中で押されたキー。`Tab` の循環より**先**に呼ぶ。
26
- * 既定動作を止めた(受け止めた)ときは、循環の判定へ進まない
27
- */
28
- onKeyDown?: (event: KeyboardEvent) => void;
29
- /** 操作対象がポップアップの外へ移ったときの通知。中での移動では呼ばない */
30
- onFocusOut?: () => void;
31
- /** 外の動き(スクロール・リサイズ)で閉じたいときの通知。自分では閉じない */
32
- onClose?: () => void;
24
+ /** 錨に対して置く。寸法を測れるよう、最前面へ出した後に呼ぶ */
25
+ place: (element: HTMLDivElement, anchor: AnchorRect) => void;
26
+ /** 出した直後の通知。焦点を移すかどうかは使う側が決める */
27
+ onOpen?: (element: HTMLDivElement) => void;
28
+ /** 外の動き(スクロール・リサイズ)の通知。中身のスクロールでは呼ばない */
29
+ onViewportChange?: () => void;
33
30
  }
34
31
 
35
32
  let {
36
33
  children,
37
34
  anchor,
38
35
  open,
39
- role = 'menu',
40
- ariaLabel,
41
- ariaActivedescendant,
36
+ place,
37
+ onOpen,
38
+ onViewportChange,
42
39
  class: className = '',
43
- onKeyDown,
44
- onFocusOut,
45
- onClose
40
+ ...attributes
46
41
  }: Props = $props();
47
42
 
48
- /** 錨と表示領域の端から空ける距離 */
49
- const MARGIN = 8;
50
-
51
43
  let popupRef: HTMLDivElement | undefined = $state();
52
44
 
53
45
  $effect(() => {
@@ -55,113 +47,37 @@
55
47
  if (!element) return;
56
48
 
57
49
  if (!open || !anchor) {
58
- hide(element);
50
+ if (element.matches(':popover-open')) element.hidePopover();
59
51
  return;
60
52
  }
61
53
 
62
- show(element, anchor);
63
- // 開いているあいだだけ、外の動きを見る
64
- window.addEventListener('resize', requestClose);
54
+ const opening = !element.matches(':popover-open');
55
+ if (opening) element.showPopover();
56
+ place(element, anchor);
57
+ if (opening) onOpen?.(element);
58
+ });
59
+
60
+ // 出しているあいだだけ、外の動きを見る
61
+ $effect(() => {
62
+ if (!open || !anchor) return;
63
+
64
+ window.addEventListener('resize', notifyViewportChange);
65
65
  document.addEventListener('scroll', handleScroll, true);
66
66
  return () => {
67
- window.removeEventListener('resize', requestClose);
67
+ window.removeEventListener('resize', notifyViewportChange);
68
68
  document.removeEventListener('scroll', handleScroll, true);
69
69
  };
70
70
  });
71
71
 
72
- function show(element: HTMLDivElement, rect: AnchorRect): void {
73
- if (!element.matches(':popover-open')) {
74
- element.showPopover();
75
- // 操作対象を中へ移す。開いた直後は何も選んでいないので、行き先はコンテナになる
76
- element.focus();
77
- }
78
- // 前回の寄せの跡を消してから測る(残すと 2 回目以降が前回の高さに縛られる)
79
- element.style.maxHeight = '';
80
- element.style.overflowY = '';
81
- place(element, rect);
82
- }
83
-
84
- function hide(element: HTMLDivElement): void {
85
- if (element.matches(':popover-open')) element.hidePopover();
86
- }
87
-
88
- /**
89
- * 錨の**右上**に置き、表示領域からはみ出すときは中へ寄せる。
90
- * 高さが収まらないときは、押し込めるだけ押し込んで中をスクロールさせる。
91
- *
92
- * 右へ出すのは、錨そのもの(対象にしている行)を覆わないためである。
93
- * 上端をそろえるので、どの行に対して開いたのかが目で追える。
94
- */
95
- function place(element: HTMLDivElement, rect: AnchorRect): void {
96
- const box = element.getBoundingClientRect();
97
- const viewport = { width: window.innerWidth, height: window.innerHeight };
98
-
99
- let top = rect.top;
100
- // 下に入らず、上のほうが広ければ、錨の下端に合わせて上へ返す
101
- const below = viewport.height - top - MARGIN;
102
- const above = rect.bottom - MARGIN * 2;
103
- if (box.height > below && above > below) top = rect.bottom - box.height;
104
-
105
- const left = clamp(rect.right + MARGIN, MARGIN, viewport.width - box.width - MARGIN);
106
- top = clamp(top, MARGIN, viewport.height - box.height - MARGIN);
107
-
108
- const available = viewport.height - top - MARGIN;
109
- if (box.height > available) {
110
- element.style.maxHeight = `${available}px`;
111
- element.style.overflowY = 'auto';
112
- }
113
-
114
- element.style.transform = `translate(${left}px, ${top}px)`;
115
- }
116
-
117
- /** 収まらない値を渡されたら手前の端に付ける(`max < min` でも表示領域の外へ出さない) */
118
- function clamp(value: number, min: number, max: number): number {
119
- return Math.max(min, Math.min(value, max));
72
+ function notifyViewportChange(): void {
73
+ onViewportChange?.();
120
74
  }
121
75
 
122
- function requestClose(): void {
123
- onClose?.();
124
- }
125
-
126
- /** 中身のスクロールは閉じるきっかけにしない */
76
+ /** 中身のスクロールは外の動きにしない */
127
77
  function handleScroll(event: Event): void {
128
78
  const target = event.target;
129
79
  if (target instanceof Node && popupRef?.contains(target)) return;
130
- requestClose();
131
- }
132
-
133
- /** 移り先がポップアップの中なら、外へ出たことにはしない */
134
- function handleFocusOut(event: FocusEvent): void {
135
- const next = event.relatedTarget;
136
- if (next instanceof Node && popupRef?.contains(next)) return;
137
- onFocusOut?.();
138
- }
139
-
140
- /** 中で押されたキー。使う側へ先に渡し、残りは Tab の循環だけを見る */
141
- function handleKeydown(event: KeyboardEvent): void {
142
- onKeyDown?.(event);
143
- if (event.defaultPrevented) return;
144
- cycleTab(event);
145
- }
146
-
147
- /** Tab を中で循環させる */
148
- function cycleTab(event: KeyboardEvent): void {
149
- if (event.key !== 'Tab' || !popupRef) return;
150
-
151
- const focusable = popupRef.querySelectorAll<HTMLElement>(
152
- 'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])'
153
- );
154
- if (focusable.length === 0) return;
155
-
156
- const first = focusable[0];
157
- const last = focusable[focusable.length - 1];
158
- if (event.shiftKey && document.activeElement === first) {
159
- event.preventDefault();
160
- last.focus();
161
- } else if (!event.shiftKey && document.activeElement === last) {
162
- event.preventDefault();
163
- first.focus();
164
- }
80
+ notifyViewportChange();
165
81
  }
166
82
  </script>
167
83
 
@@ -169,12 +85,7 @@
169
85
  bind:this={popupRef}
170
86
  popover="manual"
171
87
  class="markdown-editor-popup {className}"
172
- {role}
173
- tabindex="-1"
174
- aria-label={ariaLabel}
175
- aria-activedescendant={ariaActivedescendant}
176
- onkeydown={handleKeydown}
177
- onfocusout={handleFocusOut}
88
+ {...attributes}
178
89
  >
179
90
  {@render children()}
180
91
  </div>
@@ -201,8 +112,7 @@
201
112
  overflow: hidden;
202
113
  /*
203
114
  * 巻き取りを中で止める。端まで来た続きが背後のページへ流れると、
204
- * ページが動いたぶんを**外側のスクロール**として受け取り(→ handleScroll)、
205
- * 中を読んでいるだけなのに閉じてしまう。
115
+ * ページが動いたぶんを**外側のスクロール**として受け取ってしまう(→ handleScroll)。
206
116
  */
207
117
  overscroll-behavior: contain;
208
118
  }
@@ -1,25 +1,17 @@
1
1
  import type { Snippet } from 'svelte';
2
+ import type { HTMLAttributes } from 'svelte/elements';
2
3
  import type { AnchorRect } from '../../utils/geometry.types';
3
- interface Props {
4
+ interface Props extends HTMLAttributes<HTMLDivElement> {
4
5
  children: Snippet;
5
- /** 錨の矩形。開くたびに読み直す */
6
+ /** 錨の矩形。変わるたびに置き直す */
6
7
  anchor: AnchorRect | null;
7
8
  open: boolean;
8
- /** コンテナの役割。既定は menu */
9
- role?: string;
10
- ariaLabel?: string;
11
- /** いま選んでいる子要素の id。中身の側は実フォーカスもそこへ移す */
12
- ariaActivedescendant?: string;
13
- class?: string;
14
- /**
15
- * 中で押されたキー。`Tab` の循環より**先**に呼ぶ。
16
- * 既定動作を止めた(受け止めた)ときは、循環の判定へ進まない
17
- */
18
- onKeyDown?: (event: KeyboardEvent) => void;
19
- /** 操作対象がポップアップの外へ移ったときの通知。中での移動では呼ばない */
20
- onFocusOut?: () => void;
21
- /** 外の動き(スクロール・リサイズ)で閉じたいときの通知。自分では閉じない */
22
- onClose?: () => void;
9
+ /** 錨に対して置く。寸法を測れるよう、最前面へ出した後に呼ぶ */
10
+ place: (element: HTMLDivElement, anchor: AnchorRect) => void;
11
+ /** 出した直後の通知。焦点を移すかどうかは使う側が決める */
12
+ onOpen?: (element: HTMLDivElement) => void;
13
+ /** 外の動き(スクロール・リサイズ)の通知。中身のスクロールでは呼ばない */
14
+ onViewportChange?: () => void;
23
15
  }
24
16
  declare const Popup: import("svelte").Component<Props, {}, "">;
25
17
  type Popup = ReturnType<typeof Popup>;
package/dist/index.d.ts CHANGED
@@ -13,6 +13,11 @@ export type { EditorMessages, EditorMessagesOverride, EditorLang, EditorShortcut
13
13
  * `File` を受け取り、表示に使う URL を返す。失敗は reject か `null` で表す。
14
14
  */
15
15
  export type { ImageUpload } from './operations/plugins/imagePaste';
16
+ /**
17
+ * リンクが押されたときの通知の型(`MarkdownEditor` の `onLinkClick` に渡す)。
18
+ * `event.preventDefault()` を呼ぶと、新しいタブで開く既定の動きを止める。
19
+ */
20
+ export type { LinkClick } from './operations/plugins/linkClick';
16
21
  export type { ViewState, ViewSectionRef } from './models/viewState/viewState.types';
17
22
  /**
18
23
  * 外から本文を当てる命令(`replaceMarkdown` / `applyRemoteChange`)の戻り値に現れる型。
@@ -11,6 +11,7 @@ export const en = {
11
11
  mermaidLoadError: 'Failed to load the diagram renderer',
12
12
  imageUploading: 'Uploading image…',
13
13
  imageLoadError: 'Failed to load the image',
14
+ linkOpen: 'Open link',
14
15
  frontMatterLabel: 'Front Matter',
15
16
  shortcutCategories: {
16
17
  edit: 'Edit',
@@ -28,6 +28,7 @@ export function resolveMessages(lang = DEFAULT_LANG, overrides) {
28
28
  mermaidLoadError: overrides.mermaidLoadError ?? base.mermaidLoadError,
29
29
  imageUploading: overrides.imageUploading ?? base.imageUploading,
30
30
  imageLoadError: overrides.imageLoadError ?? base.imageLoadError,
31
+ linkOpen: overrides.linkOpen ?? base.linkOpen,
31
32
  frontMatterLabel: overrides.frontMatterLabel ?? base.frontMatterLabel
32
33
  };
33
34
  }
@@ -11,6 +11,7 @@ export const ja = {
11
11
  mermaidLoadError: '図の描画機能を読み込めませんでした',
12
12
  imageUploading: '画像を読み込んでいます…',
13
13
  imageLoadError: '画像を表示できませんでした',
14
+ linkOpen: 'リンク先を開く',
14
15
  frontMatterLabel: 'Front Matter',
15
16
  shortcutCategories: {
16
17
  // グループは利用者の意図で分ける。「ブロックの操作」のような総称は使わない
@@ -36,6 +36,8 @@ export interface EditorMessages {
36
36
  readonly imageUploading: string;
37
37
  /** 画像の読み込みに失敗したことを伝える表示 */
38
38
  readonly imageLoadError: string;
39
+ /** カーソルがリンクにあるときに出す吹き出し(押すとリンク先を開く)のアクセシブルな名前 */
40
+ readonly linkOpen: string;
39
41
  /**
40
42
  * フロントマターにタイトルが無いときに、その場所へ薄く出す名前。
41
43
  * 状態の説明(「未設定です」)ではなく、**そこが何であるか**の表示である
@@ -61,5 +63,6 @@ export interface EditorMessagesOverride {
61
63
  readonly mermaidLoadError?: string;
62
64
  readonly imageUploading?: string;
63
65
  readonly imageLoadError?: string;
66
+ readonly linkOpen?: string;
64
67
  readonly frontMatterLabel?: string;
65
68
  }
@@ -0,0 +1,14 @@
1
+ import { Plugin } from 'prosemirror-state';
2
+ import type { EditorView } from 'prosemirror-view';
3
+ /** カーソルが触れているリンク。`from` はリンクの先頭の位置 */
4
+ export interface LinkAtCursor {
5
+ readonly href: string;
6
+ readonly from: number;
7
+ }
8
+ /**
9
+ * 吹き出しを出すリンクを見張り、変わるたびに知らせる。表示は持たない(→ `LinkBubble`)。
10
+ *
11
+ * 出すのは、編集中に焦点があり、カーソルがリンクに触れているときだけである。
12
+ * 読み取り専用では素のクリックで開くので出さない。変換の最中も出さない。
13
+ */
14
+ export declare function linkBubblePlugin(onChange: (view: EditorView, link: LinkAtCursor | null) => void): Plugin;
@@ -0,0 +1,55 @@
1
+ import { Plugin } from 'prosemirror-state';
2
+ import { outlineSchema } from '../../models/document/schema.js';
3
+ import { isEditorFocused } from './editorFocus.js';
4
+ const LINK = outlineSchema.marks.link;
5
+ /**
6
+ * 吹き出しを出すリンクを見張り、変わるたびに知らせる。表示は持たない(→ `LinkBubble`)。
7
+ *
8
+ * 出すのは、編集中に焦点があり、カーソルがリンクに触れているときだけである。
9
+ * 読み取り専用では素のクリックで開くので出さない。変換の最中も出さない。
10
+ */
11
+ export function linkBubblePlugin(onChange) {
12
+ const notify = (view) => onChange(view, view.editable && !view.composing && isEditorFocused(view.state)
13
+ ? linkAtCursor(view.state)
14
+ : null);
15
+ return new Plugin({
16
+ view: (view) => {
17
+ notify(view);
18
+ return {
19
+ update: notify,
20
+ destroy: () => onChange(view, null)
21
+ };
22
+ }
23
+ });
24
+ }
25
+ /**
26
+ * カーソルが触れているリンクを返す。範囲を選んでいるときは返さない(選ぶのは直すためである)。
27
+ *
28
+ * 両端も含める。リンクの末尾をタップすると、カーソルはリンクの直後に立つ。
29
+ */
30
+ function linkAtCursor(state) {
31
+ const { selection } = state;
32
+ if (!selection.empty)
33
+ return null;
34
+ const $pos = selection.$from;
35
+ const mark = linkOf($pos.nodeAfter?.marks) ?? linkOf($pos.nodeBefore?.marks);
36
+ if (!mark)
37
+ return null;
38
+ // 同じリンクが続く区間の先頭を探す(書式が混ざると文字の節は分かれる)
39
+ const parent = $pos.parent;
40
+ let runStart = $pos.start();
41
+ let at = runStart;
42
+ for (let index = 0; index < parent.childCount; index += 1) {
43
+ const child = parent.child(index);
44
+ const end = at + child.nodeSize;
45
+ if (!mark.isInSet(child.marks))
46
+ runStart = end;
47
+ else if (at <= $pos.pos && $pos.pos <= end)
48
+ return { href: mark.attrs.href, from: runStart };
49
+ at = end;
50
+ }
51
+ return null;
52
+ }
53
+ function linkOf(marks) {
54
+ return marks?.find((mark) => mark.type === LINK);
55
+ }
@@ -0,0 +1,34 @@
1
+ import { Plugin } from 'prosemirror-state';
2
+ /**
3
+ * リンクが押されたことの通知。`href` は書かれたとおりの値(相対のままでも解決しない)。
4
+ * `event.preventDefault()` を呼ぶと、新しいタブで開く既定の動きを止める。
5
+ */
6
+ export type LinkClick = (href: string, event: MouseEvent) => void;
7
+ /** 呼ぶ時点の受け手を返す。渡されていなければ `undefined` */
8
+ export type LinkClickSource = () => LinkClick | undefined;
9
+ /**
10
+ * リンクを押して、リンク先を新しいタブで開く。
11
+ *
12
+ * 編集中は**修飾キー(Mac は ⌘、それ以外は Ctrl)を添えたときだけ**開く。
13
+ * 素のクリックはカーソルを置く操作であり、奪うとリンクの文字を直せなくなる。
14
+ * 修飾キーの無いタッチ端末では、カーソルがリンクにあるあいだ出る吹き出しから開く
15
+ * (→ `linkBubble`)。読み取り専用では素のクリックで開く。
16
+ *
17
+ * 開く前に利用側へ知らせる。相対のリンク(`./other.md`)のように、ブラウザで開いても
18
+ * 意味を持たない行き先は、利用側が引き取って扱う。
19
+ *
20
+ * `handleDOMEvents` で受けるため、読み取り専用でも届く。
21
+ *
22
+ * 修飾キーを押しているあいだは、編集エリアに `data-link-open` を立てる。押せば開くことを
23
+ * ポインタの形で見せるためで、CSS からはキーの状態が読めない。
24
+ */
25
+ export declare function linkClickPlugin(getLinkClick: LinkClickSource): Plugin;
26
+ /**
27
+ * 利用側へ知らせ、止められなければ新しいタブで開く。
28
+ *
29
+ * **開くのは押した出来事を抜けてから。** 出来事の最中に開くと、実行環境は押されている
30
+ * 修飾キーを見て開き方を決め、⌘+クリックでは新しいタブを背後に回す。利用者は元の
31
+ * タブに残されたまま、何が起きたのかが分からない。抜けた後なら修飾キーは見られず、
32
+ * 新しいタブが前に出る(押した直後なので、ポップアップの制限にも掛からない)。
33
+ */
34
+ export declare function openLink(href: string, event: MouseEvent, getLinkClick: LinkClickSource): void;
@@ -0,0 +1,94 @@
1
+ import { Plugin } from 'prosemirror-state';
2
+ import { isMacPlatform } from '../keymap/shortcutKeys.js';
3
+ /**
4
+ * リンクを押して、リンク先を新しいタブで開く。
5
+ *
6
+ * 編集中は**修飾キー(Mac は ⌘、それ以外は Ctrl)を添えたときだけ**開く。
7
+ * 素のクリックはカーソルを置く操作であり、奪うとリンクの文字を直せなくなる。
8
+ * 修飾キーの無いタッチ端末では、カーソルがリンクにあるあいだ出る吹き出しから開く
9
+ * (→ `linkBubble`)。読み取り専用では素のクリックで開く。
10
+ *
11
+ * 開く前に利用側へ知らせる。相対のリンク(`./other.md`)のように、ブラウザで開いても
12
+ * 意味を持たない行き先は、利用側が引き取って扱う。
13
+ *
14
+ * `handleDOMEvents` で受けるため、読み取り専用でも届く。
15
+ *
16
+ * 修飾キーを押しているあいだは、編集エリアに `data-link-open` を立てる。押せば開くことを
17
+ * ポインタの形で見せるためで、CSS からはキーの状態が読めない。
18
+ */
19
+ export function linkClickPlugin(getLinkClick) {
20
+ return new Plugin({
21
+ view: (view) => trackModifier(view),
22
+ props: {
23
+ handleDOMEvents: {
24
+ click: (view, event) => handleClick(view, event, getLinkClick)
25
+ }
26
+ }
27
+ });
28
+ }
29
+ function handleClick(view, event, getLinkClick) {
30
+ if (event.button !== 0)
31
+ return false;
32
+ const target = event.target;
33
+ if (!(target instanceof Element))
34
+ return false;
35
+ const link = target.closest('a.markdown-editor__link');
36
+ if (!(link instanceof HTMLAnchorElement) || !view.dom.contains(link))
37
+ return false;
38
+ // カーソルを置くだけのクリックでも、ページの遷移は止める。編集中のリンクを実行環境は
39
+ // たどらないが、置いた側のルーター(SvelteKit など)は文書全体でクリックを拾ってたどる。
40
+ // カーソルは押した時点(`mousedown`)で置かれているので、止めても妨げない
41
+ if (view.editable && !isModifierHeld(event)) {
42
+ event.preventDefault();
43
+ return false;
44
+ }
45
+ const href = link.getAttribute('href');
46
+ if (!href)
47
+ return false;
48
+ openLink(href, event, getLinkClick);
49
+ event.preventDefault();
50
+ return true;
51
+ }
52
+ /**
53
+ * 利用側へ知らせ、止められなければ新しいタブで開く。
54
+ *
55
+ * **開くのは押した出来事を抜けてから。** 出来事の最中に開くと、実行環境は押されている
56
+ * 修飾キーを見て開き方を決め、⌘+クリックでは新しいタブを背後に回す。利用者は元の
57
+ * タブに残されたまま、何が起きたのかが分からない。抜けた後なら修飾キーは見られず、
58
+ * 新しいタブが前に出る(押した直後なので、ポップアップの制限にも掛からない)。
59
+ */
60
+ export function openLink(href, event, getLinkClick) {
61
+ getLinkClick()?.(href, event);
62
+ if (event.defaultPrevented)
63
+ return;
64
+ setTimeout(() => window.open(href, '_blank', 'noopener,noreferrer'));
65
+ }
66
+ function isModifierHeld(event) {
67
+ return isMacPlatform() ? event.metaKey : event.ctrlKey;
68
+ }
69
+ /**
70
+ * 修飾キーの状態を編集エリアの属性へ写す。
71
+ *
72
+ * キーは焦点がどこにあっても押されうるため、文書全体で見る。ポインタを動かしたときにも
73
+ * 写し直す(ページの外でキーを押したまま戻ってきた場合に、キーの出来事は届かない)。
74
+ */
75
+ function trackModifier(view) {
76
+ const element = view.dom;
77
+ const ownerDocument = element.ownerDocument;
78
+ const ownerWindow = ownerDocument.defaultView;
79
+ const sync = (event) => element.toggleAttribute('data-link-open', isModifierHeld(event));
80
+ const release = () => element.removeAttribute('data-link-open');
81
+ ownerDocument.addEventListener('keydown', sync);
82
+ ownerDocument.addEventListener('keyup', sync);
83
+ element.addEventListener('mousemove', sync);
84
+ ownerWindow?.addEventListener('blur', release);
85
+ return {
86
+ destroy: () => {
87
+ ownerDocument.removeEventListener('keydown', sync);
88
+ ownerDocument.removeEventListener('keyup', sync);
89
+ element.removeEventListener('mousemove', sync);
90
+ ownerWindow?.removeEventListener('blur', release);
91
+ release();
92
+ }
93
+ };
94
+ }
@@ -12,6 +12,7 @@ import { sectionViewPlugin } from '../operations/plugins/sectionView.js';
12
12
  import { mermaidViewPlugin } from '../operations/plugins/mermaidView.js';
13
13
  import { imagePastePlugin } from '../operations/plugins/imagePaste.js';
14
14
  import { imageViewPlugin } from '../operations/plugins/imageView.js';
15
+ import { linkClickPlugin } from '../operations/plugins/linkClick.js';
15
16
  import { blockHandlePlugin } from '../operations/plugins/blockHandle.js';
16
17
  import { frontMatterGuardPlugin } from '../operations/plugins/frontMatterGuard.js';
17
18
  import { editorFocusPlugin } from '../operations/plugins/editorFocus.js';
@@ -107,6 +108,7 @@ export function createEditorSession(element, options) {
107
108
  })),
108
109
  mermaidViewPlugin(() => presentation.mermaidText ?? defaultMermaidText()),
109
110
  imageViewPlugin(() => imageText()),
111
+ linkClickPlugin(options.linkClick ?? (() => undefined)),
110
112
  ...extensions.flatMap((extension) => extension.plugins)
111
113
  ];
112
114
  const view = new EditorView(element, {
@@ -5,6 +5,7 @@ import type { Result } from '../utils/result.types';
5
5
  import type { EditorAction } from '../operations/operations.types';
6
6
  import type { ImagePasteText, ImageUploadSource } from '../operations/plugins/imagePaste';
7
7
  import type { ImageViewText } from '../operations/plugins/imageView';
8
+ import type { LinkClickSource } from '../operations/plugins/linkClick';
8
9
  import type { MermaidBlockText } from '../operations/plugins/mermaidView';
9
10
  /**
10
11
  * 画像が出す文言。**2 つのプラグイン(貼り付けと表示)が読む先を 1 つにまとめる。**
@@ -52,6 +53,8 @@ export interface EditorSessionOptions extends EditorPresentation {
52
53
  * `view.setProps` が呼ばれて入力が取りこぼされる(→ `setPresentation` の注)。
53
54
  */
54
55
  readonly imageUpload?: ImageUploadSource;
56
+ /** リンクが押されたときの受け手。`imageUpload` と同じ理由で「呼ぶ時点で読む形」で受け取る */
57
+ readonly linkClick?: LinkClickSource;
55
58
  }
56
59
  /**
57
60
  * 適用の種類。利用者の操作として取り消せる置き換えか、他の書き手の変更の同期反映か。
@@ -0,0 +1,27 @@
1
+ import { type LinkClickSource } from '../operations/plugins/linkClick.js';
2
+ import type { AnchorRect } from '../utils/geometry.types';
3
+ import type { EditorExtension, EditorSession } from './editorSession.types';
4
+ export interface LinkBubbleControllerOptions {
5
+ /** 現在のセッション。生き死にの管理はコンポーネントが持つ */
6
+ readonly getSession: () => EditorSession | null;
7
+ /** リンクが押されたときの受け手。呼ぶ時点の値を読む */
8
+ readonly getLinkClick: LinkClickSource;
9
+ }
10
+ export interface LinkBubbleController {
11
+ /** 基盤へ渡す拡張。セッション生成より前に取得する */
12
+ readonly extension: EditorExtension;
13
+ /** 吹き出しを出しているリンクの行き先。出していなければ `null` */
14
+ readonly href: string | null;
15
+ /** リンクの先頭の矩形 */
16
+ readonly anchor: AnchorRect | null;
17
+ /** 吹き出しが押された。利用側へ知らせ、止められなければ新しいタブで開く */
18
+ open(event: MouseEvent): void;
19
+ /** 錨を読み直す。外の動き(スクロール・リサイズ)に付いていく */
20
+ refresh(): void;
21
+ }
22
+ /**
23
+ * カーソルがリンクにあるあいだ出す吹き出しの状態を、エディタ 1 インスタンスに閉じて持つ。
24
+ *
25
+ * **エディタ 1 つにつき 1 つ生成する。** セッションは都度たどるだけで抱え込まない。
26
+ */
27
+ export declare function createLinkBubbleController(options: LinkBubbleControllerOptions): LinkBubbleController;
@@ -0,0 +1,42 @@
1
+ import { linkBubblePlugin } from '../operations/plugins/linkBubble.js';
2
+ import { openLink } from '../operations/plugins/linkClick.js';
3
+ /**
4
+ * カーソルがリンクにあるあいだ出す吹き出しの状態を、エディタ 1 インスタンスに閉じて持つ。
5
+ *
6
+ * **エディタ 1 つにつき 1 つ生成する。** セッションは都度たどるだけで抱え込まない。
7
+ */
8
+ export function createLinkBubbleController(options) {
9
+ let link = $state(null);
10
+ let anchor = $state(null);
11
+ const extension = {
12
+ plugins: [
13
+ linkBubblePlugin((view, next) => {
14
+ link = next;
15
+ anchor = next ? anchorOf(view, next) : null;
16
+ })
17
+ ],
18
+ actions: []
19
+ };
20
+ function anchorOf(view, target) {
21
+ const coords = view.coordsAtPos(target.from);
22
+ return { left: coords.left, right: coords.left, top: coords.top, bottom: coords.bottom };
23
+ }
24
+ return {
25
+ extension,
26
+ get href() {
27
+ return link?.href ?? null;
28
+ },
29
+ get anchor() {
30
+ return anchor;
31
+ },
32
+ open(event) {
33
+ if (link)
34
+ openLink(link.href, event, options.getLinkClick);
35
+ },
36
+ refresh() {
37
+ const view = options.getSession()?.getView();
38
+ if (view && link)
39
+ anchor = anchorOf(view, link);
40
+ }
41
+ };
42
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@14ch/svelte-md-outliner",
3
- "version": "0.0.24",
3
+ "version": "0.0.26",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "description": "An outliner-style Markdown editor for Svelte 5. Headings form a real section tree you can fold, focus, and re-nest from the keyboard.",