labull-framework 0.1.28 → 0.1.30

package/dist/types/auth-real.d.ts

@@ -1,5 +1,12 @@
 import { type Ref } from 'vue';
-export declare const API_BASE: string;
+export declare let API_BASE: string;
+/**
+ * 设置后端地址（**运行期**；跨源部署时由宿主调一次）。空串 = 相对本站（默认）。
+ *
+ * 结尾的 `/` 一律去掉（`'https://api.x/' + '/auth/me'` 会长出双斜杠，有的网关会 404）。
+ * ⚠️ 必须在**任何请求之前**调（`app.use(labull, { apiBase })` 会替你调，且排在挂别的插件之前）。
+ */
+export declare function setApiBase(value: string | null | undefined): void;
 export declare const AUTH_DEADLINE_MS = 8000;
 export declare const CLEAR_SESSION_DEADLINE_MS = 1500;
 export interface AuthUser {

package/dist/types/magic-block-declared.d.ts

@@ -54,3 +54,39 @@ export declare function declaredUuidsOf(routes: DeclaredRoute[] | null | undefin
  *    见 `export._judge()` 里那条 `not-in-db` 条目）。
  */
 export declare function declaredMissing(routes: DeclaredRoute[] | null | undefined, page: unknown, dbIds: Iterable<string> | null | undefined): DeclaredEntry[];
+/** 块页组件上的标记键名。**字符串只写这一处**：`index.ts` 照着它打标记，这一节照着它认标记。 */
+export declare const BLOCK_PAGE_MARK = "__labullBlockPage";
+/**
+ * 这个值是不是块页。
+ *
+ * 🔴 **认标记、不认引用**：使用者的 `node_modules` 里可能同时躺着两份 `@labull/magic-block`
+ *    （两个依赖各锁了一个版本），那种情况下"引用相等"在两个副本之间**永远不成立** ——
+ *    而标记是打在同一个对象上的，跨副本照样认得出。
+ */
+export declare function isBlockPage(value: unknown): boolean;
+/** 块页站错位置的一种情形（`code` 是机器判据：用例按它断言 —— 报文改一个标点不该让用例红）。 */
+export interface BlockPlacementProblem {
+    /** `wrapped` = 块页被别的组件渲染；`nested` = 块路由挂在了别的路由下面；
+     *  `extra-views` = 除默认视图外还挂了具名视图；`no-uuid` = 挂了块页却没说这是哪个块。 */
+    code: 'wrapped' | 'nested' | 'extra-views' | 'no-uuid';
+    /** 出问题的那条路由（`chain` 里最后一条的路径；拿不到就是空串）。 */
+    path: string;
+    /** 给人看的一句话：错在哪儿 + 该往哪儿写。 */
+    message: string;
+}
+/**
+ * 块页站的位置对不对。`chain` 传 `route.matched`（最后一条是这条地址**真正渲染**的那条记录），
+ * `page` 传块页自己（`getCurrentInstance()?.type`；不传就只认标记）。回空数组 = 合规。
+ *
+ * 判这四件事：
+ *   ① `wrapped`     —— 链上最后一条记录挂的不是块页：块页被**别的组件**渲染出来了
+ *                      （AI 最常写的那种包装页，或在渲染函数里 `h(MagicBlockPage)`）；
+ *   ② `nested`      —— 块路由挂在别的路由下面：父级 template 里除了 `<RouterView>` 还有别的东西；
+ *   ③ `extra-views` —— 这条记录除了 `default` 还挂了具名视图，那正是"在块旁边摆第二块内容"；
+ *   ④ `no-uuid`     —— 挂了块页却没写块的 uuid：这一页不知道该渲染哪个块。
+ *
+ * 🔴 ①命中就**当场返回**：位置都不对，后面三条判了也没有意义（只会把一份问题说成四份）。
+ * ⚠️ 拿不到链（空表 / null）时回**空清单**：不知道的事不许编成一条违规 ——
+ *    闸门误报一次，人就会把整个闸门绕过去（`tools/block-guard.mjs` 里是同一句话）。
+ */
+export declare function blockPlacementProblems(chain: DeclaredRoute[] | null | undefined, page?: unknown): BlockPlacementProblem[];

package/dist/types/magic-block-real.d.ts

@@ -1,8 +1,9 @@
-export { default as MagicBlockPage } from './magic-block-MagicBlockPage.vue';
+import MagicBlockPage from './magic-block-MagicBlockPage.vue';
+export { MagicBlockPage };
 export { default as MagicBlockConsole } from './magic-block-MagicBlockConsole.vue';
 export { loadBlockRender, onBlockRenderRefresh, refreshBlockRender, type BlockRender } from './magic-block-render';
 export { BLOCK_BACKEND_FILE, BLOCK_ENTRY, buildPreview } from './magic-block-preview';
 export { CLIENT_SOURCE, installBridge, type BridgeDeps } from './magic-block-bridge';
 export { BLOCK_MANIFEST, MANIFEST_KEYS, MANIFEST_REQUIRED, NAME_MAX, checkSelection, parseManifest, validFileName, validName, validateBlock, type BlockValidation, type Manifest, type ManifestKey, type SelectionCheck, } from './magic-block-manifest';
-export { API_BASE } from './auth-real';
-export { declaredMissing, declaredUuidOf, declaredUuidsOf, type DeclaredEntry, type DeclaredRoute, } from './magic-block-declared';
+export { API_BASE, setApiBase } from './auth-real';
+export { BLOCK_PAGE_MARK, blockPlacementProblems, declaredMissing, declaredUuidOf, declaredUuidsOf, isBlockPage, type BlockPlacementProblem, type DeclaredEntry, type DeclaredRoute, } from './magic-block-declared';

package/dist/types/ui-real.d.ts

@@ -13,6 +13,16 @@ export type { LocationResolver, TabContext } from './ui-tab-context';
 export type { SideItem } from './ui-types';
 export interface LabullOptions {
     extra?: Plugin[];
+    /**
+     * 后端地址（跨源部署时给；不给 = **相对本站**）。
+     *
+     * 🔴 **由宿主传，库自己不读构建期 env**：这个包发布的是预编译 dist，而 `import.meta.env.*`
+     *    是构建时的静态替换 —— 库构建那一刻的值会被烧成字面量，使用方再也覆盖不了
+     *    （真踩过：产物里烧死了 `http://localhost:3000`，登录后所有接口打到访问者自己的机器）。
+     *    所以这一句要写在**宿主**的入口里，由宿主自己的构建工具替换：
+     *      `app.use(labull, { apiBase: import.meta.env.VITE_API_BASE })`
+     */
+    apiBase?: string;
 }
 export declare function installApp(app: App, options?: LabullOptions): void;
 export declare const labull: Plugin;

package/dist/ui.js

@@ -1,5 +1,5 @@
-import { A as e, P as o, a as t, b as l, _ as T, U as b, i as r, l as i } from "./chunk-index-BN-lnG-w.js";
-import { T as n, a as p, c as u, f as d, i as P, b as f, o as x, p as A, s as v, u as C, d as S } from "./chunk-ProductShell.vue_vue_type_style_index_0_scoped_06035587_lang-BpRKKThg.js";
+import { A as e, P as o, a as t, b as l, _ as T, U as b, i as r, l as i } from "./chunk-index-3dQJWK2S.js";
+import { T as n, a as p, c as u, f as d, i as P, b as f, o as x, p as A, s as v, u as C, d as S } from "./chunk-ProductShell.vue_vue_type_style_index_0_scoped_06035587_lang-Fky1ghd2.js";
 export {
   e as AppSearch,
   o as ProductShell,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "labull-framework",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "private": false,
   "type": "module",
   "description": "Labull 前端 SDK：主题 CSS + 登录态 / 外壳组件 / magic block（四块合一，一个包）",