Skip to content

Extend @kanopi/pack support for Vue projects

License

Notifications You must be signed in to change notification settings

kanopi/kanopi-pack-vue

Repository files navigation

Kanopi Pack - Vue Support

The Kanopi Pack Vue module adds support to Webpack for Vue development and linting. Vue and associated libraries are NOT included in this package. The intent is for each front-end application to select the appropriate version (Vue 2.x or 3.x) for their use case.

Vue 2.x Support

In order to support Vue 2.x, the vue-loader is locked at 15.x. Please note when installing vue and vue-template-compiler for version 2 that they match versions, i.e. vue@2.6.14 and vue-template-compiler@2.6.14.

Linting Support

The ESLint parser vue-eslint-parser and associated plugin eslint-plugin-vue are included in this package, and can be combined with either the core Babel or Typescript parsers included in Kanopi Pack.

To enable linting within Vue SFC (Single-File Component) files, you need to add the extension in your Kanopi Pack configuration, i.e.

    ...
    "scripts": {
        ...
        "esLintFileTypes": "js,ts,vue" // This assumes the project also has both JS and TS files
        ...
    }
    ...

ESLint configurations are scoped within a particular directory. If you place all of your Vue apps in the ./assets/src/vue folder, create an .eslintrc.js file there.

Here is an example configuration to lint all scripts included different types of script blocks within Vue SFCs:

module.exports = {
    "root": true,
    "extends": [
        "plugin:@typescript-eslint/recommended",
        "plugin:vue/recommended",
    ],
    "env": {
        "browser": true,
        "node": true
    },
    "parser": "vue-eslint-parser",
    "parserOptions": {
        "parser": {
            "js": "espree",
            "ts": "@typescript-eslint/parser",
            "template": "espree"
        },
        "requireConfigFile": false,
        "sourceType": "module"
    },
    "plugins": [
        "@typescript-eslint",
        "vue"
    ],
    "rules": {
        "indent": ["error", "tab"]
    }
}

Package Version Notes

Package Version Limit Reason
chalk 4.x Version 5.x forward are ESM based, which is not easily compatible, staying on 4.x for CommonJS support
vue-loader 15.x Limited to support version 2.x of Vue; anything past this breaks Vue 2.x support