weaver-e10-builder 1.1.3 → 1.1.5

package/skill-docs/assets/factory/factory-slide.json

@@ -0,0 +1,164 @@
+[
+  {
+    "id": "",
+    "pageId": "",
+    "layoutType": "GRID",
+    "terminalType": "PC",
+    "module": "EB_ANONYMOUS_PAGE",
+    "ecodeVersion": 1,
+    "appId": "",
+    "comps": [
+      {
+        "id": "b80364c69d4e4834b7af2d6211ab5a9d",
+        "type": "Slide",
+        "package": "@weapp/ebdbasecoms",
+        "category": "2",
+        "pid": "",
+        "refModule": "",
+        "refCompId": "c530d67633774dffa1d2bdb3c52de826",
+        "refPluginPackageId": null,
+        "refPluginPackage": null,
+        "config": {
+          "name": "幻灯片",
+          "type": "Slide",
+          "title": "标题",
+          "titleEnabled": false,
+          "footerEnabled": false,
+          "pics": [],
+          "imageMode": "stretch",
+          "switchEffect": "fade",
+          "intervalTime": {
+            "type": -1,
+            "value": -1
+          },
+          "speed": 500,
+          "lazyLoad": false,
+          "imgSourceType": "manual",
+          "dataset": "",
+          "picField": {
+            "text": "请选择",
+            "id": "DEFAULT"
+          },
+          "titleField": {
+            "text": "请选择",
+            "id": "DEFAULT"
+          },
+          "describeField": {
+            "text": "请选择",
+            "id": "DEFAULT"
+          },
+          "linkField": {
+            "text": "请选择",
+            "id": "DEFAULT"
+          },
+          "eventGroup": [],
+          "filter": [],
+          "showNum": 5,
+          "showPicTitle": true,
+          "layout": {
+            "i": "cf619ffb77294bc5a848dca5e07b462e",
+            "x": 1,
+            "y": 0,
+            "w": 4,
+            "h": 29,
+            "scope": "",
+            "moved": false,
+            "selected": false,
+            "offsetTop": 61
+          },
+          "flow": {},
+          "disabled": {},
+          "styles": [],
+          "hasCssCache": true
+        },
+        "masterComponent": null,
+        "isCustom": false,
+        "isLock": false,
+        "ecodeId": "",
+        "ecodeVersion": null,
+        "applyStyle": "1,8",
+        "prop": "EB",
+        "styleCategoryCompKey": "BasicStyleConfig,SlideStyleConfig",
+        "styleCategoryPackage": "@weapp/ebdcoms,@weapp/ebdbasecoms"
+      }
+    ]
+  },
+  {
+    "id": "",
+    "pageId": "",
+    "layoutType": "GRID",
+    "terminalType": "MOBILE",
+    "module": "EB_ANONYMOUS_PAGE",
+    "ecodeVersion": 1,
+    "appId": "",
+    "comps": [
+      {
+        "id": "c530d67633774dffa1d2bdb3c52de826",
+        "type": "Slide",
+        "package": "@weapp/ebdbasecoms",
+        "category": "2",
+        "pid": "",
+        "refModule": "",
+        "refCompId": "b80364c69d4e4834b7af2d6211ab5a9d",
+        "refPluginPackageId": null,
+        "refPluginPackage": null,
+        "config": {
+          "name": "幻灯片",
+          "type": "Slide",
+          "title": "标题",
+          "titleEnabled": false,
+          "footerEnabled": false,
+          "pics": [],
+          "imageMode": "stretch",
+          "switchEffect": "fade",
+          "intervalTime": {
+            "type": -1,
+            "value": -1
+          },
+          "speed": 500,
+          "lazyLoad": false,
+          "imgSourceType": "manual",
+          "dataset": "",
+          "picField": {
+            "text": "请选择",
+            "id": "DEFAULT"
+          },
+          "titleField": {
+            "text": "请选择",
+            "id": "DEFAULT"
+          },
+          "describeField": {
+            "text": "请选择",
+            "id": "DEFAULT"
+          },
+          "linkField": {
+            "text": "请选择",
+            "id": "DEFAULT"
+          },
+          "eventGroup": [],
+          "filter": [],
+          "showNum": 5,
+          "showPicTitle": true,
+          "layout": {
+            "i": "a4cf121068324221890fe77357c065a1",
+            "adaptive": false,
+            "h": 29,
+            "selected": false
+          },
+          "disabled": {},
+          "flow": {},
+          "styles": []
+        },
+        "masterComponent": null,
+        "isCustom": false,
+        "isLock": false,
+        "ecodeId": "",
+        "ecodeVersion": null,
+        "applyStyle": "1,8",
+        "prop": "EB",
+        "styleCategoryCompKey": "BasicStyleConfig,SlideStyleConfig",
+        "styleCategoryPackage": "@weapp/ebdcoms,@weapp/ebdbasecoms"
+      }
+    ]
+  }
+]

package/skill-docs/assets/factory/factory-treemap.json

@@ -0,0 +1,322 @@
+[
+  {
+    "id": "",
+    "pageId": "",
+    "layoutType": "GRID",
+    "terminalType": "PC",
+    "module": "EB_PAGE",
+    "ecodeVersion": 1,
+    "appId": "",
+    "comps": [
+      {
+        "id": "a3931d5ced19481d974b06e0123de702",
+        "type": "Treemap",
+        "package": "@weapp/ebdchartcoms",
+        "category": "5",
+        "pid": "",
+        "refModule": "",
+        "refCompId": "f27369e708e34be19a6e2240d1a191b9",
+        "refPluginPackageId": null,
+        "refPluginPackage": null,
+        "config": {
+          "name": "矩形树图",
+          "type": "Treemap",
+          "title": "矩形树图",
+          "titleEnabled": true,
+          "topOperatBtns": {
+            "enabled": true,
+            "alignType": "CENTER",
+            "btns": [
+              {
+                "id": "f7438d",
+                "showType": "ICON",
+                "btnFrom": "DEFAULT",
+                "showContent": {
+                  "path": "#icon-Right-refresh",
+                  "title": "刷新",
+                  "style": {
+                    "fontSize": "36",
+                    "bgColor": "transparent",
+                    "borderColor": "transparent",
+                    "color": "#999",
+                    "radius": "3px"
+                  }
+                },
+                "event": {
+                  "to": "REFRESHCOM",
+                  "value": "刷新组件"
+                },
+                "isOpen": false,
+                "showOrder": 1
+              },
+              {
+                "id": "be2dc8",
+                "showType": "ICON",
+                "btnFrom": "DEFAULT",
+                "showContent": {
+                  "path": "#icon-Advanced-search",
+                  "title": "搜索",
+                  "style": {
+                    "fontSize": "36",
+                    "bgColor": "transparent",
+                    "borderColor": "transparent",
+                    "color": "#999",
+                    "radius": "3px"
+                  }
+                },
+                "event": {
+                  "to": "SEARCH",
+                  "value": "搜索组件"
+                },
+                "isOpen": false,
+                "showOrder": 2,
+                "hideAlways": true
+              }
+            ]
+          },
+          "showTopOperatBtnConfig": true,
+          "measures": [],
+          "dimensions": [],
+          "height": 360,
+          "label": {
+            "show": true,
+            "valType": "value",
+            "connector": ", "
+          },
+          "layout": {
+            "i": "bc3ed15025b24003b5fdda2ef3d85d40",
+            "x": 0,
+            "y": 97.45454545454545,
+            "w": 4,
+            "h": 34,
+            "scope": "",
+            "moved": false,
+            "selected": false,
+            "offsetTop": 1133
+          },
+          "flow": {},
+          "disabled": {},
+          "styles": [],
+          "filterVersion": 1,
+          "hasCssCache": true,
+          "measureName": "",
+          "minMeasures": [],
+          "maxMeasures": [],
+          "yoyDimensions": [],
+          "graphNodeName": {},
+          "graphRelation": {},
+          "graphGroupBy": {},
+          "graphNodeSize": {},
+          "scatterColor": {},
+          "scatterSize": {},
+          "xAxis": {
+            "type": "measures",
+            "data": {}
+          },
+          "yAxis": {},
+          "filter": {},
+          "dataset": {
+            "id": "",
+            "text": "",
+            "type": "LOGIC",
+            "groupId": "weaver-ebuilder-form-service",
+            "isPhysical": true,
+            "usage": "all",
+            "detailTable": false,
+            "objType": "physical",
+            "module": "ebuilder",
+            "appId": "",
+            "isFormModuleSelected": true
+          },
+          "searchConditions": {
+            "commonSearchType": "0",
+            "commonFilters": [],
+            "conditionId": ""
+          },
+          "eventGroup": [],
+          "url": [],
+          "markLine": {
+            "average": false,
+            "fixed": "",
+            "currentDataSetId": ""
+          },
+          "choseLabels": [],
+          "addToolTip": {
+            "addContent": "",
+            "addFields": []
+          },
+          "dataListDisplay": {
+            "fieldList": []
+          },
+          "nodesShowRange": {}
+        },
+        "masterComponent": null,
+        "isCustom": false,
+        "isLock": false,
+        "ecodeId": "",
+        "ecodeVersion": null,
+        "applyStyle": "1,2",
+        "prop": "EB",
+        "styleCategoryCompKey": "BasicStyleConfig,ChartStyleConfig",
+        "styleCategoryPackage": "@weapp/ebdcoms,@weapp/ebdchartcoms"
+      }
+    ]
+  },
+  {
+    "id": "",
+    "pageId": "",
+    "layoutType": "GRID",
+    "terminalType": "MOBILE",
+    "module": "EB_PAGE",
+    "ecodeVersion": 1,
+    "appId": "",
+    "comps": [
+      {
+        "id": "f27369e708e34be19a6e2240d1a191b9",
+        "type": "Treemap",
+        "package": "@weapp/ebdchartcoms",
+        "category": "5",
+        "pid": "",
+        "refModule": "",
+        "refCompId": "a3931d5ced19481d974b06e0123de702",
+        "refPluginPackageId": null,
+        "refPluginPackage": null,
+        "config": {
+          "name": "矩形树图",
+          "type": "Treemap",
+          "title": "矩形树图",
+          "titleEnabled": true,
+          "topOperatBtns": {
+            "enabled": true,
+            "alignType": "CENTER",
+            "btns": [
+              {
+                "id": "f7438d",
+                "showType": "ICON",
+                "btnFrom": "DEFAULT",
+                "showContent": {
+                  "path": "#icon-Right-refresh",
+                  "title": "刷新",
+                  "style": {
+                    "fontSize": "36",
+                    "bgColor": "transparent",
+                    "borderColor": "transparent",
+                    "color": "#999",
+                    "radius": "3px"
+                  }
+                },
+                "event": {
+                  "to": "REFRESHCOM",
+                  "value": "刷新组件"
+                },
+                "isOpen": false,
+                "showOrder": 1
+              },
+              {
+                "id": "be2dc8",
+                "showType": "ICON",
+                "btnFrom": "DEFAULT",
+                "showContent": {
+                  "path": "#icon-Advanced-search",
+                  "title": "搜索",
+                  "style": {
+                    "fontSize": "36",
+                    "bgColor": "transparent",
+                    "borderColor": "transparent",
+                    "color": "#999",
+                    "radius": "3px"
+                  }
+                },
+                "event": {
+                  "to": "SEARCH",
+                  "value": "搜索组件"
+                },
+                "isOpen": false,
+                "showOrder": 2,
+                "hideAlways": true
+              }
+            ]
+          },
+          "showTopOperatBtnConfig": true,
+          "measures": [],
+          "dimensions": [],
+          "height": 360,
+          "label": {
+            "show": true,
+            "valType": "value",
+            "connector": ", "
+          },
+          "layout": {
+            "i": "de3a404bc65b4fa2a2b67e66ae85d9ec",
+            "adaptive": false,
+            "h": 34,
+            "selected": false
+          },
+          "disabled": {},
+          "flow": {},
+          "styles": [],
+          "filterVersion": 1,
+          "measureName": "",
+          "minMeasures": [],
+          "maxMeasures": [],
+          "yoyDimensions": [],
+          "graphNodeName": {},
+          "graphRelation": {},
+          "graphGroupBy": {},
+          "graphNodeSize": {},
+          "scatterColor": {},
+          "scatterSize": {},
+          "xAxis": {
+            "type": "measures",
+            "data": {}
+          },
+          "yAxis": {},
+          "filter": {},
+          "dataset": {
+            "id": "",
+            "text": "",
+            "type": "LOGIC",
+            "groupId": "weaver-ebuilder-form-service",
+            "isPhysical": true,
+            "usage": "all",
+            "detailTable": false,
+            "objType": "physical",
+            "module": "ebuilder",
+            "appId": "",
+            "isFormModuleSelected": true
+          },
+          "searchConditions": {
+            "commonSearchType": "0",
+            "commonFilters": [],
+            "conditionId": ""
+          },
+          "eventGroup": [],
+          "url": [],
+          "markLine": {
+            "average": false,
+            "fixed": "",
+            "currentDataSetId": ""
+          },
+          "choseLabels": [],
+          "addToolTip": {
+            "addContent": "",
+            "addFields": []
+          },
+          "dataListDisplay": {
+            "fieldList": []
+          },
+          "nodesShowRange": {}
+        },
+        "masterComponent": null,
+        "isCustom": false,
+        "isLock": false,
+        "ecodeId": "",
+        "ecodeVersion": null,
+        "applyStyle": "1,2",
+        "prop": "EB",
+        "styleCategoryCompKey": "BasicStyleConfig,ChartStyleConfig",
+        "styleCategoryPackage": "@weapp/ebdcoms,@weapp/ebdchartcoms"
+      }
+    ]
+  }
+]

package/skill-docs/references/coding/guide-page-code.md

@@ -207,6 +207,22 @@ if (editingId) {
 
 ---
 
+## E10 平台硬规则（白屏 / 无样式 / 资源 404 的真凶）
+
+> 上面的规则管「能不能编译、数据对不对」；本节管平台**导入 / 运行期**的硬约束。
+> 违反不会报编译错，只会让页面发布后白屏、样式丢失或资源 404，且本地很难发现，写完务必逐条对照。
+
+| 规则 | 说明 |
+|------|------|
+| **资源统一用 `${appRes}/相对路径`**（如 `${appRes}/logo.png`） | `${appRes}` 是平台模板变量，导入后自动替换成正式静态地址。**禁止**写 `./resources/...`、`../resources/...`、`/resources/...`，发布后必 404。 |
+| **禁止在线资源** | 不要 `loadjs('http(s)://...')`、CDN、外链脚本——平台不加载外网资源。确需第三方脚本：先下载进项目，再按上一条 `${appRes}` 引用。 |
+| **禁止在 JS 里 `import` CSS** | ecode 没有 CSS 模块解析，`import './x.css'` 不会生效，样式静默丢失。少量样式用内联 style；独立 CSS 文件的打包规则见 `ref-compile-rules.md`「E10 打包与平台加载规则」。 |
+| **全部用 ESM `import` / `export`，禁止 `module.exports`** | 平台按模块加载，CommonJS 导出解析不到。 |
+| **只用白名单组件及其文档化 props** | 拿不准的组件 / prop / 图标名，先查 `references/components/`，不要凭记忆从 `@weapp/ui` 编造。 |
+| **不碰平台组件内部** | 不读 `props.children[...]`（含可选链写法）、不依赖内部 class / `weId` 段、不做全局无条件 `regOvComponent` 复写——内部结构不是稳定 API，平台升级即坏。 |
+
+---
+
 ## 代码质量检查清单
 
 生成代码后逐项检查：
@@ -221,4 +237,8 @@ if (editingId) {
 8. [ ] 没有 `forEach/map/filter(fn, this)` 传 context 的写法，用 `var self = this;` 替代
 9. [ ] 表单数据 key 用字段 ID（纯数字字符串），对照 `form read --out fields.json`
 10. [ ] Employee/Department 字段写入前已转为 ID
-11. [ ] 写完代码后运行 `e10-cli check <项目目录>` 逐条自检
+11. [ ] 页面没有 JS `import` CSS、没有 `module.exports`（全 ESM）
+12. [ ] 图片等静态资源统一 `${appRes}/相对路径`，没有写死相对路径或在线热链（loadjs/CDN）
+13. [ ] 只用清单内的 `@weapp/ui` 组件，不读 `props.children[...]`、不依赖内部 class/weId
+14. [ ] entry.js 只做路由注册，没有业务逻辑 / 轮询 / 直接 import 页面组件
+15. [ ] 写完代码后运行 `e10-cli check <项目目录>` 逐条自检

package/skill-docs/references/coding/ref-compile-rules.md

@@ -98,6 +98,30 @@ e10-cli project import <projectId> .target/xxx.zip --main-url /sp/custom/...
 
 ---
 
+## E10 打包与平台加载规则（build.json / CSS / 资源）
+
+> 首次 build 会自动生成 `build.json`。它决定每个文件是否**前置加载**，平台导入后按它加载代码。
+> 违反本节规则不报编译错，只会让页面发布后白屏 / 无样式 / 资源 404。
+
+### build.json：前置加载登记表
+
+- 首次 `ecodecmd build` 在项目根自动生成 `build.json`：`entry.js`、`formApi.js`、`.css`、`.pre.js` → `state:"y"`（平台前置加载）；其余 `.js` → `"n"`（按需，经 `asyncImport` 加载）。
+- **再次 build 以已存在的 `build.json` 为准，不会自动补登记之后新增的文件。** 新增 / 删除文件后若平台表现异常，先检查 `build.json`（必要时删掉让它重新生成，或手动补登记）。
+- `entry.js` 是唯一前置业务 JS，必须在 codes 里 `state:y`；其他业务 JS 不要批量设成 `y`（会让首屏变慢）。
+
+### CSS 规则
+
+- **禁止在 JS 里 `import` CSS**：ecode 无 CSS 模块解析，写了必丢、发布后无样式。
+- 少量页面样式用内联 style；确需独立 `.css` 文件时，确认它在 `build.json` 的 codes 里（首次自动生成时 `.css` 会登记为 `y`；文件是后加的要自行补登记），否则平台不合并加载。
+- 业务 CSS 选择器挂在页面根容器下，避免裸 `.类名`、`body`、`:root` 或平台内部 class 污染全局。
+
+### 资源规则
+
+- 工程 `resources/` 目录内容打包进 zip 的 `${resources` 物理目录；**业务代码引用统一用模板变量 `${appRes}/相对路径`**（导入后平台自动替换成正式地址），如 `${appRes}/logo.png`。
+- 禁止 `./resources/...`、`../resources/...`、`/resources/...` 相对写法，以及在线 `loadjs('http(s)://...')` / CDN。
+
+---
+
 ## 关键注意事项
 
 1. **所有变量用 var 声明**，非前置加载文件引用确保使用 `React.lazy(() => asyncImport...)`