@lumal/core 0.0.1-beta → 0.0.3-beta

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# @lumal/core
+
+## 0.0.3-beta (2026-10-16)
+
+### Minor Changes
+
+- 新增 `@lumal/core/minimal`，不引用默认 UI 注册表，按需接入组件与插件，字典默认关闭。
+- 请求缓存增加身份与租户隔离、显式作用域及 `clearCache()`；默认仅缓存 GET，非 GET 需要显式 key。
+- `LumalRouterView` 增加 `cacheKeys`，打通标签关闭和按标签刷新；缓存默认最多 20 项，并遵守 `meta.keepAlive=false`。
+
+### Patch Changes
+
+- 修复字典删除、清空和手动赋值后的旧请求回填、错误与 loading 竞态。
+- 路由进度和 loading 改为反映真实导航状态；修复 Esc 退出最大化及新窗口 history/base 地址。
+- 标签快照先恢复后持久化、恢复时限量，卸载不再写回已清理快照。
+- 全局搜索补齐弹窗焦点约束与恢复，内存 Storage 兜底收敛为共享工具。
+
+## 0.0.2-beta (2026-08-01)
+
+### Minor Changes
+
+- Add the unified static and remote menu route runtime, navigation discovery components, permission access control, and persisted navigation and font-size preferences. Nested route guards enforce ancestor permissions and roles, and generated admin projects now use the same menu runtime.
+- Expose live selected rows, selected row keys, and a shared clear-selection action through the CRUD table toolbar actions slot.
+
+### Patch Changes
+
+- 让 mixed-nav 顶级目录默认只切换侧栏分组，并提供可配置的子菜单自动激活；同时保留后端菜单重定向，避免首个子项为外链时误跳转和菜单高亮错位。
+- 修复应用插件安装顺序和脚手架发布后的依赖版本同步，并统一多包版本发布策略。
+- 优化后台布局的面包屑落点、侧栏退场动画和普通路由页面自然高度，避免宽屏页面内容被强制拉伸。

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Lumal contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Lumal contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,16 +1,25 @@
-# @lumal/core
-
-Lumal 后台核心包，提供应用安装器、布局、路由菜单辅助、权限、请求、主题和基础组件。
-
-```ts
-import { createLumalAdmin } from '@lumal/core'
-import { LumalCrudTable, LumalSchemaForm } from '@lumal/core/components'
-import '@lumal/core/theme-chalk/index.scss'
-import '@lumal/core/style.css'
-```
-
+# @lumal/core
+
+Lumal 后台核心包，提供应用安装器、布局、路由菜单辅助、权限、请求、主题和基础组件。
+
+```ts
+import { createLumalAdmin } from '@lumal/core'
+import { LumalCrudTable, LumalSchemaForm } from '@lumal/core/components'
+import '@lumal/core/theme-chalk/index.scss'
+import '@lumal/core/style.css'
+```
+
 `createLumalAdmin` 支持 preset、异步 mount、应用侧 `router` / `pinia`、权限 Store 自动注入、Element Plus options 和选择性全局组件注册；这些依赖保持为 peer dependency，不会由 core 默认创建。
 
+纯服务或需要严格按需加载时，使用无默认 UI 注册表的轻入口：
+
+```ts
+import { createLumalAdmin } from '@lumal/core/minimal'
+await createLumalAdmin({ rootComponent: App }).mount('#app')
+```
+
+轻入口默认不安装字典，只接受显式 `components: { MyComponent }` 映射，不静态加载 Element Plus 或 Sortable。根入口的 `preset: 'minimal'` 只关闭默认注册，不是体积隔离边界。`@lumal/core/request` 等纯服务子入口也无需安装 Element Plus；UI 子入口仍需安装对应 peer 和样式。
+
 路由子入口提供 `createMenuRouteRuntime`，统一静态与远程菜单的校验、排序、组件解析和原子注册。布局子入口提供面包屑、全局搜索、菜单徽标与 `activeMenu` 高亮；主题偏好支持持久化动态标题、导航开关和 12-20px 全局字号。
-
-详细说明见仓库文档 `docs/core-api.md`。
+
+详细说明见仓库文档 `docs/core-api.md`。

package/dist/auth.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e,t={}){let n=t.parseResponse?t.parseResponse(e):e;if(!n||typeof n!=`object`||Array.isArray(n))throw TypeError(`会话响应格式不正确`);let r=n,i=r[t.fieldNames?.accessToken??`accessToken`],a=r[t.fieldNames?.refreshToken??`refreshToken`],o=r[t.fieldNames?.expiresAt??`expiresAt`],s=o==null?void 0:Number(o);if(typeof i!=`string`||!i)throw TypeError(`会话响应缺少有效的 accessToken`);let c={accessToken:i,...typeof a==`string`&&a?{refreshToken:a}:{},...s!==void 0&&Number.isFinite(s)?{expiresAt:s}:{}};return t.transform?t.transform(c):c}function t(e,t={}){let n=t.loginPath??`/login`,r=t.redirectQueryKey??`redirect`,i=e.trim();if(!i||i===n)return n;let a=new URL(n,`http://lumal.local`);return a.searchParams.set(r,i),`${a.pathname}${a.search}`}function n(e,t){return{getToken:()=>e.getItem(t)??``,setToken:n=>{if(!n){e.removeItem(t);return}e.setItem(t,n)},clearToken:()=>{e.removeItem(t)}}}function r(){let e=new Map;return{get length(){return e.size},clear:()=>e.clear(),getItem:t=>e.has(t)?e.get(t):null,key:t=>Array.from(e.keys())[t]??null,removeItem:t=>{e.delete(t)},setItem:(t,n)=>{e.set(t,n)}}}function i(e){return e||(typeof localStorage<`u`?localStorage:r())}function a(e={}){let r=e.tokenKey??`lumal:token`,a=i(e.storage),o=n(a,r),s=n(a,e.refreshTokenKey??`${r}:refresh`),c=e.expiresAtKey??`${r}:expires-at`;function l(){o.clearToken(),s.clearToken(),a.removeItem(c)}function u(){let e=o.getToken();if(!e)return null;let t=s.getToken(),n=a.getItem(c),r=n===null?void 0:Number(n);return{accessToken:e,...t?{refreshToken:t}:{},...r!==void 0&&Number.isFinite(r)?{expiresAt:r}:{}}}function d(e){if(!e.accessToken){l();return}o.setToken(e.accessToken),s.setToken(e.refreshToken??``),e.expiresAt===void 0?a.removeItem(c):a.setItem(c,String(e.expiresAt))}function f(e){l(),o.setToken(e)}async function p(){l(),await e.onSessionExpired?.()}return{getToken:()=>o.getToken(),getRefreshToken:()=>s.getToken(),getSession:u,setToken:f,setSession:d,clearToken:l,isAuthenticated:()=>!!o.getToken(),handleSessionExpired:p,logout:p,resolveRedirect:(n,r)=>t(n,r??e.redirect)}}var o=`lumal:token`;function s(e,t=o){return n(e,t).getToken()}function c(e,t,r=o){n(e,r).setToken(t)}function l(e,t=o){n(e,t).clearToken()}var u=null;function d(e){u=e}function f(){u=null}async function p(){await u?.()}exports.DEFAULT_TOKEN_STORAGE_KEY=o,exports.clearSessionExpiredHandler=f,exports.clearStoredToken=l,exports.createAuthSession=a,exports.createTokenStorage=n,exports.getStoredToken=s,exports.handleSessionExpired=p,exports.parseAuthSession=e,exports.registerSessionExpiredHandler=d,exports.resolveLoginRedirect=t,exports.setStoredToken=c;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./storage-CCBa7Qh8.cjs");function t(e,t={}){let n=t.parseResponse?t.parseResponse(e):e;if(!n||typeof n!=`object`||Array.isArray(n))throw TypeError(`会话响应格式不正确`);let r=n,i=r[t.fieldNames?.accessToken??`accessToken`],a=r[t.fieldNames?.refreshToken??`refreshToken`],o=r[t.fieldNames?.expiresAt??`expiresAt`],s=o==null?void 0:Number(o);if(typeof i!=`string`||!i)throw TypeError(`会话响应缺少有效的 accessToken`);let c={accessToken:i,...typeof a==`string`&&a?{refreshToken:a}:{},...s!==void 0&&Number.isFinite(s)?{expiresAt:s}:{}};return t.transform?t.transform(c):c}function n(e,t={}){let n=t.loginPath??`/login`,r=t.redirectQueryKey??`redirect`,i=e.trim();if(!i||i===n)return n;let a=new URL(n,`http://lumal.local`);return a.searchParams.set(r,i),`${a.pathname}${a.search}`}function r(e,t){return{getToken:()=>e.getItem(t)??``,setToken:n=>{if(!n){e.removeItem(t);return}e.setItem(t,n)},clearToken:()=>{e.removeItem(t)}}}function i(t){return t||(typeof localStorage<`u`?localStorage:e.t())}function a(e={}){let t=e.tokenKey??`lumal:token`,a=i(e.storage),o=r(a,t),s=r(a,e.refreshTokenKey??`${t}:refresh`),c=e.expiresAtKey??`${t}:expires-at`;function l(){o.clearToken(),s.clearToken(),a.removeItem(c)}function u(){let e=o.getToken();if(!e)return null;let t=s.getToken(),n=a.getItem(c),r=n===null?void 0:Number(n);return{accessToken:e,...t?{refreshToken:t}:{},...r!==void 0&&Number.isFinite(r)?{expiresAt:r}:{}}}function d(e){if(!e.accessToken){l();return}o.setToken(e.accessToken),s.setToken(e.refreshToken??``),e.expiresAt===void 0?a.removeItem(c):a.setItem(c,String(e.expiresAt))}function f(e){l(),o.setToken(e)}async function p(){l(),await e.onSessionExpired?.()}return{getToken:()=>o.getToken(),getRefreshToken:()=>s.getToken(),getSession:u,setToken:f,setSession:d,clearToken:l,isAuthenticated:()=>!!o.getToken(),handleSessionExpired:p,logout:p,resolveRedirect:(t,r)=>n(t,r??e.redirect)}}var o=`lumal:token`;function s(e,t=o){return r(e,t).getToken()}function c(e,t,n=o){r(e,n).setToken(t)}function l(e,t=o){r(e,t).clearToken()}var u=null;function d(e){u=e}function f(){u=null}async function p(){await u?.()}exports.DEFAULT_TOKEN_STORAGE_KEY=o,exports.clearSessionExpiredHandler=f,exports.clearStoredToken=l,exports.createAuthSession=a,exports.createTokenStorage=r,exports.getStoredToken=s,exports.handleSessionExpired=p,exports.parseAuthSession=t,exports.registerSessionExpiredHandler=d,exports.resolveLoginRedirect=n,exports.setStoredToken=c;

package/dist/auth.js

@@ -1,5 +1,6 @@
+import { t as e } from "./storage-CorgkMJU.js";
 //#region src/auth/adapter.ts
-function e(e, t = {}) {
+function t(e, t = {}) {
 	let n = t.parseResponse ? t.parseResponse(e) : e;
 	if (!n || typeof n != "object" || Array.isArray(n)) throw TypeError("会话响应格式不正确");
 	let r = n, i = r[t.fieldNames?.accessToken ?? "accessToken"], a = r[t.fieldNames?.refreshToken ?? "refreshToken"], o = r[t.fieldNames?.expiresAt ?? "expiresAt"], s = o == null ? void 0 : Number(o);
@@ -13,7 +14,7 @@ function e(e, t = {}) {
 }
 //#endregion
 //#region src/auth/redirect.ts
-function t(e, t = {}) {
+function n(e, t = {}) {
 	let n = t.loginPath ?? "/login", r = t.redirectQueryKey ?? "redirect", i = e.trim();
 	if (!i || i === n) return n;
 	let a = new URL(n, "http://lumal.local");
@@ -21,7 +22,7 @@ function t(e, t = {}) {
 }
 //#endregion
 //#region src/auth/storage.ts
-function n(e, t) {
+function r(e, t) {
 	return {
 		getToken: () => e.getItem(t) ?? "",
 		setToken: (n) => {
@@ -38,28 +39,11 @@ function n(e, t) {
 }
 //#endregion
 //#region src/auth/createAuthSession.ts
-function r() {
-	let e = /* @__PURE__ */ new Map();
-	return {
-		get length() {
-			return e.size;
-		},
-		clear: () => e.clear(),
-		getItem: (t) => e.has(t) ? e.get(t) : null,
-		key: (t) => Array.from(e.keys())[t] ?? null,
-		removeItem: (t) => {
-			e.delete(t);
-		},
-		setItem: (t, n) => {
-			e.set(t, n);
-		}
-	};
-}
-function i(e) {
-	return e || (typeof localStorage < "u" ? localStorage : r());
+function i(t) {
+	return t || (typeof localStorage < "u" ? localStorage : e());
 }
 function a(e = {}) {
-	let r = e.tokenKey ?? "lumal:token", a = i(e.storage), o = n(a, r), s = n(a, e.refreshTokenKey ?? `${r}:refresh`), c = e.expiresAtKey ?? `${r}:expires-at`;
+	let t = e.tokenKey ?? "lumal:token", a = i(e.storage), o = r(a, t), s = r(a, e.refreshTokenKey ?? `${t}:refresh`), c = e.expiresAtKey ?? `${t}:expires-at`;
 	function l() {
 		o.clearToken(), s.clearToken(), a.removeItem(c);
 	}
@@ -96,20 +80,20 @@ function a(e = {}) {
 		isAuthenticated: () => !!o.getToken(),
 		handleSessionExpired: p,
 		logout: p,
-		resolveRedirect: (n, r) => t(n, r ?? e.redirect)
+		resolveRedirect: (t, r) => n(t, r ?? e.redirect)
 	};
 }
 //#endregion
 //#region src/auth/session.ts
 var o = "lumal:token";
 function s(e, t = o) {
-	return n(e, t).getToken();
+	return r(e, t).getToken();
 }
-function c(e, t, r = o) {
-	n(e, r).setToken(t);
+function c(e, t, n = o) {
+	r(e, n).setToken(t);
 }
 function l(e, t = o) {
-	n(e, t).clearToken();
+	r(e, t).clearToken();
 }
 //#endregion
 //#region src/auth/session-expired.ts
@@ -124,4 +108,4 @@ async function p() {
 	await u?.();
 }
 //#endregion
-export { o as DEFAULT_TOKEN_STORAGE_KEY, f as clearSessionExpiredHandler, l as clearStoredToken, a as createAuthSession, n as createTokenStorage, s as getStoredToken, p as handleSessionExpired, e as parseAuthSession, d as registerSessionExpiredHandler, t as resolveLoginRedirect, c as setStoredToken };
+export { o as DEFAULT_TOKEN_STORAGE_KEY, f as clearSessionExpiredHandler, l as clearStoredToken, a as createAuthSession, r as createTokenStorage, s as getStoredToken, p as handleSessionExpired, t as parseAuthSession, d as registerSessionExpiredHandler, n as resolveLoginRedirect, c as setStoredToken };