@ehfuse/taskbox 0.6.3 → 0.7.1

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 (65) hide show
  1. package/dist/atoms/TaskMembersDialog.d.ts +4 -4
  2. package/dist/board/TaskCardContent.d.ts +3 -3
  3. package/dist/chunks/muiIconCatalog-IM2VBIZU.js +2 -0
  4. package/dist/chunks/muiIconCatalog-IM2VBIZU.js.map +7 -0
  5. package/dist/controllers/addLabelController.d.ts +25 -0
  6. package/dist/controllers/addTabController.d.ts +27 -0
  7. package/dist/controllers/calendarLinkController.d.ts +37 -0
  8. package/dist/controllers/employeeSelectController.d.ts +37 -0
  9. package/dist/controllers/googleEventController.d.ts +56 -0
  10. package/dist/controllers/sprintChartsController.d.ts +41 -0
  11. package/dist/controllers/sprintCloseController.d.ts +37 -0
  12. package/dist/controllers/sprintManageController.d.ts +57 -0
  13. package/dist/controllers/taskActivityController.d.ts +25 -0
  14. package/dist/controllers/taskContentTranslateController.d.ts +37 -0
  15. package/dist/controllers/taskCreateController.d.ts +88 -0
  16. package/dist/controllers/taskDetailController.d.ts +49 -0
  17. package/dist/controllers/taskLinkController.d.ts +28 -0
  18. package/dist/controllers/taskMembersController.d.ts +20 -0
  19. package/dist/controllers/taskRuleController.d.ts +76 -0
  20. package/dist/controllers/taskTemplateManageController.d.ts +68 -0
  21. package/dist/controllers/taskTemplateRunController.d.ts +32 -0
  22. package/dist/controllers/taskboxHelpController.d.ts +30 -0
  23. package/dist/controllers/useControlledModal.d.ts +22 -0
  24. package/dist/controllers/usePropSyncedModal.d.ts +36 -0
  25. package/dist/controllers/workloadCapacityController.d.ts +33 -0
  26. package/dist/controllers/workloadPersonTasksController.d.ts +21 -0
  27. package/dist/dialogs/AddLabelDialog.d.ts +4 -1
  28. package/dist/dialogs/AddTabDialog.d.ts +1 -0
  29. package/dist/dialogs/CalendarLinkDialog.d.ts +2 -1
  30. package/dist/dialogs/EmployeeSelectDialog.d.ts +1 -0
  31. package/dist/dialogs/GoogleEventDialog.d.ts +2 -1
  32. package/dist/dialogs/ShortcutHelpDialog.d.ts +1 -0
  33. package/dist/dialogs/SprintChartsDialog.d.ts +1 -0
  34. package/dist/dialogs/SprintCloseDialog.d.ts +3 -8
  35. package/dist/dialogs/SprintManageDialog.d.ts +1 -0
  36. package/dist/dialogs/TaskActivityDialog.d.ts +5 -8
  37. package/dist/dialogs/TaskContentTranslateDialog.d.ts +5 -5
  38. package/dist/dialogs/TaskLinkDialog.d.ts +6 -6
  39. package/dist/dialogs/TaskRuleManageDialog.d.ts +1 -0
  40. package/dist/dialogs/TaskTemplateManageDialog.d.ts +2 -0
  41. package/dist/dialogs/TaskTemplateRunDialog.d.ts +2 -1
  42. package/dist/dialogs/WorkloadCapacityDialog.d.ts +1 -0
  43. package/dist/dialogs/WorkloadPersonTasksDialog.d.ts +1 -0
  44. package/dist/drawers/TaskCreateBody.d.ts +2 -2
  45. package/dist/drawers/TaskCreateDrawer.d.ts +2 -1
  46. package/dist/drawers/TaskDetailBody.d.ts +1 -2
  47. package/dist/drawers/TaskDetailDrawer.d.ts +1 -0
  48. package/dist/index.d.ts +2 -0
  49. package/dist/index.esm.js +15 -15
  50. package/dist/index.esm.js.map +4 -4
  51. package/dist/index.js +43 -43
  52. package/dist/index.js.map +4 -4
  53. package/dist/internal/ConfirmActionPopper.d.ts +24 -9
  54. package/dist/sections/TaskContentEditor.d.ts +5 -3
  55. package/dist/state/useTaskboxForm.d.ts +5 -3
  56. package/package.json +1 -1
  57. package/dist/dialogs/manual/sections/checklist.d.ts +0 -4
  58. package/dist/dialogs/manual/sections/confirm.d.ts +0 -4
  59. package/dist/dialogs/manual/sections/filters.d.ts +0 -4
  60. package/dist/dialogs/manual/sections/projects.d.ts +0 -4
  61. package/dist/dialogs/manual/sections/tasks.d.ts +0 -4
  62. package/dist/dialogs/manual/sections/views.d.ts +0 -4
  63. package/dist/internal/a11y.d.ts +0 -26
  64. package/dist/internal/editorHeightStore.d.ts +0 -11
  65. package/dist/sections/TaskActivitySection.d.ts +0 -15
@@ -0,0 +1,25 @@
1
+ /**
2
+ * 커스텀 라벨 추가 컨트롤러 — 라벨 이름/색 폼과 모달을 소유하고, 검사·확정 콜백 호출을 맡는다.
3
+ * 라벨 사전 갱신(저장)은 여전히 소비처 `onSubmit` 몫이다.
4
+ */
5
+ /** 기본 라벨 색이다. */
6
+ export declare const DEFAULT_LABEL_COLOR = "#2f80ed";
7
+ /** 라벨 추가 폼 값이다. */
8
+ export interface AddLabelForm {
9
+ name: string;
10
+ color: string;
11
+ }
12
+ /** 라벨 추가 컨트롤러 옵션이다(다이얼로그 props 그대로). */
13
+ export interface UseAddLabelControllerOptions {
14
+ open: boolean;
15
+ onClose: () => void;
16
+ onSubmit: (name: string, color: string) => void;
17
+ }
18
+ /** 라벨 추가 폼/모달 컨트롤러 훅이다. */
19
+ export declare function useAddLabelController({ open, onClose, onSubmit }: UseAddLabelControllerOptions): {
20
+ form: import("@ehfuse/forma").UseGlobalFormReturn<AddLabelForm>;
21
+ modals: {
22
+ form: import("./usePropSyncedModal").TaskboxModal;
23
+ };
24
+ };
25
+ export type AddLabelController = ReturnType<typeof useAddLabelController>;
@@ -0,0 +1,27 @@
1
+ /**
2
+ * 프로젝트 이름/아이콘 입력 컨트롤러 — 추가·수정 공용 폼과 모달을 소유하고, 검사·확정 콜백 호출을 맡는다.
3
+ * 서버 저장은 여전히 소비처 `onSubmit` 몫이다.
4
+ */
5
+ /** 프로젝트 입력 폼 값이다. */
6
+ export interface AddTabForm {
7
+ label: string;
8
+ icon: string;
9
+ useSprints: boolean;
10
+ }
11
+ /** 프로젝트 입력 컨트롤러 옵션이다. */
12
+ export interface UseAddTabControllerOptions {
13
+ open: boolean;
14
+ initialLabel?: string;
15
+ initialIcon?: string;
16
+ initialUseSprints?: boolean;
17
+ onClose: () => void;
18
+ onSubmit: (label: string, icon: string, useSprints: boolean) => void;
19
+ }
20
+ /** 프로젝트 입력 폼/모달 컨트롤러 훅이다. */
21
+ export declare function useAddTabController({ open, initialLabel, initialIcon, initialUseSprints, onClose, onSubmit, }: UseAddTabControllerOptions): {
22
+ form: import("@ehfuse/forma").UseGlobalFormReturn<AddTabForm>;
23
+ modals: {
24
+ form: import("./usePropSyncedModal").TaskboxModal;
25
+ };
26
+ };
27
+ export type AddTabController = ReturnType<typeof useAddTabController>;
@@ -0,0 +1,37 @@
1
+ /**
2
+ * 캘린더 연동 다이얼로그 컨트롤러다 — 모달과 구글 연동 동작(연결·해제·토글·재내보내기)을 소유한다.
3
+ * 연동 상태는 서버 값이라 폼이 아니다 — 스위치는 누르는 즉시 소비처 콜백으로 서버에 반영된다.
4
+ * 열림 원본은 소비처 `open` prop 이다(useControlledModal — taskham·codeshop www 가 prop 으로 쓴다).
5
+ */
6
+ import type { CalendarLinkGoogleApiProps } from "../dialogs/CalendarLinkDialog";
7
+ import { type TaskboxModal } from "./usePropSyncedModal";
8
+ /** `useCalendarLinkController` 옵션이다. */
9
+ export interface UseCalendarLinkControllerOptions {
10
+ open: boolean;
11
+ googleApi: CalendarLinkGoogleApiProps;
12
+ onClose: () => void;
13
+ }
14
+ /** 캘린더 연동 다이얼로그 컨트롤러 훅이다. */
15
+ export declare function useCalendarLinkController(options: UseCalendarLinkControllerOptions): {
16
+ modals: {
17
+ link: TaskboxModal;
18
+ };
19
+ status: import("..").TaskBoxGcalLink;
20
+ busy: boolean;
21
+ canResync: boolean;
22
+ calendarName: string;
23
+ actions: {
24
+ /** 구글 계정 연결(동의 화면으로 이동). */
25
+ connect: () => void;
26
+ /** 연결 해제. */
27
+ disconnect: () => void;
28
+ /** 내보내기 토글. */
29
+ toggleExport: (enabled: boolean) => void;
30
+ /** 가져오기 토글. */
31
+ toggleImport: (enabled: boolean) => void;
32
+ /** 전량 재내보내기. */
33
+ resync: () => void | undefined;
34
+ };
35
+ };
36
+ /** 캘린더 연동 컨트롤러 타입이다. */
37
+ export type CalendarLinkController = ReturnType<typeof useCalendarLinkController>;
@@ -0,0 +1,37 @@
1
+ /**
2
+ * 직원선택 다이얼로그 컨트롤러다 — 체크 폼(전역 폼)·모달·확정 흐름을 소유한다.
3
+ * 열림 원본은 소비처 `open` prop 이다(useControlledModal — 공개 다이얼로그라 prop API 를 유지한다).
4
+ */
5
+ import type { TaskboxEmployee, TaskboxEmployeeGroup } from "../types/employee";
6
+ import { type TaskboxModal } from "./usePropSyncedModal";
7
+ /** 직원선택 폼 값이다. */
8
+ export interface EmployeeSelectForm {
9
+ selectedSeqs: number[];
10
+ }
11
+ /** 직원선택 화면 상태다. */
12
+ export interface EmployeeSelectUiState {
13
+ openCount: number;
14
+ }
15
+ /** `useEmployeeSelectController` 옵션이다. */
16
+ export interface UseEmployeeSelectControllerOptions {
17
+ open: boolean;
18
+ groups: TaskboxEmployeeGroup[];
19
+ multiple: boolean;
20
+ selectedSeqs: number[];
21
+ onConfirm: (selected: TaskboxEmployee[]) => void;
22
+ onClose: () => void;
23
+ }
24
+ /** 그룹 트리를 평탄화해 전 직원 목록을 얻는다(선택 seq → 직원 역참조용). */
25
+ export declare function collectEmployees(groups: TaskboxEmployeeGroup[]): TaskboxEmployee[];
26
+ /** 직원선택 다이얼로그 컨트롤러 훅이다. */
27
+ export declare function useEmployeeSelectController(options: UseEmployeeSelectControllerOptions): {
28
+ form: import("@ehfuse/forma").UseGlobalFormReturn<EmployeeSelectForm>;
29
+ modals: {
30
+ select: TaskboxModal;
31
+ };
32
+ ui: import("@ehfuse/forma").UseFormaStateReturn<EmployeeSelectUiState>;
33
+ allEmployees: TaskboxEmployee[];
34
+ changeSelection: (seqs: number[]) => void;
35
+ };
36
+ /** 직원선택 컨트롤러 타입이다. */
37
+ export type EmployeeSelectController = ReturnType<typeof useEmployeeSelectController>;
@@ -0,0 +1,56 @@
1
+ /**
2
+ * 구글 일정 편집 다이얼로그 컨트롤러다 — 일정 폼(전역 폼)·모달·검사·저장/삭제 흐름을 소유한다.
3
+ * 서버 반영(PATCH·DELETE)과 성공 후 닫기는 소비처 콜백이 한다 — 컨트롤러는 검사를 거친 저장값만 넘긴다.
4
+ * 열림 원본은 소비처 `open` prop 이다(useControlledModal — codeshop www 가 prop 으로 쓴다).
5
+ */
6
+ import type { TaskBoxGoogleEvent, TaskBoxGoogleEventPatch } from "../types";
7
+ import { type TaskboxModal } from "./usePropSyncedModal";
8
+ /** 구글 일정 편집 폼 값이다. */
9
+ export interface GoogleEventForm {
10
+ title: string;
11
+ allDay: boolean;
12
+ startDate: string;
13
+ endDate: string;
14
+ startTime: string;
15
+ endTime: string;
16
+ location: string;
17
+ description: string;
18
+ }
19
+ /** `useGoogleEventController` 옵션이다. */
20
+ export interface UseGoogleEventControllerOptions {
21
+ open: boolean;
22
+ event: TaskBoxGoogleEvent | null;
23
+ busy?: boolean;
24
+ onClose: () => void;
25
+ onSave: (patch: TaskBoxGoogleEventPatch) => void;
26
+ onDelete?: () => void;
27
+ }
28
+ /** "HH:mm" 에 분을 더한다(하루 안에서 순환). */
29
+ export declare function addMinutes(time: string, minutes: number): string;
30
+ /** 구글 일정 편집 다이얼로그 컨트롤러 훅이다. */
31
+ export declare function useGoogleEventController(options: UseGoogleEventControllerOptions): {
32
+ form: import("@ehfuse/forma").UseGlobalFormReturn<GoogleEventForm>;
33
+ modals: {
34
+ event: TaskboxModal;
35
+ };
36
+ event: TaskBoxGoogleEvent | null;
37
+ readOnly: boolean;
38
+ busy: boolean;
39
+ canDelete: boolean;
40
+ actions: {
41
+ /** 시작일을 바꾸면 종료일이 앞서지 않게 따라온다. */
42
+ changeStartDate: (ymd: string) => void;
43
+ /** 종료일을 바꾼다. */
44
+ changeEndDate: (ymd: string) => void;
45
+ /** 시작 시각을 바꾸면(같은 날) 종료 시각이 앞서지 않게 +1시간으로 맞춘다. */
46
+ changeStartTime: (next: string) => void;
47
+ /** 종료 시각을 바꾼다. */
48
+ changeEndTime: (next: string) => void;
49
+ /** 종일 여부를 바꾼다. */
50
+ changeAllDay: (checked: boolean) => void;
51
+ /** 삭제(확인 팝퍼를 거친 뒤) — 서버 반영·닫기는 소비처가 한다. */
52
+ remove: () => void | undefined;
53
+ };
54
+ };
55
+ /** 구글 일정 편집 컨트롤러 타입이다. */
56
+ export type GoogleEventController = ReturnType<typeof useGoogleEventController>;
@@ -0,0 +1,41 @@
1
+ /**
2
+ * 업무 차트 컨트롤러 — 차트 모달, 목표·기간·보기 선택 폼, 겹쳐 여는 인원 업무·인원 용량 선택을 소유한다.
3
+ * 용량 저장·책임자 옮기기·상세 열기는 여전히 소비처 콜백 몫이다.
4
+ */
5
+ import type { TaskBoxItem, TaskBoxSprint, WorkloadCapacity } from "../types";
6
+ /** 차트 선택 폼 값이다 — LabelSelect 가 문자열을 돌려주므로 문자열로 들고 읽을 때 바꾼다. */
7
+ export interface SprintChartsForm {
8
+ sprintSeq: string;
9
+ flowDays: string;
10
+ workloadMode: string;
11
+ }
12
+ /** 업무 차트 컨트롤러 옵션이다. */
13
+ export interface UseSprintChartsControllerOptions {
14
+ open: boolean;
15
+ sprints: TaskBoxSprint[];
16
+ tasks: TaskBoxItem[];
17
+ todayStr: string;
18
+ initialSprintSeq: number;
19
+ capacity: WorkloadCapacity;
20
+ onSaveCapacity?: (capacity: WorkloadCapacity) => void | Promise<void>;
21
+ onOpenTask?: (taskSeq: number) => void;
22
+ onClose: () => void;
23
+ }
24
+ /** 업무 차트 폼/모달 컨트롤러 훅이다. */
25
+ export declare function useSprintChartsController({ open, sprints, tasks, todayStr, initialSprintSeq, capacity, onSaveCapacity, onOpenTask, onClose, }: UseSprintChartsControllerOptions): {
26
+ form: import("@ehfuse/forma").UseGlobalFormReturn<SprintChartsForm>;
27
+ modals: {
28
+ charts: import("./usePropSyncedModal").TaskboxModal;
29
+ };
30
+ workloadRows: import("..").WorkloadRow[];
31
+ pickedAccountSeq: number;
32
+ pickedRow: import("..").WorkloadRow | null;
33
+ pickPerson: import("react").Dispatch<import("react").SetStateAction<number>>;
34
+ closePersonTasks: () => void;
35
+ capacityOpen: boolean;
36
+ openCapacity: () => void;
37
+ closeCapacity: () => void;
38
+ saveCapacity: ((next: WorkloadCapacity) => Promise<void>) | undefined;
39
+ openTask: ((taskSeq: number) => void) | undefined;
40
+ };
41
+ export type SprintChartsController = ReturnType<typeof useSprintChartsController>;
@@ -0,0 +1,37 @@
1
+ /**
2
+ * 목표(스프린트) 마감 컨트롤러 — 남은 업무 처리 방식 폼과 모달을 소유하고, 마감 확정 콜백 호출을 맡는다.
3
+ * 실제 저장(상태 변경·업무 이동)은 여전히 소비처 `onConfirm` 몫이다.
4
+ */
5
+ import type { TaskBoxItem, TaskBoxSprint } from "../types";
6
+ /** 남은 업무 처리 방식이다. */
7
+ export type SprintCarryOverMode = "move" | "backlog" | "keep";
8
+ /** 마감 확정 결과다 — 소비처가 이대로 저장한다. */
9
+ export interface SprintCloseResult {
10
+ mode: SprintCarryOverMode;
11
+ moveToSprintSeq: number;
12
+ taskSeqs: number[];
13
+ }
14
+ /** 마감 폼 값이다 — 이월 대상은 LabelSelect 가 문자열로 돌려주므로 문자열로 든다. */
15
+ export interface SprintCloseForm {
16
+ mode: SprintCarryOverMode;
17
+ moveToSeq: string;
18
+ }
19
+ /** 목표 마감 컨트롤러 옵션이다. */
20
+ export interface UseSprintCloseControllerOptions {
21
+ open: boolean;
22
+ sprint: TaskBoxSprint | null;
23
+ remainingTasks: TaskBoxItem[];
24
+ sprints: TaskBoxSprint[];
25
+ onClose: () => void;
26
+ onConfirm: (result: SprintCloseResult) => void;
27
+ }
28
+ /** 목표 마감 폼/모달 컨트롤러 훅이다. */
29
+ export declare function useSprintCloseController({ open, sprint, remainingTasks, sprints, onClose, onConfirm, }: UseSprintCloseControllerOptions): {
30
+ form: import("@ehfuse/forma").UseGlobalFormReturn<SprintCloseForm>;
31
+ modals: {
32
+ form: import("./usePropSyncedModal").TaskboxModal;
33
+ };
34
+ candidates: TaskBoxSprint[];
35
+ hasRemaining: boolean;
36
+ };
37
+ export type SprintCloseController = ReturnType<typeof useSprintCloseController>;
@@ -0,0 +1,57 @@
1
+ /**
2
+ * 목표(스프린트) 관리 컨트롤러 — 관리 목록 모달, 등록·수정 폼과 그 모달, 마감 대상 선택을 소유한다.
3
+ * 등록·수정·상태 변경·삭제의 실제 저장은 여전히 소비처 콜백(onCreate/onUpdate/onChangeStatus/onRemove) 몫이다.
4
+ */
5
+ import type { TaskBoxCustomTab, TaskBoxItem, TaskBoxSprint } from "../types";
6
+ import type { SprintCloseResult } from "./sprintCloseController";
7
+ import { type TaskboxModal } from "./usePropSyncedModal";
8
+ /** 목표 등록·수정 폼 값이다. */
9
+ export interface SprintForm {
10
+ editingSeq: number;
11
+ groupKey: string;
12
+ name: string;
13
+ goal: string;
14
+ start_date: string;
15
+ end_date: string;
16
+ }
17
+ /** 목표 관리 컨트롤러 옵션이다(다이얼로그 props 그대로). */
18
+ export interface UseSprintManageControllerOptions {
19
+ open: boolean;
20
+ customTabs: TaskBoxCustomTab[];
21
+ onClose: () => void;
22
+ onCreate: (payload: {
23
+ group_seq: number;
24
+ name: string;
25
+ goal: string;
26
+ start_date: string;
27
+ end_date: string;
28
+ }) => Promise<boolean>;
29
+ onUpdate: (seq: number, patch: {
30
+ name: string;
31
+ goal: string;
32
+ start_date: string;
33
+ end_date: string;
34
+ }) => void;
35
+ onChangeStatus: (seq: number, status: TaskBoxSprint["status"]) => void;
36
+ tasks?: TaskBoxItem[];
37
+ onCloseSprint?: (seq: number, result: SprintCloseResult) => void;
38
+ onRemove: (seq: number) => void;
39
+ }
40
+ /** 목표 관리 폼/모달 컨트롤러 훅이다. */
41
+ export declare function useSprintManageController({ open, customTabs, onClose, onCreate, onUpdate, onChangeStatus, tasks, onCloseSprint, onRemove, }: UseSprintManageControllerOptions): {
42
+ form: import("@ehfuse/forma").UseGlobalFormReturn<SprintForm>;
43
+ modals: {
44
+ manage: TaskboxModal;
45
+ form: TaskboxModal;
46
+ };
47
+ sprintTabs: TaskBoxCustomTab[];
48
+ closingSprint: TaskBoxSprint | null;
49
+ remainingTasks: TaskBoxItem[];
50
+ openCreateForm: () => void;
51
+ openEditForm: (sprint: TaskBoxSprint) => void;
52
+ changeStatus: (sprint: TaskBoxSprint, next: TaskBoxSprint["status"]) => void;
53
+ cancelCloseSprint: () => void;
54
+ confirmCloseSprint: (result: SprintCloseResult) => void;
55
+ removeSprint: (seq: number) => void;
56
+ };
57
+ export type SprintManageController = ReturnType<typeof useSprintManageController>;
@@ -0,0 +1,25 @@
1
+ /**
2
+ * 업무 활동로그 다이얼로그 컨트롤러다 — 모달과 "열릴 때 읽기" 흐름을 소유한다.
3
+ * 다이얼로그(TaskActivityDialog)는 컨트롤러가 준 모달·목록으로 그리기만 한다.
4
+ * 조회는 소비처 콜백(onLoad)이 한다 — 닫힌 업무마다 이력을 미리 당기지 않는다.
5
+ */
6
+ import type { TaskActivityItem } from "../types";
7
+ import { type TaskboxModal } from "./usePropSyncedModal";
8
+ /** `useTaskActivityController` 옵션이다. */
9
+ export interface UseTaskActivityControllerOptions {
10
+ taskSeq: number;
11
+ items?: TaskActivityItem[];
12
+ loading?: boolean;
13
+ onLoad?: (taskSeq: number) => void;
14
+ }
15
+ /** 업무 활동로그 다이얼로그 컨트롤러 훅이다. */
16
+ export declare function useTaskActivityController({ taskSeq, items, loading, onLoad }: UseTaskActivityControllerOptions): {
17
+ modals: {
18
+ activity: TaskboxModal;
19
+ };
20
+ items: TaskActivityItem[] | undefined;
21
+ loading: boolean | undefined;
22
+ openDialog: () => void;
23
+ };
24
+ /** 업무 활동로그 컨트롤러 타입이다 — `TaskActivityDialog` 의 `controller` prop. */
25
+ export type TaskActivityController = ReturnType<typeof useTaskActivityController>;
@@ -0,0 +1,37 @@
1
+ /**
2
+ * 업무 내용 번역 다이얼로그 컨트롤러다 — 모달·언어 선택·AI 번역 요청·복사를 소유한다(Provider translateContent 주입).
3
+ * 서버가 언어별 결과를 업무에 저장하므로(translated_targets) 이미 번역된 언어는 확인 없이 연다(비용 없음).
4
+ * 번역 상태는 forma 상태에 둔다 — 여는 쪽(상세 본문)이 아니라 다이얼로그만 구독해 본문 전체가 다시 그려지지 않는다.
5
+ */
6
+ import type { TaskboxTranslateResult } from "../types";
7
+ import { type TaskboxModal } from "./usePropSyncedModal";
8
+ /** 번역 다이얼로그 화면 상태다. */
9
+ export interface TaskContentTranslateUiState {
10
+ target: string;
11
+ doneTargets: string[];
12
+ result: TaskboxTranslateResult | null;
13
+ loading: boolean;
14
+ error: string;
15
+ copied: boolean;
16
+ summaryCopied: boolean;
17
+ }
18
+ /** `useTaskContentTranslateController` 옵션이다. */
19
+ export interface UseTaskContentTranslateControllerOptions {
20
+ taskSeq: number;
21
+ translatedTargets?: string[];
22
+ }
23
+ /** 업무 내용 번역 다이얼로그 컨트롤러 훅이다. */
24
+ export declare function useTaskContentTranslateController(options: UseTaskContentTranslateControllerOptions): {
25
+ modals: {
26
+ translate: TaskboxModal;
27
+ };
28
+ ui: import("@ehfuse/forma").UseFormaStateReturn<TaskContentTranslateUiState>;
29
+ taskSeq: number;
30
+ isStored: (code: string) => boolean;
31
+ selectTarget: (code: string) => void;
32
+ openDialog: () => void;
33
+ copySummary: () => void;
34
+ copyResult: () => void;
35
+ };
36
+ /** 업무 내용 번역 컨트롤러 타입이다 — `TaskContentTranslateDialog` 의 `controller` prop. */
37
+ export type TaskContentTranslateController = ReturnType<typeof useTaskContentTranslateController>;
@@ -0,0 +1,88 @@
1
+ /**
2
+ * 새 업무 등록 컨트롤러다 — 등록 폼(forma 전역 폼)·등록 드로어 모달과, 그 폼을 바꾸는 동작
3
+ * (열림 초기화·유형 전환·반복·공개 범위·할일·첨부 대기)을 한곳에 둔다. 드로어·본문은 그리기만 한다.
4
+ *
5
+ * 서버 저장은 패키지가 모른다 — 소비처가 `onSubmit(values, files)` 로 주입하고, 컨트롤러는 등록 흐름의 앞뒤
6
+ * (검증·중복 제출 잠금·첨부 대기 비우기·드로어 닫기)만 맡는다.
7
+ * 동작은 "폼을 인자로 받는 함수"로도 내보낸다 — 소비처가 `useTaskboxForm` 으로 폼을 따로 만들어 드로어에
8
+ * 넘기는 기존 조립에서도 뷰가 같은 동작을 써야 하기 때문이다(훅 안에 가두면 그 경로가 끊긴다).
9
+ */
10
+ import type { TaskboxModal } from "./usePropSyncedModal";
11
+ import type { TaskBoxRepeatRule, TaskBoxVisibility } from "../types";
12
+ import type { TaskBoxForm } from "../types/form";
13
+ import { type TaskboxCreateForm } from "../state/useTaskboxForm";
14
+ import { type TaskboxUiStateInstance } from "../state/useTaskboxUiState";
15
+ /** 일정 기본 아이콘 색이다(초록 — 캘린더 박스 "일정 m건"·가져오기 다이얼로그 아이콘과 동일 계열). */
16
+ export declare const EVENT_ICON_COLOR = "#0f9d58";
17
+ /** 등록 유형이다([업무|일정|오류] 토글 값). */
18
+ export type TaskCreateType = "task" | "event" | "bug";
19
+ /** 등록 드로어가 열릴 때 채울 프리셋이다(드로어 props 로 들어온다). */
20
+ export interface TaskCreatePresets {
21
+ presetTitle?: string;
22
+ presetContent?: string;
23
+ presetVisibility?: TaskBoxVisibility;
24
+ presetVisibilityGroupSeq?: number;
25
+ presetDueDate?: string;
26
+ presetTabKey?: string;
27
+ presetManager?: {
28
+ name: string;
29
+ accountSeq: number;
30
+ } | null;
31
+ isNotice?: boolean;
32
+ defaultBug?: boolean;
33
+ }
34
+ /** 등록 폼을 프리셋으로 초기화하고 첨부 대기 목록을 비운다(드로어가 닫힘 → 열림 전환 때 부른다). */
35
+ export declare function resetTaskCreateForm(form: TaskboxCreateForm, uiState: TaskboxUiStateInstance, presets: TaskCreatePresets): void;
36
+ /**
37
+ * 등록 기본 검증이다 — 어기면 알림을 띄우고 false.
38
+ * 비어 있는 칸은 제목 입력칸이므로 등록 유형별 placeholder 와 같은 문구로 안내한다.
39
+ */
40
+ export declare function validateTaskCreateForm(values: TaskBoxForm): boolean;
41
+ /** 등록 유형을 바꾼다 — 입력값은 유지하고 유형에 딸린 기본값(공개 범위·반복·아이콘)만 갈아끼운다. */
42
+ export declare function changeTaskCreateType(form: TaskboxCreateForm, type: TaskCreateType): void;
43
+ /** 반복 주기를 고른다 — 종료일 기본값을 채우고, 반복 업무에서 쓰지 않는 마감일시를 비운다. */
44
+ export declare function applyTaskCreateRepeatRule(form: TaskboxCreateForm, rule: TaskBoxRepeatRule | ""): void;
45
+ /** 반복 종료일을 달력에서 고른 날로 정한다. */
46
+ export declare function setTaskCreateRepeatUntil(form: TaskboxCreateForm, picked: Date): void;
47
+ /** 공개 범위를 정한다 — 부서공개가 아니면 부서 seq 는 0 으로 되돌린다(두 칸이 한 값이라 함께 쓴다). */
48
+ export declare function setTaskCreateVisibility(form: TaskboxCreateForm, visibility: TaskBoxVisibility, groupSeq?: number): void;
49
+ /** 할일을 덧붙인다. */
50
+ export declare function addTaskCreateChecklistItem(form: TaskboxCreateForm, label: string): void;
51
+ /** 할일 체크를 바꾼다. */
52
+ export declare function toggleTaskCreateChecklistItem(form: TaskboxCreateForm, index: number, checked: boolean): void;
53
+ /** 할일을 뺀다. */
54
+ export declare function removeTaskCreateChecklistItem(form: TaskboxCreateForm, index: number): void;
55
+ /** 할일 글자를 고친다. */
56
+ export declare function updateTaskCreateChecklistItem(form: TaskboxCreateForm, index: number, label: string): void;
57
+ /** 첨부 대기 목록에 파일을 담는다 — 한도(uploadMaxMb) 초과 파일은 담기 전에 걸러 안내한다(정책 안내 — 정보 알림). */
58
+ export declare function addTaskCreatePendingFiles(uiState: TaskboxUiStateInstance, files: File[], uploadMaxMb: number): void;
59
+ /** 첨부 대기 목록에서 파일을 뺀다. */
60
+ export declare function removeTaskCreatePendingFile(uiState: TaskboxUiStateInstance, index: number): void;
61
+ /** `useTaskCreateController` 옵션이다. */
62
+ export interface UseTaskCreateControllerOptions {
63
+ /** forma formId(기본 "taskbox-create-form"). 같은 id 는 같은 폼을 공유한다. */
64
+ formId?: string;
65
+ /** forma modalId(기본 "taskbox-create-drawer"). 드로어를 여는 버튼과 드로어가 같은 id 로 만난다. */
66
+ modalId?: string;
67
+ /** 폼 기본값 부분 오버라이드. */
68
+ initialValues?: Partial<TaskBoxForm>;
69
+ /** 추가 검증 — 기본 검증(제목·일정 날짜·일시 순서)을 통과한 뒤 부른다. false 면 제출 중단. */
70
+ onValidate?: (values: TaskBoxForm) => boolean | Promise<boolean>;
71
+ /**
72
+ * 등록 저장(서버 저장·첨부 업로드는 소비처 몫). files 는 첨부 대기 파일이다.
73
+ * false 를 돌려주면 등록 실패로 보고 드로어와 입력·첨부 대기를 그대로 둔다.
74
+ */
75
+ onSubmit: (values: TaskBoxForm, files: File[]) => Promise<boolean | void> | boolean | void;
76
+ }
77
+ /** 등록 폼·드로어 모달과 등록 흐름을 소유하는 컨트롤러 훅이다. */
78
+ export declare function useTaskCreateController(options: UseTaskCreateControllerOptions): {
79
+ form: TaskboxCreateForm;
80
+ modals: {
81
+ form: TaskboxModal;
82
+ };
83
+ uiState: TaskboxUiStateInstance;
84
+ /** 등록 드로어를 연다 — 폼 초기화는 드로어가 열림 전환에서 프리셋 props 로 한다(초기화 경로를 하나로 둔다). */
85
+ openCreate: () => void;
86
+ };
87
+ /** 등록 컨트롤러 반환 타입이다. */
88
+ export type TaskCreateController = ReturnType<typeof useTaskCreateController>;
@@ -0,0 +1,49 @@
1
+ /**
2
+ * 업무 상세 컨트롤러다 — 상세 드로어의 저장 흐름을 뷰에서 떼어 둔다.
3
+ * · 모바일 지연 저장 — 필드 수정을 forma 전역 폼(`changes` 한 칸)에 모았다가 저장하기(`form.submit`)로 한 번에 보낸다.
4
+ * · 데스크톱 즉시 저장 — 같은 콜백 묶음이 소비처 콜백을 바로 부른다.
5
+ * · 편집 세션 — 고친 게 있으면 닫힐 때 소비처(`onEditSessionEnd`)에 알려 수정 알림을 1건으로 묶게 한다.
6
+ * 저장 수단(PATCH)은 패키지가 모른다 — 소비처가 준 필드별 콜백·일괄 저장 콜백을 부른다.
7
+ */
8
+ import type { TaskBoxItem, TaskBoxRepeatRule } from "../types";
9
+ import type { TaskDetailBodyProps } from "../drawers/TaskDetailBody";
10
+ /** 모바일 지연 저장 폼 값이다 — 아직 저장하지 않은 수정분(키가 있으면 바뀐 필드). */
11
+ export interface TaskDetailPendingForm {
12
+ changes: Partial<TaskBoxItem>;
13
+ }
14
+ /** 드로어가 본문에 넘기는 콜백 묶음이다(헤더 몫 콜백은 컨트롤러가 따로 감싼다). */
15
+ export type TaskDetailStagedBodyProps = Omit<TaskDetailBodyProps, "task" | "onToggleCompleted" | "onChangeTitle" | "onChangeIcon">;
16
+ /** `useTaskDetailController` 옵션이다. */
17
+ export interface UseTaskDetailControllerOptions {
18
+ open: boolean;
19
+ task: TaskBoxItem | null;
20
+ isMobile: boolean;
21
+ bodyProps: Omit<TaskDetailBodyProps, "task" | "myAccountSeq" | "onToggleCompleted" | "onChangeTitle" | "onChangeIcon" | "onChangeIconColor">;
22
+ onSaveFields?: (taskSeq: number, fields: Partial<TaskBoxItem>) => void;
23
+ onChangeTitle: (taskSeq: number, title: string) => void;
24
+ onChangeIcon: (taskSeq: number, icon: string) => void;
25
+ onChangeIconColor?: (taskSeq: number, iconColor: string) => void;
26
+ }
27
+ /**
28
+ * 반복 주기를 바꾼다 — 해제·규칙 변경은 이후 회차를 지우거나 재생성하므로 확인창을 거친 뒤 저장 콜백을 부른다.
29
+ * 본문 반복 메뉴가 부른다(확인·안내·저장이 한 흐름이라 뷰에 두지 않는다).
30
+ */
31
+ export declare function applyTaskRepeatRule(task: TaskBoxItem, rule: TaskBoxRepeatRule | "", onChangeRepeat: ((taskSeq: number, rule: TaskBoxRepeatRule | "", until: string) => void) | undefined): Promise<void>;
32
+ /** 반복 종료일을 바꾼다 — 반복 중인 업무만(이후 회차가 새 종료일 기준으로 재생성된다). */
33
+ export declare function applyTaskRepeatUntil(task: TaskBoxItem, picked: Date, onChangeRepeat: ((taskSeq: number, rule: TaskBoxRepeatRule | "", until: string) => void) | undefined): void;
34
+ /** 상세 드로어의 지연/즉시 저장·편집 세션을 소유하는 컨트롤러 훅이다. */
35
+ export declare function useTaskDetailController(options: UseTaskDetailControllerOptions): {
36
+ form: import("@ehfuse/forma").UseGlobalFormReturn<TaskDetailPendingForm>;
37
+ baseTask: TaskBoxItem | null;
38
+ task: TaskBoxItem | null;
39
+ hasPendingChanges: boolean;
40
+ stagedBodyProps: TaskDetailStagedBodyProps;
41
+ /** 제목 수정 — 모바일은 스테이징, 데스크톱은 즉시 저장. */
42
+ changeTitle: (seq: number, title: string) => void;
43
+ /** 아이콘 수정 — 모바일은 스테이징, 데스크톱은 즉시 저장. */
44
+ changeIcon: (seq: number, icon: string) => void;
45
+ /** 아이콘 색 수정 — 모바일은 스테이징, 데스크톱은 즉시 저장. */
46
+ changeIconColor: (seq: number, iconColor: string) => void;
47
+ };
48
+ /** 상세 컨트롤러 반환 타입이다. */
49
+ export type TaskDetailController = ReturnType<typeof useTaskDetailController>;
@@ -0,0 +1,28 @@
1
+ /**
2
+ * 관련 업무 연결 다이얼로그 컨트롤러다 — 선택 폼(전역 폼)·모달·확정 흐름을 소유한다.
3
+ * 확정은 소비처 콜백(onSubmit)에 건별로 알린다 — 연결 저장·양방향 정합은 소비처 몫이다.
4
+ */
5
+ import type { TaskBoxRelationType } from "../types";
6
+ import { type TaskboxModal } from "./usePropSyncedModal";
7
+ /** 관련 업무 연결 폼 값이다. */
8
+ export interface TaskLinkForm {
9
+ type: TaskBoxRelationType;
10
+ search: string;
11
+ selectedSeqs: number[];
12
+ }
13
+ /** `useTaskLinkController` 옵션이다. */
14
+ export interface UseTaskLinkControllerOptions {
15
+ multiSelect?: boolean;
16
+ onSubmit: (targetSeq: number, type: TaskBoxRelationType) => void;
17
+ }
18
+ /** 관련 업무 연결 다이얼로그 컨트롤러 훅이다. */
19
+ export declare function useTaskLinkController(options: UseTaskLinkControllerOptions): {
20
+ form: import("@ehfuse/forma").UseGlobalFormReturn<TaskLinkForm>;
21
+ modals: {
22
+ link: TaskboxModal;
23
+ };
24
+ openDialog: () => void;
25
+ toggleSelected: (seq: number) => void;
26
+ };
27
+ /** 관련 업무 연결 컨트롤러 타입이다 — `TaskLinkDialog` 의 `controller` prop. */
28
+ export type TaskLinkController = ReturnType<typeof useTaskLinkController>;
@@ -0,0 +1,20 @@
1
+ /**
2
+ * 업무 인원 정보 다이얼로그 컨트롤러다 — 모달과 대상 업무를 소유한다(읽기 전용이라 폼은 없다).
3
+ * 대상 업무는 forma 상태에 둔다 — 캘린더(여는 쪽)가 아니라 다이얼로그만 구독해 달력 전체가 다시 그려지지 않는다.
4
+ */
5
+ import type { TaskBoxItem } from "../types";
6
+ import { type TaskboxModal } from "./usePropSyncedModal";
7
+ /** 인원 정보 다이얼로그 화면 상태다. */
8
+ export interface TaskMembersUiState {
9
+ task: TaskBoxItem | null;
10
+ }
11
+ /** 업무 인원 정보 다이얼로그 컨트롤러 훅이다. */
12
+ export declare function useTaskMembersController(): {
13
+ modals: {
14
+ members: TaskboxModal;
15
+ };
16
+ ui: import("@ehfuse/forma").UseFormaStateReturn<TaskMembersUiState>;
17
+ openDialog: (task: TaskBoxItem) => void;
18
+ };
19
+ /** 업무 인원 정보 컨트롤러 타입이다 — `TaskMembersDialog` 의 `controller` prop. */
20
+ export type TaskMembersController = ReturnType<typeof useTaskMembersController>;
@@ -0,0 +1,76 @@
1
+ /**
2
+ * 자동화 규칙 관리 다이얼로그 컨트롤러다 — 규칙 편집 폼(전역 폼)·목록/편집 모달·검사·저장·조건/동작 줄 조작을 소유한다.
3
+ *
4
+ * 조건·동작은 "키가 있으면 그 줄이 보인다" 규칙이다(줄 추가=기본값 넣기, X=키 지우기). 그래서 조건/동작 객체는
5
+ * 칸 단위로 쪼개 쓰지 않고 통째로 갈아 끼운다 — 빈 값은 키를 지워야 줄이 사라지고 서버에도 안 간다.
6
+ * 저장·토글·삭제는 소비처 콜백이 한다(목록 재조회·알림 포함). 목록 열림 원본은 소비처 `open` prop 이다.
7
+ */
8
+ import type { TaskBoxCustomTab, TaskBoxLabel, TaskContentTemplate, TaskRule, TaskRuleInput, TaskRuleTrigger } from "../types";
9
+ import { type TaskboxModal } from "./usePropSyncedModal";
10
+ /** 필드 변경 조건에서 고를 수 있는 필드다(사람이 실제로 규칙을 거는 것만 추린다). */
11
+ export declare const CHANGED_FIELD_OPTIONS: {
12
+ value: string;
13
+ label: string;
14
+ }[];
15
+ /** 조건 줄 종류다("kind" 는 is_bug/is_event 를 묶은 가상 키). */
16
+ export type ConditionRowKey = "group_seq" | "kind" | "priority" | "label_key" | "title_contains" | "manager_empty" | "manager_account" | "receiver_account" | "from_status" | "to_status" | "changed_field" | "comment_contains" | "comment_by_others" | "overdue_days";
17
+ /** 동작 줄 종류다. */
18
+ export type ActionRowKey = "apply_content_template" | "set_status" | "set_priority" | "add_label_key" | "assign_manager" | "add_receiver" | "notify";
19
+ /** 규칙 편집 폼 값이다 — 저장 입력 + 편집 대상 seq. */
20
+ export interface TaskRuleForm extends TaskRuleInput {
21
+ editSeq: number;
22
+ }
23
+ /** `useTaskRuleController` 옵션이다. */
24
+ export interface UseTaskRuleControllerOptions {
25
+ open: boolean;
26
+ rules: TaskRule[];
27
+ customTabs: TaskBoxCustomTab[];
28
+ statusOptions: TaskBoxLabel[];
29
+ contentTemplates: TaskContentTemplate[];
30
+ onPickAccount?: (current: number, purpose: string) => Promise<{
31
+ accountSeq: number;
32
+ name: string;
33
+ } | null>;
34
+ onClose: () => void;
35
+ onCreate: (payload: TaskRuleInput) => Promise<boolean>;
36
+ onUpdate: (seq: number, payload: TaskRuleInput) => Promise<boolean>;
37
+ onToggle: (seq: number, enabled: boolean) => void;
38
+ onRemove: (seq: number) => void;
39
+ }
40
+ /** 프로젝트 선택지(보관 제외)다. */
41
+ export declare function buildProjectSelectOptions(customTabs: TaskBoxCustomTab[]): {
42
+ value: string;
43
+ label: string;
44
+ }[];
45
+ /** 라벨 선택지다. */
46
+ export declare function buildLabelSelectOptions(statusOptions: TaskBoxLabel[]): {
47
+ value: string;
48
+ label: string;
49
+ }[];
50
+ /** 자동화 규칙 관리 다이얼로그 컨트롤러 훅이다. */
51
+ export declare function useTaskRuleController(options: UseTaskRuleControllerOptions): {
52
+ form: import("@ehfuse/forma").UseGlobalFormReturn<TaskRuleForm>;
53
+ modals: {
54
+ list: TaskboxModal;
55
+ form: TaskboxModal;
56
+ };
57
+ actions: {
58
+ openCreate: () => void;
59
+ openEdit: (rule: TaskRule) => void;
60
+ changeTrigger: (next: TaskRuleTrigger) => void;
61
+ setCondition: (key: keyof TaskRuleInput["condition"], value: unknown) => void;
62
+ setAction: (key: keyof TaskRuleInput["action"], value: unknown) => void;
63
+ addCondition: (key: ConditionRowKey) => void;
64
+ removeCondition: (key: ConditionRowKey) => void;
65
+ changeKind: (isBug: boolean) => void;
66
+ pickConditionAccount: (kind: "manager_account" | "receiver_account") => Promise<void>;
67
+ addAction: (key: ActionRowKey) => void;
68
+ removeAction: (key: ActionRowKey) => void;
69
+ pickAccountFor: (kind: "assign_manager" | "add_receiver" | "notify") => Promise<void>;
70
+ selectContentTemplate: (value: string) => void;
71
+ toggleRule: (seq: number, enabled: boolean) => void;
72
+ removeRule: (seq: number) => void;
73
+ };
74
+ };
75
+ /** 자동화 규칙 컨트롤러 타입이다. */
76
+ export type TaskRuleController = ReturnType<typeof useTaskRuleController>;