@jingyi0605/codingns4dsh 0.1.7-rc.3 → 0.2.0-beta.2

package/data/build/dist/host/modules/peer-host/peer-host-session.js

@@ -17,51 +17,111 @@ export class PeerHostSessionService {
         this.refreshSkewMs = options.refreshSkewMs ?? 30_000;
     }
     async login(peerHostId, input) {
-        const record = await this.ensureReady(peerHostId);
+        // 目标明确拒绝旧 token 后状态就是 session_required；此时重新登录必须直接可用，
+        // 不能要求用户先手工重新握手。
+        const record = await this.ensureReady(peerHostId, true);
         const username = requiredText(input.username, 'username');
         const password = requiredText(input.password, 'password');
         const response = await this.request(record, '/api/auth/login', { username, password });
         const payload = parseTokenResponse(response);
-        const credential = toCredential(payload, this.now());
+        const credential = toCredential(payload, this.now(), { username, password });
         await this.credentials.write(peerHostId, credential);
+        if (record.status !== 'ready')
+            await this.store.updateStatus(peerHostId, 'ready', null);
         return toView(peerHostId, credential);
     }
     async refresh(peerHostId) {
-        const record = await this.ensureReady(peerHostId);
+        const record = await this.ensureReady(peerHostId, true);
         const previous = await this.credentials.read(peerHostId);
         if (previous === null)
             return this.sessionRequired(peerHostId);
+        const refreshed = await this.tryRefresh(peerHostId, record, previous);
+        if (refreshed !== null)
+            return toView(peerHostId, refreshed);
+        // refreshToken 失效但编辑时保存了账号密码时静默重登，用户无需再手工登录。
+        const relogged = await this.trySavedLogin(peerHostId, record, previous);
+        if (relogged !== null)
+            return toView(peerHostId, relogged);
+        return this.sessionRequired(peerHostId);
+    }
+    async getAccessToken(peerHostId) {
+        const record = await this.ensureReady(peerHostId);
+        const credential = await this.credentials.read(peerHostId);
+        if (credential === null)
+            return this.sessionRequired(peerHostId);
+        if (credential.expiresAt - this.now() > this.refreshSkewMs)
+            return credential.accessToken;
+        const refreshed = await this.tryRefresh(peerHostId, record, credential);
+        if (refreshed !== null)
+            return refreshed.accessToken;
+        const relogged = await this.trySavedLogin(peerHostId, record, credential);
+        if (relogged !== null)
+            return relogged.accessToken;
+        return this.sessionRequired(peerHostId);
+    }
+    /**
+     * 用 refreshToken 续期；失败返回 null，交给调用方决定是否静默重登。
+     *
+     * 这里刻意不清除凭据：网络抖动导致的失败不应该抹掉用户在编辑里保存的账号，
+     * 否则"只保存一次"的语义会被一次断网破坏。
+     */
+    async tryRefresh(peerHostId, record, previous) {
         try {
             const response = await this.request(record, '/api/auth/refresh', { refreshToken: previous.refreshToken });
             const payload = parseTokenResponse(response, previous.refreshToken);
-            const credential = toCredential(payload, this.now());
+            const credential = toCredential(payload, this.now(), readSavedAccount(previous));
             await this.credentials.write(peerHostId, credential);
-            return toView(peerHostId, credential);
+            if (record.status !== 'ready')
+                await this.store.updateStatus(peerHostId, 'ready', null);
+            return credential;
         }
-        catch (error) {
-            await this.credentials.clear(peerHostId);
-            await this.store.updateStatus(peerHostId, 'session_required', errorCode(error, PEER_HOST_ERROR_CODES.SESSION_REQUIRED));
-            return this.sessionRequired(peerHostId);
+        catch {
+            return null;
         }
     }
-    async getAccessToken(peerHostId) {
-        const record = await this.ensureReady(peerHostId);
-        const credential = await this.credentials.read(peerHostId);
-        if (credential === null)
-            return this.sessionRequired(peerHostId).then(() => '');
-        if (credential.expiresAt - this.now() <= this.refreshSkewMs) {
-            const refreshed = await this.refresh(peerHostId);
-            const latest = await this.credentials.read(peerHostId);
-            if (refreshed.status !== 'logged_in' || latest === null)
-                throw new PeerHostSessionError(PEER_HOST_ERROR_CODES.SESSION_REQUIRED, '目标 Host 登录态已失效');
-            return latest.accessToken;
+    /**
+     * 用编辑时保存的账号密码静默重登。
+     *
+     * 只有目标明确拒绝该账号（401 → SESSION_REQUIRED）时才清除凭据，避免用过期
+     * 口令反复重试；网络类失败保留凭据，等待下一次请求再试。
+     */
+    async trySavedLogin(peerHostId, record, previous) {
+        const account = readSavedAccount(previous);
+        if (account === null)
+            return null;
+        try {
+            const response = await this.request(record, '/api/auth/login', account);
+            const payload = parseTokenResponse(response);
+            const credential = toCredential(payload, this.now(), account);
+            await this.credentials.write(peerHostId, credential);
+            if (record.status !== 'ready')
+                await this.store.updateStatus(peerHostId, 'ready', null);
+            return credential;
+        }
+        catch (error) {
+            if (error instanceof PeerHostSessionError && error.code === PEER_HOST_ERROR_CODES.SESSION_REQUIRED) {
+                await this.credentials.clear(peerHostId);
+            }
+            return null;
         }
-        return credential.accessToken;
     }
-    /** 目标 Host 明确拒绝当前 token 时，只清理该 PeerHost 的登录态。 */
+    /**
+     * 目标 Host 明确拒绝当前 token 时的恢复入口。
+     *
+     * 保存了账号密码时先尝试静默重登：目标是"编辑里保存一次，之后一直能连"，
+     * 因此一次 401 不应该直接把用户打回手工登录。重登失败才清理登录态。
+     */
     async invalidate(peerHostId) {
-        await this.credentials.clear(peerHostId);
         const record = await this.store.get(peerHostId);
+        if (record !== null && record.status === 'ready') {
+            const credential = await this.credentials.read(peerHostId);
+            if (credential !== null && readSavedAccount(credential) !== null) {
+                const recovered = await this.trySavedLogin(peerHostId, record, credential);
+                if (recovered !== null)
+                    return;
+            }
+        }
+        await this.credentials.clear(peerHostId);
         if (record !== null && record.status === 'ready')
             await this.store.updateStatus(peerHostId, 'session_required', PEER_HOST_ERROR_CODES.SESSION_REQUIRED);
     }
@@ -83,13 +143,14 @@ export class PeerHostSessionService {
             await this.store.updateStatus(peerHostId, 'ready', null);
         return { peerHostId, status: 'logged_out', expiresAt: null };
     }
-    async ensureReady(peerHostId) {
+    async ensureReady(peerHostId, allowSessionRequired = false) {
         const record = await this.store.get(peerHostId);
         if (record === null)
             throw new PeerHostSessionError(PEER_HOST_ERROR_CODES.NOT_FOUND, 'PeerHost 不存在');
-        if (record.status !== 'ready')
-            throw new PeerHostSessionError(record.status === 'session_required' ? PEER_HOST_ERROR_CODES.SESSION_REQUIRED : PEER_HOST_ERROR_CODES.NOT_READY, 'PeerHost 尚未通过握手检查');
-        return record;
+        const requiresLogin = record.status === 'session_required';
+        if (record.status === 'ready' || (allowSessionRequired && requiresLogin))
+            return record;
+        throw new PeerHostSessionError(requiresLogin ? PEER_HOST_ERROR_CODES.SESSION_REQUIRED : PEER_HOST_ERROR_CODES.NOT_READY, requiresLogin ? '目标 Host 需要登录' : 'PeerHost 尚未通过握手检查');
     }
     async request(record, path, body, accessToken) {
         if (record.route.kind !== 'lan')
@@ -99,16 +160,28 @@ export class PeerHostSessionService {
             headers.set('content-type', 'application/json');
         if (accessToken !== undefined)
             headers.set('authorization', `Bearer ${accessToken}`);
-        const response = await this.fetchImpl(new URL(path, record.route.normalizedOrigin), {
-            method: 'POST', headers, ...(body === undefined ? {} : { body: JSON.stringify(body) }),
-        });
+        let response;
+        try {
+            response = await this.fetchImpl(new URL(path, record.route.normalizedOrigin), {
+                method: 'POST', headers, ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+            });
+        }
+        catch {
+            throw new PeerHostSessionError(PEER_HOST_ERROR_CODES.PROXY_UNREACHABLE, `目标 Host 请求失败（POST ${path}，网络不可达）`);
+        }
         let payload = null;
         try {
             payload = await response.json();
         }
         catch { /* logout 允许空响应 */ }
-        if (!response.ok)
-            throw new PeerHostSessionError(response.status === 401 ? PEER_HOST_ERROR_CODES.SESSION_REQUIRED : PEER_HOST_ERROR_CODES.PROXY_UNREACHABLE, '目标 Host 登录请求失败');
+        if (!response.ok) {
+            if (response.status === 401) {
+                // 登录端点的 401 只表示凭据被拒；不能用“登录态已失效”掩盖密码错误。
+                const message = path === '/api/auth/login' ? '目标 Host 用户名或密码错误' : '目标 Host 登录态已失效';
+                throw new PeerHostSessionError(PEER_HOST_ERROR_CODES.SESSION_REQUIRED, message);
+            }
+            throw new PeerHostSessionError(PEER_HOST_ERROR_CODES.PROXY_UNREACHABLE, `目标 Host 请求失败（POST ${path}，HTTP ${response.status}）`);
+        }
         return payload;
     }
     async sessionRequired(peerHostId) {
@@ -135,8 +208,19 @@ function parseTokenResponse(value, fallbackRefreshToken) {
         throw new PeerHostSessionError(PEER_HOST_ERROR_CODES.RESPONSE_INVALID, '目标 Host token 响应无效');
     return { accessToken, refreshToken, expiresIn };
 }
-function toCredential(payload, now) {
-    return { accessToken: payload.accessToken, refreshToken: payload.refreshToken, expiresAt: now + payload.expiresIn * 1000 };
+function toCredential(payload, now, account = null) {
+    return {
+        accessToken: payload.accessToken,
+        refreshToken: payload.refreshToken,
+        expiresAt: now + payload.expiresIn * 1000,
+        ...(account === null ? {} : { username: account.username, password: account.password }),
+    };
+}
+/** 读出凭据里保存的目标账号；缺任一半都视为未保存。 */
+function readSavedAccount(credential) {
+    const username = typeof credential.username === 'string' ? credential.username.trim() : '';
+    const password = typeof credential.password === 'string' ? credential.password : '';
+    return username === '' || password === '' ? null : { username, password };
 }
 function toView(peerHostId, credential) {
     return { peerHostId, status: 'logged_in', expiresAt: credential.expiresAt };
@@ -146,7 +230,4 @@ function requiredText(value, field) {
         throw new TypeError(`${field} 不能为空`);
     return value.trim();
 }
-function errorCode(error, fallback) {
-    return error instanceof PeerHostSessionError ? error.code : fallback;
-}
 //# sourceMappingURL=peer-host-session.js.map

package/data/build/dist/host/modules/peer-host/peer-host-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-host-session.js","sourceRoot":"","sources":["../../../../../../src/host/modules/peer-host/peer-host-session.ts"],"names":[],"mappings":"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"}

package/data/build/dist/host/modules/peer-host/peer-host-store.d.ts

@@ -3,6 +3,13 @@ export interface PeerHostTokenRecord {
     readonly accessToken: string;
     readonly refreshToken: string;
     readonly expiresAt: number;
+    /**
+     * 用户显式保存的目标账号；只存在于加密凭据文件，从不回传客户端。
+     *
+     * 保存账号密码的唯一目的是票据彻底失效后静默重登，避免用户重复手工登录。
+     */
+    readonly username?: string;
+    readonly password?: string;
 }
 export interface PeerHostRecordStore {
     read(): Promise<readonly PeerHostRecord[]>;
@@ -16,16 +23,21 @@ export interface PeerHostCredentialStore {
 export interface PeerHostCreateInput {
     readonly displayName: string;
     readonly route: PeerHostRoute;
+    /** 工作区标签配色；缺省时客户端按名称推导稳定色。 */
+    readonly color?: string | null;
 }
 export interface PeerHostUpdateInput {
     readonly displayName?: string;
     readonly route?: PeerHostRoute;
+    readonly color?: string | null;
 }
 export interface PeerHostHandshakeUpdate {
     readonly status: PeerHostRecord['status'];
     readonly pluginId: string | null;
     readonly pluginVersion: string | null;
     readonly dshVersion: string | null;
+    readonly hostname?: string | null;
+    readonly configProfile?: string | null;
     readonly apiCompatibility: string | null;
     readonly fingerprint: string | null;
     readonly lastCheckedAt: number;
@@ -52,6 +64,15 @@ export declare class PeerHostStore {
     remove(peerHostId: string): Promise<void>;
     updateHandshake(peerHostId: string, input: PeerHostHandshakeUpdate): Promise<PeerHostRecord>;
     updateStatus(peerHostId: string, status: PeerHostRecord['status'], lastErrorCode: PeerHostErrorCode | null): Promise<PeerHostRecord>;
+    /**
+     * 显式添加或移除一个可见远端工作区。
+     *
+     * 只有这里写入的远端工作区才会进入聚合摘要；重复添加是幂等的，移除不存在的
+     * ID 也不报错，避免用户连点或并发刷新时产生难以理解的状态。
+     */
+    setWorkspaceVisibility(peerHostId: string, workspaceId: string, visible: boolean): Promise<PeerHostRecord>;
+    /** 整体替换可见工作区集合；用于"一次性保存"的编辑路径。 */
+    replaceVisibleWorkspaces(peerHostId: string, workspaceIds: readonly string[]): Promise<PeerHostRecord>;
     private load;
     private persist;
     private findIndex;

package/data/build/dist/host/modules/peer-host/peer-host-store.d.ts.map

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

package/data/build/dist/host/modules/peer-host/peer-host-store.js

@@ -1,7 +1,7 @@
 import { createCipheriv, createDecipheriv, randomBytes } from 'node:crypto';
 import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
-import { PEER_HOST_ERROR_CODES } from '../../../shared/contracts/peer-host.js';
+import { PEER_HOST_ERROR_CODES, normalizePeerHostColor } from '../../../shared/contracts/peer-host.js';
 export class PeerHostStoreError extends Error {
     code;
     constructor(code, message) {
@@ -52,10 +52,14 @@ export class PeerHostStore {
                 pluginId: null,
                 pluginVersion: null,
                 dshVersion: null,
+                hostname: null,
+                configProfile: null,
                 apiCompatibility: null,
                 fingerprint: null,
                 lastCheckedAt: null,
                 lastErrorCode: null,
+                color: normalizePeerHostColor(input.color) ?? null,
+                visibleWorkspaceIds: [],
                 createdAt: timestamp,
                 updatedAt: timestamp,
             };
@@ -78,6 +82,7 @@ export class PeerHostStore {
                 ...previous,
                 displayName,
                 route,
+                ...(input.color === undefined ? {} : { color: normalizePeerHostColor(input.color) }),
                 ...(routeChanged ? resetHandshake(previous) : {}),
                 updatedAt: this.now(),
             };
@@ -117,13 +122,47 @@ export class PeerHostStore {
             return cloneRecord(next);
         });
     }
+    /**
+     * 显式添加或移除一个可见远端工作区。
+     *
+     * 只有这里写入的远端工作区才会进入聚合摘要；重复添加是幂等的，移除不存在的
+     * ID 也不报错，避免用户连点或并发刷新时产生难以理解的状态。
+     */
+    async setWorkspaceVisibility(peerHostId, workspaceId, visible) {
+        return this.enqueue(async () => {
+            await this.load();
+            const index = this.findIndex(peerHostId);
+            const previous = this.records[index];
+            const current = previous.visibleWorkspaceIds ?? [];
+            const next = visible
+                ? (current.includes(workspaceId) ? current : [...current, workspaceId])
+                : current.filter((id) => id !== workspaceId);
+            const record = { ...previous, visibleWorkspaceIds: next, updatedAt: this.now() };
+            this.records[index] = record;
+            await this.persist();
+            return cloneRecord(record);
+        });
+    }
+    /** 整体替换可见工作区集合；用于"一次性保存"的编辑路径。 */
+    async replaceVisibleWorkspaces(peerHostId, workspaceIds) {
+        return this.enqueue(async () => {
+            await this.load();
+            const index = this.findIndex(peerHostId);
+            const previous = this.records[index];
+            const next = [...new Set(workspaceIds.filter((id) => typeof id === 'string' && id.trim() !== ''))];
+            const record = { ...previous, visibleWorkspaceIds: next, updatedAt: this.now() };
+            this.records[index] = record;
+            await this.persist();
+            return cloneRecord(record);
+        });
+    }
     async load() {
         if (this.records !== null)
             return;
         const records = await this.recordStore.read();
         this.records = records
             .filter((record) => record.ownerUserId === this.ownerUserId)
-            .map((record) => ({ ...record, route: normalizePeerHostRoute(record.route) }));
+            .map((record) => ({ ...normalizeStoredRecord(record), route: normalizePeerHostRoute(record.route) }));
     }
     async persist() {
         await this.recordStore.write(this.records.map(cloneRecord));
@@ -286,12 +325,30 @@ function routeKey(route) {
         ? `lan:${route.normalizedOrigin}`
         : `relay:${route.deviceId}:${route.relayEntryId}`;
 }
+/**
+ * 归一化磁盘上的旧记录。
+ *
+ * 旧版本没有 `color` 与 `visibleWorkspaceIds`：前者保持 null（客户端按名称推导），
+ * 后者必须是空数组——把 undefined 当成"显示全部"会让升级后的用户突然看到所有
+ * 远端工作区，与"默认不显示"的新语义相反。
+ */
+function normalizeStoredRecord(record) {
+    return {
+        ...record,
+        color: normalizePeerHostColor(record.color),
+        visibleWorkspaceIds: Array.isArray(record.visibleWorkspaceIds)
+            ? record.visibleWorkspaceIds.filter((id) => typeof id === 'string' && id.trim() !== '')
+            : [],
+    };
+}
 function resetHandshake(record) {
     return {
         status: 'configured',
         pluginId: null,
         pluginVersion: null,
         dshVersion: null,
+        hostname: null,
+        configProfile: null,
         apiCompatibility: null,
         fingerprint: null,
         lastCheckedAt: null,
@@ -310,7 +367,12 @@ function requireText(value, field) {
     return value.trim();
 }
 function cloneRecord(record) {
-    return { ...record, route: record.route.kind === 'lan' ? { ...record.route } : { ...record.route } };
+    return {
+        ...record,
+        route: record.route.kind === 'lan' ? { ...record.route } : { ...record.route },
+        // 数组字段必须复制：调用方拿到的是快照，不能通过引用改到 store 内部状态。
+        ...(record.visibleWorkspaceIds === undefined ? {} : { visibleWorkspaceIds: [...record.visibleWorkspaceIds] }),
+    };
 }
 function isCredentialMap(value) {
     if (typeof value !== 'object' || value === null || Array.isArray(value))

package/data/build/dist/host/modules/peer-host/peer-host-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-host-store.js","sourceRoot":"","sources":["../../../../../../src/host/modules/peer-host/peer-host-store.ts"],"names":[],"mappings":"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"}

package/data/build/dist/host/modules/peer-host/peer-host-virtual-registry.d.ts

@@ -0,0 +1,49 @@
+import type { AggregateHostResult, AggregateWorkspaceOrder, AggregateWorkspaceSummary, PeerHostSessionRecord, VirtualSessionId, VirtualWorkspaceId, VirtualWorkspaceRef, VirtualSessionRef } from '../../../shared/contracts/peer-host.js';
+/** 聚合层可选的顺序存储；存储失败不能破坏当前内存中的排序。 */
+export interface AggregateWorkspaceOrderStore {
+    load(): Promise<readonly VirtualWorkspaceId[] | AggregateWorkspaceOrder | null> | readonly VirtualWorkspaceId[] | AggregateWorkspaceOrder | null;
+    save(order: AggregateWorkspaceOrder): Promise<void> | void;
+}
+/** Host 侧顺序文件存储；文件内容只包含虚拟 ID，不包含远端正文或凭据。 */
+export declare class FileAggregateWorkspaceOrderStore implements AggregateWorkspaceOrderStore {
+    private readonly filePath;
+    constructor(filePath: string);
+    load(): Promise<AggregateWorkspaceOrder | null>;
+    save(order: AggregateWorkspaceOrder): Promise<void>;
+}
+export interface VirtualWorkspaceEntry extends AggregateWorkspaceSummary {
+    readonly virtualWorkspaceId: VirtualWorkspaceId;
+    readonly source: 'local' | 'peer';
+}
+export interface VirtualSessionEntry extends PeerHostSessionRecord {
+    readonly virtualSessionId: VirtualSessionId;
+    readonly source: 'local' | 'peer';
+}
+/** 将本地和多个 PeerHost 摘要映射为单一 Host 可消费的虚拟资源表。 */
+export declare class VirtualWorkspaceRegistry {
+    private readonly workspaces;
+    private readonly sessions;
+    private order;
+    private orderStore;
+    constructor(options?: {
+        readonly order?: readonly VirtualWorkspaceId[];
+        readonly orderStore?: AggregateWorkspaceOrderStore;
+    });
+    /** 替换一次聚合快照；旧 Host/Workspace 不会残留在表中。 */
+    replace(results: readonly AggregateHostResult[]): void;
+    /** 从持久化存储恢复顺序，未知/重复 ID 会被过滤，新的 Workspace 追加到末尾。 */
+    hydrateOrder(): Promise<readonly VirtualWorkspaceId[]>;
+    list(): readonly VirtualWorkspaceEntry[];
+    listWorkspaceIds(): readonly VirtualWorkspaceId[];
+    /** 返回包含离线/暂未加载资源的顺序，用于持久化和重连恢复。 */
+    listPersistedWorkspaceIds(): readonly VirtualWorkspaceId[];
+    get(virtualWorkspaceId: VirtualWorkspaceId): VirtualWorkspaceEntry | null;
+    listSessions(virtualWorkspaceId: VirtualWorkspaceId): readonly VirtualSessionEntry[];
+    resolveWorkspace(virtualWorkspaceId: VirtualWorkspaceId): VirtualWorkspaceRef | null;
+    resolveSession(virtualSessionId: VirtualSessionId): VirtualSessionRef | null;
+    /** 将 Workspace 移到 before 之前；before 为 null 表示移动到末尾。 */
+    move(virtualWorkspaceId: VirtualWorkspaceId, beforeVirtualWorkspaceId: VirtualWorkspaceId | null): Promise<readonly VirtualWorkspaceId[]>;
+    persistOrder(): Promise<void>;
+    private reconcileOrder;
+}
+//# sourceMappingURL=peer-host-virtual-registry.d.ts.map

package/data/build/dist/host/modules/peer-host/peer-host-virtual-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-host-virtual-registry.d.ts","sourceRoot":"","sources":["../../../../../../src/host/modules/peer-host/peer-host-virtual-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,wCAAwC,CAAA;AAQ/C,mCAAmC;AACnC,MAAM,WAAW,4BAA4B;IAC3C,IAAI,IAAI,OAAO,CAAC,SAAS,kBAAkB,EAAE,GAAG,uBAAuB,GAAG,IAAI,CAAC,GAAG,SAAS,kBAAkB,EAAE,GAAG,uBAAuB,GAAG,IAAI,CAAA;IAChJ,IAAI,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC3D;AAED,4CAA4C;AAC5C,qBAAa,gCAAiC,YAAW,4BAA4B;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEvC,IAAI,IAAI,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAY/C,IAAI,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;CAM1D;AAED,MAAM,WAAW,qBAAsB,SAAQ,yBAAyB;IACtE,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAA;IAC/C,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAA;CAClC;AAED,MAAM,WAAW,mBAAoB,SAAQ,qBAAqB;IAChE,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAA;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAA;CAClC;AAED,8CAA8C;AAC9C,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuD;IAClF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmD;IAC5E,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,UAAU,CAA0C;gBAEhD,OAAO,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,4BAA4B,CAAA;KAAO;IAKhI,yCAAyC;IACzC,OAAO,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,GAAG,IAAI;IA2BtD,mDAAmD;IAC7C,YAAY,IAAI,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;IAY5D,IAAI,IAAI,SAAS,qBAAqB,EAAE;IAOxC,gBAAgB,IAAI,SAAS,kBAAkB,EAAE;IAIjD,mCAAmC;IACnC,yBAAyB,IAAI,SAAS,kBAAkB,EAAE;IAI1D,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,qBAAqB,GAAG,IAAI;IAIzE,YAAY,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,SAAS,mBAAmB,EAAE;IAWpF,gBAAgB,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,IAAI;IAMpF,cAAc,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,IAAI;IAc5E,sDAAsD;IAChD,IAAI,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;IAYzI,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,OAAO,CAAC,cAAc;CAMvB"}