@qimen-lab/core 0.1.1

package/dist/oauth2/register.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * 自动注册 TokenRefreshHandler 到 HTTP 管道
+ *
+ * 引入 @qimenjs/oauth2 时自动执行
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerOAuth2Actions = registerOAuth2Actions;
+const http_1 = require("@/http");
+const TokenRefreshHandler_1 = require("./TokenRefreshHandler");
+/**
+ * 注册 OAuth2 HTTP 管道扩展
+ */
+function registerOAuth2Actions() {
+    const registrar = http_1.HttpActionRegistrar.getInstance();
+    registrar.register({
+        name: 'TokenRefresh',
+        category: http_1.HttpActionCategory.ALIGN,
+        offset: 20,
+        handler: TokenRefreshHandler_1.TokenRefreshHandler,
+        description: '401 拦截 + Token 自动刷新 + 重试',
+    });
+}
+// 自动注册
+registerOAuth2Actions();
+//# sourceMappingURL=register.js.map

package/dist/oauth2/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/oauth2/register.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAQH,sDASC;AAfD,iCAAiE;AACjE,+DAA4D;AAE5D;;GAEG;AACH,SAAgB,qBAAqB;IACjC,MAAM,SAAS,GAAG,0BAAmB,CAAC,WAAW,EAAE,CAAC;IACpD,SAAS,CAAC,QAAQ,CAAC;QACf,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,yBAAkB,CAAC,KAAK;QAClC,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,yCAAmB;QAC5B,WAAW,EAAE,0BAA0B;KAC1C,CAAC,CAAC;AACP,CAAC;AAED,OAAO;AACP,qBAAqB,EAAE,CAAC"}

package/dist/oauth2/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * OAuth2 认证流程类型定义
+ *
+ * @module oauth2/types
+ */
+/**
+ * OAuth2 授权类型
+ */
+export type OAuth2GrantType = 'authorization_code' | 'password' | 'client_credentials' | 'refresh_token';
+/**
+ * OAuth2 配置
+ */
+export interface OAuth2Config {
+    /** Token 端点（必填） */
+    tokenEndpoint: string;
+    /** 撤销端点（可选） */
+    revokeEndpoint?: string;
+    /** 客户端 ID（必填） */
+    clientId: string;
+    /** 客户端密钥（机密客户端需要） */
+    clientSecret?: string;
+    /** 重定向 URI（授权码模式） */
+    redirectUri?: string;
+    /** 授权端点（授权码模式跳转用） */
+    authorizationEndpoint?: string;
+    /** 作用域 */
+    scopes?: string[];
+    /** 关联的域名（updateToken 目标，支持多个） */
+    domain: string | string[];
+    /** Token 存储方式（默认 'memory'） */
+    storage?: 'memory' | 'localStorage' | 'sessionStorage';
+    /** Token 提前刷新时间（毫秒，默认 60000 = 1 分钟） */
+    refreshBuffer?: number;
+}
+/**
+ * OAuth2 Token 响应（RFC 6749 标准格式）
+ */
+export interface OAuth2TokenResponse {
+    access_token: string;
+    token_type: string;
+    expires_in?: number;
+    refresh_token?: string;
+    scope?: string;
+}
+/**
+ * 密码模式凭证
+ */
+export interface OAuth2PasswordCredentials {
+    username: string;
+    password: string;
+    scope?: string;
+}
+/**
+ * Token 存储条目
+ */
+export interface OAuth2TokenEntry {
+    accessToken: string;
+    refreshToken?: string;
+    tokenType?: string;
+    expiresIn?: number;
+    scope?: string;
+    acquiredAt: number;
+}
+/**
+ * OAuth2 登录结果
+ */
+export interface OAuth2LoginResult {
+    success: boolean;
+    accessToken?: string;
+    error?: {
+        code?: string;
+        message: string;
+    };
+}
+/**
+ * OAuth2 事件数据
+ */
+export interface OAuth2TokenAcquiredEvent {
+    accessToken: string;
+    refreshToken?: string;
+    expiresIn?: number;
+}
+export interface OAuth2TokenRefreshedEvent {
+    accessToken: string;
+    refreshToken?: string;
+    expiresIn?: number;
+}
+export interface OAuth2TokenExpiredEvent {
+    domain: string | string[];
+}
+export interface OAuth2RefreshFailedEvent {
+    error: Error;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/oauth2/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/oauth2/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GACrB,oBAAoB,GACpB,UAAU,GACV,oBAAoB,GACpB,eAAe,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,mBAAmB;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iCAAiC;IACjC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,QAAQ,GAAG,cAAc,GAAG,gBAAgB,CAAC;IACvD,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE;QACJ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACnB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACpC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACrC,KAAK,EAAE,KAAK,CAAC;CAChB"}

package/dist/oauth2/types.esm.js

@@ -0,0 +1,7 @@
+/**
+ * OAuth2 认证流程类型定义
+ *
+ * @module oauth2/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/oauth2/types.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/oauth2/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/oauth2/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * OAuth2 认证流程类型定义
+ *
+ * @module oauth2/types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/oauth2/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/oauth2/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/pattern/PatternRegistrar.d.ts

@@ -0,0 +1,63 @@
+/**
+ * PatternRegistrar - 模式注册器
+ *
+ * 职责：
+ * - 管理命名正则表达式的注册和检索
+ * - 用于集中管理应用程序中使用的各种正则表达式模式
+ */
+import { RegistrarBase } from '@qimenjs/registry';
+/**
+ * 模式注册器名称
+ */
+export declare const PatternRegistrarName: "pattern";
+/**
+ * 模式注册器
+ * 管理命名正则表达式的注册和检索
+ *
+ * 用于集中管理应用程序中使用的各种正则表达式模式，
+ * 如邮箱验证、手机号验证、URL验证等常用模式
+ */
+export declare class PatternRegistrar extends RegistrarBase<Map<string, RegExp>> {
+    readonly name: "pattern";
+    protected storage: Map<string, RegExp>;
+    /**
+     * 注册模式：
+     * 1. 单个: register('email', /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/)
+     * 2. 对象: register({ 'uuid': /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/ })
+     *
+     * @param nameOrObj - 模式名称或包含多个模式的对象
+     * @param entry - 正则表达式对象（当第一个参数为模式名称时）
+     * @throws RegistrarInvalidArgumentError - 当参数无效时
+     */
+    register(nameOrObj: string | Record<string, RegExp>, entry?: RegExp): void;
+    /**
+     * 注销指定名称的模式
+     * 从存储中删除指定名称的正则表达式
+     *
+     * @param name - 要注销的模式名称
+     */
+    unregister(name: string): void;
+    /**
+     * 核心逻辑提取：负责将多种输入统一转化为 RegExp 并存入 Map
+     *
+     * @param name - 模式名称
+     * @param entry - 正则表达式对象
+     */
+    private doRegister;
+    /**
+     * 根据名称获取正则表达式
+     *
+     * @param name - 模式名称
+     * @returns 对应的正则表达式对象
+     * @throws RegistrarNotFoundError - 当指定名称的模式不存在时
+     */
+    get(name: string): RegExp;
+    /**
+     * 输出模式注册器的状态信息
+     * 显示当前存储的所有模式名称和对应的正则表达式
+     *
+     * @protected
+     */
+    protected doInspect(): void;
+}
+//# sourceMappingURL=PatternRegistrar.d.ts.map

package/dist/pattern/PatternRegistrar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatternRegistrar.d.ts","sourceRoot":"","sources":["../../../src/pattern/PatternRegistrar.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAG,SAAkB,CAAC;AAEvD;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpE,SAAgB,IAAI,YAAwB;IAG5C,SAAS,CAAC,OAAO,sBAA6B;IAE9C;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAe1E;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMzB;;;;;OAKG;IACH,SAAS,CAAC,SAAS,IAAI,IAAI;CAY9B"}

package/dist/pattern/PatternRegistrar.esm.js

@@ -0,0 +1,103 @@
+/**
+ * PatternRegistrar - 模式注册器
+ *
+ * 职责：
+ * - 管理命名正则表达式的注册和检索
+ * - 用于集中管理应用程序中使用的各种正则表达式模式
+ */
+import { RegistrarBase } from '@qimenjs/registry';
+import { RegistrarInvalidArgumentError, RegistrarNotFoundError } from '@qimenjs/registry';
+/**
+ * 模式注册器名称
+ */
+export const PatternRegistrarName = 'pattern';
+/**
+ * 模式注册器
+ * 管理命名正则表达式的注册和检索
+ *
+ * 用于集中管理应用程序中使用的各种正则表达式模式，
+ * 如邮箱验证、手机号验证、URL验证等常用模式
+ */
+export class PatternRegistrar extends RegistrarBase {
+    constructor() {
+        super(...arguments);
+        this.name = PatternRegistrarName;
+        // 存储，确保编码期和运行期共享
+        this.storage = new Map();
+    }
+    /**
+     * 注册模式：
+     * 1. 单个: register('email', /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/)
+     * 2. 对象: register({ 'uuid': /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/ })
+     *
+     * @param nameOrObj - 模式名称或包含多个模式的对象
+     * @param entry - 正则表达式对象（当第一个参数为模式名称时）
+     * @throws RegistrarInvalidArgumentError - 当参数无效时
+     */
+    register(nameOrObj, entry) {
+        this.checkLock();
+        if (typeof nameOrObj === 'object' && !(nameOrObj instanceof RegExp)) {
+            // 模式 2：批量注册对象
+            for (const [name, val] of Object.entries(nameOrObj)) {
+                this.doRegister(name, val);
+            }
+        }
+        else if (typeof nameOrObj === 'string') {
+            // 模式 1：单个注册
+            if (!entry)
+                throw new RegistrarInvalidArgumentError(this.name, nameOrObj);
+            this.doRegister(nameOrObj, entry);
+        }
+    }
+    /**
+     * 注销指定名称的模式
+     * 从存储中删除指定名称的正则表达式
+     *
+     * @param name - 要注销的模式名称
+     */
+    unregister(name) {
+        this.checkLock();
+        this.storage.delete(name);
+    }
+    /**
+     * 核心逻辑提取：负责将多种输入统一转化为 RegExp 并存入 Map
+     *
+     * @param name - 模式名称
+     * @param entry - 正则表达式对象
+     */
+    doRegister(name, entry) {
+        this.storage.set(name, entry);
+    }
+    /**
+     * 根据名称获取正则表达式
+     *
+     * @param name - 模式名称
+     * @returns 对应的正则表达式对象
+     * @throws RegistrarNotFoundError - 当指定名称的模式不存在时
+     */
+    get(name) {
+        const pattern = this.storage.get(name);
+        if (!pattern)
+            throw new RegistrarNotFoundError(this.name, name);
+        return pattern;
+    }
+    /**
+     * 输出模式注册器的状态信息
+     * 显示当前存储的所有模式名称和对应的正则表达式
+     *
+     * @protected
+     */
+    doInspect() {
+        console.group('🔍 Registered Patterns');
+        const info = {};
+        this.storage.forEach((reg, name) => {
+            info[name] = {
+                source: reg.source,
+                flags: reg.flags,
+            };
+        });
+        console.table(info);
+        console.groupEnd();
+    }
+}
+//# sourceMappingURL=PatternRegistrar.js.map

package/dist/pattern/PatternRegistrar.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatternRegistrar.js","sourceRoot":"","sources":["../../../src/pattern/PatternRegistrar.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE1F;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAkB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,OAAO,gBAAiB,SAAQ,aAAkC;IAAxE;;QACoB,SAAI,GAAG,oBAAoB,CAAC;QAE5C,iBAAiB;QACP,YAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IA8ElD,CAAC;IA5EG;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAA0C,EAAE,KAAc;QAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;QAEjB,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,YAAY,MAAM,CAAC,EAAE,CAAC;YAClE,cAAc;YACd,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC/B,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YACvC,YAAY;YACZ,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,6BAA6B,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC1E,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAY;QACnB,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACK,UAAU,CAAC,IAAY,EAAE,KAAa;QAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,IAAY;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACO,SAAS;QACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACxC,MAAM,IAAI,GAAQ,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YAC/B,IAAI,CAAC,IAAI,CAAC,GAAG;gBACT,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;aACnB,CAAC;QACN,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,CAAC,QAAQ,EAAE,CAAC;IACvB,CAAC;CACJ"}

package/dist/pattern/PatternRegistrar.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * PatternRegistrar - 模式注册器
+ *
+ * 职责：
+ * - 管理命名正则表达式的注册和检索
+ * - 用于集中管理应用程序中使用的各种正则表达式模式
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatternRegistrar = exports.PatternRegistrarName = void 0;
+const registry_1 = require("@qimenjs/registry");
+const registry_2 = require("@qimenjs/registry");
+/**
+ * 模式注册器名称
+ */
+exports.PatternRegistrarName = 'pattern';
+/**
+ * 模式注册器
+ * 管理命名正则表达式的注册和检索
+ *
+ * 用于集中管理应用程序中使用的各种正则表达式模式，
+ * 如邮箱验证、手机号验证、URL验证等常用模式
+ */
+class PatternRegistrar extends registry_1.RegistrarBase {
+    constructor() {
+        super(...arguments);
+        this.name = exports.PatternRegistrarName;
+        // 存储，确保编码期和运行期共享
+        this.storage = new Map();
+    }
+    /**
+     * 注册模式：
+     * 1. 单个: register('email', /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/)
+     * 2. 对象: register({ 'uuid': /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/ })
+     *
+     * @param nameOrObj - 模式名称或包含多个模式的对象
+     * @param entry - 正则表达式对象（当第一个参数为模式名称时）
+     * @throws RegistrarInvalidArgumentError - 当参数无效时
+     */
+    register(nameOrObj, entry) {
+        this.checkLock();
+        if (typeof nameOrObj === 'object' && !(nameOrObj instanceof RegExp)) {
+            // 模式 2：批量注册对象
+            for (const [name, val] of Object.entries(nameOrObj)) {
+                this.doRegister(name, val);
+            }
+        }
+        else if (typeof nameOrObj === 'string') {
+            // 模式 1：单个注册
+            if (!entry)
+                throw new registry_2.RegistrarInvalidArgumentError(this.name, nameOrObj);
+            this.doRegister(nameOrObj, entry);
+        }
+    }
+    /**
+     * 注销指定名称的模式
+     * 从存储中删除指定名称的正则表达式
+     *
+     * @param name - 要注销的模式名称
+     */
+    unregister(name) {
+        this.checkLock();
+        this.storage.delete(name);
+    }
+    /**
+     * 核心逻辑提取：负责将多种输入统一转化为 RegExp 并存入 Map
+     *
+     * @param name - 模式名称
+     * @param entry - 正则表达式对象
+     */
+    doRegister(name, entry) {
+        this.storage.set(name, entry);
+    }
+    /**
+     * 根据名称获取正则表达式
+     *
+     * @param name - 模式名称
+     * @returns 对应的正则表达式对象
+     * @throws RegistrarNotFoundError - 当指定名称的模式不存在时
+     */
+    get(name) {
+        const pattern = this.storage.get(name);
+        if (!pattern)
+            throw new registry_2.RegistrarNotFoundError(this.name, name);
+        return pattern;
+    }
+    /**
+     * 输出模式注册器的状态信息
+     * 显示当前存储的所有模式名称和对应的正则表达式
+     *
+     * @protected
+     */
+    doInspect() {
+        console.group('🔍 Registered Patterns');
+        const info = {};
+        this.storage.forEach((reg, name) => {
+            info[name] = {
+                source: reg.source,
+                flags: reg.flags,
+            };
+        });
+        console.table(info);
+        console.groupEnd();
+    }
+}
+exports.PatternRegistrar = PatternRegistrar;
+//# sourceMappingURL=PatternRegistrar.js.map

package/dist/pattern/PatternRegistrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatternRegistrar.js","sourceRoot":"","sources":["../../../src/pattern/PatternRegistrar.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,gDAAkD;AAClD,gDAA0F;AAE1F;;GAEG;AACU,QAAA,oBAAoB,GAAG,SAAkB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAa,gBAAiB,SAAQ,wBAAkC;IAAxE;;QACoB,SAAI,GAAG,4BAAoB,CAAC;QAE5C,iBAAiB;QACP,YAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IA8ElD,CAAC;IA5EG;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAA0C,EAAE,KAAc;QAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;QAEjB,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,YAAY,MAAM,CAAC,EAAE,CAAC;YAClE,cAAc;YACd,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC/B,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YACvC,YAAY;YACZ,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,wCAA6B,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC1E,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAY;QACnB,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACK,UAAU,CAAC,IAAY,EAAE,KAAa;QAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,IAAY;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,iCAAsB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACO,SAAS;QACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACxC,MAAM,IAAI,GAAQ,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YAC/B,IAAI,CAAC,IAAI,CAAC,GAAG;gBACT,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;aACnB,CAAC;QACN,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,CAAC,QAAQ,EAAE,CAAC;IACvB,CAAC;CACJ;AAlFD,4CAkFC"}

package/dist/pattern/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @qimenjs/pattern - 模式注册器
+ *
+ * 提供命名正则表达式注册器，管理验证所需的模式。
+ * 引入即自动注册 ValidationPatternType 枚举中全部 19 个模式。
+ *
+ * @example
+ * ```typescript
+ * import '@qimenjs/pattern';
+ *
+ * // 使用 PatternRegistrar
+ * import { PatternRegistrar } from '@qimenjs/pattern';
+ * const emailRegex = PatternRegistrar.getInstance().get('email');
+ * emailRegex.test('user@example.com'); // true
+ * ```
+ */
+export { PatternRegistrar, PatternRegistrarName } from './PatternRegistrar';
+export { FORMAT_PATTERNS, PASSWORD_PATTERNS, VALIDATION_PATTERNS } from './presets';
+export { registerValidationPatterns } from './register';
+//# sourceMappingURL=index.d.ts.map

package/dist/pattern/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pattern/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG5E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC"}

package/dist/pattern/index.esm.js

@@ -0,0 +1,23 @@
+/**
+ * @qimenjs/pattern - 模式注册器
+ *
+ * 提供命名正则表达式注册器，管理验证所需的模式。
+ * 引入即自动注册 ValidationPatternType 枚举中全部 19 个模式。
+ *
+ * @example
+ * ```typescript
+ * import '@qimenjs/pattern';
+ *
+ * // 使用 PatternRegistrar
+ * import { PatternRegistrar } from '@qimenjs/pattern';
+ * const emailRegex = PatternRegistrar.getInstance().get('email');
+ * emailRegex.test('user@example.com'); // true
+ * ```
+ */
+// PatternRegistrar 核心
+export { PatternRegistrar, PatternRegistrarName } from './PatternRegistrar';
+// 预定义模式常量
+export { FORMAT_PATTERNS, PASSWORD_PATTERNS, VALIDATION_PATTERNS } from './presets';
+// 自动注册（必须在最后，触发 registerValidationPatterns）
+export { registerValidationPatterns } from './register';
+//# sourceMappingURL=index.js.map

package/dist/pattern/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pattern/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,sBAAsB;AACtB,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEpF,4CAA4C;AAC5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC"}

package/dist/pattern/index.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * @qimenjs/pattern - 模式注册器
+ *
+ * 提供命名正则表达式注册器，管理验证所需的模式。
+ * 引入即自动注册 ValidationPatternType 枚举中全部 19 个模式。
+ *
+ * @example
+ * ```typescript
+ * import '@qimenjs/pattern';
+ *
+ * // 使用 PatternRegistrar
+ * import { PatternRegistrar } from '@qimenjs/pattern';
+ * const emailRegex = PatternRegistrar.getInstance().get('email');
+ * emailRegex.test('user@example.com'); // true
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerValidationPatterns = exports.VALIDATION_PATTERNS = exports.PASSWORD_PATTERNS = exports.FORMAT_PATTERNS = exports.PatternRegistrarName = exports.PatternRegistrar = void 0;
+// PatternRegistrar 核心
+var PatternRegistrar_1 = require("./PatternRegistrar");
+Object.defineProperty(exports, "PatternRegistrar", { enumerable: true, get: function () { return PatternRegistrar_1.PatternRegistrar; } });
+Object.defineProperty(exports, "PatternRegistrarName", { enumerable: true, get: function () { return PatternRegistrar_1.PatternRegistrarName; } });
+// 预定义模式常量
+var presets_1 = require("./presets");
+Object.defineProperty(exports, "FORMAT_PATTERNS", { enumerable: true, get: function () { return presets_1.FORMAT_PATTERNS; } });
+Object.defineProperty(exports, "PASSWORD_PATTERNS", { enumerable: true, get: function () { return presets_1.PASSWORD_PATTERNS; } });
+Object.defineProperty(exports, "VALIDATION_PATTERNS", { enumerable: true, get: function () { return presets_1.VALIDATION_PATTERNS; } });
+// 自动注册（必须在最后，触发 registerValidationPatterns）
+var register_1 = require("./register");
+Object.defineProperty(exports, "registerValidationPatterns", { enumerable: true, get: function () { return register_1.registerValidationPatterns; } });
+//# sourceMappingURL=index.js.map

package/dist/pattern/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pattern/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAEH,sBAAsB;AACtB,uDAA4E;AAAnE,oHAAA,gBAAgB,OAAA;AAAE,wHAAA,oBAAoB,OAAA;AAE/C,UAAU;AACV,qCAAoF;AAA3E,0GAAA,eAAe,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAEhE,4CAA4C;AAC5C,uCAAwD;AAA/C,sHAAA,0BAA0B,OAAA"}

package/dist/pattern/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@qimen-lab/pattern",
+  "version": "0.1.1",
+  "main": "index.js",
+  "module": "index.esm.js",
+  "types": "index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": "./index.esm.js",
+      "require": "./index.js",
+      "types": "./index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@qimen-lab/registry": "0.1.1"
+  }
+}

package/dist/pattern/presets.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 预定义验证模式
+ *
+ * 覆盖 ValidationPatternType 枚举中全部 19 个模式：
+ * - 格式验证（15 个）：email, url, ipv4, ipv6, mac, phone, uuid, base64,
+ *   hexColor, rgbColor, rgbaColor, creditCard, chineseId, chinesePostcode, username
+ * - 密码验证（4 个）：uppercase, lowercase, digit, specialChar
+ *
+ * 引入 @qimenjs/pattern 时自动注册到 PatternRegistrar
+ */
+/**
+ * 格式验证模式（15 个）
+ */
+export declare const FORMAT_PATTERNS: Record<string, RegExp>;
+/**
+ * 密码验证模式（4 个）
+ */
+export declare const PASSWORD_PATTERNS: Record<string, RegExp>;
+/**
+ * 所有验证模式（合并格式 + 密码）
+ */
+export declare const VALIDATION_PATTERNS: Record<string, RegExp>;
+//# sourceMappingURL=presets.d.ts.map

package/dist/pattern/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/pattern/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkBlD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGtD,CAAC"}

package/dist/pattern/presets.esm.js

@@ -0,0 +1,47 @@
+/**
+ * 预定义验证模式
+ *
+ * 覆盖 ValidationPatternType 枚举中全部 19 个模式：
+ * - 格式验证（15 个）：email, url, ipv4, ipv6, mac, phone, uuid, base64,
+ *   hexColor, rgbColor, rgbaColor, creditCard, chineseId, chinesePostcode, username
+ * - 密码验证（4 个）：uppercase, lowercase, digit, specialChar
+ *
+ * 引入 @qimenjs/pattern 时自动注册到 PatternRegistrar
+ */
+/**
+ * 格式验证模式（15 个）
+ */
+export const FORMAT_PATTERNS = {
+    email: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
+    url: /^(https?:\/\/)?([\da-z.-]+)\.([a-z.]{2,6})([/\w .-]*)*\/?$/,
+    ipv4: /^(?:(?:25[0-5]|2[0-4]\d|[01]?\d\d?)\.){3}(?:25[0-5]|2[0-4]\d|[01]?\d\d?)$/,
+    ipv6: /^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|::|([0-9a-fA-F]{1,4})?::([0-9a-fA-F]{1,4}:){0,5}[0-9a-fA-F]{1,4})$/,
+    mac: /^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$/,
+    phone: /^(\+?\d{1,3}[-.\s]?)?\(?\d{1,4}\)?[-.\s]?\d{1,4}[-.\s]?\d{1,9}$/,
+    uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
+    base64: /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/,
+    hexColor: /^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/,
+    rgbColor: /^rgb\(\s*(\d{1,3}%?)\s*,\s*(\d{1,3}%?)\s*,\s*(\d{1,3}%?)\s*\)$/,
+    rgbaColor: /^rgba\(\s*(\d{1,3}%?)\s*,\s*(\d{1,3}%?)\s*,\s*(\d{1,3}%?)\s*,\s*(0|0?\.\d+|1|100%?)\s*\)$/,
+    creditCard: /^(?:4[0-9]{12}(?:[0-9]{3})?|5[1-5][0-9]{14}|3[47][0-9]{13}|6(?:011|5[0-9]{2})[0-9]{12})$/,
+    chineseId: /^[1-9]\d{5}(?:19|20)\d{2}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\d|3[01])\d{3}[\dXx]$/,
+    chinesePostcode: /^[1-9]\d{5}$/,
+    username: /^[a-zA-Z][a-zA-Z0-9_]{2,15}$/,
+};
+/**
+ * 密码验证模式（4 个）
+ */
+export const PASSWORD_PATTERNS = {
+    uppercase: /[A-Z]/,
+    lowercase: /[a-z]/,
+    digit: /\d/,
+    specialChar: /[!@#$%^&*()_+\-=\[\]{};':"\\|,.<>\/?`~]/,
+};
+/**
+ * 所有验证模式（合并格式 + 密码）
+ */
+export const VALIDATION_PATTERNS = {
+    ...FORMAT_PATTERNS,
+    ...PASSWORD_PATTERNS,
+};
+//# sourceMappingURL=presets.js.map

package/dist/pattern/presets.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/pattern/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAA2B;IACnD,KAAK,EAAE,kDAAkD;IACzD,GAAG,EAAE,4DAA4D;IACjE,IAAI,EAAE,2EAA2E;IACjF,IAAI,EAAE,6GAA6G;IACnH,GAAG,EAAE,2CAA2C;IAChD,KAAK,EAAE,iEAAiE;IACxE,IAAI,EAAE,iEAAiE;IACvE,MAAM,EAAE,kEAAkE;IAC1E,QAAQ,EAAE,oCAAoC;IAC9C,QAAQ,EAAE,gEAAgE;IAC1E,SAAS,EACL,2FAA2F;IAC/F,UAAU,EACN,0FAA0F;IAC9F,SAAS,EAAE,+EAA+E;IAC1F,eAAe,EAAE,cAAc;IAC/B,QAAQ,EAAE,8BAA8B;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACrD,SAAS,EAAE,OAAO;IAClB,SAAS,EAAE,OAAO;IAClB,KAAK,EAAE,IAAI;IACX,WAAW,EAAE,yCAAyC;CACzD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACvD,GAAG,eAAe;IAClB,GAAG,iBAAiB;CACvB,CAAC"}