package.json

{
  "name": "mini-typescript-hero",
  "displayName": "Mini TypeScript Hero",
  "description": "Sorts and organizes TypeScript/JavaScript imports — Keep your codebase clean with custom import grouping, automatic cleanup, and smart formatting. Small hero. Big cleanup!",
  "version": "4.0.1",
  "publisher": "angular-schule",
  "icon": "icon.png",
  "galleryBanner": {
    "color": "#ffffff",
    "theme": "light"
  },
  "author": {
    "name": "Johannes Hoppe",
    "email": "team@angular.schule",
    "url": "https://angular.schule"
  },
  "license": "MIT",
  "repository": {
    "type": "git",
    "url": "https://github.com/angular-schule/mini-typescript-hero"
  },
  "homepage": "https://github.com/angular-schule/mini-typescript-hero",
  "bugs": {
    "url": "https://github.com/angular-schule/mini-typescript-hero/issues"
  },
  "keywords": [
    "typescript",
    "javascript",
    "imports",
    "organize",
    "sort",
    "formatter"
  ],
  "engines": {
    "vscode": "^1.104.0",
    "node": ">=18.0.0"
  },
  "categories": [
    "Formatters",
    "Programming Languages"
  ],
  "activationEvents": [
    "onLanguage:typescript",
    "onLanguage:typescriptreact",
    "onLanguage:javascript",
    "onLanguage:javascriptreact"
  ],
  "main": "./dist/extension.js",
  "contributes": {
    "commands": [
      {
        "command": "miniTypescriptHero.imports.organize",
        "title": "Mini TS Hero: Organize imports (sort and remove unused)"
      },
      {
        "command": "miniTypescriptHero.imports.organizeWorkspace",
        "title": "Mini TS Hero: Organize imports in workspace",
        "description": "Organize imports in all TypeScript and JavaScript files (.ts, .tsx, .js, .jsx) in the workspace"
      },
      {
        "command": "miniTypescriptHero.imports.organizeFolder",
        "title": "Mini TS Hero: Organize imports in folder",
        "description": "Organize imports in all TypeScript and JavaScript files (.ts, .tsx, .js, .jsx) in the selected folder"
      },
      {
        "command": "miniTypescriptHero.checkConflicts",
        "title": "Mini TS Hero: Check for configuration conflicts"
      },
      {
        "command": "miniTypescriptHero.toggleLegacyMode",
        "title": "Mini TS Hero: Toggle legacy mode"
      }
    ],
    "menus": {
      "explorer/context": [
        {
          "command": "miniTypescriptHero.imports.organizeFolder",
          "when": "explorerResourceIsFolder",
          "group": "1_modification"
        }
      ],
      "commandPalette": [
        {
          "command": "miniTypescriptHero.imports.organizeFolder",
          "when": "false"
        }
      ]
    },
    "keybindings": [
      {
        "command": "miniTypescriptHero.imports.organize",
        "key": "ctrl+alt+o",
        "when": "editorTextFocus && editorLangId =~ /^(typescript|typescriptreact|javascript|javascriptreact)$/ && !editorReadonly"
      },
      {
        "command": "miniTypescriptHero.imports.organize",
        "key": "cmd+alt+o",
        "mac": "cmd+alt+o",
        "when": "editorTextFocus && editorLangId =~ /^(typescript|typescriptreact|javascript|javascriptreact)$/ && !editorReadonly"
      }
    ],
    "configuration": {
      "title": "Mini TypeScript Hero",
      "properties": {
        "miniTypescriptHero.imports.insertSpaceBeforeAndAfterImportBraces": {
          "type": "boolean",
          "default": true,
          "description": "Defines if there should be a space inside the curly braces of an import statement.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.removeTrailingIndex": {
          "type": "boolean",
          "default": true,
          "description": "Defines if a trailing '/index' should be removed from imports.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.insertSemicolons": {
          "type": "boolean",
          "default": true,
          "description": "Defines if there should be a semicolon at the end of a statement. Fallback setting - respects VSCode 'typescript.format.semicolons' and 'javascript.format.semicolons' first.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.stringQuoteStyle": {
          "enum": [
            "'",
            "\""
          ],
          "default": "'",
          "description": "Defines if single or double quotes should be used. Fallback setting - respects VSCode 'typescript.preferences.quoteStyle' and 'javascript.preferences.quoteStyle' first.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.multiLineWrapThreshold": {
          "type": "number",
          "minimum": 1,
          "multipleOf": 1,
          "default": 125,
          "description": "Defines the threshold when an import should be wrapped into a multiline import.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.multiLineTrailingComma": {
          "type": "boolean",
          "default": true,
          "description": "Defines if multiline imports contain the last trailing comma.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.organizeOnSave": {
          "type": "boolean",
          "default": false,
          "description": "Defines if the imports should be organized on save.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.organizeSortsByFirstSpecifier": {
          "type": "boolean",
          "default": false,
          "description": "Defines if the imports are organized by first specifier/alias instead of module path. NOTE: This setting has no effect when disableImportsSorting is true (sorting is disabled) or when legacyMode is true (legacy mode always sorts by library name).",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.disableImportsSorting": {
          "type": "boolean",
          "default": false,
          "description": "Defines if sorting is disabled during organize imports. NOTE: This setting has no effect when legacyMode is true (legacy mode always sorts within groups).",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.disableImportRemovalOnOrganize": {
          "type": "boolean",
          "default": false,
          "description": "Defines if any imports should be removed at all on an organize imports command.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.mergeImportsFromSameModule": {
          "type": "boolean",
          "default": true,
          "description": "Merge multiple import statements from the same module into a single import. For example, 'import { A } from \"./lib\"' and 'import { B } from \"./lib\"' become 'import { A, B } from \"./lib\"'. This setting is independent from removal behavior.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.excludePatterns": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "uniqueItems": true,
          "default": [],
          "markdownDescription": "Additional glob patterns for files to exclude from import organization (workspace and single-file operations). These patterns are added to the built-in defaults: `**/node_modules/**`, `**/dist/**`, `**/build/**`, `**/out/**`, `**/.git/**`, `**/coverage/**`.\n\nCommon examples:\n- `**/.next/**` (Next.js build output)\n- `**/.nuxt/**` (Nuxt build output)\n- `**/tmp/**` (temporary files)\n- `**/generated/**` (auto-generated code)\n\n**Team collaboration:** When organizing a single file that matches an exclude pattern, a warning is shown to inform the user.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.ignoredFromRemoval": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "uniqueItems": true,
          "default": [
            "react"
          ],
          "description": "Defines imports (libraries, so the 'from' part), which are not removed during 'organize imports'.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.legacyMode": {
          "type": "boolean",
          "default": false,
          "description": "Enable full legacy mode for formatting compatibility with old TypeScript Hero extension (with documented exceptions for crashes and edge cases). When true: replicates old formatting behaviors (within-group sorting bug, preserve blank lines, merge-before-removeTrailingIndex timing, type-only merge). When false: modern best practices (correct sorting, 1 blank line, correct merge timing, type-only separation). Migrated users get 'true' automatically.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.tabSize": {
          "type": "number",
          "minimum": 1,
          "default": 2,
          "markdownDescription": "**Only used when `useOnlyExtensionSettings` is true.** Otherwise, VS Code `editor.tabSize` is always used.\n\n**VS Code always has a value** for `editor.tabSize` (default: 4 spaces). Modern mode overrides this to 2 spaces when VS Code is at its default value.\n\n**Note:** VS Code automatically reads `editor.tabSize` from `.editorconfig` files (if EditorConfig extension is installed). We read the final resolved value, so EditorConfig integration works automatically.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.insertSpaces": {
          "type": "boolean",
          "default": true,
          "markdownDescription": "**Only used when `useOnlyExtensionSettings` is true.** Otherwise, VS Code `editor.insertSpaces` is always used.\n\n**VS Code always has a value** for `editor.insertSpaces` (default: true).\n\n**Note:** VS Code automatically reads `editor.insertSpaces` from `.editorconfig` files (if EditorConfig extension is installed). We read the final resolved value, so EditorConfig integration works automatically.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.useOnlyExtensionSettings": {
          "type": "boolean",
          "default": false,
          "markdownDescription": "When enabled, ignores VS Code settings and uses only Mini TypeScript Hero extension settings for all formatting options (quotes, semicolons, indentation).\n\n**Use case:** Enforce consistent import formatting across all team members regardless of their editor configuration.",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.blankLinesAfterImports": {
          "enum": [
            "one",
            "two",
            "preserve"
          ],
          "default": "one",
          "description": "Number of blank lines after the last import before code starts. 'one' = exactly 1 (Google/ESLint/Prettier standard), 'two' = exactly 2, 'preserve' = keep existing blank lines. NOTE: This setting has no effect when legacyMode is true (legacy mode always uses 'preserve' behavior).",
          "scope": "resource"
        },
        "miniTypescriptHero.imports.grouping": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "enum": [
                  "Modules",
                  "Plains",
                  "Workspace",
                  "Remaining"
                ]
              },
              {
                "type": "string",
                "pattern": "^/.+/[dgimsuyv]*$",
                "description": "Regex pattern for custom grouping (e.g., '/^@angular/', '/rxjs/', etc.)"
              },
              {
                "type": "object",
                "properties": {
                  "identifier": {
                    "anyOf": [
                      {
                        "enum": [
                          "Modules",
                          "Plains",
                          "Workspace",
                          "Remaining"
                        ]
                      },
                      {
                        "type": "string",
                        "pattern": "^/.+/[dgimsuyv]*$",
                        "description": "Regex pattern (e.g., '/^@angular/')"
                      }
                    ]
                  },
                  "order": {
                    "enum": [
                      "asc",
                      "desc"
                    ]
                  }
                },
                "additionalProperties": false,
                "required": [
                  "identifier",
                  "order"
                ]
              }
            ]
          },
          "default": [
            "Plains",
            "Modules",
            "Workspace"
          ],
          "description": "Defines the groups of imports and their order. Possible values are \"Modules\" (for library imports), \"Plains\" (for string-only imports), \"Workspace\" (for local imports), \"Remaining\" (catch-all) or a regex pattern (enclosed in forward slashes). You can also specify an object with \"identifier\" and \"order\" (asc/desc).",
          "scope": "resource"
        }
      }
    }
  },
  "scripts": {
    "vscode:prepublish": "npm run package",
    "compile": "npm run check-types && npm run lint && node esbuild.js",
    "watch": "npm-run-all -p watch:*",
    "watch:esbuild": "node esbuild.js --watch",
    "watch:tsc": "tsc --noEmit --watch --project tsconfig.json",
    "package": "npm run check-types && npm run lint && node esbuild.js --production",
    "compile-tests": "tsc -p . --outDir out",
    "watch-tests": "tsc -p . -w --outDir out",
    "clean": "rm -rf out",
    "pretest": "npm run clean && npm run compile-tests && node esbuild.js && npm run lint",
    "check-types": "tsc --noEmit",
    "lint": "eslint \"src/**/*.ts\"",
    "test": "vscode-test",
    "test:comparison": "cd tests/comparison && npm test",
    "test:all": "npm test && npm run test:comparison",
    "vsix": "vsce package"
  },
  "devDependencies": {
    "@types/mocha": "^10.0.10",
    "@types/node": "22.x",
    "@types/vscode": "^1.104.0",
    "@typescript-eslint/eslint-plugin": "^8.45.0",
    "@typescript-eslint/parser": "^8.45.0",
    "@vscode/test-cli": "^0.0.11",
    "@vscode/test-electron": "^2.5.2",
    "@vscode/vsce": "^3.7.1",
    "esbuild": "^0.25.10",
    "eslint": "^9.36.0",
    "npm-run-all": "^4.1.5",
    "typescript": "^5.9.3"
  },
  "dependencies": {
    "minimatch": "^10.1.1",
    "ts-morph": "^27.0.0"
  }
}