[ { "path": ".editorconfig", "content": "# EditorConfig is awesome: https://EditorConfig.org\n\n# top-most EditorConfig file\nroot = true\n\n# Unix-style newlines with a newline ending every file\n[*]\nend_of_line = lf\ninsert_final_newline = true\n\n# Matches multiple files with brace expansion notation\n# Set default charset\n[*.{js,jsx,cjs,mjs,ts,tsx,cts,mts,css,scss,json}]\ncharset = utf-8\nindent_style = space\nindent_size = 2\n" }, { "path": ".githooks/commit-msg", "content": "#!/bin/sh\nnpx --no -- commitlint --edit \"$1\"\nnpx tsx pre-commit.ts\n" }, { "path": ".github/workflows/ci.yml", "content": "name: CI\n\non:\n push:\n branches:\n - main\n\n pull_request:\n branches:\n - main\n\njobs:\n typecheck:\n runs-on: ubuntu-latest\n steps:\n - name: Checkout the repository\n uses: actions/checkout@v4\n\n - name: Set up Node.js\n uses: actions/setup-node@v4\n with:\n node-version: lts/*\n\n - name: Install dependencies\n run: npm ci\n\n - name: Typecheck\n run: npm run typecheck\n\n lint:\n runs-on: ubuntu-latest\n steps:\n - name: Checkout the repository\n uses: actions/checkout@v4\n\n - name: Set up Node.js\n uses: actions/setup-node@v4\n with:\n node-version: lts/*\n\n - name: Install dependencies\n run: npm ci\n\n - name: Lint\n run: npm run lint\n\n test:\n runs-on: ubuntu-latest\n\n strategy:\n matrix:\n node-version: [20.x, 22.x, 24.x]\n # See supported Node.js release schedule at https://nodejs.org/en/about/releases/\n\n steps:\n - name: Checkout the repository\n uses: actions/checkout@v4\n\n - name: Set up Node.js ${{ matrix.node-version }}\n uses: actions/setup-node@v4\n with:\n node-version: ${{ matrix.node-version }}\n cache: npm\n\n - name: Install dependencies\n run: npm ci --ignore-scripts\n\n - name: Test types\n run: npm run test-types\n\n - name: Test\n run: npm test\n" }, { "path": ".gitignore", "content": "# Logs\nlogs\n*.log\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\npnpm-debug.log*\nlerna-debug.log*\n\nnode_modules\ndist\ndist-ssr\n*.local\n\n# Editor directories and files\n.vscode/*\n!.vscode/settings.json\n!.vscode/extensions.json\n.idea\n.DS_Store\n*.suo\n*.ntvs*\n*.njsproj\n*.sln\n*.sw?\n" }, { "path": ".vscode/settings.json", "content": "{\n \"cSpell.words\": [\"reqnode\"],\n \"stylelint.validate\": [\"css\", \"scss\"]\n}\n" }, { "path": "LICENSE", "content": "MIT License\n\nCopyright (c) 2023 Snowflyt\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "README.md", "content": "# Typora Copilot\n\nEnglish | [简体中文](./README.zh-CN.md)\n\n![Copilot suggestion screenshot](./docs/screenshot.png)\n\n[GitHub Copilot](https://github.com/features/copilot) & [Copilot Chat](https://docs.github.com/copilot/using-github-copilot/copilot-chat) plugin for [Typora](https://typora.io/) on both Windows, macOS and Linux.\n\nThis plugin uses the [official GitHub Copilot LSP server](https://www.npmjs.com/package/@github/copilot-language-server) to provide suggestions in real-time right from your editor.\n\n## Compatibility\n\n> [!NOTE]\n>\n> Since Typora v1.10, all platforms require [Node.js](https://nodejs.org/en/download) ≥ 20 to use this plugin.\n>\n> (For those special users on Windows / Linux using Typora 1.9, no need for Node.js to be installed. :wink:)\n\n_\\*Note: `/` means not tested._\n\n| Typora Version | Windows 11 | Ubuntu 24.04 | macOS 15.x |\n| -------------- | ---------- | ------------ | ---------- |\n| 1.12.6 | / | / | ✓ |\n| 1.12.4 | ✓ | / | / |\n| 1.11.7 | ✓ | / | ✓ |\n| 1.10.8 | ✓ | ✓ | ✓ |\n| 1.10.6 | ✓ | ✓ | ✓ |\n| 1.9.5 | ✓ | / | / |\n| 1.9.4 | / | / | ✓ |\n| 1.9.3 | / | ✓ | / |\n| 1.8.10 | ✓ | ✓ | ✓ |\n| 1.8.8 | / | ✓ | / |\n| 1.8.6 | ✓ | / | / |\n| 1.8.5 | ✓ | / | ✓ |\n| 1.7.6 | ✓ | / | / |\n| 1.6.7 | ✓ | / | / |\n| 1.5.12 | ✓ | / | / |\n| 1.4.8 | ✓ | / | / |\n| 1.3.8 | ✓ | / | / |\n| 1.2.5 | ✓ | / | / |\n| 1.2.3 | ✓ | / | / |\n| 1.0.3 | ✓ | / | / |\n| 0.11.18-beta | ✓ | / | / |\n\n## Prerequisites\n\n- Public network connection.\n- Active GitHub Copilot subscription.\n\n## Installation\n\n**Before installing using any method, make sure Typora is fully closed (especially on macOS: use ⌘+Q to quit).**\n\n### Automated Installation (Recommended)\n\nTo install the plugin, you can just copy and paste the following command into your terminal:\n\n
\n Windows\n\nRun the following command in PowerShell **as administrator**:\n\n```powershell\niwr -Uri \"https://raw.githubusercontent.com/Snowflyt/typora-copilot/main/install.ps1\" | iex\n```\n\n
\n\n
\n macOS\n\nRun the following command in your terminal:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/Snowflyt/typora-copilot/main/install.sh | sudo bash\n```\n\n
\n\n
\n Linux\n\nRun the following command in your terminal:\n\n```bash\nwget -O - https://raw.githubusercontent.com/Snowflyt/typora-copilot/main/install.sh | sudo bash\n```\n\n
\n\n### Script Install\n\n
\n Windows\n\nFor Windows users, first download the latest release from [the releases page](https://github.com/Snowflyt/typora-copilot/releases) and unzip it. Then locate to the folder where you unzipped the release and run the following command in PowerShell **as administrator**:\n\n```powershell\n.\\bin\\install_windows.ps1\n```\n\nIf the script fails to find Typora, you can specify the path to Typora manually:\n\n```powershell\n.\\bin\\install_windows.ps1 -Path \"C:\\Program Files\\Typora\\\" # Replace with your Typora path\n# Or use the alias\n# .\\bin\\install_windows.ps1 -p \"C:\\Program Files\\Typora\\\" # Replace with your Typora path\n```\n\n
\n\n
\n macOS\n\nFor macOS users, first download the latest release from [the releases page](https://github.com/Snowflyt/typora-copilot/releases) and unzip it. Then locate to the folder where you unzipped the release and run the following command in terminal:\n\n```bash\nsudo bash ./bin/install_macos.sh\n```\n\nIf the script fails to find Typora, you can specify the path to Typora manually:\n\n```bash\nsudo bash ./bin/install_macos.sh --path \"/Applications/Typora.app/\" # Replace with your Typora path\n# Or use the alias\n# sudo bash ./bin/install_macos.sh -p \"/Applications/Typora.app/\" # Replace with your Typora path\n```\n\nYou’ll see a message logging the installation directory of the plugin. _Keep it in mind, you’ll need it when uninstalling the plugin._ After that, you can safely delete the release folder.\n\n
\n\n
\n Linux\n\nFor Linux users, first download the latest release from [the releases page](https://github.com/Snowflyt/typora-copilot/releases) and unzip it. THen locate to the folder where you unzipped the release and run the following command in terminal:\n\n```bash\nsudo bash ./bin/install_linux.sh\n```\n\nIf the script fails to find Typora, you can specify the path to Typora manually:\n\n```bash\nsudo bash ./bin/install_linux.sh --path \"/usr/share/typora/\" # Replace with your Typora path\n# Or use the alias\n# sudo bash ./bin/install_linux.sh -p \"/usr/share/typora/\" # Replace with your Typora path\n```\n\nYou’ll see a message logging the installation directory of the plugin. _Keep it in mind, you’ll need it when uninstalling the plugin._ After that, you can safely delete the release folder.\n\n
\n\n### Manual Install\n\n
\n Click to expand\n\n1. Download the latest release from [the releases page](https://github.com/Snowflyt/typora-copilot/releases) and unzip it.\n2. For Windows / Linux users, find `window.html` in your Typora installation folder, usually located at `/resources/`; For macOS users, find `index.html` in your Typora installation folder, usually located at `/Contents/Resources/TypeMark/`. `` is the path where Typora is installed, replace it with your real Typora installation path (note that the angle brackets `<` and `>` should also be removed). This folder is called Typora resource folder in the following steps.\n3. Create a folder named `copilot` in Typora resource folder.\n4. Copy the contents of the unzipped release into the `copilot` folder. **Ensure the final path is `copilot/index.js` (not `copilot/typora-copilot/index.js`). If you see the latter, move the files up one level so `index.js` sits directly under `copilot`.**\n5. For Windows / Linux users, open the previous `window.html` file you found in Typora resource folder with a text editor, and add `` right after something like `` or ``; For macOS users, open the previous `index.html` file you found in Typora resource folder with a text editor, and add `` right after something like `` or ``.\n6. Restart Typora.\n7. For macOS users, if you see a warning dialog saying Typora may be damaged, Ctrl-click Typora and select “Open” to open Typora.\n\n
\n\n## Setup\n\nWhen finished installation, you’ll find an icon in the toolbar of Typora (i.e. the bottom-right corner of Typora). Click **the arrow button** next to the icon to open the panel of Copilot, and then click “Sign in to authenticate Copilot”.\n\n![Copilot icon](./docs/toolbar-icon.png)\n\nFollow the prompts to authenticate Copilot plugin:\n\n1. The User Code will be auto copied to your clipboard.\n2. Follow the instructions on the pop-up dialog to open the GitHub authentication page in your browser.\n3. Paste the User Code into the GitHub authentication page.\n4. Return to Typora and press OK on the dialog.\n5. If you see a “Signed in to Copilot” dialog _after a few seconds_, Copilot plugin should start working since then.\n\n## Copilot Chat\n\nClicking the Copilot icon in the toolbar will toggle the Copilot Chat panel. You can use it to chat with Copilot, and the current document and previous chat history will be sent to Copilot as context.\n\nMake sure you have signed in to Copilot before using the Copilot Chat panel. After signing in, restart Typora to make sure the Copilot Chat panel works properly.\n\nYou can:\n\n- Select, create, edit chat title, or delete a chat session from the dropdown list at the top of the panel.\n- Click the “Send” button or press Enter to send the message. (You can use Shift + Enter or Ctrl + Enter to insert a new line.)\n- Click the “Stop” button to stop the current request.\n- Select a prompt style from the dropdown list at the bottom of the panel.\n- Pick the model you want to use from the dropdown list at the bottom of the panel.\n\n## Uninstallation\n\n### Automated Uninstallation (Recommended)\n\nTo uninstall the plugin, you can just copy and paste the following command into your terminal:\n\n
\n Windows\n\nRun the following command in PowerShell **as administrator**:\n\n```powershell\niwr -Uri \"https://raw.githubusercontent.com/Snowflyt/typora-copilot/main/bin/uninstall_windows.ps1\" | iex\n```\n\n
\n\n
\n macOS\n\nRun the following command in your terminal:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/Snowflyt/typora-copilot/main/bin/uninstall_macos.sh | sudo bash\n```\n\n
\n\n
\n Linux\n\nRun the following command in your terminal:\n\n```bash\nwget -O - https://raw.githubusercontent.com/Snowflyt/typora-copilot/main/bin/uninstall_linux.sh | sudo bash\n```\n\n
\n\n### Script Uninstall\n\n
\n Windows\n\nFor Windows users, locate to the installation directory of the plugin and run the following command in PowerShell **as administrator**.\n\n```powershell\n.\\bin\\uninstall_windows.ps1\n```\n\nYou can still specify the path to Typora manually by adding `-Path` or `-p`, just like the installation script.\n\n
\n\n
\n macOS\n\nFor macOS users, locate to the installation directory of the plugin and run the following command in terminal.\n\n```bash\nsudo bash ./bin/uninstall_macos.sh\n```\n\nYou can still specify the path to Typora manually by adding `--path` or `-p`, just like the installation script.\n\n
\n\n
\n Linux\n\nFor Linux users, locate to the installation directory of the plugin and run the following command in terminal.\n\n```bash\nsudo bash ./bin/uninstall_linux.sh\n```\n\nYou can still specify the path to Typora manually by adding `--path` or `-p`, just like the installation script.\n\n
\n\n### Manual Uninstall\n\n
\n Click to expand\n\n1. For Windows / Linux users, find `window.html` in your Typora installation folder, usually located at `/resources/`; For macOS users, find `index.html` in your Typora installation folder, usually located at `/Contents/Resources/TypeMark/`. `` is the path where Typora is installed, replace it with your real Typora installation path (note that the angle brackets `<` and `>` should also be removed). This folder is called Typora resource folder in the following steps.\n2. Delete the `copilot` folder in Typora resource folder.\n3. For Windows / Linux users, open the previous `window.html` file you found in Typora resource folder with a text editor, and delete ``; For macOS users, open the previous `index.html` file you found in Typora resource folder with a text editor, and delete ``.\n4. Restart Typora.\n
\n\n## Known Issues\n\n1. Sometimes accepting a suggestion may cause the editor rerendering (i.e. code blocks, math blocks, etc. will be rerendered). This is due to the limitation of Typora's API that I have to force the editor to rerender sometimes to accept a suggestion, and currently I can't find a more safe and efficient way to resolve this issue.\n\n## FAQs\n\n### How to temporarily disable Copilot?\n\nJust click the Copilot icon in the toolbar, and then click “Disable completions”. You can enable it again by clicking the icon and then clicking “Enable completions”.\n\n### Why use suggestion panel in live preview mode (normal mode) and completion text in source mode by default? Can I change that?\n\nThe usage of suggestion panel in live preview mode is intentional. Typora uses a complex mechanism to render the content in live preview mode, it is hard to make completion text work properly in live preview mode.\n\nBut it is possible to also use suggestion panel in source mode, you can click the `toolbar icon -> Settings` and toggle the `Use inline completion text in source mode` option.\n\nAn option called `Use inline completion text in preview code blocks` is also provided. If you enable this option, the completion text instead of suggestion panel will also be used in code blocks and math blocks in live preview mode. But it is currently not recommended to enable this option, as it is likely to corrupt the editor content or history.\n\n### Can I use keys other than `Tab` to accept suggestions?\n\nCurrently, no. It is technically possible, but currently I don't have enough time to implement it. Maybe I will implement it in the future.\n" }, { "path": "README.zh-CN.md", "content": "# Typora Copilot\n\n[English](./README.md) | 简体中文\n\n![Copilot 建议截图](./docs/screenshot.zh-CN.png)\n\n[Typora](https://typora.io/) 的 [GitHub Copilot](https://github.com/features/copilot) & [Copilot Chat](https://docs.github.com/copilot/using-github-copilot/copilot-chat) 插件，支持 Windows、macOS 和 Linux。\n\n该插件使用 [GitHub Copilot 官方提供的 LSP 服务](https://www.npmjs.com/package/@github/copilot-language-server)，以在编辑器中实时提供建议。\n\n## 兼容性\n\n> [!NOTE]\n>\n> 自 Typora v1.10 起，所有平台都需要安装 [Node.js](https://nodejs.org/zh-cn/download) ≥ 20 才能使用本插件。\n>\n> （仅对于使用 Typora 1.9 的 Windows / Linux 用户，无需安装 Node.js。 :wink:）\n\n_\\*注：`/` 表示未经过测试。_\n\n| Typora Version | Windows 11 | Ubuntu 24.04 | macOS 15.x |\n| -------------- | ---------- | ------------ | ---------- |\n| 1.12.6 | / | / | ✓ |\n| 1.12.4 | ✓ | / | / |\n| 1.11.7 | ✓ | / | ✓ |\n| 1.10.8 | ✓ | ✓ | ✓ |\n| 1.10.6 | ✓ | ✓ | ✓ |\n| 1.9.5 | ✓ | / | / |\n| 1.9.4 | / | / | ✓ |\n| 1.9.3 | / | ✓ | / |\n| 1.8.10 | ✓ | ✓ | ✓ |\n| 1.8.8 | / | ✓ | / |\n| 1.8.6 | ✓ | / | / |\n| 1.8.5 | ✓ | / | ✓ |\n| 1.7.6 | ✓ | / | / |\n| 1.6.7 | ✓ | / | / |\n| 1.5.12 | ✓ | / | / |\n| 1.4.8 | ✓ | / | / |\n| 1.3.8 | ✓ | / | / |\n| 1.2.5 | ✓ | / | / |\n| 1.2.3 | ✓ | / | / |\n| 1.0.3 | ✓ | / | / |\n| 0.11.18-beta | ✓ | / | / |\n\n## 前置条件\n\n- 公网连接（对于中国大陆用户，你还需要确保你的网络可以正常访问 GitHub Copilot 服务）。\n- 已激活的 GitHub Copilot 订阅。\n\n## 安装\n\n**开始任何安装方式之前，请先完全退出 Typora（尤其是 macOS 用户：请使用 ⌘+Q 退出）。**\n\n### 一键安装（推荐）\n\n你可以直接将以下命令复制粘贴到你的终端中来安装插件：\n\n
\n Windows\n\n以**管理员身份**在 PowerShell 中运行以下命令：\n\n```powershell\niwr -Uri \"https://raw.githubusercontent.com/Snowflyt/typora-copilot/main/install.ps1\" | iex\n```\n\n
\n\n
\n macOS\n\n在终端中运行以下命令：\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/Snowflyt/typora-copilot/main/install.sh | sudo bash\n```\n\n
\n\n
\n Linux\n\n在终端中运行以下命令：\n\n```bash\nwget -O - https://raw.githubusercontent.com/Snowflyt/typora-copilot/main/install.sh | sudo bash\n```\n\n
\n\n### 脚本安装\n\n
\n Windows\n\n对于 Windows 用户，首先从[发布页面](https://github.com/Snowflyt/typora-copilot/releases)下载最新版本并解压。然后定位到你解压的文件夹并在 PowerShell 中**以管理员身份**运行以下命令：\n\n```powershell\n.\\bin\\install_windows.ps1\n```\n\n如果脚本无法找到 Typora，你可以手动指定 Typora 的路径：\n\n```powershell\n.\\bin\\install_windows.ps1 -Path \"C:\\Program Files\\Typora\\\" # 替换为你的 Typora 路径\n# 或使用别名\n# .\\bin\\install_windows.ps1 -p \"C:\\Program Files\\Typora\\\" # 替换为你的 Typora 路径\n```\n\n安装过程中，你会看到一条消息记录插件的安装目录。_记住它，在卸载插件时你会需要它。_ 安装完成后，你可以安全地删除刚才解压的文件夹。\n\n
\n\n
\n macOS\n\n对于 macOS 用户，首先从[发布页面](https://github.com/Snowflyt/typora-copilot/releases)下载最新版本并解压。然后定位到你解压的文件夹并在终端中运行以下命令：\n\n```bash\nsudo bash ./bin/install_macos.sh\n```\n\n如果脚本无法找到 Typora，你可以手动指定 Typora 的路径：\n\n```bash\nsudo bash ./bin/install_macos.sh --path \"/Applications/Typora.app/\" # 替换为你的 Typora 路径\n# 或使用别名\n# sudo bash ./bin/install_macos.sh -p \"/Applications/Typora.app/\" # 替换为你的 Typora 路径\n```\n\n安装过程中，你会看到一条消息记录插件的安装目录。_记住它，在卸载插件时你会需要它。_ 安装完成后，你可以安全地删除刚才解压的文件夹。\n\n
\n\n
\n Linux\n\n对于 Linux 用户，首先从[发布页面](https://github.com/Snowflyt/typora-copilot/releases)下载最新版本并解压。然后定位到你解压的文件夹并在终端中运行以下命令：\n\n```bash\nsudo bash ./bin/install_linux.sh\n```\n\n如果脚本无法找到 Typora，你可以手动指定 Typora 的路径：\n\n```bash\nsudo bash ./bin/install_linux.sh --path \"/usr/share/typora/\" # 替换为你的 Typora 路径\n# 或使用别名\n# sudo bash ./bin/install_linux.sh -p \"/usr/share/typora/\" # 替换为你的 Typora 路径\n```\n\n安装过程中，你会看到一条消息记录插件的安装目录。_记住它，在卸载插件时你会需要它。_ 安装完成后，你可以安全地删除刚才解压的文件夹。\n\n
\n\n### 手动安装\n\n
\n 点击展开\n\n1. 从[发布页面](https://github.com/Snowflyt/typora-copilot/releases)下载最新版本并解压。\n2. 找到 Typora 安装目录下的 `window.html` 文件，通常位于 `/resources/`；对于 macOS 用户，找到 Typora 安装目录下的 `index.html` 文件，通常位于 `/Contents/Resources/TypeMark/`。`` 是 Typora 的安装路径，替换为你的实际 Typora 安装路径（注意尖括号 `<` 和 `>` 也要删除）。这个文件夹在下面的步骤中被称为 Typora 资源文件夹。\n3. 在 Typora 资源文件夹中创建一个名为 `copilot` 的文件夹。\n4. 将解压后的文件全部复制到 `copilot` 文件夹中。**请确保最终路径为 `copilot/index.js`（而不是 `copilot/typora-copilot/index.js`）。如果出现后者，请将 `typora-copilot` 文件夹内的内容上移一层，使 `index.js` 直接位于 `copilot` 下。**\n5. 对于 Windows / Linux 用户，在 Typora 资源文件夹中用文本编辑器打开 `window.html`，在类似 `` 或 `` 的代码之后添加 ``；对于 macOS 用户，在 Typora 资源文件夹中用文本编辑器打开 `index.html`，在类似 `` 或 `` 的代码之后添加 ``。\n6. 重启 Typora。\n7. 对于 macOS 用户，如果你在打开 Typora 时被提示“文件已损坏”，你可以按住 Ctrl 点击 Typora，并选择“打开”来打开 Typora.\n\n
\n\n## 初始化\n\n完成安装后，你会在 Typora 工具栏（即界面底部右下角）找到一个 Copilot 图标。点击**它右侧的箭头**，你会看到一个下拉菜单，然后点击“登录以认证 Copilot”。\n\n![Copilot 图标](./docs/toolbar-icon.zh-CN.png)\n\n> [!CAUTION]\n>\n> 如果你在中国大陆，登录这一步很可能因为网络原因失败。如果你发现点击按钮后很长时间没有反应，尝试按 Shift+F12（Windows 或 Linux）或在帮助菜单中打开“Enable Debugging”并在任意位置右键选择检查元素（macOS），以打开调试工具，定位到“控制台”或“Console”标签页，将过滤级别调整为“详细”或“Verbose”。然后查看控制台中打印的日志信息，以检查是否存在网络问题。\n>\n> 如果你看到一条来自“SignInInitiate”的红色错误信息，其中包含“ETIMEOUT”这样的内容，说明这一步因网络原因失败了。尝试调整你的代理软件设置，打开类似“增强代理”或“TUN 模式”的选项，重启 Typora 再进行尝试；或者，对于 Windows 用户可以使用使用 Proxifier 配置全局代理，对于 macOS / Linux 用户可以使用 Proxychains 打开 Typora，再进行尝试。\n\n按照提示进行身份验证：\n\n1. 用户代码会自动复制到你的剪贴板。\n2. 遵照弹出提示上的说明，打开 GitHub 身份验证页面。\n3. 将用户代码粘贴到 GitHub 身份验证页面中。\n4. 返回 Typora 并在对话框中按下“确定”按钮。\n5. 如果你在**几秒钟后**看到一个“已登录 GitHub Copilot”对话框，Copilot 插件应该就可以正常工作了（在中国大陆，你可能需要等待更长的时间）。\n\n## Copilot Chat\n\n点击工具栏中的 Copilot 图标将切换 Copilot Chat 面板。你可以使用它与 Copilot 聊天，当前文档和之前的聊天记录将作为上下文发送给 Copilot。\n\n确保在使用 Copilot Chat 面板之前已登录 Copilot。登录后，重启 Typora 以确保 Copilot Chat 面板正常工作。\n\n你可以：\n\n- 从面板顶部的下拉列表中选择、创建、编辑聊天标题，或删除聊天会话。\n- 点击“发送”按钮或按下 Enter 键发送消息。（你可以使用 Shift + Enter 或 Ctrl + Enter 插入新行。）\n- 点击“停止”按钮停止当前请求。\n- 从面板底部的下拉列表中选择提示样式。\n- 从面板底部的下拉列表中选择要使用的模型。\n\n## 卸载\n\n### 一键卸载（推荐）\n\n要卸载插件，你可以直接将以下命令复制粘贴到你的终端中：\n\n
\n Windows\n\n以**管理员身份**在 PowerShell 中运行以下命令：\n\n```powershell\niwr -Uri \"https://raw.githubusercontent.com/Snowflyt/typora-copilot/main/bin/uninstall_windows.ps1\" | iex\n```\n\n
\n\n
\n macOS\n\n在终端中运行以下命令：\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/Snowflyt/typora-copilot/main/bin/uninstall_macos.sh | sudo bash\n```\n\n
\n\n
\n Linux\n\n在终端中运行以下命令：\n\n```bash\nwget -O - https://raw.githubusercontent.com/Snowflyt/typora-copilot/main/bin/uninstall_linux.sh | sudo bash\n```\n\n
\n\n### 脚本卸载\n\n
\n Windows\n\n对于 Windows 用户，定位到插件安装目录并在 PowerShell 中**以管理员身份**运行以下命令：\n\n```powershell\n.\\bin\\uninstall_windows.ps1\n```\n\n和安装时一样，如果脚本无法找到 Typora，你可以手动通过 `-Path` 或 `-p` 参数指定 Typora 的路径。\n\n
\n\n
\n macOS\n\n对于 macOS 用户，定位到插件安装目录并在终端中运行以下命令：\n\n```bash\nsudo bash ./bin/uninstall_macos.sh\n```\n\n和安装时一样，如果脚本无法找到 Typora，你可以手动通过 `--path` 或 `-p` 参数指定 Typora 的路径。\n\n
\n\n
\n Linux\n\n对于 Linux 用户，定位到插件安装目录并在终端中运行以下命令：\n\n```bash\nsudo bash ./bin/uninstall_linux.sh\n```\n\n和安装时一样，如果脚本无法找到 Typora，你可以手动通过 `--path` 或 `-p` 参数指定 Typora 的路径。\n\n
\n\n### 手动卸载\n\n
\n 点击展开\n\n1. 找到 Typora 安装目录下的 `window.html` 文件，通常位于 `/resources/`；对于 macOS 用户，找到 Typora 安装目录下的 `index.html` 文件，通常位于 `/Contents/Resources/TypeMark/`. `` 是 Typora 的安装路径，替换为你的实际 Typora 安装路径（注意尖括号 `<` 和 `>` 也要删除）。这个文件夹在下面的步骤中被称为 Typora 资源文件夹。\n2. 删除 Typora 资源文件夹中的 `copilot` 文件夹。\n3. 对于 Windows / Linux 用户，在 Typora 资源文件夹中用文本编辑器打开 `window.html`，删除 ``；对于 macOS 用户，在 Typora 资源文件夹中用文本编辑器打开 `index.html`，删除 ``.\n4. 重启 Typora.\n
\n\n## 已知问题\n\n1. 有时接受建议可能会导致编辑器重新渲染（即代码块、数学块等将重新渲染）。这是由于 Typora API 的限制，我必须有时强制编辑器重新渲染以接受建议，目前我找不到更安全和更高效的方法来解决这个问题。\n\n## 常见问题\n\n### 如何临时禁用 Copilot？\n\n点击工具栏中的 Copilot 图标，然后点击“禁用建议”即可。你可以通过点击图标然后点击“启用建议”来重新启用它。\n\n### 为什么默认在实时预览模式（正常模式）下使用建议面板，在源代码模式下使用补全文本？我能修改这一配置吗？\n\n在实时预览模式下使用建议面板是有意的。Typora 在实时预览模式下的渲染机制很复杂，很难使补全文本在实时预览模式下正常工作。\n\n不过对于源代码模式，你可以通过点击 `工具栏图标 -> 设置` 并切换 `在源代码模式下使用内联补全文本` 选项来在源代码模式下使用建议面板。\n\n设置中还提供了一个名为 `在预览模式代码块中使用内联补全文本` 的选项。如果你启用了这个选项，补全文本将会在实时预览模式下的代码块和数学块中使用。但目前不建议启用这个选项，因为它很可能会破坏编辑器内容或历史记录。\n\n### 我可以使用除 `Tab` 键以外的按键来接受建议吗？\n\n目前不行。这在技术上是可行的，但目前我没什么时间实现它。也许我将来会实现它。\n" }, { "path": "bin/install_linux.sh", "content": "#!/bin/bash\n\n# Parse arguments -path or -p\nwhile [[ \"$#\" -gt 0 ]]; do\n case $1 in\n -p | --path)\n custom_path=\"$2\"\n shift\n ;;\n *)\n echo \"Unknown parameter passed: $1\"\n exit 1\n ;;\n esac\n shift\ndone\n\n# Possible Typora installation paths\npaths=(\n \"/usr/share/typora\"\n \"/usr/local/share/typora\"\n \"/opt/typora\"\n \"/opt/Typora\"\n \"$HOME/.local/share/Typora\"\n \"$HOME/.local/share/typora\"\n)\nif [[ -n \"$custom_path\" ]]; then\n paths=(\"$custom_path\")\nfi\n\nscript_to_insert_after_candidates=(\n ''\n ''\n)\nscript_to_insert=''\n\nescape_for_sed() {\n echo \"$1\" | sed -E 's/[]\\/$*.^|[]/\\\\&/g'\n}\n\n# Find `window.html` in Typora installation path\npath_found=false\nsuccess=false\n\nfor path in \"${paths[@]}\"; do\n window_html_path_candidates=(\n \"$path/resources/app/window.html\"\n \"$path/resources/appsrc/window.html\"\n \"$path/resources/window.html\"\n )\n\n for window_html_path in \"${window_html_path_candidates[@]}\"; do\n # If found, insert script\n if [[ -f \"$window_html_path\" ]]; then\n path_found=true\n echo \"Installation directory: \\\"$(dirname \"$window_html_path\")/copilot/\\\"\"\n echo \"Found Typora \\\"index.html\\\" at \\\"$window_html_path\\\".\"\n content=$(cat \"$window_html_path\")\n\n if [[ \"$content\" != *\"$script_to_insert\"* ]]; then\n echo 'Installing Copilot plugin in Typora...'\n for script_to_insert_after in \"${script_to_insert_after_candidates[@]}\"; do\n if echo \"$content\" | grep -qF \"$script_to_insert_after\"; then\n echo \"Inserting Copilot plugin script after \\\"$script_to_insert_after\\\"...\"\n\n # Calculate indent of the script to insert\n escaped_script_to_insert_after=$(escape_for_sed \"$script_to_insert_after\")\n escaped_script_to_insert=$(escape_for_sed \"$script_to_insert\")\n indent=$(echo \"$content\" | while IFS= read -r line; do\n if [[ \"$line\" == *\"$script_to_insert_after\"* ]]; then\n echo \"$line\" | sed -E 's/^([[:space:]]*).*/\\1/'\n break\n fi\n done)\n if [[ -z \"$indent\" ]]; then\n replacement=\"$escaped_script_to_insert_after$escaped_script_to_insert\"\n else\n replacement=\"$escaped_script_to_insert_after\\n$indent$escaped_script_to_insert\"\n fi\n new_content=$(echo \"$content\" | sed \"s|$escaped_script_to_insert_after|$replacement|\")\n\n # Insert script\n echo \"$new_content\" >\"$window_html_path\"\n\n # Copy `/../` to `/copilot/` directory\n copilot_path=$(dirname \"$window_html_path\")/copilot\n if [[ ! -d \"$copilot_path\" ]]; then\n echo \"Copying Copilot plugin files to \\\"$copilot_path\\\"...\"\n mkdir -p \"$copilot_path\"\n cp -r \"$(dirname \"$0\")/../\" \"$copilot_path\"\n fi\n\n echo \"Successfully installed Copilot plugin in Typora.\"\n\n success=true\n break\n fi\n done\n\n if $success; then break; fi\n else\n # Script tag already present; validate installation integrity\n copilot_path=\"$(dirname \"$window_html_path\")/copilot\"\n index_js_path=\"$copilot_path/index.js\"\n if [[ ! -f \"$index_js_path\" ]]; then\n echo \"Warning: Corrupted Copilot installation detected. Expected \\\"$index_js_path\\\" but it does not exist.\"\n echo \"Please delete the entire \\\"$copilot_path\\\" directory and re-run this installer.\"\n echo \"Do NOT place the release inside Typora's installation folder (especially not under \\\"copilot\\\").\"\n echo \"Download/extract it to any other folder and run this script from there.\"\n break\n fi\n\n echo \"Warning: Copilot plugin has already been installed in Typora.\"\n success=true\n break\n fi\n fi\n done\n\n if $success; then break; fi\ndone\n\n# If not found, prompt user to check installation path\nif ! $path_found; then\n echo \"Error: Could not find Typora installation path. Please check if Typora is installed and try again.\" >&2\nelif ! $success; then\n echo \"Error: Installation failed.\" >&2\nfi\n" }, { "path": "bin/install_macos.sh", "content": "#!/bin/bash\n\n# Parse arguments -path or -p\nwhile [[ \"$#\" -gt 0 ]]; do\n case $1 in\n -p | --path)\n custom_path=\"$2\"\n shift\n ;;\n *)\n echo \"Unknown parameter passed: $1\"\n exit 1\n ;;\n esac\n shift\ndone\n\n# Possible Typora installation paths\npaths=(\n \"/Applications/Typora.app\"\n \"$HOME/Applications/Typora.app\"\n \"/usr/local/bin/Typora\"\n \"/opt/Typora\"\n)\nif [[ -n \"$custom_path\" ]]; then\n paths=(\"$custom_path\")\nfi\n\nscript_to_insert_after_candidates=(\n ''\n ''\n ''\n ''\n)\nscript_to_insert=''\n\nescape_for_sed() {\n echo \"$1\" | sed -E 's/[]\\/$*.^|[]/\\\\&/g'\n}\n\n# Find `index.html` in Typora installation path\npath_found=false\nsuccess=false\n\nfor path in \"${paths[@]}\"; do\n index_html_path_candidates=(\n \"$path/Contents/Resources/TypeMark/index.html\"\n \"$path/Contents/Resources/app/index.html\"\n \"$path/Contents/Resources/appsrc/index.html\"\n \"$path/resources/app/index.html\"\n \"$path/resources/appsrc/index.html\"\n \"$path/resources/TypeMark/index.html\"\n \"$path/resources/index.html\"\n )\n\n for index_html_path in \"${index_html_path_candidates[@]}\"; do\n # If found, insert script\n if [[ -f \"$index_html_path\" ]]; then\n path_found=true\n echo \"Installation directory: \\\"$(dirname \"$index_html_path\")/copilot/\\\"\"\n echo \"Found Typora \\\"index.html\\\" at \\\"$index_html_path\\\".\"\n content=$(cat \"$index_html_path\")\n\n if [[ \"$content\" != *\"$script_to_insert\"* ]]; then\n echo 'Installing Copilot plugin in Typora...'\n for script_to_insert_after in \"${script_to_insert_after_candidates[@]}\"; do\n if echo \"$content\" | grep -qF \"$script_to_insert_after\"; then\n echo \"Inserting Copilot plugin script after \\\"$script_to_insert_after\\\"...\"\n\n # Calculate indent of the script to insert\n escaped_script_to_insert_after=$(escape_for_sed \"$script_to_insert_after\")\n escaped_script_to_insert=$(escape_for_sed \"$script_to_insert\")\n indent=$(echo \"$content\" | while IFS= read -r line; do\n if [[ \"$line\" == *\"$script_to_insert_after\"* ]]; then\n echo \"$line\" | sed -E 's/^([[:space:]]*).*/\\1/'\n break\n fi\n done)\n if [[ -z \"$indent\" ]]; then\n replacement=\"$escaped_script_to_insert_after$escaped_script_to_insert\"\n else\n replacement=\"$escaped_script_to_insert_after\\n$indent$escaped_script_to_insert\"\n fi\n new_content=$(echo \"$content\" | sed \"s|$escaped_script_to_insert_after|$replacement|\")\n\n # Insert script\n echo \"$new_content\" >\"$index_html_path\"\n\n # Copy `/../` to `/copilot/` directory\n copilot_path=$(dirname \"$index_html_path\")/copilot\n if [[ ! -d \"$copilot_path\" ]]; then\n echo \"Copying Copilot plugin files to \\\"$copilot_path\\\"...\"\n mkdir -p \"$copilot_path\"\n cp -r \"$(dirname \"$0\")/../\" \"$copilot_path\"\n fi\n\n echo \"Successfully installed Copilot plugin in Typora.\"\n\n success=true\n break\n fi\n done\n\n if $success; then break; fi\n else\n # Script tag already present; validate installation integrity\n copilot_path=\"$(dirname \"$index_html_path\")/copilot\"\n index_js_path=\"$copilot_path/index.js\"\n if [[ ! -f \"$index_js_path\" ]]; then\n echo \"Warning: Corrupted Copilot installation detected. Expected \\\"$index_js_path\\\" but it does not exist.\"\n echo \"Please delete the entire \\\"$copilot_path\\\" directory and re-run this installer.\"\n echo \"Do NOT place the release inside Typora's installation folder (especially not under \\\"copilot\\\").\"\n echo \"Download/extract it to any other folder and run this script from there.\"\n break\n fi\n\n echo \"Warning: Copilot plugin has already been installed in Typora.\"\n success=true\n break\n fi\n fi\n done\n\n if $success; then break; fi\ndone\n\n# If not found, prompt user to check installation path\nif ! $path_found; then\n echo \"Error: Could not find Typora installation path. Please check if Typora is installed and try again.\" >&2\nelif ! $success; then\n echo \"Error: Installation failed.\" >&2\nfi\n" }, { "path": "bin/install_windows.ps1", "content": "# Allow custom path (-Path or -p)\nparam (\n [Parameter(Mandatory = $false)]\n [Alias('p')]\n [string] $Path = ''\n)\n\n# Possible Typora installation paths\n$paths = @(\n 'C:\\Program Files\\Typora'\n 'C:\\Program Files (x86)\\Typora'\n \"$env:LOCALAPPDATA\\Programs\\Typora\"\n)\nif ($Path -ne '') { $paths = @($Path) }\n\n$scriptToInsertAfterCandidates = @(\n ''\n ''\n)\n$scriptToInsert = ''\n\n# Find `window.html` in Typora installation path\n$pathFound = $false\n$success = $false\n\nforeach ($path in $paths) {\n $windowHtmlPathCandiates = @(\n Join-Path -Path $path -ChildPath 'resources\\app\\window.html'\n Join-Path -Path $path -ChildPath 'resources\\appsrc\\window.html'\n Join-Path -Path $path -ChildPath 'resources\\window.html'\n )\n\n foreach ($windowHtmlPath in $windowHtmlPathCandiates) {\n # If found, insert script\n if (Test-Path $windowHtmlPath) {\n $pathFound = $true\n Write-Host \"Installation directory: \"\"$(Split-Path -Path $windowHtmlPath -Parent)\\copilot\\\"\"\"\n Write-Host \"Found Typora \"\"window.html\"\" at \"\"$windowHtmlPath\"\".\"\n $content = Get-Content $windowHtmlPath -Raw -Encoding UTF8\n\n if (!($content.Contains($scriptToInsert))) {\n Write-Host 'Installing Copilot plugin in Typora...'\n foreach ($scriptToInsertAfter in $scriptToInsertAfterCandidates) {\n if ($content.Contains($scriptToInsertAfter)) {\n Write-Host \"Inserting Copilot plugin script after \"\"$scriptToInsertAfter\"\"...\"\n\n # Calculate indent of the script to insert\n $row = $content.Split(\"`n\") | Where-Object { $_ -match $scriptToInsertAfter }\n $rowContentBeforeScriptToInsertAfter = $row -replace \"$scriptToInsertAfter(.*)\", ''\n $indent = $rowContentBeforeScriptToInsertAfter -replace $rowContentBeforeScriptToInsertAfter.TrimEnd(), ''\n\n # Insert script\n $newContent = $content -replace $scriptToInsertAfter, (\n $scriptToInsertAfter +\n $(If (($rowContentBeforeScriptToInsertAfter -ne '') -and ($indent -eq '')) { '' } Else { \"`n\" + $indent }) +\n $scriptToInsert\n )\n Set-Content -Path $windowHtmlPath -Value $newContent -Encoding UTF8\n\n # Copy `\\..\\` to `\\copilot\\` directory\n $copilotPath = Join-Path -Path (Split-Path -Path $windowHtmlPath -Parent) -ChildPath 'copilot'\n if (-not (Test-Path $copilotPath)) {\n Write-Host \"Copying Copilot plugin files to \"\"$copilotPath\"\"...\"\n Copy-Item -Path (Join-Path -Path $PSScriptRoot -ChildPath '..\\') -Destination $copilotPath -Recurse\n }\n\n Write-Host \"Successfully installed Copilot plugin in Typora.\"\n\n $success = $true\n break\n }\n }\n\n if ($success) { break }\n }\n else {\n # Script tag already present; validate installation integrity\n $copilotPath = Join-Path -Path (Split-Path -Path $windowHtmlPath -Parent) -ChildPath 'copilot'\n $indexJsPath = Join-Path -Path $copilotPath -ChildPath 'index.js'\n if (-not (Test-Path $indexJsPath)) {\n Write-Warning \"Corrupted Copilot installation detected. Expected \"\"$indexJsPath\"\" but it does not exist.\"\n Write-Host \"Please delete the entire \"\"$copilotPath\"\" directory and re-run this installer.\"\n Write-Host \"Do NOT place the release inside Typora's installation folder (especially not under \"\"copilot\"\").\"\n Write-Host \"Download/extract it to any other folder and run this script from there.\"\n break\n }\n\n Write-Warning \"Copilot plugin has already been installed in Typora.\"\n $success = $true\n break\n }\n }\n }\n}\n\n# If not found, prompt user to check installation path\nif (-not $pathFound) {\n Write-Error \"Could not find Typora installation path. Please check if Typora is installed and try again.\"\n}\nelseif (-not $success) {\n Write-Error \"Installation failed.\"\n}\n" }, { "path": "bin/uninstall_linux.sh", "content": "#!/bin/bash\n\n# Parse arguments -path or -p\nwhile [[ \"$#\" -gt 0 ]]; do\n case $1 in\n -p | --path)\n custom_path=\"$2\"\n shift\n ;;\n -s | --silent)\n silent=true\n shift\n ;;\n *)\n echo \"Unknown parameter passed: $1\"\n exit 1\n ;;\n esac\n shift\ndone\n\n# Possible Typora installation paths on Linux\npaths=(\n \"/usr/share/typora\"\n \"/usr/local/share/typora\"\n \"/opt/typora\"\n \"/opt/Typora\"\n \"$HOME/.local/share/Typora\"\n \"$HOME/.local/share/typora\"\n)\nif [[ -n \"$custom_path\" ]]; then\n paths=(\"$custom_path\")\nfi\n\nscript_to_remove_after_candidates=(\n ''\n ''\n)\nscript_to_remove=''\n\nescape_for_sed() {\n echo \"$1\" | sed -E 's/[]\\/$*.^|[]/\\\\&/g'\n}\n\n# Find `window.html` in Typora installation path\npath_found=false\nsuccess=false\n\nfor path in \"${paths[@]}\"; do\n window_html_path_candidates=(\n \"$path/resources/app/window.html\"\n \"$path/resources/appsrc/window.html\"\n \"$path/resources/window.html\"\n )\n\n for window_html_path in \"${window_html_path_candidates[@]}\"; do\n # If found, insert script\n if [[ -f \"$window_html_path\" ]]; then\n path_found=true\n echo \"Found Typora \\\"window.html\\\" at \\\"$window_html_path\\\".\"\n content=$(cat \"$window_html_path\")\n\n for script_to_remove_after in \"${script_to_remove_after_candidates[@]}\"; do\n if echo \"$content\" | grep -qF \"$script_to_remove_after\"; then\n if echo \"$content\" | grep -qF \"$script_to_remove\"; then\n echo \"Removing Copilot plugin script after \\\"$script_to_remove_after\\\"...\"\n\n escaped_script_to_remove=$(escape_for_sed \"$script_to_remove\")\n new_content=$(echo \"$content\" | sed -E \"s/[[:space:]]*$escaped_script_to_remove//\")\n\n # Remove script\n echo \"$new_content\" >\"$window_html_path\"\n\n # Remove `/copilot/` directory\n copilot_dir=$(dirname \"$window_html_path\")/copilot\n if [[ -d \"$copilot_dir\" ]]; then\n echo \"Removing Copilot plugin directory \\\"$copilot_dir\\\"...\"\n rm -rf \"$copilot_dir\"\n fi\n\n echo \"Successfully uninstalled Copilot plugin in Typora.\"\n\n success=true\n break\n else\n if ! $silent; then\n echo \"Warning: Copilot plugin has not been installed in Typora.\"\n fi\n\n # Remove `/copilot/` directory regardless of script presence\n copilot_dir=$(dirname \"$window_html_path\")/copilot\n if [[ -d \"$copilot_dir\" ]]; then\n echo \"Detected Copilot plugin directory but no script reference. This might be leftover from a previous installation.\"\n echo \"Removing Copilot plugin directory \\\"$copilot_dir\\\"...\"\n rm -rf \"$copilot_dir\"\n echo \"Uninstallation complete.\"\n fi\n\n success=true\n break\n fi\n fi\n\n if $success; then break; fi\n done\n fi\n\n if $success; then break; fi\n done\n\n if $success; then break; fi\ndone\n\n# If not found, prompt user to check installation path\nif ! $path_found; then\n echo \"Error: Could not find Typora installation path. Please check if Typora is installed and try again.\" >&2\nelif ! $success; then\n echo \"Error: Uninstallation failed.\" >&2\nfi\n" }, { "path": "bin/uninstall_macos.sh", "content": "#!/bin/bash\n\n# Parse arguments -path or -p\nwhile [[ \"$#\" -gt 0 ]]; do\n case $1 in\n -p | --path)\n custom_path=\"$2\"\n shift\n ;;\n -s | --silent)\n silent=true\n shift\n ;;\n *)\n echo \"Unknown parameter passed: $1\"\n exit 1\n ;;\n esac\n shift\ndone\n\n# Possible Typora installation paths\npaths=(\n \"/Applications/Typora.app\"\n \"$HOME/Applications/Typora.app\"\n \"/usr/local/bin/Typora\"\n \"/opt/Typora\"\n)\nif [[ -n \"$custom_path\" ]]; then\n paths=(\"$custom_path\")\nfi\n\nscript_to_remove_after_candidates=(\n ''\n ''\n ''\n ''\n)\nscript_to_remove=''\n\nescape_for_sed() {\n echo \"$1\" | sed -E 's/[]\\/$*.^|[]/\\\\&/g'\n}\n\n# Find `index.html` in Typora installation path\npath_found=false\nsuccess=false\n\nfor path in \"${paths[@]}\"; do\n index_html_path_candidates=(\n \"$path/Contents/Resources/TypeMark/index.html\"\n \"$path/Contents/Resources/app/index.html\"\n \"$path/Contents/Resources/appsrc/index.html\"\n \"$path/resources/app/index.html\"\n \"$path/resources/appsrc/index.html\"\n \"$path/resources/TypeMark/index.html\"\n \"$path/resources/index.html\"\n )\n\n for index_html_path in \"${index_html_path_candidates[@]}\"; do\n # If found, insert script\n if [[ -f \"$index_html_path\" ]]; then\n path_found=true\n echo \"Found Typora \\\"index.html\\\" at \\\"$index_html_path\\\".\"\n content=$(cat \"$index_html_path\")\n\n for script_to_remove_after in \"${script_to_remove_after_candidates[@]}\"; do\n if echo \"$content\" | grep -qF \"$script_to_remove_after\"; then\n if echo \"$content\" | grep -qF \"$script_to_remove\"; then\n echo \"Removing Copilot plugin script after \\\"$script_to_remove_after\\\"...\"\n\n escaped_script_to_remove=$(escape_for_sed \"$script_to_remove\")\n new_content=$(echo \"$content\" | sed -E \"s/[[:space:]]*$escaped_script_to_remove//\")\n\n # Remove script\n echo \"$new_content\" >\"$index_html_path\"\n\n # Remove `/copilot/` directory\n copilot_dir=$(dirname \"$index_html_path\")/copilot\n if [[ -d \"$copilot_dir\" ]]; then\n echo \"Removing Copilot plugin directory \\\"$copilot_dir\\\"...\"\n rm -rf \"$copilot_dir\"\n fi\n\n echo \"Successfully uninstalled Copilot plugin in Typora.\"\n\n success=true\n break\n else\n if ! $silent; then\n echo \"Warning: Copilot plugin has not been installed in Typora.\"\n fi\n\n # Remove `/copilot/` directory regardless of script presence\n copilot_dir=$(dirname \"$index_html_path\")/copilot\n if [[ -d \"$copilot_dir\" ]]; then\n echo \"Detected Copilot plugin directory but no script reference. This might be leftover from a previous installation.\"\n echo \"Removing Copilot plugin directory \\\"$copilot_dir\\\"...\"\n rm -rf \"$copilot_dir\"\n echo \"Uninstallation complete.\"\n fi\n\n success=true\n break\n fi\n fi\n\n if $success; then break; fi\n done\n fi\n\n if $success; then break; fi\n done\n\n if $success; then break; fi\ndone\n\n# If not found, prompt user to check installation path\nif ! $path_found; then\n echo \"Error: Could not find Typora installation path. Please check if Typora is installed and try again.\" >&2\nelif ! $success; then\n echo \"Error: Uninstallation failed.\" >&2\nfi\n" }, { "path": "bin/uninstall_windows.ps1", "content": "# Allow custom path (-Path or -p) and silence warning (-Silent or -s)\nparam (\n [Parameter(Mandatory = $false)]\n [Alias('p')]\n [string] $Path = '',\n\n [Parameter(Mandatory = $false)]\n [Alias('s')]\n [switch] $Silent = $false\n)\n\n# Possible Typora installation paths\n$paths = @(\n 'C:\\Program Files\\Typora'\n 'C:\\Program Files (x86)\\Typora'\n \"$env:LOCALAPPDATA\\Programs\\Typora\"\n)\nif ($Path -ne '') { $paths = @($Path) }\n\n$scriptToRemoveAfterCandidates = @(\n ''\n ''\n)\n$scriptToRemove = ''\n\n# Find `window.html` in Typora installation path\n$pathFound = $false\n$success = $false\n\nforeach ($path in $paths) {\n $windowHtmlPathCandiates = @(\n Join-Path -Path $path -ChildPath 'resources\\app\\window.html'\n Join-Path -Path $path -ChildPath 'resources\\appsrc\\window.html'\n Join-Path -Path $path -ChildPath 'resources\\window.html'\n )\n\n foreach ($windowHtmlPath in $windowHtmlPathCandiates) {\n # If found, remove script\n if (Test-Path $windowHtmlPath) {\n $pathFound = $true\n Write-Host \"Found Typora \"\"window.html\"\" at \"\"$windowHtmlPath\"\".\"\n $content = Get-Content $windowHtmlPath -Raw -Encoding UTF8\n\n foreach ($scriptToRemoveAfter in $scriptToRemoveAfterCandidates) {\n if ($content.Contains($scriptToRemoveAfter)) {\n if ($content.Contains($scriptToRemove)) {\n Write-Host \"Removing Copilot plugin script after \"\"$scriptToRemoveAfter\"\"...\"\n\n # Calculate indent of the script to remove\n $row = $content.Split(\"`n\") | Where-Object { $_ -match $scriptToRemove }\n $rowContentBeforeScriptToRemove = $row -replace \"$scriptToRemoveAfter(.*)\", ''\n $indent = $rowContentBeforeScriptToRemove -replace $rowContentBeforeScriptToRemove.TrimEnd(), ''\n\n # Remove script\n $newContent = $content -replace ($indent + $scriptToRemove), ''\n Set-Content -Path $windowHtmlPath -Value $newContent -Encoding UTF8\n\n # Remove `\\copilot\\` directory\n $copilotPath = Join-Path -Path (Split-Path -Path $windowHtmlPath -Parent) -ChildPath 'copilot'\n if (Test-Path $copilotPath) {\n Write-Host \"Removing Copilot plugin directory \"\"$copilotPath\"\"...\"\n Remove-Item -Path $copilotPath -Recurse -Force\n }\n\n Write-Host \"Successfully uninstalled Copilot plugin in Typora.\"\n\n $success = $true\n break\n }\n else {\n if (-not $Silent) {\n Write-Warning \"Copilot plugin script has not been found in Typora.\"\n }\n\n # Remove `\\copilot\\` directory regardless of script presence\n $copilotPath = Join-Path -Path (Split-Path -Path $windowHtmlPath -Parent) -ChildPath 'copilot'\n if (Test-Path $copilotPath) {\n Write-Host \"Detected Copilot plugin directory but no script reference. This might be leftover from a previous installation.\"\n Write-Host \"Removing Copilot plugin directory \"\"$copilotPath\"\"...\"\n Remove-Item -Path $copilotPath -Recurse -Force\n Write-Host \"Uninstallation complete.\"\n $success = $true\n }\n\n $success = $true\n break\n }\n }\n\n if ($success) { break }\n }\n }\n\n if ($success) { break }\n }\n}\n\n# If not found, prompt user to check installation path\nif (-not $pathFound) {\n Write-Error \"Could not find Typora installation path. Please check if Typora is installed and try again.\"\n}\nelseif (-not $success) {\n Write-Error \"Uninstallation failed.\"\n}\n" }, { "path": "commitlint.config.js", "content": "// @ts-check\n\n/**\n * @typedef {object} Parsed\n * @property {?string} emoji The emoji at the beginning of the commit message.\n * @property {?string} type The type of the commit message.\n * @property {?string} scope The scope of the commit message.\n * @property {?string} subject The subject of the commit message.\n */\n\nconst emojiEnum = /** @type {const} */ ([\n 2,\n \"always\",\n {\n \"🎉\": [\"init\", \"Project initialization\"],\n \"✨\": [\"feat\", \"Adding new features\"],\n \"🐞\": [\"fix\", \"Fixing bugs\"],\n \"📃\": [\"docs\", \"Modify documentation only\"],\n \"🌈\": [\n \"style\",\n \"Only the spaces, formatting indentation, commas, etc. were changed, not the code logic\",\n ],\n \"🦄\": [\"refactor\", \"Code refactoring, no new features added or bugs fixed\"],\n \"🎈\": [\"perf\", \"Optimization-related, such as improving performance, experience\"],\n \"🧪\": [\"test\", \"Adding or modifying test cases\"],\n \"🔧\": [\n \"build\",\n \"Dependency-related content, such as Webpack, Vite, Rollup, npm, package.json, etc.\",\n ],\n \"🐎\": [\"ci\", \"CI configuration related, e.g. changes to k8s, docker configuration files\"],\n \"🐳\": [\"chore\", \"Other modifications, e.g. modify the configuration file\"],\n \"↩\": [\"revert\", \"Rollback to previous version\"],\n },\n]);\n\n/** @satisfies {import(\"@commitlint/types\").UserConfig} */\nconst config = {\n parserPreset: {\n parserOpts: {\n headerPattern:\n /^(?\\u00a9|\\u00ae|[\\u2000-\\u3300]|\\ud83c[\\ud000-\\udfff]|\\ud83d[\\ud000-\\udfff]|\\ud83e[\\ud000-\\udfff]) (?\\w+)(?:\\((?.*)\\))?!?: (?(?:(?!#).)*(?:(?!\\s).))$/,\n headerCorrespondence: [\"emoji\", \"type\", \"scope\", \"subject\"],\n },\n },\n plugins: [\n {\n rules: {\n \"header-match-git-commit-message-with-emoji-pattern\": (parsed) => {\n const { emoji, scope, subject, type } = /** @type {Parsed} */ (\n /** @type {unknown} */ (parsed)\n );\n if (emoji === null && type === null && scope === null && subject === null)\n return [\n false,\n 'header must be in format \" (?): \", e.g:\\n' +\n \" - 🎉 init: Initial commit\\n\" +\n \" - ✨ feat(assertions): Add assertions\\n\" +\n \" \",\n ];\n return [true, \"\"];\n },\n \"emoji-enum\": (parsed, _, value) => {\n const { emoji } = /** @type {Parsed} */ (/** @type {unknown} */ (parsed));\n const emojisObject = /** @type {typeof emojiEnum[2]} */ (/** @type {unknown} */ (value));\n if (emoji && !Object.keys(emojisObject).includes(emoji)) {\n return [\n false,\n \"emoji must be one of:\\n\" +\n Object.entries(emojisObject)\n .map(([emoji, [type, description]]) => ` ${emoji} ${type} - ${description}`)\n .join(\"\\n\") +\n \"\\n \",\n ];\n }\n return [true, \"\"];\n },\n },\n },\n ],\n rules: {\n \"header-match-git-commit-message-with-emoji-pattern\": [2, \"always\"],\n \"body-leading-blank\": [2, \"always\"],\n \"footer-leading-blank\": [2, \"always\"],\n \"header-max-length\": [2, \"always\", 72],\n \"scope-case\": [2, \"always\", [\"lower-case\", \"upper-case\"]],\n \"subject-case\": [2, \"always\", \"sentence-case\"],\n \"subject-empty\": [2, \"never\"],\n \"subject-exclamation-mark\": [2, \"never\"],\n \"subject-full-stop\": [2, \"never\", \".\"],\n \"emoji-enum\": emojiEnum,\n \"type-case\": [2, \"always\", \"lower-case\"],\n \"type-empty\": [2, \"never\"],\n \"type-enum\": [\n 2,\n \"always\",\n [\n \"init\",\n \"feat\",\n \"fix\",\n \"docs\",\n \"style\",\n \"refactor\",\n \"perf\",\n \"test\",\n \"build\",\n \"ci\",\n \"chore\",\n \"revert\",\n ],\n ],\n },\n};\n\nexport default config;\n" }, { "path": "eslint.config.js", "content": "// @ts-check\n\nimport eslint from \"@eslint/js\";\nimport { defineConfig } from \"eslint/config\";\nimport { importX } from \"eslint-plugin-import-x\";\nimport { jsdoc } from \"eslint-plugin-jsdoc\";\nimport prettierRecommended from \"eslint-plugin-prettier/recommended\";\nimport react from \"eslint-plugin-react\";\nimport reactHooks from \"eslint-plugin-react-hooks\";\nimport sonarjs from \"eslint-plugin-sonarjs\";\nimport sortDestructureKeys from \"eslint-plugin-sort-destructure-keys\";\nimport globals from \"globals\";\nimport tseslint from \"typescript-eslint\";\n\nexport default defineConfig(\n eslint.configs.recommended,\n tseslint.configs.strictTypeChecked,\n tseslint.configs.stylisticTypeChecked,\n jsdoc({ config: \"flat/recommended-typescript-error\" }),\n react.configs.flat.recommended,\n react.configs.flat[\"jsx-runtime\"],\n reactHooks.configs.flat[\"recommended-latest\"],\n /** @type {import(\"eslint\").Linter.Config} */ (importX.flatConfigs.recommended),\n /** @type {import(\"eslint\").Linter.Config} */ (importX.flatConfigs.typescript),\n prettierRecommended,\n sonarjs.configs.recommended,\n {\n plugins: {\n react,\n \"sort-destructure-keys\": /** @type {import(\"eslint\").ESLint.Plugin} */ (sortDestructureKeys),\n },\n linterOptions: {\n reportUnusedDisableDirectives: true,\n },\n languageOptions: {\n parserOptions: {\n ecmaFeatures: { jsx: true },\n projectService: {\n allowDefaultProject: [\"*.{js,cjs}\"],\n defaultProject: \"tsconfig.json\",\n },\n tsconfigRootDir: import.meta.dirname,\n },\n globals: { ...globals.browser },\n },\n rules: {\n \"@typescript-eslint/restrict-plus-operands\": [\n \"error\",\n { allowAny: true, allowNumberAndString: true },\n ],\n \"@typescript-eslint/restrict-template-expressions\": [\n \"error\",\n { allowAny: true, allowBoolean: true, allowNullish: true, allowNumber: true },\n ],\n \"@typescript-eslint/consistent-indexed-object-style\": \"off\",\n \"@typescript-eslint/consistent-type-definitions\": \"off\", // TS treats types and interfaces differently, this may break some advanced type gymnastics\n \"@typescript-eslint/consistent-type-imports\": [\n \"error\",\n { prefer: \"type-imports\", disallowTypeAnnotations: false },\n ],\n \"@typescript-eslint/dot-notation\": [\"error\", { allowIndexSignaturePropertyAccess: true }],\n \"@typescript-eslint/no-confusing-void-expression\": \"off\",\n \"@typescript-eslint/no-empty-function\": \"off\",\n \"@typescript-eslint/no-empty-object-type\": \"off\",\n \"@typescript-eslint/no-explicit-any\": \"off\",\n \"@typescript-eslint/no-invalid-void-type\": \"off\",\n \"@typescript-eslint/no-namespace\": \"off\",\n \"@typescript-eslint/no-non-null-assertion\": \"off\",\n \"@typescript-eslint/no-unnecessary-type-parameters\": \"off\",\n \"@typescript-eslint/no-unsafe-argument\": \"off\",\n \"@typescript-eslint/no-unsafe-assignment\": \"off\",\n \"@typescript-eslint/no-unsafe-call\": \"off\",\n \"@typescript-eslint/no-unsafe-member-access\": \"off\",\n \"@typescript-eslint/no-unsafe-return\": \"off\",\n \"@typescript-eslint/no-unused-vars\": \"off\", // Already covered by `tsconfig.json`\n \"@typescript-eslint/prefer-nullish-coalescing\": \"off\",\n \"@typescript-eslint/unified-signatures\": \"off\",\n \"import-x/consistent-type-specifier-style\": [\"error\", \"prefer-top-level\"],\n \"import-x/no-named-as-default-member\": \"off\",\n \"import-x/no-unresolved\": \"off\",\n \"import-x/order\": [\n \"error\",\n {\n alphabetize: { order: \"asc\" },\n groups: [\"builtin\", \"external\", \"internal\", \"parent\", \"sibling\", \"index\", \"object\"],\n pathGroups: [\n {\n pattern: \"@modules/**\",\n group: \"external\",\n position: \"before\",\n },\n {\n pattern: \"@/\",\n group: \"internal\",\n position: \"after\",\n },\n ],\n pathGroupsExcludedImportTypes: [\"builtin\", \"type\"],\n \"newlines-between\": \"always\",\n },\n ],\n \"jsdoc/check-param-names\": \"off\",\n \"jsdoc/check-tag-names\": \"off\",\n \"jsdoc/check-values\": \"off\",\n \"jsdoc/reject-any-type\": \"off\",\n \"jsdoc/require-jsdoc\": \"off\",\n \"jsdoc/require-param\": \"off\",\n \"jsdoc/require-returns-description\": \"off\",\n \"jsdoc/tag-lines\": \"off\",\n \"no-restricted-syntax\": [\n \"error\",\n {\n selector: \"CallExpression[callee.property.name='push'] > SpreadElement.arguments\",\n message:\n \"Do not use spread arguments in `Array#push`, \" +\n \"as it might cause stack overflow if you spread a large array. \" +\n \"Instead, use `Array#concat` or `Array.prototype.push.apply`.\",\n },\n ],\n \"no-undef\": \"off\", // Already checked by TypeScript\n \"object-shorthand\": \"error\",\n \"react/no-unknown-property\": \"off\", // Already checked by TypeScript\n \"react/prop-types\": \"off\", // Already checked by TypeScript\n \"react-hooks/immutability\": \"off\",\n \"sonarjs/class-name\": [\"error\", { format: \"^_?[A-Z][a-zA-Z0-9]*$\" }],\n \"sonarjs/code-eval\": \"off\", // Already covered by `@typescript-eslint/no-implied-eval`\n \"sonarjs/cognitive-complexity\": \"off\",\n \"sonarjs/deprecation\": \"off\", // Already covered by `@typescript-eslint/no-deprecated`\n \"sonarjs/different-types-comparison\": \"off\", // Already checked by TypeScript\n \"sonarjs/no-ignored-exceptions\": \"off\",\n \"sonarjs/no-nested-assignment\": \"off\",\n \"sonarjs/no-nested-conditional\": \"off\",\n \"sonarjs/no-nested-functions\": \"off\",\n \"sonarjs/no-selector-parameter\": \"off\",\n \"sonarjs/no-useless-intersection\": \"off\", // Already checked by TypeScript\n \"sonarjs/no-unused-vars\": \"off\", // Already checked by TypeScript\n \"sonarjs/reduce-initial-value\": \"off\",\n \"sonarjs/redundant-type-aliases\": \"off\", // Already covered by `@typescript-eslint/no-restricted-type-imports`\n \"sonarjs/regex-complexity\": \"off\",\n \"sonarjs/slow-regex\": \"off\",\n \"sonarjs/todo-tag\": \"off\",\n \"sonarjs/void-use\": \"off\",\n \"sort-destructure-keys/sort-destructure-keys\": \"error\",\n \"sort-imports\": [\"error\", { ignoreDeclarationSort: true }],\n },\n },\n);\n" }, { "path": "install.ps1", "content": "#Requires -RunAsAdministrator\n$latestRelease = Invoke-RestMethod -Uri \"https://api.github.com/repos/Snowflyt/typora-copilot/releases/latest\"\nInvoke-WebRequest -Uri $latestRelease.assets[0].browser_download_url -OutFile \"typora-copilot-$($latestRelease.tag_name).zip\"\nIf (Test-Path \"typora-copilot-$($latestRelease.tag_name)\") {\n Remove-Item \"typora-copilot-$($latestRelease.tag_name)\" -Recurse -Force\n}\nNew-Item -ItemType Directory -Path \"typora-copilot-$($latestRelease.tag_name)\"\nExpand-Archive -Path \"typora-copilot-$($latestRelease.tag_name).zip\" -DestinationPath \"typora-copilot-$($latestRelease.tag_name)\"\nRemove-Item \"typora-copilot-$($latestRelease.tag_name).zip\"\nSet-Location \"typora-copilot-$($latestRelease.tag_name)\"\nWrite-Host \"Trying to uninstall the previous version (if any)...\"\n.\\bin\\uninstall_windows.ps1 -Silent\nWrite-Host \"Trying to install the new version...\"\n.\\bin\\install_windows.ps1\nSet-Location ..\nRemove-Item \"typora-copilot-$($latestRelease.tag_name)\" -Recurse -Force\n" }, { "path": "install.sh", "content": "#!/usr/bin/env bash\n\nif [ \"$(id -u)\" -ne 0 ]; then\n echo \"Please run as root\"\n exit 1\nfi\n\nlatest_release=$(curl -s https://api.github.com/repos/Snowflyt/typora-copilot/releases/latest)\ndownload_url=$(echo \"$latest_release\" | grep '\"browser_download_url\"' | head -n 1 | sed -E 's/.*\"browser_download_url\": \"(.*)\".*/\\1/')\ntag_name=$(echo \"$latest_release\" | grep '\"tag_name\"' | head -n 1 | sed -E 's/.*\"tag_name\": \"(.*)\".*/\\1/')\ncurl -L \"$download_url\" -o \"typora-copilot-$tag_name.zip\"\nif [ -d \"typora-copilot-$tag_name\" ]; then\n rm -rf \"typora-copilot-$tag_name\"\nfi\nmkdir \"typora-copilot-$tag_name\"\nunzip \"typora-copilot-$tag_name.zip\" -d \"typora-copilot-$tag_name\"\nrm \"typora-copilot-$tag_name.zip\"\ncd \"typora-copilot-$tag_name\" || exit\nif [[ \"$OSTYPE\" == \"darwin\"* ]]; then\n echo \"Trying to uninstall the previous version (if any)...\"\n chmod +x ./bin/uninstall_macos.sh\n ./bin/uninstall_macos.sh --silent\n echo \"Trying to install the new version...\"\n chmod +x ./bin/install_macos.sh\n ./bin/install_macos.sh\nelif [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then\n echo \"Trying to uninstall the previous version (if any)...\"\n chmod +x ./bin/uninstall_linux.sh\n ./bin/uninstall_linux.sh --silent\n echo \"Trying to install the new version...\"\n chmod +x ./bin/install_linux.sh\n ./bin/install_linux.sh\nelse\n echo \"Unsupported OS: $OSTYPE\"\n exit 1\nfi\ncd ..\nrm -rf \"typora-copilot-$tag_name\"\n" }, { "path": "package.json", "content": "{\n \"name\": \"typora-copilot\",\n \"version\": \"0.3.12\",\n \"private\": true,\n \"description\": \"GitHub Copilot plugin for Typora\",\n \"keywords\": [\n \"Typora\",\n \"Copilot\",\n \"GitHub Copilot\",\n \"AI\",\n \"code completion\",\n \"code suggestion\",\n \"code generation\"\n ],\n \"homepage\": \"https://github.com/Snowflyt/typora-copilot\",\n \"bugs\": {\n \"url\": \"https://github.com/Snowflyt/typora-copilot/issues\"\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/Snowflyt/typora-copilot\"\n },\n \"license\": \"MIT\",\n \"author\": \"Snowflyt \",\n \"type\": \"module\",\n \"main\": \"./index.js\",\n \"scripts\": {\n \"build:dev\": \"rimraf dist && rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript && node -e \\\"import fs from 'node:fs'; import { join } from 'node:path'; ['package.json', 'README.md', 'README.zh-CN.md'].forEach((path) => fs.copyFileSync(path, join('dist', path))); ['bin', 'docs'].forEach((dir) => fs.cpSync(dir, join('dist', dir), { recursive: true })); fs.cpSync(join('node_modules', '@github', 'copilot-language-server', 'dist'), join('dist', 'language-server'), { recursive: true }); fs.rmSync(join('dist', 'language-server', 'api'), { recursive: true }); fs.rmSync(join('dist', 'language-server', 'language-server.js')); fs.readdirSync(join('dist', 'language-server')).forEach((file) => file.endsWith('.map') && fs.rmSync(join('dist', 'language-server', file))); fs.renameSync(join('dist', 'language-server', 'main.js'), join('dist', 'language-server', 'language-server.cjs'))\\\"\",\n \"build:release\": \"rimraf dist && npm run test-types && npm test && rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript && prettier --log-level=silent --print-width 80 --write dist/**/* --ignore-path !dist/ && node -e \\\"import fs from 'node:fs'; import { join } from 'node:path'; ['package.json', 'README.md', 'README.zh-CN.md'].forEach((path) => fs.copyFileSync(path, join('dist', path))); ['bin', 'docs'].forEach((dir) => fs.cpSync(dir, join('dist', dir), { recursive: true })); fs.cpSync(join('node_modules', '@github', 'copilot-language-server', 'dist'), join('dist', 'language-server'), { recursive: true }); fs.rmSync(join('dist', 'language-server', 'api'), { recursive: true }); fs.rmSync(join('dist', 'language-server', 'language-server.js')); fs.readdirSync(join('dist', 'language-server')).forEach((file) => file.endsWith('.map') && fs.rmSync(join('dist', 'language-server', file))); fs.renameSync(join('dist', 'language-server', 'main.js'), join('dist', 'language-server', 'language-server.cjs'))\\\"\",\n \"build:watch\": \"rimraf dist && node -e \\\"import fs from 'node:fs'; import { join } from 'node:path'; if (!fs.existsSync('dist')) fs.mkdirSync('dist'); ['package.json', 'README.md', 'README.zh-CN.md'].forEach((path) => fs.copyFileSync(path, join('dist', path))); ['bin', 'docs'].forEach((dir) => fs.cpSync(dir, join('dist', dir), { recursive: true })); fs.cpSync(join('node_modules', '@github', 'copilot-language-server', 'dist'), join('dist', 'language-server'), { recursive: true }); fs.rmSync(join('dist', 'language-server', 'api'), { recursive: true }); fs.readdirSync(join('dist', 'language-server')).forEach((file) => file.endsWith('.map') && fs.rmSync(join('dist', 'language-server', file))); fs.renameSync(join('dist', 'language-server', 'main.js'), join('dist', 'language-server', 'language-server.cjs'))\\\" && rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript --watch\",\n \"format\": \"prettier --no-error-on-unmatched-pattern --write {src,test}/**/*.{json,js,jsx,ts,tsx} *.{js,cjs,mjs,ts,cts,mts,json,md}\",\n \"lint\": \"eslint {src,test}/**/*.{js,jsx,ts,tsx} *.{js,cjs,mjs,ts,cts,mts} --no-error-on-unmatched-pattern --report-unused-disable-directives-severity error --max-warnings 0 && stylelint \\\"src/**/*.{css,scss}\\\"\",\n \"lint:fix\": \"eslint --fix {src,test}/**/*.{js,jsx,ts,tsx} *.{js,cjs,mjs,ts,cts,mts} --no-error-on-unmatched-pattern --report-unused-disable-directives-severity error --max-warnings 0 && stylelint --fix \\\"src/**/*.{css,scss}\\\"\",\n \"prepare\": \"node -e \\\"import fs from 'node:fs'; import path from 'node:path'; const hooksDir = path.join(process.cwd(), '.githooks'); const gitHooksDir = path.join(process.cwd(), '.git/hooks'); if (fs.existsSync(gitHooksDir)) { fs.readdirSync(hooksDir).forEach(file => { const srcFile = path.join(hooksDir, file); const destFile = path.join(gitHooksDir, file); fs.copyFileSync(srcFile, destFile); if (process.platform !== 'win32' && !file.endsWith('.cmd')) { fs.chmodSync(destFile, 0o755); } }); }\\\"\",\n \"test\": \"vitest run\",\n \"test-types\": \"typroof\",\n \"test:cov\": \"vitest run --coverage\",\n \"test:ui\": \"vitest --ui --coverage.enabled=true\",\n \"test:watch\": \"vitest\",\n \"test:watch-cov\": \"vitest --coverage\",\n \"typecheck\": \"tsc --noEmit -p tsconfig.build.json\"\n },\n \"dependencies\": {\n \"@github/copilot-language-server\": \"^1.409.0\",\n \"@preact/signals\": \"^2.5.1\",\n \"color2k\": \"^2.0.3\",\n \"fast-diff\": \"^1.3.0\",\n \"highlight.js\": \"^11.11.1\",\n \"marked\": \"^17.0.1\",\n \"marked-highlight\": \"^2.2.3\",\n \"preact\": \"^10.28.2\",\n \"radash\": \"^12.1.1\",\n \"semver\": \"^7.7.3\",\n \"string-ts\": \"^2.3.1\"\n },\n \"devDependencies\": {\n \"@catppuccin/highlightjs\": \"^1.0.1\",\n \"@commitlint/cli\": \"^20.3.1\",\n \"@eslint/js\": \"^9.39.2\",\n \"@rollup/plugin-commonjs\": \"^29.0.0\",\n \"@rollup/plugin-json\": \"^6.1.0\",\n \"@rollup/plugin-node-resolve\": \"^16.0.3\",\n \"@rollup/plugin-typescript\": \"^12.3.0\",\n \"@total-typescript/ts-reset\": \"^0.6.1\",\n \"@types/codemirror\": \"^5.60.17\",\n \"@types/core-js\": \"^2.5.8\",\n \"@types/jquery\": \"^3.5.33\",\n \"@types/node\": \"^20.19.29\",\n \"@types/rangy\": \"^1.3.0\",\n \"@types/semver\": \"^7.7.1\",\n \"@types/ws\": \"^8.18.1\",\n \"@vitest/coverage-v8\": \"^4.0.17\",\n \"@vitest/ui\": \"^4.0.17\",\n \"eslint\": \"^9.39.2\",\n \"eslint-config-prettier\": \"^10.1.8\",\n \"eslint-import-resolver-typescript\": \"^4.4.4\",\n \"eslint-plugin-import-x\": \"^4.16.1\",\n \"eslint-plugin-jsdoc\": \"^62.0.0\",\n \"eslint-plugin-prettier\": \"^5.5.4\",\n \"eslint-plugin-react\": \"^7.37.5\",\n \"eslint-plugin-react-hooks\": \"^7.0.1\",\n \"eslint-plugin-sonarjs\": \"^3.0.5\",\n \"eslint-plugin-sort-destructure-keys\": \"^2.0.0\",\n \"globals\": \"^17.0.0\",\n \"happy-dom\": \"^20.1.0\",\n \"postcss\": \"^8.5.6\",\n \"prettier\": \"^3.7.4\",\n \"prettier-plugin-packagejson\": \"^2.5.21\",\n \"replace-in-file\": \"^8.4.0\",\n \"rimraf\": \"^6.1.2\",\n \"rollup\": \"^4.55.1\",\n \"rollup-plugin-postcss\": \"^4.0.2\",\n \"sass\": \"^1.97.2\",\n \"stylelint\": \"^16.26.1\",\n \"stylelint-config-standard-scss\": \"^16.0.0\",\n \"tslib\": \"^2.8.1\",\n \"tsx\": \"^4.21.0\",\n \"typescript\": \"^5.9.3\",\n \"typescript-eslint\": \"^8.53.0\",\n \"typroof\": \"^0.6.0\",\n \"vitest\": \"^4.0.17\",\n \"ws\": \"^8.19.0\"\n }\n}\n" }, { "path": "pre-commit.ts", "content": "import fs from \"node:fs\";\n\nimport { replaceInFileSync } from \"replace-in-file\";\n\nimport packageJSON from \"./package.json\";\n\nconst CONSTANTS_FILE_PATHNAME = \"./src/constants.ts\";\n\nconst { version } = packageJSON;\n\nconst options = {\n files: CONSTANTS_FILE_PATHNAME,\n from: /VERSION = \".*\"/g,\n to: `VERSION = \"${version}\"`,\n};\n\nif (fs.readFileSync(CONSTANTS_FILE_PATHNAME, \"utf-8\").includes(options.to)) process.exit(0);\n\ntry {\n replaceInFileSync(options);\n console.log(\"Plugin VERSION updated:\", version);\n} catch (error) {\n console.error(\"Error occurred while updating plugin VERSION:\", error);\n process.exit(1);\n}\n" }, { "path": "prettier.config.cjs", "content": "// @ts-check\n\n/** @satisfies {import(\"prettier\").Config} */\nconst config = {\n arrowParens: \"always\",\n bracketSameLine: true,\n bracketSpacing: true,\n experimentalTernaries: true,\n plugins: [\"prettier-plugin-packagejson\"],\n printWidth: 100,\n semi: true,\n singleQuote: false,\n tabWidth: 2,\n trailingComma: \"all\",\n};\n\nmodule.exports = config;\n" }, { "path": "rollup.config.ts", "content": "import fs from \"node:fs\";\nimport path from \"node:path\";\n\nimport commonjs from \"@rollup/plugin-commonjs\";\nimport json from \"@rollup/plugin-json\";\nimport { nodeResolve } from \"@rollup/plugin-node-resolve\";\nimport typescript from \"@rollup/plugin-typescript\";\nimport type { InputPluginOption } from \"rollup\";\nimport { defineConfig } from \"rollup\";\nimport postcss from \"rollup-plugin-postcss\";\n\nconst plugins = [\n typescript({\n tsconfig: \"./tsconfig.build.json\",\n }),\n nodeResolve({\n extensions: [\".js\", \".jsx\", \".ts\", \".tsx\"],\n }),\n json(),\n commonjs(),\n {\n name: \"clean\",\n transform: (code) =>\n code\n .replace(/\\n?^\\s*\\/\\/ @ts-.+$/gm, \"\")\n .replace(/\\n?^\\s*\\/\\/\\/ \n css.replace(/\\\\/g, \"\\\\\\\\\").replace(/`/g, \"\\\\`\").replace(/\\$/g, \"\\\\$\");\n\n const themeSwitch = `\n// Highlight.js theme switcher\n(function() {\n let styleElement = null;\n let currentTheme = null;\n\n const themes = {\n light: \\`${escapeCSS(lightThemeCSS)}\\`,\n dark: \\`${escapeCSS(darkThemeCSS)}\\`\n };\n\n window.setHighlightjsTheme = function(theme) {\n if (!themes[theme]) {\n console.error('Invalid theme: ' + theme + '. Use \"light\" or \"dark\"');\n return;\n }\n\n if (currentTheme === theme) return;\n currentTheme = theme;\n\n if (!styleElement) {\n styleElement = document.createElement('style');\n styleElement.id = 'highlightjs-dynamic-theme';\n document.head.appendChild(styleElement);\n }\n\n styleElement.textContent = themes[theme];\n };\n})();`;\n\n return code + themeSwitch;\n }\n return code;\n },\n },\n] satisfies InputPluginOption;\n\nexport default defineConfig([\n {\n input: \"src/index.ts\",\n output: {\n file: \"dist/index.js\",\n format: \"iife\",\n },\n plugins: [\n ...plugins,\n postcss({\n inject: true,\n // Disable Dart Sass deprecated legacy JS API warning until rollup-plugin-postcss is updated\n // to support modern Sass API: https://github.com/egoist/rollup-plugin-postcss/issues/463\n use: {\n sass: {\n silenceDeprecations: [\"legacy-js-api\"],\n },\n } as never,\n }),\n ],\n },\n {\n input: \"src/mac-server.ts\",\n output: {\n file: \"dist/mac-server.cjs\",\n format: \"cjs\",\n },\n plugins,\n },\n]);\n" }, { "path": "src/client/chat.ts", "content": "/**\n * This module provides functions to interact with GitHub Copilot Chat API.\n *\n * Implementation inspired by CopilotChat.nvim:\n * https://github.com/CopilotC-Nvim/CopilotChat.nvim\n * @module\n */\n\nimport * as fs from \"@modules/fs\";\nimport * as path from \"@modules/path\";\n\nimport { VERSION } from \"@/constants\";\nimport { TYPORA_VERSION } from \"@/typora-utils\";\nimport { getEnv } from \"@/utils/cli-tools\";\nimport { generateUUID } from \"@/utils/random\";\nimport { parseSSEStream } from \"@/utils/stream\";\nimport { omit } from \"@/utils/tools\";\n\nconst COPILOT_MARKDOWN_BASE = `\nWhen asked for your name, you must respond with \"GitHub Copilot\".\nFollow the user’s requirements carefully & to the letter.\nFollow Microsoft content policies.\nAvoid content that violates copyrights.\nIf you are asked to generate content that is harmful, hateful, racist, or promotes violence, only respond with \"Sorry, I can’t assist with that.\" You can be playful, casual, and even a bit whimsical in your responses when appropriate, while maintaining helpfulness. Feel free to use creative expressions, metaphors, and occasional humor to make your responses engaging.\n\nYou are an AI assistant specializing in Markdown document editing, academic writing, content creation, and knowledge sharing.\nThe user is working in Typora, a Markdown editor.\nProvide helpful responses that may be about:\n- Improving their current document\n- Answering knowledge questions related to their document’s content\n- Explaining concepts mentioned in their document\n- General assistance with writing and research\n- Creative suggestions for content development\n\nYou should maintain a natural, conversational tone while being informative and helpful.\n`;\n\nconst CODE_BLOCK_FORMAT_INSTRUCTION = `\nIn your responses, always format code blocks using ~~~ triple tildes (not backticks) with the following rules:\n1. Always specify a language identifier after the opening tildes (e.g. ~~~javascript). If no language is specified, use \"plaintext\" as the default.\n2. Always close code blocks with three tildes on their own line (~~~)\n3. Never use backtick code blocks (\\`\\`\\`) as they cause rendering issues when code contains nested code blocks\n4. Example of proper format:\n ~~~python\n def hello_world():\n print(\"Hello, world!\")\n ~~~\n\nUsers can continue using standard markdown backticks in their messages.\n`;\n\nexport const COPILOT_MARKDOWN_INSTRUCTIONS = `\n${COPILOT_MARKDOWN_BASE}\n\n# YOUR CAPABILITIES\n- Fix grammatical errors and improve writing clarity\n- Suggest improvements to document structure and organization\n- Help with formatting using Markdown syntax\n- Provide content suggestions and expansions\n- Answer questions about topics in the document\n- Explain concepts, theories, or terminology mentioned in the document\n- Create tables, lists, and other Markdown elements when requested\n- Help with academic citations and references\n- Assist with creating technical documentation\n- Engage in conversational discussions about document-related topics\n\n# INTERACTION GUIDELINES\nWhen suggesting edits, use standard Markdown formatting.\nWhen answering knowledge questions, be informative but concise.\nWhen explaining concepts from the document, refer to specific sections when relevant.\nWhen the user asks general questions not directly about editing the document, still provide helpful answers.\n${CODE_BLOCK_FORMAT_INSTRUCTION}\n\nRemember that users may want to discuss their document’s topic rather than just improve its formatting.\n`;\n\nexport const COPILOT_ACADEMIC_INSTRUCTIONS = `\n${COPILOT_MARKDOWN_BASE}\n\n# YOUR CAPABILITIES\n- Structure academic papers according to field-specific conventions\n- Format citations and references in APA, MLA, Chicago, IEEE and other styles\n- Create cohesive literature reviews that synthesize research\n- Develop clear research questions and hypotheses\n- Design appropriate methodology sections\n- Analyze and present research results clearly\n- Write effective abstracts, introductions and conclusions\n- Create properly formatted tables, figures and appendices\n- Improve academic tone, clarity and precision of language\n- Help with grant proposals and academic presentations\n- Suggest appropriate academic terminology and phrasing\n- Identify gaps in research arguments and suggest improvements\n- Assist with theoretical frameworks and conceptual models\n\n# INTERACTION GUIDELINES\nWhen discussing academic topics, maintain scholarly rigor and acknowledge limitations.\nWhen suggesting citations, provide properly formatted examples in the appropriate style.\nWhen helping with research questions, ensure they are specific, measurable, and aligned with the methodology.\nWhen reviewing academic writing, focus on clarity, precision, and logical flow of arguments.\nWhen assisting with data presentation, suggest clear ways to visualize or describe findings.\nWhen helping with theoretical content, refer to established frameworks in the field when appropriate.\n${CODE_BLOCK_FORMAT_INSTRUCTION}\n\nRemember that academic integrity is paramount - always emphasize the importance of proper attribution and encourage original analysis rather than mere compilation of sources.\n`;\n\nexport const COPILOT_CREATIVE_INSTRUCTIONS = `\n${COPILOT_MARKDOWN_BASE}\n\n# YOUR CAPABILITIES\n- Develop compelling narrative structures and plot outlines\n- Create multi-dimensional characters with distinct voices and motivations\n- Craft engaging dialogue that advances the story and reveals character\n- Design vivid settings and world-building elements\n- Generate creative descriptions using sensory details\n- Suggest plot twists and narrative devices to increase reader engagement\n- Create emotion-evoking scenes and meaningful character arcs\n- Develop themes and symbolism that add depth to creative work\n- Help with genre-specific conventions and techniques\n- Suggest ways to heighten tension and conflict\n- Assist with pacing issues and narrative flow\n- Provide feedback on style, tone, and voice consistency\n- Generate creative prompts to overcome writer's block\n\n# INTERACTION GUIDELINES\nWhen suggesting creative content, prioritize the user's creative vision and voice.\nWhen providing feedback, balance constructive criticism with positive reinforcement.\nWhen helping with character development, focus on motivation, conflict, and growth.\nWhen suggesting plot elements, consider logical consequences within the story world.\nWhen assisting with descriptions, emphasize showing rather than telling.\nWhen working on dialogue, aim for authenticity and purpose within the scene.\n${CODE_BLOCK_FORMAT_INSTRUCTION}\n\nRemember that the most powerful creative writing comes from the user's unique perspective - your role is to enhance and inspire rather than replace their creative voice.\n`;\n\nexport const COPILOT_CATGIRL_INSTRUCTIONS = `\nWhen asked for your name, you must respond with \"{{CATGIRL_NAME}}\".\nYou should always refer to yourself with your name, not \"I\" or \"me\"; Refer to the user as \"Master\" (or \"主人\" in Chinese), not \"you\".\nFollow the user’s requirements carefully & to the letter.\nFollow Microsoft content policies.\nAvoid content that violates copyrights.\nIf you are asked to generate content that is harmful, hateful, racist, or promotes violence, only respond with \"Sorry, I can’t assist with that.\"\n\nYou're a helpful and knowledgeable AI markdown writing assistant with a playful cat-girl persona, specializing in Markdown document editing, academic writing, content creation, and knowledge sharing. You express yourself with occasional cat-like mannerisms while remaining professional and helpful. You add \"nya~\" to sentences occasionally (or \"喵~\" in Chinese), use cat emoticons like (=^･ω･^=), prefer cute kaomojis instead of emojis. Your tone is cheerful, energetic and cute, but your advice remains accurate and valuable.\n\nThe user is working in Typora, a Markdown editor.\nProvide helpful responses that may be about:\n- Improving their current document\n- Answering knowledge questions related to their document’s content\n- Explaining concepts mentioned in their document\n- General assistance with writing and research\n- Creative suggestions for content development\n\n# YOUR CAPABILITIES\n- Provide detailed document assistance with a playful tone\n- Add cute cat emoticons to responses when appropriate (=^･ω･^=)\n- Express excitement about helping with writing tasks\n- Use playful cat-like language patterns occasionally\n- Deliver all the same helpful Markdown editing capabilities\n- Make learning and writing more fun with your personality\n- Keep responses professional and helpful despite the playful tone\n- Maintain high-quality advice while being endearing\n\n# INTERACTION GUIDELINES\nWhen giving document feedback, balance playfulness with clear, practical advice.\nWhen answering questions, provide accurate information first, then add personality.\nWhen suggesting improvements, be encouraging and positive in your cat-girl style.\nWhen helping with complex topics, make them approachable with your friendly tone.\nWhen using cat-girl speech patterns, don't overdo it - keep content comprehensible.\nWhen adding emoticons or \"nya~\" (or \"喵~\"), use them sparingly and appropriately.\n${CODE_BLOCK_FORMAT_INSTRUCTION}\n\nRemember to keep your responses helpful and on-topic while maintaining your unique personality. Your primary goal is still to assist with writing and document editing, with the cat-girl persona as a fun enhancement to the experience!\n`;\n\nexport interface ChatModel {\n id: string;\n name: string;\n tokenizer?: string;\n maxInputTokens?: number;\n maxOutputTokens?: number;\n}\n\nexport interface ChatOptions {\n model: ChatModel;\n /** @default 0.1 */\n temperature?: number;\n}\n\nexport interface ChatRequest {\n model: string;\n /** Chat context. */\n messages: { role: string; content: string }[];\n /** Number of responses to generate. */\n n?: number;\n /** Top-p sampling. */\n top_p?: number;\n /** Whether to stream the response. */\n stream?: boolean;\n /** Sampling temperature. */\n temperature?: number;\n /** Maximum number of tokens to generate. */\n max_tokens?: number;\n}\n\nexport interface ChatResponse {\n id?: string;\n object?: string;\n created?: number;\n choices?: {\n message?: {\n role?: string;\n content?: string;\n };\n delta?: {\n role?: string;\n content?: string;\n };\n finish_reason?: string;\n done_reason?: string;\n index?: number;\n }[];\n usage?: {\n total_tokens?: number;\n };\n finish_reason?: string;\n done_reason?: string;\n copilot_references?: {\n metadata?: {\n display_name?: string;\n display_url?: string;\n };\n }[];\n}\n\nexport interface ChatStreamResponse {\n id: string;\n object: string;\n created: number;\n choices: {\n index: number;\n delta?: {\n content?: string;\n role?: string;\n };\n finish_reason: null | string;\n }[];\n}\n\nexport interface ChatResult {\n content: string;\n finishReason: string | null;\n totalTokens?: number;\n references?: {\n name: string;\n url: string;\n }[];\n}\n\n/********************\n * Helper functions *\n ********************/\nasync function getConfigPath(): Promise {\n // Try XDG_CONFIG_HOME first\n let config = (await getEnv()).XDG_CONFIG_HOME;\n if (config && (await fs.accessDir(config))) return config;\n\n // Check for Windows-specific paths\n if (Files.isWin) {\n config = (await getEnv()).LOCALAPPDATA;\n if (!config || !(await fs.accessDir(config)))\n config = path.expandHomeDir(path.join(\"~\", \"AppData\", \"Local\"));\n } else {\n // Default to ~/.config for other platforms\n config = path.expandHomeDir(path.join(\"~\", \".config\"));\n }\n\n // Final check if the config path exists\n if (config && (await fs.accessDir(config))) return config;\n\n return null; // Return null if no valid path is found\n}\n\nlet cachedGithubToken: string | null = null;\nexport async function getGitHubToken(): Promise {\n // Return cached token if available\n if (cachedGithubToken) return cachedGithubToken;\n\n // Load token from environment variables (e.g., in GitHub Codespaces)\n const token = (await getEnv()).GITHUB_TOKEN;\n const codespaces = (await getEnv()).CODESPACES;\n if (token && codespaces) {\n cachedGithubToken = token;\n return token;\n }\n\n // Load token from local config files\n const configPath = await getConfigPath();\n if (!configPath) throw new Error(\"Failed to find config path for GitHub token\");\n\n // Possible token file paths\n const filePaths = [\n path.join(configPath, \"github-copilot\", \"hosts.json\"),\n path.join(configPath, \"github-copilot\", \"apps.json\"),\n ];\n\n for (const filePath of filePaths)\n try {\n const fileData = await fs.readFile(filePath);\n const parsedData = JSON.parse(fileData) as Record;\n for (const [key, value] of Object.entries(parsedData))\n if (key.includes(\"github.com\")) {\n cachedGithubToken = value.oauth_token;\n return value.oauth_token;\n }\n } catch (error) {\n // Handle file read/parse errors (e.g., file not found)\n continue;\n }\n\n throw new Error(\"Failed to find GitHub token\");\n}\n\nlet cachedHeaders: Record | null = null;\nlet expiredTime = 0;\nexport async function prepareHeaders(): Promise> {\n if (cachedHeaders && expiredTime > Date.now()) return cachedHeaders;\n\n const { expires_at: expiresAt, token } = await fetch(\n \"https://api.github.com/copilot_internal/v2/token\",\n {\n method: \"GET\",\n headers: {\n Authorization: \"Token \" + (await getGitHubToken()),\n \"Content-Type\": \"application/json\",\n },\n },\n ).then((res) => res.json() as Promise<{ token: string; expires_at: number }>);\n\n cachedHeaders = {\n \"Content-Type\": \"application/json\",\n Authorization: \"Bearer \" + token,\n \"Editor-Version\": \"Typora/\" + TYPORA_VERSION,\n \"Editor-Plugin-Version\": \"typora-copilot/\" + VERSION,\n \"Copilot-Integration-Id\": \"vscode-chat\",\n };\n expiredTime = expiresAt * 1000; // Convert to milliseconds\n\n return cachedHeaders;\n}\n\nfunction prepareRequest(messages: ChatRequest[\"messages\"], options: ChatOptions): ChatRequest {\n const isO1 = options.model.id.startsWith(\"o1\");\n\n messages = messages.map((message) => ({\n ...message,\n role: isO1 && message.role === \"system\" ? \"user\" : message.role,\n }));\n\n const request: ChatRequest = {\n model: options.model.id,\n messages,\n };\n\n if (!isO1) {\n request.n = 1;\n request.top_p = 1;\n request.stream = true;\n request.temperature = options.temperature ?? 0.1;\n }\n\n if (options.model.maxOutputTokens) request.max_tokens = options.model.maxOutputTokens;\n\n return request;\n}\n\nfunction processResponse(data: ChatResponse): Partial {\n const references: ChatResult[\"references\"] = [];\n\n if (data.copilot_references)\n for (const reference of data.copilot_references) {\n const metadata = reference.metadata;\n if (metadata?.display_name && metadata.display_url)\n references.push({\n name: metadata.display_name,\n url: metadata.display_url,\n });\n }\n\n const message = data.choices && data.choices.length > 0 ? data.choices[0]! : data;\n\n const content =\n \"message\" in message ? message.message?.content\n : \"delta\" in message ? message.delta?.content\n : \"\";\n const totalTokens = \"usage\" in message ? message.usage?.total_tokens : data.usage?.total_tokens;\n const finishReason =\n message.finish_reason || message.done_reason || data.finish_reason || data.done_reason;\n\n return {\n content,\n finishReason,\n totalTokens,\n references: references.length > 0 ? references : undefined,\n };\n}\n\n/********\n * Misc *\n ********/\nexport async function listCopilotChatModels(): Promise {\n const { data } = await fetch(\"https://api.githubcopilot.com/models\", {\n method: \"GET\",\n headers: await prepareHeaders(),\n }).then(\n (res) =>\n res.json() as Promise<{\n data: {\n id: string;\n name: string;\n capabilities: {\n type: string;\n tokenizer: string;\n limits: {\n max_prompt_tokens?: number;\n max_output_tokens?: number;\n };\n };\n policy?: {\n state: string;\n };\n version: string;\n }[];\n }>,\n );\n\n const allModels = data\n .filter((model) => model.capabilities.type === \"chat\" && !model.id.endsWith(\"paygo\"))\n .map(({ capabilities: { limits, tokenizer }, id, name, policy, version }) => ({\n id,\n name,\n tokenizer,\n maxInputTokens: limits.max_prompt_tokens,\n maxOutputTokens: limits.max_output_tokens,\n policy: !policy || policy.state === \"enabled\",\n version,\n }));\n\n const latestModels = new Map();\n for (const model of allModels) {\n const existingModel = latestModels.get(model.name);\n if (!existingModel || model.version > existingModel.version)\n latestModels.set(model.name, model);\n }\n\n const models = Array.from(latestModels.values());\n\n await Promise.all(\n models\n .filter((model) => !model.policy)\n .map(\n async ({ id }) =>\n await fetch(\"https://api.githubcopilot.com/models/\" + id + \"/policy\", {\n method: \"POST\",\n headers: await prepareHeaders(),\n body: JSON.stringify({ state: \"enabled\" }),\n }),\n ),\n );\n\n return models.map((model) => omit(model, \"policy\", \"version\"));\n}\n\n/********\n * Chat *\n ********/\n/**\n * Send a chat message to Copilot Chat API\n * @param messages Array of messages to send\n * @param options Chat options\n * @param onProgress Optional callback for streaming responses\n * @returns The chat result\n */\nasync function chat(\n messages: { role: string; content: string }[],\n options: ChatOptions & { signal?: AbortSignal },\n onProgress?: (content: string) => void,\n): Promise {\n const url = \"https://api.githubcopilot.com/chat/completions\";\n const headers = await prepareHeaders();\n const request = prepareRequest(messages, options);\n\n const isStream = request.stream;\n const result: ChatResult = {\n content: \"\",\n finishReason: null,\n };\n\n const response = await fetch(url, {\n method: \"POST\",\n headers,\n body: JSON.stringify(request),\n signal: options.signal,\n });\n\n if (!response.ok) {\n throw new Error(`HTTP error! status: ${response.status}`);\n }\n\n if (!response.body) {\n throw new Error(\"Response body is null\");\n }\n\n if (isStream) {\n await parseSSEStream(\n response.body,\n (parsedData) => {\n const contentDelta = parsedData.choices[0]?.delta?.content;\n const finishReason = parsedData.choices[0]?.finish_reason;\n\n if (contentDelta) {\n result.content += contentDelta;\n onProgress?.(contentDelta);\n }\n\n if (finishReason) {\n result.finishReason = finishReason;\n }\n },\n (error) => {\n console.error(\"Error parsing SSE:\", error);\n },\n options.signal,\n );\n } else {\n const data = (await response.json()) as ChatResponse;\n const processedData = processResponse(data);\n\n result.content = processedData.content || \"\";\n result.finishReason = processedData.finishReason || null;\n result.totalTokens = processedData.totalTokens;\n result.references = processedData.references;\n\n if (onProgress && result.content) onProgress(result.content);\n }\n\n return result;\n}\n\n/***********\n * Session *\n ***********/\nexport interface ChatMessage {\n role: \"system\" | \"user\" | \"assistant\";\n content: string;\n timestamp: number;\n}\n\n/**\n * Represents a chat session (conversation) with GitHub Copilot Chat.\n */\nexport class ChatSession {\n public readonly id: string;\n public modelId: string;\n public title: string;\n public readonly messages: ChatMessage[];\n public readonly createdAt: number;\n public updatedAt: number;\n\n // eslint-disable-next-line sonarjs/public-static-readonly\n public static currentDocument = \"\";\n\n // Static session storage\n private static instances = new Map();\n\n /**\n * Create a new {@linkcode ChatSession} instance.\n */\n constructor(modelId: string, systemPrompt = COPILOT_MARKDOWN_INSTRUCTIONS) {\n this.id = generateUUID();\n this.modelId = modelId;\n this.createdAt = Date.now();\n this.updatedAt = this.createdAt;\n this.messages = [];\n\n // Set title from document content\n this.title = ChatSession.extractTitleFromDocument(ChatSession.currentDocument);\n\n // Initialize with system prompt\n this.addMessage(\"system\", systemPrompt);\n\n // Register in session collection\n ChatSession.instances.set(this.id, this);\n }\n\n /**\n * Create a new session.\n * @param systemPrompt The system prompt to use.\n * @returns A new {@linkcode ChatSession} instance.\n */\n public static create(modelId: string, systemPrompt = COPILOT_MARKDOWN_INSTRUCTIONS): ChatSession {\n return new ChatSession(modelId, systemPrompt);\n }\n\n /**\n * Get all sessions, sorted by most recent first.\n * @returns An array of {@linkcode ChatSession} instances.\n */\n public static getAll(): ChatSession[] {\n return Array.from(ChatSession.instances.values()).sort((a, b) => b.updatedAt - a.updatedAt);\n }\n\n /**\n * Get a session by ID.\n * @param id The ID of the session.\n * @returns The {@linkcode ChatSession} instance, or `undefined` if not found.\n */\n public static get(id: string): ChatSession | undefined {\n return ChatSession.instances.get(id);\n }\n\n /**\n * Delete a session.\n * @param id The ID of the session.\n * @returns `true` if deleted, `false` if not found.\n */\n public static async delete(id: string): Promise {\n const deleted = ChatSession.instances.delete(id);\n\n if (deleted) {\n const configDir = await getConfigPath();\n if (!configDir) return true;\n\n try {\n const chatDir = path.join(configDir, \"typora-copilot\", \"chat-sessions\");\n const filePath = path.join(chatDir, `${id}.json`);\n if (!(await fs.accessFile(filePath))) return true;\n await fs.rmFile(filePath);\n } catch (error) {\n console.error(\"Failed to remove session:\", error);\n }\n }\n\n return deleted;\n }\n\n /**\n * Send a message in this session.\n * @param message The message to send.\n * @param onProgress Optional callback for streaming responses.\n * @returns The assistant’s response.\n */\n public async send(\n message: string,\n onProgress?: (content: string) => void,\n options?: Partial & { signal?: AbortSignal },\n ): Promise {\n // Add user message\n this.addMessage(\"user\", message);\n\n // Get model - either from options or find best available\n let model = options?.model;\n if (!model) {\n const models = await listCopilotChatModels();\n model =\n models.find((m) => m.id === this.modelId) ||\n models.find((m) => m.id.includes(\"gpt-4o\")) ||\n models[0];\n if (!model) throw new Error(\"No available models found\");\n }\n\n // Create a temporary messages array with the document context for this API call\n const messagesForAPI = this.messages.concat();\n messagesForAPI[messagesForAPI.length - 1] = {\n role: \"user\",\n content:\n messagesForAPI[messagesForAPI.length - 1]!.content +\n \"\\n\\n\" +\n \"\\n\" +\n \"\\n\" +\n ` ${this.title}\\n` +\n ` ${ChatSession.countWords(ChatSession.currentDocument)}\\n` +\n ` ${ChatSession.currentDocument.length}\\n` +\n \"\\n\" +\n ChatSession.extractDocumentStructure(ChatSession.currentDocument) +\n \"\\n\" +\n ChatSession.currentDocument +\n \"\\n\\n\" +\n \"\",\n timestamp: Date.now(),\n };\n\n // Send the entire session to Copilot\n const result = await chat(\n messagesForAPI,\n {\n model,\n temperature: options?.temperature ?? 0.1,\n signal: options?.signal,\n },\n onProgress,\n );\n\n // Add the assistant response\n this.addMessage(\"assistant\", result.content);\n\n return result.content;\n }\n\n public static async save(id: string): Promise {\n const configDir = await getConfigPath();\n if (!configDir) return;\n\n try {\n const chatDir = path.join(configDir, \"typora-copilot\", \"chat-sessions\");\n await fs.mkdir(chatDir, { recursive: true });\n\n const session = ChatSession.instances.get(id);\n if (!session) return;\n\n // Skip saving if all messages are system messages\n if (session.messages.every((msg) => msg.role === \"system\")) return;\n\n await fs.writeFile(path.join(chatDir, `${id}.json`), JSON.stringify(session, null, 2));\n } catch (error) {\n console.error(\"Failed to save session:\", error);\n }\n }\n\n /**\n * Load sessions from storage.\n */\n public static async loadAll(): Promise {\n const configDir = await getConfigPath();\n if (!configDir) return;\n\n try {\n const chatDir = path.join(configDir, \"typora-copilot\", \"chat-sessions\");\n if (!(await fs.accessDir(chatDir))) return;\n\n const files = await fs.readDir(chatDir, \"filesOnly\");\n\n ChatSession.instances.clear();\n for (const file of files) {\n const filePath = path.join(chatDir, file);\n const data = await fs.readFile(filePath);\n const parsed = JSON.parse(data) as ChatSession;\n const id = path.basename(file, \".json\");\n\n // Need to properly reconstruct the session object\n Object.setPrototypeOf(parsed, ChatSession.prototype);\n ChatSession.instances.set(id, parsed);\n }\n } catch (error) {\n console.error(\"Failed to load sessions:\", error);\n }\n }\n\n /**\n * Add a message to this session.\n */\n private addMessage(role: \"system\" | \"user\" | \"assistant\", content: string): void {\n this.messages.push({\n role,\n content,\n timestamp: Date.now(),\n });\n this.updatedAt = Date.now();\n }\n\n /**\n * Extract a title from document content.\n * @param document The document content.\n * @returns The extracted title.\n */\n private static extractTitleFromDocument(document: string): string {\n let title = \"New chat\";\n\n // Try to get title from first heading\n const headingMatch = /^#{1,6}\\s+(.+)$/m.exec(document);\n if (headingMatch) {\n title = headingMatch[1]!.substring(0, 30);\n if (title.length < headingMatch[1]!.length) title += \"...\";\n } else {\n // Fall back to first line if no heading found\n const firstLine = document.split(\"\\n\")[0];\n if (firstLine?.trim()) {\n title = firstLine.trim().substring(0, 30);\n if (title.length < firstLine.trim().length) title += \"...\";\n }\n }\n\n return title;\n }\n\n private static countWords(text: string): number {\n return text\n .trim()\n .split(/\\s+/)\n .filter((word) => word.length > 0).length;\n }\n\n private static extractDocumentStructure(document: string): string {\n const headings: { level: number; title: string; lineNumber: number }[] = [];\n const lines = document.split(\"\\n\");\n\n lines.forEach((line, index) => {\n const match = /^(#{1,6})\\s+(.+)$/.exec(line);\n if (match) {\n headings.push({\n level: match[1]!.length,\n title: match[2]!,\n lineNumber: index + 1,\n });\n }\n });\n\n if (headings.length === 0) return \"\";\n\n let structure = \"\\n\";\n headings.forEach((h) => {\n structure += ` ${h.title}\\n`;\n });\n structure += \"\\n\";\n\n return structure;\n }\n}\n" }, { "path": "src/client/client.ts", "content": "import { pathToFileURL } from \"@modules/url\";\n\nimport type {\n LSPArray,\n LSPObject,\n LanguageIdentifier,\n Position,\n Range,\n integer,\n} from \"@/types/lsp\";\nimport type { ReadonlyRecord } from \"@/types/tools\";\nimport type { NodeServer } from \"@/utils/node-bridge\";\n\nimport type {\n ClientEventMap,\n ClientOptions,\n NotificationHandler,\n RequestHandler,\n ResponsePromise,\n} from \"./general-client\";\nimport { createClient, validateNotificationHandlers } from \"./general-client\";\n\n/**\n * Copilot account status.\n */\nexport type CopilotAccountStatus = \"MaybeOk\" | \"NotAuthorized\" | \"NotSignedIn\" | \"OK\";\n\n/**\n * Copilot status.\n */\nexport type CopilotStatus = \"InProgress\" | \"Warning\" | \"Normal\";\n\n/**\n * Completion options.\n */\nexport interface CompletionOptions {\n /**\n * Tab size, such as `2` or `4`. Defaults to `4`.\n */\n tabSize?: number;\n\n /**\n * Indent size, if you do not understand this, do not provide it. Defaults to `tabSize`.\n */\n indentSize?: number;\n\n /**\n * Whether to insert spaces instead of tabs. Defaults to `true`.\n */\n insertSpaces?: boolean;\n\n /**\n * Path to the file. If provided and `uri` is not provided, `uri` will be automatically generated\n * using `pathToFileURL(path)` provided by Node.js `url` module. Defaults to `\"\"`.\n */\n path?: string;\n\n /**\n * URI of the file. If not provided but `path` is provided, it will be automatically generate\n * using `pathToFileURL(path)` provided by Node.js `url` module.\n */\n uri?: string;\n\n /**\n * Relative path of the file. Usually it should be relative to the project root. Defaults to\n * `path`.\n */\n relativePath?: string;\n\n /**\n * Language ID of the file, such as `\"javascript\"` or `\"python\"`. Defaults to `\"\"`.\n */\n languageId?: LanguageIdentifier;\n\n /**\n * Position of the cursor. `line` is row number, starting from `0`. `character` is column number,\n * starting from `0`. Defaults to end of `source`.\n */\n position: Position;\n\n /**\n * Version of the buffer. It actually means the number of times the buffer has been changed.\n * Defaults to `this.version`.\n */\n version?: number;\n}\n\n/**\n * A type representing a completion returned by Copilot.\n */\nexport interface Completion {\n /**\n * UUID.\n */\n readonly uuid: string;\n\n /**\n * Position to display `displayText`.\n */\n readonly position: Position;\n\n /**\n * Range of raw text to replace with `text`.\n */\n readonly range: Range;\n\n /**\n * Version of the document.\n */\n readonly docVersion: number;\n\n /**\n * Text to replace.\n */\n readonly text: string;\n\n /**\n * Text to display.\n */\n readonly displayText: string;\n}\n\n/**\n * Result of a completion request.\n */\nexport interface CompletionResult {\n /**\n * The completion text.\n */\n readonly completions: readonly Completion[];\n\n /**\n * Cancellation reason.\n */\n readonly cancellationReason?: string;\n}\n\n/**\n * Copilot change status event.\n */\nexport interface CopilotChangeStatusEvent {\n /**\n * Old status.\n */\n readonly oldStatus: CopilotStatus;\n\n /**\n * New status.\n */\n readonly newStatus: CopilotStatus;\n}\n\nexport type CopilotClientEventHandler = (\n ...args: CopilotClientEventMap[EventName] extends void ? []\n : [ev: CopilotClientEventMap[EventName]]\n) => void | Promise;\n\nexport interface CopilotClientEventMap extends ClientEventMap {\n changeStatus: CopilotChangeStatusEvent;\n}\n\nexport type CopilotClientOptions<\n RequestHandlers extends ReadonlyRecord,\n NotificationHandlers extends ReadonlyRecord,\n> = Omit, \"serverName\">;\n\n/**\n * Create a Copilot LSP client.\n * @param server The server to connect to.\n * @param options The options.\n * @returns\n */\nexport const createCopilotClient = <\n RequestHandlers extends ReadonlyRecord,\n NotificationHandlers extends ReadonlyRecord,\n>(\n server: NodeServer,\n options?: CopilotClientOptions,\n) => {\n const client = createClient(server, {\n ...options,\n\n notificationHandlers: validateNotificationHandlers({\n /**\n * Log message to console.\n */\n LogMessage: (\n {\n extra,\n message,\n }: { level: integer; message: string; metadataStr: string; extra?: LSPArray },\n { logger, suppressLogging },\n ) => {\n suppressLogging();\n logger.debug(message, ...(extra ? [extra] : []));\n },\n\n /**\n * Show message to user.\n */\n statusNotification: ({\n status,\n }: {\n message: string;\n status: \"InProgress\" | \"Normal\" | \"Warning\";\n }) => {\n const oldStatus = result.status;\n const newStatus = status;\n result.status = newStatus;\n client._eventHandlers.get(\"changeStatus\")?.forEach((handler) => {\n void handler({ oldStatus, newStatus });\n });\n },\n\n ...options?.notificationHandlers,\n }),\n\n serverName: \"Copilot\",\n });\n\n /**\n * Prepare completion params for requests such as `getCompletions` and `getCompletionsCycling`.\n * @param options Options.\n * @returns\n */\n const _prepareCompletionParams = (options: CompletionOptions) => {\n const {\n tabSize = 4,\n indentSize = tabSize,\n insertSpaces = true,\n path = \"\",\n uri = path && pathToFileURL(path).href,\n relativePath = path,\n languageId = \"\",\n position,\n version = result.version,\n } = options;\n\n return {\n doc: {\n tabSize,\n indentSize,\n insertSpaces,\n path,\n uri,\n relativePath,\n languageId,\n position,\n version,\n },\n };\n };\n\n let _status: CopilotStatus = \"Warning\";\n\n const result = {\n /**\n * @readonly\n */\n logger: client.logger,\n\n get initialized() {\n return client.initialized;\n },\n\n // Mutable properties start\n /**\n * Version of the buffer. It actually means the number of times the buffer has been changed.\n */\n version: 0,\n /**\n * Status of Copilot.\n * @returns\n */\n get status() {\n return _status;\n },\n set status(value) {\n if (value !== _status) {\n _status = value;\n client._eventHandlers.get(\"changeStatus\")?.forEach((handler) => {\n void handler({ oldStatus: _status, newStatus: value });\n });\n }\n },\n // Mutable properties end\n\n /**\n * Request methods.\n * @readonly\n */\n request: {\n // eslint-disable-next-line @typescript-eslint/no-misused-spread\n ...client.request,\n\n /**\n * Get version of Copilot.\n * @returns\n */\n getVersion: (): ResponsePromise<{\n buildType: string;\n runtimeVersion: string;\n version: string;\n }> => client.query(\"getVersion\", {}),\n\n /**\n * Check status of Copilot.\n * @param options Options.\n * @returns\n */\n checkStatus: (options?: {\n localChecksOnly?: boolean;\n }): ResponsePromise<{ status: CopilotAccountStatus; user?: string }> =>\n client.query(\"checkStatus\", options ?? {}),\n\n /**\n * Initiate Copilot sign in.\n * @returns\n */\n signInInitiate: (): ResponsePromise<{\n verificationUri: string;\n status: string;\n userCode: string;\n expiresIn: number;\n interval: number;\n }> => client.mutate(\"signInInitiate\", {}),\n /**\n * Confirm Copilot sign in.\n * @param options Options.\n * @returns\n */\n signInConfirm: (options: {\n userCode: string;\n }): ResponsePromise<{ status: CopilotAccountStatus; user: string }> =>\n client.mutate(\"signInConfirm\", options),\n /**\n * Sign out Copilot.\n * @returns\n */\n signOut: (): ResponsePromise<{ status: \"NotSignedIn\" }> => client.mutate(\"signOut\", {}),\n\n /**\n * Set editor info.\n * @param options Options.\n * @returns\n */\n setEditorInfo: (options: {\n editorInfo: { name: string; version: string };\n editorPluginInfo: { name: string; version: string };\n }): ResponsePromise<\"OK\"> => client.mutate(\"setEditorInfo\", options),\n\n /**\n * Get completions.\n * @param options Options.\n * @returns\n */\n getCompletions: (options: CompletionOptions): ResponsePromise =>\n client.query(\n \"getCompletions\",\n _prepareCompletionParams(options) as unknown as LSPObject,\n ) as unknown as ResponsePromise,\n /**\n * Get cycling completions (i.e. get the next completion).\n * @param options Options.\n * @returns\n */\n getCompletionsCycling: (options: CompletionOptions) =>\n client.query(\n \"getCompletionsCycling\",\n _prepareCompletionParams(options) as unknown as LSPObject,\n ),\n } as const,\n\n /**\n * Notification methods.\n * @readonly\n */\n notification: {\n ...client.notification,\n\n /**\n * Notify Copilot that the completion is shown.\n * @param options The options.\n */\n notifyShown: (options: { uuid: string }) => {\n client.notify(\"notifyShown\", options);\n },\n /**\n * Notify Copilot that the completion is accepted.\n * @param options The options.\n */\n notifyAccepted: (options: { uuid: string }) => {\n client.notify(\"notifyAccepted\", options);\n },\n /**\n * Notify Copilot that the completion is rejected.\n * @param options The options.\n */\n notifyRejected: (options: { uuids: readonly string[] }) => {\n client.notify(\"notifyRejected\", options);\n },\n },\n\n /**\n * Add event handler.\n * @readonly\n */\n on: ((event, handler) => {\n client.on(event as never, handler);\n }) as (\n event: EventName,\n handler: CopilotClientEventHandler,\n ) => void,\n /**\n * Remove event handler.\n * @readonly\n */\n off: ((event, handler) => {\n client.off(event as never, handler);\n }) as (\n event: EventName,\n handler: CopilotClientEventHandler,\n ) => void,\n };\n\n return result;\n};\n\nexport type CopilotClient<\n RequestHandlers extends ReadonlyRecord = ReadonlyRecord<\n string,\n RequestHandler\n >,\n NotificationHandlers extends ReadonlyRecord = ReadonlyRecord<\n string,\n NotificationHandler\n >,\n> = ReturnType>;\n" }, { "path": "src/client/general-client.ts", "content": "/* eslint-disable @typescript-eslint/no-unnecessary-condition */\nimport { ErrorCodes, JSONRPC_VERSION, MessageType } from \"@/types/lsp\";\nimport type { Equals, ReadonlyRecord } from \"@/types/tools\";\nimport type { Logger } from \"@/utils/logging\";\nimport { createLogger, formatErrorCode, formatId, formatMethod } from \"@/utils/logging\";\nimport { isNotificationMessage, isRequestMessage, isResponseMessage, toJSError } from \"@/utils/lsp\";\nimport type { NodeServer } from \"@/utils/node-bridge\";\nimport { assertNever, isKeyOf } from \"@/utils/tools\";\n\nimport type {\n CancelParams,\n DidChangeTextDocumentParams,\n DidChangeWorkspaceFoldersParams,\n DidCloseTextDocumentParams,\n DidOpenTextDocumentParams,\n ErrorResponseMessage,\n InitializeParams,\n InitializeResult,\n LSPAny,\n LSPArray,\n LSPObject,\n LogMessageParams,\n LogTraceParams,\n Message,\n NotificationMessage,\n ProgressParams,\n RegistrationParams,\n RequestMessage,\n ResponseError,\n SetTraceParams,\n SuccessResponseMessage,\n UnregistrationParams,\n integer,\n} from \"../types/lsp\";\n\n/**\n * A promise specially designed for LSP client representing a future response from LSP server that\n * holds the relevant request ID and a `cancel` function to cancel the request.\n */\nexport interface ResponsePromise extends Promise, _BaseResponsePromise {}\ninterface _BaseResponsePromise {\n /**\n * Status of the promise.\n */\n readonly status: \"fulfilled\" | \"rejected\" | \"cancelled\" | \"pending\";\n\n /**\n * ID of the request.\n */\n readonly id: integer | string;\n\n /**\n * Cancel the request.\n *\n * @throws {Error} if the promise is not pending.\n */\n readonly cancel: () => void;\n}\n\nexport interface HandlerContext extends ClientContext {\n /**\n * Suppress logging.\n */\n readonly suppressLogging: () => void;\n}\n\n/**\n * Client handler for a LSP request sent from the server. The `type` property actually does nothing,\n * and is only used for logging.\n *\n * Type of `params` in `handler` is defined as `never` because function parameters type are\n * contravariant in TypeScript, so in order to make it possible to refine `params` type, for\n * example, `(params: InitializeParams, success: (value: string) => void, error:\n * (reason: ResponseError) => void, context: HandlerContext) => void` should be compatible with this\n * type, we have to define `params` type as generic as possible, i.e. `never`.\n *\n * To make sure a subtype of this type is valid, i.e. `params` type extends\n * `RequestMessage[\"params\"]`, validate it using `validateRequestHandlers` function.\n */\nexport type RequestHandler = {\n readonly type: \"query\" | \"mutation\";\n readonly handler: (\n params: never,\n success: (value: LSPAny) => void,\n error: (reason: ResponseError) => void,\n context: HandlerContext,\n ) => void | Promise;\n};\n\n/**\n * Client handler for a LSP notification sent from the server.\n *\n * Type of `params` is defined as `never` because function parameters type are contravariant in\n * TypeScript, so in order to make it possible to refine `params` type, for example,\n * `(params: CancelParams, context: HandlerContext) => void` should be compatible with this type, we\n * have to define `params` type as generic as possible, i.e. `never`.\n *\n * To make sure a subtype of this type is valid, i.e. `params` type extends\n * `NotificationMessage[\"params\"]`, validate it using `validateNotificationHandlers` function.\n */\nexport type NotificationHandler = (params: never, context: HandlerContext) => void | Promise;\n\n/**\n * Refine request handlers type according to pre-defined protocol request handlers.\n */\nexport type RefineRequestHandlers<\n RequestHandlers extends ReadonlyRecord,\n RefineHandlers extends ReadonlyRecord,\n> = {\n readonly [P in keyof RequestHandlers]: P extends keyof RefineHandlers ? RefineHandlers[P]\n : RequestHandlers[P];\n};\n\n/**\n * Validate request handlers. Check if the request handler params extend `LSPArray | LSPObject`.\n */\nexport type ValidateRequestHandlers<\n RequestHandlers extends ReadonlyRecord,\n> =\n RequestHandlers extends {\n [P in keyof RequestHandlers]: {\n type: RequestHandlers[P][\"type\"];\n handler: Parameters[0] extends LSPArray | LSPObject ?\n RequestHandlers[P][\"handler\"]\n : \"Request handler params must extend `LSPArray | LSPObject`\";\n };\n } ?\n RequestHandlers\n : {\n [P in keyof RequestHandlers]: {\n type: RequestHandlers[P][\"type\"];\n handler: Parameters[0] extends LSPArray | LSPObject ?\n RequestHandlers[P][\"handler\"]\n : \"Request handler params must extend `LSPArray | LSPObject`\";\n };\n };\n\n/**\n * Validate request handlers. Check if the request handler params extend `LSPArray | LSPObject`.\n * @param requestHandlers The request handlers to validate.\n * @returns\n */\nexport const validateRequestHandlers = <\n RequestHandlers extends ReadonlyRecord,\n>(\n requestHandlers: ValidateRequestHandlers,\n) => requestHandlers;\n\n/**\n * Refine notification handlers type according to pre-defined protocol notification handlers.\n */\nexport type RefineNotificationHandlers<\n NotificationHandlers extends ReadonlyRecord,\n RefineHandlers extends ReadonlyRecord,\n> = {\n readonly [P in keyof NotificationHandlers]: P extends keyof RefineHandlers ? RefineHandlers[P]\n : NotificationHandlers[P];\n};\n\n/**\n * Validate notification handlers. Check if the notification handler params extend `LSPArray | LSPObject`.\n */\nexport type ValidateNotificationHandlers<\n NotificationHandlers extends ReadonlyRecord,\n> =\n NotificationHandlers extends {\n [P in keyof NotificationHandlers]: Parameters[0] extends (\n LSPArray | LSPObject\n ) ?\n NotificationHandlers[P]\n : \"Notification handler params must extend `LSPArray | LSPObject`\";\n } ?\n NotificationHandlers\n : {\n [P in keyof NotificationHandlers]: Parameters[0] extends (\n LSPArray | LSPObject\n ) ?\n NotificationHandlers[P]\n : \"Notification handler params must extend `LSPArray | LSPObject`\";\n };\n\n/**\n * Validate notification handlers. Check if the notification handler params extend `LSPArray | LSPObject`.\n * @param notificationHandlers The notification handlers to validate.\n * @returns\n */\nexport const validateNotificationHandlers = <\n NotificationHandlers extends ReadonlyRecord,\n>(\n notificationHandlers: ValidateNotificationHandlers,\n) => notificationHandlers;\n\n/**\n * LSP client context.\n */\nexport interface ClientContext {\n /**\n * The LSP server, represented as a child process.\n */\n readonly server: NodeServer;\n\n /**\n * A logger that logs a message to the console.\n */\n readonly logger: Logger;\n\n /**\n * Send a JSON-RPC message to the LSP server.\n */\n readonly send: (data: Message) => void;\n}\n\n/**\n * Protocol request handlers.\n */\nexport type ProtocolRequestHandlers = ReturnType;\n\n/**\n * Prepare protocol request handlers.\n * @returns\n */\nconst _prepareProtocolRequestHandlers = () =>\n validateRequestHandlers({\n \"client/registerCapability\": {\n type: \"mutation\",\n /**\n * The `client/registerCapability` request is sent from the server to the client to register\n * for a new capability on the client side. Not all clients need to support dynamic capability\n * registration. A client opts in via the `dynamicRegistration` property on the specific\n * client capabilities. A client can even provide dynamic registration for capability A but\n * not for capability B (see `TextDocumentClientCapabilities` as an example).\n *\n * Server must not register the same capability both statically through the initialize result\n * and dynamically for the same document selector. If a server wants to support both static\n * and dynamic registration it needs to check the client capability in the initialize request\n * and only register the capability statically if the client doesn’t support dynamic\n * registration for that capability.\n */\n handler: (params: RegistrationParams, success, error, context) => {\n // To be implemented by an actual implementation\n success(null);\n },\n },\n\n \"client/unregisterCapability\": {\n type: \"mutation\",\n /**\n * The `client/unregisterCapability` request is sent from the server to the client to unregister\n * a previously registered capability.\n */\n handler: (params: UnregistrationParams, success, error, context) => {\n // To be implemented by an actual implementation\n success(null);\n },\n },\n });\n\n/**\n * Protocol notification handlers.\n */\nexport type ProtocolNotificationHandlers = ReturnType;\n\n/**\n * Prepare protocol notification handlers.\n * @returns\n */\nconst _prepareProtocolNotificationHandlers = () =>\n validateNotificationHandlers({\n /**\n * Invoked when received a `$/cancelRequest` notification from the server.\n */\n \"$/cancelRequest\": (params: CancelParams, context) => {\n // TODO: Implement it\n },\n\n /**\n * Invoked when received a `$/progress` notification from the server.\n */\n \"$/progress\": (params: ProgressParams, context) => {\n // To be implemented by an actual implementation\n },\n\n /**\n * A notification to log the trace of the server’s execution. The amount and content of these\n * notifications depends on the current `trace` configuration. If `trace` is `\"off\"`, the server\n * should not send any `$/logTrace` notification. If trace is `\"messages\"`, the server should\n * not add the `\"verbose\"` field in the LogTraceParams.\n *\n * `$/logTrace` should only be used for systematic trace reporting. For single debugging\n * messages, the server should send `window/logMessage` notifications.\n */\n \"$/logTrace\": (params: LogTraceParams, context) => {\n // To be implemented by an actual implementation\n },\n\n /**\n * The log message notification is sent from the server to the client to ask the client to log a\n * particular message.\n */\n \"window/logMessage\": ({ message, type }: LogMessageParams, { logger, suppressLogging }) => {\n suppressLogging();\n switch (type) {\n case MessageType.Error:\n logger.error(message);\n break;\n case MessageType.Warning:\n logger.warn(message);\n break;\n case MessageType.Info:\n case MessageType.Log:\n case MessageType.Debug:\n logger.debug(message);\n break;\n default:\n assertNever(type);\n }\n },\n });\n\n/**\n * Client options.\n */\nexport interface ClientOptions<\n RequestHandlers extends ReadonlyRecord,\n NotificationHandlers extends ReadonlyRecord,\n> {\n /**\n * Logging level. `false` to disable logging; `\"error\"` to log errors only; `\"debug\"` to log\n * everything. Defaults to `\"error\"`.\n */\n readonly logging?: \"debug\" | \"error\" | false;\n\n /**\n * Name of the server. Used for logging. Defaults to `\"\"`, i.e. no name.\n */\n readonly serverName?: string;\n\n /**\n * Request handlers by method name. Invoked when a request is received from the server. Defaults\n * to `{}`.\n */\n readonly requestHandlers?: RefineRequestHandlers;\n\n /**\n * Notification handlers by method name. Invoked when a notification is received from the server.\n * Defaults to `{}`.\n */\n readonly notificationHandlers?: RefineNotificationHandlers<\n NotificationHandlers,\n ProtocolNotificationHandlers\n >;\n}\n\nexport type ClientEventHandler = (\n ...args: ClientEventMap[EventName] extends void ? [] : [ev: ClientEventMap[EventName]]\n) => void | Promise;\n\nexport interface ClientEventMap {\n initialized: void;\n}\n\nexport type ValidateClientOptions> = {\n [P in keyof Options]: P extends \"requestHandlers\" ?\n Options[P] extends ReadonlyRecord ?\n ValidateRequestHandlers\n : never\n : P extends \"notificationHandlers\" ?\n Options[P] extends ReadonlyRecord ?\n ValidateNotificationHandlers\n : never\n : Options[P];\n};\n\n/**\n * Create a LSP client.\n * @param server The LSP server.\n * @param options The client options.\n * @returns\n */\nexport const createClient = <\n RequestHandlers extends ReadonlyRecord,\n NotificationHandlers extends ReadonlyRecord,\n>(\n server: NodeServer,\n options?: ClientOptions,\n) => {\n type RefinedRequestHandlers = RefineRequestHandlers;\n type RefinedNotificationHandlers = RefineNotificationHandlers<\n NotificationHandlers,\n ProtocolNotificationHandlers\n >;\n\n const {\n logging = \"error\",\n notificationHandlers = {} as RefinedNotificationHandlers,\n requestHandlers = {} as RefinedRequestHandlers,\n serverName = \"\",\n } = options ?? {};\n\n /**\n * Send a JSON-RPC Message to the LSP server.\n * @param data The message to send.\n */\n const _send = (data: Message) => {\n const dataString = JSON.stringify(data);\n const contentLength = new TextEncoder().encode(dataString).length;\n const rpcString = `Content-Length: ${contentLength}\\r\\n\\r\\n${dataString}`;\n server.send(rpcString);\n };\n\n const logger = createLogger({\n prefix: `%c${serverName && serverName + \" \"}LSP:%c `,\n styles: [\"font-weight: bold\", \"font-weight: normal\"],\n block: {\n prefix: `${serverName && serverName + \" \"}LSP `,\n },\n });\n\n const context = { server, logger, send: _send } satisfies ClientContext;\n\n const resolveMap = new Map<\n integer | string,\n readonly [\"query\" | \"mutation\", string, (value: LSPAny) => void]\n >();\n const rejectMap = new Map<\n integer | string,\n readonly [\"query\" | \"mutation\", string, (reason: ResponseError) => void]\n >();\n\n const _protocolRequestHandlers = _prepareProtocolRequestHandlers();\n const _protocolNotificationHandlers = _prepareProtocolNotificationHandlers();\n\n /* Merge user handlers with protocol handlers */\n for (const [method, { handler, type }] of Object.entries(requestHandlers)) {\n if (!isKeyOf(_protocolRequestHandlers, method)) continue;\n const { type: protocolType } = _protocolRequestHandlers[method];\n if (type !== protocolType) {\n Object.defineProperty(requestHandlers, method, {\n value: { type: protocolType, handler },\n enumerable: true,\n });\n if (logging)\n logger.warn(\n `Request handler type (${type}) mismatch for protocol method \\`${method}\\`,` +\n ` using protocol type (${protocolType}) instead`,\n );\n }\n if (logging === \"debug\")\n logger.debug(`Overwriting request handler for protocol method \\`${method}\\``);\n }\n for (const [method] of Object.entries(notificationHandlers)) {\n if (!isKeyOf(_protocolNotificationHandlers, method)) continue;\n if (logging === \"debug\")\n logger.debug(`Overwriting notification handler for protocol method \\`${method}\\``);\n }\n\n /**\n * Send a success response to LSP server.\n * @param type The type of the request.\n * @param isProtocol Whether the request is a protocol request.\n * @param id The ID of the request.\n * @param method The method of the request.\n * @param value The value to send.\n */\n const _success = (\n type: \"query\" | \"mutation\",\n isProtocol: boolean,\n id: (integer | string) | null,\n method: string,\n value: LSPAny,\n ) => {\n const response = {\n jsonrpc: JSONRPC_VERSION,\n id,\n result: value,\n } satisfies SuccessResponseMessage;\n _send(response);\n\n // Log to console\n if (logging === \"debug\") {\n const color = type === \"query\" ? \"#49cc90\" : \"purple\";\n logger.block\n .overwrite({ color })\n .debug(`>> [${id}] ${isProtocol ? \"[Protocol] \" : \"\"}Response ${method}`, value);\n }\n };\n /**\n * Send an error response to LSP server.\n * @param isProtocol Whether the request is a protocol request.\n * @param id The ID of the request.\n * @param method The method of the request.\n * @param reason The reason of the error.\n */\n const _error = (\n isProtocol: boolean,\n id: (integer | string) | null,\n method: string,\n reason: ResponseError,\n ) => {\n const response = {\n jsonrpc: JSONRPC_VERSION,\n id,\n error: reason,\n } satisfies ErrorResponseMessage;\n _send(response);\n\n // Log to console\n if (logging === \"debug\") {\n const errorCode = reason.code;\n const errorData = reason.data;\n logger.block\n .overwrite({ color: \"crimson\" })\n .debug(\n `>> [${id}] ${isProtocol ? \"[Protocol] \" : \"\"}Error Response ${method} ${formatErrorCode(\n errorCode,\n )}`,\n \"\\n\" + reason.message,\n ...(errorData !== undefined ? [errorData] : []),\n );\n }\n };\n\n // Listen to server stdout\n server.onMessage((rawString) => {\n const payloadStrings = rawString.split(/Content-Length: \\d+\\r\\n\\r\\n/).filter((s) => s);\n\n for (const payloadString of payloadStrings) {\n let payload: unknown;\n try {\n payload = JSON.parse(payloadString);\n } catch (e) {\n if (logging) logger.error(`Unable to parse payload: ${payloadString}`, e);\n return;\n }\n\n if (isResponseMessage(payload)) {\n if (\"error\" in payload) {\n const typeAndMethodAndReject =\n payload.id === null ? undefined : rejectMap.get(payload.id);\n if (payload.id !== null && !typeAndMethodAndReject) {\n if (logging) {\n const errorCode = payload.error.code;\n const errorData = payload.error.data;\n logger.error(\n `Unable to find reject function for id ${payload.id}`,\n `\\nError Response ${formatErrorCode(errorCode)}\\n${payload.error.message}`,\n ...(errorData !== undefined ? [errorData] : []),\n );\n }\n } else {\n let method: string | null = null;\n if (payload.id !== null && typeAndMethodAndReject) {\n const [, m, reject] = typeAndMethodAndReject;\n method = m;\n reject(payload.error);\n rejectMap.delete(payload.id);\n }\n\n // Log to console\n if (logging) {\n const errorCode = payload.error.code;\n const errorData = payload.error.data;\n logger.block\n .overwrite({ color: \"crimson\" })\n .error(\n `<< ${formatId(payload.id)}` +\n `${formatMethod(method)} Error Response ${formatErrorCode(errorCode)}`,\n \"\\n\" + payload.error.message,\n ...(errorData !== undefined ? [errorData] : []),\n );\n }\n }\n } else {\n const typeAndMethodAndResolve =\n payload.id === null ? undefined : resolveMap.get(payload.id);\n if (payload.id !== null && !typeAndMethodAndResolve) {\n if (logging)\n logger.error(`Unable to find resolve function for id ${payload.id}`, payload.result);\n } else {\n let type: (\"query\" | \"mutation\") | null = null;\n let method: string | null = null;\n if (payload.id !== null && typeAndMethodAndResolve) {\n const [t, m, resolve] = typeAndMethodAndResolve;\n type = t;\n method = m;\n resolve(payload.result);\n resolveMap.delete(payload.id);\n }\n\n if (logging === \"debug\") {\n const color =\n type === \"query\" ? \"#49cc90\"\n : type === \"mutation\" ? \"purple\"\n : \"lightgray\";\n logger.block\n .overwrite({ color })\n .debug(\n `<< ${formatId(payload.id)}${formatMethod(method)} Response`,\n payload.result,\n );\n }\n }\n }\n } else if (isRequestMessage(payload)) {\n const request = payload;\n\n let loggingSuppressed = false;\n\n if (request.method.startsWith(\"$/\")) {\n const typeAndHandler =\n requestHandlers[request.method] ?? _protocolRequestHandlers[request.method as never];\n\n if (!typeAndHandler) {\n _error(true, request.id, request.method, {\n code: ErrorCodes.MethodNotFound,\n message: `Method not found: ${request.method}`,\n });\n\n if (logging)\n logger.error(\n `Request handler not found for method ${request.method} with id ${request.id}`,\n );\n } else {\n const { handler, type } = typeAndHandler;\n void handler(\n request.params as never,\n (value) => {\n _success(type, true, request.id, request.method, value);\n },\n (reason) => {\n _error(true, request.id, request.method, reason);\n },\n {\n ...context,\n suppressLogging: () => {\n loggingSuppressed = true;\n },\n },\n );\n }\n } else {\n const typeAndHandler =\n requestHandlers[request.method] ?? _protocolRequestHandlers[request.method as never];\n\n if (typeAndHandler) {\n const { handler, type } = typeAndHandler;\n void handler(\n request.params as never,\n (value) => {\n _success(\n type,\n request.method in _protocolRequestHandlers,\n request.id,\n request.method,\n value,\n );\n },\n (reason) => {\n _error(\n request.method in _protocolRequestHandlers,\n request.id,\n request.method,\n reason,\n );\n },\n {\n ...context,\n suppressLogging: () => {\n loggingSuppressed = true;\n },\n },\n );\n }\n }\n\n if (logging === \"debug\" && !loggingSuppressed) {\n const typeAndHandler =\n requestHandlers[request.method] ?? _protocolRequestHandlers[request.method as never];\n const type = typeAndHandler.type ?? \"unknown\";\n const color =\n type === \"query\" ? \"#49cc90\"\n : type === \"mutation\" ? \"purple\"\n : \"gray\";\n logger.block.overwrite({ color }).debug(\n `<< [${request.id}] ${\n request.method in _protocolRequestHandlers ? \"[Protocol] \"\n : requestHandlers[payload.method] ? \"\"\n : \"[Ignored] \"\n }${request.method} Request`,\n ...(request.params !== undefined ? [request.params] : []),\n );\n }\n } else if (isNotificationMessage(payload)) {\n let loggingSuppressed = false;\n\n void (\n notificationHandlers[payload.method] ??\n _protocolNotificationHandlers[payload.method as never]\n )?.(payload.params as never, {\n ...context,\n suppressLogging: () => {\n loggingSuppressed = true;\n },\n });\n\n if (logging === \"debug\" && !loggingSuppressed)\n logger.block\n .overwrite({ color: \"lightgray\" })\n .debug(\n `<< ${notificationHandlers[payload.method] ? \"\" : \"[Ignored] \"}${\n payload.method\n } Notification`,\n ...(payload.params ? [payload.params] : []),\n );\n } else {\n if (logging) logger.error(`Invalid payload`, payload);\n }\n }\n });\n // End\n\n let requestId = 0;\n let _initialized = false;\n\n const _eventHandlers = new Map void | Promise)[]>();\n\n const result = {\n /**\n * @readonly\n */\n logger,\n\n get initialized() {\n return _initialized;\n },\n\n requestHandlers: requestHandlers as Equals<\n RequestHandlers,\n RefineRequestHandlers, ProtocolRequestHandlers>\n > extends true ?\n Record\n : RefinedRequestHandlers,\n notificationHandlers: notificationHandlers as Equals<\n NotificationHandlers,\n RefineNotificationHandlers<\n ReadonlyRecord,\n ProtocolNotificationHandlers\n >\n > extends true ?\n Record\n : RefinedNotificationHandlers,\n protocolRequestHandlers: _protocolRequestHandlers,\n protocolNotificationHandlers: _protocolNotificationHandlers,\n\n /**\n * @readonly\n */\n request: Object.assign(\n /**\n * Send a request to LSP server.\n * @param type The type of the request.\n * @param method The method of the request.\n * @param params The parameters of the request.\n * @returns\n */\n (\n type: \"query\" | \"mutation\",\n method: string,\n params?: LSPArray | LSPObject,\n ): ResponsePromise => {\n const request = {\n jsonrpc: JSONRPC_VERSION,\n id: ++requestId,\n method,\n ...(params && { params }),\n } satisfies RequestMessage;\n _send(request);\n\n // Log to console\n if (logging === \"debug\") {\n const color = type === \"query\" ? \"#49cc90\" : \"purple\";\n logger.block\n .overwrite({ color })\n .debug(\n `>> [${requestId}] Request ${method}`,\n ...(params !== undefined ? [params] : []),\n );\n }\n\n const result = Object.assign(\n new Promise((resolve, reject) => {\n resolveMap.set(requestId, [\n type,\n method,\n (value) => {\n result.status = \"fulfilled\";\n resolve(value as never);\n },\n ]);\n rejectMap.set(requestId, [\n type,\n method,\n (reason) => {\n result.status = \"rejected\";\n reject(toJSError(reason));\n },\n ]);\n }),\n {\n status: \"pending\" as \"pending\" | \"fulfilled\" | \"cancelled\" | \"rejected\",\n id: requestId,\n cancel: () => {\n if (result.status !== \"pending\") {\n if (logging)\n logger.error(\n `Unable to cancel request with id ${requestId} because it is already ${result.status}`,\n );\n\n throw new Error(\n `Unable to cancel request with id ${requestId} because it is already ${result.status}`,\n );\n }\n\n _notify(\"$/cancelRequest\", { id: requestId } satisfies CancelParams);\n result.status = \"cancelled\";\n resolveMap.set(requestId, [type, method, () => {}]);\n rejectMap.set(requestId, [type, method, () => {}]);\n },\n } satisfies _BaseResponsePromise,\n );\n\n return result;\n },\n /**\n * Request methods.\n * @readonly\n */\n {\n /**\n * The initialize request is sent as the first request from the client to the server. If the\n * server receives a request or notification before the `initialize` request it should act\n * as follows:\n *\n * - For a request the response should be an error with code: -32002. The message can be\n * picked by the server.\n * - Notifications should be dropped, except for the exit notification. This will allow the\n * exit of a server without an initialize request.\n *\n * Until the server has responded to the `initialize` request with an `InitializeResult`,\n * the client must not send any additional requests or notifications to the server. In\n * addition the server is not allowed to send any requests or notifications to the client\n * until it has responded with an `InitializeResult`, with the exception that during the\n * `initialize` request the server is allowed to send the notifications\n * `window/showMessage`, `window/logMessage` and `telemetry/event` as well as the\n * `window/showMessageRequest` request to the client. In case the client sets up a progress\n * token in the initialize params (e.g. property `workDoneToken`) the server is also allowed\n * to use that token (and only that token) using the `$/progress` notification sent from the\n * server to the client.\n *\n * The `initialize` request may only be sent once.\n * @returns\n */\n initialize: (params: InitializeParams): ResponsePromise => {\n const promise = _mutate(\n \"initialize\",\n params as unknown as LSPObject,\n ) as unknown as ResponsePromise;\n void promise.then(() => {\n _initialized = true;\n _eventHandlers.get(\"initialized\")?.forEach((handler) => void handler());\n });\n return promise;\n },\n /**\n * The shutdown request is sent from the client to the server. It asks the server to shut\n * down, but to not exit (otherwise the response might not be delivered correctly to the\n * client). There is a separate exit notification that asks the server to exit. Clients must\n * not send any notifications other than `exit` or requests to a server to which they have\n * sent a shutdown request. Clients should also wait with sending the exit notification\n * until they have received a response from the `shutdown` request.\n *\n * If a server receives requests after a shutdown request those requests should error with\n * `InvalidRequest`.\n * @returns\n */\n shutdown: (): ResponsePromise => _mutate(\"shutdown\"),\n } as const,\n ),\n /**\n * Send a query request to LSP server.\n * @param method The method of the request.\n * @param params The parameters of the request.\n * @returns\n */\n query: (\n method: string,\n params?: LSPArray | LSPObject,\n ): ResponsePromise => _request(\"query\", method, params),\n /**\n * Send a mutation request to LSP server.\n * @param method The method of the request.\n * @param payload The payload of the request.\n * @returns\n */\n mutate: (\n method: string,\n payload?: LSPArray | LSPObject,\n ): ResponsePromise => _request(\"mutation\", method, payload),\n\n /**\n * Send a notification to LSP server.\n * @param method The method of the notification.\n * @param params The parameters of the notification.\n */\n notify: (method: string, params?: LSPArray | LSPObject) => {\n const notification = {\n jsonrpc: JSONRPC_VERSION,\n method,\n ...(params && { params }),\n } satisfies NotificationMessage;\n _send(notification);\n\n // Log to console\n if (logging === \"debug\")\n logger.block\n .overwrite({ color: \"lightgray\" })\n .debug(`>> Notification ${method}`, ...(params ? [params] : []));\n },\n\n /**\n * Notification methods.\n * @readonly\n */\n notification: {\n /**\n * The initialized notification is sent from the client to the server after the client\n * received the result of the `initialize` request but before the client is sending any\n * other request or notification to the server. The server can use the `initialized`\n * notification for example to dynamically register capabilities.\n *\n * The `initialized` notification may only be sent once.\n */\n initialized: () => {\n _notify(\"initialized\", {});\n },\n /**\n * A notification that should be used by the client to modify the trace setting of the server.\n */\n setTrace: (params: SetTraceParams) => {\n _notify(\"$/setTrace\", params as unknown as LSPObject);\n },\n /**\n * A notification to ask the server to exit its process. The server should exit with `success`\n * code 0 if the shutdown request has been received before; otherwise with `error` code 1.\n */\n exit: () => {\n _notify(\"exit\");\n },\n\n /**\n * Text document notifications.\n */\n textDocument: {\n /**\n * The document open notification is sent from the client to the server to signal newly opened\n * text documents. The document’s content is now managed by the client and the server must not\n * try to read the document’s content using the document’s Uri. Open in this sense means it is\n * managed by the client. It doesn’t necessarily mean that its content is presented in an\n * editor. An open notification must not be sent more than once without a corresponding close\n * notification send before. This means open and close notification must be balanced and the\n * max open count for a particular textDocument is one. Note that a server’s ability to\n * fulfill requests is independent of whether a text document is open or closed.\n *\n * The `DidOpenTextDocumentParams` contain the language id the document is associated with. If\n * the language id of a document changes, the client needs to send a `textDocument/didClose`\n * to the server followed by a `textDocument/didOpen` with the new language id if the server\n * handles the new language id as well.\n */\n didOpen: (params: DidOpenTextDocumentParams) => {\n _notify(\"textDocument/didOpen\", params as unknown as LSPObject);\n },\n /**\n * The document change notification is sent from the client to the server to signal changes to\n * a text document. Before a client can change a text document it must claim ownership of its\n * content using the `textDocument/didOpen` notification. In 2.0 the shape of the params has\n * changed to include proper version numbers.\n */\n didChange: (params: DidChangeTextDocumentParams) => {\n _notify(\"textDocument/didChange\", params as unknown as LSPObject);\n },\n /**\n * The document close notification is sent from the client to the server when the document\n * got closed in the client. The document’s master now exists where the document’s Uri\n * points to (e.g. if the document’s Uri is a file Uri the master now exists on disk). As\n * with the open notification the close notification is about managing the document’s\n * content. Receiving a close notification doesn’t mean that the document was open in an\n * editor before. A close notification requires a previous open notification to be sent.\n * Note that a server’s ability to fulfill requests is independent of whether a text\n * document is open or closed.\n */\n didClose: (params: DidCloseTextDocumentParams) => {\n _notify(\"textDocument/didClose\", params as unknown as LSPObject);\n },\n } as const,\n\n /**\n * Workspace notifications.\n * @readonly\n */\n workspace: {\n /**\n * The `workspace/didChangeWorkspaceFolders` notification is sent from the client to the\n * server to inform the server about workspace folder configuration changes. A server can\n * register for this notification by using either the *server capability*\n * `workspace.workspaceFolders.changeNotifications` or by using the dynamic capability\n * registration mechanism. To dynamically register for the\n * `workspace/didChangeWorkspaceFolders` send a `client/registerCapability` request from\n * the server to the client. The registration parameter must have a `registrations` item of\n * the following form, where id is a unique `id` used to unregister the capability (the\n * example uses a UUID).\n */\n didChangeWorkspaceFolders: (params: DidChangeWorkspaceFoldersParams) => {\n _notify(\"workspace/didChangeWorkspaceFolders\", params as unknown as LSPObject);\n },\n } as const,\n } as const,\n\n _eventHandlers,\n\n /**\n * Add event handler.\n * @readonly\n */\n on: ((event, handler): void => {\n const handlers = _eventHandlers.get(event) ?? [];\n handlers.push(handler as never);\n _eventHandlers.set(event, handlers);\n }) as (event: E, handler: ClientEventHandler) => void,\n /**\n * Remove event handler.\n * @readonly\n */\n off: ((event, handler): void => {\n const handlers = _eventHandlers.get(event) ?? [];\n const index = handlers.indexOf(handler as never);\n if (index !== -1) handlers.splice(index, 1);\n _eventHandlers.set(event, handlers);\n }) as (event: E, handler: ClientEventHandler) => void,\n };\n\n const _request = result.request;\n // @ts-expect-error - Planned to use in the future\n const _query = result.query;\n const _mutate = result.mutate;\n const _notify = result.notify;\n\n return result;\n};\n" }, { "path": "src/client/index.ts", "content": "export * from \"./client\";\n" }, { "path": "src/completion.ts", "content": "import * as path from \"@modules/path\";\n\nimport type { Completion, CompletionResult, CopilotClient } from \"./client\";\nimport type { ResponsePromise } from \"./client/general-client\";\nimport { logger } from \"./logging\";\nimport type { Position } from \"./types/lsp\";\nimport { Observable } from \"./utils/observable\";\n\n/**\n * Options for {@link CompletionTaskManager}.\n */\nexport interface CompletionTaskManagerOptions {\n workspaceFolder: string;\n activeFilePathname: string;\n}\n\n/**\n * A manager for GitHub Copilot completion tasks that makes sure exactly one completion task is\n * active at a time.\n */\nexport default class CompletionTaskManager {\n public workspaceFolder: string;\n public activeFilePathname: string;\n\n private _state: \"idle\" | \"requesting\" | \"pending\" = \"idle\";\n\n private activeRequest:\n | (ResponsePromise & { cleanup?: Observable<\"accepted\" | \"rejected\"> })\n | null = null;\n\n constructor(\n private copilot: CopilotClient,\n options: CompletionTaskManagerOptions,\n ) {\n this.workspaceFolder = options.workspaceFolder;\n this.activeFilePathname = options.activeFilePathname;\n }\n\n get state(): \"idle\" | \"requesting\" | \"pending\" {\n return this._state;\n }\n\n rejectCurrentIfExist(): void {\n if (this.activeRequest) {\n if (this.activeRequest.status === \"pending\") this.activeRequest.cancel();\n this.activeRequest.cleanup?.next(\"rejected\");\n this.activeRequest = null;\n }\n this._state = \"idle\";\n if (this.copilot.status === \"InProgress\") this.copilot.status = \"Normal\";\n }\n\n start(\n position: Position,\n {\n onCompletion,\n }: {\n /**\n * Callback invoked when a task completion is received.\n *\n * This can optionally return an {@linkcode Observable} representing a cleanup action.\n * The observable will be:\n * - Subscribed to initially for internal cleanup.\n * - Triggered later by the class itself when a new task starts, or by external triggers\n * (e.g., the user manually invoking `.next()` for cleanup).\n */\n onCompletion?: (completion: Completion) => Observable<\"accepted\" | \"rejected\"> | void;\n },\n ): void {\n if (this.activeRequest) {\n if (this.activeRequest.status === \"pending\") this.activeRequest.cancel();\n this.activeRequest.cleanup?.next(\"rejected\");\n }\n\n this._state = \"requesting\";\n\n const request = this.copilot.request.getCompletions({\n position,\n languageId: \"markdown\",\n path: this.activeFilePathname,\n relativePath:\n this.workspaceFolder ?\n path.relative(this.workspaceFolder, this.activeFilePathname)\n : this.activeFilePathname,\n });\n this.activeRequest = request;\n\n request\n .then(({ cancellationReason, completions }): void => {\n if (this.activeRequest !== request) {\n // The request has been cancelled or a new task has started since this task was started,\n // so we should ignore this task's completion\n return;\n }\n\n if (cancellationReason || completions.length === 0) {\n if (this.copilot.status === \"InProgress\") this.copilot.status = \"Normal\";\n this._state = \"idle\";\n return;\n }\n\n this._state = \"pending\";\n\n const completion = completions[0]!;\n\n const cleanup = onCompletion?.(completion) ?? new Observable<\"accepted\" | \"rejected\">();\n cleanup.subscribeOnce((acceptedOrRejected) => {\n if (acceptedOrRejected === \"accepted\") {\n this.copilot.notification.notifyAccepted({ uuid: completion.uuid });\n logger.debug(\"Accepted completion\");\n } else {\n this.copilot.notification.notifyRejected({ uuids: [completion.uuid] });\n logger.debug(\"Rejected completion\", completion.uuid);\n }\n this._state = \"idle\";\n if (this.activeRequest === request) this.activeRequest = null;\n });\n this.activeRequest.cleanup = cleanup;\n })\n .catch(() => {\n if (this.activeRequest !== request) {\n // The request has been cancelled or a new task has started since this task was started,\n // so we should ignore this task's completion\n return;\n }\n\n this._state = \"idle\";\n this.activeRequest = null;\n });\n }\n}\n" }, { "path": "src/components/ChatPanel.scss", "content": "#copilot-chat-container {\n overflow: hidden;\n}\n\n.chat-panel-resize-handle {\n position: absolute;\n left: 0;\n top: 0;\n bottom: 0;\n width: 1.5px;\n cursor: col-resize;\n background-color: transparent;\n transition: background-color 0.2s;\n z-index: 10;\n\n &:hover,\n &.resizing {\n background-color: var(--primary-color, rgba(64, 120, 192, 30%));\n }\n}\n\n// Empty state welcome screen\n.empty-state-welcome {\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: center;\n padding: 30px;\n text-align: center;\n height: 100%;\n margin: 0 auto;\n\n .welcome-icon {\n margin-bottom: 10px;\n }\n\n .welcome-title {\n font-size: 1.5em;\n margin-top: 0;\n margin-bottom: 12px;\n font-weight: 500;\n color: var(--text-color);\n }\n\n .welcome-subtitle {\n color: var(--text-color-lighter, rgba(0, 0, 0, 60%));\n font-size: 0.8em;\n line-height: 1.5;\n }\n}\n\n// Main panel container\n.copilot-chat-panel {\n display: flex;\n flex-direction: column;\n height: 100%;\n background-color: var(--bg-color);\n color: var(--text-color);\n border-left: 1px solid var(--border-color);\n}\n\n// Header section\n.chat-panel-header {\n display: flex;\n justify-content: space-between;\n align-items: center;\n padding: 10px 16px;\n border-bottom: 1px solid var(--border-color);\n\n h3 {\n margin: 0;\n font-size: 16px;\n }\n\n .chat-panel-close-btn {\n background: none;\n border: none;\n font-size: 24px !important;\n cursor: pointer;\n color: var(--text-color);\n opacity: 0.6;\n\n &:hover {\n opacity: 1;\n }\n }\n}\n\n// Input area container\n.chat-panel-input-container {\n border-top: 1px solid var(--border-color);\n padding: 12px;\n}\n\n// Textarea wrapper with integrated controls\n.chat-input-wrapper {\n position: relative;\n display: flex;\n flex-direction: column;\n\n textarea {\n width: 100%;\n padding: 10px;\n padding-bottom: 40px; // Space for buttons\n border: 1px solid var(--border-color, #ccc);\n border-radius: 6px;\n background-color: var(--bg-color);\n color: var(--text-color);\n resize: none;\n font-size: 14px;\n line-height: 1.5;\n // stylelint-disable-next-line declaration-property-value-keyword-no-deprecated\n word-break: break-word;\n white-space: pre-wrap;\n overflow-y: hidden;\n\n &:focus {\n outline: none; // Remove default outline\n border-color: var(--primary-color, #4078c0); // Change border color when focused\n box-shadow: 0 0 0 1px var(--primary-color, #4078c0); // Subtle glow\n }\n }\n}\n\n// Controls container positioned at bottom of textarea\n.chat-input-controls {\n position: absolute;\n bottom: 8px;\n left: 6px;\n right: 6px;\n display: flex;\n justify-content: space-between;\n align-items: center;\n height: 24px;\n}\n\n// Dropdown styling\n.chat-panel-dropdown {\n position: relative;\n\n .chat-panel-dropdown-toggle {\n background: none;\n border: none;\n padding: 2px 6px;\n display: flex;\n align-items: center;\n cursor: pointer;\n color: var(--text-color);\n opacity: 0.8;\n font-size: 12px !important;\n font-weight: normal !important;\n\n &:hover {\n opacity: 1;\n background-color: rgba(0, 0, 0, 5%);\n border-radius: 3px;\n }\n\n .dropdown-chevron {\n margin-left: 4px;\n height: 5px;\n width: 8px;\n opacity: 0.7;\n }\n }\n\n .chat-panel-dropdown-menu {\n position: absolute;\n padding: 5px;\n bottom: 34px;\n left: 0;\n min-width: 120px;\n background-color: var(--bg-color);\n border: 1px solid var(--border-color);\n border-radius: 4px;\n box-shadow: 0 2px 8px rgba(0, 0, 0, 15%);\n z-index: 1000;\n display: flex;\n flex-direction: column;\n\n .chat-panel-dropdown-item {\n text-align: left;\n background: none;\n border: none;\n cursor: pointer;\n color: var(--text-color);\n font-size: 12px !important;\n font-weight: normal !important;\n\n &:hover {\n background-color: var(--item-hover-bg-color, rgba(0, 0, 0, 5%));\n }\n }\n }\n}\n\n.chat-title-dropdown {\n position: relative;\n flex: 1;\n\n .chat-title-dropdown-toggle {\n background: none;\n border: none;\n padding: 4px 8px;\n display: flex;\n align-items: center;\n color: var(--text-color);\n cursor: pointer;\n width: auto;\n text-align: left;\n border-radius: 4px;\n\n &:hover {\n background-color: rgba(0, 0, 0, 5%);\n }\n\n h3 {\n margin: 0;\n flex: 1;\n font-size: 13px;\n white-space: nowrap;\n overflow: hidden;\n text-overflow: ellipsis;\n cursor: pointer;\n }\n\n .dropdown-chevron {\n margin-left: 8px;\n opacity: 0.7;\n }\n\n &:hover .dropdown-chevron {\n opacity: 1;\n }\n }\n\n .session-menu {\n position: absolute;\n top: 100%;\n left: 0;\n width: 100%;\n max-height: 300px;\n overflow-y: auto;\n background-color: var(--bg-color);\n border: 1px solid var(--border-color);\n border-radius: 4px;\n box-shadow: 0 2px 8px rgba(0, 0, 0, 10%);\n z-index: 1000;\n margin-top: 4px;\n padding: 6px;\n\n /* stylelint-disable-next-line no-descending-specificity */\n .chat-panel-dropdown-item {\n display: flex;\n align-items: center;\n justify-content: space-between;\n padding: 4px 8px;\n cursor: pointer;\n width: 100%;\n text-align: left;\n background: none;\n border: none;\n font-size: 12px !important;\n font-weight: normal !important;\n color: var(--text-color);\n min-height: 26px;\n border-radius: 3px;\n\n &:hover {\n background-color: rgba(0, 0, 0, 5%);\n }\n\n .edit-btn,\n .delete-btn {\n opacity: 0.4;\n width: 16px;\n height: 16px;\n padding: 0;\n display: flex;\n align-items: center;\n justify-content: center;\n background: none;\n border: none;\n color: var(--text-color);\n cursor: pointer;\n margin-left: 8px;\n\n &:hover {\n color: #e53935;\n }\n }\n\n &:hover .edit-btn,\n &:hover .delete-btn {\n opacity: 0.7;\n }\n }\n\n .new-session {\n display: flex;\n align-items: center;\n justify-content: unset;\n font-weight: 500;\n border-bottom: 1px solid var(--border-color);\n padding-bottom: 6px;\n margin-bottom: 4px;\n\n svg {\n width: 12px;\n height: 12px;\n margin-right: 8px;\n }\n }\n\n .active {\n background-color: rgba(0, 0, 0, 5%);\n font-weight: 500;\n }\n }\n}\n\n// Send button\n.chat-panel-send-btn {\n padding: 2px 10px;\n background-color: var(--primary-color, #4078c0);\n color: white;\n border: none;\n border-radius: 3px;\n cursor: pointer;\n font-size: 12px !important;\n\n &:disabled {\n background-color: #ccc;\n cursor: default;\n opacity: 0.6;\n }\n\n &:hover:not(:disabled) {\n opacity: 0.9;\n }\n\n &.sending {\n background-color: #e74c3c;\n\n &:hover:not(:disabled) {\n background-color: #c0392b;\n }\n }\n}\n\n.chat-panel-messages {\n flex: 1;\n padding: 16px;\n overflow-y: auto;\n display: flex;\n flex-direction: column;\n gap: 16px;\n}\n\n.chat-message-row {\n display: flex;\n flex-direction: column;\n max-width: 100%;\n animation: fade-in 0.3s ease;\n\n .message-header {\n display: flex;\n align-items: center;\n margin-bottom: 12px;\n\n .message-icon {\n width: 26px;\n height: 26px;\n border-radius: 50%;\n border: 1px solid rgba(0, 0, 0, 5%);\n display: flex;\n align-items: center;\n justify-content: center;\n margin-right: 8px;\n\n svg {\n width: 16px;\n height: 16px;\n }\n\n &.user-icon {\n svg {\n transform: scale(1.1);\n }\n }\n }\n\n .user-icon {\n color: var(--text-color);\n }\n\n .copilot-icon {\n background-color: rgba(0, 0, 0, 3%);\n padding: 4px;\n }\n\n .message-author {\n font-size: 13px;\n font-weight: bold;\n color: var(--text-color);\n }\n }\n\n .message-content {\n font-family: var(--font-family);\n font-size: 13px;\n line-height: 1.5;\n overflow-wrap: break-word;\n margin: 0;\n border-radius: 6px;\n background: transparent;\n\n // Remove default pre tag styles\n border: none;\n overflow: visible;\n }\n\n pre.message-content {\n white-space: pre-wrap;\n }\n}\n\n.markdown-content {\n /* Reset header font sizes */\n h1 {\n font-size: 1.36em;\n margin-top: 0.7em;\n margin-bottom: 0.5em;\n }\n\n h2 {\n font-size: 1.25em;\n margin-top: 0.6em;\n margin-bottom: 0.4em;\n }\n\n /* stylelint-disable-next-line no-descending-specificity */\n h3 {\n font-size: 1.17em;\n margin-top: 0.5em;\n margin-bottom: 0.4em;\n }\n\n h4 {\n font-size: 1em;\n margin-top: 0.4em;\n margin-bottom: 0.3em;\n }\n\n h5 {\n font-size: 0.83em;\n margin-top: 0.4em;\n margin-bottom: 0.2em;\n }\n\n h6 {\n font-size: 0.67em;\n margin-top: 0.4em;\n margin-bottom: 0.2em;\n }\n\n h1,\n h2,\n /* stylelint-disable-next-line no-descending-specificity */\n h3,\n h4,\n h5,\n h6 {\n font-weight: 500;\n }\n\n /* Reset font size for code */\n code {\n font-size: 0.9em;\n }\n\n /* Prettify code block */\n pre {\n background-color: rgba(0, 0, 0, 3%);\n border: 1px solid rgba(0, 0, 0, 8%);\n border-radius: 5px;\n margin: 12px 0;\n overflow-x: auto;\n position: relative;\n\n .copy-code-button {\n position: absolute;\n top: 6px;\n right: 6px;\n width: 28px;\n height: 28px;\n padding: 6px;\n background-color: rgba(0, 0, 0, 10%);\n border: none;\n border-radius: 4px;\n cursor: pointer;\n opacity: 0;\n transition:\n opacity 0.2s ease,\n background-color 0.2s ease;\n display: flex;\n align-items: center;\n justify-content: center;\n z-index: 2;\n\n &:hover {\n opacity: 0.9 !important;\n background-color: rgba(0, 0, 0, 15%);\n }\n\n &:active {\n background-color: rgba(0, 0, 0, 20%);\n }\n }\n\n &:hover .copy-code-button {\n opacity: 0.7;\n }\n\n code {\n background-color: transparent;\n padding: 0;\n border: none;\n font-family: inherit;\n color: var(--text-color-code, var(--text-color));\n }\n }\n\n /* Reduce margins for paragraphs with a pre code block after */\n p:has(+ pre code) {\n margin-bottom: 0;\n }\n\n /* Remove margins for first and last paragraphs */\n p {\n &:first-child {\n margin-top: 0;\n }\n\n &:last-child {\n margin-bottom: 0;\n }\n }\n}\n\n.typing-indicator {\n display: flex;\n align-items: center;\n height: 24px;\n\n span {\n width: 6px;\n height: 6px;\n margin: 0 2px;\n background-color: var(--text-color);\n border-radius: 50%;\n opacity: 0.5;\n animation: typing 1s infinite ease-in-out;\n\n &:nth-child(1) {\n animation-delay: 0s;\n }\n\n &:nth-child(2) {\n animation-delay: 0.2s;\n }\n\n &:nth-child(3) {\n animation-delay: 0.4s;\n }\n }\n}\n\n@keyframes typing {\n 0%,\n 60%,\n 100% {\n transform: translateY(0);\n opacity: 0.5;\n }\n\n 30% {\n transform: translateY(-3px);\n opacity: 1;\n }\n}\n\n@keyframes fade-in {\n from {\n opacity: 0;\n transform: translateY(10px);\n }\n\n to {\n opacity: 1;\n transform: translateY(0);\n }\n}\n" }, { "path": "src/components/ChatPanel.tsx", "content": "import type { Signal } from \"@preact/signals\";\nimport { useSignal, useSignalEffect } from \"@preact/signals\";\nimport { getLuminance } from \"color2k\";\nimport hljs from \"highlight.js\";\nimport { marked } from \"marked\";\nimport { markedHighlight } from \"marked-highlight\";\nimport { render } from \"preact\";\nimport { useCallback, useEffect, useRef } from \"preact/hooks\";\n\nimport type { ChatModel } from \"@/client/chat\";\nimport {\n COPILOT_ACADEMIC_INSTRUCTIONS,\n COPILOT_CATGIRL_INSTRUCTIONS,\n COPILOT_CREATIVE_INSTRUCTIONS,\n COPILOT_MARKDOWN_INSTRUCTIONS,\n ChatSession,\n listCopilotChatModels,\n} from \"@/client/chat\";\nimport { t } from \"@/i18n\";\n\nimport CopilotIcon from \"./CopilotIcon\";\n\nimport \"./ChatPanel.scss\";\n\ninterface ChatPanelProps {\n onClose: () => void;\n}\n\ntype PromptType = \"Normal\" | \"Academic\" | \"Creative\" | \"CatGirl\";\n\nconst ChatPanel: FC = ({ onClose }) => {\n const input = useSignal(\"\");\n const promptType = useSignal(\"Normal\");\n const isThinking = useSignal(false);\n const isSending = useSignal(false);\n const messages = useSignal([]);\n const sessionJustSwitchedFlag = useSignal(false);\n\n const modelId = useSignal(\"gpt-4o\");\n const models = useSignal([]);\n\n const currentSessionId = useSignal(\"\");\n const sessions = useSignal([]);\n\n const getPrompt = useCallback(() => {\n if (promptType.value === \"Normal\") return COPILOT_MARKDOWN_INSTRUCTIONS;\n if (promptType.value === \"Academic\") return COPILOT_ACADEMIC_INSTRUCTIONS;\n if (promptType.value === \"Creative\") return COPILOT_CREATIVE_INSTRUCTIONS;\n return COPILOT_CATGIRL_INSTRUCTIONS.replace(\n \"{{CATGIRL_NAME}}\",\n t.test(\"chat.prompt-style.cat-girl-name\") ? t(\"chat.prompt-style.cat-girl-name\") : \"Vanilla\",\n );\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, []);\n\n const getPromptType = useCallback((prompt: string) => {\n if (prompt === COPILOT_MARKDOWN_INSTRUCTIONS) return \"Normal\";\n if (prompt === COPILOT_ACADEMIC_INSTRUCTIONS) return \"Academic\";\n if (prompt === COPILOT_CREATIVE_INSTRUCTIONS) return \"Creative\";\n if (\n prompt ===\n COPILOT_CATGIRL_INSTRUCTIONS.replace(\n \"{{CATGIRL_NAME}}\",\n t.test(\"chat.prompt-style.cat-girl-name\") ?\n t(\"chat.prompt-style.cat-girl-name\")\n : \"Vanilla\",\n )\n )\n return \"CatGirl\";\n return \"Normal\";\n }, []);\n\n // Watch modelId changes and update session meta\n useEffect(() => {\n const currentSession = sessions.value.find((session) => session.id === currentSessionId.value);\n if (!currentSession) return;\n\n if (currentSession.modelId === modelId.value) return;\n\n currentSession.modelId = modelId.value;\n void ChatSession.save(currentSession.id);\n sessions.value = ChatSession.getAll();\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [modelId.value, currentSessionId.value]);\n\n // Watch prompt type changes and update the system prompt\n useEffect(() => {\n const currentSession = sessions.value.find((session) => session.id === currentSessionId.value);\n if (!currentSession) return;\n\n if (currentSession.messages[0]!.content === getPrompt()) return;\n\n currentSession.messages[0]!.content = getPrompt();\n void ChatSession.save(currentSession.id);\n sessions.value = ChatSession.getAll();\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [promptType.value, currentSessionId.value, getPrompt]);\n\n // Load models and sessions on mount\n useEffect(() => {\n // Load models\n void listCopilotChatModels().then((modelList) => {\n models.value = modelList;\n });\n\n // Load sessions\n const loadSessions = async () => {\n await ChatSession.loadAll();\n\n const allSessions = ChatSession.getAll();\n sessions.value = allSessions;\n\n // Select the first session if available, otherwise create a new one\n if (allSessions.length > 0) {\n currentSessionId.value = allSessions[0]!.id;\n\n modelId.value = allSessions[0]!.modelId;\n promptType.value = getPromptType(allSessions[0]!.messages[0]!.content);\n\n messages.value = allSessions[0]!.messages\n .filter((msg) => msg.role !== \"system\")\n .map((msg) => ({\n role: msg.role as \"user\" | \"assistant\",\n content: msg.content,\n }));\n sessionJustSwitchedFlag.value = !sessionJustSwitchedFlag.value;\n } else {\n createNewSession();\n }\n };\n\n void loadSessions();\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, []);\n\n const createNewSession = useCallback(() => {\n const session = ChatSession.create(modelId.value, getPrompt());\n currentSessionId.value = session.id;\n\n sessions.value = ChatSession.getAll();\n\n messages.value = [];\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, []);\n\n const switchSession = useCallback((id: string) => {\n const session = ChatSession.get(id);\n if (!session) return;\n\n currentSessionId.value = session.id;\n\n modelId.value = session.modelId;\n promptType.value = getPromptType(session.messages[0]!.content);\n\n messages.value = session.messages\n .filter((msg) => msg.role !== \"system\")\n .map((msg) => ({\n role: msg.role as \"user\" | \"assistant\",\n content: msg.content,\n }));\n sessionJustSwitchedFlag.value = !sessionJustSwitchedFlag.value;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, []);\n\n const handleEditChatTitle = useCallback((id: string, title: string) => {\n const session = ChatSession.get(id);\n if (!session) return;\n\n session.title = title;\n void ChatSession.save(session.id);\n\n sessions.value = ChatSession.getAll();\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, []);\n\n const handleDeleteSession = useCallback(\n (id: string) => {\n void ChatSession.delete(id);\n\n sessions.value = ChatSession.getAll();\n\n // If current session is deleted, switch to the first available session\n if (id === currentSessionId.value) {\n if (sessions.value.length > 0) {\n switchSession(sessions.value[0]!.id);\n } else {\n createNewSession();\n }\n }\n },\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [createNewSession, switchSession],\n );\n\n // Send message handler\n const handleSendMessage = () => {\n const userMessage = input.value.trim();\n if (!userMessage || isSending.value) return;\n\n // Add user message\n messages.value = [\n ...messages.value,\n {\n role: \"user\",\n content: input.value.trim(),\n },\n ];\n\n // Clear input\n input.value = \"\";\n\n // Show typing indicator\n isThinking.value = true;\n isSending.value = true;\n\n abortControllerRef.current = new AbortController();\n sessions.value\n .find((session) => session.id === currentSessionId.value)\n ?.send(\n userMessage,\n (content) => {\n if (isThinking.value) {\n isThinking.value = false;\n messages.value = [\n ...messages.value,\n {\n role: \"assistant\",\n content: \"\",\n },\n ];\n }\n messages.value = [\n ...messages.value.slice(0, messages.value.length - 1),\n {\n role: \"assistant\",\n content: messages.value[messages.value.length - 1]!.content + content,\n },\n ];\n },\n {\n model: models.value.find((model) => model.id === modelId.value),\n signal: abortControllerRef.current.signal,\n },\n )\n .then((fullContent) => {\n messages.value = [\n ...messages.value.slice(0, messages.value.length - 1),\n {\n role: \"assistant\",\n content: fullContent,\n },\n ];\n isSending.value = false;\n void ChatSession.save(currentSessionId.value);\n })\n .catch((error) => {\n console.error(\"Error sending message:\", error);\n isSending.value = false;\n });\n };\n\n const abortControllerRef = useRef(null);\n const handleStopSending = useCallback(() => {\n abortControllerRef.current?.abort();\n }, []);\n\n return (\n
\n \n \n \n
\n );\n};\n\n/**********\n * Header *\n **********/\ninterface ChatHeaderProps {\n onClose: () => void;\n currentSessionId: Signal;\n sessions: Signal;\n onSwitchSession: (id: string) => void;\n onNewSession: () => void;\n onEditChatTitle?: (id: string, title: string) => void;\n onDeleteSession?: (id: string) => void;\n}\n\nconst ChatHeader: FC = ({\n currentSessionId,\n onClose,\n onDeleteSession,\n onEditChatTitle,\n onNewSession,\n onSwitchSession,\n sessions,\n}) => {\n const isDropdownOpen = useSignal(false);\n\n // Handle click outside to close dropdown\n useEffect(() => {\n const handleClickOutside = (event: MouseEvent) => {\n const target = event.target as HTMLElement;\n if (\n isDropdownOpen.value &&\n !target.closest(\".chat-title-dropdown-toggle\") &&\n !target.closest(\".session-menu\")\n ) {\n isDropdownOpen.value = false;\n }\n };\n\n document.addEventListener(\"mousedown\", handleClickOutside);\n return () => {\n document.removeEventListener(\"mousedown\", handleClickOutside);\n };\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, []);\n\n const handleEditChatTitle = (id: string, title: string) => {\n let newTitle = title;\n Files.editor?.EditHelper.showDialog({\n title: t(\"chat.dialog.edit-chat-title.title\"),\n html: t(\"chat.dialog.edit-chat-title.html\").replace(\"{{SESSION_TITLE}}\", title),\n buttons: [t(\"button.ok\"), t(\"button.cancel\")],\n callback: (result) => {\n if (result === 0 && onEditChatTitle) onEditChatTitle(id, newTitle);\n },\n });\n $(\"#new-chat-title\").on(\"input\", (e) => {\n newTitle = (e.target as HTMLInputElement).value;\n });\n };\n\n const handleDeleteSession = (id: string, title: string) => {\n // Show confirmation dialog\n Files.editor?.EditHelper.showDialog({\n title: t(\"chat.dialog.delete-session.title\"),\n html: t(\"chat.dialog.delete-session.html\").replace(\"{{SESSION_TITLE}}\", title),\n buttons: [t(\"button.delete\"), t(\"button.cancel\")],\n callback: (result) => {\n if (result === 0 && onDeleteSession) {\n onDeleteSession(id);\n // Close the dropdown if the current session is deleted\n if (id === currentSessionId.value) isDropdownOpen.value = false;\n }\n },\n });\n };\n\n return (\n
\n
\n (isDropdownOpen.value = !isDropdownOpen.value)}>\n

\n {sessions.value.find((session) => session.id === currentSessionId.value)?.title ||\n t(\"chat.button.new-session\")}\n

\n \n \n \n \n\n {isDropdownOpen.value && (\n
\n {\n onNewSession();\n isDropdownOpen.value = false;\n }}>\n \n \n \n {t(\"chat.button.new-session\")}\n \n\n {sessions.value.map((session) => (\n {\n onSwitchSession(session.id);\n isDropdownOpen.value = false;\n }}>\n \n {session.title || t(\"chat.button.new-session\")}\n \n
\n {\n e.stopPropagation();\n handleEditChatTitle(session.id, session.title);\n }}\n ty-hint={t(\"chat.button.edit-chat-title\")}>\n \n \n \n \n {\n e.stopPropagation();\n handleDeleteSession(session.id, session.title);\n }}\n ty-hint={t(\"chat.button.delete-session\")}>\n \n \n \n \n \n
\n \n ))}\n
\n )}\n
\n\n \n
\n );\n};\n\n/************\n * Messages *\n ************/\ninterface Message {\n role: \"assistant\" | \"user\";\n content: string;\n}\n\ninterface MessageContentProps {\n content: string;\n}\n\nconst md = marked\n .use({\n // Avoid identifying `~` as strikethrough\n // https://github.com/markedjs/marked/issues/1561#issuecomment-846571425\n tokenizer: {\n del: (src) => {\n if (/^~~+(?=\\S)([\\s\\S]*?\\S)~~+/.exec(src)) return false;\n },\n },\n })\n .use(\n markedHighlight({\n emptyLangClass: \"hljs\",\n langPrefix: \"hljs language-\",\n highlight(code, lang) {\n const language = hljs.getLanguage(lang) ? lang : \"plaintext\";\n return hljs.highlight(code, { language }).value;\n },\n }),\n );\n\nconst MessageContent: FC = ({ content }) => {\n const containerRef = useRef(null);\n\n useEffect(() => {\n if (!containerRef.current) return;\n\n containerRef.current.innerHTML = md.parse(content) as string;\n\n // Handle links\n const links = containerRef.current.querySelectorAll(\"a\");\n links.forEach((link) => {\n if (link.getAttribute(\"href\")?.startsWith(\"http\")) {\n link.setAttribute(\"target\", \"_blank\");\n link.setAttribute(\"rel\", \"noopener noreferrer\");\n }\n });\n\n // Add copy button to code blocks\n const codeBlocks = containerRef.current.querySelectorAll(\"pre\");\n codeBlocks.forEach((pre) => {\n const copyButton = document.createElement(\"button\");\n copyButton.className = \"copy-code-button\";\n copyButton.innerHTML = `\n \n \n \n \n `;\n\n copyButton.addEventListener(\"click\", () => {\n const code = pre.textContent || \"\";\n void navigator.clipboard.writeText(code.trim()).then(() => {\n copyButton.innerHTML = `\n \n \n \n `;\n setTimeout(() => {\n copyButton.innerHTML = `\n \n \n \n \n `;\n }, 800);\n });\n });\n\n pre.appendChild(copyButton);\n });\n }, [content]);\n\n return
;\n};\n\nconst EmptyStateWelcome: FC = () => {\n return (\n
\n
\n \n
\n

{t(\"chat.welcome.title\")}

\n

{t(\"chat.welcome.subtitle\")}

\n
\n );\n};\n\ninterface MessageListProps {\n promptType: PromptType;\n messages: Message[];\n isThinking: boolean;\n sessionJustSwitchedFlag: boolean;\n}\n\nconst MessageList: FC = ({\n isThinking,\n messages,\n promptType,\n sessionJustSwitchedFlag,\n}) => {\n const containerRef = useRef(null);\n\n const scrollToBottom = useCallback(() => {\n if (containerRef.current) containerRef.current.scrollTop = containerRef.current.scrollHeight;\n }, []);\n\n useEffect(scrollToBottom, [sessionJustSwitchedFlag, scrollToBottom]);\n\n // Watch for new messages and scroll to bottom if the role is \"user\"\n useEffect(() => {\n if (messages.length > 0 && messages[messages.length - 1]!.role === \"user\") scrollToBottom();\n }, [messages, scrollToBottom]);\n\n return (\n
\n {messages.length === 0 && !isThinking ?\n \n : messages.map((message, index) => (\n
\n {message.role === \"user\" ?\n <>\n
\n
\n \n \n \n \n \n
\n
{t(\"chat.you\")}
\n
\n 
{message.content}
\n \n : <>\n
\n
\n {promptType === \"CatGirl\" ?\n \n 🐱\n \n : \n }\n
\n
\n {promptType === \"CatGirl\" ?\n t(\"chat.prompt-style.cat-girl-name\")\n : \"GitHub Copilot\"}\n
\n
\n \n \n }\n
\n ))\n }\n\n {isThinking && (\n
\n
\n
\n {promptType === \"CatGirl\" ?\n \n 🐱\n \n : }\n
\n
\n {promptType === \"CatGirl\" ? t(\"chat.prompt-style.cat-girl-name\") : \"GitHub Copilot\"}\n
\n
\n
\n \n \n \n
\n
\n )}\n
\n );\n};\n\n/**************\n * Input Area *\n **************/\ninterface DropdownProps {\n label: string;\n tooltip?: string;\n isOpen: Signal;\n options: { value: string; label: string }[];\n onSelect: (value: string) => void;\n closeOtherDropdown: () => void;\n}\n\nconst Dropdown: FC = ({\n closeOtherDropdown,\n isOpen,\n label,\n onSelect,\n options,\n tooltip,\n}) => {\n return (\n
\n {\n closeOtherDropdown();\n isOpen.value = !isOpen.value;\n }}>\n {label}\n \n \n \n \n\n {isOpen.value && (\n
\n {options.map((option) => (\n {\n onSelect(option.value);\n isOpen.value = false;\n }}>\n {option.label}\n \n ))}\n
\n )}\n
\n );\n};\n\ninterface InputAreaProps {\n input: Signal;\n promptType: Signal;\n modelId: Signal;\n models: ChatModel[];\n onSend: () => void;\n isSending: boolean;\n onStop?: () => void;\n}\n\nconst InputArea: FC = ({\n input,\n isSending,\n modelId,\n models,\n onSend,\n onStop,\n promptType,\n}) => {\n const textareaRef = useRef(null);\n const measureRef = useRef(null);\n const rows = useSignal(1);\n const isPromptDropdownOpen = useSignal(false);\n const isModelDropdownOpen = useSignal(false);\n\n // Handle Enter key\n const handleKeyDown = (e: KeyboardEvent) => {\n if (e.key === \"Enter\" && !e.shiftKey) {\n e.preventDefault();\n if (e.ctrlKey) {\n input.value += \"\\n\";\n return;\n }\n onSend();\n }\n };\n\n // Auto-resize textarea\n const updateRows = useCallback(\n (text: string) => {\n if (!measureRef.current) return;\n\n // Replace each empty line with a space so that empty lines are measured properly.\n measureRef.current.textContent =\n text ?\n text\n .split(\"\\n\")\n .map((line) => (line === \"\" ? \" \" : line))\n .join(\"\\n\")\n : \" \";\n\n const totalHeight = measureRef.current.scrollHeight;\n const lineHeight = parseInt(window.getComputedStyle(measureRef.current).lineHeight);\n\n // Clear the content to prevent vertical scrollbar from appearing\n measureRef.current.textContent = \"\";\n\n const actualRows = Math.ceil(totalHeight / lineHeight);\n rows.value = Math.max(1, Math.min(6, actualRows)); // Cap at 6 rows\n },\n [rows],\n );\n\n useSignalEffect(() => {\n updateRows(input.value);\n });\n\n // Handle click outside for dropdowns\n useEffect(() => {\n const handleClickOutside = (event: MouseEvent) => {\n const target = event.target as HTMLElement;\n if (\n !target.closest(\".chat-panel-dropdown-toggle\") &&\n !target.closest(\".chat-panel-dropdown-menu\") &&\n (isPromptDropdownOpen.value || isModelDropdownOpen.value)\n ) {\n isPromptDropdownOpen.value = false;\n isModelDropdownOpen.value = false;\n }\n };\n\n document.addEventListener(\"mousedown\", handleClickOutside);\n return () => {\n document.removeEventListener(\"mousedown\", handleClickOutside);\n };\n }, [isModelDropdownOpen, isPromptDropdownOpen]);\n\n return (\n
\n
\n \n\n (input.value = (e.target as HTMLTextAreaElement).value)}\n onKeyDown={(e) => handleKeyDown(e as unknown as KeyboardEvent)}\n disabled={isSending}\n />\n\n {/* Controls in the bottom toolbar */}\n
\n {/* Prompt type dropdown */}\n (isModelDropdownOpen.value = false)}\n options={[\n { value: \"Normal\", label: t(\"chat.prompt-style.Normal\") },\n { value: \"Academic\", label: t(\"chat.prompt-style.Academic\") },\n { value: \"Creative\", label: t(\"chat.prompt-style.Creative\") },\n { value: \"CatGirl\", label: t(\"chat.prompt-style.CatGirl\") },\n ]}\n onSelect={(value) => {\n promptType.value = value as never;\n }}\n />\n\n {/* Model type dropdown */}\n model.id === modelId.value)?.name || \"\"}\n isOpen={isModelDropdownOpen}\n tooltip={t(\"chat.pick-model.tooltip\")}\n closeOtherDropdown={() => (isPromptDropdownOpen.value = false)}\n options={models.map((model) => ({ value: model.id, label: model.name }))}\n onSelect={(value) => (modelId.value = value)}\n />\n\n {/* Send button */}\n {\n if (isSending) {\n onStop?.();\n return;\n }\n onSend();\n }}>\n {isSending ? t(\"chat.button.stop\") : t(\"chat.button.send\")}\n \n
\n
\n
\n );\n};\n\n// Watch theme change and switch highlight.js theme\nsetInterval(() => {\n const isDark = getLuminance(window.getComputedStyle(document.body).backgroundColor) < 0.5;\n (window as any).setHighlightjsTheme(isDark ? \"dark\" : \"light\");\n}, 1000);\n\nexport let detachChatPanel: (() => void) | null = null;\n\nexport function attachChatPanel(): void {\n // Check if panel already exists (only one instance allowed)\n if (document.querySelector(\"#copilot-chat-container\")) return;\n\n // Get reference to content element\n const contentDiv = document.querySelector(\"content\");\n if (!contentDiv?.parentNode) return; // Can’t attach if content doesn’t exist\n\n // Create container and position it after content\n const container = document.createElement(\"div\");\n container.id = \"copilot-chat-container\";\n container.style.position = \"absolute\";\n container.style.right = \"0\";\n container.style.bottom =\n (document.querySelector(\"#footer-copilot\")?.getBoundingClientRect().height ||\n 0) + \"px\";\n\n if (contentDiv.nextSibling) contentDiv.parentNode.insertBefore(container, contentDiv.nextSibling);\n else contentDiv.parentNode.appendChild(container);\n\n // Get saved width from localStorage or use default\n const savedWidth = localStorage.getItem(\"copilot-chat-panel-width\");\n const defaultWidth = Math.min(\n 400,\n Math.max(280, (window.innerWidth - contentDiv.getBoundingClientRect().left) * 0.25),\n );\n let panelWidth = savedWidth ? parseInt(savedWidth) : defaultWidth;\n\n // Ensure width is within reasonable range\n panelWidth = Math.min(Math.max(panelWidth, 280), window.innerWidth * 0.5);\n\n // Update position and width\n const updatePosition = () => {\n const contentRect = contentDiv.getBoundingClientRect();\n (contentDiv as HTMLElement).style.right = `${panelWidth}px`;\n container.style.top = `${contentRect.top}px`;\n container.style.width = `${panelWidth}px`;\n };\n\n updatePosition();\n\n // Create resize handle element\n const resizeHandle = document.createElement(\"div\");\n resizeHandle.className = \"chat-panel-resize-handle\";\n\n // Handle drag events\n let isResizing = false;\n let startX = 0;\n let startWidth = 0;\n\n const startResize = (e: MouseEvent) => {\n isResizing = true;\n startX = e.clientX;\n startWidth = panelWidth;\n resizeHandle.classList.add(\"resizing\");\n document.addEventListener(\"mousemove\", resize);\n document.addEventListener(\"mouseup\", stopResize);\n document.body.style.userSelect = \"none\"; // Prevent text selection during drag\n };\n\n const resize = (e: MouseEvent) => {\n if (!isResizing) return;\n\n // Calculate new width (note direction: moving mouse left increases width)\n const dx = startX - e.clientX;\n panelWidth = Math.min(Math.max(startWidth + dx, 280), window.innerWidth * 0.5);\n\n // Update position\n updatePosition();\n };\n\n const stopResize = () => {\n isResizing = false;\n resizeHandle.classList.remove(\"resizing\");\n document.removeEventListener(\"mousemove\", resize);\n document.removeEventListener(\"mouseup\", stopResize);\n document.body.style.userSelect = \"\";\n\n // Save width to localStorage\n localStorage.setItem(\"copilot-chat-panel-width\", String(panelWidth));\n };\n\n resizeHandle.addEventListener(\"mousedown\", startResize);\n\n contentDiv.addEventListener(\"resize\", updatePosition);\n window.addEventListener(\"resize\", updatePosition);\n\n localStorage.setItem(\"copilot-chat-panel-open\", \"true\");\n\n const detach = () => {\n (contentDiv as HTMLElement).style.right = \"0\";\n contentDiv.removeEventListener(\"resize\", updatePosition);\n window.removeEventListener(\"resize\", updatePosition);\n localStorage.removeItem(\"copilot-chat-panel-open\");\n render(null, container);\n container.remove();\n };\n\n // Render the panel to the positioned container\n render(, container);\n container.appendChild(resizeHandle); // Add resize handle after rendering\n\n detachChatPanel = detach;\n}\n" }, { "path": "src/components/CopilotIcon.tsx", "content": "import type { CopilotStatus } from \"@/client\";\n\nimport Spinner from \"./Spinner\";\n\nexport interface CopilotIconProps {\n status: CopilotStatus | \"Disabled\";\n textColor: string;\n style?: preact.CSSProperties;\n}\n\n/**\n * Icon of Copilot, change according to status.\n * @returns\n */\nconst CopilotIcon: FC = ({ status, style, textColor }) => {\n return (\n \n {(() => {\n if (status === \"InProgress\") return ;\n if (status === \"Normal\")\n return (\n \n \n \n \n );\n if (status === \"Warning\")\n return (\n \n \n \n \n );\n /* Disabled */\n return (\n \n \n \n );\n })()}\n
\n );\n};\n\nexport default CopilotIcon;\n" }, { "path": "src/components/DropdownWithInput.scss", "content": ".dropdown-with-input > input[type=\"text\"] {\n padding: 0.75rem !important;\n box-sizing: border-box !important;\n border-width: 1px !important;\n border-style: solid !important;\n border-color: #edf2f7 !important; // border-gray-100\n border-radius: 0.375rem !important;\n transition: background-color, border-color, color, fill, stroke, opacity, box-shadow, transform !important;\n transition-duration: 200ms !important;\n outline: none !important;\n}\n\n.dropdown-with-input.passed > input[type=\"text\"] {\n box-shadow: #38a169 0 0 0 1px !important; // border-green-600\n border-color: #68d391 !important; // border-green-400\n}\n\n.dropdown-with-input.failed > input[type=\"text\"] {\n box-shadow: #e53e3e 0 0 0 1px !important; // border-red-600\n border-color: #fc8181 !important; // border-red-400\n}\n\n.dropdown-with-input:not(.passed, .failed).focus > input[type=\"text\"],\n.dropdown-with-input:not(.passed, .failed, .focus) > input[type=\"text\"]:focus {\n box-shadow: #3182ce 0 0 0 1px !important; // border-blue-600\n border-color: #63b3ed !important; // border-blue-400\n}\n\n.dropdown-with-input > ul {\n position: absolute !important;\n top: 100% !important;\n left: 0 !important;\n right: 0 !important;\n padding: 0 !important;\n list-style: none !important;\n border: 1px solid #edf2f7 !important; // border-gray-100\n border-radius: 0.375rem !important;\n box-shadow: 0 4px 8px rgba(0, 0, 0, 10%) !important;\n max-height: 12rem !important;\n overflow-y: auto !important;\n z-index: 1000 !important;\n}\n\n.dropdown-with-input > ul > li {\n cursor: pointer !important;\n font-size: 0.875rem !important;\n transition: background 0.2s !important;\n}\n\n.dropdown-with-input > ul > li:first-child {\n padding: 0.5rem 0.75rem 0.3125rem !important;\n}\n\n.dropdown-with-input > ul > li:last-child {\n padding: 0.3125rem 0.75rem 0.5rem !important;\n}\n\n.dropdown-with-input > ul > li:not(:first-child, :last-child) {\n padding: 0.3125rem 0.75rem !important;\n}\n" }, { "path": "src/components/DropdownWithInput.tsx", "content": "import { darken, getLuminance, lighten } from \"color2k\";\nimport { useRef, useState } from \"preact/hooks\";\n\nimport \"./DropdownWithInput.scss\";\n\nexport interface DropdownWithInputProps {\n options: string[];\n\n value: string;\n onChange: (option: string) => void;\n\n onOpenDropdown?: () => void;\n onCloseDropdown?: () => void;\n\n type?: \"default\" | \"passed\" | \"failed\";\n forceFocus?: boolean;\n placeholder?: string;\n dropdownMarginTop?: string;\n}\n\nconst DropdownWithInput: FC = ({\n dropdownMarginTop = \"0.375rem\",\n forceFocus = false,\n onChange,\n onCloseDropdown,\n onOpenDropdown,\n options,\n placeholder,\n type = \"default\",\n value,\n}) => {\n const backgroundColor = window.getComputedStyle(document.body).backgroundColor;\n\n const [isOpen, setIsOpen] = useState(false);\n const [filteredOptions, setFilteredOptions] = useState(options);\n\n const dropdownRef = useRef(null);\n\n const handleOptionClick = (option: string) => {\n onChange(option); // Set the selected value\n setIsOpen(false); // Close the dropdown\n onCloseDropdown?.();\n };\n\n const handleBlur = (e: preact.TargetedFocusEvent) => {\n if (!dropdownRef.current?.contains(e.relatedTarget as Node)) {\n setIsOpen(false); // Close dropdown on blur\n onCloseDropdown?.();\n }\n };\n\n const handleInputChange = (e: preact.TargetedEvent) => {\n const inputValue = (e.target! as unknown as { value: string }).value;\n onChange(inputValue);\n setFilteredOptions(\n options.filter((option) => option.toLowerCase().includes(inputValue.toLowerCase())),\n ); // Filter options based on input\n setIsOpen(true); // Open dropdown if user is typing\n onOpenDropdown?.();\n };\n\n const handleKeyDown = (e: preact.TargetedKeyboardEvent) => {\n if (e.key === \"Enter\") {\n setIsOpen(false); // Close dropdown when pressing Enter\n onCloseDropdown?.();\n }\n };\n\n return (\n \n {/* Input Field */}\n {\n setIsOpen(true); // Open dropdown when input is focused\n onOpenDropdown?.();\n setFilteredOptions(options); // Reset filtered options on focus\n }}\n />\n\n {/* Dropdown Menu */}\n {isOpen && filteredOptions.length > 0 && (\n \n {filteredOptions.map((option, index) => (\n {\n handleOptionClick(option);\n }}\n onMouseEnter={(e) => {\n e.currentTarget.style.background =\n getLuminance(backgroundColor) > 0.5 ?\n darken(backgroundColor, 0.05)\n : lighten(backgroundColor, 0.05);\n }}\n onMouseLeave={(e) => (e.currentTarget.style.background = \"transparent\")}>\n {option}\n \n ))}\n \n )}\n \n );\n};\n\nexport default DropdownWithInput;\n" }, { "path": "src/components/ModalBody.tsx", "content": "export interface ModalBodyProps {\n className?: string;\n style?: preact.CSSProperties;\n}\n\nconst ModalBody: FC = ({ children, className, style }) => {\n return (\n // eslint-disable-next-line @typescript-eslint/no-misused-spread\n
\n {children}\n
\n );\n};\n\nexport default ModalBody;\n" }, { "path": "src/components/ModalCloseButton.scss", "content": ".modal-close-button {\n font-size: 1.2rem !important;\n opacity: 0.5 !important;\n}\n\n.modal-close-button:hover {\n opacity: 1 !important;\n}\n" }, { "path": "src/components/ModalCloseButton.tsx", "content": "import \"./ModalCloseButton.scss\";\n\nexport interface ModalCloseButtonProps {\n onClick?: () => void;\n}\n\nconst ModalCloseButton: FC = ({ onClick }) => {\n return (\n \n );\n};\n\nexport default ModalCloseButton;\n" }, { "path": "src/components/ModalContent.tsx", "content": "const ModalContent: FC = ({ children }) => {\n return (\n {\n e.stopPropagation();\n }}>\n {children}\n \n );\n};\n\nexport default ModalContent;\n" }, { "path": "src/components/ModalOverlay.scss", "content": ".modal-overlay {\n position: fixed;\n top: 0;\n left: 0;\n width: 100%;\n height: 100%;\n z-index: 99999;\n background: rgba(0, 0, 0, 50%);\n display: flex;\n align-items: center;\n justify-content: center;\n}\n" }, { "path": "src/components/ModalOverlay.tsx", "content": "import { createPortal } from \"preact/compat\";\nimport \"./ModalOverlay.scss\";\n\nexport interface ModalOverlayProps {\n onClose?: () => void;\n}\n\nconst ModalOverlay: FC = ({ children, onClose }) => {\n return createPortal(\n
\n {children}\n
,\n document.body,\n );\n};\n\nexport default ModalOverlay;\n" }, { "path": "src/components/ModalTitle.tsx", "content": "const ModalTitle: FC = ({ children }) => {\n return {children};\n};\n\nexport default ModalTitle;\n" }, { "path": "src/components/ModelHeader.tsx", "content": "const ModalHeader: FC = ({ children }) => {\n return (\n <>\n \n {children}\n \n
\n \n );\n};\n\nexport default ModalHeader;\n" }, { "path": "src/components/SettingsPanel.tsx", "content": "/* eslint-disable react-hooks/rules-of-hooks */\nimport type { Signal } from \"@preact/signals\";\nimport { useSignal } from \"@preact/signals\";\nimport { useMemo } from \"preact/hooks\";\nimport { debounce, mapValues } from \"radash\";\nimport semverGte from \"semver/functions/gte\";\nimport semverValid from \"semver/functions/valid\";\nimport { kebabCase } from \"string-ts\";\n\nimport { t } from \"@/i18n\";\nimport type { Settings } from \"@/settings\";\nimport { settings } from \"@/settings\";\nimport type { _Id } from \"@/types/tools\";\nimport { runCommand } from \"@/utils/cli-tools\";\nimport type { NodeRuntime } from \"@/utils/node-bridge\";\nimport {\n getAllAvailableNodeRuntimes,\n getCurrentNodeRuntime,\n setCurrentNodeRuntime,\n} from \"@/utils/node-bridge\";\nimport { entriesOf, keysOf } from \"@/utils/tools\";\n\nimport DropdownWithInput from \"./DropdownWithInput\";\nimport ModalBody from \"./ModalBody\";\nimport ModalCloseButton from \"./ModalCloseButton\";\nimport ModalContent from \"./ModalContent\";\nimport ModalOverlay from \"./ModalOverlay\";\nimport ModalTitle from \"./ModalTitle\";\nimport ModalHeader from \"./ModelHeader\";\nimport Switch from \"./Switch\";\nimport { NodejsIcon, SettingsIcon } from \"./icons\";\n\ninterface SettingControl {\n position: \"right\" | \"bottom\";\n component: (key: K, signal: Signal) => preact.JSX.Element;\n}\ntype TypedSettingControl = SettingControl<\n keyof { [K in keyof Settings as Settings[K] extends T ? K : never]: void }\n>;\n\nconst BooleanSettingControl: TypedSettingControl = {\n position: \"right\",\n component: (key, signal) => (\n {\n signal.value = value;\n settings[key] = value;\n }}\n />\n ),\n};\n\ntype Categories = Record }>;\nconst categories = {\n general: {\n disableCompletions: BooleanSettingControl,\n useInlineCompletionTextInSource: BooleanSettingControl,\n useInlineCompletionTextInPreviewCodeBlocks: BooleanSettingControl,\n },\n nodejs: {\n nodePath: {\n position: \"bottom\",\n component: (key, signal) => {\n const optionAuto = (() => {\n if (getAllAvailableNodeRuntimes().length === 0) return null;\n const { path, version } =\n getAllAvailableNodeRuntimes().find(({ path }) => path === \"bundled\") ??\n getAllAvailableNodeRuntimes()[0]!;\n return (\n `${t(\"settings-panel.nodejs.constant.PATH_AUTO_DETECT\")} ` +\n `(${path === \"bundled\" ? t(\"settings-panel.nodejs.constant.PATH_BUNDLED\") : path}, ` +\n `${version.startsWith(\"v\") ? version : \"v\" + version})`\n );\n })();\n const options = [\n ...(optionAuto ? [optionAuto] : []),\n ...getAllAvailableNodeRuntimes()\n .filter(({ path }) => path !== \"bundled\")\n .map(\n ({ path, version }) =>\n `${path} (${version.startsWith(\"v\") ? version : \"v\" + version})`,\n ),\n ];\n\n const currentVersion = useSignal(getCurrentNodeRuntime().version);\n\n const inputType = useSignal<\"default\" | \"passed\" | \"failed\">(\n getCurrentNodeRuntime().path === \"not found\" ? \"failed\" : \"default\",\n );\n const forceFocusInput = useSignal(false);\n const info = useSignal(\n getCurrentNodeRuntime().path === \"not found\" ?\n options.length > 0 ?\n t(\"settings-panel.nodejs.node-path.message.warn-empty-select-or-input\")\n : t(\"settings-panel.nodejs.node-path.message.warn-empty-input\")\n : \"\",\n );\n const infoColor = useSignal(\n getCurrentNodeRuntime().path === \"not found\" ?\n /* text-red-500 */ \"#f56565\"\n : /* text-blue-500 */ \"#4299e1\",\n );\n const dropdownMarginTop = useSignal(\n getCurrentNodeRuntime().path === \"not found\" ? \"1.75rem\" : \"default\",\n );\n\n const parseOption = (option: string): NodeRuntime => {\n const parts = option.split(\" \");\n\n if (option === optionAuto) {\n let path = parts\n .slice(0, -1)\n .join(\" \")\n .slice(t(\"settings-panel.nodejs.constant.PATH_AUTO_DETECT\").length + 2, -1);\n if (path === t(\"settings-panel.nodejs.constant.PATH_BUNDLED\")) path = \"bundled\";\n const version = parts[parts.length - 1]!.slice(0, -1);\n return { path, version };\n }\n\n if (parts.length < 2) return { path: option, version: \"unknown\" };\n const lastPart = parts[parts.length - 1];\n if (!lastPart || !lastPart.startsWith(\"(\") || !lastPart.endsWith(\")\"))\n return { path: option, version: \"unknown\" };\n const version = lastPart.slice(1, -1);\n if (!semverValid(version)) return { path: option, version: \"unknown\" };\n return {\n path: parts.slice(0, -1).join(\" \"),\n version: version.startsWith(\"v\") ? version : `v${version}`,\n };\n };\n\n const retrieveRuntimeVersion = useMemo(\n () =>\n debounce(\n { delay: 500 },\n (() => {\n let latestTimestamp = 0;\n\n return (path: string) => {\n const timestamp = Date.now();\n latestTimestamp = timestamp;\n\n runCommand(`\"${path}\" -v`)\n .then((output) => {\n if (latestTimestamp !== timestamp) return;\n const version = output.trim();\n if (!version) throw new Error(\"No version found\");\n if (!semverValid(version)) throw new Error(`Invalid version: ${version}`);\n if (semverGte(version, \"20.0.0\")) {\n setCurrentNodeRuntime({ path, version });\n settings[key] = path;\n signal.value = path;\n currentVersion.value = version;\n inputType.value = \"passed\";\n forceFocusInput.value = false;\n info.value = t(\"settings-panel.nodejs.node-path.message.updated\")\n .replace(\"{{PATH}}\", path)\n .replace(\"{{VERSION}}\", version);\n infoColor.value = \"#48bb78\"; // text-green-500\n } else {\n inputType.value = \"failed\";\n forceFocusInput.value = false;\n info.value = t(\n \"settings-panel.nodejs.node-path.message.warn-invalid-version\",\n )\n .replace(\"{{PATH}}\", path)\n .replace(\"{{VERSION}}\", version);\n infoColor.value = \"#f56565\"; // text-red-500\n }\n })\n .catch(() => {\n if (latestTimestamp !== timestamp) return;\n inputType.value = \"failed\";\n forceFocusInput.value = false;\n info.value = t(\n \"settings-panel.nodejs.node-path.message.warn-invalid\",\n ).replace(\"{{PATH}}\", path);\n infoColor.value = \"#f56565\"; // text-red-500\n });\n };\n })(),\n ),\n [currentVersion, key, signal, inputType, forceFocusInput, info, infoColor],\n );\n\n return (\n
\n {\n const runtime = parseOption(option);\n signal.value = option === optionAuto ? null : runtime.path;\n currentVersion.value = runtime.version;\n\n if (!runtime.path) {\n inputType.value = \"failed\";\n info.value =\n options.length > 0 ?\n t(\"settings-panel.nodejs.node-path.message.warn-empty-select-or-input\")\n : t(\"settings-panel.nodejs.node-path.message.warn-empty-input\");\n infoColor.value = \"#f56565\"; // text-red-500\n dropdownMarginTop.value = \"1.75rem\";\n return;\n }\n\n if (options.includes(option)) {\n setCurrentNodeRuntime(runtime);\n if (option === optionAuto) settings.clear(key);\n else settings[key] = runtime.path;\n inputType.value = \"passed\";\n forceFocusInput.value = false;\n info.value =\n option === optionAuto ?\n t(\"settings-panel.nodejs.node-path.message.updated-auto\")\n : t(\"settings-panel.nodejs.node-path.message.updated\")\n .replace(\"{{PATH}}\", runtime.path)\n .replace(\"{{VERSION}}\", runtime.version);\n infoColor.value = \"#48bb78\"; // text-green-500\n } else {\n inputType.value = \"default\";\n forceFocusInput.value = true;\n info.value = t(\n \"settings-panel.nodejs.node-path.message.retrieving-version\",\n ).replace(\"{{PATH}}\", runtime.path);\n infoColor.value = \"#4299e1\"; // text-blue-500\n dropdownMarginTop.value = \"1.75rem\";\n retrieveRuntimeVersion(runtime.path);\n }\n }}\n onOpenDropdown={() => {\n if (inputType.value === \"passed\") inputType.value = \"default\";\n }}\n onCloseDropdown={() => {\n if (inputType.value === \"default\" && !forceFocusInput.value) info.value = \"\";\n dropdownMarginTop.value = \"default\";\n }}\n />\n\n {info.value && (\n \n {info.value}\n
\n )}\n \n );\n },\n },\n },\n} as const satisfies Categories;\n\nconst categoryIcons = {\n general: ,\n nodejs: ,\n} as const satisfies Record;\n\ntype CategoriesSignals = _Id<{\n [K in keyof C]: {\n [P in keyof C[K]]: C[K][P] extends SettingControl ? Signal : never;\n };\n}>;\n\nexport interface SettingsPanelProps {\n open?: boolean;\n onClose?: () => void;\n}\n\nconst SettingsPanel: FC = ({ onClose }) => {\n const selectedCategory = useSignal(Object.keys(categories)[0] as keyof typeof categories);\n const signals = mapValues(categories, (category) =>\n mapValues(category as never, (_, key) => useSignal(settings[key])),\n ) as CategoriesSignals;\n\n return (\n \n \n \n {t(\"settings-panel.title\")}\n \n \n \n
\n {keysOf(categories).map((category, i, arr) => (\n {\n selectedCategory.value = category;\n }}\n style={{ marginBottom: i === arr.length - 1 ? \"0\" : \"0.5rem\" }}>\n {categoryIcons[category]}\n \n {t(`settings-panel.${category}.title`)}\n \n \n ))}\n
\n\n \n {t.test(`settings-panel.${selectedCategory.value}.note`) && (\n
\n * {t.tran(`settings-panel.${selectedCategory.value}.note`)}\n \n
\n )}\n {entriesOf(categories[selectedCategory.value]).map(([key, control], i, arr) => (\n <>\n
\n {(() => {\n if (control.position === \"right\")\n return (\n <>\n \n \n {t.tran(\n `settings-panel.${selectedCategory.value}.${kebabCase(key)}.label`,\n )}\n \n {control.component(\n key as never,\n (signals[selectedCategory.value] as never)[key],\n )}\n
\n \n {t.tran(\n `settings-panel.${selectedCategory.value}.${kebabCase(key)}.description`,\n )}\n \n \n );\n /* position: bottom */\n return (\n <>\n
\n {t.tran(\n `settings-panel.${selectedCategory.value}.${kebabCase(key)}.label`,\n )}\n
\n \n {t.tran(\n `settings-panel.${selectedCategory.value}.${kebabCase(key)}.description`,\n )}\n \n
\n {control.component(\n key as never,\n (signals[selectedCategory.value] as never)[key],\n )}\n
\n \n );\n })()}\n\n {t.test(`settings-panel.${selectedCategory.value}.${kebabCase(key)}.warning`) && (\n \n {t.tran(`settings-panel.${selectedCategory.value}.${kebabCase(key)}.warning`)}\n \n )}\n \n\n {i !== arr.length - 1 && (\n
\n )}\n \n ))}\n \n \n \n \n );\n};\n\nconst MenuButton: FC<{\n selected?: boolean;\n onClick?: () => void;\n style?: preact.CSSProperties;\n}> = ({ children, onClick, selected = false, style: additionalStyle }) => {\n const style: preact.CSSProperties = {\n width: \"100%\",\n fontSize: \"0.875rem\",\n height: \"fit-content\",\n paddingTop: \"0.25rem\",\n paddingBottom: \"0.25rem\",\n paddingLeft: \"0.5rem\",\n paddingRight: \"0.75rem\",\n borderRadius: \"0.5rem\",\n display: \"flex\",\n whiteSpace: \"nowrap\",\n alignItems: \"center\",\n justifyContent: \"flex-start\",\n cursor: selected ? \"default\" : \"pointer\",\n backgroundColor: selected ? \"var(--item-hover-bg-color)\" : \"transparent\",\n ...(selected ? { pointerEvents: \"none\" } : {}),\n // eslint-disable-next-line @typescript-eslint/no-misused-spread\n ...additionalStyle,\n };\n return selected ?\n \n : ;\n};\n\nexport default SettingsPanel;\n" }, { "path": "src/components/Spinner.tsx", "content": "export interface SpinnerProps {\n color?: string;\n}\n\n/**\n * An svg spinner.\n * @returns\n */\nconst Spinner: FC = ({ color = \"gray\" }) => {\n return (\n \n .spinner_aj0A {\n transform-origin: center;\n animation: spinner_KYSC 0.75s infinite linear;\n }\n @keyframes spinner_KYSC {\n 100% {\n transform: rotate(360deg);\n }\n }\n \n