ados-rcm 1.0.40 → 1.0.42

package/dist/AModule/AComponents/ADialog/ADialog.d.ts

@@ -1,30 +1,18 @@
 /// <reference types="react" />
 import { Resources } from '../AResource/AResource';
-import { IAEventCallers, TActionRef } from '../ATypes/ATypes';
+import { IAEvent, TActionRef } from '../ATypes/ATypes';
 /**
  * onOk와 ok의 네이밍 차이 : 해당 function이 Action임을 정의하는 기준을 고찰.
  * onAction은 callback으로 action이 수행될 때 호출된다. 따라서 기본적으로 onAction을 호출하는 곳은 action 한 곳 뿐이다.
  * 이와 다르게 action은 여러 곳에서 해당 action을 수행하고 싶을 때 호출할 수 있다. 만약 한 곳에서만 action을 호출하는 상황이라면 onAction을 사용하도록 한다.
  */
 export interface IADialogActions {
-    /**
-     * open : () => void
-     *
-     * Description : open dialog
-     */
-    open: () => void;
     /**
      * close : () => void
      *
      * Description : close dialog
      */
     close: () => void;
-    /**
-     * toggle : () => void
-     *
-     * Description : toggle dialog
-     */
-    toggle: () => void;
     /**
      * ok : () => void
      *
@@ -38,8 +26,17 @@ export interface IADialogActions {
      */
     cancel: () => void;
 }
+export interface IADialogChildren {
+    children?: React.ReactNode;
+}
 export type TADialogTypes = 'okCancel' | 'cancelOk' | 'ok' | 'cancel' | 'none';
 export interface IADialogProps {
+    /**
+     * setIsOpen : (isOpen: boolean) => void
+     *
+     * Description : setOpen of the dialog. it is used when the dialog is closed.
+     */
+    setIsOpen: (isOpen: boolean) => void;
     /**
      * type? : TADialogTypes = 'okCancel'
      *
@@ -77,47 +74,41 @@ export interface IADialogProps {
      */
     bodyStyle?: React.CSSProperties;
     /**
-     * onOk : (e: IAEventCallers) => void;
-     *
-     * Description : onOk of the dialog. it closes the dialog by default
-     */
-    onOk?: (e: IAEventCallers) => void;
-    /**
-     * onCancel : (e: IAEventCallers) => void;
+     * onOk : (e: IAEvent) => void;
      *
-     * Description : onCancel of the dialog. it closes the dialog by default
+     * Description : onOk of the dialog. it runs close by default
      */
-    onCancel?: (e: IAEventCallers) => void;
+    onOk?: (e: IAEvent) => void;
     /**
-     * onClose : (e: IAEventCallers) => void;
+     * onCancel : (e: IAEvent) => void;
      *
-     * Description : onClose of the dialog. it closes the dialog by default
+     * Description : onCancel of the dialog. it runs close by default
      */
-    onClose?: (e: IAEventCallers) => void;
+    onCancel?: (e: IAEvent) => void;
     /**
-     * onEnterPress : (e: IAEventCallers) => void;
+     * onEnterPress : (e: IAEvent) => void;
      *
      * Description : onEnterPress of the dialog. it runs ok by default
      */
-    onEnterPress?: (e: IAEventCallers) => void;
+    onEnterPress?: (e: IAEvent) => void;
     /**
-     * onEscPress : (e: IAEventCallers) => void;
+     * onEscPress : (e: IAEvent) => void;
      *
      * Description : onEscPress of the dialog. it runs cancel by default
      */
-    onEscPress?: (e: IAEventCallers) => void;
+    onEscPress?: (e: IAEvent) => void;
     /**
-     * onSpacePress : (e: IAEventCallers) => void;
+     * onSpacePress : (e: IAEvent) => void;
      *
      * Description : onSpacePress of the dialog. it runs ok by default
      */
-    onSpacePress?: (e: IAEventCallers) => void;
+    onSpacePress?: (e: IAEvent) => void;
     /**
-     * onPaperClick : (e: IAEventCallers) => void;
+     * onPaperClick : (e: IAEvent) => void;
      *
      * Description : onPaperClick of the dialog. it runs cancel by default
      */
-    onPaperClick?: (e: IAEventCallers) => void;
+    onPaperClick?: (e: IAEvent) => void;
     /**
      * noDim? : boolean = false
      *
@@ -163,19 +154,49 @@ export interface IADialogProps {
  *
  * Basic Usage :
  *
- *     const actionRef = useRef<IADialogActions>();
+ *     const [isOpen, setIsOpen] = useState(false);
  *     const onOk = () => { console.log('ok') }
- *     const onCancel = () => { console.log('cancel') }
+ *     const onCancel = (e : IAEvent) => {
+ *       e.event.preventDefault(); // this prevents the dialog from closing.
+ *       console.log('cancel')
+ *     }
  *
  *     if (case 1)
- *       <ADialog actionRef={actionRef}
- *         title='Dialog Title'
- *         onOk={onOk}
- *         onCancel={onCancel}>
- *         <div>Content</div>
- *       </ADialog>
- *       <AButton onClick={actionRef.current?.open}>Open</AButton>
- *       <AButton onClick={actionRef.current?.close}>Close</AButton>
+ *       <>
+ *         {isOpen &&
+ *           <ADialog setIsOpen={setIsOpen}
+ *             title='Dialog Title'
+ *             onOk={onOk}
+ *             onCancel={onCancel}>
+ *             <div>Content</div>
+ *           </ADialog>
+ *         }
+ *       </>
+ *
+ *     if (case 2)
+ *       <>
+ *         {isOpen &&
+ *           <DTest setIsOpen={setIsOpen}
+ *             onOk={onOk}
+ *             onCancel={onCancel}>
+ *           </DTest>
+ *         }
+ *       </>
+ *
+ *     const DTest = (props: IADialogProps) => {
+ *       let { setIsOpen, onOk, onCancel } = props;
+ *       const [num, setNum] = useState(0);
+ *       return (
+ *         <ADialog setIsOpen={setIsOpen}
+ *           title='Dialog Title'
+ *           onOk={onOk}
+ *           onCancel={onCancel}>
+ *           {num}
+ *           <AButton onClick={() => setNum(num + 1)}>Add</AButton>
+ *           <AButton onClick={() => setNum(num - 1)}>Sub</AButton>
+ *         </ADialog>
+ *       )
+ *     }
  *
  */
-export declare const ADialog: (props: IADialogProps) => import("react").ReactPortal | null;
+export declare const ADialog: (props: IADialogProps) => import("react").ReactPortal;

package/dist/AModule/AComponents/ATypes/ATypes.d.ts

@@ -27,13 +27,13 @@ export declare enum EDir12 {
 export declare function setDir12Style(anchorRef: React.RefObject<HTMLElement>, selfRef: React.RefObject<HTMLElement>, dir: EDir12): void;
 export type TActionRef<T> = React.MutableRefObject<T | null | undefined>;
 export type TIdx = number | string;
-export interface IAEvent {
+export interface IACalledEvent {
     preventDefault: boolean;
 }
-export interface IAEventCallers {
+export interface IAEvent {
     preventDefault: () => void;
 }
 export declare function createEvent(): {
-    event: IAEvent;
-    e: IAEventCallers;
+    event: IACalledEvent;
+    e: IAEvent;
 };