knip 6.22.0 → 6.24.0

package/dist/typescript/ast-nodes.js

@@ -1,4 +1,4 @@
-import { parseSync, rawTransferSupported, } from 'oxc-parser';
+import { parseSync, rawTransferSupported, visitorKeys, } from 'oxc-parser';
 import { DEFAULT_EXTENSIONS, FIX_FLAGS, SYMBOL_TYPE } from '../constants.js';
 import { extname } from '../util/path.js';
 import { timerify } from '../util/Performance.js';
@@ -131,6 +131,56 @@ export function extractNamespaceMembers(decl, options, lineStarts, getJSDocTags,
     }
     return members;
 }
+export const collectAugmentationRefs = (node) => {
+    if (!node.body || node.body.type !== 'TSModuleBlock')
+        return [];
+    const body = node.body.body;
+    const declared = new Set();
+    for (const stmt of body) {
+        const decl = stmt.type === 'ExportNamedDeclaration' && stmt.declaration ? stmt.declaration : stmt;
+        if ('id' in decl && decl.id?.type === 'Identifier')
+            declared.add(decl.id.name);
+        else if (decl.type === 'VariableDeclaration')
+            for (const d of decl.declarations)
+                if (d.id.type === 'Identifier')
+                    declared.add(d.id.name);
+    }
+    const refs = [];
+    const seen = new Set();
+    const add = (ref) => {
+        if (ref?.type === 'Identifier' && !declared.has(ref.name) && !seen.has(ref.name)) {
+            seen.add(ref.name);
+            refs.push(ref.name);
+        }
+    };
+    const visit = (n) => {
+        const type = n?.type;
+        if (!type)
+            return;
+        if (type === 'TSTypeReference')
+            add(n.typeName);
+        else if (type === 'TSInterfaceHeritage')
+            add(n.expression);
+        const keys = visitorKeys[type];
+        if (!keys)
+            return;
+        for (const key of keys) {
+            const val = n[key];
+            if (!val)
+                continue;
+            if (Array.isArray(val)) {
+                for (const item of val)
+                    if (item)
+                        visit(item);
+            }
+            else
+                visit(val);
+        }
+    };
+    for (const stmt of body)
+        visit(stmt);
+    return refs;
+};
 export function extractEnumMembers(decl, options, lineStarts, getJSDocTags) {
     if (!decl.body?.members)
         return [];

package/dist/typescript/comments.js

@@ -1,6 +1,7 @@
 import { IMPORT_FLAGS } from '../constants.js';
 const jsDocImportRe = /import\(\s*['"]([^'"]+)['"]\s*\)(?:\.(\w+))?/g;
 const jsDocImportTagRe = /@import\s+(?:\{[^}]*\}|\*\s+as\s+\w+)\s+from\s+['"]([^'"]+)['"]/g;
+const jsDocTypeTagRe = /@(?:type|typedef|callback|param|arg|argument|property|prop|returns?|yields?|throws?|exception|this|extends|augments|implements|enum|template|satisfies|const|constant|member|var|namespace|module)\b/;
 const jsxImportSourceRe = /@jsxImportSource\s+(\S+)/;
 const referenceRe = /\s*<reference\s+(types|path)\s*=\s*"([^"]+)"[^/]*\/>/;
 const envPragmaRe = /@(vitest|jest)-environment\s+([@\w./-]+)/g;
@@ -18,6 +19,26 @@ const resolveEnvironmentPragma = (tool, value) => {
         return '@edge-runtime/vm';
     return value;
 };
+const isInJsDocTypeExpression = (text, index) => {
+    let depth = 0;
+    for (let pos = index - 1; pos >= 0; pos--) {
+        const char = text.charCodeAt(pos);
+        if (char === 125) {
+            depth++;
+        }
+        else if (char === 123) {
+            if (depth > 0) {
+                depth--;
+            }
+            else {
+                const line = text.slice(text.lastIndexOf('\n', pos - 1) + 1, pos);
+                if (jsDocTypeTagRe.test(line))
+                    return true;
+            }
+        }
+    }
+    return false;
+};
 export const extractImportsFromComments = (comments, firstStmtStart, addImport) => {
     for (const comment of comments) {
         const text = comment.value;
@@ -25,9 +46,7 @@ export const extractImportsFromComments = (comments, firstStmtStart, addImport)
         if (comment.type === 'Block') {
             jsDocImportRe.lastIndex = 0;
             while ((results = jsDocImportRe.exec(text)) !== null) {
-                const before = text.slice(0, results.index);
-                const lastOpen = before.lastIndexOf('{');
-                if (lastOpen === -1 || before.indexOf('}', lastOpen) !== -1)
+                if (!isInJsDocTypeExpression(text, results.index))
                     continue;
                 const specifier = results[1];
                 const member = results[2];

package/dist/typescript/visitors/walk.js

@@ -3,7 +3,7 @@ import { FIX_FLAGS, IMPORT_FLAGS, OPAQUE, SYMBOL_TYPE } from '../../constants.js
 import { addValue } from '../../util/module-graph.js';
 import { isInNodeModules } from '../../util/path.js';
 import { timerify } from '../../util/Performance.js';
-import { getLineAndCol, getStringValue, isStringLiteral } from '../ast-nodes.js';
+import { collectAugmentationRefs, getLineAndCol, getStringValue, isStringLiteral, } from '../ast-nodes.js';
 import { EMPTY_TAGS } from './jsdoc.js';
 import { handleCallExpression, handleNewExpression, trackCustomElementRegistry } from './calls.js';
 import { handleExportAssignment, handleExportDefault, handleExportNamed, handleExpressionStatement, } from './exports.js';
@@ -211,6 +211,12 @@ const coreVisitorObject = {
     },
     TSModuleDeclaration(node) {
         state.nsRanges.push([node.start, node.end]);
+        if (node.kind !== 'global' && isStringLiteral(node.id)) {
+            const specifier = getStringValue(node.id);
+            if (specifier.startsWith('.'))
+                for (const name of collectAugmentationRefs(node))
+                    state.addImport(specifier, name, undefined, undefined, node.id.start, IMPORT_FLAGS.TYPE_ONLY);
+        }
     },
     ClassDeclaration(node) {
         state.classNameStack.push(node.id?.name ?? '');

package/dist/util/create-options.d.ts

@@ -58,6 +58,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'astro-markdoc'?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         'astro-og-canvas'?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -862,6 +867,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            'astro-markdoc'?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             'astro-og-canvas'?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "6.22.0";
+export declare const version = "6.24.0";

package/dist/version.js

@@ -1 +1 @@
-export const version = '6.22.0';
+export const version = '6.24.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "6.22.0",
+  "version": "6.24.0",
   "description": "Find and fix unused dependencies, exports and files in your TypeScript and JavaScript projects",
   "keywords": [
     "analysis",

package/schema.json

@@ -379,6 +379,10 @@
           "title": "astro-db plugin configuration (https://knip.dev/reference/plugins/astro-db)",
           "$ref": "#/definitions/plugin"
         },
+        "astro-markdoc": {
+          "title": "astro-markdoc plugin configuration (https://knip.dev/reference/plugins/astro-markdoc)",
+          "$ref": "#/definitions/plugin"
+        },
         "ava": {
           "title": "ava plugin configuration (https://knip.dev/reference/plugins/ava)",
           "$ref": "#/definitions/plugin"