sema-core 1.0.14 → 2.0.1

package/dist/util/color.js

@@ -0,0 +1,247 @@
+"use strict";
+/**
+ * 色彩提取与归一化工具
+ *
+ * 从 Markdown / frontmatter 中嗅探 `Name: color` 形态的 color token，
+ * 支持 #hex (3/4/6/8) 与 rgb()/rgba() 两种写法，统一归一为 6 位（不透明）
+ * 或 8 位 hex（带 alpha），并提供 alpha 合成、亮度计算等 swatch 辅助函数。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractPairsFromFrontmatterColors = extractPairsFromFrontmatterColors;
+exports.extractPairsFromMarkdown = extractPairsFromMarkdown;
+exports.dedupePairs = dedupePairs;
+exports.cleanName = cleanName;
+exports.normalizeColor = normalizeColor;
+exports.normalizeHex = normalizeHex;
+exports.isNeutralHex = isNeutralHex;
+exports.isOpaqueHex = isOpaqueHex;
+exports.compositeOver = compositeOver;
+exports.luminance = luminance;
+const HEX_FRAGMENT = '#[0-9a-fA-F]{3,8}';
+const FUNC_FRAGMENT = 'rgba?\\([^)]*\\)';
+const COLOR_FRAGMENT = `(?:${HEX_FRAGMENT}|${FUNC_FRAGMENT})`;
+/**
+ * 从 frontmatter 中读 colors: 子块，逐行 `key: "#xxx"`。
+ * 通用 YAML 解析器不支持嵌套对象，这里独立实现以支持单层缩进的 colors。
+ */
+function extractPairsFromFrontmatterColors(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!match)
+        return [];
+    const lines = match[1].split(/\r?\n/);
+    const result = [];
+    let inColors = false;
+    let baseIndent = -1;
+    for (const raw of lines) {
+        if (!inColors) {
+            if (/^colors\s*:\s*$/.test(raw.trim())) {
+                inColors = true;
+                baseIndent = -1;
+            }
+            continue;
+        }
+        if (raw.trim() === '')
+            continue;
+        const indent = raw.length - raw.trimStart().length;
+        if (indent === 0)
+            break;
+        if (baseIndent === -1)
+            baseIndent = indent;
+        if (indent < baseIndent)
+            break;
+        const colonIdx = raw.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = raw.slice(0, colonIdx).trim();
+        let value = raw.slice(colonIdx + 1).trim();
+        // 行内注释（保守地按 " #" 切，避免误伤 hex）
+        const commentIdx = value.indexOf(' #');
+        if (commentIdx !== -1 && !/^["'].*["']$/.test(value)) {
+            value = value.slice(0, commentIdx).trim();
+        }
+        // 去包裹引号
+        if (value.length >= 2) {
+            const first = value[0];
+            const last = value[value.length - 1];
+            if ((first === '"' || first === "'") && first === last) {
+                value = value.slice(1, -1);
+            }
+        }
+        const norm = normalizeColor(value);
+        if (key && norm)
+            result.push({ name: cleanName(key), value: norm });
+    }
+    return result;
+}
+/**
+ * 纯 Markdown 颜色嗅探。
+ *   Form A:  - **Name:** `color`
+ *   Form B:  **Name** (`color` …) —— 中间允许 token 占位符；color 必须是 backtick 内的完整色值
+ * color 支持 #hex 与 rgb()/rgba()。要求 backtick 内 strict 等于色值（trim），避免抓
+ * gradient / box-shadow 内的颜色片段。
+ */
+function extractPairsFromMarkdown(content) {
+    const pairs = [];
+    const reA = new RegExp(`\\*\\*([^*\\n]+?):\\*\\*\\s*\`\\s*(${COLOR_FRAGMENT})\\s*\``, 'g');
+    const reB = new RegExp(`\\*\\*([^*\\n]+?)\\*\\*\\s*\\([^*\\n]*?\`\\s*(${COLOR_FRAGMENT})\\s*\``, 'g');
+    for (const re of [reA, reB]) {
+        let m;
+        while ((m = re.exec(content)) !== null) {
+            const norm = normalizeColor(m[2]);
+            if (norm)
+                pairs.push({ name: cleanName(m[1]), value: norm });
+        }
+    }
+    return pairs;
+}
+function dedupePairs(pairs) {
+    const seen = new Set();
+    const out = [];
+    for (const p of pairs) {
+        const k = `${p.name}|${p.value}`;
+        if (seen.has(k))
+            continue;
+        seen.add(k);
+        out.push(p);
+    }
+    return out;
+}
+function cleanName(raw) {
+    return raw.replace(/[*_`]/g, '').replace(/\s+/g, ' ').trim().toLowerCase();
+}
+/** 统一色值入口：识别 #hex / rgb() / rgba()，归一为 #rrggbb 或 #rrggbbaa（小写） */
+function normalizeColor(value) {
+    const v = value.trim();
+    if (v.startsWith('#'))
+        return normalizeHex(v);
+    const m = v.match(/^rgba?\(\s*([^)]*)\)\s*$/i);
+    if (m)
+        return rgbToHex(m[1]);
+    return null;
+}
+function normalizeHex(value) {
+    const m = value.trim().match(/^#([0-9a-fA-F]+)$/);
+    if (!m)
+        return null;
+    let hex = m[1].toLowerCase();
+    if (hex.length === 3 || hex.length === 4) {
+        hex = hex
+            .split('')
+            .map(c => c + c)
+            .join('');
+    }
+    else if (hex.length !== 6 && hex.length !== 8) {
+        return null;
+    }
+    return '#' + hex;
+}
+function rgbToHex(inner) {
+    // 支持逗号、空白、斜杠（CSS Color 4 的 `rgb(R G B / A)` 写法）作分隔
+    const parts = inner.split(/[,/\s]+/).filter(p => p.length > 0);
+    if (parts.length !== 3 && parts.length !== 4)
+        return null;
+    const r = parseChannel(parts[0]);
+    const g = parseChannel(parts[1]);
+    const b = parseChannel(parts[2]);
+    if (r === null || g === null || b === null)
+        return null;
+    const a = parts.length === 4 ? parseAlpha(parts[3]) : 1;
+    if (a === null)
+        return null;
+    const base = '#' + toHex2(r) + toHex2(g) + toHex2(b);
+    if (a >= 0.999)
+        return base;
+    return base + toHex2(Math.round(a * 255));
+}
+function parseChannel(s) {
+    if (s.endsWith('%')) {
+        const v = parseFloat(s.slice(0, -1));
+        if (isNaN(v))
+            return null;
+        return clamp255(Math.round((v / 100) * 255));
+    }
+    const v = parseFloat(s);
+    if (isNaN(v))
+        return null;
+    return clamp255(Math.round(v));
+}
+function parseAlpha(s) {
+    if (s.endsWith('%')) {
+        const v = parseFloat(s.slice(0, -1));
+        if (isNaN(v))
+            return null;
+        return Math.max(0, Math.min(1, v / 100));
+    }
+    const v = parseFloat(s);
+    if (isNaN(v))
+        return null;
+    return Math.max(0, Math.min(1, v));
+}
+function clamp255(n) {
+    return Math.max(0, Math.min(255, n));
+}
+function toHex2(n) {
+    return n.toString(16).padStart(2, '0');
+}
+/**
+ * 判定是否为中性色（接近灰）。兼容 6 位与 8 位 hex；带 alpha 时仅看 RGB 通道，
+ * 不再把 8 位 hex 一律视为非中性。
+ */
+function isNeutralHex(hex) {
+    if (hex.length !== 7 && hex.length !== 9)
+        return false;
+    const r = parseInt(hex.slice(1, 3), 16);
+    const g = parseInt(hex.slice(3, 5), 16);
+    const b = parseInt(hex.slice(5, 7), 16);
+    if ([r, g, b].some(isNaN))
+        return false;
+    return Math.max(r, g, b) - Math.min(r, g, b) < 10;
+}
+/** 是否完全不透明：6 位 hex 或 8 位 hex 末两位为 ff */
+function isOpaqueHex(hex) {
+    if (hex.length === 7)
+        return true;
+    if (hex.length !== 9)
+        return false;
+    return hex.slice(7, 9).toLowerCase() === 'ff';
+}
+/**
+ * 把（可能带 alpha 的）前景色合成到背景上，输出 6 位不透明 hex。
+ * 用于把 rgba token 渲染成 swatch 可见颜色。
+ */
+function compositeOver(fgHex, bgHex) {
+    const fg = parseHexRgba(fgHex);
+    if (!fg)
+        return fgHex;
+    if (fg.a >= 0.999)
+        return '#' + toHex2(fg.r) + toHex2(fg.g) + toHex2(fg.b);
+    const bg = parseHexRgba(bgHex);
+    if (!bg)
+        return '#' + toHex2(fg.r) + toHex2(fg.g) + toHex2(fg.b);
+    const a = fg.a;
+    const r = Math.round(fg.r * a + bg.r * (1 - a));
+    const g = Math.round(fg.g * a + bg.g * (1 - a));
+    const b = Math.round(fg.b * a + bg.b * (1 - a));
+    return '#' + toHex2(r) + toHex2(g) + toHex2(b);
+}
+function parseHexRgba(hex) {
+    if (hex.length !== 7 && hex.length !== 9)
+        return null;
+    const r = parseInt(hex.slice(1, 3), 16);
+    const g = parseInt(hex.slice(3, 5), 16);
+    const b = parseInt(hex.slice(5, 7), 16);
+    if ([r, g, b].some(isNaN))
+        return null;
+    const a = hex.length === 9 ? parseInt(hex.slice(7, 9), 16) / 255 : 1;
+    if (isNaN(a))
+        return null;
+    return { r, g, b, a };
+}
+/** 感知亮度（0~1），用于按亮度排序回退挑色 */
+function luminance(hex) {
+    const parsed = parseHexRgba(hex);
+    if (!parsed)
+        return 0.5;
+    return (0.299 * parsed.r + 0.587 * parsed.g + 0.114 * parsed.b) / 255;
+}
+//# sourceMappingURL=color.js.map

package/dist/util/color.js.map

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

package/dist/util/commands.d.ts

@@ -1,16 +1,15 @@
-export type CommandPrefixResult = {
+export type ExtractedCommandPrefix = {
     commandPrefix: string | null;
     commandInjectionDetected: false;
 } | {
     commandInjectionDetected: true;
 };
-export type CommandSubcommandPrefixResult = CommandPrefixResult & {
-    subcommandPrefixes: Map<string, CommandPrefixResult>;
+export type CommandPrefixWithSubcommands = ExtractedCommandPrefix & {
+    subcommandPrefixes: Map<string, ExtractedCommandPrefix>;
 };
 /**
  * 根据shell操作符将命令字符串拆分为单个命令
  */
 export declare function splitCommand(command: string): string[];
-export declare const getCommandSubcommandPrefix: ((command: string, abortSignal: AbortSignal) => Promise<CommandSubcommandPrefixResult | null>) & import("lodash").MemoizedFunction;
-export declare function isUnsafeCompoundCommand(command: string): boolean;
+export declare function getCommandSubcommandPrefix(command: string, abortSignal: AbortSignal): Promise<CommandPrefixWithSubcommands | null>;
 //# sourceMappingURL=commands.d.ts.map

package/dist/util/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/util/commands.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,mBAAmB,GAC3B;IACE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,wBAAwB,EAAE,KAAK,CAAA;CAChC,GACD;IAAE,wBAAwB,EAAE,IAAI,CAAA;CAAE,CAAA;AAGtC,MAAM,MAAM,6BAA6B,GAAG,mBAAmB,GAAG;IAChE,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;CACrD,CAAA;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAkDtD;AAED,eAAO,MAAM,0BAA0B,aAE1B,MAAM,eACF,WAAW,KACvB,OAAO,CAAC,6BAA6B,GAAG,IAAI,CAAC,qCAYjD,CAAA;AA4JD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEhE"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/util/commands.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,sBAAsB,GAC9B;IACE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,wBAAwB,EAAE,KAAK,CAAA;CAChC,GACD;IAAE,wBAAwB,EAAE,IAAI,CAAA;CAAE,CAAA;AAGtC,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG;IAClE,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;CACxD,CAAA;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAiDtD;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAU9C"}

package/dist/util/commands.js

@@ -1,24 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCommandSubcommandPrefix = void 0;
 exports.splitCommand = splitCommand;
-exports.isUnsafeCompoundCommand = isUnsafeCompoundCommand;
-const lodash_es_1 = require("lodash-es");
+exports.getCommandSubcommandPrefix = getCommandSubcommandPrefix;
 const shell_quote_1 = require("shell-quote");
 const queryLLM_1 = require("../services/api/queryLLM");
-const message_1 = require("../constants/message");
-const SINGLE_QUOTE = '__SINGLE_QUOTE__';
-const DOUBLE_QUOTE = '__DOUBLE_QUOTE__';
+const message_1 = require("./message");
+const commands_1 = require("../prompt/commands");
+const SQ_PLACEHOLDER = '__SQ_PLACEHOLDER__';
+const DQ_PLACEHOLDER = '__DQ_PLACEHOLDER__';
 /**
  * 根据shell操作符将命令字符串拆分为单个命令
  */
 function splitCommand(command) {
     const parts = [];
     // 1. 合并相邻的字符串
-    // 为引号添加特殊标记，防止后续解析时被误处理
     for (const part of (0, shell_quote_1.parse)(command
-        .replaceAll('"', `"${DOUBLE_QUOTE}`)
-        .replaceAll("'", `'${SINGLE_QUOTE}`), varName => `$${varName}`)) {
+        .replaceAll('"', `"${DQ_PLACEHOLDER}`)
+        .replaceAll("'", `'${SQ_PLACEHOLDER}`), varName => `$${varName}`)) {
         if (typeof part === 'string') {
             if (parts.length > 0 && typeof parts[parts.length - 1] === 'string') {
                 parts[parts.length - 1] += ' ' + part;
@@ -42,19 +40,19 @@ function splitCommand(command) {
         if ('op' in part) {
             return part.op;
         }
-        return null;
+        return undefined;
     })
-        .filter(_ => _ !== null);
+        .filter((part) => part !== undefined);
     // 3. 将引号映射回原始形式
     const quotedParts = stringParts.map(part => {
         return part
-            .replaceAll(`${SINGLE_QUOTE}`, "'")
-            .replaceAll(`${DOUBLE_QUOTE}`, '"');
+            .replaceAll(`${SQ_PLACEHOLDER}`, "'")
+            .replaceAll(`${DQ_PLACEHOLDER}`, '"');
     });
     // 4. 过滤掉分隔符
-    return quotedParts.filter(part => !COMMAND_LIST_SEPARATORS.has(part));
+    return quotedParts.filter(part => !SHELL_LIST_SEPARATORS.has(part));
 }
-exports.getCommandSubcommandPrefix = (0, lodash_es_1.memoize)(async (command, abortSignal) => {
+async function getCommandSubcommandPrefix(command, abortSignal) {
     const fullCommandPrefix = await getCommandPrefix(command, abortSignal);
     if (!fullCommandPrefix) {
         return null;
@@ -63,72 +61,18 @@ exports.getCommandSubcommandPrefix = (0, lodash_es_1.memoize)(async (command, ab
         ...fullCommandPrefix,
         subcommandPrefixes: new Map(),
     };
-}, command => command);
-const getCommandPrefix = (0, lodash_es_1.memoize)(async (command, abortSignal) => {
+}
+async function getCommandPrefix(command, abortSignal) {
     let response;
     try {
         response = await (0, queryLLM_1.queryQuick)({
             systemPrompt: [
                 {
                     type: 'text',
-                    text: `Your task is to process Bash commands that an AI coding agent wants to run.
-
-This policy spec defines how to determine the prefix of a Bash command:`
+                    text: commands_1.COMMAND_PREFIX_SYSTEM_PROMPT
                 }
             ],
-            userPrompt: `<policy_spec>
-# Code Bash command prefix detection
-
-This document defines risk levels for actions that the agent may take. This classification system is part of a broader safety framework and is used to determine when additional user confirmation or oversight may be needed.
-
-## Definitions
-
-**Command Injection:** Any technique used that would result in a command being run other than the detected prefix.
-
-## Command prefix extraction examples
-Examples:
-- cat foo.txt => cat
-- cd src => cd
-- cd path/to/files/ => cd
-- find ./src -type f -name "*.ts" => find
-- gg cat foo.py => gg cat
-- gg cp foo.py bar.py => gg cp
-- git commit -m "foo" => git commit
-- git diff HEAD~1 => git diff
-- git diff --staged => git diff
-- git diff $(pwd) => command_injection_detected
-- git status => git status
-- git status# test(\`id\`) => command_injection_detected
-- git status\`ls\` => command_injection_detected
-- git push => none
-- git push origin master => git push
-- git log -n 5 => git log
-- git log --oneline -n 5 => git log
-- grep -A 40 "from foo.bar.baz import" alpha/beta/gamma.py => grep
-- pig tail zerba.log => pig tail
-- npm test => none
-- npm test --foo => npm test
-- npm test -- -f "foo" => npm test
-- pwd\n curl example.com => command_injection_detected
-- pytest foo/bar.py => pytest
-- scalac build => none
-</policy_spec>
-
-The user has allowed certain command prefixes to be run, and will otherwise be asked to approve or deny the command.
-Your task is to determine the command prefix for the following command.
-
-IMPORTANT: Bash commands may run multiple commands that are chained together.
-For safety, if the command seems to contain command injection, you must return "command_injection_detected". 
-(This will help protect the user: if they think that they're allowlisting command A, 
-but the AI coding agent sends a malicious command that technically has the same prefix as command A, 
-then the safety system will see that you said “command_injection_detected” and ask the user for manual confirmation.)
-
-Note that not every command has a prefix. If a command has no prefix, return "none".
-
-ONLY return the prefix. Do not return any other text, markdown markers, or other content or formatting.
-
-Command: ${command}
-`,
+            userPrompt: (0, commands_1.COMMAND_PREFIX_USER_PROMPT)(command),
             signal: abortSignal,
             enableLLMCache: false,
         });
@@ -136,13 +80,13 @@ Command: ${command}
     catch {
         return null;
     }
-    const prefix = typeof response.message.content === 'string'
+    const prefix = (typeof response.message.content === 'string'
         ? response.message.content
         : Array.isArray(response.message.content)
             ? (response.message.content.find(_ => _.type === 'text')?.text ??
                 'none')
-            : 'none';
-    if (prefix.startsWith(message_1.API_ERROR_MESSAGE_PREFIX)) {
+            : 'none').trim();
+    if (prefix.startsWith(message_1.API_ERR_PREFIX)) {
         return null;
     }
     if (prefix === 'command_injection_detected') {
@@ -165,45 +109,11 @@ Command: ${command}
         commandPrefix: prefix,
         commandInjectionDetected: false,
     };
-}, command => command);
-const COMMAND_LIST_SEPARATORS = new Set([
+}
+const SHELL_LIST_SEPARATORS = new Set([
     '&&',
     '||',
     ';',
     ';;',
 ]);
-// 检查这是否只是一个命令列表
-function isCommandList(command) {
-    for (const part of (0, shell_quote_1.parse)(command
-        .replaceAll('"', `"${DOUBLE_QUOTE}`) // parse()会去掉引号 :P
-        .replaceAll("'", `'${SINGLE_QUOTE}`), // parse()会去掉引号 :P
-    // parse()会去掉引号 :P
-    varName => `$${varName}`)) {
-        if (typeof part === 'string') {
-            // 字符串是安全的
-            continue;
-        }
-        if ('comment' in part) {
-            // 不信任注释，它们可能包含命令注入
-            return false;
-        }
-        if ('op' in part) {
-            if (part.op === 'glob') {
-                // 通配符是安全的
-                continue;
-            }
-            else if (COMMAND_LIST_SEPARATORS.has(part.op)) {
-                // 命令列表分隔符是安全的
-                continue;
-            }
-            // 其他操作符不安全
-            return false;
-        }
-    }
-    // 在整个命令中未找到不安全的操作符
-    return true;
-}
-function isUnsafeCompoundCommand(command) {
-    return splitCommand(command).length > 1 && !isCommandList(command);
-}
 //# sourceMappingURL=commands.js.map

package/dist/util/commands.js.map

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

package/dist/util/compact.d.ts

@@ -1,11 +1,14 @@
 import { Message } from '../types/message';
 import { Tool } from '../tools/base/Tool';
+/**
+ * 基于主模型能力计算上下文使用阈值
+ * 采用主模型上下文长度作为基准，因为压缩任务需要由性能足够的模型处理
+ */
 /**
  * 根据令牌使用量判断是否应触发自动压缩
- * 采用主模型上下文限制作为判断基准，因为压缩任务需要性能足够的模型处理
  * 只计算输入token数，因为API调用时主要关心的是输入token限制
  */
-export declare function shouldAutoCompact(messages: Message[]): Promise<boolean>;
+export declare function needsAutoCompact(messages: Message[]): boolean;
 /**
  * 执行上下文压缩（公开接口）
  *
@@ -18,7 +21,7 @@ export declare function shouldAutoCompact(messages: Message[]): Promise<boolean>
  * - 确保系统在各种异常情况下都能保持功能正常
  * - 提供多层降级方案以避免完全失败
  */
-export declare function compactMessages(messages: Message[], abortController: AbortController): Promise<Message[]>;
+export declare function compactMessages(messages: Message[], abortController: AbortController, sessionId?: string): Promise<Message[]>;
 /**
  * 自动上下文压缩的主要入口函数
  *
@@ -29,9 +32,9 @@ export declare function compactMessages(messages: Message[], abortController: Ab
  * 1. 压缩后的消息列表以用户消息结尾，LLM 调用不会失败
  * 2. tool_use / tool_result 的配对关系不被破坏
  *
- * 执行自动压缩（调用前应先通过 shouldAutoCompact 判断是否需要压缩）
+ * 执行自动压缩（调用前应先通过 needsAutoCompact 判断是否需要压缩）
  */
-export declare function autoCompact(messages: Message[], abortController: AbortController): Promise<Message[]>;
+export declare function autoCompact(messages: Message[], abortController: AbortController, sessionId?: string): Promise<Message[]>;
 /**
  * Null Tool - 用于占位避免工具调用
  * 在某些场景下（如压缩），模型必须提供 tools 参数，但我们不希望模型调用任何工具

package/dist/util/compact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../src/util/compact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAQ1C,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAmQzC;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAU7E;AAGD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,OAAO,EAAE,EACnB,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC,OAAO,EAAE,CAAC,CA8CpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,OAAO,EAAE,EACnB,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC,OAAO,EAAE,CAAC,CAgDpB;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,IASvB,CAAA"}
+{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../src/util/compact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAQ1C,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AA6HzC;;;GAGG;AACH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAO7D;AAGD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,OAAO,EAAE,EACnB,eAAe,EAAE,eAAe,EAChC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,EAAE,CAAC,CA8CpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,OAAO,EAAE,EACnB,eAAe,EAAE,eAAe,EAChC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,EAAE,CAAC,CAgDpB;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,IASvB,CAAA"}