z-paging-wevu 0.1.0 → 0.1.1

package/README.md

@@ -2,7 +2,7 @@
 
 面向 **weapp-vite + wevu + Vue SFC** 的 z-paging 兼容实现。保留 z-paging 的分页心智模型，同时针对微信小程序运行时处理事件参数、虚拟列表和布局差异。
 
-> 当前版本为 0.1.0，目标是微信小程序；nvue 专属渲染仅保留兼容入口。
+> 当前版本为 0.1.1，目标是微信小程序；nvue 专属渲染仅保留兼容入口。
 
 ## 能力
 
@@ -20,14 +20,34 @@
 pnpm add z-paging-wevu wevu
 ```
 
-也可以直接将 `src/components/z-paging-wevu/` 复制到项目的组件目录。
+在 `weapp-vite.config.ts` 中注册随包提供的 SFC 解析器：
+
+```ts
+import { defineConfig } from 'weapp-vite'
+import { ZPagingWevuResolver } from 'z-paging-wevu/resolver'
+
+export default defineConfig({
+  weapp: {
+    autoImportComponents: {
+      resolvers: [ZPagingWevuResolver()],
+      vueComponents: true,
+      vueComponentsModule: 'wevu',
+    },
+    uniApp: {
+      include: ['z-paging-wevu'],
+    },
+  },
+})
+```
+
+不要把 `z-paging-wevu` 加入 `weapp.npm.include`，否则原始 Vue SFC 会被交给普通 JavaScript 打包器。也可以直接将 `src/components/z-paging-wevu/` 复制到项目的组件目录。
 
 ## 快速开始
 
 ```vue
 <script setup lang="ts">
 import { ref } from 'wevu'
-import ZPagingWevu, { createPagingController } from 'z-paging-wevu'
+import { createPagingController } from 'z-paging-wevu/controller'
 
 const items = ref<Record<string, unknown>[]>([])
 const paging = createPagingController()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "z-paging-wevu",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "面向 weapp-vite + wevu 的 z-paging 兼容分页组件",
   "type": "module",
   "license": "MIT",
@@ -37,10 +37,16 @@
     "./props": {
       "types": "./src/components/z-paging-wevu/props.ts",
       "default": "./src/components/z-paging-wevu/props.ts"
+    },
+    "./resolver": {
+      "types": "./resolver.d.ts",
+      "default": "./resolver.mjs"
     }
   },
   "files": [
     "src",
+    "resolver.mjs",
+    "resolver.d.ts",
     "README.md",
     "LICENSE"
   ],

package/resolver.d.ts

@@ -0,0 +1,14 @@
+export interface ZPagingWevuResolveResult {
+  name: 'ZPagingWevu'
+  from: 'z-paging-wevu/component'
+  resolvedId: 'z-paging-wevu/component'
+  sourceType: 'wevu-sfc'
+  typeImport: false
+}
+
+export interface ZPagingWevuResolver {
+  components: Readonly<Record<'ZPagingWevu', 'z-paging-wevu/component'>>
+  resolve: (name: string) => ZPagingWevuResolveResult | undefined
+}
+
+export declare function ZPagingWevuResolver(): ZPagingWevuResolver

package/resolver.mjs

@@ -0,0 +1,21 @@
+const componentName = 'ZPagingWevu'
+const componentEntry = 'z-paging-wevu/component'
+
+/** 将 npm 包中的 Vue SFC 交给 weapp-vite 的 wevu 模板编译链路。 */
+export function ZPagingWevuResolver() {
+  return {
+    components: Object.freeze({ [componentName]: componentEntry }),
+    resolve(name) {
+      if (name !== componentName) {
+        return
+      }
+      return {
+        name,
+        from: componentEntry,
+        resolvedId: componentEntry,
+        sourceType: 'wevu-sfc',
+        typeImport: false,
+      }
+    },
+  }
+}