@nextcloud/eslint-config 9.0.0-rc.0 → 9.0.0-rc.10

package/dist/configs/node.js

@@ -0,0 +1,24 @@
+import globals from 'globals';
+import { GLOB_FILES_TESTING } from "../globs.js";
+/**
+ * Config setup for the node environment.
+ * Config files should be parsed as Node.JS scripts with Node globals etc.
+ */
+export const node = [
+    {
+        name: 'nextcloud/node/setup',
+        files: [
+            '**/*.config.*',
+            '**/*.cjs',
+            '**/*.cts',
+            ...GLOB_FILES_TESTING,
+        ],
+        languageOptions: {
+            globals: {
+                ...globals.es2023,
+                ...globals.node,
+                ...globals.nodeBuiltin,
+            },
+        },
+    },
+];

package/dist/configs/typescript.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+import type { Linter } from 'eslint';
+import type { ConfigOptions } from '../types.d.ts';
+/**
+ * Typescript related ESLint rules for Nextcloud
+ *
+ * @param options options defining the config preset flavor
+ */
+export declare function typescript(options: ConfigOptions): Linter.Config[];

package/dist/configs/typescript.js

@@ -0,0 +1,60 @@
+import typescriptPlugin from 'typescript-eslint';
+import { GLOB_FILES_TESTING, GLOB_FILES_TYPESCRIPT, GLOB_FILES_TYPESCRIPT_DECLARATIONS, GLOB_FILES_VUE, } from "../globs.js";
+import { restrictConfigFiles } from "../utils.js";
+/**
+ * Typescript related ESLint rules for Nextcloud
+ *
+ * @param options options defining the config preset flavor
+ */
+export function typescript(options) {
+    return [
+        ...restrictConfigFiles(typescriptPlugin.configs.recommended, [
+            ...GLOB_FILES_TYPESCRIPT,
+            ...(options.vueIsTypescript ? GLOB_FILES_VUE : []),
+        ]),
+        {
+            name: 'nextcloud/typescript/rules',
+            files: [
+                ...GLOB_FILES_TYPESCRIPT,
+                ...(options.vueIsTypescript ? GLOB_FILES_VUE : []),
+            ],
+            rules: {
+                // Do not allow to import types with `import` but require `import type`
+                '@typescript-eslint/consistent-type-imports': 'error',
+                // Allow expect-error as we can sometimes not prevent it...
+                '@typescript-eslint/ban-ts-comment': [
+                    'error',
+                    {
+                        'ts-expect-error': 'allow-with-description',
+                        minimumDescriptionLength: 9,
+                    },
+                ],
+                // No nullish coalescing if left side can not be nullish
+                '@typescript-eslint/no-non-null-asserted-nullish-coalescing': 'error',
+                // Do not use types, variables etc before they are defined
+                'no-use-before-define': 'off',
+                '@typescript-eslint/no-use-before-define': [
+                    'error',
+                    {
+                        functions: false,
+                    },
+                ],
+            },
+        },
+        {
+            name: 'nextcloud/typescript/declaration-rules',
+            files: [...GLOB_FILES_TYPESCRIPT_DECLARATIONS],
+            rules: {
+                '@typescript-eslint/consistent-type-imports': ['error', { disallowTypeAnnotations: false }],
+            },
+        },
+        {
+            files: GLOB_FILES_TESTING,
+            rules: {
+                // Allow "any" in tests
+                '@typescript-eslint/no-explicit-any': 'off',
+            },
+            name: 'nextcloud/typescript/test-rules',
+        },
+    ];
+}

package/dist/configs/vue.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+import type { Linter } from 'eslint';
+import type { ConfigOptions } from '../types.d.ts';
+/**
+ * General vue related rules for both versions
+ *
+ * @param options options defining the config preset flavor
+ */
+export declare function vue(options: ConfigOptions): Linter.Config[];

package/dist/configs/vue.js

@@ -0,0 +1,158 @@
+import vuePlugin from 'eslint-plugin-vue';
+import { GLOB_FILES_JAVASCRIPT, GLOB_FILES_TYPESCRIPT, GLOB_FILES_VUE, } from "../globs.js";
+import { nextcloudPlugin } from "../index.js";
+import { codeStyle } from "./codeStyle.js";
+const stylisticRules = codeStyle({
+    isLibrary: false,
+    vueIsTypescript: false,
+}).reduce((rules, config) => ({
+    ...rules,
+    ...(config.rules ?? {}),
+}), {});
+const vueStylisticRules = Object.keys(vuePlugin.rules)
+    .filter((rule) => `@stylistic/${rule}` in stylisticRules)
+    .map((rule) => [
+    `vue/${rule}`,
+    stylisticRules[`@stylistic/${rule}`],
+]);
+/**
+ * General vue related rules for both versions
+ *
+ * @param options options defining the config preset flavor
+ */
+export function vue(options) {
+    return [
+        ...(options.vueIsTypescript
+            ? [
+                {
+                    languageOptions: {
+                        parserOptions: {
+                            parser: '@typescript-eslint/parser',
+                        },
+                    },
+                },
+            ]
+            : []),
+        {
+            files: GLOB_FILES_VUE,
+            name: 'nextcloud/vue/rules',
+            rules: {
+                // PascalCase components names in template tag names
+                'vue/component-name-in-template-casing': ['error', 'PascalCase'],
+                // Also in registration
+                'vue/component-options-name-casing': ['error', 'PascalCase'],
+                // space before self-closing elements
+                'vue/html-closing-bracket-spacing': 'error',
+                // no ending html tag on a new line
+                'vue/html-closing-bracket-newline': [
+                    'error',
+                    {
+                        multiline: 'never',
+                    },
+                ],
+                // Enforce documentation of properties
+                'vue/require-prop-comment': options.isLibrary
+                    ? [
+                        'error',
+                        {
+                            type: 'JSDoc',
+                        },
+                    ]
+                    : 'off',
+                // When a prop allows Boolean and some other type, then Boolean should come first to allow short-hand properties
+                'vue/prefer-prop-type-boolean-first': 'error',
+                // Prevent useless string interpolation where not needed
+                'vue/no-useless-mustaches': 'error',
+                // If there is a default then it is not required - this is either way a bug
+                'vue/no-required-prop-with-default': 'error',
+                // Omit empty blocks
+                'vue/no-empty-component-block': 'error',
+                // Boolean properties should behave like HTML properties
+                'vue/no-boolean-default': [
+                    'warn',
+                    'default-false',
+                ],
+                // Allow 3 attributes on the same line if singe line
+                'vue/max-attributes-per-line': [
+                    'error',
+                    {
+                        singleline: {
+                            max: 3,
+                        },
+                    },
+                ],
+                // Component names should match their export names - readability and maintainability ("where does this component come from?")
+                'vue/match-component-import-name': 'error',
+                'vue/match-component-file-name': 'error',
+                // Prevent useless v-bind like `<foo :bar="'bar'"/>`
+                'vue/no-useless-v-bind': 'error',
+                // Warn on undefined components - we need this on warning level as long as people use mixins (then we can move to error)
+                'vue/no-undef-components': [
+                    'warn',
+                    {
+                        // Ignore the router link and view as this is (most often) globally registered
+                        ignorePatterns: ['RouterLink', 'RouterView'],
+                    },
+                ],
+                // Warn on unused refs
+                'vue/no-unused-refs': 'warn',
+                // Warn on unused props
+                'vue/no-unused-properties': 'warn',
+                // This rule does not work in vue files, we must use the vue one
+                'no-irregular-whitespace': 'off',
+                'vue/no-irregular-whitespace': 'error',
+            },
+        },
+        {
+            files: GLOB_FILES_VUE,
+            name: 'nextcloud/vue/stylistic-rules',
+            rules: {
+                // same as the stylistic rules but for the <template> in Vue files
+                ...Object.fromEntries(vueStylisticRules),
+                // same as in the codeStyle config but for the <template> in Vue files
+                '@nextcloud/l10n-non-breaking-space': 'error',
+                '@nextcloud/l10n-enforce-ellipsis': 'error',
+                // Also enforce tabs for template
+                'vue/html-indent': [
+                    'error',
+                    'tab',
+                ],
+                // Consistent style of props
+                'vue/new-line-between-multi-line-property': 'error',
+                // Add consistent padding between blocks
+                'vue/padding-line-between-blocks': 'error',
+                // Prefer separated static and dynamic class attributes
+                'vue/prefer-separate-static-class': 'error',
+                // For consistent layout of components
+                'vue/define-macros-order': [
+                    'error',
+                    {
+                        order: [
+                            'defineOptions',
+                            'defineModel',
+                            'defineProps',
+                            'defineEmits',
+                            'defineSlots',
+                            'defineExpose',
+                        ],
+                    },
+                ],
+            },
+        },
+        {
+            files: [
+                ...GLOB_FILES_JAVASCRIPT,
+                ...GLOB_FILES_TYPESCRIPT,
+                ...GLOB_FILES_VUE,
+            ],
+            plugins: {
+                '@nextcloud': nextcloudPlugin,
+            },
+            rules: {
+                '@nextcloud/no-deprecated-library-exports': 'error',
+                '@nextcloud/no-deprecated-library-props': 'error',
+            },
+            name: 'nextcloud/vue/migration-rules',
+        },
+    ];
+}

package/dist/configs/vue2.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+import type { Linter } from 'eslint';
+import type { ConfigOptions } from '../types.d.ts';
+/**
+ * Vue2 related ESLint rules for Nextcloud
+ *
+ * @param option options defining the config preset flavor
+ */
+export declare function vue2(option: ConfigOptions): Linter.Config[];

package/dist/configs/vue2.js

@@ -0,0 +1,30 @@
+import vuePlugin from 'eslint-plugin-vue';
+import { GLOB_FILES_VUE } from "../globs.js";
+import { restrictConfigFiles } from "../utils.js";
+import { vue } from "./vue.js";
+/**
+ * Vue2 related ESLint rules for Nextcloud
+ *
+ * @param option options defining the config preset flavor
+ */
+export function vue2(option) {
+    return [
+        ...restrictConfigFiles(vuePlugin.configs['flat/vue2-recommended'], GLOB_FILES_VUE),
+        ...vue(option),
+        {
+            rules: {
+                // Force kebab-case for custom event name definitions (recommended by Vue 2 documentation)
+                'vue/custom-event-name-casing': [
+                    'error',
+                    'kebab-case',
+                    {
+                        // Allow namespace formats namespace:event
+                        ignores: ['/^[a-z]+(?:-[a-z]+)*:[a-z]+(?:-[a-z]+)*$/u'],
+                    },
+                ],
+            },
+            files: GLOB_FILES_VUE,
+            name: 'nextcloud/vue2/rules',
+        },
+    ];
+}

package/dist/configs/vue3.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+import type { Linter } from 'eslint';
+import type { ConfigOptions } from '../types.d.ts';
+/**
+ * Vue3 related ESLint rules for Nextcloud
+ *
+ * @param options options defining the config preset flavor
+ */
+export declare function vue3(options: ConfigOptions): Linter.Config[];

package/dist/configs/vue3.js

@@ -0,0 +1,48 @@
+/*!
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+import vuePlugin from 'eslint-plugin-vue';
+import { GLOB_FILES_VUE } from "../globs.js";
+import { restrictConfigFiles } from "../utils.js";
+import { vue } from "./vue.js";
+/**
+ * Vue3 related ESLint rules for Nextcloud
+ *
+ * @param options options defining the config preset flavor
+ */
+export function vue3(options) {
+    return [
+        ...restrictConfigFiles(vuePlugin.configs['flat/recommended'], GLOB_FILES_VUE),
+        ...vue(options),
+        // Vue3 specific overrides
+        {
+            files: GLOB_FILES_VUE,
+            rules: {
+                // Force camelCase in props/attrs for consistency with <script> and prevent tooling issues
+                'vue/attribute-hyphenation': ['error', 'never'],
+                // Force camelCase for custom event name definitions (recommended by Vue 3 documentation and consistent with JS)
+                'vue/custom-event-name-casing': [
+                    'error',
+                    'camelCase',
+                    {
+                        // Allow namespace formats namespace:event
+                        ignores: ['/^[a-z]+:[a-z]+$/iu'],
+                    },
+                ],
+                // Force camelCase for events in template for consistency with <script>
+                'vue/v-on-event-hyphenation': ['error', 'never', { autofix: true }],
+                // Force camelCase for slot names.
+                // Changing case is breaking for component users.
+                // For libraries it may result in a breaking change. Warn to prevent unintended breaking change.
+                // TODO: allow namespace:slotName format like in events
+                'vue/slot-name-casing': [options.isLibrary ? 'warn' : 'error', 'camelCase'],
+                // Deprecated thus we should not use it
+                'vue/no-deprecated-delete-set': 'error',
+                // When using script-setup the modern approach should be used
+                'vue/prefer-define-options': 'error',
+            },
+            name: 'nextcloud/vue3/rules',
+        },
+    ];
+}

package/dist/globs.d.ts

@@ -0,0 +1,20 @@
+/*!
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+/** Glob pattern for test files (specs) */
+export declare const GLOB_FILES_TESTING: string[];
+/** Glob pattern for Typescript files */
+export declare const GLOB_FILES_TYPESCRIPT: string[];
+/** Glob pattern for Typescript declaration files */
+export declare const GLOB_FILES_TYPESCRIPT_DECLARATIONS: string[];
+/** Glob pattern for Javascript files */
+export declare const GLOB_FILES_JAVASCRIPT: string[];
+/** Glob pattern for JSON files */
+export declare const GLOB_FILES_JSON: string[];
+/** Glob pattern for JSONC files */
+export declare const GLOB_FILES_JSONC: string[];
+/** Glob pattern for Microsoft JSON files which use a slightly different JSONC implementation */
+export declare const GLOB_FILES_MS_JSON: string[];
+/** Glob pattern for Vue.JS files */
+export declare const GLOB_FILES_VUE: string[];

package/dist/globs.js

@@ -0,0 +1,41 @@
+/*!
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+/** Glob pattern for test files (specs) */
+export const GLOB_FILES_TESTING = [
+    '**/*.test.*',
+    '**/*.spec.*',
+    '**/*.cy.*',
+    '**/test/**',
+    '**/tests/**',
+    '**/__tests__/**',
+    '**/__mocks__/**',
+];
+/** Glob pattern for Typescript files */
+export const GLOB_FILES_TYPESCRIPT = [
+    '**/*.ts',
+    '**/*.mts',
+    '**/*.cts',
+    '**/*.tsx',
+];
+/** Glob pattern for Typescript declaration files */
+export const GLOB_FILES_TYPESCRIPT_DECLARATIONS = ['**/*.d.ts'];
+/** Glob pattern for Javascript files */
+export const GLOB_FILES_JAVASCRIPT = [
+    '**/*.js',
+    '**/*.cjs',
+    '**/*.mjs',
+    '**/*.jsx',
+];
+/** Glob pattern for JSON files */
+export const GLOB_FILES_JSON = ['**/*.json'];
+/** Glob pattern for JSONC files */
+export const GLOB_FILES_JSONC = ['**/*.jsonc'];
+/** Glob pattern for Microsoft JSON files which use a slightly different JSONC implementation */
+export const GLOB_FILES_MS_JSON = [
+    '**/tsconfig.json',
+    '.vscode/*.json',
+];
+/** Glob pattern for Vue.JS files */
+export const GLOB_FILES_VUE = ['**/*.vue'];

package/dist/index.d.ts

@@ -1,31 +1,31 @@
-import { ESLint } from 'eslint';
-import { Linter } from 'eslint';
-
-export declare const nextcloudPlugin: ESLint.Plugin;
-
-/**
- * ESLint plugin to sort package.json files in a consistent way.
- */
-export declare const packageJsonPlugin: ESLint.Plugin;
-
-/**
- * Nextcloud shared configuration for projects using Vue 3 with Typescript <script> blocks
- */
-export declare const recommended: (Linter.Config<Linter.RulesRecord> | Linter.BaseConfig<Linter.RulesRecord, Linter.RulesRecord>)[];
-
-/**
- * Nextcloud shared configuration for projects using Vue 3 with Javascript <script> blocks
- */
-export declare const recommendedJavascript: (Linter.Config<Linter.RulesRecord> | Linter.BaseConfig<Linter.RulesRecord, Linter.RulesRecord>)[];
-
-/**
- * Nextcloud shared configuration for projects using Vue 2 with Typescript <script> blocks
- */
-export declare const recommendedVue2: (Linter.Config<Linter.RulesRecord> | Linter.BaseConfig<Linter.RulesRecord, Linter.RulesRecord>)[];
-
-/**
- * Nextcloud shared configuration for projects using Vue 2 with Javascript <script> blocks
- */
-export declare const recommendedVue2Javascript: (Linter.Config<Linter.RulesRecord> | Linter.BaseConfig<Linter.RulesRecord, Linter.RulesRecord>)[];
-
-export { }
+/*!
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+import type { Linter } from 'eslint';
+/**
+ * Nextcloud shared configuration for projects using Vue 2 with Javascript <script> blocks
+ */
+export declare const recommendedVue2Javascript: Linter.Config[];
+/**
+ * Nextcloud shared configuration for projects using Vue 2 with Typescript <script> blocks
+ */
+export declare const recommendedVue2: Linter.Config[];
+/**
+ * Nextcloud shared configuration for projects using Vue 3 with Javascript <script> blocks
+ */
+export declare const recommendedJavascript: Linter.Config[];
+/**
+ * Nextcloud shared configuration for projects using Vue 3 with Typescript <script> blocks
+ */
+export declare const recommended: Linter.Config[];
+/**
+ * Nextcloud shared configuration for projects using Vue 3 with Typescript <script> blocks
+ */
+export declare const recommendedLibrary: Linter.Config[];
+/**
+ * Nextcloud shared configuration for projects using Vue 3 with Typescript <script> blocks
+ */
+export declare const recommendedVue2Library: Linter.Config[];
+export { default as packageJsonPlugin } from './plugins/packageJson.ts';
+export { default as nextcloudPlugin } from './plugins/nextcloud/index.ts';

package/dist/index.js

@@ -0,0 +1,81 @@
+/*!
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+import { codeStyle } from "./configs/codeStyle.js";
+import { documentation } from "./configs/documentation.js";
+import { filesystem } from "./configs/filesystem.js";
+import { imports } from "./configs/imports.js";
+import { javascript } from "./configs/javascript.js";
+import { json } from "./configs/json.js";
+import { node } from "./configs/node.js";
+import { typescript } from "./configs/typescript.js";
+import { vue2 } from "./configs/vue2.js";
+import { vue3 } from "./configs/vue3.js";
+/**
+ * Nextcloud shared configuration for projects using Vue 2 with Javascript <script> blocks
+ */
+export const recommendedVue2Javascript = createConfig({
+    isLibrary: false,
+    vue2: true,
+    vueIsTypescript: false,
+});
+/**
+ * Nextcloud shared configuration for projects using Vue 2 with Typescript <script> blocks
+ */
+export const recommendedVue2 = createConfig({
+    isLibrary: false,
+    vue2: true,
+    vueIsTypescript: true,
+});
+/**
+ * Nextcloud shared configuration for projects using Vue 3 with Javascript <script> blocks
+ */
+export const recommendedJavascript = createConfig({
+    isLibrary: false,
+    vueIsTypescript: false,
+});
+/**
+ * Nextcloud shared configuration for projects using Vue 3 with Typescript <script> blocks
+ */
+export const recommended = createConfig({
+    isLibrary: false,
+    vueIsTypescript: true,
+});
+/**
+ * Nextcloud shared configuration for projects using Vue 3 with Typescript <script> blocks
+ */
+export const recommendedLibrary = createConfig({
+    isLibrary: true,
+    vueIsTypescript: true,
+});
+/**
+ * Nextcloud shared configuration for projects using Vue 3 with Typescript <script> blocks
+ */
+export const recommendedVue2Library = createConfig({
+    isLibrary: true,
+    vue2: true,
+    vueIsTypescript: true,
+});
+export { default as packageJsonPlugin } from "./plugins/packageJson.js";
+export { default as nextcloudPlugin } from "./plugins/nextcloud/index.js";
+/**
+ * Generate a configuration based on given options
+ *
+ * @param options - Configuration options
+ */
+function createConfig(options) {
+    return [
+        ...filesystem,
+        ...javascript(options),
+        ...json,
+        ...node,
+        ...typescript(options),
+        ...(options.vue2
+            ? vue2(options)
+            : vue3(options)),
+        ...documentation(options),
+        ...imports(options),
+        ...codeStyle(options),
+    ];
+}

package/dist/plugins/import-extensions/index.d.ts

@@ -0,0 +1,15 @@
+/*!
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+declare const _default: {
+    rules: {
+        'ban-inline-type-imports': import("eslint").Rule.RuleModule;
+        extensions: import("eslint").Rule.RuleModule;
+    };
+    meta: {
+        name: string;
+        version: string;
+    };
+};
+export default _default;

package/dist/plugins/import-extensions/index.js

@@ -0,0 +1,13 @@
+/*!
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+import { packageVersion } from "../../version.js";
+import { rules } from "./rules/index.js";
+export default {
+    rules,
+    meta: {
+        name: '@nextcloud/eslint-plugin',
+        version: packageVersion,
+    },
+};

package/dist/plugins/import-extensions/rules/ban-inline-type-imports.d.ts

@@ -0,0 +1,7 @@
+/*!
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-FileCopyrightText: 2015 Ben Mosher
+ * SPDX-License-Identifier: MIT
+ */
+import type { Rule } from 'eslint';
+export declare const rule: Rule.RuleModule;