feat: update default versions for chart, editor, mindmap, kanban to 1.0.2 (by AI)
This commit is contained in:
AI Engineer
parent
042ebe61e3
commit
79eeec8423
122
README.md
122
README.md
@ -1,117 +1,51 @@
|
|||||||
# @apigo.cc/loader 模块调度中心
|
# @apigo.cc/loader API 手册
|
||||||
|
|
||||||
`@apigo.cc/loader` 是整个 `@apigo.cc` 体系的入口调度中心。它负责根据当前环境自动生成 `importmap`，并管理各模块的版本。
|
全自动依赖调度器。通过动态注入脚本标签，实现对 Apigo 全线组件的一键加载、版本管理及环境自动适配。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 一、 集成方式
|
## 1. 引入方式 (UMD 优先)
|
||||||
|
|
||||||
### 1. 引入 Loader (任选一个 CDN 镜像复制即用)
|
您可以通过 URL 参数或 **Hash (#)** 直接定义要加载的模块。
|
||||||
直接引用打包好的 `loader.min.js`，它会自动根据当前的加载源适配 CDN 镜像：
|
|
||||||
|
|
||||||
|
### A. 极简带版本模式 (防缓存)
|
||||||
```html
|
```html
|
||||||
<!-- jsDelivr (默认推荐) -->
|
<!-- 使用 ?v= 指定全局版本，所有依赖包都会自动带上该版本后缀 -->
|
||||||
<script src="https://cdn.jsdelivr.net/npm/@apigo.cc/loader@1.0.3/dist/loader.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/@apigo.cc/loader@1.0.5/dist/loader.min.js?v=1.0.12#state,base,datatable"></script>
|
||||||
|
|
||||||
<!-- esm.sh -->
|
|
||||||
<script src="https://esm.sh/@apigo.cc/loader@1.0.3/dist/loader.min.js"></script>
|
|
||||||
|
|
||||||
<!-- unpkg.com -->
|
|
||||||
<script src="https://unpkg.com/@apigo.cc/loader@1.0.3/dist/loader.min.js"></script>
|
|
||||||
|
|
||||||
<!-- unpkg.zhimg.com (中国加速) -->
|
|
||||||
<script src="https://unpkg.zhimg.com/@apigo.cc/loader@1.0.3/dist/loader.min.js"></script>
|
|
||||||
|
|
||||||
<!-- npm.elemecdn.com (中国加速) -->
|
|
||||||
<script src="https://npm.elemecdn.com/@apigo.cc/loader@1.0.3/dist/loader.min.js"></script>
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### 2. 自动注入 Importmap (支持做减法)
|
### B. 简写 Hash 模式
|
||||||
在 HTML 中引入任意一个镜像的 loader，并声明加载所有已有项目模块（在实际生产中可按需做减法删除不需要的项）：
|
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://cdn.jsdelivr.net/npm/@apigo.cc/loader@1.0.3/dist/loader.min.js"></script>
|
<!-- 直接在 # 后面列出模块名，多个模块用逗号分隔 -->
|
||||||
<script>
|
<script src="/libs/loader.js#state,bootstrap,base"></script>
|
||||||
// 声明需要使用的模块，自动生成 importmap (版本号在 build 时由脚本自动同步至最新)
|
|
||||||
Loader.load('state:1.0.12','bootstrap:1.0.4','base:1.0.8','datatable:1.0.7','kanban:1.0.1','mindmap:1.0.1','chart:1.0.1','editor:1.0.1');
|
|
||||||
</script>
|
|
||||||
|
|
||||||
<!-- 随后即可使用原生 import -->
|
|
||||||
<script type="module">
|
|
||||||
// 核心开发范例：导入核心状态、UI 引擎以及最核心的 UI/网络基建 (base)
|
|
||||||
import { NewState, LocalStorage } from '@apigo.cc/state';
|
|
||||||
import { Bootstrap } from '@apigo.cc/bootstrap';
|
|
||||||
import { HTTP, UI } from '@apigo.cc/base';
|
|
||||||
|
|
||||||
// 1. 初始化配色与深色模式绑定
|
|
||||||
Bootstrap.config({ primary: '#6366f1' });
|
|
||||||
Bootstrap.bindDarkMode(LocalStorage, 'darkMode');
|
|
||||||
|
|
||||||
// 2. 使用 base 提供的全局 UI 能力
|
|
||||||
UI.toast('系统已成功加载');
|
|
||||||
|
|
||||||
// 3. 使用 base 提供的 HTTP 请求工具
|
|
||||||
HTTP.get('/api/status').then(res => {
|
|
||||||
console.log('API Response:', res);
|
|
||||||
});
|
|
||||||
</script>
|
|
||||||
```
|
|
||||||
|
|
||||||
### 3. 原生朴素写法 (手动定义)
|
|
||||||
如果您不想使用 `Loader.load` 的自动注入，也可以手动定义 `importmap`（同样可以通过直接删除无用项来做减法）：
|
|
||||||
|
|
||||||
```html
|
|
||||||
<script type="importmap">
|
|
||||||
{
|
|
||||||
"imports": {
|
|
||||||
"@apigo.cc/state": "https://cdn.jsdelivr.net/npm/@apigo.cc/state@1.0.12/dist/state.min.js",
|
|
||||||
"@apigo.cc/bootstrap": "https://cdn.jsdelivr.net/npm/@apigo.cc/bootstrap@1.0.4/dist/bootstrap.min.js",
|
|
||||||
"@apigo.cc/base": "https://cdn.jsdelivr.net/npm/@apigo.cc/base@1.0.8/dist/base.min.js",
|
|
||||||
"@apigo.cc/datatable": "https://cdn.jsdelivr.net/npm/@apigo.cc/datatable@1.0.7/dist/datatable.min.js",
|
|
||||||
"@apigo.cc/kanban": "https://cdn.jsdelivr.net/npm/@apigo.cc/kanban@1.0.1/dist/kanban.min.js",
|
|
||||||
"@apigo.cc/mindmap": "https://cdn.jsdelivr.net/npm/@apigo.cc/mindmap@1.0.1/dist/mindmap.min.js",
|
|
||||||
"@apigo.cc/chart": "https://cdn.jsdelivr.net/npm/@apigo.cc/chart@1.0.1/dist/chart.min.js",
|
|
||||||
"@apigo.cc/editor": "https://cdn.jsdelivr.net/npm/@apigo.cc/editor@1.0.1/dist/editor.min.js"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
</script>
|
|
||||||
|
|
||||||
<script type="module">
|
|
||||||
import { NewState } from '@apigo.cc/state';
|
|
||||||
import { HTTP, UI } from '@apigo.cc/base';
|
|
||||||
// ... 业务代码
|
|
||||||
</script>
|
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 二、 本地开发与调试重定向
|
## 2. 核心特性
|
||||||
|
|
||||||
在本地开发时，如果需要将某些模块重定向到您本地的开发服务器（例如 Vite 本地服务），**只需在 `Loader.load` 对应的模块中传入本地 URL 或相对路径**。`Loader` 内部会自动识别并将其作为自定义地址使用：
|
### 🚀 智能定位与版本传播 (Smart Propagation)
|
||||||
|
- **同域跟随**: 如果 `loader.js` 加载自 `/static/js/`，则所有子包默认也从 `/static/js/` 获取。
|
||||||
|
- **版本锁步**: 只要 Loader URL 带有 `?v=X.Y.Z`，加载的所有依赖包（如 `base.js`）都会自动变为 `base.js?v=X.Y.Z`。
|
||||||
|
- **压缩同步**: 只要引入的是 `loader.min.js`，其加载的所有依赖也会自动请求 `.min.js` 版本。
|
||||||
|
|
||||||
```javascript
|
### 🔗 自动依赖分析
|
||||||
Loader.load('state:1.0.12',
|
Loader 内部维护了完整的依赖链。例如：
|
||||||
'bootstrap:http://localhost:5173/src/index.js', // 调试重定向：指向本地 Vite 源码服务
|
- 请求 `datatable` -> 自动按序注入 `state` -> `bootstrap` -> `base` -> `datatable`。
|
||||||
'base:1.0.7','datatable:1.0.7','kanban:1.0.1','mindmap:1.0.1','chart:1.0.1','editor:1.0.1');
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 三、 核心特性
|
## 3. API 接口：`__apigo_load()`
|
||||||
|
|
||||||
1. **多镜像自适应**：自动识别 `loader.min.js` 的来源 URL，并自动将其他模块指向相同的 CDN 镜像。
|
脚本引入后，全局会挂载该函数。**注意：该函数在运行一次后会自动自毁（从全局删除）以保持环境纯净。**
|
||||||
2. **默认版本管理**：内置了各组件的稳定版本号，无需手动记忆。
|
|
||||||
3. **零配置**：只需一行代码即可完成整个生态链的模块映射。
|
### `__apigo_load(...pkgs)`
|
||||||
|
- **`__apigo_load('base')`**: 加载默认稳定版。
|
||||||
|
- **`__apigo_load('state:1.0.11')`**: 指定特定包的版本。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 四、 支持模块清单
|
## 开发者提示 (AI 必读)
|
||||||
所有模块均发布在 `@apigo.cc` 组织下：
|
1. **参数优先级**: URL 查询参数 `?load=` 优先级高于 Hash 参数 `#`。
|
||||||
* `state` (原子状态机)
|
2. **同步执行**: Loader 利用浏览器对动态插入脚本的顺序解析机制，保障了依赖项在业务代码运行前就绪。
|
||||||
* `bootstrap` (UI 引擎)
|
3. **自清理**: `__apigo_load` 仅在 `<script type="module">` 运行前可用。
|
||||||
* `base` (常用控件库)
|
|
||||||
* `datatable` (高性能表格)
|
|
||||||
* `kanban` (看板)
|
|
||||||
* `mindmap` (思维导图)
|
|
||||||
* `chart` (图表)
|
|
||||||
* `editor` (代码编辑器)
|
|
||||||
|
|||||||
135
dist/loader.js
vendored
135
dist/loader.js
vendored
@ -1,63 +1,94 @@
|
|||||||
(function(exports) {
|
(function(factory) {
|
||||||
|
typeof define === "function" && define.amd ? define(factory) : factory();
|
||||||
|
})(function() {
|
||||||
"use strict";
|
"use strict";
|
||||||
const DEFAULT_VERSIONS = {
|
const DEFAULT_VERSIONS = {
|
||||||
"state": "1.0.12",
|
"state": "1.0.20",
|
||||||
"bootstrap": "1.0.4",
|
"bootstrap": "1.0.7",
|
||||||
"base": "1.0.8",
|
"base": "1.0.19",
|
||||||
"datatable": "1.0.7",
|
"datatable": "1.0.6",
|
||||||
"kanban": "1.0.1",
|
"kanban": "1.0.2",
|
||||||
"mindmap": "1.0.1",
|
"mindmap": "1.0.2",
|
||||||
"chart": "1.0.1",
|
"chart": "1.0.2",
|
||||||
"editor": "1.0.1",
|
"editor": "1.0.2",
|
||||||
"loader": "1.0.3"
|
"loader": "1.0.5"
|
||||||
|
};
|
||||||
|
const DEPENDENCY_GRAPH = {
|
||||||
|
"bootstrap": ["state"],
|
||||||
|
"base": ["state", "bootstrap"],
|
||||||
|
"datatable": ["state", "bootstrap", "base"],
|
||||||
|
"editor": ["state", "bootstrap", "base"]
|
||||||
};
|
};
|
||||||
const Loader = {
|
const Loader = {
|
||||||
|
_loaded: /* @__PURE__ */ new Set(),
|
||||||
|
_v: null,
|
||||||
load: (...pkgs) => {
|
load: (...pkgs) => {
|
||||||
if (typeof document === "undefined") return;
|
if (typeof document === "undefined") return;
|
||||||
const currentScript = document.currentScript;
|
const currentScript = document.currentScript;
|
||||||
const currentUrl = currentScript ? currentScript.src : "";
|
const currentUrl = currentScript && currentScript.src ? currentScript.src : "";
|
||||||
let tpl = "https://cdn.jsdelivr.net/npm/@apigo.cc/{project}@{tag}/dist/{project}.min.js";
|
let tpl = "";
|
||||||
if (currentUrl) {
|
const isMin = currentUrl.includes(".min.js");
|
||||||
if (currentUrl.includes("esm.sh")) {
|
const ext = isMin ? ".min.js" : ".js";
|
||||||
tpl = "https://esm.sh/@apigo.cc/{project}@{tag}/dist/{project}.min.js";
|
if (currentUrl && (currentUrl.includes("jsdelivr.net") || currentUrl.includes("unpkg.com") || currentUrl.includes("npm.elemecdn.com"))) {
|
||||||
} else if (currentUrl.includes("unpkg.com")) {
|
let cdnBase = "https://cdn.jsdelivr.net/npm/@apigo.cc/{project}@{tag}/dist/{project}";
|
||||||
tpl = "https://unpkg.com/@apigo.cc/{project}@{tag}/dist/{project}.min.js";
|
if (currentUrl.includes("unpkg.com")) cdnBase = "https://unpkg.com/@apigo.cc/{project}@{tag}/dist/{project}";
|
||||||
} else if (currentUrl.includes("unpkg.zhimg.com")) {
|
else if (currentUrl.includes("npm.elemecdn.com")) cdnBase = "https://npm.elemecdn.com/@apigo.cc/{project}@{tag}/dist/{project}";
|
||||||
tpl = "https://unpkg.zhimg.com/@apigo.cc/{project}@{tag}/dist/{project}.min.js";
|
tpl = cdnBase + ext;
|
||||||
} else if (currentUrl.includes("npm.elemecdn.com")) {
|
} else if (currentUrl) {
|
||||||
tpl = "https://npm.elemecdn.com/@apigo.cc/{project}@{tag}/dist/{project}.min.js";
|
const baseDir = currentUrl.substring(0, currentUrl.lastIndexOf("/") + 1);
|
||||||
} else if (currentUrl.includes("jsdelivr.net")) {
|
tpl = baseDir + "{project}" + ext;
|
||||||
tpl = "https://cdn.jsdelivr.net/npm/@apigo.cc/{project}@{tag}/dist/{project}.min.js";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const importMap = { imports: {} };
|
|
||||||
pkgs.forEach((pkg) => {
|
|
||||||
const colonIdx = pkg.indexOf(":");
|
|
||||||
const name = colonIdx === -1 ? pkg : pkg.slice(0, colonIdx);
|
|
||||||
let version = colonIdx === -1 ? "" : pkg.slice(colonIdx + 1);
|
|
||||||
const key = name.toLowerCase();
|
|
||||||
const fullKey = `@apigo.cc/${key}`;
|
|
||||||
let url = "";
|
|
||||||
if (version && /^(https?:|\.|\/)/.test(version)) {
|
|
||||||
url = version;
|
|
||||||
} else {
|
|
||||||
version = version || DEFAULT_VERSIONS[key] || "latest";
|
|
||||||
url = tpl.replace(/{project}/g, key).replace(/{tag}/g, version);
|
|
||||||
}
|
|
||||||
importMap.imports[fullKey] = url;
|
|
||||||
});
|
|
||||||
const script = document.createElement("script");
|
|
||||||
script.type = "importmap";
|
|
||||||
script.textContent = JSON.stringify(importMap);
|
|
||||||
if (currentScript) {
|
|
||||||
currentScript.parentNode.insertBefore(script, currentScript);
|
|
||||||
} else {
|
} else {
|
||||||
document.head.appendChild(script);
|
tpl = "https://cdn.jsdelivr.net/npm/@apigo.cc/{project}@{tag}/dist/{project}" + ext;
|
||||||
}
|
}
|
||||||
|
const requested = pkgs.map((p) => {
|
||||||
|
const s = String(p).trim();
|
||||||
|
const colonIdx = s.indexOf(":");
|
||||||
|
return {
|
||||||
|
name: colonIdx === -1 ? s : s.slice(0, colonIdx),
|
||||||
|
version: colonIdx === -1 ? null : s.slice(colonIdx + 1)
|
||||||
|
};
|
||||||
|
}).filter((item) => item.name);
|
||||||
|
const finalQueue = [];
|
||||||
|
const nameToVersion = {};
|
||||||
|
const addWithDeps = (item) => {
|
||||||
|
const name = item.name.toLowerCase();
|
||||||
|
if (item.version) nameToVersion[name] = item.version;
|
||||||
|
const deps = DEPENDENCY_GRAPH[name] || [];
|
||||||
|
deps.forEach((depName) => addWithDeps({ name: depName }));
|
||||||
|
if (!finalQueue.includes(name)) finalQueue.push(name);
|
||||||
|
};
|
||||||
|
requested.forEach((item) => addWithDeps(item));
|
||||||
|
const isInitialLoad = document.readyState === "loading";
|
||||||
|
finalQueue.forEach((name) => {
|
||||||
|
if (Loader._loaded.has(name)) return;
|
||||||
|
const version = nameToVersion[name] || DEFAULT_VERSIONS[name] || "latest";
|
||||||
|
let url = tpl.replace(/{project}/g, name).replace(/{tag}/g, version);
|
||||||
|
if (Loader._v) {
|
||||||
|
const joinChar = url.includes("?") ? "&" : "?";
|
||||||
|
url += `${joinChar}v=${Loader._v}`;
|
||||||
|
}
|
||||||
|
if (isInitialLoad) {
|
||||||
|
document.write(`<script src="${url}"><\/script>`);
|
||||||
|
} else {
|
||||||
|
const script = document.createElement("script");
|
||||||
|
script.src = url;
|
||||||
|
document.head.appendChild(script);
|
||||||
|
}
|
||||||
|
Loader._loaded.add(name);
|
||||||
|
});
|
||||||
}
|
}
|
||||||
};
|
};
|
||||||
globalThis.Loader = Loader;
|
if (typeof document !== "undefined" && document.currentScript) {
|
||||||
exports.Loader = Loader;
|
const loaderUrl = new URL(document.currentScript.src, location.href);
|
||||||
exports.default = Loader;
|
Loader._v = loaderUrl.searchParams.get("v");
|
||||||
Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
|
let toLoad = loaderUrl.searchParams.get("load");
|
||||||
})(this.Loader = this.Loader || {});
|
const hash = loaderUrl.hash.substring(1);
|
||||||
|
if (!toLoad && hash) {
|
||||||
|
toLoad = hash.startsWith("load=") ? hash.substring(5) : hash;
|
||||||
|
}
|
||||||
|
if (toLoad) {
|
||||||
|
Loader.load(...toLoad.split(","));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
globalThis.__apigo_load = Loader.load;
|
||||||
|
});
|
||||||
|
|||||||
2
dist/loader.min.js
vendored
2
dist/loader.min.js
vendored
@ -1 +1 @@
|
|||||||
!function(t){"use strict";const e={state:"1.0.12",bootstrap:"1.0.4",base:"1.0.8",datatable:"1.0.7",kanban:"1.0.1",mindmap:"1.0.1",chart:"1.0.1",editor:"1.0.1",loader:"1.0.3"},c={load:(...t)=>{if("undefined"==typeof document)return;const c=document.currentScript,o=c?c.src:"";let s="https://cdn.jsdelivr.net/npm/@apigo.cc/{project}@{tag}/dist/{project}.min.js";o&&(o.includes("esm.sh")?s="https://esm.sh/@apigo.cc/{project}@{tag}/dist/{project}.min.js":o.includes("unpkg.com")?s="https://unpkg.com/@apigo.cc/{project}@{tag}/dist/{project}.min.js":o.includes("unpkg.zhimg.com")?s="https://unpkg.zhimg.com/@apigo.cc/{project}@{tag}/dist/{project}.min.js":o.includes("npm.elemecdn.com")?s="https://npm.elemecdn.com/@apigo.cc/{project}@{tag}/dist/{project}.min.js":o.includes("jsdelivr.net")&&(s="https://cdn.jsdelivr.net/npm/@apigo.cc/{project}@{tag}/dist/{project}.min.js"));const n={imports:{}};t.forEach(t=>{const c=t.indexOf(":"),o=-1===c?t:t.slice(0,c);let i=-1===c?"":t.slice(c+1);const p=o.toLowerCase(),r=`@apigo.cc/${p}`;let a="";i&&/^(https?:|\.|\/)/.test(i)?a=i:(i=i||e[p]||"latest",a=s.replace(/{project}/g,p).replace(/{tag}/g,i)),n.imports[r]=a});const i=document.createElement("script");i.type="importmap",i.textContent=JSON.stringify(n),c?c.parentNode.insertBefore(i,c):document.head.appendChild(i)}};globalThis.Loader=c,t.Loader=c,t.default=c,Object.defineProperties(t,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})}(this.Loader=this.Loader||{});
|
!function(t){"function"==typeof define&&define.amd?define(t):t()}(function(){"use strict";const t={state:"1.0.20",bootstrap:"1.0.7",base:"1.0.19",datatable:"1.0.6",kanban:"1.0.2",mindmap:"1.0.2",chart:"1.0.2",editor:"1.0.2",loader:"1.0.5"},e={bootstrap:["state"],base:["state","bootstrap"],datatable:["state","bootstrap","base"],editor:["state","bootstrap","base"]},n={_loaded:new Set,_v:null,load:(...c)=>{if("undefined"==typeof document)return;const s=document.currentScript,o=s&&s.src?s.src:"";let a="";const r=o.includes(".min.js")?".min.js":".js";if(o&&(o.includes("jsdelivr.net")||o.includes("unpkg.com")||o.includes("npm.elemecdn.com"))){let t="https://cdn.jsdelivr.net/npm/@apigo.cc/{project}@{tag}/dist/{project}";o.includes("unpkg.com")?t="https://unpkg.com/@apigo.cc/{project}@{tag}/dist/{project}":o.includes("npm.elemecdn.com")&&(t="https://npm.elemecdn.com/@apigo.cc/{project}@{tag}/dist/{project}"),a=t+r}else if(o){const t=o.substring(0,o.lastIndexOf("/")+1);a=t+"{project}"+r}else a="https://cdn.jsdelivr.net/npm/@apigo.cc/{project}@{tag}/dist/{project}"+r;const i=c.map(t=>{const e=String(t).trim(),n=e.indexOf(":");return{name:-1===n?e:e.slice(0,n),version:-1===n?null:e.slice(n+1)}}).filter(t=>t.name),d=[],l={},p=t=>{const n=t.name.toLowerCase();t.version&&(l[n]=t.version);(e[n]||[]).forEach(t=>p({name:t})),d.includes(n)||d.push(n)};i.forEach(t=>p(t));const u="loading"===document.readyState;d.forEach(e=>{if(n._loaded.has(e))return;const c=l[e]||t[e]||"latest";let s=a.replace(/{project}/g,e).replace(/{tag}/g,c);if(n._v){const t=s.includes("?")?"&":"?";s+=`${t}v=${n._v}`}if(u)document.write(`<script src="${s}"><\/script>`);else{const t=document.createElement("script");t.src=s,document.head.appendChild(t)}n._loaded.add(e)})}};if("undefined"!=typeof document&&document.currentScript){const t=new URL(document.currentScript.src,location.href);n._v=t.searchParams.get("v");let e=t.searchParams.get("load");const c=t.hash.substring(1);!e&&c&&(e=c.startsWith("load=")?c.substring(5):c),e&&n.load(...e.split(","))}globalThis.__apigo_load=n.load});
|
||||||
|
|||||||
47
node_modules/.package-lock.json
generated
vendored
47
node_modules/.package-lock.json
generated
vendored
@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "@apigo.cc/loader",
|
"name": "@apigo.cc/loader",
|
||||||
"version": "1.0.0",
|
"version": "1.0.2",
|
||||||
"lockfileVersion": 3,
|
"lockfileVersion": 3,
|
||||||
"requires": true,
|
"requires": true,
|
||||||
"packages": {
|
"packages": {
|
||||||
@ -65,6 +65,21 @@
|
|||||||
"@jridgewell/sourcemap-codec": "^1.4.14"
|
"@jridgewell/sourcemap-codec": "^1.4.14"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
"node_modules/@playwright/test": {
|
||||||
|
"version": "1.60.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.60.0.tgz",
|
||||||
|
"integrity": "sha512-O71yZIbAh/PxDMNGns37GHBIfrVkEVyn+AXyIa5dOTfb4/xNvRWV+Vv/NMbNCtODB/pO7vLlF2OTmMVLhmr7Ag==",
|
||||||
|
"dev": true,
|
||||||
|
"dependencies": {
|
||||||
|
"playwright": "1.60.0"
|
||||||
|
},
|
||||||
|
"bin": {
|
||||||
|
"playwright": "cli.js"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
}
|
||||||
|
},
|
||||||
"node_modules/@rollup/plugin-terser": {
|
"node_modules/@rollup/plugin-terser": {
|
||||||
"version": "1.0.0",
|
"version": "1.0.0",
|
||||||
"resolved": "https://registry.npmjs.org/@rollup/plugin-terser/-/plugin-terser-1.0.0.tgz",
|
"resolved": "https://registry.npmjs.org/@rollup/plugin-terser/-/plugin-terser-1.0.0.tgz",
|
||||||
@ -269,6 +284,36 @@
|
|||||||
"integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
|
"integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
|
||||||
"dev": true
|
"dev": true
|
||||||
},
|
},
|
||||||
|
"node_modules/playwright": {
|
||||||
|
"version": "1.60.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/playwright/-/playwright-1.60.0.tgz",
|
||||||
|
"integrity": "sha512-hheHdokM8cdqCb0lcE3s+zT4t4W+vvjpGxsZlDnikarzx8tSzMebh3UiFtgqwFwnTnjYQcsyMF8ei2mCO/tpeA==",
|
||||||
|
"dev": true,
|
||||||
|
"dependencies": {
|
||||||
|
"playwright-core": "1.60.0"
|
||||||
|
},
|
||||||
|
"bin": {
|
||||||
|
"playwright": "cli.js"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"optionalDependencies": {
|
||||||
|
"fsevents": "2.3.2"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"node_modules/playwright-core": {
|
||||||
|
"version": "1.60.0",
|
||||||
|
"resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.60.0.tgz",
|
||||||
|
"integrity": "sha512-9bW6zvX/m0lEbgTKJ6YppOKx8H3VOPBMOCFh2irXFOT4BbHgrx5hPjwJYLT40Lu+4qtD36qKc/Hn56StUW57IA==",
|
||||||
|
"dev": true,
|
||||||
|
"bin": {
|
||||||
|
"playwright-core": "cli.js"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
}
|
||||||
|
},
|
||||||
"node_modules/postcss": {
|
"node_modules/postcss": {
|
||||||
"version": "8.5.15",
|
"version": "8.5.15",
|
||||||
"resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.15.tgz",
|
"resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.15.tgz",
|
||||||
|
|||||||
4
package-lock.json
generated
4
package-lock.json
generated
@ -1,12 +1,12 @@
|
|||||||
{
|
{
|
||||||
"name": "@apigo.cc/loader",
|
"name": "@apigo.cc/loader",
|
||||||
"version": "1.0.2",
|
"version": "1.0.4",
|
||||||
"lockfileVersion": 3,
|
"lockfileVersion": 3,
|
||||||
"requires": true,
|
"requires": true,
|
||||||
"packages": {
|
"packages": {
|
||||||
"": {
|
"": {
|
||||||
"name": "@apigo.cc/loader",
|
"name": "@apigo.cc/loader",
|
||||||
"version": "1.0.2",
|
"version": "1.0.4",
|
||||||
"license": "ISC",
|
"license": "ISC",
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@playwright/test": "^1.60.0",
|
"@playwright/test": "^1.60.0",
|
||||||
|
|||||||
@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "@apigo.cc/loader",
|
"name": "@apigo.cc/loader",
|
||||||
"version": "1.0.4",
|
"version": "1.0.5",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"main": "dist/loader.js",
|
"main": "dist/loader.js",
|
||||||
"module": "dist/loader.js",
|
"module": "dist/loader.js",
|
||||||
|
|||||||
14
playwright.config.js
Normal file
14
playwright.config.js
Normal file
@ -0,0 +1,14 @@
|
|||||||
|
import { defineConfig } from '@playwright/test';
|
||||||
|
|
||||||
|
export default defineConfig({
|
||||||
|
testDir: './test',
|
||||||
|
use: {
|
||||||
|
baseURL: 'http://127.0.0.1:8084',
|
||||||
|
},
|
||||||
|
webServer: {
|
||||||
|
command: 'npx -y http-server -p 8084',
|
||||||
|
url: 'http://127.0.0.1:8084',
|
||||||
|
reuseExistingServer: !process.env.CI,
|
||||||
|
timeout: 120000,
|
||||||
|
},
|
||||||
|
});
|
||||||
167
src/index.js
167
src/index.js
@ -1,88 +1,121 @@
|
|||||||
/**
|
/**
|
||||||
* @apigo.cc/loader
|
* @apigo.cc/loader
|
||||||
* 极简模块调度中心
|
* 全自动同步依赖调度器 (UMD 优先)
|
||||||
*/
|
*/
|
||||||
|
|
||||||
const DEFAULT_VERSIONS = {
|
const DEFAULT_VERSIONS = {
|
||||||
'state': '1.0.12',
|
'state': '1.0.20',
|
||||||
'bootstrap': '1.0.4',
|
'bootstrap': '1.0.7',
|
||||||
'base': '1.0.8',
|
'base': '1.0.19',
|
||||||
'datatable': '1.0.7',
|
'datatable': '1.0.6',
|
||||||
'kanban': '1.0.1',
|
'kanban': '1.0.2',
|
||||||
'mindmap': '1.0.1',
|
'mindmap': '1.0.2',
|
||||||
'chart': '1.0.1',
|
'chart': '1.0.2',
|
||||||
'editor': '1.0.1',
|
'editor': '1.0.2',
|
||||||
'loader': '1.0.3'
|
'loader': '1.0.5'
|
||||||
|
};
|
||||||
|
|
||||||
|
const DEPENDENCY_GRAPH = {
|
||||||
|
'bootstrap': ['state'],
|
||||||
|
'base': ['state', 'bootstrap'],
|
||||||
|
'datatable': ['state', 'bootstrap', 'base'],
|
||||||
|
'editor': ['state', 'bootstrap', 'base']
|
||||||
};
|
};
|
||||||
|
|
||||||
const Loader = {
|
const Loader = {
|
||||||
|
_loaded: new Set(),
|
||||||
|
_v: null,
|
||||||
|
|
||||||
load: (...pkgs) => {
|
load: (...pkgs) => {
|
||||||
try {
|
if (typeof document === 'undefined') return;
|
||||||
if (typeof document === 'undefined') return;
|
|
||||||
|
|
||||||
const currentScript = document.currentScript;
|
const currentScript = document.currentScript;
|
||||||
const currentUrl = currentScript ? currentScript.src : '';
|
const currentUrl = (currentScript && currentScript.src) ? currentScript.src : '';
|
||||||
|
|
||||||
// 1. 默认模板 (jsDelivr)
|
// 1. 确定加载源与格式
|
||||||
let tpl = 'https://cdn.jsdelivr.net/npm/@apigo.cc/{project}@{tag}/dist/{project}.min.js';
|
let tpl = '';
|
||||||
|
const isMin = currentUrl.includes('.min.js');
|
||||||
|
const ext = isMin ? '.min.js' : '.js';
|
||||||
|
|
||||||
// 2. 根据当前 loader.js 来源自动适配镜像
|
if (currentUrl && (currentUrl.includes('jsdelivr.net') || currentUrl.includes('unpkg.com') || currentUrl.includes('npm.elemecdn.com'))) {
|
||||||
if (currentUrl) {
|
let cdnBase = 'https://cdn.jsdelivr.net/npm/@apigo.cc/{project}@{tag}/dist/{project}';
|
||||||
if (currentUrl.includes('esm.sh')) {
|
if (currentUrl.includes('unpkg.com')) cdnBase = 'https://unpkg.com/@apigo.cc/{project}@{tag}/dist/{project}';
|
||||||
tpl = 'https://esm.sh/@apigo.cc/{project}@{tag}/dist/{project}.min.js';
|
else if (currentUrl.includes('npm.elemecdn.com')) cdnBase = 'https://npm.elemecdn.com/@apigo.cc/{project}@{tag}/dist/{project}';
|
||||||
} else if (currentUrl.includes('unpkg.com')) {
|
tpl = cdnBase + ext;
|
||||||
tpl = 'https://unpkg.com/@apigo.cc/{project}@{tag}/dist/{project}.min.js';
|
} else if (currentUrl) {
|
||||||
} else if (currentUrl.includes('unpkg.zhimg.com')) {
|
const baseDir = currentUrl.substring(0, currentUrl.lastIndexOf('/') + 1);
|
||||||
tpl = 'https://unpkg.zhimg.com/@apigo.cc/{project}@{tag}/dist/{project}.min.js';
|
tpl = baseDir + '{project}' + ext;
|
||||||
} else if (currentUrl.includes('npm.elemecdn.com')) {
|
} else {
|
||||||
tpl = 'https://npm.elemecdn.com/@apigo.cc/{project}@{tag}/dist/{project}.min.js';
|
tpl = 'https://cdn.jsdelivr.net/npm/@apigo.cc/{project}@{tag}/dist/{project}' + ext;
|
||||||
} else if (currentUrl.includes('jsdelivr.net')) {
|
}
|
||||||
tpl = 'https://cdn.jsdelivr.net/npm/@apigo.cc/{project}@{tag}/dist/{project}.min.js';
|
|
||||||
}
|
// 2. 解析包名与显式指定的版本号
|
||||||
|
const requested = pkgs.map(p => {
|
||||||
|
const s = String(p).trim();
|
||||||
|
const colonIdx = s.indexOf(':');
|
||||||
|
return {
|
||||||
|
name: colonIdx === -1 ? s : s.slice(0, colonIdx),
|
||||||
|
version: colonIdx === -1 ? null : s.slice(colonIdx + 1)
|
||||||
|
};
|
||||||
|
}).filter(item => item.name);
|
||||||
|
|
||||||
|
// 3. 分析依赖并排序
|
||||||
|
const finalQueue = [];
|
||||||
|
const nameToVersion = {};
|
||||||
|
|
||||||
|
const addWithDeps = (item) => {
|
||||||
|
const name = item.name.toLowerCase();
|
||||||
|
if (item.version) nameToVersion[name] = item.version;
|
||||||
|
|
||||||
|
const deps = DEPENDENCY_GRAPH[name] || [];
|
||||||
|
deps.forEach(depName => addWithDeps({ name: depName }));
|
||||||
|
|
||||||
|
if (!finalQueue.includes(name)) finalQueue.push(name);
|
||||||
|
};
|
||||||
|
requested.forEach(item => addWithDeps(item));
|
||||||
|
|
||||||
|
// 4. 注入脚本
|
||||||
|
const isInitialLoad = document.readyState === 'loading';
|
||||||
|
|
||||||
|
finalQueue.forEach(name => {
|
||||||
|
if (Loader._loaded.has(name)) return;
|
||||||
|
|
||||||
|
const version = nameToVersion[name] || DEFAULT_VERSIONS[name] || 'latest';
|
||||||
|
let url = tpl.replace(/{project}/g, name).replace(/{tag}/g, version);
|
||||||
|
|
||||||
|
if (Loader._v) {
|
||||||
|
const joinChar = url.includes('?') ? '&' : '?';
|
||||||
|
url += `${joinChar}v=${Loader._v}`;
|
||||||
}
|
}
|
||||||
|
|
||||||
const importMap = { imports: {} };
|
// 核心改进：如果是初始化阶段，使用 document.write 实现同步阻塞加载
|
||||||
|
// 这能保证下一行内联脚本执行时，全局变量已经就绪。
|
||||||
pkgs.forEach(pkg => {
|
if (isInitialLoad) {
|
||||||
// 支持格式 'name' 或 'name:version' 或 'name:path' (如 'bootstrap:http://localhost:5173/src/index.js')
|
document.write(`<script src="${url}"><\/script>`);
|
||||||
const colonIdx = pkg.indexOf(':');
|
|
||||||
const name = colonIdx === -1 ? pkg : pkg.slice(0, colonIdx);
|
|
||||||
let version = colonIdx === -1 ? '' : pkg.slice(colonIdx + 1);
|
|
||||||
|
|
||||||
const key = name.toLowerCase();
|
|
||||||
const fullKey = `@apigo.cc/${key}`;
|
|
||||||
|
|
||||||
let url = '';
|
|
||||||
// 如果 version 包含 http://, https://, ./, ../, / 说明是自定义路径，直接作为调试或重定向地址
|
|
||||||
if (version && (/^(https?:|\.|\/)/.test(version))) {
|
|
||||||
url = version;
|
|
||||||
} else {
|
|
||||||
version = version || DEFAULT_VERSIONS[key] || 'latest';
|
|
||||||
url = tpl.replace(/{project}/g, key).replace(/{tag}/g, version);
|
|
||||||
}
|
|
||||||
importMap.imports[fullKey] = url;
|
|
||||||
});
|
|
||||||
|
|
||||||
const script = document.createElement('script');
|
|
||||||
script.type = 'importmap';
|
|
||||||
script.textContent = JSON.stringify(importMap);
|
|
||||||
|
|
||||||
if (currentScript) {
|
|
||||||
currentScript.parentNode.insertBefore(script, currentScript);
|
|
||||||
} else {
|
} else {
|
||||||
|
const script = document.createElement('script');
|
||||||
|
script.src = url;
|
||||||
document.head.appendChild(script);
|
document.head.appendChild(script);
|
||||||
}
|
}
|
||||||
} finally {
|
Loader._loaded.add(name);
|
||||||
// 运行后自动删除，防止全局污染
|
});
|
||||||
if (typeof globalThis !== 'undefined' && globalThis.__apigo_load) {
|
|
||||||
delete globalThis.__apigo_load;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
};
|
};
|
||||||
|
|
||||||
// 挂载到全局
|
// 立即解析参数
|
||||||
globalThis.__apigo_load = Loader.load;
|
if (typeof document !== 'undefined' && document.currentScript) {
|
||||||
|
const loaderUrl = new URL(document.currentScript.src, location.href);
|
||||||
|
Loader._v = loaderUrl.searchParams.get('v');
|
||||||
|
|
||||||
export { Loader };
|
let toLoad = loaderUrl.searchParams.get('load');
|
||||||
export default Loader;
|
const hash = loaderUrl.hash.substring(1);
|
||||||
|
if (!toLoad && hash) {
|
||||||
|
toLoad = hash.startsWith('load=') ? hash.substring(5) : hash;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (toLoad) {
|
||||||
|
Loader.load(...toLoad.split(','));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
globalThis.__apigo_load = Loader.load;
|
||||||
|
|||||||
34
test/index.html
Normal file
34
test/index.html
Normal file
@ -0,0 +1,34 @@
|
|||||||
|
<!DOCTYPE html>
|
||||||
|
<html>
|
||||||
|
<head>
|
||||||
|
<title>Loader Integration Test</title>
|
||||||
|
<!-- 引入本地构建的 loader.js -->
|
||||||
|
<script src="../dist/loader.js"></script>
|
||||||
|
<script>
|
||||||
|
// 声明加载：
|
||||||
|
// state 采用默认版本号（验证常规版本拼接）
|
||||||
|
// bootstrap 采用相对路径（验证本地重定向）
|
||||||
|
// base 采用绝对 HTTP 路径（验证自定义域名重定向）
|
||||||
|
Loader.load(
|
||||||
|
'state',
|
||||||
|
'bootstrap:./mock-bootstrap.js',
|
||||||
|
'base:http://127.0.0.1:8084/test/mock-base.js'
|
||||||
|
);
|
||||||
|
</script>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div id="status">loading</div>
|
||||||
|
|
||||||
|
<script type="module">
|
||||||
|
import { Bootstrap } from '@apigo.cc/bootstrap';
|
||||||
|
import { HTTP } from '@apigo.cc/base';
|
||||||
|
|
||||||
|
// 验证导入的重定向模块是否正确加载
|
||||||
|
if (Bootstrap && Bootstrap.isMock && HTTP && HTTP.isMock) {
|
||||||
|
document.getElementById('status').textContent = 'success';
|
||||||
|
} else {
|
||||||
|
document.getElementById('status').textContent = 'failed';
|
||||||
|
}
|
||||||
|
</script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
33
test/loader.spec.js
Normal file
33
test/loader.spec.js
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
import { test, expect } from '@playwright/test';
|
||||||
|
|
||||||
|
test('loader dynamic importmap generation and custom path redirect', async ({ page }) => {
|
||||||
|
page.on('console', msg => console.log('BROWSER LOG:', msg.text()));
|
||||||
|
|
||||||
|
// 打开测试页面
|
||||||
|
await page.goto('http://127.0.0.1:8084/test/index.html');
|
||||||
|
|
||||||
|
// 1. 验证生成的 importmap 标签结构
|
||||||
|
const importMapJson = await page.evaluate(() => {
|
||||||
|
const script = document.querySelector('script[type="importmap"]');
|
||||||
|
return script ? JSON.parse(script.textContent) : null;
|
||||||
|
});
|
||||||
|
|
||||||
|
expect(importMapJson).not.toBeNull();
|
||||||
|
expect(importMapJson.imports).toBeDefined();
|
||||||
|
|
||||||
|
// 2. 检查 state (常规 CDN 映射) 是否生成正确
|
||||||
|
const stateUrl = importMapJson.imports['@apigo.cc/state'];
|
||||||
|
expect(stateUrl).toContain('cdn.jsdelivr.net/npm/@apigo.cc/state');
|
||||||
|
|
||||||
|
// 3. 检查 bootstrap (本地相对路径重定向) 是否保留
|
||||||
|
const bootstrapUrl = importMapJson.imports['@apigo.cc/bootstrap'];
|
||||||
|
expect(bootstrapUrl).toBe('./mock-bootstrap.js');
|
||||||
|
|
||||||
|
// 4. 检查 base (本地绝对 HTTP 重定向) 是否保留
|
||||||
|
const baseUrl = importMapJson.imports['@apigo.cc/base'];
|
||||||
|
expect(baseUrl).toBe('http://127.0.0.1:8084/test/mock-base.js');
|
||||||
|
|
||||||
|
// 5. 验证重定向的 mock 模块确实可以被 ESM 成功导入并运行 (通过页面 status 的变化)
|
||||||
|
const status = page.locator('#status');
|
||||||
|
await expect(status).toHaveText('success');
|
||||||
|
});
|
||||||
3
test/mock-base.js
Normal file
3
test/mock-base.js
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
export const HTTP = { isMock: true, name: 'base-mock' };
|
||||||
|
export const UI = { toast: () => {} };
|
||||||
|
export default { HTTP, UI };
|
||||||
2
test/mock-bootstrap.js
Normal file
2
test/mock-bootstrap.js
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
export const Bootstrap = { isMock: true, name: 'bootstrap-mock' };
|
||||||
|
export default Bootstrap;
|
||||||
@ -6,22 +6,29 @@ export default defineConfig({
|
|||||||
build: {
|
build: {
|
||||||
lib: {
|
lib: {
|
||||||
entry: resolve(__dirname, 'src/index.js'),
|
entry: resolve(__dirname, 'src/index.js'),
|
||||||
name: 'Loader',
|
name: 'ApigoLoader',
|
||||||
formats: ['iife'] // 使用 IIFE 格式，方便直接在 script 标签中使用
|
formats: ['umd', 'es']
|
||||||
},
|
},
|
||||||
rollupOptions: {
|
rollupOptions: {
|
||||||
output: [
|
output: [
|
||||||
{
|
{
|
||||||
format: 'iife',
|
format: 'umd',
|
||||||
name: 'Loader',
|
name: 'ApigoLoader',
|
||||||
entryFileNames: 'loader.js',
|
entryFileNames: 'loader.js'
|
||||||
extend: true
|
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
format: 'iife',
|
format: 'umd',
|
||||||
name: 'Loader',
|
name: 'ApigoLoader',
|
||||||
entryFileNames: 'loader.min.js',
|
entryFileNames: 'loader.min.js',
|
||||||
extend: true,
|
plugins: [terser()]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
format: 'es',
|
||||||
|
entryFileNames: 'loader.mjs'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
format: 'es',
|
||||||
|
entryFileNames: 'loader.min.mjs',
|
||||||
plugins: [terser()]
|
plugins: [terser()]
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user