starlight-links-validator 0.12.4 → 0.13.0

package/index.ts

@@ -41,6 +41,12 @@ const starlightLinksValidatorOptionsSchema = z
      * @default true
      */
     errorOnInvalidHashes: z.boolean().default(true),
+    /**
+     * Defines whether the plugin should error on local links, e.g. URLs with a hostname of `localhost` or `127.0.0.1`.
+     *
+     * @default true
+     */
+    errorOnLocalLinks: z.boolean().default(true),
     /**
      * Defines a list of links or glob patterns that should be excluded from validation.
      *

package/libs/remark.ts

@@ -61,7 +61,7 @@ export const remarkStarlightLinksValidator: Plugin<[{ base: string; srcDir: URL
           break
         }
         case 'link': {
-          if (isInternalLink(node.url)) {
+          if (shouldValidateLink(node.url)) {
             fileLinks.push(node.url)
           }
 
@@ -70,7 +70,7 @@ export const remarkStarlightLinksValidator: Plugin<[{ base: string; srcDir: URL
         case 'linkReference': {
           const definition = fileDefinitions.get(node.identifier)
 
-          if (definition && isInternalLink(definition)) {
+          if (definition && shouldValidateLink(definition)) {
             fileLinks.push(definition)
           }
 
@@ -96,7 +96,7 @@ export const remarkStarlightLinksValidator: Plugin<[{ base: string; srcDir: URL
               continue
             }
 
-            if (isInternalLink(attribute.value)) {
+            if (shouldValidateLink(attribute.value)) {
               fileLinks.push(attribute.value)
             }
           }
@@ -125,7 +125,7 @@ export const remarkStarlightLinksValidator: Plugin<[{ base: string; srcDir: URL
               htmlNode.tagName === 'a' &&
               hasProperty(htmlNode, 'href') &&
               typeof htmlNode.properties.href === 'string' &&
-              isInternalLink(htmlNode.properties.href)
+              shouldValidateLink(htmlNode.properties.href)
             ) {
               fileLinks.push(htmlNode.properties.href)
             }
@@ -145,8 +145,18 @@ export function getValidationData() {
   return { headings, links }
 }
 
-function isInternalLink(link: string) {
-  return !isAbsoluteUrl(link)
+function shouldValidateLink(link: string) {
+  if (!isAbsoluteUrl(link)) {
+    return true
+  }
+
+  try {
+    const url = new URL(link)
+
+    return url.hostname === 'localhost' || url.hostname === '127.0.0.1'
+  } catch {
+    return false
+  }
 }
 
 function getFilePath(base: string, filePath: string, slug: string | undefined) {

package/libs/validation.ts

@@ -17,6 +17,7 @@ export const ValidationErrorType = {
   InconsistentLocale: 'inconsistent locale',
   InvalidHash: 'invalid hash',
   InvalidLink: 'invalid link',
+  LocalLink: 'local link',
   RelativeLink: 'relative link',
   TrailingSlash: 'trailing slash',
 } as const
@@ -115,6 +116,14 @@ function validateLink(context: ValidationContext) {
     return
   }
 
+  if (/^https?:\/\//.test(link)) {
+    if (options.errorOnLocalLinks) {
+      addError(errors, filePath, link, ValidationErrorType.LocalLink)
+    }
+
+    return
+  }
+
   const sanitizedLink = link.replace(/^\//, '')
   const segments = sanitizedLink.split('#')
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starlight-links-validator",
-  "version": "0.12.4",
+  "version": "0.13.0",
   "license": "MIT",
   "description": "Starlight plugin to validate internal links.",
   "author": "HiDeoo <github@hideoo.dev> (https://hideoo.dev)",