@wipco/sdui 0.28.0 → 0.30.0

package/dist/widgets/ApprovalOverridesEditor.js

@@ -1,9 +1,9 @@
-export { ApprovalOverridesEditor } from '../chunk-ZDRERW4G.js';
+export { ApprovalOverridesEditor } from '../chunk-OR27SRKL.js';
 import '../chunk-QDEZXA34.js';
-import '../chunk-SAPJVLZM.js';
+import '../chunk-S4LOH2TU.js';
 import '../chunk-BD75U73S.js';
-import '../chunk-DVOPZFQS.js';
 import '../chunk-EFMKWPZ3.js';
 import '../chunk-XQPTSEJC.js';
+import '../chunk-DKPNFEVU.js';
 import '../chunk-WIDDHR7L.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/AutocompleteField.js

@@ -1,7 +1,7 @@
-export { AutocompleteField, endpointSearchFn, toAutocompleteOptions } from '../chunk-6S5CFNFM.js';
+export { AutocompleteField, endpointSearchFn, toAutocompleteOptions } from '../chunk-CVCP52OD.js';
 import '../chunk-BD75U73S.js';
-import '../chunk-DVOPZFQS.js';
 import '../chunk-EFMKWPZ3.js';
 import '../chunk-XQPTSEJC.js';
+import '../chunk-DKPNFEVU.js';
 import '../chunk-WIDDHR7L.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/FileDropzone.d.ts

@@ -0,0 +1,65 @@
+import { S as SduiBoxProps } from '../layout-B1QrIBm6.js';
+import React__default from 'react';
+
+type FileDropzoneItem = {
+    id: string;
+    url: string;
+    name?: string;
+};
+interface FileDropzoneProps {
+    /** 백엔드 업로드 경로 (예: "/attachments"). 없으면 로컬 미리보기 모드 */
+    endpoint?: string;
+    /** 첨부 목록 — 주면 controlled */
+    value?: FileDropzoneItem[];
+    onChange?: (files: FileDropzoneItem[]) => void;
+    /** 업로드 큐 시작/종료 알림 */
+    onBusyChange?: (busy: boolean) => void;
+    /** 최대 첨부 수 */
+    maxCount?: number;
+    /** 허용 형식 (input accept 문법) */
+    accept?: string;
+    disabled?: boolean;
+    /** 드롭 영역 아래 보조 문구 */
+    hint?: string;
+    /**
+     * 첨부 삭제 경로의 **기준**(예: "/attachments"). 주면 썸네일의 삭제가 목록에서
+     * 빼는 데 그치지 않고 `DELETE {deleteEndpoint}/{id}` 까지 보낸다.
+     *
+     * 이게 없으면 이미 올라간 사진을 이 칸에 채워 둘 수 없다 — 지운 것처럼 보이는데
+     * 서버에는 그대로 남는 함정이 되기 때문이다(그래서 예전에는 "추가 전용"이었다).
+     * 아직 업로드 중이거나 로컬 미리보기(id가 `local-`)인 항목은 보낼 곳이 없어 건너뛴다.
+     */
+    /**
+     * 업로드를 직접 맡는다. 주면 `endpoint` 대신 이 함수가 불린다 — 위젯은 응답을
+     * 해석하지 않고 항목을 그대로 받는다(서버 봉투가 특수한 앱의 탈출구).
+     */
+    upload?: (file: File) => Promise<FileDropzoneItem>;
+    /** multipart 필드 이름. 기본 'file'. */
+    fileField?: string;
+    /**
+     * 503을 "백엔드 미연동"으로 읽어 로컬 미리보기로 강등한다. 기본 false —
+     * 일반 서버의 과부하 503에서 "올린 것처럼 보이는데 새로고침하면 없는" 항목을
+     * 만들면 안 되기 때문이다. 데모 모드를 503으로 합성하는 앱만 켠다.
+     */
+    localFallbackOn503?: boolean;
+    deleteEndpoint?: string;
+    /** 서버에서 실제로 지운 뒤 한 번 — 보통 목록·상세를 다시 읽는 invalidate를 건다 */
+    onRemove?: () => void;
+}
+/**
+ * 업로드 응답에서 `{id, url}` 을 꺼낸다 — **도메인 명사를 알지 않는다.**
+ *
+ * 단일 자원을 한 겹 감싸 주는 것은 REST 관례다(`{attachment:{…}}`·`{data:{…}}`).
+ * 그래서 이름 목록을 두는 대신 **모양**으로 판정한다: 최상위에 id·url 이 없고
+ * 객체 값을 가진 키가 **정확히 하나**면 그 안으로 한 겹 내려간다.
+ * 그 조건을 벗어나면(키가 둘 이상, 값이 객체가 아님) 벗기지 않는다 — 잘못 벗겨
+ * 엉뚱한 값을 집는 것보다 "응답 형식 오류"로 드러나는 편이 낫다.
+ */
+declare function unwrapUploaded(payload: unknown): {
+    id?: unknown;
+    url?: unknown;
+} | null;
+/** 바깥에서 온 `style`·`className`을 뿌리에 얹어 내보낸다 — 자기 축(폭·여백)이 닿게 하는 통로. */
+declare const FileDropzone: React__default.FC<FileDropzoneProps & SduiBoxProps>;
+
+export { FileDropzone, type FileDropzoneItem, type FileDropzoneProps, unwrapUploaded };

package/dist/widgets/FileDropzone.js

@@ -0,0 +1,6 @@
+export { FileDropzone, unwrapUploaded } from '../chunk-DQVDS2VP.js';
+import '../chunk-XPBZMECW.js';
+import '../chunk-THEP3VWY.js';
+import '../chunk-DKPNFEVU.js';
+import '../chunk-WIDDHR7L.js';
+import '../chunk-SAN4IX6N.js';

package/dist/widgets/OrgChartBoard.js

@@ -1,6 +1,6 @@
-export { OrgChartBoard } from '../chunk-KBLFOC37.js';
+export { OrgChartBoard } from '../chunk-NGZI4V3O.js';
 import '../chunk-XPBZMECW.js';
 import '../chunk-THEP3VWY.js';
-import '../chunk-DVOPZFQS.js';
+import '../chunk-DKPNFEVU.js';
 import '../chunk-WIDDHR7L.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/PermissionMatrixEditor.d.ts

@@ -0,0 +1,37 @@
+import { S as SduiBoxProps } from '../layout-B1QrIBm6.js';
+import React__default from 'react';
+
+/** 서버 PUT 계약의 원소 — 키 이름 변경 금지. */
+interface PermissionGrant {
+    code: string;
+    scope?: string;
+}
+/** GET /permissions 행 — 실측 키 category·code·description·name. */
+interface PermissionCatalogEntry {
+    code: string;
+    name: string;
+    category?: string | null;
+    description?: string | null;
+}
+interface PermissionMatrixEditorProps {
+    /** 권한 카탈로그 전체(216종). 대개 page.data 가 채운 상태를 바인딩한다. */
+    permissions: PermissionCatalogEntry[];
+    /** 현재 부여 목록 — PUT `permissions` 배열과 같은 모양. */
+    value: PermissionGrant[];
+    onChange: (value: PermissionGrant[]) => void;
+    /**
+     * 역할의 현재 부여를 스스로 읽어 와 onChange 로 **한 번** 흘리는 시딩 경로
+     * (예: `/roles/{id}/permissions`). 응답의 `permissions` 배열을 쓴다.
+     *
+     * 왜 필요한가: 상태에는 감시자가 없어 "다이얼로그가 열리면 GET 결과를 폼 상태에
+     * 복사"를 스펙이 표현할 수 없다(rowClick 복사는 fetch 와 경주한다). 경로가 바뀔
+     * 때마다 다시 시딩하므로, 여는 쪽이 경로에 여는 횟수를 붙이면(`…&_=3`) 같은 역할을
+     * 다시 열어도 서버 값으로 초기화된다. 캔버스 샌드박스에서는 조용히 실패한다.
+     */
+    sourceEndpoint?: string;
+    disabled?: boolean;
+}
+/** 바깥 style·className 을 뿌리에 얹는다 — 자기 축(폭·여백) 통로. */
+declare const PermissionMatrixEditor: React__default.FC<PermissionMatrixEditorProps & SduiBoxProps>;
+
+export { type PermissionCatalogEntry, type PermissionGrant, PermissionMatrixEditor, type PermissionMatrixEditorProps };

package/dist/widgets/PermissionMatrixEditor.js

@@ -0,0 +1,4 @@
+export { PermissionMatrixEditor } from '../chunk-N24VF6KI.js';
+import '../chunk-DKPNFEVU.js';
+import '../chunk-WIDDHR7L.js';
+import '../chunk-SAN4IX6N.js';

package/dist/widgets/RankBoard.js

@@ -1,6 +1,6 @@
-export { RankBoard } from '../chunk-DIVN4TBW.js';
+export { RankBoard } from '../chunk-U6H7YN4I.js';
 import '../chunk-QU7YVMFA.js';
-import '../chunk-DVOPZFQS.js';
 import '../chunk-XQPTSEJC.js';
+import '../chunk-DKPNFEVU.js';
 import '../chunk-WIDDHR7L.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/RoleMemberPicker.d.ts

@@ -0,0 +1,37 @@
+import { S as SduiBoxProps } from '../layout-B1QrIBm6.js';
+import React__default from 'react';
+
+/** GET /roles/{id}/employees 행(평면)과 GET /employees 행(department 객체)을 모두 수용. */
+interface RoleMemberEntry {
+    id: string;
+    name?: string | null;
+    employee_number?: string | null;
+    work_email?: string | null;
+    job_title?: string | null;
+    grade?: string | null;
+    department_name?: string | null;
+    department?: {
+        name?: string | null;
+    } | null;
+}
+interface RoleMemberPickerProps {
+    /** 직원 카탈로그 — 대개 page.data 의 /employees?limit=500 data 를 바인딩한다. 비면 자체 수집. */
+    employees?: RoleMemberEntry[];
+    /**
+     * 멤버십 경로(예: `/roles/{id}/employees?_=3`). 경로가 바뀔 때마다 GET 으로 현재
+     * 멤버를 다시 읽는다 — 여는 쪽이 여는 횟수를 붙이면(`?_=seq`) 같은 역할을 다시
+     * 열어도 서버 값으로 초기화된다(PermissionMatrixEditor.sourceEndpoint 와 같은 계약).
+     * 추가(POST)·해제(DELETE)는 **쿼리를 뗀 같은 경로**로 보낸다.
+     */
+    /**
+     * 후보 목록 경로. 응답은 `{data:[{id,name,…}], total}` 이고 500건씩 수집한다.
+     * 기본 '/employees'.
+     */
+    catalogEndpoint?: string;
+    sourceEndpoint?: string;
+    disabled?: boolean;
+}
+/** 바깥 style·className 을 뿌리에 얹는다 — 자기 축(폭·여백) 통로. */
+declare const RoleMemberPicker: React__default.FC<RoleMemberPickerProps & SduiBoxProps>;
+
+export { type RoleMemberEntry, RoleMemberPicker, type RoleMemberPickerProps };

package/dist/widgets/RoleMemberPicker.js

@@ -0,0 +1,4 @@
+export { RoleMemberPicker } from '../chunk-WXZDYDXG.js';
+import '../chunk-DKPNFEVU.js';
+import '../chunk-WIDDHR7L.js';
+import '../chunk-SAN4IX6N.js';

package/dist/widgets/index.d.ts

@@ -16,6 +16,8 @@ import { SecureScreenProps } from './SecureScreen.js';
 export { SecureScreen } from './SecureScreen.js';
 import { SearchableMultiPickerProps } from './SearchableMultiPicker.js';
 export { MultiPickerOption, SearchableMultiPicker } from './SearchableMultiPicker.js';
+import { RoleMemberPickerProps } from './RoleMemberPicker.js';
+export { RoleMemberPicker } from './RoleMemberPicker.js';
 import { RecordSheetProps } from './RecordSheet.js';
 export { RecordSheet, RecordSheetCell, RecordSheetCellKind, RecordSheetRow } from './RecordSheet.js';
 import { RankBoardProps } from './RankBoard.js';
@@ -24,6 +26,8 @@ import { PrintSheetProps } from './PrintSheet.js';
 export { PrintSheet } from './PrintSheet.js';
 import { PeriodFilterProps } from './PeriodFilter.js';
 export { Period, PeriodFilter, PeriodMode, PeriodModeItem } from './PeriodFilter.js';
+import { PermissionMatrixEditorProps } from './PermissionMatrixEditor.js';
+export { PermissionMatrixEditor } from './PermissionMatrixEditor.js';
 import { OrgChartBoardProps } from './OrgChartBoard.js';
 export { OrgChartBoard } from './OrgChartBoard.js';
 import { OrgChartProps } from './OrgChart.js';
@@ -53,6 +57,7 @@ import { S as SduiBoxProps } from '../layout-B1QrIBm6.js';
 import { ApprovalLineEditorProps } from './ApprovalLineEditor.js';
 export { ApprovalLineEditor, ApprovalLineStep, CustomApprover } from './ApprovalLineEditor.js';
 export { AutocompleteField, AutocompleteFieldProps, AutocompleteOption, AutocompleteSearchFn, AutocompleteSearchResult, toAutocompleteOptions } from './AutocompleteField.js';
+export { FileDropzone, FileDropzoneItem, FileDropzoneProps, unwrapUploaded } from './FileDropzone.js';
 
 /**
  * `createRegistry(widgetComponents)`로 어휘에 얹는 묶음.
@@ -75,10 +80,12 @@ declare const widgetComponents: {
     LiveClock: React.FC<LiveClockProps & SduiBoxProps>;
     OrgChart: React.FC<OrgChartProps & SduiBoxProps>;
     OrgChartBoard: React.FC<OrgChartBoardProps & SduiBoxProps>;
+    PermissionMatrixEditor: React.FC<PermissionMatrixEditorProps & SduiBoxProps>;
     PeriodFilter: React.FC<PeriodFilterProps & SduiBoxProps>;
     PrintSheet: React.FC<PrintSheetProps & SduiBoxProps>;
     RankBoard: React.FC<RankBoardProps & SduiBoxProps>;
     RecordSheet: React.FC<RecordSheetProps & SduiBoxProps>;
+    RoleMemberPicker: React.FC<RoleMemberPickerProps & SduiBoxProps>;
     SearchableMultiPicker: React.FC<SearchableMultiPickerProps & SduiBoxProps>;
     SecureScreen: React.FC<SecureScreenProps & SduiBoxProps>;
     StackedMeter: React.FC<StackedMeterProps & SduiBoxProps>;
@@ -92,4 +99,4 @@ declare const widgetComponents: {
 /** 위젯 어휘의 컴포넌트 이름 union — 메타데이터 대조에 쓴다(`@wipco/sdui/meta`). */
 type SduiWidgetComponentName = keyof typeof widgetComponents;
 
-export { ApprovalLineEditorProps, ApprovalOverridesEditorProps, ApprovalStepperProps, ColumnBoardProps, DiffViewProps, DisclosureProps, EventCalendarProps, ImageLightboxProps, InlineEditProps, JsonFieldProps, LiveClockProps, OrgChartBoardProps, OrgChartProps, PeriodFilterProps, PrintSheetProps, RankBoardProps, RecordSheetProps, type SduiWidgetComponentName, SearchableMultiPickerProps, SecureScreenProps, StackedMeterProps, StripProps, SummaryTableProps, TagMultiSelectProps, TimelineProps, TreePickerProps, TreeViewProps, widgetComponents };
+export { ApprovalLineEditorProps, ApprovalOverridesEditorProps, ApprovalStepperProps, ColumnBoardProps, DiffViewProps, DisclosureProps, EventCalendarProps, ImageLightboxProps, InlineEditProps, JsonFieldProps, LiveClockProps, OrgChartBoardProps, OrgChartProps, PeriodFilterProps, PermissionMatrixEditorProps, PrintSheetProps, RankBoardProps, RecordSheetProps, RoleMemberPickerProps, type SduiWidgetComponentName, SearchableMultiPickerProps, SecureScreenProps, StackedMeterProps, StripProps, SummaryTableProps, TagMultiSelectProps, TimelineProps, TreePickerProps, TreeViewProps, widgetComponents };

package/dist/widgets/index.js

@@ -1,3 +1,13 @@
+import { TreePicker } from '../chunk-U3HYQCFA.js';
+export { TreePicker } from '../chunk-U3HYQCFA.js';
+import { TreeView } from '../chunk-X5R2HHEN.js';
+export { TreeView, buildTreeNodes } from '../chunk-X5R2HHEN.js';
+import { RoleMemberPicker } from '../chunk-WXZDYDXG.js';
+export { RoleMemberPicker } from '../chunk-WXZDYDXG.js';
+import { SearchableMultiPicker } from '../chunk-C53NGSA3.js';
+export { SearchableMultiPicker } from '../chunk-C53NGSA3.js';
+import { SecureScreen } from '../chunk-IIRENCDS.js';
+export { SecureScreen } from '../chunk-IIRENCDS.js';
 import { StackedMeter } from '../chunk-BMZKZGJF.js';
 export { StackedMeter } from '../chunk-BMZKZGJF.js';
 import { Strip } from '../chunk-ZH5MLOZS.js';
@@ -6,26 +16,22 @@ import { SummaryTable } from '../chunk-O4U7Y3XL.js';
 export { SummaryTable } from '../chunk-O4U7Y3XL.js';
 import { Timeline } from '../chunk-EFYEOT47.js';
 export { Timeline } from '../chunk-EFYEOT47.js';
-import { TreePicker } from '../chunk-U3HYQCFA.js';
-export { TreePicker } from '../chunk-U3HYQCFA.js';
-import { TreeView } from '../chunk-X5R2HHEN.js';
-export { TreeView, buildTreeNodes } from '../chunk-X5R2HHEN.js';
+import { LiveClock } from '../chunk-Z3WGIFJP.js';
+export { LiveClock } from '../chunk-Z3WGIFJP.js';
 import { OrgChart } from '../chunk-QWJ3OBBL.js';
 export { OrgChart } from '../chunk-QWJ3OBBL.js';
-import { OrgChartBoard } from '../chunk-KBLFOC37.js';
-export { OrgChartBoard } from '../chunk-KBLFOC37.js';
+import { OrgChartBoard } from '../chunk-NGZI4V3O.js';
+export { OrgChartBoard } from '../chunk-NGZI4V3O.js';
+import { PermissionMatrixEditor } from '../chunk-N24VF6KI.js';
+export { PermissionMatrixEditor } from '../chunk-N24VF6KI.js';
 import { PeriodFilter } from '../chunk-INWASR2G.js';
 export { PeriodFilter } from '../chunk-INWASR2G.js';
 import { PrintSheet } from '../chunk-MYJ2KEIP.js';
 export { PrintSheet } from '../chunk-MYJ2KEIP.js';
-import { RankBoard } from '../chunk-DIVN4TBW.js';
-export { RankBoard } from '../chunk-DIVN4TBW.js';
+import { RankBoard } from '../chunk-U6H7YN4I.js';
+export { RankBoard } from '../chunk-U6H7YN4I.js';
 import { RecordSheet } from '../chunk-K3JBSWFI.js';
 export { RecordSheet } from '../chunk-K3JBSWFI.js';
-import { SearchableMultiPicker } from '../chunk-C53NGSA3.js';
-export { SearchableMultiPicker } from '../chunk-C53NGSA3.js';
-import { SecureScreen } from '../chunk-IIRENCDS.js';
-export { SecureScreen } from '../chunk-IIRENCDS.js';
 import { ColumnBoard } from '../chunk-C4JRSZGS.js';
 export { ColumnBoard } from '../chunk-C4JRSZGS.js';
 import { DiffView } from '../chunk-LDJ2CFFH.js';
@@ -34,29 +40,28 @@ import { Disclosure } from '../chunk-HIZ2OVJA.js';
 export { Disclosure } from '../chunk-HIZ2OVJA.js';
 import { EventCalendar } from '../chunk-C3JY6GA3.js';
 export { EventCalendar } from '../chunk-C3JY6GA3.js';
+export { FileDropzone, unwrapUploaded } from '../chunk-DQVDS2VP.js';
 import { ImageLightbox } from '../chunk-XPBZMECW.js';
 export { ImageLightbox } from '../chunk-XPBZMECW.js';
 import { InlineEdit } from '../chunk-KT3ZVBLN.js';
 export { InlineEdit } from '../chunk-KT3ZVBLN.js';
 import { JsonField } from '../chunk-JVBZRDC2.js';
 export { JsonField } from '../chunk-JVBZRDC2.js';
-import { LiveClock } from '../chunk-Z3WGIFJP.js';
-export { LiveClock } from '../chunk-Z3WGIFJP.js';
 import '../chunk-QU7YVMFA.js';
 import '../chunk-THEP3VWY.js';
-import { ApprovalOverridesEditor } from '../chunk-ZDRERW4G.js';
-export { ApprovalOverridesEditor } from '../chunk-ZDRERW4G.js';
+import { ApprovalOverridesEditor } from '../chunk-OR27SRKL.js';
+export { ApprovalOverridesEditor } from '../chunk-OR27SRKL.js';
 import { TagMultiSelect } from '../chunk-QDEZXA34.js';
 export { TagMultiSelect } from '../chunk-QDEZXA34.js';
-import { ApprovalLineEditor } from '../chunk-SAPJVLZM.js';
-export { ApprovalLineEditor } from '../chunk-SAPJVLZM.js';
+import { ApprovalLineEditor } from '../chunk-S4LOH2TU.js';
+export { ApprovalLineEditor } from '../chunk-S4LOH2TU.js';
 import { ApprovalStepper } from '../chunk-ZTQEP3TR.js';
 export { ApprovalStepper } from '../chunk-ZTQEP3TR.js';
-export { AutocompleteField, toAutocompleteOptions } from '../chunk-6S5CFNFM.js';
+export { AutocompleteField, toAutocompleteOptions } from '../chunk-CVCP52OD.js';
 import '../chunk-BD75U73S.js';
-import '../chunk-DVOPZFQS.js';
 import '../chunk-EFMKWPZ3.js';
 import '../chunk-XQPTSEJC.js';
+import '../chunk-DKPNFEVU.js';
 import '../chunk-WIDDHR7L.js';
 import '../chunk-SAN4IX6N.js';
 
@@ -75,10 +80,12 @@ var widgetComponents = {
   LiveClock,
   OrgChart,
   OrgChartBoard,
+  PermissionMatrixEditor,
   PeriodFilter,
   PrintSheet,
   RankBoard,
   RecordSheet,
+  RoleMemberPicker,
   SearchableMultiPicker,
   SecureScreen,
   StackedMeter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipco/sdui",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "description": "WIPCO 서버 주도 UI(SDUI) 렌더러 — JSON 페이지 스펙을 React 컴포넌트로 렌더링",
   "keywords": [
     "sdui",
@@ -68,6 +68,10 @@
       "types": "./dist/widgets/EventCalendar.d.ts",
       "default": "./dist/widgets/EventCalendar.js"
     },
+    "./widgets/FileDropzone": {
+      "types": "./dist/widgets/FileDropzone.d.ts",
+      "default": "./dist/widgets/FileDropzone.js"
+    },
     "./widgets/ImageLightbox": {
       "types": "./dist/widgets/ImageLightbox.d.ts",
       "default": "./dist/widgets/ImageLightbox.js"
@@ -92,6 +96,10 @@
       "types": "./dist/widgets/OrgChartBoard.d.ts",
       "default": "./dist/widgets/OrgChartBoard.js"
     },
+    "./widgets/PermissionMatrixEditor": {
+      "types": "./dist/widgets/PermissionMatrixEditor.d.ts",
+      "default": "./dist/widgets/PermissionMatrixEditor.js"
+    },
     "./widgets/PeriodFilter": {
       "types": "./dist/widgets/PeriodFilter.d.ts",
       "default": "./dist/widgets/PeriodFilter.js"
@@ -108,6 +116,10 @@
       "types": "./dist/widgets/RecordSheet.d.ts",
       "default": "./dist/widgets/RecordSheet.js"
     },
+    "./widgets/RoleMemberPicker": {
+      "types": "./dist/widgets/RoleMemberPicker.d.ts",
+      "default": "./dist/widgets/RoleMemberPicker.js"
+    },
     "./widgets/SearchableMultiPicker": {
       "types": "./dist/widgets/SearchableMultiPicker.d.ts",
       "default": "./dist/widgets/SearchableMultiPicker.js"