mushroom-cli 1.2.0-alpha.23 → 1.2.0-alpha.25

package/README.md

@@ -132,6 +132,34 @@ npx mushroom-cli parameters --no-check-update
 
 ## Version
 
+### 1.2.0-alpha.25
+
+Improvement:
+
+- gen c#-mongo
+  - support System.Text.Json on resources
+- gen api docs
+  - impove copy function
+  - allow collapse object fields
+  - display the description of entities
+
+Fixed bug:
+
+- gen api docs
+  - correct route for role \*
+
+### 1.2.0-alpha.24
+
+Improvement:
+
+- gen-docs
+  - Add `JavascriptParamModel`, `JavascriptRequestBodyModel`, `JavascriptResultModel` tab in code snippets of custom methods
+  - Correct generate query string and request body at HTTP and cURL tabs in code snippets of custom methods
+  - Correct generate param and body at Javascript tab in code snippets of custom methods
+  - Correct generate JavascriptModel in code snippets
+  - Add docs for `inline` mode of download file and zip file(s), `allowSmallerSize` for thumb
+  - Support link for Roles and Code Snippets
+
 ### 1.2.0-alpha.22
 
 Improvement:

package/dist/docs/docs.v2.html

@@ -74,6 +74,25 @@
             display: none;
         }
 
+        
+        .entity > .description {
+            display: none;
+        }
+        .entity h2:hover, .extension h2:hover {
+            background-color: #f5f5f5;
+            margin-left: calc(0px - var(--padding));
+            margin-right: calc(0px - var(--padding));
+            padding-left: var(--padding);
+            padding-right: var(--padding);
+        }
+            .entity h2 .description {
+                float: right;
+                font-size: 15px;
+            }
+        .entity .project-entity-actions, .extension .actions {
+            margin-top: var(--margin);
+        }
+
         .actions {
             padding-left: var(--padding);
             display: none;
@@ -88,6 +107,25 @@
             z-index: 100;
         }
 
+        .actions .panel-heading .copy, .entity h2 .copy {
+            display: none;
+            width: 16px;
+            height: 16px;
+            opacity: 0.8;
+            background-size: contain;
+            background-image: url(data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNTAiIGhlaWdodD0iNTAiIHZpZXdCb3g9IjAgMCA1MCA1MCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KICA8cmVjdCB4PSIxMCIgeT0iNSIgd2lkdGg9IjI1IiBoZWlnaHQ9IjMwIiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjUiIGZpbGw9Im5vbmUiIC8+CiAgPHJlY3QgeD0iMTgiIHk9IjEzIiB3aWR0aD0iMjUiIGhlaWdodD0iMzAiIHN0cm9rZT0id2hpdGUiIHN0cm9rZS13aWR0aD0iNSIgZmlsbD0ibm9uZSIgLz4KPC9zdmc+);
+        }
+        .entity h2 .copy {
+            filter: invert(1);
+            vertical-align: super;
+        }
+        .actions .panel-heading:hover .copy, .entity h2:hover .copy {
+            display: inline-block;
+            opacity: 1;
+        }
+        .actions .panel-heading .copy:hover, .entity h2 .copy:hover {
+            transform: scale(1.1);
+        }
         .actions .panel-heading .description {
             float: right;
         }
@@ -133,6 +171,26 @@
             font-weight: bold;
         }
 
+        pre .collapsable-field {
+            cursor: pointer;
+        }
+        pre .collapsable-field:hover {
+            text-decoration: underline;
+        }
+        pre .collapsable-field.collapsed {
+            display: inline-block;
+        }
+            pre .collapsable-field.collapsed::before {
+                content: ">";
+                text-decoration: none;
+                display: inline-block;
+                margin-right: 1px;
+                margin-left: -9px;
+            }
+        pre .collapsed {
+            display: none;
+        }
+
         pre[data-language] {
             position: relative;
         }
@@ -167,11 +225,23 @@
             h2 {
                 font-size: 26px;
             }
+            .entity > .description {
+                display: block;
+            }
+            .entity h2 .description {
+                display: none;
+            }
             .actions .panel-heading .description {
                 float: none;
                 display: block;
                 opacity: 0.8;
             }
+            .nav.nav-tabs {
+                top: 121px;
+            }
+            .tab-pages .nav-tabs {
+                top: 164px;
+            }
         }
 
         #project-rootUrls li label {
@@ -479,7 +549,8 @@
         <div class="panel panel-info" id="extension-auth-login">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$auth.login">
                 <span>POST</span>
-                <span class="root-url">{{rootUrl}}</span>auth/login
+                <span class="url"><span class="root-url">{{rootUrl}}</span>auth/login</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Đăng nhập</span>
             </div>
             <div class="panel-body">
@@ -685,7 +756,8 @@ API.getAuthentication().loginAsync("your account", "your password", loginResult
         <div class="panel panel-primary" id="extension-auth-logout">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$auth.logout">
                 <span>GET</span>
-                <span class="root-url">{{rootUrl}}</span>auth/logout
+                <span class="url"><span class="root-url">{{rootUrl}}</span>auth/logout</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Đăng xuất</span>
             </div>
             <div class="panel-body">
@@ -849,7 +921,8 @@ API.getAuthentication().logoutAsync(logoutMode, () -> {
         <div class="panel panel-primary" id="extension-auth-status">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$auth.status">
                 <span>GET</span>
-                <span class="root-url">{{rootUrl}}</span>auth/status
+                <span class="url"><span class="root-url">{{rootUrl}}</span>auth/status
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Truy vấn trạng thái token</span>
             </div>
             <div class="panel-body">
@@ -995,7 +1068,8 @@ API.getAuthentication().statusAsync(loginStatus -> {
         <div class="panel panel-primary" id="extension-auth-me">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$auth.me">
                 <span>GET</span>
-                <span class="root-url">{{rootUrl}}</span>auth/me
+                <span class="url"><span class="root-url">{{rootUrl}}</span>auth/me</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Lấy về thông tin người dùng hiện tại</span>
             </div>
             <div class="panel-body">
@@ -1144,7 +1218,8 @@ API.getAuthentication().meAsync(user -> {
         <div class="panel panel-info" id="extension-auth-register">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$auth.register">
                 <span>POST</span>
-                <span class="root-url">{{rootUrl}}</span>auth/register
+                <span class="url"><span class="root-url">{{rootUrl}}</span>auth/register</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Đăng ký tài khoản</span>
             </div>
             <div class="panel-body">
@@ -1324,7 +1399,8 @@ API.getAuthentication().registerAsync("your account", "your password", registerR
         <div class="panel panel-info" id="extension-auth-activate">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$auth.activate">
                 <span>POST</span>
-                <span class="root-url">{{rootUrl}}</span>auth/activate
+                <span class="url"><span class="root-url">{{rootUrl}}</span>auth/activate</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Kích hoạt tài khoản</span>
             </div>
             <div class="panel-body">
@@ -1483,7 +1559,8 @@ API.getAuthentication().activateAsync("your account", "activation code", id -> {
         <div class="panel panel-info" id="extension-auth-recover_password">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$auth.recover_password">
                 <span>POST</span>
-                <span class="root-url">{{rootUrl}}</span>auth/recover-password
+                <span class="url"><span class="root-url">{{rootUrl}}</span>auth/recover-password</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Lấy lại mật khẩu</span>
             </div>
             <div class="panel-body">
@@ -1636,7 +1713,8 @@ API.getAuthentication().recoverPasswordAsync("your account", id -> {
         <div class="panel panel-info" id="extension-auth-reset_password">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$auth.reset_password">
                 <span>POST</span>
-                <span class="root-url">{{rootUrl}}</span>auth/reset-password
+                <span class="url"><span class="root-url">{{rootUrl}}</span>auth/reset-password</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Khôi phục mật khẩu / Đổi mật khẩu</span>
             </div>
             <div class="panel-body">
@@ -1905,7 +1983,8 @@ API.getAuthentication().changePasswordAsync("your account", "your old password",
         <div class="panel panel-info" id="extension-file-upload">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$file.upload">
                 <span>POST</span>
-                <span class="root-url">{{rootUrl}}</span>file/upload
+                <span class="url"><span class="root-url">{{rootUrl}}</span>file/upload</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Upload file</span>
             </div>
             <div class="panel-body">
@@ -2093,7 +2172,8 @@ API.fileExtension().uploadAsync(file, uploadResult -> {
         <div class="panel panel-primary" id="extension-file-download">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$file.download">
                 <span>GET</span>
-                <span class="root-url">{{rootUrl}}</span>file/download
+                <span class="url"><span class="root-url">{{rootUrl}}</span>file/download</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Download file</span>
             </div>
             <div class="panel-body">
@@ -2101,6 +2181,7 @@ API.fileExtension().uploadAsync(file, uploadResult -> {
                     <h4>Query string</h4>
                     <ul>
                         <li>id: string, required - Mã của file cần download</li>
+                        <li>inline: boolean, optional - Cho biết có download ở chế độ inline hay không. Xem thêm tại <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition" target="_blank">Content-Disposition</a></li>
                     </ul>
                 </div>
                 <div>
@@ -2128,6 +2209,11 @@ Content-Range: byte {realStartIndex}-{realEndIndex}/{totalLength}
                 </div>
                 <div class="js-driver-snippet">
                     <h4>Mẫu javascript</h4>
+                    Lấy về link download file
+                    <pre>mushroom.$file.getDownloadLink("your file id");</pre>
+                    Tùy biến lấy về link download inline mode
+                    <pre>mushroom.$file.linkBuilder.download.id("your file id").inline().build();</pre>
+                    Download file trên trình duyệt
                     <pre>mushroom.$file.download("your file id");</pre>
                 </div>
             </div>
@@ -2135,7 +2221,8 @@ Content-Range: byte {realStartIndex}-{realEndIndex}/{totalLength}
         <div class="panel panel-primary" id="extension-file-thumb">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$file.thumb">
                 <span>GET</span>
-                <span class="root-url">{{rootUrl}}</span>file/thumb
+                <span class="url"><span class="root-url">{{rootUrl}}</span>file/thumb</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Download image thumbnail</span>
             </div>
             <div class="panel-body">
@@ -2209,6 +2296,13 @@ Content-Range: byte {realStartIndex}-{realEndIndex}/{totalLength}
                                 <li>rotate270 - xoay ảnh 270 độ</li>
                             </ul>
                         </li>
+                        <li>
+                            o: string, optional, chỉ định các tùy chọn, nhận một trong các giá trị sau, có thể áp dụng nhiều tùy chọn, phân cách nhau bởi dấu phải
+                            <ul>
+                                <li>allow-smaller-size - cho phép sinh ảnh bé hơn kích thước quy định nếu ảnh gốc bé</li>
+                                <li>disable-cache - không sử dụng cache server mà yêu cầu sinh ảnh thumb mới</li>
+                            </ul>
+                        </li>
                     </ul>
                 </div>
                 <div>
@@ -2233,23 +2327,28 @@ Last-Modified: {datetime}</pre>
                             <div class="js-driver-snippet">
                                 <pre data-language="javascript">const imgSrc = mushroom.$file.linkBuilder.thumb
     .id(fileId) <span class="code-comment">// required
-    // .stretch(width, height)
-    // .square(size)
-    // .zoom(width, height, backgroundColor) // backgroundColor: optional, default: transparent, valid values: transparent | [0-9a-fA-F]{6}
-    // .x(width)
-    // .y(height)
-    // .clip(150, 75, "top", "left") 
-    // // .clip(width, height, verticalAlign, horizontalAlign)
-    // //     verticalAlign: optional, default: middle, valid values: top | middle | bottom
-    // //     horizontalAlign: optional, default: center, valid values: left | center | right
+    // .stretch(width, height) // width: gt 0; height: gt 0
+    // .square(size) // size: gt 0
+    // .zoom(width, height, backgroundColor)
+    //      width: gt: 0
+    //      height: gt 0
+    //      backgroundColor: optional, default: transparent, valid values: transparent | [0-9a-fA-F]{6}
+    // .x(width) // width: gt 0
+    // .y(height) // height: gt 0
+    // .clip(width, height, verticalAlign, horizontalAlign)
+    //      width: gt 0
+    //      height: gt 0
+    //      verticalAlign: optional, default: middle, valid values: top | middle | bottom
+    //      horizontalAlign: optional, default: center, valid values: left | center | right
     // .rotate90()
     // .rotate180()
     // .rotate270()
     // .flipVertical()
     // .flipHorizontal()
-    // .transparent(50) // value: from 0 to 255
+    // .transparent(value) // value: from 0 to 255
     // .grayscale()
-    // .format("png") // outputFormat: source | jpg | png | gif | webp | auto</span>
+    // .allowSmallerSize()
+    // .format(outputFormat) // outputFormat: source | jpg | png | gif | webp | auto</span>
     .build();</pre>
                             </div>
                         </div>
@@ -2321,7 +2420,8 @@ Tạo hiệu ứng đen trắng: &lt;img src="<span class="root-url">{{rootUrl}}
         <div class="panel panel-primary" id="extension-file-zip">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$file.zip">
                 <span>GET</span>
-                <span class="root-url">{{rootUrl}}</span>file/zip
+                <span class="url"><span class="root-url">{{rootUrl}}</span>file/zip</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Download zip file</span>
             </div>
             <div class="panel-body">
@@ -2330,6 +2430,7 @@ Tạo hiệu ứng đen trắng: &lt;img src="<span class="root-url">{{rootUrl}}
                     <ul>
                         <li>id: string, required, danh sách mã các file cần zip, các mã file được phân cách bởi dấu phảy (,)</li>
                         <li>name: string, optional, tên file zip khi download. Mặc định là "No name.zip"</li>
+                        <li>inline: boolean, optional - Cho biết có download ở chế độ inline hay không. Xem thêm tại <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition" target="_blank">Content-Disposition</a></li>
                     </ul>
                 </div>
                 <div>
@@ -2343,7 +2444,14 @@ Content-Disposition: attachment; filename="{name}"</pre>
                 </div>
                 <div class="js-driver-snippet">
                     <h4>Mẫu javascript</h4>
-                    <pre>mushroom.$file.zip(["your file id 1", "your file id 2"]);</pre>
+                    Lấy về link download zip file
+                    <pre>mushroom.$file.getZipLink("your file id 1", "your file id 2");</pre>
+                    Tùy biến lấy về link download zip file với chế độ inline
+                    <pre>mushroom.$file.linkBuilder.zip.add("your file id 1", "your file id 2").inline().build();</pre>
+                    Tùy biến lấy về link download zip file chỉ định tên file
+                    <pre>mushroom.$file.linkBuilder.zip.add("your file id 1", "your file id 2").attachment("file-name.zip").build();</pre>
+                    Download zip file trên trình duyệt
+                    <pre>mushroom.$file.zip("your file id 1", "your file id 2");</pre>
                 </div>
             </div>
         </div>
@@ -2355,7 +2463,8 @@ Content-Disposition: attachment; filename="{name}"</pre>
         <div class="panel panel-info" id="extension-mailing-sent">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$mailing.sent">
                 <span>POST</span>
-                <span class="root-url">{{rootUrl}}</span>mailing/sent
+                <span class="url"><span class="root-url">{{rootUrl}}</span>mailing/sent</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Tạo lệnh gửi mail</span>
             </div>
             <div class="panel-body">
@@ -2480,7 +2589,8 @@ try {
         <div class="panel panel-primary" id="extension-mailing-get">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$mailing.get">
                 <span>GET</span>
-                <span class="root-url">{{rootUrl}}</span>mailing/get
+                <span class="url"><span class="root-url">{{rootUrl}}</span>mailing/get</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Lấy thông tin lệnh gửi mail</span>
             </div>
             <div class="panel-body">
@@ -2563,7 +2673,8 @@ catch (error) {
         <div class="panel panel-danger" id="extension-mailing-discard">
             <div class="panel-heading" onclick="toggleParentClass.call(this)" data-toggled-class="show" data-hash="$mailing.discard">
                 <span>DELETE</span>
-                <span class="root-url">{{rootUrl}}</span>mailing/discard
+                <span class="url"><span class="root-url">{{rootUrl}}</span>mailing/discard</span>
+                <span class="copy" title="Copy" data-copy=".url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">Hủy lệnh gửi mail</span>
             </div>
             <div class="panel-body">
@@ -2668,7 +2779,12 @@ catch (error) {
 
 <div class="mushroom-docs-template" id="template-project-entity">
     <div class="entity" id="entity-{{name}}">
-        <h2 data-hash="{{name}}" onclick="renderEntity.call(this, '{{name}}'); toggleParentClass.call(this)" data-toggled-class="expand">{{name}}</h2>
+        <h2 data-hash="{{name}}" onclick="renderEntity.call(this, '{{name}}'); toggleParentClass.call(this)" data-toggled-class="expand">
+            <span class="entity-name">{{name}}</span>
+            <span class="copy" title="Copy" data-copy=".entity-name" onclick="doCopy.call(this, event)"></span>
+            <div class="description">{{description}}</div>
+        </h2>
+        <div class="description">{{description}}</div>
         <div class="project-entity-actions"></div>
         <div class="project-entity-views"></div>
     </div>
@@ -2679,6 +2795,7 @@ catch (error) {
             <div class="panel-heading" onclick="renderEntityAction.call(this, '{{entityName}}', '{{actionName}}'); toggleParentClass.call(this)" data-toggled-class="show" data-hash="{{entityName}}.{{actionName}}">
                 {{actionHttpMethod}}
                 <span class="contain-root-url">{{actionApiUrl}}</span>
+                <span class="copy" title="Copy" data-copy=".contain-root-url" onclick="doCopy.call(this, event)"></span>
                 <span class="description">{{actionDescription}}</span>
             </div>
             <div class="panel-body">
@@ -2689,7 +2806,7 @@ catch (error) {
     </div>
 </div>
 <div class="mushroom-docs-template" id="template-project-entity-action-role">
-    <li role="presentation"><a onclick="renderEntityActionRolePage.call(this, '{{entityName}}', '{{actionName}}', '{{grant}}'); activeRoleTab.call(this)" data-role="{{grant}}">{{explainedRole}}</a></li>
+    <li role="presentation"><a onclick="renderEntityActionRolePage.call(this, '{{entityName}}', '{{actionName}}', '{{grant}}'); activeRoleTab.call(this)" data-hash="{{entityName}}.{{actionName}}/{{grant}}" data-role="{{grant}}">{{explainedRole}}</a></li>
 </div>
 <div class="mushroom-docs-template" id="template-project-entity-action-page">
     <div class="tab-page" data-role="{{grant}}"></div>
@@ -2733,9 +2850,9 @@ catch (e) {
         Tùy biến tham số
         <pre data-language="javascript">try {
     const response = await mushroom.{{entityName}}.listAsync({
-        fields: "<span class="separated-items">{{fields:html}}</span>",
-        filters: ["your filter 1", "your filter 2"], // <i>or</i> "your filters" ,<span style="display: {{allowSortingsDisplay}}">
-        sort: "<span class="separated-items">{{sortFields:html}}</span>",</span>
+        fields: "<span class="separated-items">{{fields:html}}</span>", <span class="code-comment">// nên sử dụng builder dạng Project.include('a', 'b').build()</span>
+        filters: ["your filter 1", "your filter 2"], <span class="code-comment">// nên sử dụng builder dạng Filter.eq('a', 1).gte('b', 2).build()</span><span style="display: {{allowSortingsDisplay}}">
+        sort: "<span class="separated-items">{{sortFields:html}}</span>", <span class="code-comment">// nên sử dụng builder dạng Sort.ascending('a').thenByAscending('b').build()</span></span>
 <span style="display: {{limitDisplay}}">        limit: 25,
 </span><span style="display: {{offsetDisplay}}">        offset: 0,
 </span><span style="display: {{pageDisplay}}">        page: 1,
@@ -4153,8 +4270,7 @@ catch (Exception ex)
     <div class="http-snippet">
         Xóa nhật một {{entityName}}
         <pre data-language="http">DELETE {{rootUrlPath}}{{entityName}}s/<span class="place-holder">id</span> HTTP/1.1
-Host: <span class="domain">{{domain}}</span>
-Content-Type: application/json<span style="display: {{tokenDisplay}}">
+Host: <span class="domain">{{domain}}</span><span style="display: {{tokenDisplay}}">
 Token: your token</span></pre>
     </div>
 </script>
@@ -4162,8 +4278,7 @@ Token: your token</span></pre>
     <div class="curl-snippet">
         cURL
         <pre data-language="cURL">curl -X DELETE \
-  '<span class="root-url">{{rootUrl}}</span>{{entityName}}s/<span class="place-holder">id</span>' \
-  -H 'Content-Type: application/json' \ <span style="display: {{tokenDisplay}}">
+  '<span class="root-url">{{rootUrl}}</span>{{entityName}}s/<span class="place-holder">id</span>' \<span style="display: {{tokenDisplay}}">
   -H 'Token: {<span>{</span>TOKEN}}' \</span></pre>
         Shell
         <pre data-language="cURL">curl --request DELETE \
@@ -4389,12 +4504,8 @@ API.get{{EntityName}}().deleteAsync(arg, count -> {
         Code tham khảo:
         <pre data-language="javascript">try {
     const response = await mushroom.{{entityName}}.{{httpMethod}}Async({<span style="display: {{paramDisplay}}">
-        params: {
-            <span class="code-comment">// parameters here</span>
-        },</span><span style="display: {{bodyDisplay}}">
-        body: {
-            <span class="code-comment">// request body here</span>
-        }</span>
+        params: {{paramModel:html}},</span><span style="display: {{bodyDisplay}}">
+        body: {{bodyModel:html}}</span>
     });
     console.log("Kết quả trả về, response: %o", response);
 } catch (error) {
@@ -4402,6 +4513,16 @@ API.get{{EntityName}}().deleteAsync(arg, count -> {
 }</pre>
     </div>
 </script>
+<script type="text/mushroom-docs-template" class="mushroom-docs-template" id="template-codeSnippets-generalAction-JavascriptModel">
+    <div class="js-model-snippet">
+        Javascript UNDEFINED model
+        <pre data-language="json">{{undefinedModel:html}}</pre>
+        Javascript VALUE model
+        <pre data-language="json">{{valueModel:html}}</pre>
+        Javascript NULL model
+        <pre data-language="json">{{nullModel:html}}</pre>
+    </div>
+</script>
 <div class="mushroom-docs-template" id="template-codeSnippets-generalAction-CSharp">
     <div class="csharp-driver-snippet">
         <p>Hỗ trợ: DotNet Framework 4.5+, DotNet Core 3.1+, Unity3D, Mono</p>
@@ -4424,31 +4545,30 @@ catch (Exception ex)
 <script type="text/mushroom-docs-template" class="mushroom-docs-template" id="template-codeSnippets-generalAction-HTTP">
     <div class="http-snippet">
         Code tham khảo:
-        <pre data-language="http">POST {{rootUrlPath}}{{entityName}}s/{{httpMethod}}<span class="place-holder">?param1=value1&amp;param2=value2</span> HTTP/1.1
+        <pre data-language="http">POST {{rootUrlPath}}{{entityName}}s/{{httpMethod}}{{queryString}} HTTP/1.1
 Host: <span class="domain">{{domain}}</span>
 Content-Type: application/json
 X-HTTP-Method-Override: {{httpMethod}}<span style="display: {{tokenDisplay}}">
 Token: your token</span>
 
-<span class="place-holder">BODY DATA IF ANY</span></pre>
+{{bodyModel:html}}</pre>
     </div>
 </script>
 <script type="text/mushroom-docs-template" class="mushroom-docs-template" id="template-codeSnippets-generalAction-cURL">
     <div class="curl-snippet">
         cURL
         <pre data-language="cURL">curl -X POST \
-  '<span class="root-url">{{rootUrl}}</span>{{entityName}}s/{{httpMethod}}<span class="place-holder">?param1=value1&amp;param2=value2</span>' \
+  '<span class="root-url">{{rootUrl}}</span>{{entityName}}s/{{httpMethod}}{{queryString}}' \
   -H 'Content-Type: application/json' \
   -H 'X-HTTP-Method-Override: {{httpMethod}}' \<span style="display: {{tokenDisplay}}">
   -H 'Token: {<span>{</span>TOKEN}}' \</span>
-  -d 'BODY DATA IF ANY'
-</pre>
+  -d '{{bodyModel:html}}'</pre>
         Shell
         <pre data-language="cURL">curl --request POST \
-  --url '<span class="root-url">{{rootUrl}}</span>{{entityName}}s/{{httpMethod}}<span class="place-holder">?param1=value1&amp;param2=value2</span>' \
+  --url '<span class="root-url">{{rootUrl}}</span>{{entityName}}s/{{httpMethod}}{{queryString}}' \
   --header 'X-HTTP-Method-Override: {{httpMethod}}' \<span style="display: {{tokenDisplay}}">
   --header 'Token: {<span>{</span>TOKEN}}' \</span>
-  --data 'BODY DATA IF ANY'</pre>
+  --data '{{bodyModel:html}}'</pre>
     </div>
 </script>
 <div class="mushroom-docs-template" id="template-codeSnippets-generalAction-Java">
@@ -4989,7 +5109,7 @@ API.get{{EntityName}}().getViews().{{viewName}}Async(arg, result -> {
     </div>
     <div class="query-string">
         <h4>Query string</h4>
-        <pre class="query-string-model"></pre>
+        <ul class="parameters-list"></ul>
     </div>
     <div class="request-body">
         <h4>Request body</h4>
@@ -5025,7 +5145,7 @@ API.get{{EntityName}}().getViews().{{viewName}}Async(arg, result -> {
 </div>
 <div class="mushroom-docs-template" id="template-view-parameters">
     <li>
-        <b>{{field}}</b>: {{type}}, {{required}}{{defaultValue}} - {{description}}
+        <b>{{field}}</b>: {{type}}, {{required}}{{defaultValue}}, {{description}}
     </li>
 </div>
 <div class="mushroom-docs-template" id="template-view">

package/dist/docs/docs.v2.js

@@ -182,6 +182,7 @@ function getModelOutput(arrFields, fields, options) {
 
   return formatModel(obj, '', options).trim();
 }
+let __field_idx = 0;
 function formatModel(obj, strIndent, options) {
   if (!obj) return '';
 
@@ -270,7 +271,7 @@ function formatModel(obj, strIndent, options) {
             ' ' +
             comment +
             `\r\n${nextIndent}`;
-        result += `]`;
+        result += '],';
       } else if (child.type === 'datetime')
         result +=
           `\r\n${nextIndent}"${m}": ` + JSON.stringify(child.defaultValue || 'ISODate_ISO_8601') + ', ' + comment;
@@ -281,7 +282,7 @@ function formatModel(obj, strIndent, options) {
       else result += `\r\n${nextIndent}"${m}": ` + JSON.stringify(child.defaultValue || child.type) + ', ' + comment;
     } else if (options.mode === 'model_null') {
       if (child.type === 'object')
-        result += '\r\n' + nextIndent + '"' + m + '": ' + comment + formatModel(child.fields, nextIndent, options);
+        result += '\r\n' + nextIndent + '"' + m + '": ' + comment + formatModel(child.fields, nextIndent, options) + ',';
       else if (child.type === 'array') {
         result += `\r\n${nextIndent}"${m}": [`;
         if (child.items.type === 'object')
@@ -290,7 +291,7 @@ function formatModel(obj, strIndent, options) {
       } else result += `\r\n${nextIndent}"${m}": null, ${comment}`;
     } else if (options.mode === 'model_undefined') {
       if (child.type === 'object')
-        result += '\r\n' + nextIndent + '"' + m + '": ' + comment + formatModel(child.fields, nextIndent, options);
+        result += '\r\n' + nextIndent + '"' + m + '": ' + comment + formatModel(child.fields, nextIndent, options) + ',';
       else if (child.type === 'array') {
         result += `\r\n${nextIndent}"${m}": [`;
         if (child.items.type === 'object')
@@ -298,11 +299,13 @@ function formatModel(obj, strIndent, options) {
         else result += '], ' + comment;
       } else result += `\r\n${nextIndent}"${m}": undefined, ${comment}`;
     } else {
-      result += '\r\n' + strIndent + encodeHtml(m) + ': ' + encodeHtml(child.type);
+      const fieldIdx = 'f_' + __field_idx.toString(36);
+      __field_idx++;
+      result += '\r\n' + strIndent + (child.type === 'object' || child.type === 'array' && child.items.type === 'object' ? '<span class="collapsable-field" data-field-idx="' + fieldIdx + '" onclick="collapseThisField(this)">' + encodeHtml(m) + '</span>' : encodeHtml(m)) + ': ' + encodeHtml(child.type);
       if (child.type === 'array') result += child.items.type === 'object' ? ' of object' : ' of ' + child.items.type;
-      if (child.type === 'object') result += ' ' + comment + formatModel(child.fields, strIndent + '    ', options);
+      if (child.type === 'object') result += ' ' + comment + '<span id="' + fieldIdx + '">' + formatModel(child.fields, strIndent + '    ', options) + '</span>';
       else if (child.type === 'array' && child.items.type === 'object')
-        result += ' ' + comment + formatModel(child.items.fields, strIndent + '    ', options);
+        result += ' ' + comment + '<span id="' + fieldIdx + '">' + formatModel(child.items.fields, strIndent + '    ', options) + '</span>';
       else result += ', ' + comment;
     }
   }
@@ -313,6 +316,10 @@ function formatModel(obj, strIndent, options) {
 
   return result;
 }
+function collapseThisField(dom) {
+  dom.classList.toggle('collapsed');
+  document.getElementById(dom.dataset.fieldIdx).classList.toggle('collapsed');
+}
 function toCachePolicyString(cachePolicy) {
   if (cachePolicy === undefined || cachePolicy === null || cachePolicy === 'unset') return 'Không thiết lập cấu hình';
   if (cachePolicy === 'required') return 'Bắt buộc phải cache';
@@ -387,7 +394,7 @@ function formatHintModel(obj, strIndent, options) {
         validation += ', enum(' + encodeHtml(child.items.validValues.join(', ')) + ')';
     }
 
-    var comment = `<span class="code-comment">// ${validation} ${typeof child.description === 'string' && child.description !== '' ? '- ' + encodeHtml(child.description).replace(/\n/g, ' ') : ''}</span>`;
+    var comment = options.hideComment ? '' : `<span class="code-comment">// ${validation} ${typeof child.description === 'string' && child.description !== '' ? '- ' + encodeHtml(child.description).replace(/\n/g, ' ') : ''}</span>`;
 
     if (options.mode === 'model') {
       if (child.type === 'object')
@@ -415,7 +422,7 @@ function formatHintModel(obj, strIndent, options) {
             ' ' +
             comment +
             `\r\n${nextIndent}`;
-        result += `]`;
+        result += '],';
       } else if (child.type === 'datetime')
         result +=
           `\r\n${nextIndent}"${m}": ` + JSON.stringify(child.defaultValue || 'ISODate_ISO_8601') + ', ' + comment;
@@ -426,7 +433,7 @@ function formatHintModel(obj, strIndent, options) {
       else result += `\r\n${nextIndent}"${m}": ` + JSON.stringify(child.defaultValue || child.type) + ', ' + comment;
     } else if (options.mode === 'model_null') {
       if (child.type === 'object')
-        result += '\r\n' + nextIndent + '"' + m + '": ' + comment + formatHintModel(child.fields, nextIndent, options);
+        result += '\r\n' + nextIndent + '"' + m + '": ' + comment + formatHintModel(child.fields, nextIndent, options) + ',';
       else if (child.type === 'array') {
         result += `\r\n${nextIndent}"${m}": [`;
         if (child.items.type === 'object')
@@ -435,7 +442,7 @@ function formatHintModel(obj, strIndent, options) {
       } else result += `\r\n${nextIndent}"${m}": null, ${comment}`;
     } else if (options.mode === 'model_undefined') {
       if (child.type === 'object')
-        result += '\r\n' + nextIndent + '"' + m + '": ' + comment + formatHintModel(child.fields, nextIndent, options);
+        result += '\r\n' + nextIndent + '"' + m + '": ' + comment + formatHintModel(child.fields, nextIndent, options) + ",";
       else if (child.type === 'array') {
         result += `\r\n${nextIndent}"${m}": [`;
         if (child.items.type === 'object')
@@ -490,7 +497,8 @@ function renderInfo() {
   let selected = localStorage.selected_root_url;
   if (!selected) selected = localStorage.selected_root_url = window.docs.info.rootUrl;
   const onspanclick = function () {
-    this.parentNode.parentNode.querySelector('.selected').className = '';
+    const domSelected = this.parentNode.parentNode.querySelector('.selected');
+    if (domSelected) domSelected.className = '';
     selected = this.innerText;
     this.className = 'selected';
     const old_root_url = localStorage.selected_root_url;
@@ -745,20 +753,28 @@ function renderEntityActionRolePage(entityName, actionName, grant) {
     domain: getApiDomain(localStorage.selected_root_url),
     rootUrlPath: getApiPath(localStorage.selected_root_url),
   };
-  const snippet = window.codeSnippets[codeSnippetName] ?? {};
+  const snippets = window.codeSnippets[codeSnippetName] 
+    ? Object.keys(window.codeSnippets[codeSnippetName]).map((lang) => {
+      return {
+        lang: lang,
+        html: window.codeSnippets[codeSnippetName][lang]?.call(null, args)
+      }
+    }).filter(item => item.html) 
+    : [];
+
   const data = {
     explainedDenyRoles: explainRoles(action.deny),
     entityName,
-    codeSnippetTabHeaders: Object.keys(snippet)
+    codeSnippetTabHeaders: snippets
       .map(
-        (lang, idx) =>
-          `<li role="presentation" ${idx ? '' : 'class="active"'}><a data-role="${lang}" onclick="activeRoleTab.call(this)">${lang}</a></li>`,
+        (item, idx) =>
+          `<li role="presentation" ${idx ? '' : 'class="active"'}><a data-role="${item.lang}" onclick="activeRoleTab.call(this)" data-hash="${entityName}.${actionName}/${grant}/${item.lang}">${item.lang}</a></li>`,
       )
       .join(''),
-    codeSnippetTabPages: Object.keys(snippet)
+    codeSnippetTabPages: snippets
       .map(
-        (lang, idx) =>
-          `<div class="tab-page ${lang} ${idx ? '' : 'active'}" data-role="${lang}">${snippet[lang]?.call(null, args) ?? ''}</div>`,
+        (item, idx) =>
+          `<div class="tab-page ${item.lang} ${idx ? '' : 'active'}" data-role="${item.lang}">${item.html}</div>`,
       )
       .join(''),
     EntityName: args.EntityName,
@@ -1005,9 +1021,16 @@ function renderDeleteMany(args) {}
 
 function renderGeneralAction(args) {
   if (args.action?.codeHint?.delegator?.param?.fields) {
-    args.tabPage.querySelector('.query-string-model').innerHTML = formatHintModel(
-      args.action.codeHint.delegator.param.fields,
-    ).trim();
+    args.tabPage.querySelector('.parameters-list').innerHTML = Object.keys(args.action.codeHint.delegator.param.fields)
+    .map((m) => {
+      const field = args.action.codeHint.delegator.param.fields[m];
+      return renderTemplate('template-view-parameters', {
+        field: m,
+        type: (field.type === 'array' ? 'array of ' : '') + (field.items?.type ?? 'string'),
+        description: field.description ?? '',
+        required: field.required ? 'required' : 'optional',
+      })
+    }).join('');
   } else {
     args.tabPage.querySelector('.query-string')?.remove();
   }
@@ -1022,7 +1045,6 @@ function renderGeneralAction(args) {
   } else {
     args.tabPage.querySelector('.request-body')?.remove();
   }
-  console.log('args.action.codeHint.delegator', args.action.codeHint.delegator);
   if (args.action?.codeHint?.delegator?.result?.fields) {
     args.tabPage.querySelector('.response-body-model').innerHTML = formatHintModel(
       args.action.codeHint.delegator.result.fields,
@@ -1036,6 +1058,17 @@ function renderGeneralAction(args) {
   }
 }
 
+function genQueryString(param) {
+  if (!param) return '';
+  if (!param.fields) return '';
+
+  const queryString = Object.keys(param.fields).map(key => {
+    const type = param.fields[key].type === 'array' ? 'array_of_' + (param.fields[key].items?.type ?? 'value') : param.fields[key].type;
+    return `${key}=${type}`;
+  }).join("&");
+  return queryString ? '?' + queryString : '';
+}
+
 function renderEntityView(entityName, viewName) {
   if (this.dataset.rendered) return;
   this.dataset.rendered = true;
@@ -1597,7 +1630,33 @@ window.codeSnippets = {
         httpMethod: getHttpMethod(args.actionName),
         paramDisplay: args.action?.codeHint?.delegator?.param?.fields ? 'inline' : 'none',
         bodyDisplay: args.action?.codeHint?.delegator?.requestBody?.fields ? 'inline' : 'none',
-      }),
+        paramModel: formatHintModel(args.action.codeHint?.delegator?.param?.fields, '        ', { mode: 'model' }).trim(),
+        bodyModel: formatHintModel(args.action.codeHint?.delegator?.requestBody?.fields, '        ', { mode: 'model' }).trim(),
+      }),
+    JavascriptParamModel: (args) =>
+      args.action?.codeHint?.delegator?.param?.fields
+        ? renderTemplate('template-codeSnippets-generalAction-JavascriptModel', {
+            undefinedModel: formatHintModel(args.action.codeHint.delegator.param.fields, undefined, { mode: 'model_undefined' }),
+            valueModel: formatHintModel(args.action.codeHint.delegator.param.fields, undefined, { mode: 'model' }),
+            nullModel: formatHintModel(args.action.codeHint.delegator.param.fields, undefined, { mode: 'model_null' }),
+          })
+        : '',
+    JavascriptRequestBodyModel: (args) =>
+      args.action?.codeHint?.delegator?.requestBody?.fields
+        ? renderTemplate('template-codeSnippets-generalAction-JavascriptModel', {
+            undefinedModel: formatHintModel(args.action.codeHint.delegator.requestBody.fields, undefined, { mode: 'model_undefined' }),
+            valueModel: formatHintModel(args.action.codeHint.delegator.requestBody.fields, undefined, { mode: 'model' }),
+            nullModel: formatHintModel(args.action.codeHint.delegator.requestBody.fields, undefined, { mode: 'model_null' }),
+          })
+        : '',
+    JavascriptResultModel: (args) =>
+      args.action?.codeHint?.delegator?.result?.fields
+        ? renderTemplate('template-codeSnippets-generalAction-JavascriptModel', {
+            undefinedModel: formatHintModel(args.action.codeHint.delegator.result.fields, undefined, { mode: 'model_undefined' }),
+            valueModel: formatHintModel(args.action.codeHint.delegator.result.fields, undefined, { mode: 'model' }),
+            nullModel: formatHintModel(args.action.codeHint.delegator.result.fields, undefined, { mode: 'model_null' }),
+          })
+        : '',
     CSharp: (args) =>
       renderTemplate('template-codeSnippets-generalAction-CSharp', {
         entityName: args.entityName,
@@ -1609,14 +1668,18 @@ window.codeSnippets = {
         domain: args.domain,
         rootUrlPath: args.rootUrlPath,
         entityName: args.entityName,
+        queryString: genQueryString(args.action.codeHint?.delegator?.param),
         httpMethod: getHttpMethod(args.actionName),
+        bodyModel: formatHintModel(args.action.codeHint?.delegator?.requestBody?.fields, undefined, { mode: 'model', hideComment: true }),
         tokenDisplay: args.action.grant !== '*' ? 'inline' : 'none',
       }),
     cURL: (args) =>
       renderTemplate('template-codeSnippets-generalAction-cURL', {
         rootUrl: localStorage.selected_root_url,
         entityName: args.entityName,
+        queryString: genQueryString(args.action.codeHint?.delegator?.param),
         httpMethod: getHttpMethod(args.actionName),
+        bodyModel: formatHintModel(args.action.codeHint?.delegator?.requestBody?.fields, undefined, { mode: 'model', hideComment: true }),
         tokenDisplay: args.action.grant !== '*' ? 'inline' : 'none',
       }),
     Java: (args) =>
@@ -1767,6 +1830,10 @@ function activeRoleTab() {
       return $(this).data('role') === role;
     })
     .addClass('active');
+  var hash = $(this).data('hash');
+  if (hash) {
+    location.hash = hash;
+  }
 }
 
 function activeFirstChild() {
@@ -1781,7 +1848,7 @@ function activeFirstChild() {
 function gotoHash() {
   if (!location.hash) return;
 
-  const m = location.hash.match(/^#(\$[\w-]+|\w+)(\.((views\.)?\w+))?$/);
+  const m = location.hash.match(/^#(\$[\w-]+|\w+)(\.((views\.)?\w+)(\/\*?[\/\w\+\|]*)?)?$/);
   if (!m) return;
 
   const cardSelector = m[1].charAt(0) === '$' ? '#extension-' + m[1].substring(1) : '#entity-' + m[1];
@@ -1820,6 +1887,55 @@ function gotoHash() {
     if (isNaN(stickyTop)) stickyTop = 0;
   }
   window.scrollTo(0, top - stickyTop);
+
+  if (m[5]) {
+    const segs = m[5].substring(1).split('/');
+    const role = segs[0];
+    if (!role) return;
+    const snippet = segs[1];
+
+    const aRole = document.querySelector(`${panelSelector} .panel-body .nav-tabs a[data-role="${role}"]`);
+    if (aRole && aRole.onclick) aRole.onclick();
+
+    if (!snippet) return;
+
+    const aSnippet = document.querySelector(`${panelSelector} .panel-body .tab-pages .tab-page[data-role="${role}"] .nav-tabs a[data-role="${snippet}"]`);
+    if (aSnippet && aSnippet.onclick) aSnippet.onclick();
+  }
+}
+
+function doCopy(e) {
+  if (!this.dataset.copy) return;
+
+  e.stopPropagation();
+  if (location.protocol !== 'https:' && location.protocol !== 'file:') {
+    alert('Can not copy, please use https protocol!');
+    return;
+  }
+
+  const copyDom = this.parentNode.querySelector(this.dataset.copy);
+
+  if (window.ClipboardItem) {
+    const content = copyDom.innerText;
+    const blob = new Blob([content], { type: 'text/plain' });
+    const text = new ClipboardItem({ 'text/plain': blob });
+    navigator.clipboard.write([text]);
+  } else {
+    if (document.body.createTextRange) {
+      const range = document.body.createTextRange();
+      range.moveToElementText(copyDom);
+      range.select();
+    } else if (window.getSelection) {
+      const selection = window.getSelection();
+      const range = document.createRange();
+      range.selectNodeContents(copyDom);
+      selection.removeAllRanges();
+      selection.addRange(range);
+    }
+    document.execCommand('copy');
+  }
+
+  copied();
 }
 
 function copied() {

package/dist/gen/gen-api-docs.js

@@ -16,9 +16,16 @@ function reserveWhitelist(obj, whitelist) {
     return obj;
 }
 const environmentVariableWhitelist = ['type', 'description'];
-function filterEnvironmentVariables(environmentVariables) {
+function filterEnvironmentVariables(environmentVariables, allowRoles) {
     if (!environmentVariables)
         return;
+    if (!allowRoles.includes('*')) {
+        Object.keys(environmentVariables).forEach((envName) => {
+            if (environmentVariables[envName].codeHint?.roles?.every((role) => !allowRoles.includes(role))) {
+                delete environmentVariables[envName];
+            }
+        });
+    }
     Object.values(environmentVariables).forEach((env) => reserveWhitelist(env, environmentVariableWhitelist));
 }
 const entityWhitelist = ['name', 'description', 'actions', 'views', 'features', 'fields'];
@@ -145,7 +152,9 @@ function markIncludedFields(excludedFields, dict) {
     if (!Array.isArray(excludedFields))
         return;
     for (const m in dict) {
-        if (!dict[m] && !excludedFields.includes(m))
+        if (!dict[m] &&
+            !excludedFields.includes(m) &&
+            excludedFields.every((excludedField) => !m.startsWith(excludedField + '.')))
             dict[m] = true;
     }
 }
@@ -198,7 +207,18 @@ function filterEntityFields(entity) {
             case 'updateOne':
             case 'updateMany':
             case 'updatePartially':
-                actions.forEach((action) => (action.exclude = action.exclude?.filter((field) => allowFields.includes(field))));
+                actions.forEach((action) => {
+                    action.exclude = action.exclude?.filter((field) => {
+                        let idx = 0;
+                        do {
+                            idx = field.indexOf('.', idx + 1);
+                            const prefix = idx === -1 ? field : field.substring(0, idx);
+                            if (allowFields.includes(prefix))
+                                return true;
+                        } while (idx !== -1);
+                        return false;
+                    });
+                });
                 break;
         }
     });
@@ -250,7 +270,8 @@ export default async function genDocs(args, projectName, project, alias, source)
         throw new Error(`Not found gen docs configuration. Please run 'npx mushroom-cli config ${projectName} gen docs OUTPUT_FILE.html${alias === 'default' ? '' : ' alias ' + alias}' first`);
     }
     common.logInfo('Use GenDocEngine v1.2');
-    const entities = common.getEntities(source, aliasProject.allowRoles);
+    const allowRoles = aliasProject.allowRoles ?? ['*'];
+    const entities = common.getEntities(source, allowRoles);
     if (Array.isArray(aliasProject.entities)) {
         for (const entityName in entities) {
             if (Object.hasOwnProperty.call(entities, entityName)) {
@@ -260,7 +281,7 @@ export default async function genDocs(args, projectName, project, alias, source)
             }
         }
     }
-    filterEnvironmentVariables(source.environmentVariables);
+    filterEnvironmentVariables(source.environmentVariables, allowRoles);
     filterEntities(entities);
     const data = JSON.stringify({
         info: {
@@ -275,7 +296,7 @@ export default async function genDocs(args, projectName, project, alias, source)
                 },
         },
         features: aliasProject.features,
-        roles: common.filterRoles(source.roles ?? [], aliasProject.allowRoles ?? ['*']),
+        roles: common.filterRoles(source.roles ?? [], allowRoles),
         environmentVariables: source.environmentVariables,
         entities: entities,
     });

package/dist/gen/gen-csharp.js

@@ -213,6 +213,8 @@ function generateCSharpClassMongoDb(source, className, fields, isRoot, descripti
         content += `        [MongoDB.Bson.Serialization.Attributes.BsonElement("${isRoot && fieldName === 'id' ? '_id' : fieldName}")]
         [MongoDB.Bson.Serialization.Attributes.BsonIgnoreIfNull]
         [Newtonsoft.Json.JsonProperty(PropertyName = "${fieldName}", NullValueHandling = Newtonsoft.Json.NullValueHandling.Ignore${type === 'System.DateTime' ? ', DefaultValueHandling = Newtonsoft.Json.DefaultValueHandling.Ignore' : ''})]
+        [System.Text.Json.Serialization.JsonPropertyName("${fieldName}")]
+        [System.Text.Json.Serialization.JsonIgnore(Condition = ${type === 'System.DateTime' ? 'JsonIgnoreCondition.WhenWritingDefault' : 'JsonIgnoreCondition.WhenWritingNull'})]
 `;
         if ((field.type === 'AutoId' || field.type === 'IdRef') && source.idType === 'ObjectId') {
             content += '        [MongoDB.Bson.Serialization.Attributes.BsonRepresentation(MongoDB.Bson.BsonType.ObjectId)]\n';
@@ -558,6 +560,8 @@ function generateCSharpClassMongoDbToFolder(source, className, fields, isRoot, d
         content += `        [MongoDB.Bson.Serialization.Attributes.BsonElement("${isRoot && fieldName === 'id' ? '_id' : fieldName}")]
         [MongoDB.Bson.Serialization.Attributes.BsonIgnoreIfNull]
         [Newtonsoft.Json.JsonProperty(PropertyName = "${fieldName}", NullValueHandling = Newtonsoft.Json.NullValueHandling.Ignore${type === 'System.DateTime' ? ', DefaultValueHandling = Newtonsoft.Json.DefaultValueHandling.Ignore' : ''})]
+        [System.Text.Json.Serialization.JsonPropertyName("${fieldName}")]
+        [System.Text.Json.Serialization.JsonIgnore(Condition = ${type === 'System.DateTime' ? 'JsonIgnoreCondition.WhenWritingDefault' : 'JsonIgnoreCondition.WhenWritingNull'})]
 `;
         if ((field.type === 'AutoId' || field.type === 'IdRef') && source.idType === 'ObjectId') {
             content += '        [MongoDB.Bson.Serialization.Attributes.BsonRepresentation(MongoDB.Bson.BsonType.ObjectId)]\n';
@@ -838,6 +842,8 @@ namespace ${namespace}
         private void RegisterCustomVnTextBuilderMethod(System.Func<System.Collections.Generic.IEnumerable<string>, System.Collections.Generic.IEnumerable<string>> fn) { }
         private void RegisterEvent(System.Func<object, Mushroom.ActionArguments, System.Threading.Tasks.Task> fn) { }
         private void RegisterEvent(System.Action<object, Mushroom.ActionArguments> fn) { }
+        private void RegisterRespondingEvent(System.Func<object, Mushroom.ActionArguments, Mushroom.ActionResult, System.Threading.Tasks.Task> fn) { }
+        private void RegisterRespondingEvent(System.Action<object, Mushroom.ActionArguments, Mushroom.ActionResult> fn) { }
         private void RegisterJob<T>() where T : Mushroom.Job.JobBase { }
         private void Help()
         {
@@ -900,6 +906,8 @@ function generateCSharpClassDriver(source, className, fields, description, out)
         /// ${singleLine(field.description)}
         /// </summary>
         [Newtonsoft.Json.JsonProperty(PropertyName ="${fieldName}", NullValueHandling = Newtonsoft.Json.NullValueHandling.Ignore${type === 'System.Datetime' ? ', DefaultValueHandling = Newtonsoft.Json.DefaultValueHandling.Ignore' : ''})]
+        [System.Text.Json.Serialization.JsonPropertyName("${fieldName}")]
+        [System.Text.Json.Serialization.JsonIgnore(Condition = ${type === 'System.DateTime' ? 'JsonIgnoreCondition.WhenWritingDefault' : 'JsonIgnoreCondition.WhenWritingNull'})]
         public ${type} ${propertyName} { get; set; }
 
 `;
@@ -1135,7 +1143,9 @@ export function genCSharpDriver(args, projectName, project, alias, source) {
                             let type = getCSharpTypeFromMushroomType(source, p.type, p.validation && p.validation.required);
                             if (p.isArray)
                                 type = `System.Collections.Generic.List<${type}>`;
-                            viewExtraClass += `        [Newtonsoft.Json.JsonProperty(PropertyName = "${p.field}")]
+                            viewExtraClass += `        [Newtonsoft.Json.JsonProperty(PropertyName = "${p.field}", NullValueHandling = Newtonsoft.Json.NullValueHandling.Ignore${type === 'System.Datetime' ? ', DefaultValueHandling = Newtonsoft.Json.DefaultValueHandling.Ignore' : ''})]
+        [System.Text.Json.Serialization.JsonPropertyName("${p.field}")]
+        [System.Text.Json.Serialization.JsonIgnore(Condition = ${type === 'System.DateTime' ? 'JsonIgnoreCondition.WhenWritingDefault' : 'JsonIgnoreCondition.WhenWritingNull'})]
         public ${type} ${toCSharpName(p.field)} { get; set; }
 
 `;

package/dist/gen/gen-js-driver-tarball.js

@@ -1,6 +1,6 @@
 import fs from 'fs';
 import path from 'path';
-import targz from 'targz';
+import { compress } from 'targz';
 import * as common from '../common.js';
 import * as javascriptDriverGenerator from './gen-js-driver.js';
 import * as typescriptDriverGenerator from './gen-ts-driver.js';
@@ -21,7 +21,7 @@ function compressAsync(src, dest, folderName) {
                 },
             };
         }
-        targz.compress(options, function (err) {
+        compress(options, function (err) {
             if (err) {
                 reject(err);
                 return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mushroom-cli",
-  "version": "1.2.0-alpha.23",
+  "version": "1.2.0-alpha.25",
   "description": "Mushroom CLI",
   "main": "dist/mr.js",
   "type": "module",
@@ -33,30 +33,30 @@
   "author": "suco2007",
   "license": "ISC",
   "dependencies": {
-    "jsdom": "^25.0.1",
+    "jsdom": "^26.1.0",
     "json5": "^2.2.3",
-    "minify": "^11.4.1",
+    "minify": "^14.0.0",
     "node-fetch": "^3.3.2",
-    "open": "^10.1.0",
+    "open": "^10.1.2",
     "readline-sync": "^1.4.10",
     "targz": "^1.0.1"
   },
   "devDependencies": {
-    "@eslint/js": "^9.11.1",
+    "@eslint/js": "^9.27.0",
     "@types/jsdom": "^21.1.7",
     "@types/minify": "^9.1.4",
-    "@types/node": "^22.7.4",
-    "@types/node-fetch": "^2.6.11",
+    "@types/node": "^22.15.26",
+    "@types/node-fetch": "^2.6.12",
     "@types/readline-sync": "^1.4.8",
-    "@types/targz": "^1.0.4",
+    "@types/targz": "^1.0.5",
     "copyfiles": "^2.4.1",
-    "eslint": "^9.11.1",
-    "husky": "^9.1.6",
-    "lint-staged": "^15.2.10",
+    "eslint": "^9.27.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.1.0",
     "only-allow": "^1.2.1",
-    "prettier": "^3.3.3",
-    "typescript": "^5.6.2",
-    "typescript-eslint": "^8.8.0"
+    "prettier": "^3.5.3",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.33.0"
   },
   "engines": {
     "node": ">=14.0.0"