@j-solution/components 1.8.0 → 1.9.0

package/types/index.d.ts

@@ -285,10 +285,10 @@ defaultTheme: string;
 availableThemes: string[];
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLElement>;
 
-declare const __VLS_component_23: DefineComponent<__VLS_Props_37, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+declare const __VLS_component_23: DefineComponent<__VLS_Props_38, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 breadcrumbClick: (item: BreadcrumbItem, index: number) => any;
 titlebarButtonClick: (button: TitlebarButton) => any;
-}, string, PublicProps, Readonly<__VLS_Props_37> & Readonly<{
+}, string, PublicProps, Readonly<__VLS_Props_38> & Readonly<{
 onBreadcrumbClick?: ((item: BreadcrumbItem, index: number) => any) | undefined;
 onTitlebarButtonClick?: ((button: TitlebarButton) => any) | undefined;
 }>, {
@@ -299,14 +299,17 @@ showTitlebar: boolean;
 contentScroll: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-declare const __VLS_component_24: DefineComponent<__VLS_Props_39, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_39> & Readonly<{}>, {
+declare const __VLS_component_24: DefineComponent<__VLS_Props_40, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_40> & Readonly<{}>, {
 styletype: StyleType_29;
 contentScroll: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-declare const __VLS_component_25: DefineComponent<__VLS_Props_40, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_40> & Readonly<{}>, {
+declare const __VLS_component_25: DefineComponent<__VLS_Props_41, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+"menu-click": (item: SidebarMenuItem, event: MouseEvent) => any;
+}, string, PublicProps, Readonly<__VLS_Props_41> & Readonly<{
+"onMenu-click"?: ((item: SidebarMenuItem, event: MouseEvent) => any) | undefined;
+}>, {
 styletype: "default" | "minimal";
-permissions: MenuPermission[];
 menuItems: SidebarMenuItem[];
 contentScroll: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
@@ -858,9 +861,35 @@ declare type __VLS_Props_34 = {
     availableThemes?: string[];
 };
 
+/**
+ * JSidebar - 통합 사이드바 컴포넌트
+ *
+ * DB 트리 데이터 기반, provide/inject로 상태 공유.
+ * collapsed 모드, 검색, 즐겨찾기(localStorage) 지원.
+ * 라우터를 모름 — @menu-click으로 아이템을 올려보냄.
+ */
 declare type __VLS_Props_35 = {
+    /** 메뉴 트리 데이터 */
+    items: SidebarMenuItem[];
+    /** 접힘 상태 (v-model:collapsed) */
+    collapsed?: boolean;
+    /** 현재 활성 경로 */
+    activePath?: string;
+    /** 펼침 너비 */
+    width?: string;
+    /** 접힘 너비 */
+    collapsedWidth?: string;
+    /** 즐겨찾기 localStorage 키 (없으면 즐겨찾기 비활성) */
+    storageKey?: string;
+    /** 검색 표시 여부 */
+    showSearch?: boolean;
+    /** 즐겨찾기 섹션 표시 여부 */
+    showFavorites?: boolean;
+};
+
+declare type __VLS_Props_36 = {
     /** 메뉴 아이템 목록 */
-    menuItems: SidebarMenuItem[];
+    menuItems: SidebarMenuItem_2[];
     /** 권한 목록 */
     permissions?: MenuPermission[];
     /** 검색어 */
@@ -875,9 +904,9 @@ declare type __VLS_Props_35 = {
     isVisible?: boolean;
 };
 
-declare type __VLS_Props_36 = {
+declare type __VLS_Props_37 = {
     /** 메뉴 아이템 목록 */
-    menuItems: SidebarMenuItem[];
+    menuItems: SidebarMenuItem_2[];
     /** 권한 목록 */
     permissions?: MenuPermission[];
     /** 즐겨찾기 메뉴 키 목록 */
@@ -892,7 +921,7 @@ declare type __VLS_Props_36 = {
     isVisible?: boolean;
 };
 
-declare type __VLS_Props_37 = {
+declare type __VLS_Props_38 = {
     /** 브레드크럼 아이템 목록 */
     breadcrumbItems?: BreadcrumbItem[];
     /** 브레드크럼 표시 여부 */
@@ -913,9 +942,9 @@ declare type __VLS_Props_37 = {
     class?: string;
 };
 
-declare type __VLS_Props_38 = {
+declare type __VLS_Props_39 = {
     /** 트리 노드 데이터 */
-    items: SidebarMenuItem[];
+    items: SidebarMenuItem_2[];
     /** 펼쳐진 노드 키 목록 (v-model 지원, 배열) */
     expandedKeys?: (number | string)[];
     /** 현재 선택(하이라이트)된 노드의 menuKey (v-model 지원) */
@@ -932,15 +961,6 @@ declare type __VLS_Props_38 = {
     class?: string;
 };
 
-declare type __VLS_Props_39 = {
-    /** 레이아웃 스타일 타입 */
-    styletype?: StyleType_29;
-    /** 콘텐츠 영역 스크롤 가능 여부 */
-    contentScroll?: boolean;
-    /** 추가 CSS 클래스 */
-    class?: string;
-};
-
 declare type __VLS_Props_4 = {
     modelValue?: string;
     disabled?: boolean;
@@ -952,37 +972,28 @@ declare type __VLS_Props_4 = {
     styletype?: StyleType_4;
 };
 
+declare type __VLS_Props_40 = {
+    /** 레이아웃 스타일 타입 */
+    styletype?: StyleType_29;
+    /** 콘텐츠 영역 스크롤 가능 여부 */
+    contentScroll?: boolean;
+    /** 추가 CSS 클래스 */
+    class?: string;
+};
+
 /**
- * JLayoutSimple - Simple Sidebar + 일반 PageContainer 조합 템플릿 (templates)
- * Simple Layout Template
- *
- * @description
- * JLayout을 사용하는 Preset 템플릿입니다.
- * JHeader, JSidebarSimple, JPageContainer를 조합한 기본 레이아웃 예시를 제공합니다.
- *
- * 레이아웃 구조:
- * - header: 상단 헤더 영역 (슬롯)
- * - sidebar: 사이드바 영역 (슬롯)
- * - content: 메인 콘텐츠 영역 (슬롯, 기본 슬롯)
+ * JLayoutSimple - JSidebar + 일반 PageContainer 조합 템플릿
  *
  * @example
  * ```vue
- * <JLayoutSimple styletype="default" :content-scroll="true">
- *   <template #header>
- *     <JHeader logo-text="JWMS Portal" :user-name="userName" styletype="default" />
- *   </template>
- *   <template #sidebar>
- *     <JSidebarSimple :menu-items="menuItems" styletype="default" />
- *   </template>
+ * <JLayoutSimple :menu-items="menuItems" storage-key="my-app-favorites">
  *   <template #content>
- *     <JPageContainer title="재고 관리">
- *       <div>페이지 콘텐츠</div>
- *     </JPageContainer>
+ *     <RouterView />
  *   </template>
  * </JLayoutSimple>
  * ```
  */
-declare type __VLS_Props_40 = {
+declare type __VLS_Props_41 = {
     /** 레이아웃 스타일 타입 */
     styletype?: 'default' | 'minimal';
     /** 콘텐츠 영역 스크롤 가능 여부 */
@@ -991,8 +1002,10 @@ declare type __VLS_Props_40 = {
     class?: string;
     /** 메뉴 아이템 목록 */
     menuItems?: SidebarMenuItem[];
-    /** 권한 목록 */
-    permissions?: MenuPermission[];
+    /** 현재 활성 경로 */
+    activePath?: string;
+    /** 즐겨찾기 localStorage 키 */
+    storageKey?: string;
 };
 
 declare type __VLS_Props_5 = {
@@ -1289,11 +1302,11 @@ declare function __VLS_template_25(): {
     attrs: Partial<{}>;
     slots: {
         header?(_: {
-            isSidebarOpen: boolean;
+            isSidebarCollapsed: boolean;
             onSidebarToggle: () => void;
         }): any;
         sidebar?(_: {
-            isSidebarOpen: boolean;
+            isSidebarCollapsed: boolean;
         }): any;
         content?(_: {}): any;
         default?(_: {}): any;
@@ -3185,30 +3198,44 @@ declare interface JShuttleProps {
     class?: string;
 }
 
-export declare const JSidebarAdvanced: DefineComponent<__VLS_Props_36, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+export declare const JSidebar: DefineComponent<__VLS_Props_35, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+"update:collapsed": (value: boolean) => any;
+"menu-click": (item: SidebarMenuItem, event: MouseEvent) => any;
+}, string, PublicProps, Readonly<__VLS_Props_35> & Readonly<{
+"onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
+"onMenu-click"?: ((item: SidebarMenuItem, event: MouseEvent) => any) | undefined;
+}>, {
+width: string;
+collapsed: boolean;
+collapsedWidth: string;
+showSearch: boolean;
+showFavorites: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLElement>;
+
+export declare const JSidebarAdvanced: DefineComponent<__VLS_Props_37, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 menuClick: (event: MenuClickEvent) => any;
 favoriteChange: (menuKey: string | number | undefined, isFavorite: boolean) => any;
-}, string, PublicProps, Readonly<__VLS_Props_36> & Readonly<{
+}, string, PublicProps, Readonly<__VLS_Props_37> & Readonly<{
 onMenuClick?: ((event: MenuClickEvent) => any) | undefined;
 onFavoriteChange?: ((menuKey: string | number | undefined, isFavorite: boolean) => any) | undefined;
 }>, {
 width: string;
 styletype: StyleType_26;
 isVisible: boolean;
-permissions: MenuPermission[];
 favorites: (number | string)[];
+permissions: MenuPermission[];
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
-export declare const JSidebarSimple: DefineComponent<__VLS_Props_35, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+export declare const JSidebarSimple: DefineComponent<__VLS_Props_36, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 menuClick: (event: MenuClickEvent) => any;
-}, string, PublicProps, Readonly<__VLS_Props_35> & Readonly<{
+}, string, PublicProps, Readonly<__VLS_Props_36> & Readonly<{
 onMenuClick?: ((event: MenuClickEvent) => any) | undefined;
 }>, {
 width: string;
 styletype: StyleType_25;
 isVisible: boolean;
-permissions: MenuPermission[];
 searchQuery: string;
+permissions: MenuPermission[];
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 export declare const JSpinner: DefineComponent<__VLS_Props_16, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_16> & Readonly<{}>, {
@@ -3284,23 +3311,23 @@ closeButton: boolean;
 
 export declare const JTooltip: __VLS_WithTemplateSlots_6<typeof __VLS_component_6, __VLS_TemplateResult_6["slots"]>;
 
-export declare const JTree: DefineComponent<__VLS_Props_38, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+export declare const JTree: DefineComponent<__VLS_Props_39, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 expandChange: (menuKey: string | number | undefined, expanded: boolean) => any;
 nodeClick: (event: MenuClickEvent) => any;
 "update:expandedKeys": (keys: (string | number)[]) => any;
 "update:activeKey": (key: string | number | null) => any;
-}, string, PublicProps, Readonly<__VLS_Props_38> & Readonly<{
+}, string, PublicProps, Readonly<__VLS_Props_39> & Readonly<{
 onExpandChange?: ((menuKey: string | number | undefined, expanded: boolean) => any) | undefined;
 onNodeClick?: ((event: MenuClickEvent) => any) | undefined;
 "onUpdate:expandedKeys"?: ((keys: (string | number)[]) => any) | undefined;
 "onUpdate:activeKey"?: ((key: string | number | null) => any) | undefined;
 }>, {
 styletype: StyleType_28;
+searchQuery: string;
 permissions: MenuPermission[];
 expandedKeys: (number | string)[];
 maxDepth: number;
 activeKey: number | string | null;
-searchQuery: string;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
 declare type LabelPosition = 'right' | 'left' | 'top' | 'bottom';
@@ -3316,9 +3343,9 @@ declare type LanguageType = 'K' | 'E';
  */
 declare interface MenuClickEvent {
     /** 클릭된 메뉴 아이템 */
-    menuItem: SidebarMenuItem;
+    menuItem: SidebarMenuItem_2;
     /** 메뉴 경로 (부모 메뉴 포함) */
-    path: SidebarMenuItem[];
+    path: SidebarMenuItem_2[];
     /** 이벤트 객체 */
     event: MouseEvent;
 }
@@ -3334,6 +3361,13 @@ declare interface MenuPermission {
     permissionLevel: number;
 }
 
+/**
+ * JSidebar 타입 정의
+ * JSidebar Type Definitions
+ */
+/** 메뉴 타입: F=폴더(그룹), L=링크(페이지) */
+export declare type MenuType = 'F' | 'L';
+
 /**
  * 사이드바 메뉴 관련 타입 정의
  * Sidebar Menu Type Definitions
@@ -3343,7 +3377,7 @@ declare interface MenuPermission {
  * - 'F': Folder (폴더 - 하위 메뉴를 가지는 메뉴)
  * - 'L': Link (링크 - 실제 페이지로 이동하는 메뉴)
  */
-declare type MenuType = 'F' | 'L';
+declare type MenuType_2 = 'F' | 'L';
 
 export declare type NotificationItem = {
     /** 알림 ID */
@@ -3433,23 +3467,47 @@ declare interface ShuttleItem {
     [key: string]: any;
 }
 
+/**
+ * 사이드바 메뉴 아이템 (DB J_마스터_프로그램 트리 매핑)
+ */
+export declare interface SidebarMenuItem {
+    /** 프로그램 아이디 */
+    id: string;
+    /** 부모 아이디 */
+    parentId?: string;
+    /** 메뉴 표시 이름 */
+    label: string;
+    /** lucide 아이콘 이름 */
+    icon?: string;
+    /** 라우트 경로 (L 타입만) */
+    path?: string;
+    /** 메뉴 타입: F=폴더(그룹), L=링크(페이지) */
+    menuType: MenuType;
+    /** 정렬 순서 */
+    sortOrder?: number;
+    /** 하위 메뉴 (서버에서 트리로 변환) */
+    children?: SidebarMenuItem[];
+    /** 비활성화 여부 */
+    disabled?: boolean;
+}
+
 /**
  * 사이드바 메뉴 아이템
  * Sidebar Menu Item
  */
-declare interface SidebarMenuItem {
+declare interface SidebarMenuItem_2 {
     /** 메뉴 표시 이름 */
     label: string;
     /** 메뉴 아이콘 이름 (lucide-vue-next 아이콘 이름 또는 컴포넌트) */
     icon?: string;
     /** 메뉴 타입 (Folder/Link) */
-    menuType?: MenuType;
+    menuType?: MenuType_2;
     /** 메뉴 키 (권한 체크용) */
     menuKey?: number;
     /** 라우팅 경로 (menuType이 'L'일 때 사용) */
     path?: string;
     /** 하위 메뉴 목록 */
-    children?: SidebarMenuItem[];
+    children?: SidebarMenuItem_2[];
     /** 비활성화 여부 */
     disabled?: boolean;
     /** 추가 메타데이터 */

package/types/sidebar.types.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=Symbol("sidebar-state");exports.SIDEBAR_INJECTION_KEY=e;
+//# sourceMappingURL=sidebar.types.cjs.map

package/types/sidebar.types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.types.cjs","sources":["../../../src/types/sidebar.types.ts"],"sourcesContent":["/**\n * JSidebar 타입 정의\n * JSidebar Type Definitions\n */\n\n/** 메뉴 타입: F=폴더(그룹), L=링크(페이지) */\nexport type MenuType = 'F' | 'L'\n\n/**\n * 사이드바 메뉴 아이템 (DB J_마스터_프로그램 트리 매핑)\n */\nexport interface SidebarMenuItem {\n  /** 프로그램 아이디 */\n  id: string\n  /** 부모 아이디 */\n  parentId?: string\n  /** 메뉴 표시 이름 */\n  label: string\n  /** lucide 아이콘 이름 */\n  icon?: string\n  /** 라우트 경로 (L 타입만) */\n  path?: string\n  /** 메뉴 타입: F=폴더(그룹), L=링크(페이지) */\n  menuType: MenuType\n  /** 정렬 순서 */\n  sortOrder?: number\n  /** 하위 메뉴 (서버에서 트리로 변환) */\n  children?: SidebarMenuItem[]\n  /** 비활성화 여부 */\n  disabled?: boolean\n}\n\n/**\n * 사이드바 내부 상태 (provide/inject)\n */\nexport interface SidebarState {\n  /** 접힘 상태 */\n  collapsed: boolean\n  /** 현재 활성 경로 */\n  activePath: string | undefined\n  /** 즐겨찾기 id Set */\n  favorites: Set<string>\n  /** 즐겨찾기 토글 */\n  toggleFavorite: (id: string) => void\n}\n\n// Vue InjectionKey 타입을 위한 import\nimport type { InjectionKey } from 'vue'\n\n/** provide/inject 키 */\nexport const SIDEBAR_INJECTION_KEY = Symbol('sidebar-state') as InjectionKey<SidebarState>\n"],"names":["SIDEBAR_INJECTION_KEY"],"mappings":"gFAkDO,MAAMA,SAA+B,eAAe"}

package/types/sidebar.types.js

@@ -0,0 +1,5 @@
+const t = /* @__PURE__ */ Symbol("sidebar-state");
+export {
+  t as SIDEBAR_INJECTION_KEY
+};
+//# sourceMappingURL=sidebar.types.js.map

package/types/sidebar.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.types.js","sources":["../../../src/types/sidebar.types.ts"],"sourcesContent":["/**\n * JSidebar 타입 정의\n * JSidebar Type Definitions\n */\n\n/** 메뉴 타입: F=폴더(그룹), L=링크(페이지) */\nexport type MenuType = 'F' | 'L'\n\n/**\n * 사이드바 메뉴 아이템 (DB J_마스터_프로그램 트리 매핑)\n */\nexport interface SidebarMenuItem {\n  /** 프로그램 아이디 */\n  id: string\n  /** 부모 아이디 */\n  parentId?: string\n  /** 메뉴 표시 이름 */\n  label: string\n  /** lucide 아이콘 이름 */\n  icon?: string\n  /** 라우트 경로 (L 타입만) */\n  path?: string\n  /** 메뉴 타입: F=폴더(그룹), L=링크(페이지) */\n  menuType: MenuType\n  /** 정렬 순서 */\n  sortOrder?: number\n  /** 하위 메뉴 (서버에서 트리로 변환) */\n  children?: SidebarMenuItem[]\n  /** 비활성화 여부 */\n  disabled?: boolean\n}\n\n/**\n * 사이드바 내부 상태 (provide/inject)\n */\nexport interface SidebarState {\n  /** 접힘 상태 */\n  collapsed: boolean\n  /** 현재 활성 경로 */\n  activePath: string | undefined\n  /** 즐겨찾기 id Set */\n  favorites: Set<string>\n  /** 즐겨찾기 토글 */\n  toggleFavorite: (id: string) => void\n}\n\n// Vue InjectionKey 타입을 위한 import\nimport type { InjectionKey } from 'vue'\n\n/** provide/inject 키 */\nexport const SIDEBAR_INJECTION_KEY = Symbol('sidebar-state') as InjectionKey<SidebarState>\n"],"names":["SIDEBAR_INJECTION_KEY"],"mappings":"AAkDO,MAAMA,2BAA+B,eAAe;"}