jyj-components 1.0.0

package/.babelrc

@@ -0,0 +1,11 @@
+{
+    "plugins": [
+        ["module-resolver", {
+            "root": ["./src"],
+            "alias": {}
+        }]
+    ],
+    "presets": [
+        ["env", {"loose": true, "modules": "commonjs"}]
+    ]
+}

package/.eslintrc.js

@@ -0,0 +1,101 @@
+module.exports = {
+  'extends': [
+    'airbnb-base',
+    'plugin:promise/recommended'
+  ],
+  'parser': '@typescript-eslint/parser',
+  'plugins': ['@typescript-eslint'],
+  'parserOptions': {
+    'ecmaVersion': 9,
+    'ecmaFeatures': {
+      'jsx': false
+    },
+    'sourceType': 'module'
+  },
+  'env': {
+    'es6': true,
+    'node': true,
+    'jest': true
+  },
+  'plugins': [
+    'import',
+    'node',
+    'promise'
+  ],
+  'rules': {
+    'arrow-parens': 'off',
+    'comma-dangle': [
+      'error',
+      'only-multiline'
+    ],
+    'complexity': ['error', 20],
+    'func-names': 'off',
+    'global-require': 'off',
+    'handle-callback-err': [
+      'error',
+      '^(err|error)$'
+    ],
+    'import/no-unresolved': [
+      'error',
+      {
+        'caseSensitive': true,
+        'commonjs': true,
+        'ignore': ['^[^.]']
+      }
+    ],
+    'import/prefer-default-export': 'off',
+    'linebreak-style': 'off',
+    'no-catch-shadow': 'error',
+    'no-continue': 'off',
+    'no-div-regex': 'warn',
+    'no-else-return': 'off',
+    'no-param-reassign': 'off',
+    'no-plusplus': 'off',
+    'no-shadow': 'off',
+    'no-multi-assign': 'off',
+    'no-underscore-dangle': 'off',
+    'node/no-deprecated-api': 'error',
+    'node/process-exit-as-throw': 'error',
+    'object-curly-spacing': [
+      'error',
+      'never'
+    ],
+    'operator-linebreak': [
+      'error',
+      'after',
+      {
+        'overrides': {
+          ':': 'before',
+          '?': 'before'
+        }
+      }
+    ],
+    'prefer-arrow-callback': 'off',
+    'prefer-destructuring': 'off',
+    'prefer-template': 'off',
+    'quote-props': [
+      1,
+      'as-needed',
+      {
+        'unnecessary': true
+      }
+    ],
+    'semi': [
+      'error',
+      'never'
+    ],
+    'no-await-in-loop': 'off',
+    'no-restricted-syntax': 'off',
+    'promise/always-return': 'off',
+  },
+  'globals': {
+    'window': true,
+    'document': true,
+    'App': true,
+    'Page': true,
+    'Component': true,
+    'Behavior': true,
+    'wx': true,
+    'getCurrentPages': true,
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MIGRATION.md

@@ -0,0 +1,336 @@
+# 插件到组件迁移指南
+
+本文档说明了从微信小程序插件到自定义组件的重构过程和主要变更。
+
+## 重构概览
+
+### 原插件结构
+```
+plugin/
+├── index.js              # 插件入口
+├── plugin.json           # 插件配置
+├── request.js            # 请求模块
+├── components/
+│   └── banner/           # 广告组件（包含所有类型）
+└── pages/
+    └── coupon/           # 优惠券页面（Page）
+```
+
+### 新组件结构
+```
+src/
+├── ad-banner/            # 横幅广告组件
+├── ad-interstitial/      # 插屏广告组件
+├── ad-rewarded-video/    # 激励视频组件
+├── ad-splash/            # 开屏广告组件
+├── ad-coupon/            # 优惠券组件（Component）
+├── mixins/
+│   └── ad-base.js        # 公共逻辑
+└── request.js            # 请求模块
+```
+
+## 主要变更
+
+### 1. 组件拆分
+
+**变更前：** 一个 `banner` 组件包含所有广告类型
+```javascript
+// plugin/components/banner/banner.js
+Component({
+  properties: {
+    type: String  // "banner" | "interstitial" | "rewardedVideo" | "splash"
+  }
+});
+```
+
+**变更后：** 拆分为 4 个独立组件
+```javascript
+// src/ad-banner/index.js
+// src/ad-interstitial/index.js
+// src/ad-rewarded-video/index.js
+// src/ad-splash/index.js
+```
+
+**优势：**
+- 代码更清晰，每个组件专注单一功能
+- 按需加载，减少包体积
+- 独立维护，互不影响
+
+### 2. Page 转 Component
+
+**变更前：** coupon 使用 Page() 构造器
+```javascript
+// plugin/pages/coupon/coupon.js
+Page({
+  onLoad(options) {
+    this.setData({ params: options });
+  }
+});
+```
+
+**变更后：** 使用 Component() 构造器
+```javascript
+// src/ad-coupon/index.js
+Component({
+  properties: {
+    secret: String,
+    phone: String,
+    userId: String
+  },
+  lifetimes: {
+    attached() {
+      // 初始化逻辑
+    }
+  }
+});
+```
+
+**使用方式变更：**
+
+插件方式（旧）：
+```xml
+<navigator url="plugin://juyoujia-adv/promotions?secret=xxx">
+  领取优惠券
+</navigator>
+```
+
+组件方式（新）：
+```xml
+<ad-coupon secret="{{secret}}" phone="{{phone}}" userId="{{userId}}" />
+```
+
+### 3. 公共逻辑提取
+
+**变更前：** 公共逻辑分散在各个组件中
+
+**变更后：** 提取到 `mixins/ad-base.js`
+```javascript
+// src/mixins/ad-base.js
+module.exports = {
+  restoreAdState() { /* ... */ },
+  saveAdState() { /* ... */ },
+  loadNextAd() { /* ... */ },
+  report(actionType) { /* ... */ }
+};
+```
+
+**使用方式：**
+```javascript
+const adBase = require('../mixins/ad-base.js');
+
+Component({
+  methods: {
+    ...adBase,
+    // 组件特有方法
+  }
+});
+```
+
+### 4. 路径引用变更
+
+**变更前：** 插件内部使用相对路径
+```javascript
+const { getAds } = require('../../request.js');
+```
+
+**变更后：** 组件使用相对路径
+```javascript
+const { getAds } = require('../request.js');
+```
+
+### 5. 配置文件变更
+
+**变更前：** 需要 `plugin.json`
+```json
+{
+  "publicComponents": {
+    "juyoujia-ad": "components/banner/banner"
+  },
+  "pages": {
+    "promotions": "pages/coupon/coupon"
+  },
+  "main": "index.js"
+}
+```
+
+**变更后：** 不需要特殊配置，直接使用标准组件配置
+```json
+{
+  "component": true,
+  "usingComponents": {}
+}
+```
+
+### 6. 宿主小程序引用方式
+
+**变更前：** 插件引用
+```json
+{
+  "plugins": {
+    "juyoujia-adv": {
+      "version": "1.0.0",
+      "provider": "wxAppId"
+    }
+  },
+  "usingComponents": {
+    "juyoujia-ad": "plugin://juyoujia-adv/juyoujia-ad"
+  }
+}
+```
+
+**变更后：** 普通组件引用
+```json
+{
+  "usingComponents": {
+    "ad-banner": "/components/jyj-components/ad-banner/index",
+    "ad-interstitial": "/components/jyj-components/ad-interstitial/index",
+    "ad-rewarded-video": "/components/jyj-components/ad-rewarded-video/index",
+    "ad-splash": "/components/jyj-components/ad-splash/index",
+    "ad-coupon": "/components/jyj-components/ad-coupon/index"
+  }
+}
+```
+
+## 迁移步骤
+
+### 对于组件开发者
+
+1. **构建组件库**
+```bash
+cd D:\myCode\miniProgram\jyj-components
+npm install
+npm run build
+```
+
+2. **发布到 npm（可选）**
+```bash
+npm publish
+```
+
+### 对于小程序开发者
+
+1. **移除插件配置**
+
+从 `app.json` 中删除：
+```json
+{
+  "plugins": {
+    "juyoujia-adv": { ... }
+  }
+}
+```
+
+2. **安装组件库**
+
+方式 A：npm 安装
+```bash
+npm install jyj-components
+```
+
+方式 B：本地复制
+```bash
+# 复制 miniprogram_dist 到项目的 components 目录
+```
+
+3. **更新组件引用**
+
+```json
+{
+  "usingComponents": {
+    "ad-banner": "jyj-components/ad-banner/index"
+  }
+}
+```
+
+4. **更新代码**
+
+**横幅广告：**
+```xml
+<!-- 旧 -->
+<juyoujia-ad slotId="xxx" type="banner" />
+
+<!-- 新 -->
+<ad-banner slotId="xxx" />
+```
+
+**插屏广告：**
+```xml
+<!-- 旧 -->
+<juyoujia-ad slotId="xxx" type="interstitial" />
+
+<!-- 新 -->
+<ad-interstitial slotId="xxx" isShow="{{show}}" />
+```
+
+**激励视频：**
+```xml
+<!-- 旧 -->
+<juyoujia-ad slotId="xxx" type="rewardedVideo" />
+
+<!-- 新 -->
+<ad-rewarded-video slotId="xxx" isShow="{{show}}" />
+```
+
+**开屏广告：**
+```xml
+<!-- 旧 -->
+<juyoujia-ad slotId="xxx" type="splash" />
+
+<!-- 新 -->
+<ad-splash slotId="xxx" />
+```
+
+**优惠券：**
+```xml
+<!-- 旧 -->
+<navigator url="plugin://juyoujia-adv/promotions?secret=xxx&phone=xxx">
+  领取优惠券
+</navigator>
+
+<!-- 新 -->
+<ad-coupon secret="{{secret}}" phone="{{phone}}" userId="{{userId}}" />
+```
+
+## 兼容性说明
+
+### 保持不变的部分
+
+1. **广告数据格式**：后端接口返回的数据格式保持不变
+2. **slotId**：广告位 ID 保持不变
+3. **事件名称**：`adLoad`、`adError`、`adClose` 等事件名保持不变
+4. **业务逻辑**：广告轮播、状态管理、数据上报逻辑保持不变
+
+### 需要调整的部分
+
+1. **组件名称**：从 `juyoujia-ad` 改为 `ad-banner` 等
+2. **type 属性**：不再需要 `type` 属性，直接使用对应的组件
+3. **优惠券参数传递**：从 URL 参数改为组件属性
+
+## 性能对比
+
+| 指标 | 插件方式 | 组件方式 |
+|------|---------|---------|
+| 包体积 | 所有类型打包在一起 | 按需加载 |
+| 代码可读性 | 大量条件判断 | 清晰独立 |
+| 维护成本 | 修改影响全部 | 独立维护 |
+| 加载速度 | 加载全部代码 | 只加载使用的组件 |
+
+## 常见问题
+
+### Q: 为什么要拆分组件？
+A: 提高代码可读性、可维护性，支持按需加载，减少包体积。
+
+### Q: 旧版插件还能用吗？
+A: 可以，但建议迁移到新版组件，获得更好的性能和维护体验。
+
+### Q: 迁移需要多久？
+A: 对于简单项目，约 30 分钟；复杂项目可能需要 1-2 小时。
+
+### Q: 数据会丢失吗？
+A: 不会，广告展示状态保存在本地存储中，迁移后会自动恢复。
+
+## 技术支持
+
+如有迁移问题，请联系开发团队或查看：
+- [完整文档](./README.md)
+- [快速开始](./QUICKSTART.md)