@ehfuse/taskbox 0.11.1 → 0.11.2
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.
- package/dist/index.esm.js +15 -10
- package/dist/index.esm.js.map +4 -4
- package/dist/index.js +40 -35
- package/dist/index.js.map +4 -4
- package/dist/sections/CommentRichEditor.d.ts +33 -0
- package/dist/sections/commentHtml.d.ts +22 -0
- package/dist/sections/useEditableAssist.d.ts +21 -0
- package/dist/sections/useMentionAutocomplete.d.ts +34 -0
- package/dist/types/provider.d.ts +8 -0
- package/package.json +1 -1
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 서식 댓글 칸 · 서식 댓글 보기(0.11.2, 2026-10-27 업무함 사용자 지시 "데스크톱 댓글 입력도 포커스 들어가면 아사나처럼 에디터").
|
|
3
|
+
*
|
|
4
|
+
* - CommentRichEditor: ehfuse editor 를 댓글 크기로 감싼 칸. 평소엔 한 칸이고 포커스가 들어오면(또는 글이 있으면) 툴바가 펼쳐진다.
|
|
5
|
+
* "@" 언급 · "/" 명령은 useEditableAssist, Ctrl/⌘+Enter 는 보내기. 붙여넣은 · 끌어놓은 파일은 본문에 박지 않고 첨부로 넘긴다.
|
|
6
|
+
* 저장 글은 editorHtmlToComment — 서식을 안 썼으면 평문이다(commentHtml.ts).
|
|
7
|
+
* - RichCommentBody: 서식 댓글을 허용 태그만 남겨 그린다. 링크는 소비처 열기(openExternalUrl), "@이름" 은 파랗게.
|
|
8
|
+
*/
|
|
9
|
+
import { type ReactNode } from "react";
|
|
10
|
+
export interface CommentRichEditorHandle {
|
|
11
|
+
/** 저장할 댓글 글(서식 없으면 평문, 비었으면 ""). */
|
|
12
|
+
getComment: () => string;
|
|
13
|
+
clear: () => void;
|
|
14
|
+
focus: () => void;
|
|
15
|
+
}
|
|
16
|
+
export interface CommentRichEditorProps {
|
|
17
|
+
defaultHtml?: string;
|
|
18
|
+
placeholder?: string;
|
|
19
|
+
/** 툴바를 늘 펼친다(고치기 칸). 아니면 포커스 · 글이 있을 때만. */
|
|
20
|
+
alwaysExpanded?: boolean;
|
|
21
|
+
autoFocus?: boolean;
|
|
22
|
+
minHeight?: number;
|
|
23
|
+
maxHeight?: number;
|
|
24
|
+
onChange?: (comment: string) => void;
|
|
25
|
+
onSubmit?: () => void;
|
|
26
|
+
onFiles?: (files: File[]) => void;
|
|
27
|
+
footer?: ReactNode;
|
|
28
|
+
}
|
|
29
|
+
export declare const CommentRichEditor: import("react").ForwardRefExoticComponent<CommentRichEditorProps & import("react").RefAttributes<CommentRichEditorHandle>>;
|
|
30
|
+
/** 서식 댓글 보기 — 허용 태그만 그리고, 링크는 소비처 열기로, "@이름" 은 파랗게. */
|
|
31
|
+
export declare function RichCommentBody({ html }: {
|
|
32
|
+
html: string;
|
|
33
|
+
}): import("react").JSX.Element;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 서식 댓글(0.11.2, 2026-10-27 업무함 사용자 지시 "댓글 입력에 아사나처럼 에디터") — 댓글 글은 두 가지가 섞여 있다.
|
|
3
|
+
*
|
|
4
|
+
* - 평문: 예전 댓글과, 서식 없이 쓴 새 댓글. 그대로 저장하고 LinkifiedText 로 그린다(줄바꿈은 white-space).
|
|
5
|
+
* - HTML: 굵게 · 목록 · 코드 같은 서식을 쓴 댓글만. `<p>` 같은 블록 태그로 시작한다.
|
|
6
|
+
* 서식 없는 댓글을 평문으로 남기는 까닭: 알림 문구 · 메일 · 다른 화면이 댓글을 평문으로 다루던 그대로 쓰게(바뀌는 범위를 줄인다).
|
|
7
|
+
*/
|
|
8
|
+
/** 서식 댓글(HTML)인가 — 에디터가 내는 블록 태그로 시작한다. 평문 댓글이 우연히 이렇게 시작할 일은 없다. */
|
|
9
|
+
export declare function isRichComment(text: string): boolean;
|
|
10
|
+
/** 서식 댓글 HTML 을 허용한 태그 · 속성만 남겨 정리한다(남이 쓴 글을 그대로 그리지 않는다). */
|
|
11
|
+
export declare function sanitizeCommentHtml(html: string): string;
|
|
12
|
+
/** HTML → 줄바꿈을 살린 평문(복사 · 고치기 칸 · 알림). */
|
|
13
|
+
export declare function commentHtmlToPlain(html: string): string;
|
|
14
|
+
/** 댓글 글을 평문으로(복사용) — 서식 댓글이면 태그를 떼고, 평문이면 그대로. */
|
|
15
|
+
export declare function commentPlainText(text: string): string;
|
|
16
|
+
/**
|
|
17
|
+
* 에디터 HTML → 저장할 댓글 글. 서식(문단 · 줄바꿈 말고)이 하나도 없으면 평문으로 바꿔 저장한다.
|
|
18
|
+
* 빈 내용이면 "".
|
|
19
|
+
*/
|
|
20
|
+
export declare function editorHtmlToComment(html: string): string;
|
|
21
|
+
/** 평문 댓글 → 에디터에 넣을 HTML(고치기에서 평문 댓글을 서식 칸으로 열 때). */
|
|
22
|
+
export declare function plainCommentToHtml(text: string): string;
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 서식 칸(ehfuse editor — contenteditable)용 "@" 언급 · "/" 명령 도우미(0.11.2, 2026-10-27).
|
|
3
|
+
*
|
|
4
|
+
* 글 칸(textarea)용 useMentionAutocomplete 와 같은 후보 · 목록 · 키를 쓴다. 다른 점은 캐럿을 DOM 선택(Selection)으로 읽는 것뿐이다:
|
|
5
|
+
* 캐럿이 든 글 마디(Text)의 앞쪽 글에서 "기호+검색어" 를 찾고, 고르면 그 범위를 고른 글로 바꾼다(execCommand insertText —
|
|
6
|
+
* 에디터의 실행 취소 · onChange 가 그대로 탄다). 목록은 캐럿 자리 위에 뜬다.
|
|
7
|
+
*
|
|
8
|
+
* 쓰는 법 — 에디터를 감싼 상자에 `handlers`(onKeyDownCapture · onKeyUp · onMouseUp · onInput)를 펴 넣고 `popper` 를 옆에 그린다.
|
|
9
|
+
*/
|
|
10
|
+
import { type KeyboardEvent, type ReactNode } from "react";
|
|
11
|
+
export declare function useEditableAssist(): {
|
|
12
|
+
handlers: {
|
|
13
|
+
onKeyDownCapture: (event: KeyboardEvent<HTMLElement>) => void;
|
|
14
|
+
onKeyUp: () => void;
|
|
15
|
+
onMouseUp: () => void;
|
|
16
|
+
onInput: () => void;
|
|
17
|
+
};
|
|
18
|
+
popper: ReactNode;
|
|
19
|
+
/** 목록이 떠 있는가 — 떠 있으면 Ctrl+Enter 보내기 같은 키를 건너뛴다. */
|
|
20
|
+
isOpen: boolean;
|
|
21
|
+
};
|
|
@@ -9,9 +9,43 @@
|
|
|
9
9
|
* 입력칸의 값 · 바꾸기(value · setValue)는 소비처 것을 그대로 쓴다(제어 입력칸).
|
|
10
10
|
*/
|
|
11
11
|
import { type KeyboardEvent, type ReactNode } from "react";
|
|
12
|
+
import { Popper } from "@mui/material";
|
|
12
13
|
import type { TaskboxMentionCandidate, TaskboxSlashCommand } from "../types/provider";
|
|
13
14
|
/** 기본 "/" 명령 — 자주 쓰는 이모지. 이름(한글) · 다른 이름으로 찾는다. */
|
|
14
15
|
export declare const DEFAULT_SLASH_COMMANDS: TaskboxSlashCommand[];
|
|
16
|
+
/** 캐럿 앞 글에서 "기호+검색어" 를 찾는다 — 기호 앞은 줄 처음 · 공백 · 여는 괄호여야 한다(메일 주소 a@b · 경로 a/b 는 아니다). */
|
|
17
|
+
export declare function findQuery(text: string, caret: number, trigger: "@" | "/"): {
|
|
18
|
+
start: number;
|
|
19
|
+
query: string;
|
|
20
|
+
} | null;
|
|
21
|
+
/** 떠 있는 목록의 한 줄. */
|
|
22
|
+
export type AssistItem = {
|
|
23
|
+
id: string;
|
|
24
|
+
text: string;
|
|
25
|
+
icon: ReactNode;
|
|
26
|
+
label: string;
|
|
27
|
+
subtitle?: string;
|
|
28
|
+
};
|
|
29
|
+
/** 사람 후보 · "/" 명령 — 넘긴 값이 없으면 Provider 설정을 쓴다(서식 댓글 칸 useEditableAssist 와 함께 쓴다). */
|
|
30
|
+
export declare function useAssistSources(candidates?: TaskboxMentionCandidate[], slashCommands?: TaskboxSlashCommand[] | boolean): {
|
|
31
|
+
people: TaskboxMentionCandidate[];
|
|
32
|
+
commands: TaskboxSlashCommand[];
|
|
33
|
+
enabled: boolean;
|
|
34
|
+
};
|
|
35
|
+
/** "기호+검색어" 로 목록 줄을 만든다. */
|
|
36
|
+
export declare function buildAssistItems(people: TaskboxMentionCandidate[], commands: TaskboxSlashCommand[], query: {
|
|
37
|
+
query: string;
|
|
38
|
+
trigger: "@" | "/";
|
|
39
|
+
} | null): AssistItem[];
|
|
40
|
+
/** 목록 팝퍼 — 누르는 순간 입력칸 포커스를 뺏지 않는다(캐럿 자리를 잃지 않게). */
|
|
41
|
+
export declare function AssistPopper({ open, anchor, items, active, onPick, onHover, }: {
|
|
42
|
+
open: boolean;
|
|
43
|
+
anchor: Parameters<typeof Popper>[0]["anchorEl"];
|
|
44
|
+
items: AssistItem[];
|
|
45
|
+
active: number;
|
|
46
|
+
onPick: (item: AssistItem) => void;
|
|
47
|
+
onHover: (index: number) => void;
|
|
48
|
+
}): import("react").JSX.Element;
|
|
15
49
|
/** "@" 언급 · "/" 명령 도우미. 이름은 처음 만든 "@" 자동완성 이름을 그대로 둔다(소비처 import 호환). */
|
|
16
50
|
export declare function useMentionAutocomplete({ value, setValue, candidates, slashCommands, }: {
|
|
17
51
|
value: string;
|
package/dist/types/provider.d.ts
CHANGED
|
@@ -89,6 +89,14 @@ export interface TaskboxConfig {
|
|
|
89
89
|
* 앱 웹뷰(Flutter)처럼 새 탭이 없는 환경은 여기서 외부 브라우저 열기 메시지를 보낸다.
|
|
90
90
|
*/
|
|
91
91
|
openExternalUrl?: (url: string) => void;
|
|
92
|
+
/**
|
|
93
|
+
* 본문(읽기 보기) 이미지를 눌렀을 때 여는 방법(0.11.2) — 소비처의 파일 뷰어로 크게 본다.
|
|
94
|
+
* images 는 그 본문의 이미지 전부(차례대로), index 는 누른 이미지. 미지정이면 이미지 주소를 새 탭(openExternalUrl)으로 연다.
|
|
95
|
+
*/
|
|
96
|
+
openContentImage?: (images: Array<{
|
|
97
|
+
src: string;
|
|
98
|
+
name: string;
|
|
99
|
+
}>, index: number) => void;
|
|
92
100
|
/**
|
|
93
101
|
* 업무 공유 텍스트를 기기 공유시트로 넘기는 방법. 미지정이면 `navigator.share`,
|
|
94
102
|
* 그것도 없으면 클립보드 복사로 떨어진다(utils/taskShareText).
|
package/package.json
CHANGED