@aws/mynah-ui 4.23.0-beta.1 → 4.23.0-beta.3

package/dist/static.d.ts

@@ -2,14 +2,14 @@
  * Copyright 2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { MynahIcons } from './components/icon';
+import { MynahIcons, MynahIconsType } from './components/icon';
 import { ChatItemBodyRenderer } from './helper/dom';
 import { SelectAbstract, SelectProps, RadioGroupAbstract, RadioGroupProps, ButtonAbstract, ButtonProps, TextInputProps, TextInputAbstract, TextAreaProps, TextAreaAbstract, ToggleOption } from './main';
 export interface QuickActionCommand {
     command: string;
     label?: string;
     disabled?: boolean;
-    icon?: MynahIcons;
+    icon?: MynahIcons | MynahIconsType;
     description?: string;
     placeholder?: string;
     children?: QuickActionCommandGroup[];
@@ -20,6 +20,7 @@ export interface QuickActionCommandInternal extends QuickActionCommand {
 }
 export interface QuickActionCommandGroup {
     groupName?: string;
+    actions?: Action[];
     commands: QuickActionCommand[];
 }
 export interface QuickActionCommandGroupInternal extends QuickActionCommandGroup {
@@ -154,6 +155,7 @@ export declare enum MynahEventNames {
     CHAT_ITEM_ADD = "chatItemAdd",
     FOLLOW_UP_CLICKED = "followUpClicked",
     BODY_ACTION_CLICKED = "bodyActionClicked",
+    QUICK_COMMAND_GROUP_ACTION_CLICK = "quickCommandGroupActionClicked",
     TABBED_CONTENT_SWITCH = "tabbedContentSwitch",
     SHOW_MORE_WEB_RESULTS_CLICK = "showMoreWebResultsClick",
     SHOW_FEEDBACK_FORM = "showFeedbackForm",
@@ -225,7 +227,7 @@ export interface ProgressField {
 }
 export interface TreeNodeDetails {
     status?: Status;
-    icon?: MynahIcons;
+    icon?: MynahIcons | MynahIconsType;
     label?: string;
     description?: string;
     clickable?: boolean;
@@ -260,11 +262,11 @@ export interface ChatItemContent {
         title?: string;
         status?: {
             status?: Status;
-            icon?: MynahIcons;
+            icon?: MynahIcons | MynahIconsType;
             body?: string;
         };
         description?: string;
-        icon?: MynahIcons;
+        icon?: MynahIcons | MynahIconsType;
         content: ChatItemContent;
     } | null;
     tabbedContent?: Array<ToggleOption & {
@@ -277,7 +279,7 @@ export interface ChatItem extends ChatItemContent {
     messageId?: string;
     snapToTop?: boolean;
     canBeVoted?: boolean;
-    icon?: MynahIcons;
+    icon?: MynahIcons | MynahIconsType;
     hoverEffect?: boolean;
     status?: Status;
 }
@@ -305,28 +307,25 @@ export interface ChatItemAction extends ChatPrompt {
     disabled?: boolean;
     description?: string;
     status?: 'primary' | Status;
-    icon?: MynahIcons;
+    icon?: MynahIcons | MynahIconsType;
 }
-export interface ChatItemButton {
+export interface ChatItemButton extends Omit<Action, 'status'> {
     keepCardAfterClick?: boolean;
     waitMandatoryFormItems?: boolean;
-    text: string;
-    id: string;
-    disabled?: boolean;
-    description?: string;
     status?: 'main' | 'primary' | 'clear' | Status;
     flash?: 'infinite' | 'once';
     fillState?: 'hover' | 'always';
-    icon?: MynahIcons;
     position?: 'inside' | 'outside';
 }
-export interface TabBarAction {
+export interface Action {
     text?: string;
     id: string;
     disabled?: boolean;
     description?: string;
     status?: Status;
-    icon?: MynahIcons;
+    icon?: MynahIcons | MynahIconsType;
+}
+export interface TabBarAction extends Action {
 }
 export interface TabBarMainAction extends TabBarAction {
     items?: TabBarAction[];
@@ -337,7 +336,7 @@ export interface FileNodeAction {
     disabled?: boolean;
     description?: string;
     status?: Status;
-    icon: MynahIcons;
+    icon: MynahIcons | MynahIconsType;
 }
 export declare enum KeyMap {
     ESCAPE = "Escape",
@@ -430,7 +429,7 @@ export declare enum NotificationType {
     ERROR = "error"
 }
 export interface TabHeaderDetails {
-    icon?: MynahIcons;
+    icon?: MynahIcons | MynahIconsType;
     title?: string;
     description?: string;
 }
@@ -438,7 +437,7 @@ export interface CodeBlockAction {
     id: 'copy' | 'insert-to-cursor' | string;
     label: string;
     description?: string;
-    icon?: MynahIcons;
+    icon?: MynahIcons | MynahIconsType;
     data?: any;
     flash?: 'infinite' | 'once';
     acceptedLanguages?: string[];

package/docs/USAGE.md

@@ -18,6 +18,7 @@ mynahUI.addToUserPrompt(...);
 mynahUI.updateLastChatAnswer(...);
 mynahUI.updateChatAnswerWithMessageId(...);
 mynahUI.endMessageStream(...);
+mynahUI.serializeChat(...);
 mynahUI.updateStore(...);
 mynahUI.selectTab(...);
 mynahUI.removeTab(...);
@@ -390,6 +391,25 @@ Can you end stream for a card you already ended the stream? Basically yes becaus
 
 ---
 
+## Serializing a chat (`serializeChat`)
+
+You can serialize an entire chat from a specific tab using this function. Only the card bodies will be included, meaning that buttons and other interactable components are left out. There are two output options for the serialization:
+- **Markdown:** get all the bodies from chat items in markdown format so that it serves as the contents of a valid `.md` file. Each card body is separated by `\n\n---\n\n`.
+- **HTML:** get a string which serves as the contents of a valid `.html` file. It consists of a centered chat container, containing all the chat item bodies in cards. All the relevant stylesheets from MynahUI are included in the `<style>` section of the string.
+
+The following example shows how serialization could be used to download an export of a tab's chat:
+```typescript
+const serializedChat = mynahUI.serializeChat(tabId, 'markdown')
+const blob = new Blob([serializedChat], { type: 'text/plain' });
+const url = URL.createObjectURL(blob);
+const link = document.createElement('a');
+link.download = 'exported-chat.md';
+link.href = url;
+link.click();
+```
+
+---
+
 ## Adding code attachments to prompt field (`addToUserPrompt`)
 
 You can add code attachments under the prompt field of the desired tab. When user fills the prompt field and sends it, the attached code block will be appended at the end of the prompt text. It accepts max chars set through **[CONFIG](./CONFIG.md#maxUserInput)** however you don't need to worry about it. MynahUI will automatically crop it depending on the available chars left from the prompt field itself by using a `96` chars of threshold. **So beware that for example if you want 4000 chars exact, you need to give 4096 to the config.**

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@aws/mynah-ui",
     "displayName": "AWS Mynah UI",
-    "version": "4.23.0-beta.1",
+    "version": "4.23.0-beta.3",
     "description": "AWS Toolkit VSCode and Intellij IDE Extension Mynah UI",
     "publisher": "Amazon Web Services",
     "license": "Apache License 2.0",