weaver-e10-builder 1.2.5 → 1.5.2

package/dist/services/org-employee.js

@@ -0,0 +1,400 @@
+/**
+ * 组织架构 — 人员录入（Excel 批量导入）。
+ *
+ * 平台自己解析 Excel，**CLI 只是搬运工** —— 不上传解析结果，只上传**文件本身**。
+ * 所以要读的只有文件字节，不读单元格；预览走 ⑤ 拿平台解析好的结果。
+ *
+ * 完整链路（七步，每步的产出喂给下一步）：
+ *
+ *   ⓪ POST `/api/bs/hrm/emp/edit/importParam`  body `{}`
+ *      → `bizId` + moduleName / functionName / handlerName / serviceName / dataType
+ *      ⚠ 这几项**全部由平台现给**，CLI 一律不硬编码 —— `bizId` 每次调用都重新生成。
+ *
+ *   ① POST `/api/file/preUploadCheck`   (multipart)               → 预上传 id
+ *   ② POST `/api/file/module/upload`    (multipart + preUploadId) → `fileId`
+ *      ⚠ ①② 的 multipart 字段**逐字相同**，② 只多 `preUploadId` 与 `uploadType=common`。
+ *
+ *   ③ POST `/api/ebatch/checkFilePassword`  `{fileId}`
+ *   ④ POST `/api/ebatch/uploadFileId`       `bizId` + `fileId` + `uploadSet` → `taskId`
+ *   ⑤ POST `/api/ebatch/getExcelData`       `?taskId&rerviewNum=N`  → 预览（**不落库**）
+ *   ⑥ POST `/api/ebatch/importExcelData`    `?taskId&...`           → 真正执行
+ *   ⑦ POST `/api/ebatch/getByTaskId`        `?taskId`               → **导入结果**（条数 / 失败原因 / 错误文件）
+ *
+ * ⚠ **返回的嵌套层级三步三样，别想当然**：
+ *   - ① 在 `data.preUploadId`（有的环境是 `data.uploadModuleDto.fileid`，藏在子对象里）
+ *   - ② 在 `data.fileid`（**小写 d**，不是 `fileId`）
+ *   - ③④ 在 `data.data.*`（多一层；④ 的 `taskId` 就在这里）
+ *
+ * ⚠ **⑥ 的响应体只有一个 `true`**，条数不在里面 —— 不补 ⑦ 的话，**整批失败也会显示成「导入已提交」**。
+ *
+ * ⑤ 是**干跑**：走到这里什么都不会落库，所以 `--dry-run` 就停在 ⑤。
+ * ⑤⑥ 的参数全在 query string，body 为空。
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync, statSync } from 'node:fs';
+import { basename } from 'node:path';
+import XLSX from 'xlsx';
+/** 上传的 multipart 字段名 —— ①② 共用这份，② 再补两个。 */
+const MULTIPART_MODULE = 'ebatch';
+/**
+ * 抽 ⓪ 的返回。**抽不到就抛** —— 这几个值是 `bizId` 和 ④ 报文的主体，
+ * 编一个默认值只会在很远的地方以看不懂的方式失败。
+ */
+export function extractImportParam(resp) {
+    const d = resp?.data?.data ?? resp?.data;
+    if (!d || typeof d !== 'object')
+        throw new Error('importParam 返回结构异常（拿不到导入参数）');
+    const pick = (k) => String(d[k] ?? '');
+    const out = {
+        bizId: pick('bizId'),
+        moduleName: pick('moduleName'),
+        functionName: pick('functionName'),
+        handlerName: pick('handlerName'),
+        serviceName: pick('serviceName'),
+        dataType: pick('dataType'),
+    };
+    // bizId / functionName 缺了就进行不下去（④ 的报文主体 + ⑤⑥ 的 query）
+    for (const k of ['bizId', 'functionName']) {
+        if (!out[k])
+            throw new Error(`importParam 未返回 ${k}（该环境可能不支持人员导入）`);
+    }
+    return out;
+}
+/**
+ * 读文件的真实元数据。`md5` 现算（平台会拿它校验文件完整性，编不得）。
+ *
+ * `lastModified` 取文件的 mtime 毫秒数 —— 实测这个值和 `lastModifiedDate` **填同一个数**。
+ */
+export function readFileMeta(filePath) {
+    const buf = readFileSync(filePath);
+    return {
+        name: basename(filePath),
+        size: buf.length,
+        md5: createHash('md5').update(buf).digest('hex'),
+        lastModified: Math.floor(statSync(filePath).mtimeMs),
+    };
+}
+/** 两端点共用的那批字段（顺序照实测：`file` 永远在最后）。 */
+function appendCommonFields(form, meta, employeeId) {
+    form.append('compressImg', 'false');
+    form.append('customParam', JSON.stringify({ employeeId }));
+    form.append('module', MULTIPART_MODULE);
+    form.append('tempFileFlag', 'true');
+    form.append('createDoc', 'false');
+    form.append('tempFileTime', '1');
+    form.append('size', String(meta.size));
+    form.append('name', meta.name);
+    form.append('MD5', meta.md5);
+    form.append('lastModified', String(meta.lastModified));
+    form.append('lastModifiedDate', String(meta.lastModified));
+}
+/** ① 的报文。 */
+export function buildPreUploadForm(meta, employeeId, fileBytes) {
+    const form = new FormData();
+    appendCommonFields(form, meta, employeeId);
+    form.append('file', new Blob([fileBytes]), meta.name);
+    return form;
+}
+/** ② 的报文 = ① + `preUploadId` + `uploadType`。 */
+export function buildUploadForm(meta, employeeId, preUploadId, fileBytes) {
+    const form = new FormData();
+    appendCommonFields(form, meta, employeeId);
+    form.append('preUploadId', preUploadId);
+    form.append('uploadType', 'common');
+    form.append('file', new Blob([fileBytes]), meta.name);
+    return form;
+}
+/**
+ * ① 的返回：预上传 id。
+ *
+ * **同一个端点在不同环境返回的形状不一样** —— 实测 mulinquan 只给 `data.preUploadId`
+ * （`data` 下就三个键：`preUploadId` / `uploadType` / `permissionType`，**没有** `uploadModuleDto`、
+ * 也**没有** `fileid`），而 `data.uploadModuleDto.fileid` 是另一套环境/版本的写法。
+ * 两者语义相同（都是给 ② 当 `preUploadId` 用），所以都认；一个都没有才报错。
+ */
+export function extractPreUploadId(resp) {
+    const id = resp?.data?.preUploadId ?? resp?.data?.uploadModuleDto?.fileid ?? resp?.data?.fileid;
+    if (!id)
+        throw new Error('preUploadCheck 未返回文件 id（data.preUploadId / data.uploadModuleDto.fileid）');
+    return String(id);
+}
+/**
+ * ② 的返回：`data.fileid`（**小写 d**）。
+ *
+ * 这里**只认小写**、不做驼峰回退：平台给的就是 `fileid`（实测），
+ * 加个 `fileId` 的兜底等于替平台猜一个不存在的写法，真出问题时反而更难查。
+ */
+export function extractFileId(resp) {
+    const id = resp?.data?.fileid;
+    if (!id)
+        throw new Error('文件上传未返回 fileid（data.fileid）');
+    return String(id);
+}
+export function resolveUploadSet(opts = {}) {
+    return {
+        importType: String(opts.importType ?? 'add'),
+        empFindField: String(opts.empFindField ?? 'username'),
+        fileType: String(opts.fileType ?? 'xlsx'),
+    };
+}
+/**
+ * ④ 的报文。
+ *
+ * ⚠ `importType` 在报文里出现**两次**：顶层那个是空串、真正生效的在 `uploadSet.customObj` 里。
+ * 看着像冗余，但实测两次都是这样，照抄 —— 别「顺手清理」成一处。
+ */
+export function buildUploadFileIdPayload(param, fileId, set, now) {
+    return {
+        fileId,
+        bizId: param.bizId,
+        moduleName: param.moduleName,
+        functionName: param.functionName,
+        handlerName: param.handlerName,
+        serviceName: param.serviceName,
+        dataType: param.dataType,
+        isStepUpload: true,
+        isChunk: false,
+        chunkNum: 5000,
+        dataSeparator: ',',
+        uploadSet: {
+            requiredVerify: false,
+            defaultfill: false,
+            drillContent: false,
+            enableDataCompute: false,
+            needMergeHead: false,
+            needDetailHeader: false,
+            needmergeheadSheetNum: 1,
+            importType: '',
+            fileType: set.fileType,
+            customObj: { empFindField: set.empFindField, importType: set.importType },
+            uploadFileAsync: false,
+            skipApprove: false,
+        },
+        password: '',
+        validDuration: 1,
+        uploadTime: now,
+    };
+}
+/** ④ 的返回：`data.data.taskId`（**多一层 data**，这里最容易取空）。 */
+export function extractTaskId(resp) {
+    const d = resp?.data?.data ?? resp?.data;
+    const id = d?.taskId ?? d?.id;
+    if (!id)
+        throw new Error('uploadFileId 未返回 taskId（data.data.taskId）');
+    return String(id);
+}
+/** ⑤⑥ 的参数都在 query 上，body 空 —— 两个端点共用这几个。 */
+function queryOf(param, taskId) {
+    return new URLSearchParams({
+        taskId,
+        moduleName: param.moduleName,
+        functionName: param.functionName,
+        sendtotal: '1',
+    });
+}
+/**
+ * ⑤ 预览。
+ *
+ * `rerviewNum` 是**平台把 review 拼错了**，别改成 `reviewNum`（改了就不认）。
+ */
+export function buildGetExcelDataPath(param, taskId, reviewNum = 100) {
+    const q = queryOf(param, taskId);
+    q.set('rerviewNum', String(reviewNum));
+    q.set('needMergeHead', 'false');
+    q.set('needmergeheadSheetNum', '1');
+    q.set('needDetailHeader', 'false');
+    return `/api/ebatch/getExcelData?${q.toString()}`;
+}
+/** ⑥ 执行导入。 */
+export function buildImportExcelDataPath(param, taskId) {
+    return `/api/ebatch/importExcelData?${queryOf(param, taskId).toString()}`;
+}
+/**
+ * 抽 ⑤ 的预览。
+ *
+ * ⚠ `weaTable[0].total` 实测是 **-1**，不能拿来当行数 —— 行数看 `data.length`。
+ * 而且 `rerviewNum` 限了条数，**这里看到的只是前 N 行，不是全部**。
+ */
+export function extractPreview(resp) {
+    const d = resp?.data?.data ?? resp?.data ?? {};
+    const t = Array.isArray(d.weaTable) ? d.weaTable[0] : (d.weaTable ?? {});
+    const columns = Array.isArray(t.columns) ? t.columns.map((c) => String(c?.title ?? '')).filter(Boolean) : [];
+    const rows = Array.isArray(t.data) ? t.data : [];
+    return {
+        fileName: String(d.fileName ?? ''),
+        sheetNames: Array.isArray(d.sheetNames) ? d.sheetNames.map(String) : [],
+        columns,
+        rows,
+    };
+}
+/** ⑥ 之后的进度查询。 */
+export function buildGetByTaskIdPath(taskId) {
+    return `/api/ebatch/getByTaskId?taskId=${encodeURIComponent(taskId)}`;
+}
+/**
+ * 解析任务状态。
+ *
+ * ⚠ `callbackData` 是**一个 JSON 字符串**，要二次解析；里面 `successCount` 是**数字**
+ * （`1`）、`errorCount` 却是**字符串**（`"0"`）—— 同一段 JSON 里类型不一致，两边都过一遍 `Number`。
+ */
+export function parseTaskResult(resp) {
+    const d = resp?.data ?? {};
+    let cb = {};
+    let countsUnknown = true;
+    const raw = d.callbackData;
+    if (typeof raw === 'string' && raw.trim()) {
+        try {
+            cb = JSON.parse(raw);
+            countsUnknown = false;
+        }
+        catch {
+            cb = {};
+        }
+    }
+    else if (raw && typeof raw === 'object') {
+        cb = raw;
+        countsUnknown = false;
+    }
+    return {
+        status: Number(d.status),
+        msg: String(d.msg ?? ''),
+        successCount: Number(cb.successCount ?? 0),
+        errorCount: Number(cb.errorCount ?? 0),
+        errorFileId: String(cb.errorFileId ?? ''),
+        countsUnknown,
+    };
+}
+/**
+ * 任务是否已到终态。
+ *
+ * **判据是 `callbackData` 能不能解出来，不是 `status`。** 踩过的坑：按 `status === 0` 判完成，
+ * 会在任务刚开始那一刻就停 —— 那时 `status: 0`、`msg: 成功`、`callbackData` 还没有，
+ * 几秒后才落成 `-1` + 失败 1 条。**中途值长得像成功，这是最坏的一种**。
+ *
+ * `status === -1` 也直接算终态（明确失败，没必要再等）；此时若条数还取不到，调用方会照实提示。
+ */
+export function isTaskSettled(r) {
+    return !r.countsUnknown || r.status === -1;
+}
+export async function fetchTaskResult(client, baseUrl, taskId) {
+    const r = await client.post(`${baseUrl}${buildGetByTaskIdPath(taskId)}`);
+    if (r?.code !== 200 || r?.status === false)
+        throw new Error(`查询导入任务失败: ${r?.msg || '未知错误'}`);
+    return parseTaskResult(r);
+}
+/**
+ * 轮询到终态。超时返回 `null`（**不编一个成功出来**）—— 调用方据此如实报「还在处理」。
+ */
+export async function waitTaskResult(client, baseUrl, taskId, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? 60_000;
+    const intervalMs = opts.intervalMs ?? 1_000;
+    const deadline = Date.now() + timeoutMs;
+    let last = null;
+    for (;;) {
+        try {
+            last = await fetchTaskResult(client, baseUrl, taskId);
+            if (isTaskSettled(last))
+                return last;
+        }
+        catch {
+            // 单次查询失败不致命：任务在平台侧照跑，继续轮询到超时为止
+        }
+        if (Date.now() >= deadline)
+            return null;
+        await new Promise((r) => setTimeout(r, intervalMs));
+    }
+}
+// ─── 失败数据下载 ───────────────────────────────────────────
+/**
+ * 失败数据的下载地址。
+ *
+ * 这是个**跳转**：平台 302 到对象存储的签名地址，文件真身在那一步。
+ */
+export function buildErrorFileDownloadPath(fileId) {
+    return `/api/file/remotedownload/${encodeURIComponent(fileId)}/token/true?authModule=ebatch`;
+}
+/** 文件名：优先取对象存储那步 `response-content-disposition` 里的，取不到就用兜底名。 */
+export function fileNameFromDisposition(location, fallback) {
+    try {
+        const q = new URL(location).searchParams.get('response-content-disposition') || '';
+        const m = /filename=([^;]+)/i.exec(q);
+        if (m)
+            return decodeURIComponent(m[1].trim());
+    }
+    catch { /* 不是合法 URL 就用兜底 */ }
+    return fallback;
+}
+/**
+ * 下载失败数据。
+ *
+ * 两步走是**故意的**：先带鉴权拿 302，再**不带任何鉴权头**去对象存储取文件。
+ * 直接把 `eteamsid` 跟着跳转发到腾讯云域名上，等于把会话凭证递给第三方主机 —— 哪怕那是租户自己的桶，
+ * 也没有理由发。
+ *
+ * 这里不走 `ApiClient`：它把 302 一律当「会话过期」会去重新登录，而这个 302 是正常业务跳转。
+ */
+export async function downloadErrorFile(baseUrl, fileId, eteamsId) {
+    const first = await fetch(`${baseUrl}${buildErrorFileDownloadPath(fileId)}`, {
+        headers: { eteamsid: eteamsId, langtype: 'zh_CN' },
+        redirect: 'manual',
+    });
+    const fallback = `错误数据_${fileId}.xlsx`;
+    if (first.status >= 300 && first.status < 400) {
+        const location = first.headers.get('location') || '';
+        if (!location)
+            throw new Error(`下载跳转缺少 location（HTTP ${first.status}）`);
+        const second = await fetch(location);
+        if (!second.ok)
+            throw new Error(`从对象存储下载失败: HTTP ${second.status}`);
+        return {
+            bytes: Buffer.from(await second.arrayBuffer()),
+            fileName: fileNameFromDisposition(location, fallback),
+        };
+    }
+    if (!first.ok)
+        throw new Error(`下载失败数据失败: HTTP ${first.status}`);
+    return { bytes: Buffer.from(await first.arrayBuffer()), fileName: fallback };
+}
+function stripHeaderSuffix(title) {
+    return title.replace(/[（(]\s*必填\s*[）)]\s*$/, '').trim();
+}
+/**
+ * 从一个错误 xlsx 的字节里把「哪一格、错在哪」抽出来。
+ *
+ * 批注是**默认就解析**的（挂在 `cell.c`），不用开任何选项 —— 这里刻意不传 `cellComments`，
+ * 那玩意儿在这版类型里没声明，传了编译不过，而它本来也不改变行为。
+ */
+export function parseErrorFileReasons(bytes) {
+    const wb = XLSX.read(bytes);
+    const out = [];
+    for (const sheetName of wb.SheetNames) {
+        const ws = wb.Sheets[sheetName];
+        const ref = ws?.['!ref'];
+        if (!ref)
+            continue;
+        const range = XLSX.utils.decode_range(ref);
+        // 表头固定在第 1 行：批注挂在数据行上，得回头去表头取列名
+        const headers = [];
+        for (let c = range.s.c; c <= range.e.c; c++) {
+            const cell = ws[XLSX.utils.encode_cell({ r: range.s.r, c })];
+            headers[c] = stripHeaderSuffix(String(cell?.v ?? ''));
+        }
+        for (let r = range.s.r + 1; r <= range.e.r; r++) {
+            for (let c = range.s.c; c <= range.e.c; c++) {
+                const cell = ws[XLSX.utils.encode_cell({ r, c })];
+                const note = Array.isArray(cell?.c) ? cell.c.map((x) => String(x?.t ?? '')).filter(Boolean).join(' / ') : '';
+                if (!note)
+                    continue;
+                out.push({
+                    row: r + 1,
+                    column: c + 1,
+                    header: headers[c] || XLSX.utils.encode_col(c),
+                    value: String(cell?.v ?? ''),
+                    reason: note,
+                });
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=org-employee.js.map

package/dist/services/org-employee.js.map

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

package/dist/services/role-member.d.ts

@@ -0,0 +1,99 @@
+/**
+ * 角色成员：人员 / 部门 / 分部。
+ *
+ * 三类走**同一个**保存端点 `/api/bs/auth/role/{roleId}/member/save-or-update`，
+ * 靠 `objType` 选各自的数组键：
+ *
+ *   resource   → obj_resource[]     人员
+ *   department → obj_department[]   部门
+ *   subcompany → obj_subcompany[]   分部
+ *
+ * 成员项**不是「只给 id」** —— 平台要的是「搜索接口返回的那个对象」按各自形状再加工：
+ * 人员带 avatar（来自 `hrmAvatarInfos`，不是搜索结果里那个只有 showName 的 avatar）、
+ * 工号（`jobNum` → `number`）、姓名首字母（`logogram` 首字母大写 → `indexType`）；
+ * 部门/分部带 `icon`、`title`（部门是「部门名|上级路径」）。
+ *
+ * 搜索那一步不在这里 —— 人员走 `getEmployeeByKeyWords`、部门/分部走
+ * `browser/data/{department,subcompany}`，各自形状不同，由调用方负责。
+ */
+/**
+ * 角色成员的对象类型，与平台 `objType` 同值。
+ *
+ * 这几项就是保存报文里 `objectTypeFilter` 白名单中**可以逐个选**的那些：
+ * `resource`(人员) / `department`(部门) / `subcompany`(分部) / `position`(岗位) / `channel`(渠道)。
+ * 白名单里另三项（`all` 全体 / `external` 外部 / `allExternal` 全部外部）**不是逐个选的对象**，
+ * 语义不同，不走这里。
+ *
+ * 搜索接口（`browser/data/{kind}`，人员走 `getEmployeeByKeyWords`）与保存数组
+ * （`obj_{kind}`）都按这个类型名对齐；平台不认的类型会直接 500 `browser not found type`。
+ */
+export type MemberKind = 'resource' | 'department' | 'subcompany' | 'position' | 'channel';
+export declare const MEMBER_KINDS: readonly MemberKind[];
+/** 类型的中文名（错误信息与命令输出用）。 */
+export declare const MEMBER_KIND_LABEL: Record<MemberKind, string>;
+/** 判定用户输入的形状是不是合法成员类型（CLI 侧收窄，比平台报错早）。 */
+export declare function isMemberKind(v: string): v is MemberKind;
+/** 成员类型 → 保存报文里的数组键（`resource` → `obj_resource`）。 */
+export declare function memberArrayKey(kind: MemberKind): string;
+/**
+ * 人员：`getEmployeeByKeyWords` 的返回项 → `obj_resource[]` 的一项。
+ *
+ * 几处**不能想当然**的地方：
+ * - `avatar` 要用 `hrmAvatarInfos`；搜索结果里那个 `avatar` 只有 `{showName}`，结构不对。
+ * - `title` 是**纯名字** —— 早期 CLI 自己拼过「名字|部门」，与平台实际存的不符。
+ * - `department` 留空（平台存的是空串，机构信息另有 `departmentId`）。
+ * - `number`（工号）**不是人人都有**，没有就不发这个键。
+ * - `userid`：搜索接口不返回它，用 `id` 顶上 —— 实测平台落库取的正是 `id`
+ *   （读回 `member/list` 里 `userId === id`）。
+ */
+export declare function buildPersonEntry(emp: any): Record<string, unknown>;
+/**
+ * 部门 / 分部：浏览接口（`browser/data/{department,subcompany}`）的返回项 → `obj_department[]` / `obj_subcompany[]` 的一项。
+ *
+ * 两个返回项字段一致（`id`/`name`/`content`/`title`/`icon`），只有缺省图标不同，
+ * 所以共用一份构造。
+ */
+export declare function buildOrgEntry(raw: any, kind: Exclude<MemberKind, 'resource'>): Record<string, unknown>;
+/** 按类型分发到对应的构造器。 */
+export declare function buildMemberEntry(kind: MemberKind, raw: any): Record<string, unknown>;
+/**
+ * 从搜索结果里挑出目标对象：**精确同名优先**；只有一条结果时用它；否则报错。
+ *
+ * 不取首条 —— 同名或模糊命中时取首条会**静默加错人**，事后只能去角色里一条条翻。
+ */
+export declare function pickExact(list: any[] | undefined, keyword: string, label: string, nameOf: (x: any) => unknown): any;
+export interface MemberSaveOptions {
+    /** 安全级别的可选范围。**随租户配置变**（某租户 0–100、另一个 -999–999），不要当成固定值。 */
+    secMin?: number;
+    secMax?: number;
+    /** 是否启用安全级别校验（同样随租户：有的租户是 true）。 */
+    isSeclevel?: boolean;
+    /** 部门成员的归属属性（`subordinate` 含下属部门 / `partTimeStaff` 含兼职人员）。 */
+    departmentAttribute?: string[];
+}
+/**
+ * 组装 `member/save-or-update` 的报文。
+ *
+ * `objectTypeFilter` 与 `org_permission` 等取平台界面上的固定值；
+ * `objType` 决定哪个数组承载成员。
+ */
+export declare function buildMemberSavePayload(kind: MemberKind, entries: Array<Record<string, unknown>>, opts?: MemberSaveOptions): Record<string, unknown>;
+/** `member/list` 的请求体（分页与筛选都留空 = 取全部）。 */
+export declare function buildMemberListBody(): Record<string, unknown>;
+/** `member/list` 返回里的成员行（只取用得到的字段）。 */
+export interface RoleMemberRow {
+    id: string;
+    object: string;
+    resourceType: string;
+    memberLevel: string;
+    orgPermission: string;
+    userId: string;
+}
+/**
+ * 从 `member/list` 的返回里抽出成员行。
+ *
+ * 返回体里除 `data` 外还夹着表格列定义、按钮权限等一堆东西，**只认 `data` 数组**，
+ * 别去猜别的键（`displayData` 是同一份内容的副本）。
+ */
+export declare function extractMemberRows(response: any): RoleMemberRow[];
+//# sourceMappingURL=role-member.d.ts.map

package/dist/services/role-member.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-member.d.ts","sourceRoot":"","sources":["../../src/services/role-member.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3F,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAE7C,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAMxD,CAAC;AAEF,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,UAAU,CAEvD;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEvD;AAqBD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiClE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAatG;AAED,oBAAoB;AACpB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,OAAO,GACnF,GAAG,CAcL;AAED,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,IAAI,GAAE,iBAAsB,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB;AAED,0CAA0C;AAC1C,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK7D;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,GAAG,GAAG,aAAa,EAAE,CAehE"}