labull-framework 0.1.29 → 0.1.30

package/README.md

@@ -80,20 +80,26 @@ const tab = await magicBlock.context()                    // { path, params, que
 await magicBlock.setTabTitle('订单 SO-42', 'pi pi-file')   // 给所属那条标签起名
 ```
 
-后端地址走 `VITE_API_BASE`（默认 `http://localhost:3000`）。
+后端地址：**默认相对本站**（空串）。跨源部署时由**宿主**在自己的入口里给一次 ——
+`app.use(labull, { apiBase: import.meta.env.VITE_API_BASE })`，或者 `setApiBase('https://api.你的域名')`。
+
+🔴 **别让库去读 `import.meta.env`**：这个包发布的是**预编译 dist**，而 `import.meta.env.*` 是 Vite 在
+**构建时**做的静态替换 —— 库构建那一刻没设这个变量 ⇒ 它被换成字面量烧进产物，你的 `.env` 再也
+覆盖不了（0.1.29 及以前就是这样：产物里烧死 `http://localhost:3000`，登录之后所有接口打到
+**访问者自己那台机器**）。那一句读法必须写在**你自己的源码**里，替换才会发生在**你的**构建里。
 
 ## subpath 对照表（原包 → 现在怎么 import）
 
 | 原来 | 现在 | 内容 |
 |---|---|---|
 | `@labull/theme` | `labull-framework/style.css`（或 `labull-framework/theme`） | `--sp-*` token + 完整主题层 + 结构类 + primeicons |
-| `@labull/auth` | `labull-framework/auth` | `useAuth()` / `apiFetch()` / `ensureAuthenticated()` / `createAuthGate()` / `API_BASE` |
+| `@labull/auth` | `labull-framework/auth` | `useAuth()` / `apiFetch()` / `ensureAuthenticated()` / `createAuthGate()` / `setApiBase()`（后端地址，**运行期**给）/ `API_BASE`（当前值，活绑定） |
 | `@labull/ui` | `labull-framework/ui` | `ProductShell` / `ProductSide` / `ProductTabs` / `TabPage` / `AppSearch` / `UserMenu` / `labull` 插件，以及标签那一套：`openTab` / `activateTab` / `closeTab` / `useTabs` / `useTabContext` |
 | `@labull/magic-block` | `labull-framework/magic-block` | `MagicBlockPage`（一条路由 = 一个块，**唯一入口**） / `MagicBlockConsole` / 清单校验 / bridge |
 
 根入口 `labull-framework` = `auth` + `ui`（最常用的两层）。
 
-🔴 **它故意不 re-export `magic-block`**：`magic-block` 与 `auth` 都导出 `API_BASE`，
+🔴 **它故意不 re-export `magic-block`**：`magic-block` 与 `auth` 都导出 `API_BASE`（以及 `setApiBase`），
 两路 `export *` 撞同一个名字是打包器层面的歧义。要块就从 `labull-framework/magic-block` 拿。
 
 ## 两份东西要知道

package/dist/auth.js

@@ -1,17 +1,18 @@
-import { A as s, a as t, C as r, b as u, c as A, d as c, e as h, f as i, g as n, h as E, l as o, i as S, j as _, u as l } from "./chunk-index-BWpDbB19.js";
+import { A as s, a as t, C as r, b as u, c as A, d as i, e as c, f as h, g as n, h as E, l as o, i as S, j as _, s as l, u as I } from "./chunk-index-BVIJeFeJ.js";
 export {
   s as API_BASE,
   t as AUTH_DEADLINE_MS,
   r as CLEAR_SESSION_DEADLINE_MS,
   u as apiFetch,
   A as authHeaders,
-  c as createAuthGate,
-  h as currentPath,
-  i as currentUser,
+  i as createAuthGate,
+  c as currentPath,
+  h as currentUser,
   n as currentUserInTime,
   E as ensureAuthenticated,
   o as loginUrl,
   S as loginWithRedirect,
   _ as logout,
-  l as useAuth
+  l as setApiBase,
+  I as useAuth
 };