@docusaurus/eslint-plugin 0.0.0-5415 → 0.0.0-5416

package/lib/index.d.ts

@@ -10,12 +10,16 @@ declare const _default: {
             ignoredStrings: string[];
         }], import("@typescript-eslint/utils/dist/ts-eslint/Rule").RuleListener>;
         'string-literal-i18n-messages': import("@typescript-eslint/utils/dist/ts-eslint/Rule").RuleModule<"translateChildren" | "translateArg", [], import("@typescript-eslint/utils/dist/ts-eslint/Rule").RuleListener>;
+        'no-html-links': import("@typescript-eslint/utils/dist/ts-eslint/Rule").RuleModule<"link", [{
+            ignoreFullyResolved: boolean;
+        }], import("@typescript-eslint/utils/dist/ts-eslint/Rule").RuleListener>;
     };
     configs: {
         recommended: {
             plugins: string[];
             rules: {
                 '@docusaurus/string-literal-i18n-messages': string;
+                '@docusaurus/no-html-links': string;
             };
         };
         all: {
@@ -23,6 +27,7 @@ declare const _default: {
             rules: {
                 '@docusaurus/string-literal-i18n-messages': string;
                 '@docusaurus/no-untranslated-text': string;
+                '@docusaurus/no-html-links': string;
             };
         };
     };

package/lib/index.js

@@ -14,6 +14,7 @@ module.exports = {
             plugins: ['@docusaurus'],
             rules: {
                 '@docusaurus/string-literal-i18n-messages': 'error',
+                '@docusaurus/no-html-links': 'warn',
             },
         },
         all: {
@@ -21,6 +22,7 @@ module.exports = {
             rules: {
                 '@docusaurus/string-literal-i18n-messages': 'error',
                 '@docusaurus/no-untranslated-text': 'warn',
+                '@docusaurus/no-html-links': 'warn',
             },
         },
     },

package/lib/rules/index.d.ts

@@ -9,5 +9,8 @@ declare const _default: {
         ignoredStrings: string[];
     }], import("@typescript-eslint/utils/dist/ts-eslint/Rule").RuleListener>;
     'string-literal-i18n-messages': import("@typescript-eslint/utils/dist/ts-eslint/Rule").RuleModule<"translateChildren" | "translateArg", [], import("@typescript-eslint/utils/dist/ts-eslint/Rule").RuleListener>;
+    'no-html-links': import("@typescript-eslint/utils/dist/ts-eslint/Rule").RuleModule<"link", [{
+        ignoreFullyResolved: boolean;
+    }], import("@typescript-eslint/utils/dist/ts-eslint/Rule").RuleListener>;
 };
 export default _default;

package/lib/rules/index.js

@@ -7,9 +7,11 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+const no_html_links_1 = tslib_1.__importDefault(require("./no-html-links"));
 const no_untranslated_text_1 = tslib_1.__importDefault(require("./no-untranslated-text"));
 const string_literal_i18n_messages_1 = tslib_1.__importDefault(require("./string-literal-i18n-messages"));
 exports.default = {
     'no-untranslated-text': no_untranslated_text_1.default,
     'string-literal-i18n-messages': string_literal_i18n_messages_1.default,
+    'no-html-links': no_html_links_1.default,
 };

package/lib/rules/no-html-links.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+declare type Options = [
+    {
+        ignoreFullyResolved: boolean;
+    }
+];
+declare const _default: import("@typescript-eslint/utils/dist/ts-eslint/Rule").RuleModule<"link", Options, import("@typescript-eslint/utils/dist/ts-eslint/Rule").RuleListener>;
+export default _default;

package/lib/rules/no-html-links.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const util_1 = require("../util");
+const docsUrl = 'https://docusaurus.io/docs/docusaurus-core#link';
+function isFullyResolvedUrl(urlString) {
+    try {
+        // href gets coerced to a string when it gets rendered anyway
+        const url = new URL(String(urlString));
+        if (url.protocol) {
+            return true;
+        }
+    }
+    catch (e) { }
+    return false;
+}
+exports.default = (0, util_1.createRule)({
+    name: 'no-html-links',
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'enforce using Docusaurus Link component instead of <a> tag',
+            recommended: false,
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    ignoreFullyResolved: {
+                        type: 'boolean',
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+        messages: {
+            link: `Do not use an \`<a>\` element to navigate. Use the \`<Link />\` component from \`@docusaurus/Link\` instead. See: ${docsUrl}`,
+        },
+    },
+    defaultOptions: [
+        {
+            ignoreFullyResolved: false,
+        },
+    ],
+    create(context, [options]) {
+        const { ignoreFullyResolved } = options;
+        return {
+            JSXOpeningElement(node) {
+                if (node.name.name !== 'a') {
+                    return;
+                }
+                if (ignoreFullyResolved) {
+                    const hrefAttr = node.attributes.find((attr) => attr.type === 'JSXAttribute' && attr.name.name === 'href');
+                    if (hrefAttr?.value?.type === 'Literal') {
+                        if (isFullyResolvedUrl(String(hrefAttr.value.value))) {
+                            return;
+                        }
+                    }
+                    if (hrefAttr?.value?.type === 'JSXExpressionContainer') {
+                        const container = hrefAttr.value;
+                        const { expression } = container;
+                        if (expression.type === 'TemplateLiteral') {
+                            // Simple static string template literals
+                            if (expression.expressions.length === 0 &&
+                                expression.quasis.length === 1 &&
+                                expression.quasis[0]?.type === 'TemplateElement' &&
+                                isFullyResolvedUrl(String(expression.quasis[0].value.raw))) {
+                                return;
+                            }
+                            // TODO add more complex TemplateLiteral cases here
+                        }
+                    }
+                }
+                context.report({ node, messageId: 'link' });
+            },
+        };
+    },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/eslint-plugin",
-  "version": "0.0.0-5415",
+  "version": "0.0.0-5416",
   "description": "ESLint plugin to enforce best Docusaurus practices.",
   "main": "lib/index.js",
   "keywords": [
@@ -33,5 +33,5 @@
   "engines": {
     "node": ">=16.14"
   },
-  "gitHead": "75a8c6e99031132fc1c96cf1154a026b27714055"
+  "gitHead": "58fa9168665fa4cb70b0eb722e0d56d6e26ac8c6"
 }

package/src/index.ts

@@ -14,6 +14,7 @@ export = {
       plugins: ['@docusaurus'],
       rules: {
         '@docusaurus/string-literal-i18n-messages': 'error',
+        '@docusaurus/no-html-links': 'warn',
       },
     },
     all: {
@@ -21,6 +22,7 @@ export = {
       rules: {
         '@docusaurus/string-literal-i18n-messages': 'error',
         '@docusaurus/no-untranslated-text': 'warn',
+        '@docusaurus/no-html-links': 'warn',
       },
     },
   },

package/src/rules/index.ts

@@ -5,10 +5,12 @@
  * LICENSE file in the root directory of this source tree.
  */
 
+import noHtmlLinks from './no-html-links';
 import noUntranslatedText from './no-untranslated-text';
 import stringLiteralI18nMessages from './string-literal-i18n-messages';
 
 export default {
   'no-untranslated-text': noUntranslatedText,
   'string-literal-i18n-messages': stringLiteralI18nMessages,
+  'no-html-links': noHtmlLinks,
 };

package/src/rules/no-html-links.ts

@@ -0,0 +1,103 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import {createRule} from '../util';
+import type {TSESTree} from '@typescript-eslint/types/dist/ts-estree';
+
+const docsUrl = 'https://docusaurus.io/docs/docusaurus-core#link';
+
+type Options = [
+  {
+    ignoreFullyResolved: boolean;
+  },
+];
+
+type MessageIds = 'link';
+
+function isFullyResolvedUrl(urlString: string): boolean {
+  try {
+    // href gets coerced to a string when it gets rendered anyway
+    const url = new URL(String(urlString));
+    if (url.protocol) {
+      return true;
+    }
+  } catch (e) {}
+  return false;
+}
+
+export default createRule<Options, MessageIds>({
+  name: 'no-html-links',
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'enforce using Docusaurus Link component instead of <a> tag',
+      recommended: false,
+    },
+    schema: [
+      {
+        type: 'object',
+        properties: {
+          ignoreFullyResolved: {
+            type: 'boolean',
+          },
+        },
+        additionalProperties: false,
+      },
+    ],
+    messages: {
+      link: `Do not use an \`<a>\` element to navigate. Use the \`<Link />\` component from \`@docusaurus/Link\` instead. See: ${docsUrl}`,
+    },
+  },
+  defaultOptions: [
+    {
+      ignoreFullyResolved: false,
+    },
+  ],
+
+  create(context, [options]) {
+    const {ignoreFullyResolved} = options;
+
+    return {
+      JSXOpeningElement(node) {
+        if ((node.name as TSESTree.JSXIdentifier).name !== 'a') {
+          return;
+        }
+
+        if (ignoreFullyResolved) {
+          const hrefAttr = node.attributes.find(
+            (attr): attr is TSESTree.JSXAttribute =>
+              attr.type === 'JSXAttribute' && attr.name.name === 'href',
+          );
+
+          if (hrefAttr?.value?.type === 'Literal') {
+            if (isFullyResolvedUrl(String(hrefAttr.value.value))) {
+              return;
+            }
+          }
+          if (hrefAttr?.value?.type === 'JSXExpressionContainer') {
+            const container: TSESTree.JSXExpressionContainer = hrefAttr.value;
+            const {expression} = container;
+            if (expression.type === 'TemplateLiteral') {
+              // Simple static string template literals
+              if (
+                expression.expressions.length === 0 &&
+                expression.quasis.length === 1 &&
+                expression.quasis[0]?.type === 'TemplateElement' &&
+                isFullyResolvedUrl(String(expression.quasis[0].value.raw))
+              ) {
+                return;
+              }
+              // TODO add more complex TemplateLiteral cases here
+            }
+          }
+        }
+
+        context.report({node, messageId: 'link'});
+      },
+    };
+  },
+});