labull-framework 0.1.0

package/dist/theme.d.ts

@@ -0,0 +1 @@
+export * from './types/theme'

package/dist/theme.js

@@ -0,0 +1,4 @@
+const e = "labull-framework/theme";
+export {
+  e as THEME_ENTRY
+};

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

@@ -0,0 +1,60 @@
+import { type Ref } from 'vue';
+export declare const API_BASE: string;
+export declare const AUTH_DEADLINE_MS = 8000;
+export declare const CLEAR_SESSION_DEADLINE_MS = 1500;
+export interface AuthUser {
+    id: string;
+    /** Authing 的身份（就是 Django 那边的 `username`）。 */
+    username: string;
+    name: string;
+    /** 工号（Authing 的 `username` 同步过来的；没有就是 null）。 */
+    workId: string | null;
+    /** 🔴 "是不是管理员" = 这个布尔位（Django 的 `is_staff`）。前端只拿它做**显隐**，授权全在后端。 */
+    isStaff: boolean;
+    groups: string[];
+    permissions: string[];
+}
+export declare function authHeaders(method?: string, json?: boolean): Record<string, string>;
+export declare function apiFetch<T>(path: string, init?: RequestInit): Promise<T>;
+export declare function currentPath(): string;
+/** 后端登录入口（它再 302 到 OIDC 授权页）。🔴 只放行站内 redirect：放行外站就是开放重定向。 */
+export declare function loginUrl(redirect?: string): string;
+export declare function loginWithRedirect(redirect?: string): void;
+export declare function logout(): void;
+/**
+ * 认人。**只有后端明确说"你没登录"（401 / 403）才去清会话**。
+ *
+ * 🔴 这里曾经有个很难查的 bug：原来"只要 `/auth/me` 不顺就 POST `/auth/logout`"，
+ *    而网络抖动、后端还没起来、代理 502 都会被算进"不顺" ⇒ 顺手把**整个会话**清掉。
+ *    登录流程的 `state` 正存在那个会话里（`/auth/login` 存、`/auth/callback` 比），
+ *    于是症状极难对上：**"点登录 → 走完 Authing → 回到 /auth/callback 说登录会话已过期"**，
+ *    而中间那一下"清会话"跟登录两个字在日志里一点关系都看不出来。
+ * 🔴 另外"后端没答话"本来就**判不出来**是谁——那时什么都不该做（下一次问就是了）。
+ */
+export declare function currentUser(): Promise<AuthUser | null>;
+export declare function currentUserInTime(ms?: number): Promise<AuthUser | null | 'timeout'>;
+export declare function ensureAuthenticated(redirect?: string, ms?: number): Promise<AuthUser | null>;
+export interface AuthGate {
+    open: Ref<boolean>;
+    denied: Ref<boolean>;
+    unreachable: Ref<boolean>;
+    pass(redirect: string): Promise<void>;
+    recheck(redirect: string): void;
+}
+export interface AuthGateOptions {
+    deadlineMs?: number;
+}
+/** 造一道闸门。⚠️ 是工厂不是单例：状态只属于挂着它的那个外壳。 */
+export declare function createAuthGate(options?: AuthGateOptions): AuthGate;
+export declare function useAuth(): {
+    user: Ref<AuthUser | null, AuthUser | null>;
+    isStaff: import("vue").ComputedRef<boolean>;
+    /** 🔴 只是界面提示位（本地读得到 CSRF cookie 就算），**不是授权判据**：要挡就在后端挡。 */
+    isAuthenticated: () => boolean;
+    refresh: () => Promise<AuthUser | null>;
+    apiFetch: typeof apiFetch;
+    authHeaders: typeof authHeaders;
+    currentPath: typeof currentPath;
+    login: typeof loginWithRedirect;
+    logout: typeof logout;
+};

package/dist/types/auth.d.ts

@@ -0,0 +1 @@
+export * from './auth-real';

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './auth';
+export * from './ui';

package/dist/types/magic-block-MagicBlockConsole.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/magic-block-MagicBlockHost.vue.d.ts

@@ -0,0 +1,21 @@
+/** 🔴 `uuid` 是前端写死的：后端按它找那一行（库里还没有也能先渲染成「未开发」）。`width` / `height` 数字按 rem 处理、字符串原样当 CSS 值。 */
+type __VLS_Props = {
+    uuid: string;
+    name?: string;
+    module?: string;
+    width?: string | number;
+    height?: string | number;
+    flexible?: boolean;
+    fullSize?: boolean;
+    responsive?: boolean;
+    theme?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    name: string;
+    module: string;
+    flexible: boolean;
+    fullSize: boolean;
+    responsive: boolean;
+    theme: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,22 @@
+/**
+ * full-size 的块**不许自己出竖滚动条**（滚的是外层页面，见 `MagicBlockHost.vue` 的 `fullSize`）。
+ *
+ * 🔴 这条要**在文档里**禁，不是在 iframe 标签上：`scrolling="no"` 与父页给的 `overflow: hidden`
+ *    都管不到文档自己的视口。宿主这一侧看不见块里的 DOM（沙箱是不透明源），所以只能随预览一起注入。
+ * 🔴 为什么不能靠"把宿主那层设得够高"就算了：块一出现滚动条，**内容宽度就少十几像素** ⇒
+ *    文字重新折行 ⇒ 量到的内容高度又变 ⇒ 宿主再改高度 —— 两边来回抖。
+ *    `overflow: hidden` 把这个正反馈从源头掐掉（内容高度只由宽度决定，而宽度不再变）。
+ * ⚠️ 代价：块真比宿主给的位置更高时，多出来的部分**是被裁掉的**（不是藏起来还能滚）。
+ *    所以只在 full-size 这条路上加（`MagicBlockHost.vue` 的 `extras`），弹性那条路块该滚还得滚。
+ */
+export declare const BLOCK_NO_SCROLL_CSS = "html, body { overflow: hidden !important; }";
+/** 注入到块 iframe 里的 JS 源码（块没有构建步骤，它必须自己就是能跑的 JS）。
+ * 🔴 这是模板字符串：段内的注释出现反引号会提前截断它（实现也一律用字符串拼接）。 */
+export declare const CLIENT_SOURCE = "\n(function () {\n  var seq = 0, waiting = {}, queue = [], ready = false, last = -1;\n  function call(method, args) {\n    return new Promise(function (resolve, reject) {\n      function run() {\n        var id = ++seq;\n        waiting[id] = { resolve: resolve, reject: reject };\n        parent.postMessage({ '__mb': 'call', id: id, method: method, args: args }, '*');\n      }\n      if (ready) run(); else queue.push(run);\n    });\n  }\n  window.addEventListener('message', function (event) {\n    var data = event.data, pending;\n    if (!data || data['__mb'] === undefined) return;\n    if (data['__mb'] === 'host-ready') { ready = true; queue.splice(0).forEach(function (run) { run(); }); return; }\n    if (data['__mb'] !== 'reply') return;\n    if (!(pending = waiting[data.id])) return;\n    delete waiting[data.id];\n    if (data.ok) pending.resolve(data.value); else pending.reject(new Error(data.error || '\u8C03\u7528\u5931\u8D25'));\n  });\n  window.magicBlock = {\n    getMe: function () { return call('getMe', []); },\n    navigateTab: function (path) { return call('navigateTab', [path]); }\n  };\n  function make(prefix) {\n    return new Proxy(function () {}, {\n      get: function (_, name) { return make(prefix ? prefix + '.' + name : name); },\n      apply: function (_, __, args) {\n        var params = args[0] === undefined || args[0] === null ? {} : args[0];\n        if (typeof params !== 'object' || Array.isArray(params)) return Promise.reject(new Error('magicBackendApi.' + prefix + '(params) \u7684\u53C2\u6570\u8981\u4E48\u662F\u4E00\u4E2A\u5BF9\u8C61\uFF08\u62FF\u4E0D\u51C6\u5C31\u4F20 {}\uFF09\uFF0C\u8981\u4E48\u662F\u4E00\u4E2A\u6587\u4EF6\uFF08File / Blob\uFF09'));\n        return call('backend', [prefix, params]);\n      }\n    });\n  }\n  window.magicBackendApi = make('');\n  if (typeof document === 'undefined') return;\n  function report() {\n    var body = document.body;\n    if (!body) return;\n    var max = -1, style = window.getComputedStyle(body), bodyTop = body.getBoundingClientRect().top;\n    var gap = (parseFloat(style.marginTop) || 0) + (parseFloat(style.marginBottom) || 0);\n    try {\n      for (var i = 0; i < body.children.length; i += 1) {\n        var el = body.children[i], cs = window.getComputedStyle(el), rect = el.getBoundingClientRect();\n        if (cs.display === 'none' || cs.visibility === 'hidden' || cs.position === 'fixed' || rect.height <= 0) continue;\n        if (rect.bottom > max) max = rect.bottom;\n      }\n    } catch (error) { return; }\n    var height = max < 0 ? 0 : Math.ceil(max - bodyTop + gap); /* \u4E00\u6761\u6B63\u5E38\u6D41\u5185\u5BB9\u90FD\u6CA1\u6709 \u21D2 \u62A5 0\uFF08\u5BBF\u4E3B\u6309\u8FD8\u6CA1\u91CF\u5230\u5904\u7406\uFF09 */\n    /* \uD83D\uDD34 +1 \u662F\"\u53D6\u6574\u7684\u4F59\u91CF\"\uFF1A\u51E0\u4F55\u4E0A\u7B97\u51FA\u6765\u7684\u5185\u5BB9\u9AD8\u5EA6\u5E38\u5E38\u5DEE\u90A3\u4E48\u96F6\u70B9\u51E0\u50CF\u7D20\uFF08\u5B50\u50CF\u7D20\u6392\u7248\uFF09\uFF0C\n     *    \u5BBF\u4E3B\u7167\u7740\u5B83\u8BBE\u9AD8\u5EA6\u65F6\u5C31\u4F1A**\u5DEE\u4E00\u50CF\u7D20**\u2014\u2014\u90A3\u4E00\u50CF\u7D20\u6B63\u662F\u4E00\u4E2A\u7AD6\u6EDA\u52A8\u6761\u7684\u5F00\u5173\u3002 */\n    if (height > 0) height += 1;\n    if (height === last) return; /* \u4E00\u6837\u9AD8\u5C31\u4E0D\u518D\u53D1\uFF1A\u5426\u5219\u300C\u5BBF\u4E3B\u6539\u9AD8\u5EA6 \u2192 \u89E6\u53D1\u89C2\u5BDF \u2192 \u53C8\u53D1\u4E00\u6B21\u300D\u4F1A\u8F6C\u4E2A\u4E0D\u505C */\n    last = height;\n    parent.postMessage({ '__mb': 'height', height: height }, '*');\n  }\n  function start() {\n    report();\n    if (window.ResizeObserver && document.body) new ResizeObserver(report).observe(document.body);\n  }\n  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', start); else start();\n  setInterval(report, 500);\n})();\n";
+export interface BridgeDeps {
+    uuid: string;
+    onHeight?: (height: number) => void;
+    /** 🔴 路由白名单在宿主手上（块看不到路由表）。 */
+    onNavigateTab?: (path: string) => Promise<string> | string;
+}
+export declare function installBridge(iframe: HTMLIFrameElement, deps: BridgeDeps): () => void;

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

@@ -0,0 +1,15 @@
+/** 生成物在开发目录顶层的那两个名字。⚠️ 与后端 `export.DEV_PAGES_LOCK` **逐字一致**。 */
+export declare const PAGES_LOCK = "pages.lock.ts";
+/** 一条页面（从路由表现算出来的那一份：见 `AppSearch` 的 `collect()`，判据与它同一套）。 */
+export interface PageEntry {
+    /** 路由路径（`navigateTab()` 收的就是它）。 */
+    path: string;
+    /** 页面的中文名（`meta.title`，没有就退到 `meta.sub` / 路径）。 */
+    title: string;
+    /** 分组（`meta.group`；没有就是空串）。 */
+    group: string;
+}
+/** 路径 → 枚举键：`/orders` ⇒ `Orders`，`/order-detail` ⇒ `OrderDetail`（中文路径退到 `Page2` 这种）。 */
+export declare function pageKey(path: string, index: number): string;
+/** 生成 `pages.lock.ts` 的正文（纯文本，写盘由调用方做）。 */
+export declare function pagesLockTs(pages: PageEntry[]): string;

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

@@ -0,0 +1,34 @@
+/** 亮红框的默认时长（毫秒）：够人从一页跳到另一页之后还看得见那一下。 */
+export declare const HIGHLIGHT_MS = 4000;
+/** 订阅"高亮变了"（组件用；返回退订函数）。 */
+export declare function onBlockHighlight(fn: () => void): () => void;
+/** 现在该亮红框的是哪一块（空串 = 没有）。 */
+export declare function highlightedUuid(): string;
+/**
+ * 记下"这个块挂在这一页"，返回退订函数（宿主卸载时调）。
+ *
+ * ⚠️ 同一个块挂在两页 ⇒ 两条都在；退订只去掉**这一页**那一条。
+ * ⚠️ uuid / 路径是空的一律不记（记了会变成"能跳到一页没有路径的地方"）。
+ */
+export declare function mountBlock(uuid: string, path: string): () => void;
+/** 这个块还挂在哪一页（**除了 `currentPath`**）；没有就回 `null`。 */
+export declare function whereElse(uuid: string, currentPath: string): string | null;
+/** 这个块记录到的全部页面（按记下来的顺序）。 */
+export declare function mountedAt(uuid: string): string[];
+/**
+ * 「定位这一块」该跳到哪一页（`null` = **不用跳**）。
+ *
+ * 🔴 与 `whereElse()` 是两件事、两套取舍，别混着用：
+ *    · `whereElse()`（块自己那一圈被点）—— 优先去**别的**页面（"这个块还挂在别处"）；
+ *    · `locateTarget()`（控制台里点那一行）—— 本页就有就**留在本页**（就在眼皮底下，
+ *      把人传送走只会让人找不到刚点的那一块），本页没有才去第一个挂着它的页面。
+ */
+export declare function locateTarget(uuid: string, currentPath: string): string | null;
+/**
+ * 让这一块亮几秒红框（点那一圈时调）。
+ *
+ * 🔴 **先亮、再跳**：目标页那一块一露面就已经是"该亮"的状态，不必等它挂载之后再通知一次。
+ */
+export declare function flashBlock(uuid: string, ms?: number): void;
+/** 立刻收起高亮（用例、以及"不想再亮"的场合用）。 */
+export declare function clearHighlight(): void;

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

@@ -0,0 +1,126 @@
+/** 用户选中的那个目录（句柄留在内存里：刷新一次就要重选，**句柄存不进 localStorage**）。 */
+export interface LocalDir {
+    /** 目录名（只用来显示）。 */
+    name: string;
+    handle: FileSystemDirectoryHandle;
+}
+/** 后端给的扫描规则（`export.scan_rules()` 的正文，字段名逐字对齐）。 */
+export interface ScanRules {
+    /** 块包入口的名字（`index.open.html`）。 */
+    entry: string;
+    /** 代码铺在哪一层（导出铺的是 `workspace/`）：导出前问"要不要覆盖"时用它认"这里已经有块了"。 */
+    blocksDir: string;
+    /** 认得的文本扩展名（其余一律跳过并报一条）。 */
+    textExt: string[];
+    /** 爬目录时跳过的目录名（依赖 / 构建产物 / 缓存）。 */
+    skipDirs: string[];
+    /** 平台生成物：**静默跳过**（不进库）。 */
+    platformFiles: string[];
+    /** 开发目录**顶层**直接忽略的文件名。 */
+    rootSkipFiles: string[];
+    /** 最多往下几层。 */
+    maxDepth: number;
+    /** 单个文件的上限（字节）。 */
+    maxFileBytes: number;
+    /** 一次"读回改动"的正文上限（字节）：读到的合计超过它就当场说清，别让后端回一句看不懂的错。 */
+    maxBodyBytes: number;
+}
+/** 浏览器扫出来的一条失败（形状与后端 `export._failure()` 一致：`{kind, where, message}`）。 */
+export interface ScanFailure {
+    kind: 'dir' | 'file';
+    where: string;
+    message: string;
+}
+/** 递给 `POST /magic-blocks/read` 的那一份扫描结果（**这就是"事实"**，后端据此配对与比对）。 */
+export interface ScanUpload {
+    /** 选中的目录名（回话里原样带回来）。 */
+    root: string;
+    /** 候选块文件夹：`where` 是相对选中目录的路径，`files` 是包内相对路径 → 正文。 */
+    folders: {
+        where: string;
+        files: Record<string, string>;
+    }[];
+    failures: ScanFailure[];
+    /** 因为层数上限没走完 ⇒ 不能说"目录里没有就是删了"。 */
+    truncated: boolean;
+}
+/** 这个浏览器能不能直接写本机目录（Chrome / Edge 才有；还要 https 或 localhost）。 */
+export declare function pickerAvailable(): boolean;
+/** 弹系统目录选择框，回用户选的那个目录（取消 ⇒ 抛一句人话，不静默返回空）。 */
+export declare function pickDirectory(): Promise<LocalDir>;
+/**
+ * 路径 → 能逐级建目录的段（**在客户端再拦一道**）。
+ *
+ * 🔴 键是后端算出来的（它只铺 `workspace/…` 这种相对路径），这里再拦一道的理由是"落盘的判据不该只有上游"：
+ *    `..` / 绝对路径 / 盘符 / 反斜杠在**用户的盘上**是"写到别处去"，而这一层是最后一道。
+ */
+export declare function pathSegments(path: string): string[];
+/** 一条写失败的记录（`path` 是包内相对路径，`message` 是一句人话）。 */
+export interface WriteFailure {
+    path: string;
+    message: string;
+}
+/** `writePackage` 的结果。🔴 一个文件失败**不算整批失败**：写成的照写，失败的如实列出来。 */
+export interface WriteResult {
+    written: number;
+    failed: WriteFailure[];
+    /** 一共排了几个文件（= `written + failed.length`，进度条的分母）。 */
+    total: number;
+}
+/**
+ * 把一整个开发包写进用户选的目录（`{相对路径: 正文}`）。
+ *
+ * 🔴 **清空是"问过才做"的动作**：导出前会先看目录里有什么、由控制台问一句（清空 / 只覆盖 / 取消）。
+ *    这个函数自己**不删任何东西**（`clearChildren()` 才是删那一步），它只管写。
+ * 🔴 **并发写 + 目录句柄缓存**：原来是一个文件一个文件地等、每个文件都从根重新走一遍目录，
+ *    几十个文件（含 540 KB 的主题那份）要串行好几趟目录树。
+ * 🔴 **一个文件写失败不许把整批吞掉**：失败收进 `failed` 回给调用方（这一层的判据与后端
+ *    `export.write_dir` 一致 —— "一个块失败只报它自己"），调用方把它们显示出来。
+ *    原来是一抛全停：排在前面的文件已经落盘了，用户却只看到一句"失败"，不知道铺了多少。
+ */
+export declare function writePackage(dir: LocalDir, files: Record<string, string>, onProgress?: (done: number, total: number) => void): Promise<WriteResult>;
+/** 选中目录里都有什么（顶层项 + 递归数出来的文件 / 目录数）—— 导出前"要不要清空"那个确认框用。 */
+export interface DirInventory {
+    /** 顶层项（名字 + 是不是目录）。 */
+    items: {
+        name: string;
+        dir: boolean;
+    }[];
+    /** 顶层项个数。 */
+    topCount: number;
+    /** 递归数出来的文件数。 */
+    files: number;
+    /** 递归数出来的目录数（不含选中目录自己）。 */
+    dirs: number;
+}
+/**
+ * 数一遍选中目录里有什么（**只读**，不动任何东西）。
+ *
+ * 🔴 只走 `rules.maxDepth` 层：确认框要的是"大概有多少东西"，为此把一个巨大的目录爬到底
+ *    （依赖目录动辄几万个文件）只会让"导出"按钮按下去半天没反应。
+ */
+export declare function inspectDirectory(dir: LocalDir, rules: ScanRules): Promise<DirInventory>;
+/**
+ * 把选中目录**里面的东西**全删掉（选中目录本身不动，它外面的东西更不碰）。
+ *
+ * 🔴 判据只有一条：**只删 `dir` 的子项**。用 `handle.removeEntry(name, { recursive: true })` 按名字删，
+ *    路径**拼不出来**（不是"拼一个路径再删"）—— 这样"删到别处去"在实现上就不可能发生。
+ * 🔴 删除是**不可逆**的，所以它只能由用户在确认框里点过"清空并导出"之后走到这里（见控制台）。
+ * ⚠️ 删完再铺：并发写的时候如果和删除同时跑，`getDirectoryHandle(create: true)` 可能建出马上又被删掉的目录。
+ */
+export declare function clearChildren(dir: LocalDir): Promise<number>;
+/**
+ * 选中的目录**本身**就是代码那一层时当场说清（`workspace/workspace/…` 是没人想要的）。
+ *
+ * 🔴 这是个很容易犯的错：目录选择框上写着"选一个文件夹"，而 `workspace/` 也是一个文件夹。
+ *    选错一层的**后果**是代码铺进两层 `workspace/` 里，而"读回改动"照样认得出来（它按 uuid 认）——
+ *    于是这个错会一直躺着，直到有人去看目录结构。
+ */
+export declare function assertNotBlocksDir(dir: LocalDir, rules: ScanRules): void;
+/**
+ * 扫一遍用户选中的目录，攒出递给 `POST /magic-blocks/read` 的那一份事实。
+ *
+ * 🔴 超过正文上限**当场说清**：后端那边回的是"请求正文太大"，而用户看到那句话时并不知道
+ *    自己能做什么（这一句里带着"多大 / 上限多少"）。
+ */
+export declare function scanDirectory(dir: LocalDir, rules: ScanRules): Promise<ScanUpload>;

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

@@ -0,0 +1,64 @@
+/** 块包入口（必备件）。与后端 `sdk.BLOCK_ENTRY` 逐字一致。 */
+export declare const BLOCK_ENTRY = "index.open.html";
+/** 块包清单（必备件）。与后端 `sdk.BLOCK_MANIFEST` 逐字一致。 */
+export declare const BLOCK_MANIFEST = "magic-block.open.yaml";
+/** 清单只认这四个键，全部必填（顺序就是文档里的顺序）。 */
+export declare const MANIFEST_KEYS: readonly ["id", "module", "name", "brief"];
+export type ManifestKey = (typeof MANIFEST_KEYS)[number];
+/** 可读名的字符上限（与后端 `NAME_MAX` 同一份）。 */
+export declare const NAME_MAX = 40;
+/** 包内文件名的形状。
+ *  🔴 `(?![A-Za-z]:)` 与 `(?!/)` **两个前瞻缺一不可**：后端 `FILE_NAME_PATTERN` 是
+ *     `^(?!/)(?![A-Za-z]:)[A-Za-z0-9._\-/]+$`，而 `/etc/passwd` 是**字符合法但语义是绝对路径** ——
+ *     少一个前瞻就等于放行绝对路径（这一条是差分比对抓出来的，见 `tools/manifest-parity.mjs`）。 */
+export declare const FILE_NAME_PATTERN: RegExp;
+/** 清单里 `id` 的形状。 */
+export declare const BLOCK_ID_PATTERN: RegExp;
+/** 清单里 `module` 的形状。 */
+export declare const MODULE_PATTERN: RegExp;
+/** 清单里的键名形状。 */
+export declare const MANIFEST_KEY_PATTERN: RegExp;
+/** 清单里 `name` 的形状（🔴 这里**不能只判长度**：`'   '` 长度合法但它是空的）。 */
+export declare function validName(value: string): boolean;
+/** 清单解析出来的字段（缺的 / 空的**不会**出现在这里）。 */
+export type Manifest = Partial<Record<ManifestKey, string>>;
+/** 一个块包的校验结果。`files` 是提交时**原样回给后端**的那一份，这里只读不写。 */
+export interface BlockValidation {
+    /** 清单里读出来的四个键（没读全就是空对象）。 */
+    manifest: Manifest;
+    /** 逐条问题，中文、可直接显示给用户。 */
+    issues: string[];
+}
+/**
+ * 解析清单正文：`[认得的字段, 逐条问题]`（与后端 `parse_manifest` 同一套判据、同一套报文）。
+ *
+ * 🔴 不认识的写法（列表 / 嵌套 / 没有冒号 / 不认识的键 / 重复键）**各报一条**，绝不静默忽略 ——
+ *    静默的后果是"前端放行、后端拒绝"，用户看到的是两套说法。
+ */
+export declare function parseManifest(text: string): [Manifest, string[]];
+/** 包内文件名合法吗（形状 + 不许 `..` 段）。 */
+export declare function validFileName(name: string): boolean;
+/**
+ * 一整个块包的判据（**前端这一半**）：必备件 + 清单 + 文件名。
+ *
+ * 🔴 **不判块后端**：`backend_open.py` 要 `ast` 静态判据 + 子进程试加载，那是服务端才做得到的事
+ *    （见 `validate.check_backend`）。这份函数过了不等于能存，只等于"值得发这一趟请求"。
+ */
+export declare function validateBlock(files: Record<string, string>): BlockValidation;
+/** 一次"保存选中的块"该带的全部信息。 */
+export interface SelectionCheck {
+    /** 勾了几个块（0 = 一个都没勾）。 */
+    selected: number;
+    /** 所有问题（每条都带块名，直接显示）。 */
+    issues: string[];
+}
+/**
+ * 「保存选中的块」按钮的判据：勾了没有、每包过不过。
+ *
+ * 🔴 **一个块都没勾 = 直接拦下**：空请求打过去只会得到一句"没有能保存的块"，
+ *    而用户真正的问题是"我忘了勾" —— 这件事只有浏览器知道。
+ */
+export declare function checkSelection(items: {
+    name?: string;
+    files?: Record<string, string>;
+}[]): SelectionCheck;

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

@@ -0,0 +1,11 @@
+export declare const BLOCK_ENTRY = "index.open.html";
+export declare const BLOCK_BACKEND_FILE = "backend_open.py";
+export interface PreviewExtras {
+    /** 注入给块的引导脚本（`CLIENT_SOURCE`）。 */
+    bootstrap?: string;
+    /** 宿主额外加的 CSS：禁掉块自己的滚动条（`fullSize` 用）。 */
+    css?: string;
+    /** 应用主题 / 控件那一层 CSS（`theme.ts` 的 `collectThemeCss()`；由 `MagicBlockHost` 的 `theme` prop 决定给不给）。 */
+    themeCss?: string;
+}
+export declare function buildPreview(files: Record<string, string>, extras?: string | PreviewExtras): string;

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

@@ -0,0 +1,7 @@
+export { default as MagicBlockHost } from './magic-block-MagicBlockHost.vue';
+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, 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';

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

@@ -0,0 +1,12 @@
+export interface BlockRender {
+    id: string;
+    state: 'draft' | 'invalid' | 'ok';
+    name: string;
+    brief: string;
+    reason: string | null;
+    files?: Record<string, string>;
+}
+export declare function onBlockRenderRefresh(fn: () => void): () => void;
+export declare function refreshBlockRender(): void;
+/** 批量问状态（**只问还没问到过的那些**）。🔴 读不到（断网 / 会话失效）**不抛给宿主**：页面退回「按手上有什么显示」。 */
+export declare function loadBlockRender(ids: string[]): Promise<BlockRender[]>;

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

@@ -0,0 +1,33 @@
+/** 开发包根上那份主题 CSS 的名字。⚠️ 与后端 `devkit.THEME` **逐字一致**。 */
+export declare const THEME_FILE = "labull.css";
+/** 控件清单（照着抄 markup）。⚠️ 与后端 `devkit.CONTROLS` **逐字一致**。 */
+export declare const CONTROLS_FILE = "CONTROLS.lock.html";
+/** 收出来的那份样式（`css` 就是要写进文件里的正文）。 */
+export interface ThemeBundle {
+    css: string;
+    /** 读到规则的样式表张数。 */
+    sheets: number;
+    /** 读不到规则的（跨源 / 还没加载完）：如实列出来，别装作收全了。 */
+    skipped: string[];
+    /** 收了多少条规则。 */
+    rules: number;
+}
+/**
+ * 这条规则算不算"主题 / 控件"（其余一律丢掉：应用自己的业务样式不该混进开发包）。
+ *
+ * 留：`@font-face` / `@keyframes`；选择器里有 `.p-`（PrimeVue 控件）/ `.pi`（图标）/ `.labull-`（结构类）
+ *     / `:root` / `html` / `body` / `*`；**`:where(...)` 开头的那一层**（主题给原生控件与 `<dialog>`
+ *     留的零特异度兜底 —— 它的声明里常常一个 token 都没有，例如 `::backdrop` 的纯色遮罩，
+ *     所以不能只靠"有没有 token"判它）；或者这条规则里在定义 `--sp-*` / `--surface-*` 这类 token。
+ * 🔴 纯函数：只看文本，不看 DOM —— 所以能直接用 node 跑用例。
+ */
+export declare function keepCssRule(selector: string, cssText: string): boolean;
+/** 收一份自足的 CSS（规则从**当前页面已加载的样式表**里来）。 */
+export declare function collectThemeCss(): ThemeBundle;
+/**
+ * `CONTROLS.lock.html`：控件清单（一页能直接打开看的对照表，markup 可以照抄）。
+ *
+ * 🔴 只列**光有 CSS 就能看**的东西：PrimeVue 那些需要 JS 的组件（下拉、日期、弹窗）不在这里，
+ *    免得作者抄了 markup 却发现没有行为（那比不给他更糟）。
+ */
+export declare function controlsPage(): string;

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

@@ -0,0 +1 @@
+export * from './magic-block-real';

package/dist/types/theme.d.ts

@@ -0,0 +1,3 @@
+import '../../theme/tokens.css';
+import '../../theme/labull.css';
+export declare const THEME_ENTRY = "labull-framework/theme";

package/dist/types/ui-AppSearch.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/ui-ProductShell.vue.d.ts

@@ -0,0 +1,31 @@
+import type { SideItem } from './ui-types';
+type __VLS_Props = {
+    actions?: boolean;
+    side?: SideItem[];
+    logo?: string;
+    caption?: string;
+    /** 左侧图标栏最上面那个"首页"按钮的路径（默认 `/`）。配合 `side` 用。 */
+    home?: string;
+    /** 底部竖排的产品名（不给就不画）。 */
+    brand?: string;
+};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {};
+type __VLS_Slots = {} & {
+    bar?: (props: typeof __VLS_1) => any;
+} & {
+    appbar?: (props: typeof __VLS_3) => any;
+} & {
+    actions?: (props: typeof __VLS_5) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    home: string;
+    actions: boolean;
+    caption: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/ui-ProductSide.vue.d.ts

@@ -0,0 +1,14 @@
+import type { SideItem } from './ui-types';
+type __VLS_Props = {
+    items: SideItem[];
+    /** 底部竖排的产品名（不给就不画）。 */
+    brand?: string;
+    /** 图标栏最上面那一个"首页"按钮：点它跳这个路径（**不开新标签的例外**，它由路由自己记账）。 */
+    home?: string;
+    /** 首页按钮的名字。 */
+    homeTitle?: string;
+    /** 首页按钮的图标。 */
+    homeIcon?: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/ui-ProductTabs.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/ui-UserMenu.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

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

@@ -0,0 +1,9 @@
+export interface SharedGate {
+    /** 认人；没登录时**只跳一次** Authing。返回"这次认出来了吗"。 */
+    pass(redirect: string): Promise<boolean>;
+    /** 身份作废（退出登录 / 从 bfcache 退回来）：下一次问会重新认。 */
+    reset(): void;
+}
+/** 按地址栏认人（路由守卫用的就是这一条）。 */
+export declare function passShared(): Promise<boolean>;
+export declare function resetShared(): void;

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

@@ -0,0 +1,16 @@
+import type { App, Plugin } from 'vue';
+import AppSearch from './ui-AppSearch.vue';
+import ProductShell from './ui-ProductShell.vue';
+import ProductSide from './ui-ProductSide.vue';
+import ProductTabs from './ui-ProductTabs.vue';
+import UserMenu from './ui-UserMenu.vue';
+export { AppSearch, ProductShell, ProductSide, ProductTabs, UserMenu };
+export { openTab, closeTab, registerTabLabel, useTabs, TABS_MAX } from './ui-tabs';
+export type { TabItem } from './ui-tabs';
+export type { SideItem } from './ui-types';
+export interface LabullOptions {
+    extra?: Plugin[];
+}
+export declare function installApp(app: App, options?: LabullOptions): void;
+export declare const labull: Plugin;
+export default labull;

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

@@ -0,0 +1,31 @@
+/** 标签上限：点开太多页时丢最早那个（界面上的东西，不设上限会越攒越长）。 */
+export declare const TABS_MAX = 12;
+export interface TabItem {
+    /** 标签的键，就是路径。 */
+    key: string;
+    path: string;
+    title: string;
+    /** PrimeIcons 的类名，例如 `pi pi-home`。 */
+    icon: string;
+}
+/**
+ * 页面自报名字（可选）。
+ *
+ * 🔴 为什么需要它：`meta.title` 只对**写死在路由表里**的页面有效；带参数的页面（`/orders/42`）
+ *    要显示"订单 SO-1"这种名字，只有页面自己知道。页面在 `onMounted` 里调一次即可。
+ */
+export declare function registerTabLabel(path: string, title: string, icon?: string): void;
+/** 开一个标签（已经开着就切过去）并把当前页指到它 —— **这是"跳页"的唯一入口**。 */
+export declare function openTab(path: string, meta?: {
+    title?: unknown;
+    icon?: unknown;
+}): void;
+/** 关一个标签，回"下一个该去哪"的路径（关掉的不是当前那个就回空串）。 */
+export declare function closeTab(path: string): string;
+/** 标签那一栏要读的东西。 */
+export declare function useTabs(): {
+    tabs: import("vue").ComputedRef<TabItem[]>;
+    active: import("vue").ComputedRef<string>;
+    openTab: typeof openTab;
+    closeTab: typeof closeTab;
+};

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

@@ -0,0 +1,20 @@
+/** 侧栏菜单的形状。
+ *
+ * 🔴 **只有两级**（与老项目一致）：
+ *    · 一级 = **分组**：只负责展开 / 收起，**本身不是页面、点它不跳转、也不开标签**；
+ *    · 二级 = **页面**：点它才跳转并**开一个标签**。
+ *    所以下面 `children` 里的每一项都必须有 `path`（一级那个 `path` 只是这一组的标识，页面用不到它）。
+ *
+ * ⚠️ 想从路由表现算这份名单也行（老项目的 `pages.lock.ts` 就是那么做的：按 `meta.group` 分组、
+ *    二级取 `meta.title` / `meta.sub`），但**那是使用者的事** —— 库只认这张表。
+ */
+export interface SideItem {
+    /** 一级分组的标识（**不跳转**，只用来认这一组）。 */
+    path: string;
+    /** 分组名（一级）。 */
+    title: string;
+    /** 分组图标（PrimeIcons 类名，例如 `pi pi-home`）。 */
+    icon?: string;
+    /** 这一组下面的页面（二级）—— 点它才跳转并开标签。 */
+    children?: SideItem[];
+}

package/dist/types/ui.d.ts

@@ -0,0 +1 @@
+export * from './ui-real';

package/dist/ui.d.ts

@@ -0,0 +1 @@
+export * from './types/ui'

package/dist/ui.js

@@ -0,0 +1,15 @@
+import { A as e, P as l, a as r, b, T as o, U as u, c as T, i as c, l as p, o as t, r as A, u as d } from "./chunk-index-_jasBCim.js";
+export {
+  e as AppSearch,
+  l as ProductShell,
+  r as ProductSide,
+  b as ProductTabs,
+  o as TABS_MAX,
+  u as UserMenu,
+  T as closeTab,
+  c as installApp,
+  p as labull,
+  t as openTab,
+  A as registerTabLabel,
+  d as useTabs
+};