@lumal/core 0.0.1-beta

package/dist/src/permission/directive.d.ts

@@ -0,0 +1,3 @@
+import type { PermissionDirective, PermissionDirectiveOptions, PermissionStore } from './types';
+export declare function createPermissionDirective(store: PermissionStore, options?: PermissionDirectiveOptions): PermissionDirective;
+//# sourceMappingURL=directive.d.ts.map

package/dist/src/permission/directive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive.d.ts","sourceRoot":"","sources":["../../../src/permission/directive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,0BAA0B,EAAyB,eAAe,EAAE,MAAM,SAAS,CAAA;AAYtH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CASrB"}

package/dist/src/permission/guard.d.ts

@@ -0,0 +1,4 @@
+import type { PermissionGuardOptions, PermissionRouterLike, PermissionStore } from './types';
+/***********************路由守卫*********************/
+export declare function setupPermissionGuard(router: PermissionRouterLike, store: PermissionStore, options?: PermissionGuardOptions): void;
+//# sourceMappingURL=guard.d.ts.map

package/dist/src/permission/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../src/permission/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EAGtB,oBAAoB,EACpB,eAAe,EAChB,MAAM,SAAS,CAAA;AAmDhB,kDAAkD;AAClD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,sBAA2B,GACnC,IAAI,CAyBN"}

package/dist/src/permission/helpers.d.ts

@@ -0,0 +1,4 @@
+import type { PermissionCheckMode, PermissionRequirement } from './types';
+export declare function hasPermission(permissions: string[], required?: PermissionRequirement, mode?: PermissionCheckMode): boolean;
+export declare function hasRole(roles: string[], required?: PermissionRequirement, mode?: PermissionCheckMode): boolean;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/src/permission/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/permission/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AA8BzE,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EAAE,EACrB,QAAQ,CAAC,EAAE,qBAAqB,EAChC,IAAI,GAAE,mBAA4B,GACjC,OAAO,CAET;AAED,wBAAgB,OAAO,CACrB,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,CAAC,EAAE,qBAAqB,EAChC,IAAI,GAAE,mBAA4B,GACjC,OAAO,CAET"}

package/dist/src/permission/index.d.ts

@@ -0,0 +1,8 @@
+export { permissionStoreKey, providePermissionStore, usePermissionStore, } from './context';
+export { createPermissionDirective, } from './directive';
+export { setupPermissionGuard, } from './guard';
+export { hasPermission, hasRole, } from './helpers';
+export { default as LumalAccessControl } from './LumalAccessControl.vue';
+export { createPermissionStore, } from './store';
+export type { PermissionCheckMode, PermissionDirective, PermissionDirectiveOptions, PermissionGuardOptions, PermissionGuardResult, PermissionRequirement, PermissionRouteLike, PermissionRouteMeta, PermissionRouterLike, PermissionStore, PermissionStoreOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/permission/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/permission/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,yBAAyB,GAC1B,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,oBAAoB,GACrB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,aAAa,EACb,OAAO,GACR,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AACxE,OAAO,EACL,qBAAqB,GACtB,MAAM,SAAS,CAAA;AAChB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,GACvB,MAAM,SAAS,CAAA"}

package/dist/src/permission/store.d.ts

@@ -0,0 +1,4 @@
+import type { PermissionStore, PermissionStoreOptions } from './types';
+/***********************权限状态*********************/
+export declare function createPermissionStore(options?: PermissionStoreOptions): PermissionStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/src/permission/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/permission/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA8C,eAAe,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAIlH,kDAAkD;AAClD,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CA4B3F"}

package/dist/src/permission/types.d.ts

@@ -0,0 +1,67 @@
+import type { Directive } from 'vue';
+export type PermissionRequirement = string | string[] | null | undefined;
+export type PermissionCheckMode = 'every' | 'some';
+export interface PermissionStoreOptions {
+    permissions?: string[];
+    roles?: string[];
+}
+export interface PermissionStore {
+    readonly permissions: string[];
+    readonly roles: string[];
+    clear: () => void;
+    hasPermission: (required?: PermissionRequirement, mode?: PermissionCheckMode) => boolean;
+    hasRole: (required?: PermissionRequirement, mode?: PermissionCheckMode) => boolean;
+    setPermissions: (permissions: string[]) => void;
+    setRoles: (roles: string[]) => void;
+}
+export interface PermissionDirectiveOptions {
+    mode?: PermissionCheckMode;
+}
+export type PermissionDirective = Directive<HTMLElement, PermissionRequirement>;
+export interface PermissionRouteMeta {
+    permission?: PermissionRequirement;
+    permissions?: PermissionRequirement;
+    role?: PermissionRequirement;
+    roles?: PermissionRequirement;
+    requireLogin?: boolean;
+    [key: string]: unknown;
+}
+export interface PermissionRouteLike {
+    meta?: PermissionRouteMeta;
+    matched?: readonly {
+        meta?: PermissionRouteMeta;
+    }[];
+    path?: string;
+    fullPath?: string;
+    name?: string | symbol | null;
+}
+/**
+ * 守卫返回：true 放行，字符串或位置对象为跳转目标，false 拦截。
+ */
+export type PermissionGuardResult = boolean | string | {
+    path: string;
+    query?: Record<string, string>;
+    replace?: boolean;
+};
+export interface PermissionRouterLike {
+    beforeEach: (guard: (to: PermissionRouteLike) => PermissionGuardResult | Promise<PermissionGuardResult>) => unknown;
+}
+export interface PermissionGuardOptions {
+    /** 权限匹配模式，默认 some。 */
+    mode?: PermissionCheckMode;
+    /** 角色匹配模式，默认 some。 */
+    roleMode?: PermissionCheckMode;
+    /** 无权限时的跳转目标。 */
+    noAccessRedirect?: string;
+    /** 免登录白名单路径。 */
+    whiteList?: string[];
+    /** 登录页路径，默认 `/login`；命中时始终放行。 */
+    loginPath?: string;
+    /** 是否已登录；提供后开启登录守卫。 */
+    isAuthenticated?: () => boolean;
+    /** 未登录跳转登录页时携带的原始路径参数名，默认 `redirect`。 */
+    redirectQueryKey?: string;
+    /** 未显式声明 requireLogin 时是否默认需要登录，默认 false。 */
+    requireLoginByDefault?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/permission/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/permission/types.ts"],"names":[],"mappings":"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"}

package/dist/src/request/cache.d.ts

@@ -0,0 +1,8 @@
+import type { RequestCache } from './types';
+/***********************内存缓存*********************/
+/**
+ * 基于 Map 的内存请求缓存实现，作为开启缓存时的默认存储。
+ * 应用可实现同接口替换为带 TTL、LRU 或持久化的存储。
+ */
+export declare function createRequestCache(): RequestCache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/src/request/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/request/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,kDAAkD;AAClD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAgBjD"}

package/dist/src/request/client.d.ts

@@ -0,0 +1,4 @@
+import type { RequestClient, RequestClientOptions } from './types';
+/***********************客户端创建*********************/
+export declare function createRequestClient(clientOptions?: RequestClientOptions): RequestClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/request/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/request/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,oBAAoB,EAMrB,MAAM,SAAS,CAAA;AA+JhB,mDAAmD;AACnD,wBAAgB,mBAAmB,CAAC,aAAa,GAAE,oBAAyB,GAAG,aAAa,CAmP3F"}

package/dist/src/request/error.d.ts

@@ -0,0 +1,19 @@
+export type RequestErrorKind = 'business' | 'cancelled' | 'duplicate' | 'http' | 'network' | 'session';
+export interface RequestErrorOptions {
+    code?: number | string;
+    kind?: RequestErrorKind;
+    data?: unknown;
+    originalError?: unknown;
+    response?: Response;
+    status?: number;
+}
+export declare class RequestError extends Error {
+    code?: number | string;
+    data?: unknown;
+    kind: RequestErrorKind;
+    originalError?: unknown;
+    response?: Response;
+    status?: number;
+    constructor(message: string, options?: RequestErrorOptions);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/src/request/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/request/error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACtB,UAAU,GACV,WAAW,GACX,WAAW,GACX,MAAM,GACN,SAAS,GACT,SAAS,CAAA;AAEf,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,gBAAgB,CAAA;IACtB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEH,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB;CAU/D"}

package/dist/src/request/index.d.ts

@@ -0,0 +1,8 @@
+export { createRequestCache, } from './cache';
+export { createRequestClient, } from './client';
+export { RequestError, } from './error';
+export type { RequestErrorKind, RequestErrorOptions, } from './error';
+export { createStandardResponseParser, parsePageResult, parseStandardResponse, } from './standard';
+export type { ApiEnvelope, PageResult, PageResultFieldNames, ParsePageResultOptions, ParseStandardResponseOptions, StandardResponse, StandardResponseFieldNames, } from './standard';
+export type { RequestAuthRefreshOptions, RequestBeforeContext, RequestCache, RequestCacheOptions, RequestClient, RequestClientOptions, RequestContext, RequestErrorContext, RequestMethod, RequestOptions, RequestQuery, RequestQueryValue, RequestUploadOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/request/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/request/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GACnB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,mBAAmB,GACpB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,YAAY,GACb,MAAM,SAAS,CAAA;AAChB,YAAY,EACV,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,4BAA4B,EAC5B,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,WAAW,EACX,UAAU,EACV,oBAAoB,EACpB,sBAAsB,EACtB,4BAA4B,EAC5B,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,yBAAyB,EACzB,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,SAAS,CAAA"}

package/dist/src/request/standard.d.ts

@@ -0,0 +1,61 @@
+/***********************标准响应解析*********************/
+/**
+ * 常见后端统一响应包装（可通过 fieldNames 适配非标准字段）。
+ */
+export interface ApiEnvelope<TData = unknown> {
+    code?: unknown;
+    data?: TData;
+    message?: unknown;
+    [key: string]: unknown;
+}
+export type StandardResponse<TData = unknown> = ApiEnvelope<TData>;
+export interface StandardResponseFieldNames {
+    /** 业务状态码字段名，默认 `code`。 */
+    code?: string;
+    /** 业务数据字段名，默认 `data`。 */
+    data?: string;
+    /** 提示消息字段名，默认 `message`。 */
+    message?: string;
+}
+export interface ParseStandardResponseOptions<TData = unknown, TResult = TData> {
+    /** 非标准字段映射。 */
+    fieldNames?: StandardResponseFieldNames;
+    /** 判定成功的状态码集合，默认 `[0, 200]`。 */
+    successCodes?: unknown[];
+    /** 解析失败时抛出的错误工厂，默认抛出 Error(message)。 */
+    onError?: (message: string, response: StandardResponse) => never;
+    /** 会话失效业务码；命中时抛出 kind=session 的 RequestError。 */
+    sessionExpiredCodes?: unknown[];
+    /** 对取出的业务数据做最终类型归一。 */
+    transform?: (data: TData, response: StandardResponse<TData>) => TResult;
+}
+/**
+ * 从标准响应包装中取出业务数据，状态码不在成功集合时抛错。
+ * 该 helper 需显式启用，未启用时 request client 返回原始响应数据，
+ * 以便适配非标准后端。
+ */
+export declare function parseStandardResponse<TData = unknown, TResult = TData>(response: StandardResponse<TData>, options?: ParseStandardResponseOptions<TData, TResult>): TResult;
+/**
+ * 生成可直接用作 onResponse 的标准响应解析器。
+ */
+export declare function createStandardResponseParser<TData = unknown, TResult = TData>(options?: ParseStandardResponseOptions<TData, TResult>): <TValue = TResult>(context: {
+    data: unknown;
+}) => TValue;
+/***********************标准分页解析*********************/
+export interface PageResult<TItem = unknown> {
+    items: TItem[];
+    total: number;
+}
+export interface PageResultFieldNames {
+    items?: string;
+    total?: string;
+}
+export interface ParsePageResultOptions<TItem = unknown> {
+    fieldNames?: PageResultFieldNames;
+    /** 处理多层嵌套或异常列表位置。 */
+    parseResponse?: (response: unknown) => unknown;
+    /** 逐项修正数字字符串、布尔字符串等类型漂移。 */
+    transform?: (item: unknown, index: number) => TItem;
+}
+export declare function parsePageResult<TItem = unknown>(response: unknown, options?: ParsePageResultOptions<TItem>): PageResult<TItem>;
+//# sourceMappingURL=standard.d.ts.map

package/dist/src/request/standard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard.d.ts","sourceRoot":"","sources":["../../../src/request/standard.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,KAAK,GAAG,OAAO;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,KAAK,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC,CAAA;AAElE,MAAM,WAAW,0BAA0B;IACzC,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,4BAA4B,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,KAAK;IAC5E,eAAe;IACf,UAAU,CAAC,EAAE,0BAA0B,CAAA;IACvC,gCAAgC;IAChC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAA;IACxB,wCAAwC;IACxC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,KAAK,KAAK,CAAA;IAChE,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,OAAO,EAAE,CAAA;IAC/B,uBAAuB;IACvB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,OAAO,CAAA;CACxE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,KAAK,EACpE,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,EACjC,OAAO,GAAE,4BAA4B,CAAC,KAAK,EAAE,OAAO,CAAM,GACzD,OAAO,CA8BT;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,KAAK,EAC3E,OAAO,GAAE,4BAA4B,CAAC,KAAK,EAAE,OAAO,CAAM,IAElD,MAAM,GAAG,OAAO,EAAE,SAAS;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,KAAG,MAAM,CAE9D;AAED,oDAAoD;AACpD,MAAM,WAAW,UAAU,CAAC,KAAK,GAAG,OAAO;IACzC,KAAK,EAAE,KAAK,EAAE,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,sBAAsB,CAAC,KAAK,GAAG,OAAO;IACrD,UAAU,CAAC,EAAE,oBAAoB,CAAA;IACjC,qBAAqB;IACrB,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAA;IAC9C,4BAA4B;IAC5B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAA;CACpD;AAED,wBAAgB,eAAe,CAAC,KAAK,GAAG,OAAO,EAC7C,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE,sBAAsB,CAAC,KAAK,CAAM,GAC1C,UAAU,CAAC,KAAK,CAAC,CAoBnB"}

package/dist/src/request/types.d.ts

@@ -0,0 +1,102 @@
+export type RequestMethod = 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';
+export type RequestQueryValue = boolean | number | string | null | undefined;
+export type RequestQuery = Record<string, RequestQueryValue | RequestQueryValue[]>;
+/***********************请求上下文*********************/
+export interface RequestContext<TData = unknown> {
+    /** 当前发送次数，首次为 0，认证刷新后的重放为 1。 */
+    attempt: number;
+    data: TData;
+    init: RequestInit;
+    response: Response;
+    url: string;
+    /** 本次请求的唯一标识，用于日志追踪与缓存 key。 */
+    requestId?: string;
+}
+/**
+ * 请求发起前的上下文：可在此改写 url、init 或读取 requestId。
+ */
+export interface RequestBeforeContext {
+    url: string;
+    init: RequestInit;
+    requestId?: string;
+}
+/**
+ * 请求错误上下文：网络错误或响应非 2xx 时携带。
+ */
+export interface RequestErrorContext {
+    error: unknown;
+    url: string;
+    init: RequestInit;
+    requestId?: string;
+    response?: Response;
+}
+/***********************缓存*********************/
+export interface RequestCache {
+    get: (key: string) => unknown;
+    set: (key: string, value: unknown) => void;
+    has: (key: string) => boolean;
+    delete: (key: string) => void;
+    clear: () => void;
+}
+export interface RequestCacheOptions {
+    /** 缓存存储，默认内存 Map 实现。 */
+    cache?: RequestCache;
+    /** 是否对该请求启用缓存，默认仅 GET 且显式开启。 */
+    enabled?: boolean;
+    /** 自定义缓存 key，默认 `method:url`。 */
+    key?: string;
+}
+/***********************客户端选项*********************/
+export interface RequestClientOptions<TData = unknown> {
+    /** 认证刷新配置；仅会对允许重放的请求执行一次。 */
+    authRefresh?: RequestAuthRefreshOptions<TData>;
+    baseURL?: string;
+    duplicateSubmit?: boolean;
+    fetch?: typeof fetch;
+    getToken?: () => Promise<string | undefined> | string | undefined;
+    tokenPrefix?: string;
+    /** 是否为每个请求生成 requestId，或传入自定义生成函数。 */
+    requestId?: boolean | (() => string);
+    /** 请求头中携带 requestId 的字段名，默认 `X-Request-Id`。 */
+    requestIdHeader?: string;
+    /** 默认缓存存储，供开启缓存的请求复用。 */
+    cache?: RequestCache;
+    onRequest?: (context: RequestBeforeContext) => Promise<void> | void;
+    onRequestError?: (context: RequestErrorContext) => Promise<void> | void;
+    onResponse?: <TResult = unknown>(context: RequestContext<TData>) => Promise<TResult> | TResult;
+    onResponseError?: (context: RequestErrorContext) => Promise<void> | void;
+    onSessionExpired?: (context: RequestContext<TData>) => Promise<void> | void;
+}
+/***********************请求选项*********************/
+export interface RequestOptions {
+    body?: BodyInit | Record<string, unknown> | unknown[] | null;
+    headers?: HeadersInit;
+    method?: RequestMethod;
+    query?: RequestQuery;
+    /** 写请求是否允许在认证刷新成功后重放，默认 false；GET 默认允许。 */
+    retryOnAuthRefresh?: boolean;
+    signal?: AbortSignal;
+    /** 逐请求缓存配置。 */
+    cache?: RequestCacheOptions;
+}
+export interface RequestAuthRefreshOptions<TData = unknown> {
+    /** 刷新访问凭据。并发过期请求共享同一个 Promise。 */
+    refresh: (context: RequestContext<TData>) => Promise<void>;
+}
+export interface RequestUploadOptions extends Omit<RequestOptions, 'body' | 'method'> {
+    /** 除文件外的附加字段。 */
+    data?: Record<string, RequestQueryValue>;
+    /** 文件字段名，默认 `file`。 */
+    fileField?: string;
+}
+export interface RequestClient {
+    delete: <TResult = unknown>(url: string, options?: Omit<RequestOptions, 'method'>) => Promise<TResult>;
+    get: <TResult = unknown>(url: string, options?: Omit<RequestOptions, 'body' | 'method'>) => Promise<TResult>;
+    patch: <TResult = unknown>(url: string, options?: Omit<RequestOptions, 'method'>) => Promise<TResult>;
+    post: <TResult = unknown>(url: string, options?: Omit<RequestOptions, 'method'>) => Promise<TResult>;
+    put: <TResult = unknown>(url: string, options?: Omit<RequestOptions, 'method'>) => Promise<TResult>;
+    request: <TResult = unknown>(url: string, options?: RequestOptions) => Promise<TResult>;
+    /** 上传文件（multipart/form-data），单文件或多文件。 */
+    upload: <TResult = unknown>(url: string, file: Blob | Blob[], options?: RequestUploadOptions) => Promise<TResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/request/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/request/types.ts"],"names":[],"mappings":"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"}

package/dist/src/router/index.d.ts

@@ -0,0 +1,36 @@
+import type { CreateMenuRouteRuntimeOptions, CreateRouteRecordsOptions, CreateSidebarMenusOptions, CreateTopMenusOptions, FindAccessibleMenuOptions, GlobComponentResolverOptions, LumalMenuInputRecord, LumalRouteRecord, MenuNode, MenuRouteConflictKind, MenuRouteConflictSource, MenuRouteRuntime, NormalizedMenuNode, NormalizeMenuRecordsOptions, RouteComponentResolver, RouteRegistry, RouteRegistryRouterLike, SidebarMenuItem } from './types';
+export type { CreateMenuRouteRuntimeOptions, CreateRouteRecordsOptions, CreateSidebarMenusOptions, CreateTopMenusOptions, FindAccessibleMenuOptions, GlobComponentResolverOptions, LumalMenuBadgeTone, LumalMenuBadgeType, LumalMenuComponent, LumalMenuInputRecord, LumalMenuRecord, LumalRouteAuthority, LumalRouteMeta, LumalRouteRecord, LumalStaticMenuRecord, MenuNode, MenuNodeId, MenuRecordFieldNames, MenuRouteComponent, MenuRouteConflictKind, MenuRouteConflictSource, MenuRouteErrorContext, MenuRouteRuntime, MenuRouteRuntimeRouterLike, MenuRouteSource, NormalizedMenuNode, NormalizeMenuRecordsOptions, RouteComponentResolver, RouteRegistry, RouteRegistryRouterLike, SidebarMenuItem, } from './types';
+/***********************标准字段归一化*********************/
+export declare function normalizeMenuRecords(records: LumalMenuInputRecord[], options?: NormalizeMenuRecordsOptions): NormalizedMenuNode[];
+/***********************菜单归一化*********************/
+export declare function normalizeMenuNodes(nodes: MenuNode[]): NormalizedMenuNode[];
+/***********************路由记录*********************/
+export declare function createRouteRecords(nodes: NormalizedMenuNode[], options?: CreateRouteRecordsOptions): LumalRouteRecord[];
+/***********************侧边栏菜单*********************/
+export declare function createSidebarMenus(nodes: NormalizedMenuNode[], options?: CreateSidebarMenusOptions): SidebarMenuItem[];
+/***********************顶部菜单*********************/
+/**
+ * 顶部菜单：在可访问过滤的基础上，仅保留一级菜单中标记 meta.topMenu === true 的项。
+ * 未标记任何顶部菜单时回退为全部可访问的一级菜单，便于 top-nav 布局直接使用。
+ */
+export declare function createTopMenus(nodes: NormalizedMenuNode[], options?: CreateTopMenusOptions): SidebarMenuItem[];
+/***********************访问菜单查找*********************/
+export declare function findFirstAccessibleMenu(nodes: NormalizedMenuNode[], options?: FindAccessibleMenuOptions): NormalizedMenuNode | undefined;
+/***********************动态路由注册*********************/
+export declare function createRouteRegistry(router: RouteRegistryRouterLike): RouteRegistry;
+/***********************glob 组件解析*********************/
+/**
+ * 基于 import.meta.glob 收集的模块表，创建组件字符串到懒加载组件的解析函数。
+ * 依次尝试 `${viewsPrefix}/${component}.vue` 与 `${viewsPrefix}/${component}/index.vue`，
+ * 命中即缓存懒加载函数；全部未命中时回退到 fallback。
+ */
+export declare function createGlobComponentResolver(options: GlobComponentResolverOptions): RouteComponentResolver;
+export declare class MenuRouteConflictError extends Error {
+    readonly firstSource: MenuRouteConflictSource;
+    readonly kind: MenuRouteConflictKind;
+    readonly secondSource: MenuRouteConflictSource;
+    readonly value: string;
+    constructor(kind: MenuRouteConflictKind, value: string, firstSource: MenuRouteConflictSource, secondSource: MenuRouteConflictSource);
+}
+export declare function createMenuRouteRuntime(options: CreateMenuRouteRuntimeOptions): MenuRouteRuntime;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,EAG5B,oBAAoB,EAIpB,gBAAgB,EAChB,QAAQ,EAER,qBAAqB,EACrB,uBAAuB,EAEvB,gBAAgB,EAGhB,kBAAkB,EAClB,2BAA2B,EAC3B,sBAAsB,EACtB,aAAa,EACb,uBAAuB,EACvB,eAAe,EAChB,MAAM,SAAS,CAAA;AAEhB,YAAY,EACV,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,EAC5B,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,QAAQ,EACR,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,0BAA0B,EAC1B,eAAe,EACf,kBAAkB,EAClB,2BAA2B,EAC3B,sBAAsB,EACtB,aAAa,EACb,uBAAuB,EACvB,eAAe,GAChB,MAAM,SAAS,CAAA;AAWhB,qDAAqD;AACrD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,oBAAoB,EAAE,EAC/B,OAAO,GAAE,2BAAgC,GACxC,kBAAkB,EAAE,CAOtB;AA+HD,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,kBAAkB,EAAE,CAiB1E;AAmED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,kBAAkB,EAAE,EAC3B,OAAO,GAAE,yBAA8B,GACtC,gBAAgB,EAAE,CAEpB;AAkED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,kBAAkB,EAAE,EAC3B,OAAO,GAAE,yBAA8B,GACtC,eAAe,EAAE,CA2BnB;AAED,kDAAkD;AAClD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,kBAAkB,EAAE,EAC3B,OAAO,GAAE,qBAA0B,GAClC,eAAe,EAAE,CAUnB;AAED,oDAAoD;AACpD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,kBAAkB,EAAE,EAC3B,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,GAAG,SAAS,CAkBhC;AASD,oDAAoD;AACpD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,uBAAuB,GAAG,aAAa,CAkDlF;AAED,uDAAuD;AACvD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,sBAAsB,CA6BxB;AA6CD,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAA;IAC7C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAA;IACpC,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAA;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;gBAGpB,IAAI,EAAE,qBAAqB,EAC3B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,uBAAuB,EACpC,YAAY,EAAE,uBAAuB;CASxC;AA+VD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,gBAAgB,CAuL/F"}

package/dist/src/router/types.d.ts

@@ -0,0 +1,231 @@
+import type { Component } from 'vue';
+export type MenuNodeId = string;
+export type LumalRouteAuthority = string | string[];
+export type LumalMenuBadgeType = 'dot' | 'text';
+export type LumalMenuBadgeTone = 'primary' | 'success' | 'warning' | 'danger' | 'info';
+export interface LumalRouteMeta {
+    title?: string;
+    icon?: string;
+    order?: number;
+    hideInMenu?: boolean;
+    hideChildrenInMenu?: boolean;
+    activeMenu?: string;
+    keepAlive?: boolean;
+    affixTab?: boolean;
+    authority?: LumalRouteAuthority;
+    badge?: string | number;
+    badgeType?: LumalMenuBadgeType;
+    badgeTone?: LumalMenuBadgeTone;
+    hideInBreadcrumb?: boolean;
+    roles?: LumalRouteAuthority;
+    externalLink?: string;
+    externalTarget?: '_blank' | '_self';
+    topMenu?: boolean;
+    [key: string]: unknown;
+}
+export interface LumalMenuRecord {
+    path: string;
+    children?: LumalMenuRecord[];
+    component?: string;
+    meta?: LumalRouteMeta;
+    name?: string;
+    redirect?: string;
+    externalLink?: string;
+}
+export type LumalMenuComponent = Component | (() => Promise<unknown>);
+export type MenuRouteComponent = LumalMenuComponent;
+/**
+ * 静态菜单可以直接绑定 Vue 组件或懒加载器；字符串组件仍交给 componentResolver 解析。
+ */
+export interface LumalStaticMenuRecord extends Omit<LumalMenuRecord, 'children' | 'component'> {
+    children?: LumalStaticMenuRecord[];
+    component?: string | LumalMenuComponent;
+}
+/**
+ * 非标准菜单记录：字段名由后端决定，需要通过 fieldNames 显式映射到标准字段。
+ */
+export type LumalMenuInputRecord = LumalMenuRecord | Record<string, unknown>;
+/**
+ * 标准字段 -> 源字段名的映射，用于适配非标准后端菜单结构。
+ * 未配置的字段回退到标准字段位置（顶层或 meta）。
+ */
+export interface MenuRecordFieldNames {
+    activeMenu?: string;
+    badge?: string;
+    badgeType?: string;
+    badgeTone?: string;
+    path?: string;
+    name?: string;
+    component?: string;
+    redirect?: string;
+    children?: string;
+    title?: string;
+    icon?: string;
+    order?: string;
+    authority?: string;
+    roles?: string;
+    hideInMenu?: string;
+    hideInBreadcrumb?: string;
+    keepAlive?: string;
+    externalLink?: string;
+}
+export interface NormalizeMenuRecordsOptions {
+    fieldNames?: MenuRecordFieldNames;
+}
+export interface MenuNode {
+    activeMenu?: string;
+    badge?: string | number;
+    badgeType?: LumalMenuBadgeType;
+    badgeTone?: LumalMenuBadgeTone;
+    id: MenuNodeId;
+    path: string;
+    title: string;
+    children?: MenuNode[];
+    component?: string | LumalMenuComponent;
+    icon?: string;
+    keepAlive?: boolean;
+    meta?: Record<string, unknown>;
+    name?: string;
+    order?: number;
+    parentId?: MenuNodeId;
+    permissions?: string[];
+    redirect?: string;
+    roles?: string[];
+    visible?: boolean;
+    hideInBreadcrumb?: boolean;
+    externalLink?: string;
+}
+export interface NormalizedMenuNode extends Omit<MenuNode, 'children' | 'parentId'> {
+    authority: string[];
+    children: NormalizedMenuNode[];
+    meta: Record<string, unknown>;
+    name: string;
+    permissions: string[];
+    redirect?: string;
+    roles: string[];
+    keepAlive?: boolean;
+    visible: boolean;
+    externalLink?: string;
+}
+export type RouteComponentResolver = (component: string) => unknown;
+/**
+ * glob 组件 resolver 选项：把标准 component 字符串解析为 import.meta.glob 收集到的组件模块。
+ */
+export interface GlobComponentResolverOptions {
+    /** import.meta.glob 收集的模块表，key 为相对路径，value 为动态导入函数。 */
+    modules: Record<string, () => Promise<unknown>>;
+    /** 视图目录前缀，默认 `../views`，与候选路径拼接。 */
+    viewsPrefix?: string;
+    /** 未命中任何候选路径时的兜底组件。 */
+    fallback?: () => Promise<unknown>;
+}
+export interface CreateRouteRecordsOptions {
+    componentResolver?: RouteComponentResolver;
+}
+export interface LumalRouteRecord {
+    path: string;
+    children?: LumalRouteRecord[];
+    component?: unknown;
+    redirect?: string;
+    meta: {
+        authority?: string[];
+        permissions: string[];
+        roles: string[];
+        title: string;
+        externalLink?: string;
+        [key: string]: unknown;
+    };
+    name: string;
+}
+export interface SidebarMenuItem {
+    badge?: string | number;
+    badgeType?: LumalMenuBadgeType;
+    badgeTone?: LumalMenuBadgeTone;
+    path: string;
+    redirect?: string;
+    title: string;
+    children: SidebarMenuItem[];
+    icon?: string;
+    externalLink?: string;
+    externalTarget?: '_blank' | '_self';
+}
+export interface CreateSidebarMenusOptions {
+    hasPermission?: (permissions: string[]) => boolean;
+    hasRole?: (roles: string[]) => boolean;
+}
+/**
+ * 顶部菜单生成选项：在侧边菜单可访问过滤的基础上，仅保留标记为顶部菜单（meta.topMenu）的一级项。
+ */
+export type CreateTopMenusOptions = CreateSidebarMenusOptions;
+export interface FindAccessibleMenuOptions {
+    hasPermission?: (permissions: string[]) => boolean;
+    hasRole?: (roles: string[]) => boolean;
+}
+/**
+ * vue-router 的最小子集，避免在类型层强依赖 vue-router 具体版本。
+ */
+export interface RouteRegistryRouterLike {
+    addRoute: (route: LumalRouteRecord) => (() => void) | unknown;
+    getRoutes?: () => readonly {
+        name?: string | symbol;
+        path: string;
+    }[];
+    hasRoute: (name: string) => boolean;
+    removeRoute: (name: string) => void;
+}
+/**
+ * 菜单路由运行时需要读取现有路由路径，以便在注册前完成 path 冲突校验。
+ * 旧 createRouteRegistry 继续接受不含 getRoutes 的宽松 Router 子集。
+ */
+export interface MenuRouteRuntimeRouterLike extends RouteRegistryRouterLike {
+    getRoutes: () => readonly {
+        name?: string | symbol;
+        path: string;
+    }[];
+}
+/**
+ * 动态路由注册器：负责注册后端下发的动态路由并支持整体重置。
+ */
+export interface RouteRegistry {
+    register: (routes: LumalRouteRecord[]) => void;
+    reset: () => void;
+    readonly names: readonly string[];
+}
+export type MenuRouteSource = 'static' | 'remote';
+export type MenuRouteConflictSource = MenuRouteSource | 'existing';
+export type MenuRouteConflictKind = 'id' | 'name' | 'path';
+export interface MenuRouteErrorContext {
+    component?: string;
+    phase: 'load-component' | 'load-remote-menus' | 'register-routes' | 'resolve-component';
+    routeName?: string;
+    routePath?: string;
+    source?: MenuRouteSource;
+}
+export interface CreateMenuRouteRuntimeOptions {
+    router: MenuRouteRuntimeRouterLike;
+    staticMenus?: LumalStaticMenuRecord[];
+    loadRemoteMenus?: () => Promise<LumalMenuInputRecord[]>;
+    remoteNormalizeOptions?: NormalizeMenuRecordsOptions;
+    componentResolver?: RouteComponentResolver;
+    fallbackComponent?: () => Promise<unknown>;
+    hasPermission?: (permissions: string[]) => boolean;
+    hasRole?: (roles: string[]) => boolean;
+    onError?: (error: unknown, context: MenuRouteErrorContext) => void;
+}
+export interface MenuRouteRuntime {
+    readonly firstAccessibleMenu: NormalizedMenuNode | undefined;
+    readonly firstAccessiblePath: string;
+    readonly menus: NormalizedMenuNode[];
+    readonly remoteLoaded: boolean;
+    readonly remoteMenus: NormalizedMenuNode[];
+    readonly routeNames: readonly string[];
+    readonly routes: LumalRouteRecord[];
+    readonly sidebarMenus: SidebarMenuItem[];
+    readonly staticMenus: NormalizedMenuNode[];
+    readonly topMenus: SidebarMenuItem[];
+    loadRemote: () => Promise<NormalizedMenuNode[]>;
+    reload: () => Promise<NormalizedMenuNode[]>;
+    resetRemote: () => void;
+    dispose: () => void;
+}
+//# sourceMappingURL=types.d.ts.map