pages/index: на главную страницу добавлен компонент чата, предлагающий начать общение

CLAUDE.md

@@ -11,13 +11,11 @@ Docuservix docs — шаблон документационного сайта
 
 ## Commands
 
-Используется **yarn**.
+- `npm start` — dev-сервер
-
+- `npm run build` — production-сборка в `build/`
-- `yarn start` — dev-сервер
+- `npm run typecheck` — проверка типов (tsc)
-- `yarn build` — production-сборка в `build/`
+- `npm run prettier:check` — проверка форматирования
-- `yarn typecheck` — проверка типов (tsc)
+- `npm run prettier:fix` — автоформатирование
-- `yarn prettier:check` — проверка форматирования
-- `yarn prettier:fix` — автоформатирование
 
 ## Architecture
 

docusaurus.config.ts

@@ -35,7 +35,7 @@ const config: Config = {
     markdown: {
         mermaid: true,
     },
-    plugins: [docuservix()],
+    plugins: [docuservix],
     themes: ['@docusaurus/theme-mermaid'],
 
     // Future flags, see https://docusaurus.io/docs/api/docusaurus-config#future

package.json

@@ -48,9 +48,7 @@
         "js-yaml": "^4.2.0",
         "prism-react-renderer": "^2.3.0",
         "react": "^19.0.0",
-        "react-dom": "^19.0.0",
+        "react-dom": "^19.0.0"
-        "react-markdown": "^10.1.0",
-        "remark-gfm": "^4.0.1"
     },
     "devDependencies": {
         "@docusaurus/module-type-aliases": "3.10.1",

plugins/docuservix/entities/markdown/MD.module.css

@@ -1,59 +0,0 @@
-.MD p:last-child {
-    margin-bottom: 0;
-}
-
-.MD p:first-child {
-    margin-top: 0;
-}
-
-.MD code {
-    padding: 0.15em 0.4em;
-    border-radius: 4px;
-    background: var(--ifm-color-emphasis-200);
-    font-size: 0.85em;
-}
-
-.MD pre {
-    margin: 0.5em 0;
-    padding: 0.75em;
-    overflow-x: auto;
-    border-radius: 6px;
-    background: var(--ifm-color-emphasis-100);
-}
-
-.MD pre code {
-    padding: 0;
-    background: none;
-}
-
-.MD ul,
-.MD ol {
-    padding-left: 1.5em;
-    margin: 0.5em 0;
-}
-
-.MD table {
-    width: 100%;
-    margin: 0.5em 0;
-    border-collapse: collapse;
-    font-size: 0.9em;
-}
-
-.MD th,
-.MD td {
-    padding: 0.4em 0.75em;
-    border: 1px solid var(--ifm-color-emphasis-300);
-    text-align: left;
-}
-
-.MD th {
-    background: var(--ifm-color-emphasis-100);
-    font-weight: var(--ifm-font-weight-semibold);
-}
-
-.MD blockquote {
-    margin: 0.5em 0;
-    padding: 0.25em 1em;
-    border-left: 3px solid var(--ifm-color-emphasis-300);
-    color: var(--ifm-color-emphasis-700);
-}

plugins/docuservix/entities/markdown/MD.tsx

@@ -1,17 +0,0 @@
-import React, { ReactNode } from 'react';
-import Markdown from 'react-markdown';
-import remarkGfm from 'remark-gfm';
-
-import styles from './MD.module.css';
-
-interface MDProps {
-    children: string;
-}
-
-export function MD({ children }: MDProps): ReactNode {
-    return (
-        <div className={styles.MD}>
-            <Markdown remarkPlugins={[remarkGfm]}>{children}</Markdown>
-        </div>
-    );
-}

plugins/docuservix/entities/markdown/index.ts

@@ -1 +0,0 @@
-export { MD } from './MD';

plugins/docuservix/index.ts

@@ -2,8 +2,7 @@ import path from 'path';
 
 import type { LoadContext, Plugin } from '@docusaurus/types';
 
-export default function docuservix() {
+function pluginDocuservix(_context: LoadContext): Plugin {
-    return function pluginDocuservix(_context: LoadContext): Plugin {
     return {
         name: 'docuservix',
 
@@ -27,5 +26,6 @@ export default function docuservix() {
             });
         },
     };
-    };
 }
+
+export default pluginDocuservix;

plugins/docuservix/pages/chat/ChatPage.tsx

@@ -12,7 +12,7 @@ const dialog: IChat = {
         },
         {
             role: 'assistant',
-            content: "Hello! I'm your **AI assistant**. How can I help you today?",
+            content: "Hello! I'm your AI assistant. How can I help you today?",
         },
     ],
 };
@@ -21,11 +21,7 @@ export function ChatPage(): ReactNode {
     return (
         <Layout title="Чат">
             <main className="container margin-vert--lg">
-                <Chat
+                <Chat dialog={dialog} />
-                    dialog={dialog}
-                    statusMessage="Unable to connect to the server"
-                    typing
-                />
             </main>
         </Layout>
     );

plugins/docuservix/widgets/chat/Chat.module.css

@@ -7,18 +7,3 @@
     border-radius: var(--ifm-global-radius);
     overflow: hidden;
 }
-
-.Chat__statusMessage {
-    font-size: .65rem;
-    color: #666;
-    bottom: 0;
-    left: 0;
-    right: 0;
-    padding: .75rem 2.5rem;
-    background: #eee;
-}
-
-.Chat__statusMessage i {
-    margin-right: .25rem;
-    color: #667eea;
-}

plugins/docuservix/widgets/chat/Chat.tsx

@@ -1,7 +1,7 @@
 import block from 'bem-css-modules';
 import React, { ReactNode } from 'react';
 
-import { IChat } from '@docuservix/models/chat';
+import { IChat, IChatMessage } from '@docuservix/models/chat';
 
 import styles from './Chat.module.css';
 import { Header } from './Header';
@@ -12,12 +12,11 @@ const b = block(styles, 'Chat');
 
 interface ChatProps {
     dialog: IChat;
-    typing?: boolean;
+    loading?: boolean;
-    statusMessage?: string;
     onSend?: (text: string) => void;
 }
 
-export function Chat({ dialog, typing, statusMessage, onSend }: ChatProps): ReactNode {
+export function Chat({ dialog, loading, onSend }: ChatProps): ReactNode {
     const { messages } = dialog;
 
     return (
@@ -25,11 +24,10 @@ export function Chat({ dialog, typing, statusMessage, onSend }: ChatProps): Reac
             <Header />
             <Messages
                 messages={messages}
-                typing={typing}
+                loading={loading}
             />
-            {statusMessage && <div className={b('statusMessage')}>{statusMessage}</div>}
             <Input
-                disabled={typing}
+                loading={loading}
                 onSend={onSend}
             />
         </div>

plugins/docuservix/widgets/chat/Input.module.css

@@ -33,9 +33,6 @@
 }
 
 .Input__send {
-    display: flex;
-    justify-content: center;
-    align-items: center;
     width: 3.25rem;
     height: 3.25rem;
     background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);

plugins/docuservix/widgets/chat/Input.tsx

@@ -7,17 +7,17 @@ import styles from './Input.module.css';
 const b = block(styles, 'Input');
 
 interface InputProps {
-    disabled?: boolean;
+    loading?: boolean;
     onSend?: (text: string) => void;
 }
 
-export function Input({ disabled, onSend }: InputProps): ReactNode {
+export function Input({ loading, onSend }: InputProps): ReactNode {
     const [input, setInput] = useState('');
 
     const handleSend = () => {
         const text = input.trim();
 
-        if (!text || disabled) {
+        if (!text || loading) {
             return;
         }
 
@@ -41,12 +41,12 @@ export function Input({ disabled, onSend }: InputProps): ReactNode {
                 onKeyDown={handleKeyDown}
                 placeholder="Type your message here..."
                 rows={1}
-                disabled={disabled}
+                disabled={loading}
             />
             <button
                 className={b('send')}
                 onClick={handleSend}
-                disabled={disabled || !input.trim()}
+                disabled={loading || !input.trim()}
             >
                 <PaperPlaneIcon />
             </button>

plugins/docuservix/widgets/chat/Message.module.css

@@ -1,5 +1,5 @@
 .Message {
-    max-width: 90%;
+    max-width: 85%;
     animation: slideIn 0.3s ease-out;
 }
 
@@ -34,8 +34,8 @@
     border-bottom-right-radius: 0.25rem;
 }
 
-@media (max-width: 576px) {
+@media (min-width: 576px) {
     .Message {
-        max-width: 100%;
+        max-width: 75%;
     }
 }

plugins/docuservix/widgets/chat/Message.tsx

@@ -1,8 +1,6 @@
 import block from 'bem-css-modules';
 import React, { ReactNode } from 'react';
 
-import { MD } from '@docuservix/entities/markdown';
-
 import styles from './Message.module.css';
 
 const b = block(styles, 'Message');
@@ -15,9 +13,7 @@ interface MessageProps {
 export function Message({ role, content }: MessageProps): ReactNode {
     return (
         <div className={b({ role })}>
-            <div className={b('content')}>
+            <div className={b('content')}>{content}</div>
-                <MD>{content}</MD>
-            </div>
         </div>
     );
 }

plugins/docuservix/widgets/chat/Messages.tsx

@@ -10,10 +10,10 @@ const b = block(styles, 'Messages');
 
 interface MessagesProps {
     messages: IChatMessage[];
-    typing?: boolean;
+    loading?: boolean;
 }
 
-export function Messages({ messages, typing }: MessagesProps): ReactNode {
+export function Messages({ messages, loading }: MessagesProps): ReactNode {
     return (
         <div className={b()}>
             {messages.map((msg, i) => (
@@ -24,7 +24,7 @@ export function Messages({ messages, typing }: MessagesProps): ReactNode {
                 />
             ))}
 
-            {typing && (
+            {loading && (
                 <div className={b('typing')}>
                     <div className={b('typingIndicator')}>
                         <span></span>

plugins/docuservix/widgets/chat/icons.tsx

@@ -1,30 +1,31 @@
-import React, { ReactNode } from 'react';
+import React from 'react';
 
-export function RobotIcon(): ReactNode {
+export function RobotIcon(props: React.SVGProps<SVGSVGElement>): JSX.Element {
     return (
         <svg
             xmlns="http://www.w3.org/2000/svg"
-            width="32"
+            viewBox="0 0 640 512"
-            height="32"
             fill="currentColor"
-            viewBox="0 0 16 16"
+            width="1em"
+            height="1em"
+            {...props}
         >
-            <path d="M6 12.5a.5.5 0 0 1 .5-.5h3a.5.5 0 0 1 0 1h-3a.5.5 0 0 1-.5-.5M3 8.062C3 6.76 4.235 5.765 5.53 5.886a26.6 26.6 0 0 0 4.94 0C11.765 5.765 13 6.76 13 8.062v1.157a.93.93 0 0 1-.765.935c-.845.147-2.34.346-4.235.346s-3.39-.2-4.235-.346A.93.93 0 0 1 3 9.219zm4.542-.827a.25.25 0 0 0-.217.068l-.92.9a25 25 0 0 1-1.871-.183.25.25 0 0 0-.068.495c.55.076 1.232.149 2.02.193a.25.25 0 0 0 .189-.071l.754-.736.847 1.71a.25.25 0 0 0 .404.062l.932-.97a25 25 0 0 0 1.922-.188.25.25 0 0 0-.068-.495c-.538.074-1.207.145-1.98.189a.25.25 0 0 0-.166.076l-.754.785-.842-1.7a.25.25 0 0 0-.182-.135" />
+            <path d="M320 0c17.7 0 32 14.3 32 32v64h120c48.6 0 88 39.4 88 88v272c0 48.6-39.4 88-88 88H168c-48.6 0-88-39.4-88-88V184c0-48.6 39.4-88 88-88h120V32c0-17.7 14.3-32 32-32zM208 384c-8.8 0-16 7.2-16 16s7.2 16 16 16h224c8.8 0 16-7.2 16-16s-7.2-16-16-16H208zm-48-96a32 32 0 1 0 0-64 32 32 0 1 0 0 64zm288-32a32 32 0 1 0 -64 0 32 32 0 1 0 64 0zM64 224c-17.7 0-32 14.3-32 32v64c0 17.7 14.3 32 32 32s32-14.3 32-32V256c0-17.7-14.3-32-32-32zm512 0c-17.7 0-32 14.3-32 32v64c0 17.7 14.3 32 32 32s32-14.3 32-32V256c0-17.7-14.3-32-32-32z" />
-            <path d="M8.5 1.866a1 1 0 1 0-1 0V3h-2A4.5 4.5 0 0 0 1 7.5V8a1 1 0 0 0-1 1v2a1 1 0 0 0 1 1v1a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2v-1a1 1 0 0 0 1-1V9a1 1 0 0 0-1-1v-.5A4.5 4.5 0 0 0 10.5 3h-2zM14 7.5V13a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1V7.5A3.5 3.5 0 0 1 5.5 4h5A3.5 3.5 0 0 1 14 7.5" />
         </svg>
     );
 }
 
-export function PaperPlaneIcon(): ReactNode {
+export function PaperPlaneIcon(props: React.SVGProps<SVGSVGElement>): JSX.Element {
     return (
         <svg
             xmlns="http://www.w3.org/2000/svg"
-            width="24"
+            viewBox="0 0 512 512"
-            height="24"
             fill="currentColor"
-            viewBox="0 0 16 16"
+            width="1em"
+            height="1em"
+            {...props}
         >
-            <path d="M15.964.686a.5.5 0 0 0-.65-.65L.767 5.855H.766l-.452.18a.5.5 0 0 0-.082.887l.41.26.001.002 4.995 3.178 3.178 4.995.002.002.26.41a.5.5 0 0 0 .886-.083zm-1.833 1.89L6.637 10.07l-.215-.338a.5.5 0 0 0-.154-.154l-.338-.215 7.494-7.494 1.178-.471z" />
+            <path d="M498.1 5.6c10.1 7 15.4 19.1 13.5 31.2l-64 416c-1.5 9.7-7.4 18.2-16 23s-18.9 5.4-28 1.6L284 427.7l-68.5 74.1c-8.9 9.7-22.9 12.9-35.2 8.1S160 googl492.3 160 480v-83.6c0-4 1.5-7.8 4.2-10.7l167.6-182.8c5.8-6.3 5.4-16.1-.9-21.9s-16.1-5.4-21.9 .9L106.2 350.8 13.7 313.4C3.2 309 -2 297.3 .5 286.4s11.3-18.9 22.4-21L490.5 .6c10.1-2 20.6 1.7 27.6 8.7L498.1 5.6z" />
         </svg>
     );
 }

src/pages/index.tsx

@@ -1,12 +1,26 @@
 import Link from '@docusaurus/Link';
+import { useHistory } from '@docusaurus/router';
+import useBaseUrl from '@docusaurus/useBaseUrl';
 import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
 import Heading from '@theme/Heading';
 import Layout from '@theme/Layout';
 import clsx from 'clsx';
 import type { ReactNode } from 'react';
 
+import { IChat } from '@docuservix/models/chat';
+import { Chat } from '@docuservix/widgets/chat';
+
 import styles from './index.module.css';
 
+const startDialog: IChat = {
+    messages: [
+        {
+            role: 'assistant',
+            content: 'Чем могу помочь?',
+        },
+    ],
+};
+
 function HomepageHeader() {
     const { siteConfig } = useDocusaurusContext();
 
@@ -35,6 +49,12 @@ function HomepageHeader() {
 
 export default function Home(): ReactNode {
     const { siteConfig } = useDocusaurusContext();
+    const history = useHistory();
+    const chatUrl = useBaseUrl('/chat');
+
+    const handleSend = (text: string) => {
+        history.push(`${chatUrl}?q=${encodeURIComponent(text)}`);
+    };
 
     return (
         <Layout
@@ -42,6 +62,12 @@ export default function Home(): ReactNode {
             description="Description will go into a meta tag in <head />"
         >
             <HomepageHeader />
+            <main className="container margin-vert--lg">
+                <Chat
+                    dialog={startDialog}
+                    onSend={handleSend}
+                />
+            </main>
         </Layout>
     );
 }

yarn.lock

@@ -7308,11 +7308,6 @@ html-tags@^3.3.1:
   resolved "https://registry.yarnpkg.com/html-tags/-/html-tags-3.3.1.tgz#a04026a18c882e4bba8a01a3d39cfe465d40b5ce"
   integrity sha512-ztqyC3kLto0e9WbNp0aeP+M3kTt+nbaIveGmUxAtZa+8iFgKLUOD4YKM5j+f3QD89bra7UeumolZHKuOXnTmeQ==
 
-html-url-attributes@^3.0.0:
-  version "3.0.1"
-  resolved "https://registry.yarnpkg.com/html-url-attributes/-/html-url-attributes-3.0.1.tgz#83b052cd5e437071b756cd74ae70f708870c2d87"
-  integrity sha512-ol6UPyBWqsrO6EJySPz2O7ZSr856WDrEzM5zMqp+FJJLGMW35cLYmmZnl0vztAZxRUoNZJFTCohfjuIJ8I4QBQ==
-
 html-void-elements@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/html-void-elements/-/html-void-elements-3.0.0.tgz#fc9dbd84af9e747249034d4d62602def6517f1d7"
@@ -10561,23 +10556,6 @@ react-loadable-ssr-addon-v5-slorber@^1.0.3:
   dependencies:
     "@types/react" "*"
 
-react-markdown@^10.1.0:
-  version "10.1.0"
-  resolved "https://registry.yarnpkg.com/react-markdown/-/react-markdown-10.1.0.tgz#e22bc20faddbc07605c15284255653c0f3bad5ca"
-  integrity sha512-qKxVopLT/TyA6BX3Ue5NwabOsAzm0Q7kAPwq6L+wWDwisYs7R8vZ0nRXqq6rkueboxpkjvLGU9fWifiX/ZZFxQ==
-  dependencies:
-    "@types/hast" "^3.0.0"
-    "@types/mdast" "^4.0.0"
-    devlop "^1.0.0"
-    hast-util-to-jsx-runtime "^2.0.0"
-    html-url-attributes "^3.0.0"
-    mdast-util-to-hast "^13.0.0"
-    remark-parse "^11.0.0"
-    remark-rehype "^11.0.0"
-    unified "^11.0.0"
-    unist-util-visit "^5.0.0"
-    vfile "^6.0.0"
-
 react-router-config@^5.1.1:
   version "5.1.1"
   resolved "https://registry.yarnpkg.com/react-router-config/-/react-router-config-5.1.1.tgz#0f4263d1a80c6b2dc7b9c1902c9526478194a988"
@@ -10831,7 +10809,7 @@ remark-frontmatter@^5.0.0:
     micromark-extension-frontmatter "^2.0.0"
     unified "^11.0.0"
 
-remark-gfm@^4.0.0, remark-gfm@^4.0.1:
+remark-gfm@^4.0.0:
   version "4.0.1"
   resolved "https://registry.yarnpkg.com/remark-gfm/-/remark-gfm-4.0.1.tgz#33227b2a74397670d357bf05c098eaf8513f0d6b"
   integrity sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==