From dfc13e312cd6b15ced4e6fdca3392e3de6f2f5ad Mon Sep 17 00:00:00 2001
From: chess99 <chess99@126.com>
Date: Sun, 12 Jan 2025 17:22:49 +0800
Subject: [PATCH 1/2] Add `miniprogram` plugin

---
 .../plugins/miniprogram/app-project/app.js    |  10 +
 .../plugins/miniprogram/app-project/app.json  |  23 ++
 .../plugins/miniprogram/app-project/app.wxss  |   5 +
 .../components/unused-button/index.js         |   6 +
 .../components/unused-button/index.json       |   3 +
 .../components/unused-counter/index.json      |   3 +
 .../components/unused-counter/index.ts        |  15 ++
 .../components/used-footer/index.js           |   5 +
 .../components/used-footer/index.json         |   3 +
 .../app-project/images/unused-logo.png        |   1 +
 .../app-project/images/used-icon.png          |   1 +
 .../app-project/images/used-logo.png          |   1 +
 .../plugins/miniprogram/app-project/knip.json |   9 +
 .../miniprogram/app-project/package.json      |   7 +
 .../app-project/pages/index/helper.wxs        |   7 +
 .../app-project/pages/index/index.json        |   8 +
 .../app-project/pages/index/index.ts          |  13 ++
 .../app-project/pages/index/index.wxml        |  16 ++
 .../app-project/pages/index/index.wxss        |   6 +
 .../app-project/pages/index/used-date.wxs     |   8 +
 .../miniprogram/app-project/sitemap.json      |  15 ++
 .../app-project/styles/unused-theme.wxss      |   4 +
 .../app-project/styles/used-theme.wxss        |   4 +
 .../app-project/templates/unused-card.wxml    |   6 +
 .../app-project/templates/used-item.wxml      |   3 +
 .../app-project/wxs/unused-format.wxs         |   7 +
 packages/knip/schema.json                     |   4 +
 packages/knip/src/compilers/index.ts          |   5 +
 packages/knip/src/compilers/miniprogram.ts    |  24 ++
 packages/knip/src/plugins/index.ts            |   2 +
 .../knip/src/plugins/miniprogram/README.md    | 208 ++++++++++++++++++
 .../knip/src/plugins/miniprogram/index.ts     | 115 ++++++++++
 .../knip/src/plugins/miniprogram/parser.ts    |  89 ++++++++
 .../knip/src/plugins/miniprogram/types.ts     |  60 +++++
 .../knip/src/plugins/miniprogram/utils.ts     | 206 +++++++++++++++++
 packages/knip/src/schema/plugins.ts           |   1 +
 packages/knip/src/types/PluginNames.ts        |   2 +
 .../knip/src/util/get-referenced-inputs.ts    |   3 +-
 .../plugins/miniprogram/miniprogram.test.ts   |  52 +++++
 .../test/plugins/miniprogram/parser.test.ts   |  94 ++++++++
 .../test/plugins/miniprogram/utils.test.ts    | 104 +++++++++
 41 files changed, 1156 insertions(+), 2 deletions(-)
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/app.js
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/app.json
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/app.wxss
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-button/index.js
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-button/index.json
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-counter/index.json
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-counter/index.ts
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/components/used-footer/index.js
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/components/used-footer/index.json
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/images/unused-logo.png
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/images/used-icon.png
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/images/used-logo.png
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/knip.json
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/package.json
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/helper.wxs
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.json
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.ts
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.wxml
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.wxss
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/used-date.wxs
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/sitemap.json
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/styles/unused-theme.wxss
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/styles/used-theme.wxss
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/templates/unused-card.wxml
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/templates/used-item.wxml
 create mode 100644 packages/knip/fixtures/plugins/miniprogram/app-project/wxs/unused-format.wxs
 create mode 100644 packages/knip/src/compilers/miniprogram.ts
 create mode 100644 packages/knip/src/plugins/miniprogram/README.md
 create mode 100644 packages/knip/src/plugins/miniprogram/index.ts
 create mode 100644 packages/knip/src/plugins/miniprogram/parser.ts
 create mode 100644 packages/knip/src/plugins/miniprogram/types.ts
 create mode 100644 packages/knip/src/plugins/miniprogram/utils.ts
 create mode 100644 packages/knip/test/plugins/miniprogram/miniprogram.test.ts
 create mode 100644 packages/knip/test/plugins/miniprogram/parser.test.ts
 create mode 100644 packages/knip/test/plugins/miniprogram/utils.test.ts

diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/app.js b/packages/knip/fixtures/plugins/miniprogram/app-project/app.js
new file mode 100644
index 000000000..3a8e24531
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/app.js
@@ -0,0 +1,10 @@
+App({
+  onLaunch() {
+    // Create worker
+    const worker = wx.createWorker('workers/request');
+    
+    worker.onMessage((msg) => {
+      console.log(msg);
+    });
+  }
+}); 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/app.json b/packages/knip/fixtures/plugins/miniprogram/app-project/app.json
new file mode 100644
index 000000000..25ddf9f54
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/app.json
@@ -0,0 +1,23 @@
+{
+  "pages": [
+    "pages/index/index"
+  ],
+  "window": {
+    "navigationBarTitleText": "Mini Program"
+  },
+  "usingComponents": {
+    "missing-header": "/components/missing-header/index",
+    "used-footer": "/components/used-footer/index"
+  },
+  "workers": "workers/missing-worker.ts",
+  "tabBar": {
+    "list": [
+      {
+        "pagePath": "pages/index/index",
+        "text": "Home",
+        "iconPath": "images/missing-icon.png",
+        "selectedIconPath": "images/used-icon.png"
+      }
+    ]
+  }
+} 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/app.wxss b/packages/knip/fixtures/plugins/miniprogram/app-project/app.wxss
new file mode 100644
index 000000000..e157fdc37
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/app.wxss
@@ -0,0 +1,5 @@
+@import "/styles/missing-theme";
+
+page {
+  background: #f8f8f8;
+} 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-button/index.js b/packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-button/index.js
new file mode 100644
index 000000000..f5b3280a6
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-button/index.js
@@ -0,0 +1,6 @@
+Component({
+  properties: {
+    type: String,
+    text: String
+  }
+}); 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-button/index.json b/packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-button/index.json
new file mode 100644
index 000000000..33aefde3a
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-button/index.json
@@ -0,0 +1,3 @@
+{
+  "component": true
+} 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-counter/index.json b/packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-counter/index.json
new file mode 100644
index 000000000..33aefde3a
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-counter/index.json
@@ -0,0 +1,3 @@
+{
+  "component": true
+} 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-counter/index.ts b/packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-counter/index.ts
new file mode 100644
index 000000000..c4a233eea
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/components/unused-counter/index.ts
@@ -0,0 +1,15 @@
+interface IProps {
+  count: number;
+  onIncrement: () => void;
+}
+
+Component<IProps>({
+  properties: {
+    count: Number
+  },
+  methods: {
+    handleTap() {
+      this.triggerEvent('increment');
+    }
+  }
+}); 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/components/used-footer/index.js b/packages/knip/fixtures/plugins/miniprogram/app-project/components/used-footer/index.js
new file mode 100644
index 000000000..5b6c7741a
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/components/used-footer/index.js
@@ -0,0 +1,5 @@
+Component({
+  properties: {
+    text: String
+  }
+}); 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/components/used-footer/index.json b/packages/knip/fixtures/plugins/miniprogram/app-project/components/used-footer/index.json
new file mode 100644
index 000000000..33aefde3a
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/components/used-footer/index.json
@@ -0,0 +1,3 @@
+{
+  "component": true
+} 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/images/unused-logo.png b/packages/knip/fixtures/plugins/miniprogram/app-project/images/unused-logo.png
new file mode 100644
index 000000000..cb2757f0e
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/images/unused-logo.png
@@ -0,0 +1 @@
+// This is an empty file for testing unused image detection 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/images/used-icon.png b/packages/knip/fixtures/plugins/miniprogram/app-project/images/used-icon.png
new file mode 100644
index 000000000..cb2757f0e
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/images/used-icon.png
@@ -0,0 +1 @@
+// This is an empty file for testing unused image detection 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/images/used-logo.png b/packages/knip/fixtures/plugins/miniprogram/app-project/images/used-logo.png
new file mode 100644
index 000000000..cb2757f0e
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/images/used-logo.png
@@ -0,0 +1 @@
+// This is an empty file for testing unused image detection 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/knip.json b/packages/knip/fixtures/plugins/miniprogram/app-project/knip.json
new file mode 100644
index 000000000..9c2feead0
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/knip.json
@@ -0,0 +1,9 @@
+{
+  "$schema": "https://unpkg.com/knip@2/schema.json",
+  "paths": {
+    "@components/*": ["components/*"],
+    "@utils/*": ["utils/*"],
+    "@styles/*": ["styles/*"],
+    "~/*": ["*"]
+  }
+} 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/package.json b/packages/knip/fixtures/plugins/miniprogram/app-project/package.json
new file mode 100644
index 000000000..64db009e0
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/package.json
@@ -0,0 +1,7 @@
+{
+  "name": "miniprogram-test",
+  "version": "1.0.0",
+  "devDependencies": {
+    "miniprogram-api-typings": "*"
+  }
+} 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/helper.wxs b/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/helper.wxs
new file mode 100644
index 000000000..560591cf5
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/helper.wxs
@@ -0,0 +1,7 @@
+var common = require('./missing-common.wxs');
+var usedDate = require('./used-date.wxs');
+
+module.exports = {
+  format: common.format,
+  usedDate: usedDate.format
+}; 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.json b/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.json
new file mode 100644
index 000000000..131407b78
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.json
@@ -0,0 +1,8 @@
+{
+  "usingComponents": {
+    "missing-button": "@components/missing-button",
+    "missing-helper": "~/utils/missing-helper",
+    "missing-footer": "./missing-footer",
+    "used-counter": "../used-counter"
+  }
+} 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.ts b/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.ts
new file mode 100644
index 000000000..05e990e79
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.ts
@@ -0,0 +1,13 @@
+import { formatDate } from '~/utils/missing-date';
+
+Page({
+  data: {
+    now: Date.now(),
+    text: ''
+  },
+  onLoad() {
+    this.setData({
+      text: formatDate(this.data.now)
+    });
+  }
+}); 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.wxml b/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.wxml
new file mode 100644
index 000000000..089198ac1
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.wxml
@@ -0,0 +1,16 @@
+<wxs src="/utils/missing-format.wxs" module="format" />
+<wxs src="./helper.wxs" module="helper" />
+
+<import src="/templates/missing-list.wxml" />
+<import src="/templates/used-list.wxml" />
+
+<include src="/templates/used-item.wxml" />
+<include src="/templates/missing-item.wxml" />
+
+<view class="container">
+  <image src="/images/missing-logo.png" />
+  <image src="/images/used-logo.png" />
+  
+  <template is="missing-list" data="{{items}}" />
+  <template is="used-item" data="{{text}}" />
+</view> 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.wxss b/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.wxss
new file mode 100644
index 000000000..2dfa5e275
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/index.wxss
@@ -0,0 +1,6 @@
+@import "/styles/missing-theme.wxss";
+@import "/styles/used-theme.wxss";
+
+.container {
+  padding: 20px;
+} 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/used-date.wxs b/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/used-date.wxs
new file mode 100644
index 000000000..97cfe5610
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/pages/index/used-date.wxs
@@ -0,0 +1,8 @@
+function format(timestamp) {
+  var date = getDate(timestamp);
+  return date.getFullYear() + '-' + (date.getMonth() + 1) + '-' + date.getDate();
+}
+
+module.exports = {
+  format: format
+}; 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/sitemap.json b/packages/knip/fixtures/plugins/miniprogram/app-project/sitemap.json
new file mode 100644
index 000000000..1d91bb01c
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/sitemap.json
@@ -0,0 +1,15 @@
+{
+  "desc": "Configuration for WeChat search crawling",
+  "rules": [
+    {
+      "action": "allow",
+      "page": "pages/index/index",
+      "params": ["id"],
+      "matching": "exact"
+    },
+    {
+      "action": "disallow",
+      "page": "pages/private/*"
+    }
+  ]
+} 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/styles/unused-theme.wxss b/packages/knip/fixtures/plugins/miniprogram/app-project/styles/unused-theme.wxss
new file mode 100644
index 000000000..e3c6ddce8
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/styles/unused-theme.wxss
@@ -0,0 +1,4 @@
+.unused-theme {
+  color: #333;
+  background: #fff;
+} 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/styles/used-theme.wxss b/packages/knip/fixtures/plugins/miniprogram/app-project/styles/used-theme.wxss
new file mode 100644
index 000000000..e3c6ddce8
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/styles/used-theme.wxss
@@ -0,0 +1,4 @@
+.unused-theme {
+  color: #333;
+  background: #fff;
+} 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/templates/unused-card.wxml b/packages/knip/fixtures/plugins/miniprogram/app-project/templates/unused-card.wxml
new file mode 100644
index 000000000..0c75fe50a
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/templates/unused-card.wxml
@@ -0,0 +1,6 @@
+<template name="unused-card">
+  <view class="card">
+    <view class="title">{{title}}</view>
+    <view class="content">{{content}}</view>
+  </view>
+</template> 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/templates/used-item.wxml b/packages/knip/fixtures/plugins/miniprogram/app-project/templates/used-item.wxml
new file mode 100644
index 000000000..d0ace96c0
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/templates/used-item.wxml
@@ -0,0 +1,3 @@
+<template name="used-item">
+  <view class="item">{{text}}</view>
+</template> 
\ No newline at end of file
diff --git a/packages/knip/fixtures/plugins/miniprogram/app-project/wxs/unused-format.wxs b/packages/knip/fixtures/plugins/miniprogram/app-project/wxs/unused-format.wxs
new file mode 100644
index 000000000..a9a0fa6ca
--- /dev/null
+++ b/packages/knip/fixtures/plugins/miniprogram/app-project/wxs/unused-format.wxs
@@ -0,0 +1,7 @@
+function format(number) {
+  return number.toFixed(2);
+}
+
+module.exports = {
+  format: format
+}; 
\ No newline at end of file
diff --git a/packages/knip/schema.json b/packages/knip/schema.json
index a0be0d805..881efdc9a 100644
--- a/packages/knip/schema.json
+++ b/packages/knip/schema.json
@@ -404,6 +404,10 @@
           "title": "metro plugin configuration (https://knip.dev/reference/plugins/metro)",
           "$ref": "#/definitions/plugin"
         },
+        "miniprogram": {
+          "title": "miniprogram plugin configuration (https://knip.dev/reference/plugins/miniprogram)",
+          "$ref": "#/definitions/plugin"
+        },
         "mocha": {
           "title": "Mocha plugin configuration (https://knip.dev/reference/plugins/mocha)",
           "$ref": "#/definitions/plugin"
diff --git a/packages/knip/src/compilers/index.ts b/packages/knip/src/compilers/index.ts
index 2125c06f2..9b1715a95 100644
--- a/packages/knip/src/compilers/index.ts
+++ b/packages/knip/src/compilers/index.ts
@@ -2,6 +2,7 @@ import type { RawConfiguration } from '../types/config.js';
 import type { DependencySet } from '../types/workspace.js';
 import Astro from './astro.js';
 import MDX from './mdx.js';
+import Miniprogram from './miniprogram.js';
 import Svelte from './svelte.js';
 import type { AsyncCompilerFn, AsyncCompilers, SyncCompilerFn, SyncCompilers } from './types.js';
 import Vue from './vue.js';
@@ -37,6 +38,10 @@ const compilers = new Map([
   ['.mdx', MDX],
   ['.svelte', Svelte],
   ['.vue', Vue],
+  ['.wxml', Miniprogram.wxml],
+  ['.wxss', Miniprogram.wxss],
+  ['.wxs', Miniprogram.wxs],
+  ['.json', Miniprogram.json],
 ]);
 
 export const getIncludedCompilers = (
diff --git a/packages/knip/src/compilers/miniprogram.ts b/packages/knip/src/compilers/miniprogram.ts
new file mode 100644
index 000000000..8c31140a3
--- /dev/null
+++ b/packages/knip/src/compilers/miniprogram.ts
@@ -0,0 +1,24 @@
+import { parseWxml, parseWxs, parseWxss } from '../plugins/miniprogram/parser.js';
+import type { HasDependency } from './types.js';
+
+// Enable compilers when miniprogram-api-typings is present (indicating a Mini Program project)
+const isMiniprogramProject = (hasDependency: HasDependency) => {
+    return hasDependency('miniprogram-api-typings');
+};
+
+// We don't parse JSON files in the compiler because:
+// 1. When a component path is referenced (e.g. "./foobar"), we can't determine if it's:
+//    - "./foobar.json" (single file) or
+//    - "./foobar/index.json" (directory)
+// 2. The only purpose of this JSON compiler is to make getCompilerExtensions include
+//    JSON files as project files, so they can be analyzed for usage
+const parseJson = (text: string) => {
+    return text;
+};
+
+const wxml = { condition: isMiniprogramProject, compiler: parseWxml };
+const wxss = { condition: isMiniprogramProject, compiler: parseWxss };
+const wxs = { condition: isMiniprogramProject, compiler: parseWxs };
+const json = { condition: isMiniprogramProject, compiler: parseJson };
+
+export default { wxml, wxss, wxs, json };
diff --git a/packages/knip/src/plugins/index.ts b/packages/knip/src/plugins/index.ts
index f7c8f6036..ad74c6048 100644
--- a/packages/knip/src/plugins/index.ts
+++ b/packages/knip/src/plugins/index.ts
@@ -31,6 +31,7 @@ import { default as lockfileLint } from './lockfile-lint/index.js';
 import { default as lostPixel } from './lost-pixel/index.js';
 import { default as markdownlint } from './markdownlint/index.js';
 import { default as metro } from './metro/index.js';
+import { default as miniprogram } from './miniprogram/index.js';
 import { default as mocha } from './mocha/index.js';
 import { default as moonrepo } from './moonrepo/index.js';
 import { default as msw } from './msw/index.js';
@@ -123,6 +124,7 @@ export const Plugins = {
   'lost-pixel': lostPixel,
   markdownlint,
   metro,
+  miniprogram,
   mocha,
   moonrepo,
   msw,
diff --git a/packages/knip/src/plugins/miniprogram/README.md b/packages/knip/src/plugins/miniprogram/README.md
new file mode 100644
index 000000000..d3cfc0bc1
--- /dev/null
+++ b/packages/knip/src/plugins/miniprogram/README.md
@@ -0,0 +1,208 @@
+# Mini Program Plugin
+
+A plugin for analyzing dependencies in WeChat Mini Program projects.
+
+## Overview
+
+The plugin analyzes dependencies in WeChat Mini Program projects, supporting both regular Mini Program projects and plugin projects. It handles various file types including JavaScript/TypeScript, WXML templates, WXSS styles, WXS modules, and JSON configurations.
+
+## Requirements and Activation
+
+- Requires `miniprogram-api-typings` in dependencies/devDependencies
+- Activates when either:
+  - `app.json` exists with a valid `pages` array (Mini Program project)
+  - `plugin.json` exists (Mini Program plugin project)
+
+## Project Structure
+
+### Entry Points
+
+The plugin automatically selects the appropriate entry point based on project type:
+
+- `app.json` - Main configuration for Mini Program projects
+- `plugin.json` - Main configuration for plugin projects
+- `sitemap.json` - Optional configuration for WeChat search crawling (marked as used but not analyzed)
+
+### File Types and Dependencies
+
+#### JSON Files
+
+1. **app.json**
+   - Pages via `pages` array
+   - Components via `usingComponents`
+   - Subpackages via `subPackages`
+   - Workers via `workers`
+   - Tab bar icons via `tabBar.list[].iconPath`
+
+   Example:
+
+   ```json
+   {
+     "pages": ["pages/index/index"],
+     "subPackages": [{
+       "root": "packages/feature",
+       "pages": ["pages/index/index"]
+     }],
+     "usingComponents": {
+       "custom-comp": "/components/custom/custom"
+     },
+     "workers": "workers",
+     "tabBar": {
+       "list": [{
+         "iconPath": "images/icon.png",
+         "selectedIconPath": "images/icon-selected.png"
+       }]
+     }
+   }
+   ```
+
+2. **Component/Page JSON**
+
+   ```json
+   {
+     "component": true,
+     "usingComponents": {
+       "custom-comp": "/components/custom/custom",
+       "other-comp": "../../components/other/index"
+     }
+   }
+   ```
+
+3. **plugin.json** (for plugin projects)
+
+   ```json
+   {
+     "publicComponents": {
+       "custom-component": "components/custom/custom"
+     },
+     "pages": {
+       "hello-page": "pages/hello/hello"
+     },
+     "main": "index.js"
+   }
+   ```
+
+#### Template Files (WXML)
+
+1. **Template Imports/Includes**
+
+   ```html
+   <!-- Importing templates -->
+   <import src="template.wxml"/>
+   <template is="item" data="{{text: 'hello'}}"/>
+
+   <!-- Including content -->
+   <include src="/templates/header.wxml" />
+   ```
+
+2. **Resources**
+
+   ```html
+   <!-- Images -->
+   <image src="/images/logo.png" />
+
+   <!-- WXS Modules -->
+   <wxs src="/utils/format.wxs" module="format" />
+   ```
+
+#### Style Files (WXSS)
+
+```css
+@import "/styles/common.wxss";
+```
+
+#### Script Files (WXS)
+
+```js
+var utils = require('/utils/common.wxs');
+```
+
+#### Worker Files
+
+```js
+const worker = wx.createWorker('workers/request.js')
+```
+
+## Configuration
+
+Configure the plugin in your Knip configuration:
+
+```json
+{
+  "miniprogram": {
+    // Entry files to analyze (overrides default entry points)
+    "entry": ["src/app.json", "src/plugin.json"],
+
+    // Production files to include (in addition to default patterns)
+    "project": [
+      "src/custom/**/*.js",
+      "src/vendors/**/*.js"
+    ],
+
+    // Files to ignore from analysis
+    "ignore": [
+      "src/components/debug/**/*",
+      "src/**/*.test.js"
+    ],
+
+    // Custom root directory for absolute path resolution
+    "root": "src/miniprogram"
+  }
+}
+```
+
+### Path Resolution
+
+The plugin supports three types of paths:
+
+1. **Alias Paths** (via Knip's global paths)
+
+   ```json
+   {
+     "paths": {
+       "@components": ["src/components"],
+       "@utils": ["src/utils"],
+       "~": ["src"]
+     }
+   }
+   ```
+
+2. **Absolute Paths** (via miniprogram.root)
+3. **Relative Paths** (relative to current file)
+
+Example usage in component configuration:
+
+```json
+{
+  "usingComponents": {
+    "comp1": "@components/shared/foo",  // Alias path
+    "comp2": "/components/baz",         // Absolute path
+    "comp3": "../components/other"      // Relative path
+  }
+}
+```
+
+## Best Practices
+
+1. **Component Organization**
+   - Keep component dependencies in the same directory
+   - Use explicit paths in component references
+   - Avoid dynamic component loading
+
+2. **Template Usage**
+   - Place shared templates in a dedicated directory
+   - Use static template names over dynamic `is` attributes
+   - Understand import vs include:
+     - `import`: Template definitions only
+     - `include`: Full content with shared scope
+
+## Limitations
+
+- No analysis of dynamic imports
+- No tracking of runtime component registration
+- Cannot detect dynamic template names
+- Cannot analyze worker message patterns
+
+## TypeScript Support
+
+The plugin automatically handles TypeScript files, with `miniprogram-api-typings` required for all file types.
diff --git a/packages/knip/src/plugins/miniprogram/index.ts b/packages/knip/src/plugins/miniprogram/index.ts
new file mode 100644
index 000000000..7996bd642
--- /dev/null
+++ b/packages/knip/src/plugins/miniprogram/index.ts
@@ -0,0 +1,115 @@
+import { existsSync } from 'node:fs';
+import type { IsPluginEnabled, Plugin, ResolveConfig, ResolveEntryPaths } from '../../types/config.js';
+import { toDevDependency, toEntry } from '../../util/input.js';
+import { _load } from '../../util/loader.js';
+import { join } from '../../util/path.js';
+import { hasDependency } from '../../util/plugin.js';
+import { analyzeMiniprogramProject, isMiniprogramProject } from './utils.js';
+
+const title = 'WeChat Mini Program';
+
+const enablers = ['miniprogram-api-typings'];
+
+const isEnabled: IsPluginEnabled = ({ dependencies, cwd }) => {
+  const enabled = isMiniprogramProject(cwd, pkg => hasDependency(dependencies, [pkg]));
+  return enabled;
+};
+
+// Add config property to specify which files should be processed
+const config = ['app.json'];
+
+interface MiniprogramConfig {
+  pages?: string[];
+  subPackages?: Array<{
+    root: string;
+    pages: string[];
+  }>;
+  usingComponents?: Record<string, string>;
+}
+
+const resolveEntryPaths: ResolveEntryPaths<MiniprogramConfig> = async (_config, options) => {
+  // Load workspace config to get path aliases
+  const workspaceConfig = await _load(join(options.configFileDir, 'knip.json'));
+
+  // Analyze the project to get all pages and components
+  const result = await analyzeMiniprogramProject(options.cwd, { paths: workspaceConfig.paths });
+  const entries: string[] = [];
+
+  // Add default miniprogram files
+  entries.push('app.{js,ts}');
+  entries.push('app.wxss');
+  entries.push('app.json');
+  entries.push('plugin.json');
+  entries.push('package.json');
+  entries.push('sitemap.json');
+
+  // Helper function to add file patterns based on actual file structure
+  const addFilePatterns = (basePath: string) => {
+    const absolutePath = join(options.cwd, basePath);
+    const isDirectory = existsSync(absolutePath) && !existsSync(`${absolutePath}.json`);
+
+    if (isDirectory) {
+      // Directory case (e.g. used-counter/index.json)
+      entries.push(`${basePath}/index.json`);
+      entries.push(`${basePath}/index.{js,ts}`);
+      entries.push(`${basePath}/index.wxml`);
+      entries.push(`${basePath}/index.wxss`);
+    } else {
+      // Single file case (e.g. used-counter.json)
+      entries.push(`${basePath}.json`);
+      entries.push(`${basePath}.{js,ts}`);
+      entries.push(`${basePath}.wxml`);
+      entries.push(`${basePath}.wxss`);
+    }
+  };
+
+  // Add all discovered pages
+  if (result.pages) {
+    for (const page of result.pages) {
+      addFilePatterns(page.resolvedPath);
+    }
+  }
+
+  // Add all discovered components
+  if (result.components) {
+    for (const component of result.components) {
+      addFilePatterns(component.resolvedPath);
+    }
+  }
+
+  // Add all discovered workers
+  if (result.workers) {
+    for (const worker of result.workers) {
+      entries.push(`${worker.resolvedPath}`);
+    }
+  }
+
+  // Add all discovered tabBar icons
+  if (result.tabBarIcons) {
+    for (const icon of result.tabBarIcons) {
+      entries.push(icon.resolvedPath);
+    }
+  }
+
+  return entries.map(toEntry);
+};
+
+const resolveConfig: ResolveConfig<MiniprogramConfig> = async (_config, { manifest }) => {
+  const inputs = [];
+
+  // Add miniprogram-api-typings as a dev dependency if it exists in manifest
+  if (manifest.devDependencies?.['miniprogram-api-typings']) {
+    inputs.push(toDevDependency('miniprogram-api-typings'));
+  }
+
+  return inputs;
+};
+
+export default {
+  title,
+  enablers,
+  isEnabled,
+  config,
+  resolveEntryPaths,
+  resolveConfig,
+} satisfies Plugin;
diff --git a/packages/knip/src/plugins/miniprogram/parser.ts b/packages/knip/src/plugins/miniprogram/parser.ts
new file mode 100644
index 000000000..182d21f2b
--- /dev/null
+++ b/packages/knip/src/plugins/miniprogram/parser.ts
@@ -0,0 +1,89 @@
+import { readFileSync } from 'node:fs';
+
+// Parse JSON configuration files
+export function parseConfig<T>(filePath: string): T | null {
+  try {
+    const content = readFileSync(filePath, 'utf8');
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+
+// Parse WXML files for dependencies
+export function parseWxml(text: string, _filePath: string): string {
+  const results: string[] = [];
+  try {
+    // Match image sources
+    const imgRegex = /<image[^>]+src=["']([^"']+)["']/g;
+    let match: RegExpExecArray | null = imgRegex.exec(text);
+    while (match) {
+      results.push(`import '${match[1]}'`);
+      match = imgRegex.exec(text);
+    }
+
+    // Match template imports
+    const importRegex = /<import\s+src=["']([^"']+)["']/g;
+    match = importRegex.exec(text);
+    while (match) {
+      results.push(`import '${match[1]}'`);
+      match = importRegex.exec(text);
+    }
+
+    // Match template includes
+    const includeRegex = /<include\s+src=["']([^"']+)["']/g;
+    match = includeRegex.exec(text);
+    while (match) {
+      results.push(`import '${match[1]}'`);
+      match = includeRegex.exec(text);
+    }
+
+    // Match WXS module imports
+    const wxsRegex = /<wxs\s+src=["']([^"']+)["']/g;
+    match = wxsRegex.exec(text);
+    while (match) {
+      results.push(`import '${match[1]}'`);
+      match = wxsRegex.exec(text);
+    }
+
+    return results.join('\n');
+  } catch {
+    return '';
+  }
+}
+
+// Parse WXSS files for dependencies
+export function parseWxss(text: string, _filePath: string): string {
+  const results: string[] = [];
+  try {
+    // Match style imports
+    const importRegex = /@import\s+["']([^"']+)["']/g;
+    let match: RegExpExecArray | null = importRegex.exec(text);
+    while (match) {
+      results.push(`@import '${match[1]}'`);
+      match = importRegex.exec(text);
+    }
+
+    return results.join('\n');
+  } catch {
+    return '';
+  }
+}
+
+// Parse WXS files for dependencies
+export function parseWxs(text: string, _filePath: string): string {
+  const results: string[] = [];
+  try {
+    // Match require statements
+    const requireRegex = /require\s*\(\s*["']([^"']+)["']\s*\)/g;
+    let match: RegExpExecArray | null = requireRegex.exec(text);
+    while (match) {
+      results.push(`import '${match[1]}'`);
+      match = requireRegex.exec(text);
+    }
+
+    return results.join('\n');
+  } catch {
+    return '';
+  }
+} 
\ No newline at end of file
diff --git a/packages/knip/src/plugins/miniprogram/types.ts b/packages/knip/src/plugins/miniprogram/types.ts
new file mode 100644
index 000000000..6a93eb159
--- /dev/null
+++ b/packages/knip/src/plugins/miniprogram/types.ts
@@ -0,0 +1,60 @@
+// App project configuration
+export interface AppConfig {
+  pages: string[];
+  subPackages?: Array<{
+    root: string;
+    pages: string[];
+  }>;
+  usingComponents?: Record<string, string>;
+  workers?: string;
+  tabBar?: {
+    list: Array<{
+      pagePath: string;
+      iconPath?: string;
+      selectedIconPath?: string;
+    }>;
+  };
+}
+
+// Plugin project configuration
+export interface PluginConfig {
+  publicComponents: Record<string, string>;
+  pages: Record<string, string>;
+  main: string;
+}
+
+// Page configuration
+export interface PageConfig {
+  usingComponents?: Record<string, string>;
+  component?: boolean;
+}
+
+// Component configuration
+export interface ComponentConfig {
+  component: boolean;
+  usingComponents?: Record<string, string>;
+}
+
+export interface MiniprogramPluginConfig {
+  // Root directory of the miniprogram project
+  root?: string;
+  // Custom path aliases
+  paths?: Record<string, string[]>;
+}
+
+export interface MiniprogramDependency {
+  specifier: string;
+  resolvedPath: string;
+  containingFile: string;
+}
+
+export interface MiniprogramAnalysisResult {
+  pages: MiniprogramDependency[];
+  components: MiniprogramDependency[];
+  subPackagePages: Array<{
+    root: string;
+    pages: MiniprogramDependency[];
+  }>;
+  workers?: MiniprogramDependency[];
+  tabBarIcons?: MiniprogramDependency[];
+} 
\ No newline at end of file
diff --git a/packages/knip/src/plugins/miniprogram/utils.ts b/packages/knip/src/plugins/miniprogram/utils.ts
new file mode 100644
index 000000000..ebb26ea9e
--- /dev/null
+++ b/packages/knip/src/plugins/miniprogram/utils.ts
@@ -0,0 +1,206 @@
+import { existsSync, readFileSync } from 'node:fs';
+import type { HasDependency } from '../../compilers/types.js';
+import { join } from '../../util/path.js';
+import { parseConfig } from './parser.js';
+import type { AppConfig, ComponentConfig, MiniprogramAnalysisResult } from './types.js';
+
+/**
+ * Check if a directory contains a valid Mini Program project
+ */
+export const isMiniprogramProject = (cwd: string, hasDependency: HasDependency): boolean => {
+  // Check for plugin.json
+  if (existsSync(join(cwd, 'plugin.json'))) {
+    return true;
+  }
+
+  // Check for app.json with pages array
+  try {
+    const appConfig = JSON.parse(readFileSync(join(cwd, 'app.json'), 'utf8'));
+    if (Array.isArray(appConfig.pages)) {
+      return true;
+    }
+  } catch {}
+
+  // Check for miniprogram-api-typings dependency
+  return hasDependency('miniprogram-api-typings');
+};
+
+/**
+ * Resolves a Mini Program path to its absolute path based on the project root and path aliases.
+ * Handles three types of paths:
+ * 1. Absolute paths (starting with '/') - resolved relative to project root
+ * 2. Alias paths (matching configured aliases) - resolved using the first target path
+ * 3. Relative paths - resolved relative to project root
+ * 
+ * @param path - The path to resolve (can be absolute, aliased, or relative)
+ * @param cwd - The project root directory
+ * @param paths - Optional path alias configuration mapping aliases to target paths
+ * @returns The resolved absolute path
+ */
+const resolveMiniprogramPath = (path: string, cwd: string, paths?: Record<string, string[]>): string => {
+  // Handle absolute paths
+  if (path.startsWith('/')) {
+    return join(cwd, path);
+  }
+
+  // Handle alias paths
+  if (paths) {
+    for (const [alias, targets] of Object.entries(paths)) {
+      // Strip wildcard from alias and target
+      const baseAlias = alias.endsWith('/*') ? alias.slice(0, -2) : alias;
+      const baseTarget = targets[0].endsWith('/*') ? targets[0].slice(0, -2) : targets[0];
+
+      if (path.startsWith(baseAlias)) {
+        const relativePath = path.slice(baseAlias.length + (path[baseAlias.length] === '/' ? 1 : 0));
+        return join(cwd, baseTarget, relativePath);
+      }
+    }
+  }
+
+  // Handle built-in alias paths (starting with @ or ~)
+  if (path.startsWith('@components/')) {
+    return join(cwd, 'components', path.slice('@components/'.length));
+  }
+  if (path.startsWith('~/')) {
+    return join(cwd, path.slice(2));
+  }
+
+  // Handle relative paths
+  return join(cwd, path);
+};
+
+interface MiniprogramAnalysisOptions {
+  paths?: Record<string, string[]>;
+}
+
+/**
+ * Analyze a Mini Program project starting from app.json
+ * Returns all pages, components, and other assets used in the project
+ * 
+ * File structure:
+ * - Components:
+ *   Required:
+ *   - .json (must have "component": true)
+ *   - .js (component logic)
+ *   - .wxml (component template)
+ *   Optional:
+ *   - .wxss (component styles)
+ * 
+ * - Pages:
+ *   Required:
+ *   - .json (page config)
+ *   - .js (page logic)
+ *   - .wxml (page template)
+ *   Optional:
+ *   - .wxss (page styles)
+ */
+export const analyzeMiniprogramProject = (cwd: string, options: MiniprogramAnalysisOptions = {}): MiniprogramAnalysisResult => {
+  const result: MiniprogramAnalysisResult = {
+    pages: [],
+    components: [],
+    subPackagePages: [],
+    workers: [],
+    tabBarIcons: []
+  };
+
+  // Read and parse app.json
+  try {
+    const appJsonPath = join(cwd, 'app.json');
+    const appConfig = parseConfig<AppConfig>(appJsonPath);
+    
+    if (!appConfig || typeof appConfig !== 'object') {
+      console.error('Invalid app.json config', appJsonPath);
+      return result;
+    }
+
+    // Add main pages
+    if (Array.isArray(appConfig.pages)) {
+      result.pages.push(...appConfig.pages.map(page => ({
+        specifier: page,
+        resolvedPath: resolveMiniprogramPath(page, cwd, options.paths),
+        containingFile: appJsonPath
+      })));
+    }
+
+    // Add global components
+    if (appConfig.usingComponents) {
+      result.components.push(...Object.values(appConfig.usingComponents).map(component => ({
+        specifier: component,
+        resolvedPath: resolveMiniprogramPath(component, cwd, options.paths),
+        containingFile: appJsonPath
+      })));
+    }
+
+    // Add worker
+    if (appConfig.workers) {
+      result.workers?.push({
+        specifier: appConfig.workers,
+        resolvedPath: resolveMiniprogramPath(appConfig.workers, cwd, options.paths),
+        containingFile: appJsonPath
+      });
+    }
+
+    // Add tabBar icons
+    if (appConfig.tabBar?.list) {
+      for (const tab of appConfig.tabBar.list) {
+        if (tab.iconPath) {
+          result.tabBarIcons?.push({
+            specifier: tab.iconPath,
+            resolvedPath: resolveMiniprogramPath(tab.iconPath, cwd, options.paths),
+            containingFile: appJsonPath
+          });
+        }
+        if (tab.selectedIconPath) {
+          result.tabBarIcons?.push({
+            specifier: tab.selectedIconPath,
+            resolvedPath: resolveMiniprogramPath(tab.selectedIconPath, cwd, options.paths),
+            containingFile: appJsonPath
+          });
+        }
+      }
+    }
+
+    // Analyze components used in pages
+    const processedPaths = new Set<string>();
+    const findComponents = (filePath: string, _containingFile: string) => {
+      if (processedPaths.has(filePath)) {
+        return;
+      }
+      processedPaths.add(filePath);
+
+      try {
+        // If filePath is already absolute, use it directly
+        const configPath = filePath.startsWith('/') ? `${filePath}.json` : join(cwd, `${filePath}.json`);
+        const config = parseConfig<ComponentConfig>(configPath);
+        
+        if (config?.usingComponents) {
+          const components = Object.values(config.usingComponents);
+          result.components.push(...components.map(component => ({
+            specifier: component,
+            resolvedPath: resolveMiniprogramPath(component, cwd, options.paths),
+            containingFile: configPath
+          })));
+          
+          // Recursively process components
+          for (const component of components) {
+            const resolvedPath = resolveMiniprogramPath(component, cwd, options.paths);
+            findComponents(resolvedPath, configPath);
+          }
+        }
+      } catch (error) {
+        console.error('Error reading component config:', error);
+      }
+    };
+
+    // Process all pages and their components
+    for (const page of result.pages) {
+      findComponents(page.resolvedPath, page.containingFile);
+    }
+
+
+  } catch (error) {
+    console.error('Error analyzing Mini Program project:', error);
+  }
+
+  return result;
+};
\ No newline at end of file
diff --git a/packages/knip/src/schema/plugins.ts b/packages/knip/src/schema/plugins.ts
index 2273c45ee..7542f16dd 100644
--- a/packages/knip/src/schema/plugins.ts
+++ b/packages/knip/src/schema/plugins.ts
@@ -45,6 +45,7 @@ export const pluginsSchema = z.object({
   'lost-pixel': pluginSchema,
   markdownlint: pluginSchema,
   metro: pluginSchema,
+  miniprogram: pluginSchema,
   mocha: pluginSchema,
   moonrepo: pluginSchema,
   msw: pluginSchema,
diff --git a/packages/knip/src/types/PluginNames.ts b/packages/knip/src/types/PluginNames.ts
index 959b680e7..b8ec1f27f 100644
--- a/packages/knip/src/types/PluginNames.ts
+++ b/packages/knip/src/types/PluginNames.ts
@@ -32,6 +32,7 @@ export type PluginName =
   | 'lost-pixel'
   | 'markdownlint'
   | 'metro'
+  | 'miniprogram'
   | 'mocha'
   | 'moonrepo'
   | 'msw'
@@ -124,6 +125,7 @@ export const pluginNames = [
   'lost-pixel',
   'markdownlint',
   'metro',
+  'miniprogram',
   'mocha',
   'moonrepo',
   'msw',
diff --git a/packages/knip/src/util/get-referenced-inputs.ts b/packages/knip/src/util/get-referenced-inputs.ts
index 58992ab61..cfb42f832 100644
--- a/packages/knip/src/util/get-referenced-inputs.ts
+++ b/packages/knip/src/util/get-referenced-inputs.ts
@@ -3,8 +3,7 @@ import type { DependencyDeputy } from '../DependencyDeputy.js';
 import type { IssueCollector } from '../IssueCollector.js';
 import { IGNORED_RUNTIME_DEPENDENCIES } from '../constants.js';
 import { debugLog } from './debug.js';
-import { toDebugString } from './input.js';
-import { type Input, fromBinary, isBinary, isConfigPattern, isDeferResolveEntry, isDependency } from './input.js';
+import { type Input, fromBinary, isBinary, isConfigPattern, isDeferResolveEntry, isDependency, toDebugString } from './input.js';
 import { getPackageNameFromSpecifier } from './modules.js';
 import { dirname, isAbsolute, isInternal, join } from './path.js';
 import { _resolveSync } from './resolve.js';
diff --git a/packages/knip/test/plugins/miniprogram/miniprogram.test.ts b/packages/knip/test/plugins/miniprogram/miniprogram.test.ts
new file mode 100644
index 000000000..d92bbef73
--- /dev/null
+++ b/packages/knip/test/plugins/miniprogram/miniprogram.test.ts
@@ -0,0 +1,52 @@
+import { test } from 'bun:test';
+import assert from 'node:assert/strict';
+import { main } from '../../../src/index.js';
+import { join, resolve } from '../../../src/util/path.js';
+import baseArguments from '../../helpers/baseArguments.js';
+import baseCounters from '../../helpers/baseCounters.js';
+
+test('Mini Program app project dependencies', async () => {
+  const cwd = resolve('fixtures/plugins/miniprogram/app-project');
+  const { issues, counters } = await main({
+    ...baseArguments,
+    cwd,
+  });
+
+  // Verify unresolved dependencies (files referenced but don't exist)
+  assert(issues.unresolved['app.wxss']?.['/styles/missing-theme']);
+  assert(issues.unresolved['pages/index/helper.wxs']?.['./missing-common.wxs']);
+  assert(issues.unresolved['pages/index/index.wxml']?.['/templates/missing-list.wxml']);
+  assert(issues.unresolved['pages/index/index.wxml']?.['/templates/used-list.wxml']);
+  assert(issues.unresolved['pages/index/index.wxml']?.['/templates/used-item.wxml']);
+  assert(issues.unresolved['pages/index/index.wxml']?.['/templates/missing-item.wxml']);
+  assert(issues.unresolved['pages/index/index.wxml']?.['/utils/missing-format.wxs']);
+  assert(issues.unresolved['pages/index/index.wxss']?.['/styles/missing-theme.wxss']);
+  assert(issues.unresolved['pages/index/index.ts']?.['~/utils/missing-date']);
+
+  // Verify unreferenced files (files that exist but aren't used)
+  const unreferencedFiles = new Set([
+    join(cwd, 'styles/unused-theme.wxss'),
+    join(cwd, 'wxs/unused-format.wxs'),
+    join(cwd, 'templates/unused-card.wxml'),
+    join(cwd, 'templates/used-item.wxml'),
+    join(cwd, 'components/unused-button/index.json'),
+    join(cwd, 'components/unused-button/index.js'),
+    join(cwd, 'components/unused-counter/index.json'),
+    join(cwd, 'components/unused-counter/index.ts'),
+  ]);
+
+  // All unreferenced files should be reported
+  for (const file of unreferencedFiles) {
+    assert(issues.files.has(file), `Expected ${file} to be reported as unreferenced`);
+  }
+
+  assert.deepEqual(counters, {
+    ...baseCounters,
+    files: 9, // Number of unreferenced files
+    unresolved: 10, // Number of missing files that are referenced
+    processed: 23,
+    total: 23, // Total files including both referenced and unreferenced
+    devDependencies: 0, // No problematic dev dependencies (miniprogram-api-typings is an allowed dependency)
+    unlisted: 0,
+  });
+});
diff --git a/packages/knip/test/plugins/miniprogram/parser.test.ts b/packages/knip/test/plugins/miniprogram/parser.test.ts
new file mode 100644
index 000000000..b5b04bad0
--- /dev/null
+++ b/packages/knip/test/plugins/miniprogram/parser.test.ts
@@ -0,0 +1,94 @@
+import { test } from 'bun:test';
+import assert from 'node:assert/strict';
+import { parseWxml, parseWxs, parseWxss } from '../../../src/plugins/miniprogram/parser.js';
+
+test('parseWxml should parse dependencies correctly', () => {
+  const wxml = `
+    <wxs src="/utils/format.wxs" module="format" />
+    <wxs src="./helper.wxs" module="helper" />
+    
+    <import src="/templates/list" />
+    <import src="./item.wxml" />
+    
+    <include src="/templates/header" />
+    
+    <view class="container">
+      <image src="/images/logo.png" />
+      <image src="./icon.png" />
+    </view>
+  `;
+
+  const result = parseWxml(wxml, 'test.wxml');
+  const expected = [
+    "import '/images/logo.png'",
+    "import './icon.png'",
+    "import '/templates/list'",
+    "import './item.wxml'",
+    "import '/templates/header'",
+    "import '/utils/format.wxs'",
+    "import './helper.wxs'"
+  ].join('\n');
+
+  assert.equal(result, expected);
+});
+
+test('parseWxml should handle empty or invalid input', () => {
+  assert.equal(parseWxml('', 'test.wxml'), '');
+  assert.equal(parseWxml('<invalid>', 'test.wxml'), '');
+});
+
+test('parseWxss should parse dependencies correctly', () => {
+  const wxss = `
+    @import "/styles/theme.wxss";
+    @import "./local.wxss";
+    @import "@styles/alias.wxss";
+    @import "~/styles/root.wxss";
+    
+    .container {
+      padding: 20px;
+    }
+  `;
+
+  const result = parseWxss(wxss, 'test.wxss');
+  const expected = [
+    "@import '/styles/theme.wxss'",
+    "@import './local.wxss'",
+    "@import '@styles/alias.wxss'",
+    "@import '~/styles/root.wxss'"
+  ].join('\n');
+
+  assert.equal(result, expected);
+});
+
+test('parseWxss should handle empty or invalid input', () => {
+  assert.equal(parseWxss('', 'test.wxss'), '');
+  assert.equal(parseWxss('.invalid {', 'test.wxss'), '');
+});
+
+test('parseWxs should parse dependencies correctly', () => {
+  const wxs = `
+    var common = require('/utils/common.wxs');
+    var helper = require('./helper.wxs');
+    var format = require('@utils/format.wxs');
+    var util = require('~/utils/util.wxs');
+    
+    module.exports = {
+      format: common.format
+    };
+  `;
+
+  const result = parseWxs(wxs, 'test.wxs');
+  const expected = [
+    "import '/utils/common.wxs'",
+    "import './helper.wxs'",
+    "import '@utils/format.wxs'",
+    "import '~/utils/util.wxs'"
+  ].join('\n');
+
+  assert.equal(result, expected);
+});
+
+test('parseWxs should handle empty or invalid input', () => {
+  assert.equal(parseWxs('', 'test.wxs'), '');
+  assert.equal(parseWxs('invalid javascript', 'test.wxs'), '');
+}); 
\ No newline at end of file
diff --git a/packages/knip/test/plugins/miniprogram/utils.test.ts b/packages/knip/test/plugins/miniprogram/utils.test.ts
new file mode 100644
index 000000000..f2ec343de
--- /dev/null
+++ b/packages/knip/test/plugins/miniprogram/utils.test.ts
@@ -0,0 +1,104 @@
+import { test } from 'bun:test';
+import assert from 'node:assert/strict';
+import { analyzeMiniprogramProject } from '../../../src/plugins/miniprogram/utils.js';
+import { join, resolve } from '../../../src/util/path.js';
+
+const fixturesDir = resolve('packages/knip/fixtures/plugins/miniprogram/app-project');
+
+test('should analyze miniprogram project', () => {
+  const result = analyzeMiniprogramProject(fixturesDir);
+
+  // Check pages
+  assert.equal(result.pages.length, 1);
+  assert.equal(result.pages[0].specifier, 'pages/index/index');
+  assert.equal(result.pages[0].resolvedPath, join(fixturesDir, 'pages/index/index'));
+  assert.equal(result.pages[0].containingFile, join(fixturesDir, 'app.json'));
+
+  // Check components
+  assert.equal(result.components.length, 5);
+  
+  // Check global components from app.json
+  const missingHeader = result.components.find(c => c.specifier === '/components/missing-header/index');
+  assert.ok(missingHeader);
+  assert.equal(missingHeader.resolvedPath, join(fixturesDir, '/components/missing-header/index'));
+  assert.equal(missingHeader.containingFile, join(fixturesDir, 'app.json'));
+
+  const usedFooter = result.components.find(c => c.specifier === '/components/used-footer/index');
+  assert.ok(usedFooter);
+  assert.equal(usedFooter.resolvedPath, join(fixturesDir, '/components/used-footer/index'));
+  assert.equal(usedFooter.containingFile, join(fixturesDir, 'app.json'));
+
+  // Check page components
+  const missingButton = result.components.find(c => c.specifier === '@components/missing-button');
+  assert.ok(missingButton);
+  assert.equal(missingButton.resolvedPath, join(fixturesDir, 'components/missing-button'));
+  assert.equal(missingButton.containingFile, join(fixturesDir, 'pages/index/index.json'));
+
+  const missingHelper = result.components.find(c => c.specifier === '~/utils/missing-helper');
+  assert.ok(missingHelper);
+  assert.equal(missingHelper.resolvedPath, join(fixturesDir, 'utils/missing-helper'));
+  assert.equal(missingHelper.containingFile, join(fixturesDir, 'pages/index/index.json'));
+
+  const pageFooter = result.components.find(c => c.specifier === './missing-footer');
+  assert.ok(pageFooter);
+  assert.equal(pageFooter.resolvedPath, join(fixturesDir, 'missing-footer'));
+  assert.equal(pageFooter.containingFile, join(fixturesDir, 'pages/index/index.json'));
+
+  // Check workers
+  assert.equal(result.workers?.length, 1);
+  assert.equal(result.workers?.[0].specifier, 'workers/missing-worker');
+  assert.equal(result.workers?.[0].resolvedPath, join(fixturesDir, 'workers/missing-worker'));
+  assert.equal(result.workers?.[0].containingFile, join(fixturesDir, 'app.json'));
+
+  // Check tabBar icons
+  assert.equal(result.tabBarIcons?.length, 2);
+  const iconPath = result.tabBarIcons?.find(i => i.specifier === 'images/missing-icon.png');
+  assert.ok(iconPath);
+  assert.equal(iconPath.resolvedPath, join(fixturesDir, 'images/missing-icon.png'));
+  assert.equal(iconPath.containingFile, join(fixturesDir, 'app.json'));
+
+  const selectedIconPath = result.tabBarIcons?.find(i => i.specifier === 'images/missing-icon-selected.png');
+  assert.ok(selectedIconPath);
+  assert.equal(selectedIconPath.resolvedPath, join(fixturesDir, 'images/missing-icon-selected.png'));
+  assert.equal(selectedIconPath.containingFile, join(fixturesDir, 'app.json'));
+});
+
+test('should handle path aliases', () => {
+  const result = analyzeMiniprogramProject(fixturesDir, {
+    paths: {
+      '@components': ['components'],
+      '@utils': ['utils'],
+      '~': ['.']
+    }
+  });
+
+  // Check aliased components
+  assert.equal(result.components.length, 5);
+  
+  // Check global components from app.json
+  const missingHeader = result.components.find(c => c.specifier === '/components/missing-header/index');
+  assert.ok(missingHeader);
+  assert.equal(missingHeader.resolvedPath, join(fixturesDir, '/components/missing-header/index'));
+  assert.equal(missingHeader.containingFile, join(fixturesDir, 'app.json'));
+
+  const usedFooter = result.components.find(c => c.specifier === '/components/used-footer/index');
+  assert.ok(usedFooter);
+  assert.equal(usedFooter.resolvedPath, join(fixturesDir, '/components/used-footer/index'));
+  assert.equal(usedFooter.containingFile, join(fixturesDir, 'app.json'));
+
+  // Check page components
+  const missingButton = result.components.find(c => c.specifier === '@components/missing-button');
+  assert.ok(missingButton);
+  assert.equal(missingButton.resolvedPath, join(fixturesDir, 'components/missing-button'));
+  assert.equal(missingButton.containingFile, join(fixturesDir, 'pages/index/index.json'));
+
+  const missingHelper = result.components.find(c => c.specifier === '~/utils/missing-helper');
+  assert.ok(missingHelper);
+  assert.equal(missingHelper.resolvedPath, join(fixturesDir, 'utils/missing-helper'));
+  assert.equal(missingHelper.containingFile, join(fixturesDir, 'pages/index/index.json'));
+
+  const pageFooter = result.components.find(c => c.specifier === './missing-footer');
+  assert.ok(pageFooter);
+  assert.equal(pageFooter.resolvedPath, join(fixturesDir, 'missing-footer'));
+  assert.equal(pageFooter.containingFile, join(fixturesDir, 'pages/index/index.json'));
+}); 
\ No newline at end of file

From b55ab449392aa9f4a97befb2a76aa6afe3a29191 Mon Sep 17 00:00:00 2001
From: chess99 <chess99@126.com>
Date: Sun, 12 Jan 2025 20:25:26 +0800
Subject: [PATCH 2/2] Run `npm run format` (from root)

---
 packages/knip/src/compilers/miniprogram.ts    |  4 +-
 .../knip/src/plugins/miniprogram/parser.ts    |  2 +-
 .../knip/src/plugins/miniprogram/types.ts     |  2 +-
 .../knip/src/plugins/miniprogram/utils.ts     | 65 ++++++++++---------
 .../knip/src/util/get-referenced-inputs.ts    | 10 ++-
 .../test/plugins/miniprogram/parser.test.ts   |  8 +--
 .../test/plugins/miniprogram/utils.test.ts    | 10 +--
 7 files changed, 58 insertions(+), 43 deletions(-)

diff --git a/packages/knip/src/compilers/miniprogram.ts b/packages/knip/src/compilers/miniprogram.ts
index 8c31140a3..f617012ed 100644
--- a/packages/knip/src/compilers/miniprogram.ts
+++ b/packages/knip/src/compilers/miniprogram.ts
@@ -3,7 +3,7 @@ import type { HasDependency } from './types.js';
 
 // Enable compilers when miniprogram-api-typings is present (indicating a Mini Program project)
 const isMiniprogramProject = (hasDependency: HasDependency) => {
-    return hasDependency('miniprogram-api-typings');
+  return hasDependency('miniprogram-api-typings');
 };
 
 // We don't parse JSON files in the compiler because:
@@ -13,7 +13,7 @@ const isMiniprogramProject = (hasDependency: HasDependency) => {
 // 2. The only purpose of this JSON compiler is to make getCompilerExtensions include
 //    JSON files as project files, so they can be analyzed for usage
 const parseJson = (text: string) => {
-    return text;
+  return text;
 };
 
 const wxml = { condition: isMiniprogramProject, compiler: parseWxml };
diff --git a/packages/knip/src/plugins/miniprogram/parser.ts b/packages/knip/src/plugins/miniprogram/parser.ts
index 182d21f2b..89bff1802 100644
--- a/packages/knip/src/plugins/miniprogram/parser.ts
+++ b/packages/knip/src/plugins/miniprogram/parser.ts
@@ -86,4 +86,4 @@ export function parseWxs(text: string, _filePath: string): string {
   } catch {
     return '';
   }
-} 
\ No newline at end of file
+}
diff --git a/packages/knip/src/plugins/miniprogram/types.ts b/packages/knip/src/plugins/miniprogram/types.ts
index 6a93eb159..67062897e 100644
--- a/packages/knip/src/plugins/miniprogram/types.ts
+++ b/packages/knip/src/plugins/miniprogram/types.ts
@@ -57,4 +57,4 @@ export interface MiniprogramAnalysisResult {
   }>;
   workers?: MiniprogramDependency[];
   tabBarIcons?: MiniprogramDependency[];
-} 
\ No newline at end of file
+}
diff --git a/packages/knip/src/plugins/miniprogram/utils.ts b/packages/knip/src/plugins/miniprogram/utils.ts
index ebb26ea9e..3a64628fb 100644
--- a/packages/knip/src/plugins/miniprogram/utils.ts
+++ b/packages/knip/src/plugins/miniprogram/utils.ts
@@ -31,7 +31,7 @@ export const isMiniprogramProject = (cwd: string, hasDependency: HasDependency):
  * 1. Absolute paths (starting with '/') - resolved relative to project root
  * 2. Alias paths (matching configured aliases) - resolved using the first target path
  * 3. Relative paths - resolved relative to project root
- * 
+ *
  * @param path - The path to resolve (can be absolute, aliased, or relative)
  * @param cwd - The project root directory
  * @param paths - Optional path alias configuration mapping aliases to target paths
@@ -76,7 +76,7 @@ interface MiniprogramAnalysisOptions {
 /**
  * Analyze a Mini Program project starting from app.json
  * Returns all pages, components, and other assets used in the project
- * 
+ *
  * File structure:
  * - Components:
  *   Required:
@@ -85,7 +85,7 @@ interface MiniprogramAnalysisOptions {
  *   - .wxml (component template)
  *   Optional:
  *   - .wxss (component styles)
- * 
+ *
  * - Pages:
  *   Required:
  *   - .json (page config)
@@ -94,20 +94,23 @@ interface MiniprogramAnalysisOptions {
  *   Optional:
  *   - .wxss (page styles)
  */
-export const analyzeMiniprogramProject = (cwd: string, options: MiniprogramAnalysisOptions = {}): MiniprogramAnalysisResult => {
+export const analyzeMiniprogramProject = (
+  cwd: string,
+  options: MiniprogramAnalysisOptions = {}
+): MiniprogramAnalysisResult => {
   const result: MiniprogramAnalysisResult = {
     pages: [],
     components: [],
     subPackagePages: [],
     workers: [],
-    tabBarIcons: []
+    tabBarIcons: [],
   };
 
   // Read and parse app.json
   try {
     const appJsonPath = join(cwd, 'app.json');
     const appConfig = parseConfig<AppConfig>(appJsonPath);
-    
+
     if (!appConfig || typeof appConfig !== 'object') {
       console.error('Invalid app.json config', appJsonPath);
       return result;
@@ -115,20 +118,24 @@ export const analyzeMiniprogramProject = (cwd: string, options: MiniprogramAnaly
 
     // Add main pages
     if (Array.isArray(appConfig.pages)) {
-      result.pages.push(...appConfig.pages.map(page => ({
-        specifier: page,
-        resolvedPath: resolveMiniprogramPath(page, cwd, options.paths),
-        containingFile: appJsonPath
-      })));
+      result.pages.push(
+        ...appConfig.pages.map(page => ({
+          specifier: page,
+          resolvedPath: resolveMiniprogramPath(page, cwd, options.paths),
+          containingFile: appJsonPath,
+        }))
+      );
     }
 
     // Add global components
     if (appConfig.usingComponents) {
-      result.components.push(...Object.values(appConfig.usingComponents).map(component => ({
-        specifier: component,
-        resolvedPath: resolveMiniprogramPath(component, cwd, options.paths),
-        containingFile: appJsonPath
-      })));
+      result.components.push(
+        ...Object.values(appConfig.usingComponents).map(component => ({
+          specifier: component,
+          resolvedPath: resolveMiniprogramPath(component, cwd, options.paths),
+          containingFile: appJsonPath,
+        }))
+      );
     }
 
     // Add worker
@@ -136,7 +143,7 @@ export const analyzeMiniprogramProject = (cwd: string, options: MiniprogramAnaly
       result.workers?.push({
         specifier: appConfig.workers,
         resolvedPath: resolveMiniprogramPath(appConfig.workers, cwd, options.paths),
-        containingFile: appJsonPath
+        containingFile: appJsonPath,
       });
     }
 
@@ -147,14 +154,14 @@ export const analyzeMiniprogramProject = (cwd: string, options: MiniprogramAnaly
           result.tabBarIcons?.push({
             specifier: tab.iconPath,
             resolvedPath: resolveMiniprogramPath(tab.iconPath, cwd, options.paths),
-            containingFile: appJsonPath
+            containingFile: appJsonPath,
           });
         }
         if (tab.selectedIconPath) {
           result.tabBarIcons?.push({
             specifier: tab.selectedIconPath,
             resolvedPath: resolveMiniprogramPath(tab.selectedIconPath, cwd, options.paths),
-            containingFile: appJsonPath
+            containingFile: appJsonPath,
           });
         }
       }
@@ -172,15 +179,17 @@ export const analyzeMiniprogramProject = (cwd: string, options: MiniprogramAnaly
         // If filePath is already absolute, use it directly
         const configPath = filePath.startsWith('/') ? `${filePath}.json` : join(cwd, `${filePath}.json`);
         const config = parseConfig<ComponentConfig>(configPath);
-        
+
         if (config?.usingComponents) {
           const components = Object.values(config.usingComponents);
-          result.components.push(...components.map(component => ({
-            specifier: component,
-            resolvedPath: resolveMiniprogramPath(component, cwd, options.paths),
-            containingFile: configPath
-          })));
-          
+          result.components.push(
+            ...components.map(component => ({
+              specifier: component,
+              resolvedPath: resolveMiniprogramPath(component, cwd, options.paths),
+              containingFile: configPath,
+            }))
+          );
+
           // Recursively process components
           for (const component of components) {
             const resolvedPath = resolveMiniprogramPath(component, cwd, options.paths);
@@ -196,11 +205,9 @@ export const analyzeMiniprogramProject = (cwd: string, options: MiniprogramAnaly
     for (const page of result.pages) {
       findComponents(page.resolvedPath, page.containingFile);
     }
-
-
   } catch (error) {
     console.error('Error analyzing Mini Program project:', error);
   }
 
   return result;
-};
\ No newline at end of file
+};
diff --git a/packages/knip/src/util/get-referenced-inputs.ts b/packages/knip/src/util/get-referenced-inputs.ts
index cfb42f832..1b9128fe7 100644
--- a/packages/knip/src/util/get-referenced-inputs.ts
+++ b/packages/knip/src/util/get-referenced-inputs.ts
@@ -3,7 +3,15 @@ import type { DependencyDeputy } from '../DependencyDeputy.js';
 import type { IssueCollector } from '../IssueCollector.js';
 import { IGNORED_RUNTIME_DEPENDENCIES } from '../constants.js';
 import { debugLog } from './debug.js';
-import { type Input, fromBinary, isBinary, isConfigPattern, isDeferResolveEntry, isDependency, toDebugString } from './input.js';
+import {
+  type Input,
+  fromBinary,
+  isBinary,
+  isConfigPattern,
+  isDeferResolveEntry,
+  isDependency,
+  toDebugString,
+} from './input.js';
 import { getPackageNameFromSpecifier } from './modules.js';
 import { dirname, isAbsolute, isInternal, join } from './path.js';
 import { _resolveSync } from './resolve.js';
diff --git a/packages/knip/test/plugins/miniprogram/parser.test.ts b/packages/knip/test/plugins/miniprogram/parser.test.ts
index b5b04bad0..3d7a6136d 100644
--- a/packages/knip/test/plugins/miniprogram/parser.test.ts
+++ b/packages/knip/test/plugins/miniprogram/parser.test.ts
@@ -26,7 +26,7 @@ test('parseWxml should parse dependencies correctly', () => {
     "import './item.wxml'",
     "import '/templates/header'",
     "import '/utils/format.wxs'",
-    "import './helper.wxs'"
+    "import './helper.wxs'",
   ].join('\n');
 
   assert.equal(result, expected);
@@ -54,7 +54,7 @@ test('parseWxss should parse dependencies correctly', () => {
     "@import '/styles/theme.wxss'",
     "@import './local.wxss'",
     "@import '@styles/alias.wxss'",
-    "@import '~/styles/root.wxss'"
+    "@import '~/styles/root.wxss'",
   ].join('\n');
 
   assert.equal(result, expected);
@@ -82,7 +82,7 @@ test('parseWxs should parse dependencies correctly', () => {
     "import '/utils/common.wxs'",
     "import './helper.wxs'",
     "import '@utils/format.wxs'",
-    "import '~/utils/util.wxs'"
+    "import '~/utils/util.wxs'",
   ].join('\n');
 
   assert.equal(result, expected);
@@ -91,4 +91,4 @@ test('parseWxs should parse dependencies correctly', () => {
 test('parseWxs should handle empty or invalid input', () => {
   assert.equal(parseWxs('', 'test.wxs'), '');
   assert.equal(parseWxs('invalid javascript', 'test.wxs'), '');
-}); 
\ No newline at end of file
+});
diff --git a/packages/knip/test/plugins/miniprogram/utils.test.ts b/packages/knip/test/plugins/miniprogram/utils.test.ts
index f2ec343de..c097cf71f 100644
--- a/packages/knip/test/plugins/miniprogram/utils.test.ts
+++ b/packages/knip/test/plugins/miniprogram/utils.test.ts
@@ -16,7 +16,7 @@ test('should analyze miniprogram project', () => {
 
   // Check components
   assert.equal(result.components.length, 5);
-  
+
   // Check global components from app.json
   const missingHeader = result.components.find(c => c.specifier === '/components/missing-header/index');
   assert.ok(missingHeader);
@@ -68,13 +68,13 @@ test('should handle path aliases', () => {
     paths: {
       '@components': ['components'],
       '@utils': ['utils'],
-      '~': ['.']
-    }
+      '~': ['.'],
+    },
   });
 
   // Check aliased components
   assert.equal(result.components.length, 5);
-  
+
   // Check global components from app.json
   const missingHeader = result.components.find(c => c.specifier === '/components/missing-header/index');
   assert.ok(missingHeader);
@@ -101,4 +101,4 @@ test('should handle path aliases', () => {
   assert.ok(pageFooter);
   assert.equal(pageFooter.resolvedPath, join(fixturesDir, 'missing-footer'));
   assert.equal(pageFooter.containingFile, join(fixturesDir, 'pages/index/index.json'));
-}); 
\ No newline at end of file
+});