@matechat/ng 0.0.1-alpha.0 → 20.0.1-alpha.0

package/Base/base.component.d.ts

@@ -1,11 +1,11 @@
-import { DefaultAdapter } from '../components-common/Base/foundation';
+import BaseFoundation, { DefaultAdapter } from '../components-common/Base/foundation';
 import * as i0 from "@angular/core";
-export default class BaseComponent {
-    foundation: any;
+export default class BaseComponent<T extends BaseFoundation<DefaultAdapter>> {
+    foundation: T;
     cache: any;
     constructor();
     ngOnDestroy(): void;
     get adapter(): DefaultAdapter;
-    static ɵfac: i0.ɵɵFactoryDeclaration<BaseComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BaseComponent, "mate-base-component", never, {}, {}, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BaseComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BaseComponent<any>, "mate-base-component", never, {}, {}, never, never, true, never>;
 }

package/Bubble/bubble.component.d.ts

@@ -1,24 +1,26 @@
-import { TemplateRef } from '@angular/core';
+import { TemplateRef, QueryList } from '@angular/core';
 import { BubbleAlign, BubbleVariant, AvatarPosition, BubbleAvatar } from '../components-common//Bubble/common/bubble-types';
-import { BubbleAdapter } from '../components-common/Bubble/foundation';
+import { BubbleAdapter, BubbleFoundation } from '../components-common/Bubble/foundation';
 import BaseComponent from '../Base/base.component';
 import * as i0 from "@angular/core";
-export declare class BubbleComponent extends BaseComponent {
+export declare class BubbleComponent extends BaseComponent<BubbleFoundation> {
     content: string;
     loading: boolean;
     align: BubbleAlign;
     avatarPosition: AvatarPosition;
     variant: BubbleVariant;
     avatarConfig?: BubbleAvatar;
+    avatarTemplate: TemplateRef<any> | null;
     topTemplate: TemplateRef<any> | null;
     loadingTplTemplate: TemplateRef<any> | null;
-    defaultTemplate: TemplateRef<any> | null;
     bottomTemplate: TemplateRef<any> | null;
+    contentChildren: QueryList<any>;
+    get ngContentProjected(): boolean;
     constructor();
     ngOnInit(): void;
     get adapter(): BubbleAdapter;
     get bubbleClasses(): string;
     get isEmptyAvatar(): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<BubbleComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BubbleComponent, "mc-bubble", never, { "content": { "alias": "content"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "align": { "alias": "align"; "required": false; }; "avatarPosition": { "alias": "avatarPosition"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "avatarConfig": { "alias": "avatarConfig"; "required": false; }; }, {}, ["topTemplate", "loadingTplTemplate", "defaultTemplate", "bottomTemplate"], ["[top]", "[loadingTpl]", "*", "[bottom]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BubbleComponent, "mc-bubble", never, { "content": { "alias": "content"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "align": { "alias": "align"; "required": false; }; "avatarPosition": { "alias": "avatarPosition"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "avatarConfig": { "alias": "avatarConfig"; "required": false; }; }, {}, ["avatarTemplate", "topTemplate", "loadingTplTemplate", "bottomTemplate", "contentChildren"], ["[avatar]", "[top]", "[loadingTpl]", "*", "[bottom]"], true, never>;
 }

package/Input/button/button.component.d.ts

@@ -2,8 +2,9 @@ import { EventEmitter, ElementRef } from '@angular/core';
 import { SendBtnVariant } from '../../components-common/Input/common/types';
 import BaseComponent from '../../Base/base.component';
 import { LocaleService } from '../../Locale';
+import { InputButtonFoundation } from '../../components-common/Input/button-foundation';
 import * as i0 from "@angular/core";
-export declare class ButtonComponent extends BaseComponent {
+export declare class ButtonComponent extends BaseComponent<InputButtonFoundation> {
     private localeService;
     disabled: boolean;
     loading: boolean;
@@ -20,7 +21,7 @@ export declare class ButtonComponent extends BaseComponent {
         left: string;
     };
     constructor(localeService: LocaleService);
-    get buttonClasses(): string;
+    get buttonClasses(): Record<string, any>;
     ngOnInit(): void;
     onMouseDown(): void;
     onMouseUp(): void;

package/Input/input.component.d.ts

@@ -1,11 +1,15 @@
 import { EventEmitter, OnInit, ElementRef, TemplateRef, SimpleChanges } from '@angular/core';
 import { DisplayType, InputVariant, SendBtnVariant, SubmitShortKey } from '../components-common/Input/common/types';
 import BaseComponent from '../Base/base.component';
-import { InputAdapter } from '../components-common/Input/foundation';
+import { InputAdapter, InputFoundation } from '../components-common/Input/foundation';
 import { LocaleService } from '../Locale/locale.service';
 import * as i0 from "@angular/core";
+export type TextareaAutoSize = {
+    minRows?: number;
+    maxRows?: number;
+} | boolean;
 export declare const inputContextToken = "input-context";
-export declare class InputComponent extends BaseComponent implements OnInit {
+export declare class InputComponent extends BaseComponent<InputFoundation> implements OnInit {
     private localeService;
     value: string;
     placeholder: string;
@@ -18,6 +22,8 @@ export declare class InputComponent extends BaseComponent implements OnInit {
     maxLength: number | null;
     submitShortKey: SubmitShortKey | null | string;
     autofocus: boolean;
+    autosize: TextareaAutoSize;
+    textareaStyle: Record<string, string>;
     change: EventEmitter<string>;
     submit: EventEmitter<string>;
     cancel: EventEmitter<void>;
@@ -36,7 +42,7 @@ export declare class InputComponent extends BaseComponent implements OnInit {
     get adapter(): InputAdapter;
     onChange(e: any): void;
     ngOnChanges(changes: SimpleChanges): void;
-    get inputClasses(): string;
+    get inputClasses(): Record<string, any>;
     get maxlengthValue(): number | null;
     onInput(): void;
     onCompositionStart(): void;
@@ -48,9 +54,12 @@ export declare class InputComponent extends BaseComponent implements OnInit {
     onButtonCancel(): void;
     onButtonChange(value: string): void;
     ngAfterViewInit(): void;
+    updateTextareaStyle(): void;
+    private getAutosizeConfig;
+    private computeTextareaHeight;
     get placeholderText(): string;
     onFocus(event: FocusEvent): void;
     onBlur(event: FocusEvent): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<InputComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<InputComponent, "mc-input", never, { "value": { "alias": "value"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "displayType": { "alias": "displayType"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "sendBtnVariant": { "alias": "sendBtnVariant"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "showCount": { "alias": "showCount"; "required": false; }; "maxLength": { "alias": "maxLength"; "required": false; }; "submitShortKey": { "alias": "submitShortKey"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; }, { "change": "change"; "submit": "submit"; "cancel": "cancel"; "focus": "focus"; "blur": "blur"; }, ["headTemplate", "prefixTemplate", "suffixTemplate", "buttonTemplate", "extraTemplate"], never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<InputComponent, "mc-input", never, { "value": { "alias": "value"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "displayType": { "alias": "displayType"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "sendBtnVariant": { "alias": "sendBtnVariant"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "showCount": { "alias": "showCount"; "required": false; }; "maxLength": { "alias": "maxLength"; "required": false; }; "submitShortKey": { "alias": "submitShortKey"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; "autosize": { "alias": "autosize"; "required": false; }; }, { "change": "change"; "submit": "submit"; "cancel": "cancel"; "focus": "focus"; "blur": "blur"; }, ["headTemplate", "prefixTemplate", "suffixTemplate", "buttonTemplate", "extraTemplate"], never, true, never>;
 }

package/MarkdownCard/code-block.component.d.ts

@@ -0,0 +1,49 @@
+import { OnInit, ElementRef, OnChanges, SimpleChanges, ChangeDetectorRef, QueryList } from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import type { MermaidConfig } from '../components-common/MarkdownCard/common/mdCard.types';
+import BaseComponent from '../Base/base.component';
+import { CodeBlockAdapter, CodeBlockFoundation } from '../components-common/MarkdownCard/codeblock-foundation';
+import * as i0 from "@angular/core";
+export declare class CodeBlockComponent extends BaseComponent<CodeBlockFoundation> implements OnInit, OnChanges {
+    private cdr;
+    code: string;
+    language: string;
+    blockIndex: number;
+    theme: 'light' | 'dark';
+    enableMermaid: boolean;
+    mermaidConfig: MermaidConfig;
+    contentTemplate: TemplateRef<any> | null;
+    headerTemplate: TemplateRef<any> | null;
+    actionsTemplate: TemplateRef<any> | null;
+    rootRef: ElementRef;
+    mermaidContentRef: ElementRef;
+    codeElementRef: ElementRef;
+    codeElementTemplates: QueryList<ElementRef>;
+    expanded: boolean;
+    copied: boolean;
+    mermaidContent: string;
+    private diffDom;
+    private _showMermaidDiagram;
+    get showMermaidDiagram(): boolean;
+    set showMermaidDiagram(value: boolean);
+    highlightedCode: string;
+    isMermaid: boolean;
+    private copySubject;
+    constructor(cdr: ChangeDetectorRef);
+    get adapter(): CodeBlockAdapter;
+    switchShowMermaid(show: boolean): void;
+    ngOnInit(): void;
+    ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    private checkIsMermaid;
+    private updateHighlightedCode;
+    zoomIn(): void;
+    zoomOut(): void;
+    download(): void;
+    renderMermaid(): Promise<void>;
+    toggleExpand(): void;
+    copyCode(): void;
+    copyCodeInternal(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CodeBlockComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CodeBlockComponent, "mc-code-block", never, { "code": { "alias": "code"; "required": false; }; "language": { "alias": "language"; "required": false; }; "blockIndex": { "alias": "blockIndex"; "required": false; }; "theme": { "alias": "theme"; "required": false; }; "enableMermaid": { "alias": "enableMermaid"; "required": false; }; "mermaidConfig": { "alias": "mermaidConfig"; "required": false; }; "contentTemplate": { "alias": "contentTemplate"; "required": false; }; "headerTemplate": { "alias": "headerTemplate"; "required": false; }; "actionsTemplate": { "alias": "actionsTemplate"; "required": false; }; }, {}, never, never, false, never>;
+}

package/MarkdownCard/index.d.ts

@@ -0,0 +1,3 @@
+export * from './markdown-card.component';
+export * from './code-block.component';
+export * from './markdown-card.module';

package/MarkdownCard/markdown-card.component.d.ts

@@ -0,0 +1,200 @@
+import { OnInit, OnChanges, OnDestroy, ChangeDetectorRef, SimpleChanges, EventEmitter, Renderer2, ViewContainerRef, TemplateRef } from '@angular/core';
+import markdownit from 'markdown-it';
+import type { Token } from 'markdown-it';
+import type { ASTNode } from '../components-common/MarkdownCard/common/mdCard.types';
+import { MarkdownCardProps } from '../components-common/MarkdownCard/common/mdCard.types';
+import BaseComponent from '../Base/base.component';
+import { MarkdownCardAdapter, MarkdownCardFoundation } from '../components-common/MarkdownCard/foundation';
+import * as i0 from "@angular/core";
+export declare class MarkdownCardComponent extends BaseComponent<MarkdownCardFoundation> implements OnInit, OnChanges, OnDestroy {
+    private renderer;
+    cdr: ChangeDetectorRef;
+    private diffDom;
+    content: string;
+    typing: boolean;
+    enableThink: boolean;
+    typingOptions: MarkdownCardProps['typingOptions'] | any;
+    thinkOptions: MarkdownCardProps['thinkOptions'];
+    mdOptions: MarkdownCardProps['mdOptions'];
+    mdPlugins: MarkdownCardProps['mdPlugins'];
+    customXssRules: MarkdownCardProps['customXssRules'];
+    theme: 'light' | 'dark' | any;
+    enableMermaid: boolean;
+    mermaidConfig: MarkdownCardProps['mermaidConfig'];
+    actionsTemplate: TemplateRef<any> | null;
+    headerTemplate: TemplateRef<any> | null;
+    contentTemplate: TemplateRef<any> | null;
+    private codeBlockComponentsCache;
+    afterMdtInit: EventEmitter<markdownit>;
+    typingStart: EventEmitter<void>;
+    typingEvent: EventEmitter<void>;
+    typingEnd: EventEmitter<void>;
+    markdownContainer: ViewContainerRef;
+    private mdt;
+    typingIndex: number;
+    isTyping: boolean;
+    timer: number | null;
+    parser: {
+        isSelfClosingTag: (token: {
+            type: string;
+            tag: string;
+            attrs: [string, string][] | null;
+            map: [number, number] | null;
+            nesting: Token.Nesting;
+            level: number;
+            children: any[] | null;
+            content: string;
+            markup: string;
+            info: string;
+            meta: any;
+            block: boolean;
+            hidden: boolean;
+            attrIndex(name: string): number;
+            attrPush(attrData: [string, string]): void;
+            attrSet(name: string, value: string): void;
+            attrGet(name: string): string | null;
+            attrJoin(name: string, value: string): void;
+        }) => boolean;
+        isClosingTag: (openToken: {
+            type: string;
+            tag: string;
+            attrs: [string, string][] | null;
+            map: [number, number] | null;
+            nesting: Token.Nesting;
+            level: number;
+            children: any[] | null;
+            content: string;
+            markup: string;
+            info: string;
+            meta: any;
+            block: boolean;
+            hidden: boolean;
+            attrIndex(name: string): number;
+            attrPush(attrData: [string, string]): void;
+            attrSet(name: string, value: string): void;
+            attrGet(name: string): string | null;
+            attrJoin(name: string, value: string): void;
+        }, closeToken: {
+            type: string;
+            tag: string;
+            attrs: [string, string][] | null;
+            map: [number, number] | null;
+            nesting: Token.Nesting;
+            level: number;
+            children: any[] | null;
+            content: string;
+            markup: string;
+            info: string;
+            meta: any;
+            block: boolean;
+            hidden: boolean;
+            attrIndex(name: string): number;
+            attrPush(attrData: [string, string]): void;
+            attrSet(name: string, value: string): void;
+            attrGet(name: string): string | null;
+            attrJoin(name: string, value: string): void;
+        }) => boolean;
+        tokensToAst: (tokens: {
+            type: string;
+            tag: string;
+            attrs: [string, string][] | null;
+            map: [number, number] | null;
+            nesting: Token.Nesting;
+            level: number;
+            children: any[] | null;
+            content: string;
+            markup: string;
+            info: string;
+            meta: any;
+            block: boolean;
+            hidden: boolean;
+            attrIndex(name: string): number;
+            attrPush(attrData: [string, string]): void;
+            attrSet(name: string, value: string): void;
+            attrGet(name: string): string | null;
+            attrJoin(name: string, value: string): void;
+        }[]) => ASTNode[];
+        genTreeNode: (node: {
+            type: string;
+            tag: string;
+            attrs: [string, string][] | null;
+            map: [number, number] | null;
+            nesting: Token.Nesting;
+            level: number;
+            children: any[] | null;
+            content: string;
+            markup: string;
+            info: string;
+            meta: any;
+            block: boolean;
+            hidden: boolean;
+            attrIndex(name: string): number;
+            attrPush(attrData: [string, string]): void;
+            attrSet(name: string, value: string): void;
+            attrGet(name: string): string | null;
+            attrJoin(name: string, value: string): void;
+        } | null) => ASTNode;
+        matchHtmlToken: (token: {
+            type: string;
+            tag: string;
+            attrs: [string, string][] | null;
+            map: [number, number] | null;
+            nesting: Token.Nesting;
+            level: number;
+            children: any[] | null;
+            content: string;
+            markup: string;
+            info: string;
+            meta: any;
+            block: boolean;
+            hidden: boolean;
+            attrIndex(name: string): number;
+            attrPush(attrData: [string, string]): void;
+            attrSet(name: string, value: string): void;
+            attrGet(name: string): string | null;
+            attrJoin(name: string, value: string): void;
+        }, stack: {
+            type: string;
+            tag: string;
+            attrs: [string, string][] | null;
+            map: [number, number] | null;
+            nesting: Token.Nesting;
+            level: number;
+            children: any[] | null;
+            content: string;
+            markup: string;
+            info: string;
+            meta: any;
+            block: boolean;
+            hidden: boolean;
+            attrIndex(name: string): number;
+            attrPush(attrData: [string, string]): void;
+            attrSet(name: string, value: string): void;
+            attrGet(name: string): string | null;
+            attrJoin(name: string, value: string): void;
+        }[]) => void;
+        isValidTagName: (tagName: string | undefined) => boolean;
+    };
+    mdCardService: any;
+    noDiff: boolean;
+    constructor(renderer: Renderer2, cdr: ChangeDetectorRef);
+    ngOnInit(): void;
+    get adapter(): MarkdownCardAdapter;
+    ngOnChanges(changes: SimpleChanges): void;
+    private parseContent;
+    private renderContent;
+    private getEmptyCodeBlock;
+    private astToVnodes;
+    private processASTNode;
+    private processHTMLNode;
+    private renderContentNoDiff;
+    private processInlineToken;
+    private processFenceNode;
+    private processASTNodeInternal;
+    private processToken;
+    private createCodeBlock;
+    private typewriterStart;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MarkdownCardComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MarkdownCardComponent, "mc-markdown-card", never, { "content": { "alias": "content"; "required": false; }; "typing": { "alias": "typing"; "required": false; }; "enableThink": { "alias": "enableThink"; "required": false; }; "typingOptions": { "alias": "typingOptions"; "required": false; }; "thinkOptions": { "alias": "thinkOptions"; "required": false; }; "mdOptions": { "alias": "mdOptions"; "required": false; }; "mdPlugins": { "alias": "mdPlugins"; "required": false; }; "customXssRules": { "alias": "customXssRules"; "required": false; }; "theme": { "alias": "theme"; "required": false; }; "enableMermaid": { "alias": "enableMermaid"; "required": false; }; "mermaidConfig": { "alias": "mermaidConfig"; "required": false; }; "actionsTemplate": { "alias": "actionsTemplate"; "required": false; }; "headerTemplate": { "alias": "headerTemplate"; "required": false; }; "contentTemplate": { "alias": "contentTemplate"; "required": false; }; }, { "afterMdtInit": "afterMdtInit"; "typingStart": "typingStart"; "typingEvent": "typingEvent"; "typingEnd": "typingEnd"; }, never, ["*"], false, never>;
+}

package/MarkdownCard/markdown-card.module.d.ts

@@ -0,0 +1,13 @@
+import { ModuleWithProviders } from '@angular/core';
+import * as i0 from "@angular/core";
+import * as i1 from "./markdown-card.component";
+import * as i2 from "./code-block.component";
+import * as i3 from "@angular/common";
+import * as i4 from "../Locale/translate.pipe";
+import * as i5 from "../Locale/locale.module";
+export declare class MarkdownCardModule {
+    static forRoot(): ModuleWithProviders<MarkdownCardModule>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MarkdownCardModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MarkdownCardModule, [typeof i1.MarkdownCardComponent, typeof i2.CodeBlockComponent], [typeof i3.CommonModule, typeof i4.TranslatePipe, typeof i5.LocaleModule], [typeof i1.MarkdownCardComponent, typeof i2.CodeBlockComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MarkdownCardModule>;
+}

package/README.md

@@ -1,24 +1,128 @@
-# ComponentsNg
+<p align="center">
+  <a href="https://matechat.gitcode.com/" target="_blank" rel="noopener noreferrer">
+    <img alt="MateChat Logo" src="https://matechat.gitcode.com/logo.svg" width="180" style="max-width:100%;">
+  </a>
+</p>
+<h1 align="center">MateChat/Angular</h1>
+<p align="center">前端智能化场景解决方案UI库，轻松构建你的AI应用。已服务于华为内部多个应用智能化改造，并助力CodeArts、InsCode AI IDE等智能化助手搭建。</p>
 
-This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 17.3.0.
+![example](https://matechat.gitcode.com/example1.png)
 
-## Code scaffolding
+## 🌈 特性
 
-Run `ng generate component component-name --project components-ng` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module --project components-ng`.
-> Note: Don't forget to add `--project components-ng` or else it will be added to the default project in your `angular.json` file. 
+- 面向智能化场景组件库
+- 开箱即用
+- 多场景匹配
+- 多主题适配
+- 更多特性持续演进更新中...
 
-## Build
+了解更多请访问MateChat网站：[MateChat](https://matechat.gitcode.com)
 
-Run `ng build components-ng` to build the project. The build artifacts will be stored in the `dist/` directory.
+## 🖥️ 快速开始
 
-## Publishing
+### 1. 安装
 
-After building your library with `ng build components-ng`, go to the dist folder `cd dist/components-ng` and run `npm publish`.
+如果你还没有新建项目，可以使用Angular CLI首先初始化一个`angular`项目：
 
-## Running unit tests
+```bash
+$ npm install -g @angular/cli
 
-Run `ng test components-ng` to execute the unit tests via [Karma](https://karma-runner.github.io).
+$ ng new matechat-ng
 
-## Further help
+$ npm i @matechat/ng @devui-design/icons
+```
 
-To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI Overview and Command Reference](https://angular.io/cli) page.
+### 2. 引入
+
+在`app.component.ts`文件中引入模块
+
+```ts
+import { Component } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { BubbleModule } from '@matechat/ng';
+
+@Component({
+  selector: 'app-root',
+  standalone: true,
+  imports: [
+    CommonModule,
+    BubbleModule,
+  ],
+  templateUrl: './app.component.html',
+  styleUrl: './app.component.css',
+})
+export class AppComponent {
+}
+```
+
+在`angular.json`中引入图标库样式文件
+
+```json
+{
+    "options": {
+        "styles": [
+              "node_modules/@devui-design/icons/icomoon/devui-icon.css"
+            ],
+    }
+}
+```
+
+### 3. 使用
+
+在`main.ts`中初始化主题
+
+```ts
+import { bootstrapApplication } from '@angular/platform-browser';
+import { appConfig } from './app/app.config';
+import { AppComponent } from './app/app.component';
+import { ThemeServiceInit, infinityTheme } from 'devui-theme';
+ 
+// 使用无限主题
+ThemeServiceInit({ infinityTheme }, 'infinityTheme');
+bootstrapApplication(AppComponent, appConfig)
+  .catch((err) => console.error(err));
+
+```
+
+在`app.component.html`文件中使用 MateChat 组件，如：
+
+```html
+<template>
+  <mc-bubble [content]="'Hello, MateChat'" [avatarConfig]="{ name: 'matechat' }"></mc-bubble>
+</template>
+```
+
+## 📝 提出意见&建议
+
+我们非常欢迎您的建议，您的每一个想法都可能帮助我们改进这个项目。如果您有任何关于功能改进、特性新增、文档补充或者其他方面的建议，随时在 [issues](https://gitcode.com/DevCloudFE/MateChat/issues) 提交。
+
+## 🔧 本地开发
+
+```bash
+git clone git@gitcode.com:DevCloudFE/MateChat.git
+cd matechat
+pnpm i
+pnpm run docs:dev
+```
+
+## 📅 特性规划
+
+MateChat 在不断的演进中，你可在这里了解我们的计划：[MateChat 特性计划](https://gitcode.com/DevCloudFE/MateChat/issues/1)
+
+## 🤝 欢迎贡献
+
+我们诚挚地邀请您加入MateChat社区，一起参与项目的建设。无论您是经验丰富的开发者，还是刚刚起步的编程爱好者，您的贡献都对我们至关重要，这里是我们的[【贡献指南】](https://gitcode.com/DevCloudFE/MateChat/blob/main/CONTRIBUTING.md)。
+
+## 谁在使用
+
+[华为云CodeArts智能助手](https://www.huaweicloud.com/product/codeartside/snap.html)
+
+[InsCode AI IDE](https://inscode.csdn.net/)
+
+## License
+
+[MIT](https://gitcode.com/DevCloudFE/MateChat/blob/main/LICENSE)
+
+## 联系方式
+
+欢迎加入我们的开源社区，关注DevUI微信公众号：DevUI

package/components-common/Base/foundation.d.ts

@@ -8,6 +8,7 @@ export interface DefaultAdapter {
     getCache(c: string): any;
     getCaches(): any;
     setCache(key: any, value: any): void;
+    nextTick(cb: (...args: any) => void): void;
 }
 declare class BaseFoundation<T extends DefaultAdapter> {
     static get cssClasses(): {};
@@ -36,6 +37,7 @@ declare class BaseFoundation<T extends DefaultAdapter> {
     getCaches(): any;
     getCache(key: string): any;
     setCache(key: string, value: any): void | "";
+    nextTick(cb: (...args: any) => void): void;
     _isInProps(key: string): boolean;
     init(lifecycle?: any): void;
     destroy(): void;

package/components-common/MarkdownCard/codeblock-foundation.d.ts

@@ -0,0 +1,21 @@
+import BaseFoundation, { DefaultAdapter } from '../Base/foundation';
+import { MermaidService } from './common/MermaidService';
+import { MDCardService } from './common/MDCardService';
+export interface CodeBlockAdapter extends DefaultAdapter {
+    getContainer(): HTMLElement | null;
+    highlightCodeChange(code: string, language: string): void;
+}
+export declare class CodeBlockFoundation extends BaseFoundation<CodeBlockAdapter> {
+    mermaidService?: MermaidService;
+    mdCardService: MDCardService;
+    constructor(adapter: CodeBlockAdapter);
+    toggleExpand: () => void;
+    zoomOut: () => void;
+    zoomIn: () => void;
+    checkIsMermaid: () => any;
+    download: () => void;
+    handleCopySuccess: () => void;
+    copyCodeInternal(): void;
+    updateHighlightedCode: () => void;
+    renderMermaid: () => Promise<void>;
+}

package/components-common/MarkdownCard/common/MDCardService.d.ts

@@ -0,0 +1,14 @@
+import { type IWhiteList } from 'xss';
+import type { CustomXssRule, MdPlugin } from './mdCard.types.ts';
+export declare class MDCardService {
+    private xssWhiteList;
+    private cssWhiteList;
+    constructor();
+    private setDefaultXss;
+    private onIgnoreTagAttr;
+    getXssWhiteList(): IWhiteList;
+    setXssWhiteList(list: IWhiteList): void;
+    setCustomXssRules(rules: CustomXssRule[]): void;
+    setMdPlugins(plugins: MdPlugin[], mdt: any): void;
+    filterHtml(html: string): string;
+}

package/components-common/MarkdownCard/common/MermaidService.d.ts

@@ -0,0 +1,23 @@
+import type { MermaidConfig } from './mdCard.types';
+export declare class MermaidService {
+    private config;
+    private mermaidInstance;
+    private isLoading;
+    private lastValidResult;
+    private viewStateMap;
+    private containerHeight;
+    constructor(config?: MermaidConfig);
+    private loadMermaid;
+    renderToContainer(container: HTMLElement, code: string, theme?: 'light' | 'dark'): Promise<void>;
+    private initViewState;
+    private applyTransform;
+    zoomIn(container: HTMLElement): void;
+    zoomOut(container: HTMLElement): void;
+    reset(container: HTMLElement): void;
+    download(container: HTMLElement, filename?: string): Promise<void>;
+    private onSvgMouseDown;
+    private onSvgMouseMove;
+    private onSvgMouseUp;
+    renderMermaid(code: string, theme?: 'light' | 'dark'): Promise<string>;
+    setConfig(config?: MermaidConfig): void;
+}