项目测试代码结构调整

* 添加 VSCode 配置项 (逻辑待实现)

* QuickPick 菜单支持过滤用户配置的禁用格式 (disableFormat)

* 右键菜单支持过滤用户配置的禁用格式 (disableFormat)

* 快捷键循环转换支持过滤用户配置的禁用格式 (disableFormat)

* 为了发版暂时隐藏未开发完成的 variable-conversion.circularConversionFormatOrder 配置项

* 配置项描述调整：中文在前英文在后

* 更新 README.md 自述文档

CHANGELOG.md

@@ -23,11 +23,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 -->
 
+## 2.0.0
+
+### Improvement
+
+- Adjust the project code directory structure. (项目代码目录结构调整)
+
+### Changed
+
+- Do not display the editor context menu `Variable Conversion` option when text is not selected. (当未选中文本时，不显示右键菜单 `变量转换` 选项)
+
+## 1.1.0
+
+### Added
+
+- Support configuring which formats are disabled through the VSCode settings page. It will apply to QuickPick menu conversions, context menu conversions, and shortcut key cyclic conversions. (支持通过 VSCode 设置页配置哪些格式是禁用的。配置后将同时对 QuickPick 菜单转换、右键菜单转换、快捷键循环转换生效)
+
 ## 1.0.11
 
 ### Improvement
 
-- Imperfect support: When a sub window is activated, clicking on the status bar of the main window can correctly bring up the QuickPick menu. 不完美支持：当子窗口激活时，点击主窗口状态栏能够正确弹出快速拾取菜单
+- Imperfect support: When a sub window is activated, clicking on the status bar of the main window can correctly bring up the QuickPick menu. (不完美支持：当子窗口激活时，点击主窗口状态栏能够正确弹出快速拾取菜单)
 
 ## 1.0.10
 

README.md

@@ -6,8 +6,9 @@
 A powerful variable naming conversion extension. Supports one-key conversion & cyclic conversion. You can use it through the editer menu, shortcut keys and bottom bar.
 
 - ✅ 支持多选区 Support multi-selection
-- ✅ 支持多窗口 (不支持子窗口状态栏) Support subwindow  (subwindow status bar are not supported)
+- ✅ 支持多窗口 Support subwindow
 - ✅ 支持撤回 & 重做 Support undo & redo (Ctrl + Z / Ctrl + Y)
+- ✅ 支持禁用部分目标转换格式 Supports disabling some target conversion formats
 
 > 🔭 Tips for Chinese users: 如果您无法看到下文图片，请[点这里](https://gitee.com/coder-xiaomo/variable-conversion-vscode-extension/blob/main/README.md)查看
 
@@ -20,7 +21,7 @@ Select what you want to convert in the editor, and then press `Ctrl + Alt + [` o
 
 ![](image/cyclic-conversion.gif)
 
-### 基础转换
+### 基础转换 Basic conversion
 
 **1. 选中代码中需要转换的内容** **Select The Text To Convert**
 
@@ -47,7 +48,7 @@ Or right-click on the selected text -> Convert string to...
 
 **3. 选择转换目标，转换完成** **Select the conversion target and complete**
 
-## 快捷键
+## 快捷键 Shortcut key
 
 | 功能 Feature                                     | 快捷键 shortcut key |
 | ------------------------------------------------ | ------------------- |
@@ -55,6 +56,12 @@ Or right-click on the selected text -> Convert string to...
 | 循环转换→上一个 Cyclic conversion → Previous one | Ctrl + Alt + [      |
 | 循环转换→下一个 Cyclic conversion → Next one     | Ctrl + Alt + ]      |
 
+## 配置项 configurations
+
+| 配置项 Configuration Key            | 描述 Description                                             | 配置示例                       | 默认值 |
+| ----------------------------------- | ------------------------------------------------------------ | ------------------------------ | ------ |
+| `variable-conversion.disableFormat` | 定义哪些格式是禁用的<br />Define which formats are disabled. | `["lower_case", "upper_case"]` | `[]`   |
+
 ## 支持的类型 Support Case
 
 | 类型                                       | Case                     | 举例 e.g.        |
@@ -82,7 +89,7 @@ Or right-click on the selected text -> Convert string to...
 
 ## 小提示 Tips
 
-#### 关于文本选区...
+#### 关于文本选区... About text selections...
 
 - 可以先按住 `Alt` 键不放，再鼠标先后选中多个选区
   You can first hold down `Alt`, and then use the mouse to select multiple selection
@@ -107,4 +114,6 @@ Gitee Mirror (码云镜像): https://gitee.com/coder-xiaomo/variable-conversion-
 
 -----
 
+**玩得开心！**
+
 **Enjoy!**

package-comment.jsonc

@@ -4,7 +4,7 @@
   "displayName": "Variable Conversion",
   "description": "一个强大的变量名转换插件，支持右键菜单、快捷键、状态栏等多种方式使用，支持小驼峰、大驼峰(帕斯卡)、下划线(蛇形)、中划线(连字符/脊柱式)、空格分隔、点分隔、全小写、全大写等常用命名方式(及组合)转换。 \nA powerful variable naming conversion extension. You can use it through the editer menu, shortcut keys and bottom bar. Support camel, pascal, snake, kebab(spinal), space, dot, lower, upper case, and more.",
   // 版本号
-  "version": "1.0.11",
+  "version": "2.0.0",
   // logo
   "icon": "image/logo.png",
   "publisher": "coder-xiaomo",
@@ -209,7 +209,9 @@
       // 编辑器右键菜单
       "editor/context": [
         {
-          "when": "editorTextFocus",
+          // "when": "editorTextFocus",
+          // 2024.12.07 当未选中文字时，隐藏 [变量转换] 右键菜单
+          "when": "editorTextFocus && _textSelectionLength >= 1",
           "command": "variable-conversion.convertCase",
           // "group": "1_modification@9"
           "group": "navigation@9"
@@ -225,87 +227,107 @@
       "variable-conversion.stringConversionMenu": [
         // group-1-camel
         {
+          "when": "!_isHideSubMenuItem_camel_case",
           "command": "variable-conversion.toCamelCase",
           "group": "group-1-camel@1"
         },
         {
+          "when": "!_isHideSubMenuItem_pascal_case",
           "command": "variable-conversion.toPascalCase",
           "group": "group-1-camel@2"
         },
         // group-2-snake
         {
+          "when": "!_isHideSubMenuItem_snake_case",
           "command": "variable-conversion.toSnakeCase",
           "group": "group-2-snake@1"
         },
         {
+          "when": "!_isHideSubMenuItem_snake_upper_case",
           "command": "variable-conversion.toSnakeUpperCase",
           "group": "group-2-snake@2"
         },
         {
+          "when": "!_isHideSubMenuItem_snake_pascal_case",
           "command": "variable-conversion.toSnakePascalCase",
           "group": "group-2-snake@3"
         },
         {
+          "when": "!_isHideSubMenuItem_snake_camel_case",
           "command": "variable-conversion.toSnakeCamelCase",
           "group": "group-2-snake@4"
         },
         // group-3-kebab
         {
+          "when": "!_isHideSubMenuItem_kebab_case",
           "command": "variable-conversion.toKebabCase",
           "group": "group-3-kebab@1"
         },
         {
+          "when": "!_isHideSubMenuItem_kebab_upper_case",
           "command": "variable-conversion.toKebabUpperCase",
           "group": "group-3-kebab@2"
         },
         {
+          "when": "!_isHideSubMenuItem_kebab_pascal_case",
           "command": "variable-conversion.toKebabPascalCase",
           "group": "group-3-kebab@3"
         },
         {
+          "when": "!_isHideSubMenuItem_kebab_camel_case",
           "command": "variable-conversion.toKebabCamelCase",
           "group": "group-3-kebab@4"
         },
         // group-4-space
         {
+          "when": "!_isHideSubMenuItem_space_case",
           "command": "variable-conversion.toSpaceCase",
           "group": "group-4-space@1"
         },
         {
+          "when": "!_isHideSubMenuItem_space_upper_case",
           "command": "variable-conversion.toSpaceUpperCase",
           "group": "group-4-space@2"
         },
         {
+          "when": "!_isHideSubMenuItem_space_pascal_case",
           "command": "variable-conversion.toSpacePascalCase",
           "group": "group-4-space@3"
         },
         {
+          "when": "!_isHideSubMenuItem_space_camel_case",
           "command": "variable-conversion.toSpaceCamelCase",
           "group": "group-4-space@4"
         },
         // group-5-dot
         {
+          "when": "!_isHideSubMenuItem_dot_case",
           "command": "variable-conversion.toDotCase",
           "group": "group-5-dot@1"
         },
         {
+          "when": "!_isHideSubMenuItem_dot_upper_case",
           "command": "variable-conversion.toDotUpperCase",
           "group": "group-5-dot@2"
         },
         {
+          "when": "!_isHideSubMenuItem_dot_pascal_case",
           "command": "variable-conversion.toDotPascalCase",
           "group": "group-5-dot@3"
         },
         {
+          "when": "!_isHideSubMenuItem_dot_camel_case",
           "command": "variable-conversion.toDotCamelCase",
           "group": "group-5-dot@4"
         },
         // group-6-upper-lower
         {
+          "when": "!_isHideSubMenuItem_lower_case",
           "command": "variable-conversion.toLowerCase",
           "group": "group-6-upper-lower@1"
         },
         {
+          "when": "!_isHideSubMenuItem_upper_case",
           "command": "variable-conversion.toUpperCase",
           "group": "group-6-upper-lower@2"
         }
@@ -348,8 +370,177 @@
         "id": "variable-conversion.stringConversionMenu",
         "label": "将变量转换为..."
       }
+    ],
+    // docs: https://code.visualstudio.com/api/references/contribution-points#contributes.configuration
+    "configuration": {
+      "title": "Variable Conversion 变量转换",
+      "properties": {
+        // 仅测试用
+        // "variable-conversion.test1": {
+        //   "title": "定义转换格式的排序",
+        //   "description": "Defines the ordering of the conversion format.\n定义转换格式的排序",
+        //   "type": "array",
+        //   "default": [
+        //     "camelCase",
+        //     "snake_case",
+        //     "PascalCase"
+        //   ]
+        // },
+        // "variable-conversion.enableFormat": {
+        //   "type": "object",
+        //   "default": {
+        //     "camelCase": true,
+        //     "snake_case": true,
+        //     "PascalCase": true
+        //   },
+        //   "description": "Define which formats are enabled.\n定义哪些格式是开启的"
+        // },
+        //
+        // 全小写命名
+        // lower_case(全小写), snake_case(下划线), kebab_case(连字符), space_case(空格), dot_case(点)
+        // 全大写命名
+        // upper_case(全大写), snake_upper_case(下划线), kebab_upper_case(连字符), space_upper_case(空格), dot_upper_case(点)
+        // 大驼峰命名
+        // pascal_case(大驼峰), snake_pascal_case(下划线), kebab_pascal_case(连字符), space_pascal_case(空格), dot_pascal_case(点)
+        // 小驼峰命名
+        // camel_case(小驼峰), snake_camel_case(下划线), kebab_camel_case(连字符), space_camel_case(空格), dot_camel_case(点)
+        "variable-conversion.disableFormat": {
+          "order": 1,
+          // markdownDescription 最多配置 11 行
+          "markdownDescription": "定义哪些格式是禁用的\n\nDefine which formats are disabled.\n\n若您感觉以下配置比较麻烦，也可以选择在 `settings.json` 中编辑：\n\nIf you find the following configuration troublesome, you can also edit this configuration item in `settings.json`:\n\n`\"variable-conversion.disableFormat\": [ ... ],`\n\n[在 settings.json 中编辑 (Edit in settings.json)](command:workbench.action.openSettingsJson)\n\n配置后，您可能需要*重启扩展宿主*，或*重启当前窗口*才可使该配置完全生效（二选一即可）:\n\nYou may need to *restart extension host* or *reload window* after configuration to take full effect (either):\n\n[重启扩展宿主 (Restart Extension Host)](command:workbench.action.restartExtensionHost), [重启当前窗口 (Reload Window)](command:workbench.action.reloadWindow)",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "camel_case",
+              "pascal_case",
+              "snake_case",
+              "snake_camel_case",
+              "snake_pascal_case",
+              "snake_upper_case",
+              "kebab_case",
+              "kebab_camel_case",
+              "kebab_pascal_case",
+              "kebab_upper_case",
+              "space_case",
+              "space_camel_case",
+              "space_pascal_case",
+              "space_upper_case",
+              "dot_case",
+              "dot_camel_case",
+              "dot_pascal_case",
+              "dot_upper_case",
+              "lower_case",
+              "upper_case"
+            ],
+            "enumDescriptions": [
+              "小驼峰(驼峰)命名",
+              "大驼峰(帕斯卡)命名",
+              "下划线(蛇形)命名",
+              "下划线(蛇形) + 小驼峰(驼峰)命名",
+              "下划线(蛇形) + 大驼峰(帕斯卡)命名",
+              "下划线(蛇形) + 全大写命名",
+              "中划线(连字符/脊柱式)命名",
+              "中划线(连字符/脊柱式) + 小驼峰(驼峰)命名",
+              "中划线(连字符/脊柱式) + 大驼峰(帕斯卡)命名",
+              "中划线(连字符/脊柱式) + 全大写命名",
+              "空格分隔命名",
+              "空格分隔 + 小驼峰(驼峰)命名",
+              "空格分隔 + 大驼峰(帕斯卡)命名",
+              "空格分隔 + 全大写命名",
+              "点分隔命名",
+              "点分隔 + 小驼峰(驼峰)命名",
+              "点分隔 + 大驼峰(帕斯卡)命名",
+              "点分隔 + 全大写命名",
+              "全小写",
+              "全大写"
             ]
           },
+          "default": []
+        },
+        "variable-conversion.circularConversionFormatOrder": {
+          "order": 2,
+          "title": "定义循环转换快捷键的目标格式排序",
+          // "description": "Defines the destination format ordering of the circular conversion shortcut.\n定义循环转换快捷键的目标格式排序",
+          // markdownDescription 最多配置 11 行
+          // "markdownDescription": "Defines the destination format ordering of the circular conversion shortcut, separated by commas.\n\n 定义循环转换快捷键的目标格式排序，以英文逗号分隔\n\n Target formats that are not in the following configuration list will appear last in the following custom order in the default order.\n\n不在以下配置列表中的目标格式，将按照默认顺序排在以下自定义顺序最后\n\n 🌟Lower Case 全小写命名: `lower_case`(全小写), `snake_case`(下划线), `kebab_case`(连字符), `space_case`(空格), `dot_case`(点)\n\n 🌟Upper Case 全大写命名: `upper_case`(全大写), `snake_upper_case`(下划线), `kebab_upper_case`(连字符), `space_upper_case`(空格), `dot_upper_case`(点)\n\n 🌟Pascal Case 大驼峰命名: `pascal_case`(大驼峰), `snake_pascal_case`(下划线), `kebab_pascal_case`(连字符), `space_pascal_case`(空格), `dot_pascal_case`(点)\n\n 🌟Camel Case 小驼峰命名: `camel_case`(小驼峰), `snake_camel_case`(下划线), `kebab_camel_case`(连字符), `space_camel_case`(空格), `dot_camel_case`(点)\n\n🐳Default value 默认值: `camel_case, snake_case, pascal_case, kebab_case, space_case, dot_case, snake_upper_case, kebab_upper_case, space_upper_case, dot_upper_case, snake_pascal_case, kebab_pascal_case, space_pascal_case, dot_pascal_case, snake_camel_case, kebab_camel_case, space_camel_case, dot_camel_case, lower_case, upper_case`\n\n If you find the following configuration troublesome, you can also edit this configuration item in `settings.json`. 若您感觉以下配置比较麻烦，也可以选择在 `settings.json` 中编辑: `\"variable-conversion.circularConversionFormatOrder\": \"...\",` [Edit in settings.json (在 settings.json 中编辑)](command:workbench.action.openSettingsJson)",
+          "markdownDescription": "定义循环转换快捷键的目标格式排序，以英文逗号分隔。不在以下配置列表中的目标格式，将按照默认顺序排在以下自定义顺序最后\n\n Defines the destination format ordering of the circular conversion shortcut, separated by commas. (Target formats that are not in the following configuration list will appear last in the following custom order in the default order.)\n\n 📌请[在 `settings.json` 中编辑该配置](command:workbench.action.openSettingsJson)，**不要使用**设置页面的下拉框进行配置: `\"variable-conversion.circularConversionFormatOrder\": [ ... ],`\n\n 📌Please [edit this configuration in `settings.json`](command:workbench.action.openSettingsJson), **instead of** using the drop-down box on the settings page.\n\n 🐳默认值 Default value: `\"variable-conversion.circularConversionFormatOrder\": [ \"camel_case\", \"snake_case\", \"pascal_case\", \"kebab_case\", \"space_case\", \"dot_case\", \"snake_upper_case\", \"kebab_upper_case\", \"space_upper_case\", \"dot_upper_case\", \"snake_pascal_case\", \"kebab_pascal_case\", \"space_pascal_case\", \"dot_pascal_case\", \"snake_camel_case\", \"kebab_camel_case\", \"space_camel_case\", \"dot_camel_case\", \"lower_case\", \"upper_case\" ],`\n\n 👉Configuration item meaning 配置项说明\n\n 🌟Lower Case 全小写命名: `lower_case`(全小写), `snake_case`(下划线), `kebab_case`(连字符), `space_case`(空格), `dot_case`(点)\n\n 🌟Upper Case 全大写命名: `upper_case`(全大写), `snake_upper_case`(下划线), `kebab_upper_case`(连字符), `space_upper_case`(空格), `dot_upper_case`(点)\n\n 🌟Pascal Case 大驼峰命名: `pascal_case`(大驼峰), `snake_pascal_case`(下划线), `kebab_pascal_case`(连字符), `space_pascal_case`(空格), `dot_pascal_case`(点)\n\n 🌟Camel Case 小驼峰命名: `camel_case`(小驼峰), `snake_camel_case`(下划线), `kebab_camel_case`(连字符), `space_camel_case`(空格), `dot_camel_case`(点)",
+          // "type": "string",
+          // "default": "camel_case, snake_case, pascal_case, kebab_case, space_case, dot_case, snake_upper_case, kebab_upper_case, space_upper_case, dot_upper_case, snake_pascal_case, kebab_pascal_case, space_pascal_case, dot_pascal_case, snake_camel_case, kebab_camel_case, space_camel_case, dot_camel_case, lower_case, upper_case"
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "camel_case",
+              "pascal_case",
+              "snake_case",
+              "snake_camel_case",
+              "snake_pascal_case",
+              "snake_upper_case",
+              "kebab_case",
+              "kebab_camel_case",
+              "kebab_pascal_case",
+              "kebab_upper_case",
+              "space_case",
+              "space_camel_case",
+              "space_pascal_case",
+              "space_upper_case",
+              "dot_case",
+              "dot_camel_case",
+              "dot_pascal_case",
+              "dot_upper_case",
+              "lower_case",
+              "upper_case"
+            ],
+            "enumDescriptions": [
+              "小驼峰(驼峰)命名",
+              "大驼峰(帕斯卡)命名",
+              "下划线(蛇形)命名",
+              "下划线(蛇形) + 小驼峰(驼峰)命名",
+              "下划线(蛇形) + 大驼峰(帕斯卡)命名",
+              "下划线(蛇形) + 全大写命名",
+              "中划线(连字符/脊柱式)命名",
+              "中划线(连字符/脊柱式) + 小驼峰(驼峰)命名",
+              "中划线(连字符/脊柱式) + 大驼峰(帕斯卡)命名",
+              "中划线(连字符/脊柱式) + 全大写命名",
+              "空格分隔命名",
+              "空格分隔 + 小驼峰(驼峰)命名",
+              "空格分隔 + 大驼峰(帕斯卡)命名",
+              "空格分隔 + 全大写命名",
+              "点分隔命名",
+              "点分隔 + 小驼峰(驼峰)命名",
+              "点分隔 + 大驼峰(帕斯卡)命名",
+              "点分隔 + 全大写命名",
+              "全小写",
+              "全大写"
+            ]
+          },
+          "default": [
+            "camel_case",
+            "snake_case",
+            "pascal_case",
+            "kebab_case",
+            "space_case",
+            "dot_case",
+            "snake_upper_case",
+            "kebab_upper_case",
+            "space_upper_case",
+            "dot_upper_case",
+            "snake_pascal_case",
+            "kebab_pascal_case",
+            "space_pascal_case",
+            "dot_pascal_case",
+            "snake_camel_case",
+            "kebab_camel_case",
+            "space_camel_case",
+            "dot_camel_case",
+            "lower_case",
+            "upper_case"
+          ]
+        }
+      }
+    }
+  },
   "scripts": {
     "vscode:prepublish": "npm run compile",
     "compile": "tsc -p ./",

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "variable-conversion",
-  "version": "1.0.11",
+  "version": "1.1.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "variable-conversion",
-      "version": "1.0.11",
+      "version": "1.1.0",
       "devDependencies": {
         "@types/mocha": "^10.0.6",
         "@types/node": "18.x",

package.json

@@ -2,7 +2,7 @@
   "name": "variable-conversion",
   "displayName": "Variable Conversion",
   "description": "一个强大的变量名转换插件，支持右键菜单、快捷键、状态栏等多种方式使用，支持小驼峰、大驼峰(帕斯卡)、下划线(蛇形)、中划线(连字符/脊柱式)、空格分隔、点分隔、全小写、全大写等常用命名方式(及组合)转换。 \nA powerful variable naming conversion extension. You can use it through the editer menu, shortcut keys and bottom bar. Support camel, pascal, snake, kebab(spinal), space, dot, lower, upper case, and more.",
-  "version": "1.0.11",
+  "version": "2.0.0",
   "icon": "image/logo.png",
   "publisher": "coder-xiaomo",
   "engines": {
@@ -143,7 +143,7 @@
     "menus": {
       "editor/context": [
         {
-          "when": "editorTextFocus",
+          "when": "editorTextFocus && _textSelectionLength >= 1",
           "command": "variable-conversion.convertCase",
           "group": "navigation@9"
         },
@@ -155,84 +155,104 @@
       ],
       "variable-conversion.stringConversionMenu": [
         {
+          "when": "!_isHideSubMenuItem_camel_case",
           "command": "variable-conversion.toCamelCase",
           "group": "group-1-camel@1"
         },
         {
+          "when": "!_isHideSubMenuItem_pascal_case",
           "command": "variable-conversion.toPascalCase",
           "group": "group-1-camel@2"
         },
         {
+          "when": "!_isHideSubMenuItem_snake_case",
           "command": "variable-conversion.toSnakeCase",
           "group": "group-2-snake@1"
         },
         {
+          "when": "!_isHideSubMenuItem_snake_upper_case",
           "command": "variable-conversion.toSnakeUpperCase",
           "group": "group-2-snake@2"
         },
         {
+          "when": "!_isHideSubMenuItem_snake_pascal_case",
           "command": "variable-conversion.toSnakePascalCase",
           "group": "group-2-snake@3"
         },
         {
+          "when": "!_isHideSubMenuItem_snake_camel_case",
           "command": "variable-conversion.toSnakeCamelCase",
           "group": "group-2-snake@4"
         },
         {
+          "when": "!_isHideSubMenuItem_kebab_case",
           "command": "variable-conversion.toKebabCase",
           "group": "group-3-kebab@1"
         },
         {
+          "when": "!_isHideSubMenuItem_kebab_upper_case",
           "command": "variable-conversion.toKebabUpperCase",
           "group": "group-3-kebab@2"
         },
         {
+          "when": "!_isHideSubMenuItem_kebab_pascal_case",
           "command": "variable-conversion.toKebabPascalCase",
           "group": "group-3-kebab@3"
         },
         {
+          "when": "!_isHideSubMenuItem_kebab_camel_case",
           "command": "variable-conversion.toKebabCamelCase",
           "group": "group-3-kebab@4"
         },
         {
+          "when": "!_isHideSubMenuItem_space_case",
           "command": "variable-conversion.toSpaceCase",
           "group": "group-4-space@1"
         },
         {
+          "when": "!_isHideSubMenuItem_space_upper_case",
           "command": "variable-conversion.toSpaceUpperCase",
           "group": "group-4-space@2"
         },
         {
+          "when": "!_isHideSubMenuItem_space_pascal_case",
           "command": "variable-conversion.toSpacePascalCase",
           "group": "group-4-space@3"
         },
         {
+          "when": "!_isHideSubMenuItem_space_camel_case",
           "command": "variable-conversion.toSpaceCamelCase",
           "group": "group-4-space@4"
         },
         {
+          "when": "!_isHideSubMenuItem_dot_case",
           "command": "variable-conversion.toDotCase",
           "group": "group-5-dot@1"
         },
         {
+          "when": "!_isHideSubMenuItem_dot_upper_case",
           "command": "variable-conversion.toDotUpperCase",
           "group": "group-5-dot@2"
         },
         {
+          "when": "!_isHideSubMenuItem_dot_pascal_case",
           "command": "variable-conversion.toDotPascalCase",
           "group": "group-5-dot@3"
         },
         {
+          "when": "!_isHideSubMenuItem_dot_camel_case",
           "command": "variable-conversion.toDotCamelCase",
           "group": "group-5-dot@4"
         },
         {
+          "when": "!_isHideSubMenuItem_lower_case",
           "command": "variable-conversion.toLowerCase",
-          "group": "group-5-upper-lower@1"
+          "group": "group-6-upper-lower@1"
         },
         {
+          "when": "!_isHideSubMenuItem_upper_case",
           "command": "variable-conversion.toUpperCase",
-          "group": "group-5-upper-lower@2"
+          "group": "group-6-upper-lower@2"
         }
       ]
     },
@@ -241,8 +261,66 @@
         "id": "variable-conversion.stringConversionMenu",
         "label": "将变量转换为..."
       }
+    ],
+    "configuration": {
+      "title": "Variable Conversion 变量转换",
+      "properties": {
+        "variable-conversion.disableFormat": {
+          "order": 1,
+          "markdownDescription": "定义哪些格式是禁用的\n\nDefine which formats are disabled.\n\n若您感觉以下配置比较麻烦，也可以选择在 `settings.json` 中编辑：\n\nIf you find the following configuration troublesome, you can also edit this configuration item in `settings.json`:\n\n`\"variable-conversion.disableFormat\": [ ... ],`\n\n[在 settings.json 中编辑 (Edit in settings.json)](command:workbench.action.openSettingsJson)\n\n配置后，您可能需要*重启扩展宿主*，或*重启当前窗口*才可使该配置完全生效（二选一即可）:\n\nYou may need to *restart extension host* or *reload window* after configuration to take full effect (either):\n\n[重启扩展宿主 (Restart Extension Host)](command:workbench.action.restartExtensionHost), [重启当前窗口 (Reload Window)](command:workbench.action.reloadWindow)",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "camel_case",
+              "pascal_case",
+              "snake_case",
+              "snake_camel_case",
+              "snake_pascal_case",
+              "snake_upper_case",
+              "kebab_case",
+              "kebab_camel_case",
+              "kebab_pascal_case",
+              "kebab_upper_case",
+              "space_case",
+              "space_camel_case",
+              "space_pascal_case",
+              "space_upper_case",
+              "dot_case",
+              "dot_camel_case",
+              "dot_pascal_case",
+              "dot_upper_case",
+              "lower_case",
+              "upper_case"
+            ],
+            "enumDescriptions": [
+              "小驼峰(驼峰)命名",
+              "大驼峰(帕斯卡)命名",
+              "下划线(蛇形)命名",
+              "下划线(蛇形) + 小驼峰(驼峰)命名",
+              "下划线(蛇形) + 大驼峰(帕斯卡)命名",
+              "下划线(蛇形) + 全大写命名",
+              "中划线(连字符/脊柱式)命名",
+              "中划线(连字符/脊柱式) + 小驼峰(驼峰)命名",
+              "中划线(连字符/脊柱式) + 大驼峰(帕斯卡)命名",
+              "中划线(连字符/脊柱式) + 全大写命名",
+              "空格分隔命名",
+              "空格分隔 + 小驼峰(驼峰)命名",
+              "空格分隔 + 大驼峰(帕斯卡)命名",
+              "空格分隔 + 全大写命名",
+              "点分隔命名",
+              "点分隔 + 小驼峰(驼峰)命名",
+              "点分隔 + 大驼峰(帕斯卡)命名",
+              "点分隔 + 全大写命名",
+              "全小写",
+              "全大写"
             ]
           },
+          "default": []
+        }
+      }
+    }
+  },
   "scripts": {
     "vscode:prepublish": "npm run compile",
     "compile": "tsc -p ./",

src/core/variable-convert/conversion.ts

@@ -1,7 +1,7 @@
-import { EOL } from '../type-definition/EOLType';
+import { EOL } from '../../types/EOLType';
-import { SupportCase } from '../type-definition/SupportCaseType';
+import { SupportCase } from './types/SupportCaseType';
-import { TransformTextResult } from '../type-definition/TransformTextResultType';
+import { TransformTextResult } from '../../types/TransformTextResultType';
-import { transformMutliLineText, transformText } from './transform';
+import { transformMutliLineText, transformText } from '../../utils/transform';
 
 /**
  * 统一文本转换函数
@@ -9,6 +9,7 @@ import { transformMutliLineText, transformText } from './transform';
  * @param {SupportCase} targetCase 目标文本情况
  * @param {string} str 用户选择的文本 user selection
  * @param {EOL} eol 行结束符
+ * @param {Array<TransformTextResult>?} cutText 行结束符
  * @returns 转换后的文本
  * @since 2024-04-04
  */

src/core/variable-convert/cyclic-conversion.ts

@@ -1,8 +1,9 @@
 import * as vscode from 'vscode';
-import { EOL } from "../type-definition/EOLType";
+import { EOL } from "../../types/EOLType";
-import { cyclicConvertCaseOrder } from "../type-definition/SupportCaseType";
+import { cyclicConvertCaseOrder } from "./types/SupportCaseType";
 import { caseConversion } from "./conversion";
-import { isStringArrayEqual, stringListArrayDuplicateRemoval } from './utils';
+import { isStringArrayEqual, stringListArrayDuplicateRemoval } from '../../utils/utils';
+import { getUserConfigurations } from '../../utils/user-configuration';
 
 interface UserSelection {
     currentEol: EOL
@@ -64,16 +65,25 @@ function lazyConvert() {
         return;
     }
 
+    // 获取用户配置
+    const disableFormatList = getUserConfigurations<Array<string>>('disableFormat') || [];
+
     const textList = userSelection.currentSelectionsText;
     // vscode.window.showInformationMessage('lazyConvert' + textList.join('\n'));
     const eol = userSelection.currentEol;
     const conversionsTarget: Array<string[]> = [textList];
     for (const cyclicConvertCase of cyclicConvertCaseOrder) {
+        // issue: #1 https://github.com/coder-xiaomo/variable-conversion-vscode-extension/issues/1
+        // 跳过禁用的目标格式
+        if (disableFormatList.includes(cyclicConvertCase.settingsKey)) {
+            continue;
+        }
+
         // 每一个类型
         const conversionsTargetItem: string[] = [];
         for (const line of textList) {
             // 选中区块的每一行
-            const conversionResult: string = caseConversion(cyclicConvertCase, line, eol);
+            const conversionResult: string = caseConversion(cyclicConvertCase.type, line, eol);
             conversionsTargetItem.push(conversionResult);
         }
         conversionsTarget.push(conversionsTargetItem);

src/core/variable-convert/types/SupportCaseType.ts

@@ -3,11 +3,11 @@
  *
  * Code:
  * - Add type definition in below `SupportCase` enum and following array
- * - Add `commands`, `menus` parts in [package.json] and [package-comment.jsonc]
+ * - Add `commands`, `menus`, `configuration` parts in [package.json] and [package-comment.jsonc]
- * - Add main conversion logic in [src/main-code/conversion.ts]
+ * - Add main conversion logic in [src/core/variable-convert/conversion.ts]
  *
  * Test:
- * - Add test case type definition in [src/type-definition/TestCaseType.ts]
+ * - Add test case type definition in [src/test/types/TestCaseType.ts]
  * - Add test case in [src/test/test-case.ts]
  * - Add test code in [src/test/extension.test.ts]
  *
@@ -281,188 +281,301 @@ const keyword = {
 /**
  * 接管的变量转换命令
  */
-export const commands: Array<{ command: string; targetCase: SupportCase }> = [
+export const commands: Array<{ command: string; targetCase: SupportCase; settingsKey: string }> = [
-    { command: 'variable-conversion.toCamelCase', targetCase: SupportCase.CAMEL_CASE },
+    {
-    { command: 'variable-conversion.toPascalCase', targetCase: SupportCase.PASCAL_CASE },
+        command: 'variable-conversion.toCamelCase',
-
+        targetCase: SupportCase.CAMEL_CASE,
-    { command: 'variable-conversion.toSnakeCase', targetCase: SupportCase.SNAKE_CASE },
+        settingsKey: 'camel_case'
-    { command: 'variable-conversion.toSnakeUpperCase', targetCase: SupportCase.SNAKE_UPPER_CASE },
+    },
-    { command: 'variable-conversion.toSnakePascalCase', targetCase: SupportCase.SNAKE_PASCAL_CASE },
+    {
-    { command: 'variable-conversion.toSnakeCamelCase', targetCase: SupportCase.SNAKE_CAMEL_CASE },
+        command: 'variable-conversion.toPascalCase',
-
+        targetCase: SupportCase.PASCAL_CASE,
-    { command: 'variable-conversion.toKebabCase', targetCase: SupportCase.KEBAB_CASE },
+        settingsKey: 'pascal_case'
-    { command: 'variable-conversion.toKebabUpperCase', targetCase: SupportCase.KEBAB_UPPER_CASE },
+    },
-    { command: 'variable-conversion.toKebabPascalCase', targetCase: SupportCase.KEBAB_PASCAL_CASE },
+    // +++++++++++++++++++++++++++++++++++++++++++++++
-    { command: 'variable-conversion.toKebabCamelCase', targetCase: SupportCase.KEBAB_CAMEL_CASE },
+    {
-
+        command: 'variable-conversion.toSnakeCase',
-    { command: 'variable-conversion.toSpaceCase', targetCase: SupportCase.SPACE_CASE },
+        targetCase: SupportCase.SNAKE_CASE,
-    { command: 'variable-conversion.toSpaceUpperCase', targetCase: SupportCase.SPACE_UPPER_CASE },
+        settingsKey: 'snake_case'
-    { command: 'variable-conversion.toSpacePascalCase', targetCase: SupportCase.SPACE_PASCAL_CASE },
+    },
-    { command: 'variable-conversion.toSpaceCamelCase', targetCase: SupportCase.SPACE_CAMEL_CASE },
+    {
-
+        command: 'variable-conversion.toSnakeUpperCase',
-    { command: 'variable-conversion.toDotCase', targetCase: SupportCase.DOT_CASE },
+        targetCase: SupportCase.SNAKE_UPPER_CASE,
-    { command: 'variable-conversion.toDotUpperCase', targetCase: SupportCase.DOT_UPPER_CASE },
+        settingsKey: 'snake_upper_case'
-    { command: 'variable-conversion.toDotPascalCase', targetCase: SupportCase.DOT_PASCAL_CASE },
+    },
-    { command: 'variable-conversion.toDotCamelCase', targetCase: SupportCase.DOT_CAMEL_CASE },
+    {
-
+        command: 'variable-conversion.toSnakePascalCase',
-    { command: 'variable-conversion.toLowerCase', targetCase: SupportCase.LOWER_CASE },
+        targetCase: SupportCase.SNAKE_PASCAL_CASE,
-    { command: 'variable-conversion.toUpperCase', targetCase: SupportCase.UPPER_CASE },
+        settingsKey: 'snake_pascal_case'
+    },
+    {
+        command: 'variable-conversion.toSnakeCamelCase',
+        targetCase: SupportCase.SNAKE_CAMEL_CASE,
+        settingsKey: 'snake_camel_case'
+    },
+    // +++++++++++++++++++++++++++++++++++++++++++++++
+    {
+        command: 'variable-conversion.toKebabCase',
+        targetCase: SupportCase.KEBAB_CASE,
+        settingsKey: 'kebab_case'
+    },
+    {
+        command: 'variable-conversion.toKebabUpperCase',
+        targetCase: SupportCase.KEBAB_UPPER_CASE,
+        settingsKey: 'kebab_upper_case'
+    },
+    {
+        command: 'variable-conversion.toKebabPascalCase',
+        targetCase: SupportCase.KEBAB_PASCAL_CASE,
+        settingsKey: 'kebab_pascal_case'
+    },
+    {
+        command: 'variable-conversion.toKebabCamelCase',
+        targetCase: SupportCase.KEBAB_CAMEL_CASE,
+        settingsKey: 'kebab_camel_case'
+    },
+    // +++++++++++++++++++++++++++++++++++++++++++++++
+    {
+        command: 'variable-conversion.toSpaceCase',
+        targetCase: SupportCase.SPACE_CASE,
+        settingsKey: 'space_case'
+    },
+    {
+        command: 'variable-conversion.toSpaceUpperCase',
+        targetCase: SupportCase.SPACE_UPPER_CASE,
+        settingsKey: 'space_upper_case'
+    },
+    {
+        command: 'variable-conversion.toSpacePascalCase',
+        targetCase: SupportCase.SPACE_PASCAL_CASE,
+        settingsKey: 'space_pascal_case'
+    },
+    {
+        command: 'variable-conversion.toSpaceCamelCase',
+        targetCase: SupportCase.SPACE_CAMEL_CASE,
+        settingsKey: 'space_camel_case'
+    },
+    // +++++++++++++++++++++++++++++++++++++++++++++++
+    {
+        command: 'variable-conversion.toDotCase',
+        targetCase: SupportCase.DOT_CASE,
+        settingsKey: 'dot_case'
+    },
+    {
+        command: 'variable-conversion.toDotUpperCase',
+        targetCase: SupportCase.DOT_UPPER_CASE,
+        settingsKey: 'dot_upper_case'
+    },
+    {
+        command: 'variable-conversion.toDotPascalCase',
+        targetCase: SupportCase.DOT_PASCAL_CASE,
+        settingsKey: 'dot_pascal_case'
+    },
+    {
+        command: 'variable-conversion.toDotCamelCase',
+        targetCase: SupportCase.DOT_CAMEL_CASE,
+        settingsKey: 'dot_camel_case'
+    },
+    // +++++++++++++++++++++++++++++++++++++++++++++++
+    {
+        command: 'variable-conversion.toLowerCase',
+        targetCase: SupportCase.LOWER_CASE,
+        settingsKey: 'lower_case'
+    },
+    {
+        command: 'variable-conversion.toUpperCase',
+        targetCase: SupportCase.UPPER_CASE,
+        settingsKey: 'upper_case'
+    },
 ];
 
+export interface QuickPickSupportCaseItem {
+    type: SupportCase,
+    name: string,
+    shortName: string,
+    keyword: string[],
+    settingsKey: string,
+}
+
 /**
  * 所有支持的命名方式
  * @since 2024-04-06
  */
-export const quickPickSupportCases = [
+export const quickPickSupportCases: Array<QuickPickSupportCaseItem> = [
     {
         type: SupportCase.CAMEL_CASE,
         name: '小驼峰(驼峰)命名',
         shortName: '小驼峰',
         keyword: keyword.camel,
+        settingsKey: 'camel_case',
     },
     {
         type: SupportCase.PASCAL_CASE,
         name: '大驼峰(帕斯卡)命名',
         shortName: '帕斯卡',
         keyword: keyword.pascal,
+        settingsKey: 'pascal_case',
     },
     {
         type: SupportCase.SNAKE_CASE,
         name: '下划线(蛇形)命名',
         shortName: '蛇形',
         keyword: [...keyword.snake, ...keyword.lower],
+        settingsKey: 'snake_case',
     },
     {
         type: SupportCase.SNAKE_CAMEL_CASE,
         name: '下划线(蛇形) + 小驼峰(驼峰)命名',
         shortName: '蛇形驼峰',
         keyword: [...keyword.snake, ...keyword.camel],
+        settingsKey: 'snake_camel_case',
     },
     {
         type: SupportCase.SNAKE_PASCAL_CASE,
         name: '下划线(蛇形) + 大驼峰(帕斯卡)命名',
         shortName: '蛇形帕斯卡',
         keyword: [...keyword.snake, ...keyword.pascal],
+        settingsKey: 'snake_pascal_case',
     },
     {
         type: SupportCase.SNAKE_UPPER_CASE,
         name: '下划线(蛇形) + 全大写命名',
         shortName: '蛇形大写',
         keyword: [...keyword.snake, ...keyword.upper],
+        settingsKey: 'snake_upper_case',
     },
     {
         type: SupportCase.KEBAB_CASE,
         name: '中划线(连字符/脊柱式)命名',
         shortName: '脊柱',
         keyword: [...keyword.kebab, ...keyword.lower],
+        settingsKey: 'kebab_case',
     },
     {
         type: SupportCase.KEBAB_CAMEL_CASE,
         name: '中划线(连字符/脊柱式) + 小驼峰(驼峰)命名',
         shortName: '脊柱驼峰',
         keyword: [...keyword.kebab, ...keyword.camel],
+        settingsKey: 'kebab_camel_case',
     },
     {
         type: SupportCase.KEBAB_PASCAL_CASE,
         name: '中划线(连字符/脊柱式) + 大驼峰(帕斯卡)命名',
         shortName: '脊柱帕斯卡',
         keyword: [...keyword.kebab, ...keyword.pascal],
+        settingsKey: 'kebab_pascal_case',
     },
     {
         type: SupportCase.KEBAB_UPPER_CASE,
         name: '中划线(连字符/脊柱式) + 全大写命名',
         shortName: '脊柱大写',
         keyword: [...keyword.kebab, ...keyword.upper],
+        settingsKey: 'kebab_upper_case',
     },
     {
         type: SupportCase.SPACE_CASE,
         name: '空格分隔命名',
         shortName: '脊柱',
         keyword: [...keyword.space, ...keyword.lower],
+        settingsKey: 'space_case',
     },
     {
         type: SupportCase.SPACE_CAMEL_CASE,
         name: '空格分隔 + 小驼峰(驼峰)命名',
         shortName: '脊柱驼峰',
         keyword: [...keyword.space, ...keyword.camel],
+        settingsKey: 'space_camel_case',
     },
     {
         type: SupportCase.SPACE_PASCAL_CASE,
         name: '空格分隔 + 大驼峰(帕斯卡)命名',
         shortName: '脊柱帕斯卡',
         keyword: [...keyword.space, ...keyword.pascal],
+        settingsKey: 'space_pascal_case',
     },
     {
         type: SupportCase.SPACE_UPPER_CASE,
         name: '空格分隔 + 全大写命名',
         shortName: '脊柱大写',
         keyword: [...keyword.space, ...keyword.upper],
+        settingsKey: 'space_upper_case',
     },
     {
         type: SupportCase.DOT_CASE,
         name: '点分隔命名',
         shortName: '脊柱',
         keyword: [...keyword.dot, ...keyword.lower],
+        settingsKey: 'dot_case',
     },
     {
         type: SupportCase.DOT_CAMEL_CASE,
         name: '点分隔 + 小驼峰(驼峰)命名',
         shortName: '脊柱驼峰',
         keyword: [...keyword.dot, ...keyword.camel],
+        settingsKey: 'dot_camel_case',
     },
     {
         type: SupportCase.DOT_PASCAL_CASE,
         name: '点分隔 + 大驼峰(帕斯卡)命名',
         shortName: '脊柱帕斯卡',
         keyword: [...keyword.dot, ...keyword.pascal],
+        settingsKey: 'dot_pascal_case',
     },
     {
         type: SupportCase.DOT_UPPER_CASE,
         name: '点分隔 + 全大写命名',
         shortName: '脊柱大写',
         keyword: [...keyword.dot, ...keyword.upper],
+        settingsKey: 'dot_upper_case',
     },
     {
         type: SupportCase.LOWER_CASE,
         name: '全小写',
         shortName: '小写',
         keyword: keyword.lower,
+        settingsKey: 'lower_case',
     },
     {
         type: SupportCase.UPPER_CASE,
         name: '全大写',
         shortName: '大写',
         keyword: keyword.upper,
+        settingsKey: 'upper_case',
     },
 ];
 
+export interface CyclicConvertCaseOrderItem {
+    type: SupportCase,
+    settingsKey: string,
+}
+
 /**
  * 通过快捷键循环转换的顺序
  * @since 2024-04-08
  */
-export const cyclicConvertCaseOrder = [
+export const cyclicConvertCaseOrder: Array<CyclicConvertCaseOrderItem> = [
-    SupportCase.CAMEL_CASE,
+    { type: SupportCase.CAMEL_CASE, settingsKey: 'camel_case' },
-    SupportCase.SNAKE_CASE,
+    { type: SupportCase.SNAKE_CASE, settingsKey: 'snake_case' },
-    SupportCase.PASCAL_CASE,
+    { type: SupportCase.PASCAL_CASE, settingsKey: 'pascal_case' },
-    SupportCase.KEBAB_CASE,
+    { type: SupportCase.KEBAB_CASE, settingsKey: 'kebab_case' },
-    SupportCase.SPACE_CASE,
+    { type: SupportCase.SPACE_CASE, settingsKey: 'space_case' },
-    SupportCase.DOT_CASE,
+    { type: SupportCase.DOT_CASE, settingsKey: 'dot_case' },
 
-    SupportCase.SNAKE_UPPER_CASE,
+    { type: SupportCase.SNAKE_UPPER_CASE, settingsKey: 'snake_upper_case' },
-    SupportCase.KEBAB_UPPER_CASE,
+    { type: SupportCase.KEBAB_UPPER_CASE, settingsKey: 'kebab_upper_case' },
-    SupportCase.SPACE_UPPER_CASE,
+    { type: SupportCase.SPACE_UPPER_CASE, settingsKey: 'space_upper_case' },
-    SupportCase.DOT_UPPER_CASE,
+    { type: SupportCase.DOT_UPPER_CASE, settingsKey: 'dot_upper_case' },
 
-    SupportCase.SNAKE_PASCAL_CASE,
+    { type: SupportCase.SNAKE_PASCAL_CASE, settingsKey: 'snake_pascal_case' },
-    SupportCase.KEBAB_PASCAL_CASE,
+    { type: SupportCase.KEBAB_PASCAL_CASE, settingsKey: 'kebab_pascal_case' },
-    SupportCase.SPACE_PASCAL_CASE,
+    { type: SupportCase.SPACE_PASCAL_CASE, settingsKey: 'space_pascal_case' },
-    SupportCase.DOT_PASCAL_CASE,
+    { type: SupportCase.DOT_PASCAL_CASE, settingsKey: 'dot_pascal_case' },
 
-    SupportCase.SNAKE_CAMEL_CASE,
+    { type: SupportCase.SNAKE_CAMEL_CASE, settingsKey: 'snake_camel_case' },
-    SupportCase.KEBAB_CAMEL_CASE,
+    { type: SupportCase.KEBAB_CAMEL_CASE, settingsKey: 'kebab_camel_case' },
-    SupportCase.SPACE_CAMEL_CASE,
+    { type: SupportCase.SPACE_CAMEL_CASE, settingsKey: 'space_camel_case' },
-    SupportCase.DOT_CAMEL_CASE,
+    { type: SupportCase.DOT_CAMEL_CASE, settingsKey: 'dot_camel_case' },
 
-    SupportCase.LOWER_CASE,
+    { type: SupportCase.LOWER_CASE, settingsKey: 'lower_case' },
-    SupportCase.UPPER_CASE,
+    { type: SupportCase.UPPER_CASE, settingsKey: 'upper_case' },
 ];

src/extension.ts

@@ -1,12 +1,23 @@
-// The module 'vscode' contains the VS Code extensibility API
+/**
-// Import the module and reference it with the alias vscode in your code below
+ * @file extension.ts
+ * @description 该文件包含了 VS Code 插件的主要扩展逻辑，包括命令注册、菜单配置和编辑器事件监听等。
+ * @author coder-xiaomo
+ * @version 1.0.0
+ * @license MIT
+ *
+ * 本文件是插件的核心文件，负责扩展命令的注册以及编辑器中各种事件的处理。通过监听编辑器的选择状态，
+ * 动态更新命令行为。插件在启动时会初始化必要的命令，并根据编辑器状态决定是否启用相关功能。
+ *
+ * @see https://code.visualstudio.com/api
+ */
 import * as vscode from 'vscode';
-import handleEditorReplace from './extension-handler/editor-submenu-handler';
+import handleEditorReplace from './handler/editor-submenu-handler';
-import { handleQuickPick } from './extension-handler/quick-pick-handler';
+import { handleQuickPick } from './handler/quick-pick-handler';
-import { commands } from './type-definition/SupportCaseType';
+import { commands } from './core/variable-convert/types/SupportCaseType';
-import { createStatusBarItem, updateStatusBarItemVisable } from './extension-handler/status-bar-handler';
+import { createStatusBarItem, updateStatusBarItemVisable } from './handler/status-bar-handler';
-import * as CyclicConversion from './main-code/cyclic-conversion';
+import * as CyclicConversion from './core/variable-convert/cyclic-conversion';
-import { EOL } from './type-definition/EOLType';
+import { EOL } from './types/EOLType';
+import { getUserConfigurations } from './utils/user-configuration';
 
 // This method is called when your extension is activated
 // Your extension is activated the very first time the command is executed
@@ -41,6 +52,14 @@ export function activate(context: vscode.ExtensionContext) {
 		// 更新 _textSelectionLength (用于判断是否展示右键菜单)
 		vscode.commands.executeCommand('setContext', '_textSelectionLength', selectTextLength);
 
+		// issue: #1 https://github.com/coder-xiaomo/variable-conversion-vscode-extension/issues/1
+		// 获取用户配置
+		const disableFormatList = getUserConfigurations<Array<string>>('disableFormat') || [];
+		// 更新右键菜单每一项是否展示
+		for (const { settingsKey } of commands) {
+			vscode.commands.executeCommand('setContext', '_isHideSubMenuItem_' + settingsKey, disableFormatList.includes(settingsKey));
+		}
+
 		// 判断是否展示状态栏按钮
 		updateStatusBarItemVisable(selectTextLength);
 

src/handler/editor-submenu-handler.ts

@@ -1,8 +1,8 @@
 import * as vscode from 'vscode';
-import { EOL } from '../type-definition/EOLType';
+import { EOL } from '../types/EOLType';
-import { caseConversion } from '../main-code/conversion';
+import { caseConversion } from '../core/variable-convert/conversion';
-import { SupportCase } from '../type-definition/SupportCaseType';
+import { SupportCase } from '../core/variable-convert/types/SupportCaseType';
-import { isStringArrayEqual } from '../main-code/utils';
+import { isStringArrayEqual } from '../utils/utils';
 
 /**
  * 编辑器右键菜单

src/handler/quick-pick-handler.ts

@@ -1,11 +1,12 @@
 import * as vscode from 'vscode';
-import QuickPickItemEx from "../type-definition/QuickPickItemExType";
+import QuickPickItemEx from "./types/QuickPickItemExType";
-import { quickPickSupportCases } from '../type-definition/SupportCaseType';
+import { QuickPickSupportCaseItem, quickPickSupportCases } from '../core/variable-convert/types/SupportCaseType';
-import { TransformTextResult } from '../type-definition/TransformTextResultType';
+import { TransformTextResult } from '../types/TransformTextResultType';
-import { transformMutliLineText, transformMutliSelectionText } from '../main-code/transform';
+import { transformMutliSelectionText } from '../utils/transform';
-import { EOL } from '../type-definition/EOLType';
+import { EOL } from '../types/EOLType';
-import { caseConversion } from '../main-code/conversion';
+import { caseConversion } from '../core/variable-convert/conversion';
-import { isStringArrayEqual } from '../main-code/utils';
+import { isStringArrayEqual } from '../utils/utils';
+import { getUserConfigurations } from '../utils/user-configuration';
 
 const QuickPickLabelMaxLength = 60;
 
@@ -18,12 +19,12 @@ interface RecommendItem {
 /**
  * 弹出的提示
  */
-function generateOptionsBasedOnText(textList: string[], eol: EOL): Array<QuickPickItemEx> {
+function generateOptionsBasedOnText(textList: string[], eol: EOL, enabledQuickPickSupportCases: Array<QuickPickSupportCaseItem>): Array<QuickPickItemEx> {
     // Cut text 切割文本
     const resultsList: Array<TransformTextResult[]> = transformMutliSelectionText(textList);
 
     const mergeResultList: Array<RecommendItem> = [];
-    for (const quickPick of quickPickSupportCases) {
+    for (const quickPick of enabledQuickPickSupportCases) {
         const conversionResults: Array<string> = [];
         for (let i = 0; i < textList.length; i++) {
             const text = textList[i];
@@ -95,8 +96,24 @@ export function handleQuickPick() {
         return;
     }
 
+    // issue: #1 https://github.com/coder-xiaomo/variable-conversion-vscode-extension/issues/1
+    // 获取用户配置
+    const disableFormatList = getUserConfigurations<Array<string>>('disableFormat') || [];
+    // 排除禁用的选项
+    const enabledQuickPickSupportCases = [];
+    for (const quickPick of quickPickSupportCases) {
+        if (disableFormatList.includes(quickPick.settingsKey)) {
+            continue;
+        }
+        enabledQuickPickSupportCases.push(quickPick);
+    }
+    if (enabledQuickPickSupportCases.length === 0) {
+        vscode.window.showInformationMessage('所有格式都已被配置为禁用，请修改配置 `variable-conversion.disableFormat` 后重试\nAll formats have been configured to disable. Modify the `variable-conversion.disableFormat` configuration and try again.');
+        return;
+    }
+
     // 基于选中的文本生成选项
-    const options = generateOptionsBasedOnText(textList, eol);
+    const options = generateOptionsBasedOnText(textList, eol, enabledQuickPickSupportCases);
     if (options.length === 0) {
         vscode.window.showInformationMessage('所选内容暂无可选转换，请尝试重新选择\nNo conversion candidates are available for the selected content, please try to select another text.');
         return;

src/test/extension.test.ts

@@ -3,12 +3,12 @@ import * as assert from 'assert';
 // You can import and use all API from the 'vscode' module
 // as well as import your extension to test it
 import * as vscode from 'vscode';
-import testGroups from './test-case';
+import { pathConvertTestGroups } from './test-case/path-convert-test-case';
-import { TestCase, TestCaseGroup } from '../type-definition/TestCaseType';
+import { TestCase, TestCaseGroup } from './test-case/types/TestCaseType';
-import { transformMutliLineText, transformText } from '../main-code/transform';
+import { transformMutliLineText, transformText } from '../utils/transform';
-import { caseConversion } from '../main-code/conversion';
+import { caseConversion } from '../core/variable-convert/conversion';
-import { SupportCase } from '../type-definition/SupportCaseType';
+import { SupportCase } from '../core/variable-convert/types/SupportCaseType';
-import { TransformTextResult } from '../type-definition/TransformTextResultType';
+import { TransformTextResult } from '../types/TransformTextResultType';
 // import * as myExtension from '../../extension';
 
 /*
@@ -22,10 +22,15 @@ suite('Extension Test Suite', () => {
 });
  */
 
-suite('Extension Test: run test case', () => {
+/**
+ * 变量转换 测试函数
+ *
+ * @since 2024-04-02
+ */
+suite('Extension Test: run variable convert test case', () => {
 	vscode.window.showInformationMessage('Start all tests.');
 
-	const groups: Array<TestCaseGroup> = testGroups;
+	const groups: Array<TestCaseGroup> = pathConvertTestGroups;
 	for (const testGroup of groups) {
 		const testTitle = testGroup.testTitle;
 		const testCases: Array<TestCase> = testGroup.cases;

src/test/test-case/path-convert-test-case.ts

@@ -1,9 +1,9 @@
-import { TestCaseGroup } from "../type-definition/TestCaseType";
+import { TestCaseGroup } from "./types/TestCaseType";
 
 const LF = '\n';
 const CRLF = '\r\n';
 
-const testGroups: Array<TestCaseGroup> = [
+export const pathConvertTestGroups: Array<TestCaseGroup> = [
     {
         group: 'Input validation',
         testTitle: 'Input validation (输入有效性验证)',
@@ -1095,5 +1095,3 @@ const testGroups: Array<TestCaseGroup> = [
     },
     // add more cases...
 ];
-
-export default testGroups;

src/test/test-case/types/TestCaseType.ts

@@ -1,4 +1,4 @@
-import { EOL } from "./EOLType";
+import { EOL } from "../../../types/EOLType";
 
 export type TestCaseGroup = {
     group: string

src/utils/transform.ts

@@ -1,4 +1,4 @@
-import { TransformTextResult } from "../type-definition/TransformTextResultType";
+import { TransformTextResult } from "../types/TransformTextResultType";
 
 const logDebugInfo = false;
 

src/utils/user-configuration.ts

@@ -0,0 +1,20 @@
+import vscode from 'vscode';
+
+/**
+ * 获取用户配置项
+ *
+ * @param configKey 配置项的键
+ * @returns 配置项的值
+ * @since 2024-07-29
+ */
+function getUserConfigurations<T>(configKey: string): T | undefined {
+    const config = vscode.workspace.getConfiguration('variable-conversion');
+
+    const configValue = config.get<T>(configKey);
+    // console.log('configValue:', configValue);
+    return configValue;
+}
+
+export {
+    getUserConfigurations
+};

src/utils/utils.ts

@@ -1,3 +1,11 @@
+/**
+ * 比较两个字符串数组 `Array<string>` 是否相同
+ *
+ * @param array1 数组1
+ * @param array2 数组2
+ * @returns
+ * @since 2024-04-09
+ */
 export function isStringArrayEqual(array1: string[], array2: string[]) {
     if (array1.length !== array2.length) {
         return false;
@@ -12,6 +20,15 @@ export function isStringArrayEqual(array1: string[], array2: string[]) {
     return true;
 }
 
+/**
+ * 去除二维字符串数组中的重复数组元素
+ *
+ * 例如，输入 [["a", "b"], ["a", "b"], ["c", "d"]]，会返回 [[ "a", "b"], ["c", "d"]]，去除了重复出现的 ["a", "b"]。
+ *
+ * @param stringArr 要进行去重操作的二维字符串数组，即数组中每个元素又是一个字符串数组，代表一组相关的字符串元素集合。
+ * @returns 返回一个二维字符串数组，其中已经去除了原输入二维数组中重复的元素组合，基于JSON序列化后的字符串比较来判定重复与否。
+ * @since 2024-04-09
+ */
 export function stringListArrayDuplicateRemoval(stringArr: Array<string[]>): Array<string[]> {
     const tempArr: Array<string> = [];
     const newArr: Array<string[]> = [];