@jsbot-tellus/core 2.5.0 → 2.6.0

package/dist/core/plugin/params/declaration.js

@@ -0,0 +1,286 @@
+import { declarationError, } from './types.js';
+import { measureLength, parseBoolean, parseTimeValue, unquote, } from './values.js';
+const NAME_PATTERN = /^[\p{L}_][\p{L}\p{N}_-]*$/u;
+const LENGTH_PATTERN = /^(\d*)\.\.(\d*)$/;
+export function parseType(value) {
+    switch (value) {
+        case 'string':
+        case 'text':
+        case 'number':
+        case 'integer':
+        case 'boolean':
+        case 'at':
+        case 'reply':
+        case 'time':
+            return value;
+        default:
+            throw declarationError(`未知的参数类型 "${value}"`);
+    }
+}
+function parseLengthNumber(raw, token) {
+    const value = Number(raw);
+    if (!Number.isSafeInteger(value)) {
+        throw declarationError(`长度限制不是安全的整数：${token}`);
+    }
+    return value;
+}
+function parseLength(raw, token) {
+    const value = raw.trim();
+    const match = LENGTH_PATTERN.exec(value);
+    if (!match) {
+        throw declarationError(`非法的长度限制 "${raw}"：${token}`);
+    }
+    const minRaw = match[1] ?? '';
+    const maxRaw = match[2] ?? '';
+    if (minRaw === '' && maxRaw === '') {
+        throw declarationError(`长度限制不能为空：${token}`);
+    }
+    const min = minRaw === '' ? undefined : parseLengthNumber(minRaw, token);
+    const max = maxRaw === '' ? undefined : parseLengthNumber(maxRaw, token);
+    if (min !== undefined && max !== undefined && min > max) {
+        throw declarationError(`长度下限不能大于上限：${token}`);
+    }
+    return { min, max };
+}
+function parseTypeDeclaration(raw, token) {
+    const value = raw.trim();
+    const open = value.indexOf('(');
+    if (open < 0) {
+        return { type: parseType(value) };
+    }
+    if (!value.endsWith(')')) {
+        throw declarationError(`非法的参数声明 "${token}"`);
+    }
+    const type = parseType(value.slice(0, open).trim());
+    const length = parseLength(value.slice(open + 1, -1), token);
+    if (type !== 'string' && type !== 'text') {
+        throw declarationError(`只有 string/text 参数支持长度限制：${token}`);
+    }
+    return { type, length };
+}
+function validateDefaultLength(name, value, length) {
+    if (length === undefined)
+        return;
+    const measured = measureLength(value);
+    if (length.min !== undefined && measured < length.min) {
+        throw declarationError(`参数 ${name} 的默认值至少需要 ${length.min} 个字符`);
+    }
+    if (length.max !== undefined && measured > length.max) {
+        throw declarationError(`参数 ${name} 的默认值不能超过 ${length.max} 个字符`);
+    }
+}
+export function validateName(value) {
+    const name = value.trim();
+    if (!name) {
+        throw declarationError('参数名不能为空');
+    }
+    if (!NAME_PATTERN.test(name)) {
+        throw declarationError(`非法的参数名 "${name}"`);
+    }
+    return name;
+}
+export function splitDeclaration(input) {
+    const parts = [];
+    let index = 0;
+    while (index < input.length) {
+        const char = input[index];
+        if (char === undefined)
+            break;
+        if (/\s/.test(char)) {
+            index += 1;
+            continue;
+        }
+        if (char !== '<' && char !== '[') {
+            throw declarationError(`无法识别的字符 "${char}"`);
+        }
+        const close = char === '<' ? '>' : ']';
+        let end = index + 1;
+        let quote = null;
+        for (; end < input.length; end += 1) {
+            const current = input[end];
+            if (current === undefined)
+                break;
+            if (quote !== null) {
+                if (current === '\\') {
+                    end += 1;
+                    continue;
+                }
+                if (current === quote) {
+                    quote = null;
+                }
+                continue;
+            }
+            if (current === '"' || current === "'") {
+                quote = current;
+                continue;
+            }
+            if (current === close)
+                break;
+        }
+        if (end >= input.length || input[end] !== close) {
+            throw declarationError(`参数 "${input.slice(index)}" 缺少 ${close}`);
+        }
+        parts.push(input.slice(index, end + 1));
+        index = end + 1;
+    }
+    return parts;
+}
+export function parseToken(token) {
+    const open = token[0];
+    const close = token[token.length - 1];
+    if ((open !== '<' && open !== '[') ||
+        (close !== '>' && close !== ']') ||
+        (open === '<') !== (close === '>')) {
+        throw declarationError(`非法的参数声明 "${token}"`);
+    }
+    const required = open === '<';
+    const inner = token.slice(1, -1).trim();
+    if (!inner) {
+        throw declarationError('参数名不能为空');
+    }
+    if (inner.startsWith('...')) {
+        if (required) {
+            throw declarationError('变长参数必须使用 [ ]');
+        }
+        const rest = inner.slice(3);
+        if (rest.includes('(')) {
+            throw declarationError(`变长参数不支持长度限制：${token}`);
+        }
+        const name = validateName(rest);
+        return {
+            name,
+            type: 'string',
+            required: false,
+            rest: true,
+            hasDefault: false,
+        };
+    }
+    if (inner.includes('...')) {
+        throw declarationError(`非法的参数声明 "${token}"`);
+    }
+    const equals = inner.indexOf('=');
+    const head = equals >= 0 ? inner.slice(0, equals).trim() : inner.trim();
+    const defaultRaw = equals >= 0 ? inner.slice(equals + 1).trim() : undefined;
+    const colon = head.indexOf(':');
+    const name = validateName(colon >= 0 ? head.slice(0, colon) : head);
+    const { type, length } = parseTypeDeclaration(colon >= 0 ? head.slice(colon + 1) : 'string', token);
+    if (required && defaultRaw !== undefined) {
+        throw declarationError(`必填参数不能有默认值：${token}`);
+    }
+    if (defaultRaw !== undefined) {
+        const defaultValue = parseDefaultValue(type, defaultRaw, name);
+        if (typeof defaultValue === 'string') {
+            validateDefaultLength(name, defaultValue, length);
+        }
+        return {
+            name,
+            type,
+            required,
+            rest: false,
+            hasDefault: true,
+            defaultValue,
+            length,
+        };
+    }
+    return {
+        name,
+        type,
+        required,
+        rest: false,
+        hasDefault: false,
+        length,
+    };
+}
+export function validateSpecs(specs) {
+    const names = new Set();
+    let seenOptional = false;
+    let seenRest = false;
+    let seenText = false;
+    for (let index = 0; index < specs.length; index += 1) {
+        const spec = specs[index];
+        if (!spec)
+            continue;
+        if (names.has(spec.name)) {
+            throw declarationError(`参数名重复 "${spec.name}"`);
+        }
+        names.add(spec.name);
+        if (seenRest) {
+            throw declarationError('变长参数后面不能再有参数');
+        }
+        if (seenText) {
+            throw declarationError('文本参数后面不能再有参数');
+        }
+        if (spec.rest) {
+            if (index !== specs.length - 1) {
+                throw declarationError('变长参数必须放在最后');
+            }
+            seenRest = true;
+            continue;
+        }
+        if (spec.type === 'text') {
+            if (index !== specs.length - 1) {
+                throw declarationError('文本参数必须放在最后');
+            }
+            seenText = true;
+        }
+        if (spec.required) {
+            if (seenOptional) {
+                throw declarationError('必填参数不能出现在可选参数后面');
+            }
+        }
+        else {
+            seenOptional = true;
+        }
+    }
+}
+export function usageOf(specs) {
+    return specs
+        .map((spec) => {
+        if (spec.rest) {
+            return `[...${spec.name}]`;
+        }
+        const name = spec.type === 'text' ? `${spec.name}...` : spec.name;
+        return spec.required ? `<${name}>` : `[${name}]`;
+    })
+        .join(' ');
+}
+export function parseDefaultValue(type, raw, name) {
+    const value = unquote(raw);
+    switch (type) {
+        case 'string':
+        case 'text':
+            return value;
+        case 'number': {
+            const number = value.trim() === '' ? Number.NaN : Number(value);
+            if (!Number.isFinite(number)) {
+                throw declarationError(`参数 ${name} 的默认值不是数字`);
+            }
+            return number;
+        }
+        case 'integer': {
+            const number = value.trim() === '' ? Number.NaN : Number(value);
+            if (!Number.isInteger(number)) {
+                throw declarationError(`参数 ${name} 的默认值不是整数`);
+            }
+            return number;
+        }
+        case 'boolean': {
+            const boolean = parseBoolean(value);
+            if (boolean === null) {
+                throw declarationError(`参数 ${name} 的默认值不是布尔值`);
+            }
+            return boolean;
+        }
+        case 'at':
+        case 'reply':
+            throw declarationError(`参数 ${name} 不支持默认值`);
+        case 'time': {
+            const seconds = parseTimeValue(value);
+            if (seconds === null) {
+                throw declarationError(`参数 ${name} 的默认值不是时间`);
+            }
+            return seconds;
+        }
+    }
+}
+//# sourceMappingURL=declaration.js.map

package/dist/core/plugin/params/declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.js","sourceRoot":"","sources":["../../../../src/core/plugin/params/declaration.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,gBAAgB,GAInB,MAAM,YAAY,CAAA;AACnB,OAAO,EACH,aAAa,EACb,YAAY,EACZ,cAAc,EACd,OAAO,GACV,MAAM,aAAa,CAAA;AAEpB,MAAM,YAAY,GAAG,4BAA4B,CAAA;AACjD,MAAM,cAAc,GAAG,kBAAkB,CAAA;AAEzC,MAAM,UAAU,SAAS,CAAC,KAAa;IACnC,QAAQ,KAAK,EAAE,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,SAAS,CAAC;QACf,KAAK,IAAI,CAAC;QACV,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACP,OAAO,KAAK,CAAA;QAChB;YACI,MAAM,gBAAgB,CAAC,YAAY,KAAK,GAAG,CAAC,CAAA;IACpD,CAAC;AACL,CAAC;AAOD,SAAS,iBAAiB,CAAC,GAAW,EAAE,KAAa;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IAEzB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,gBAAgB,CAAC,eAAe,KAAK,EAAE,CAAC,CAAA;IAClD,CAAC;IAED,OAAO,KAAK,CAAA;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,GAAW,EAAE,KAAa;IAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IACxB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAExC,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,gBAAgB,CAAC,YAAY,GAAG,KAAK,KAAK,EAAE,CAAC,CAAA;IACvD,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAE7B,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QACjC,MAAM,gBAAgB,CAAC,YAAY,KAAK,EAAE,CAAC,CAAA;IAC/C,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACxE,MAAM,GAAG,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAExE,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACtD,MAAM,gBAAgB,CAAC,cAAc,KAAK,EAAE,CAAC,CAAA;IACjD,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;AACvB,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAW,EAAE,KAAa;IACpD,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IACxB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAE/B,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAA;IACrC,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,gBAAgB,CAAC,YAAY,KAAK,GAAG,CAAC,CAAA;IAChD,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACnD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IAE5D,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACvC,MAAM,gBAAgB,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAA;IAC9D,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AAC3B,CAAC;AAED,SAAS,qBAAqB,CAC1B,IAAY,EACZ,KAAa,EACb,MAA+B;IAE/B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAM;IAEhC,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IAErC,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,QAAQ,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;QACpD,MAAM,gBAAgB,CAClB,MAAM,IAAI,aAAa,MAAM,CAAC,GAAG,MAAM,CAC1C,CAAA;IACL,CAAC;IAED,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,QAAQ,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;QACpD,MAAM,gBAAgB,CAClB,MAAM,IAAI,aAAa,MAAM,CAAC,GAAG,MAAM,CAC1C,CAAA;IACL,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACtC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAEzB,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACrC,CAAC;IAED,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,gBAAgB,CAAC,WAAW,IAAI,GAAG,CAAC,CAAA;IAC9C,CAAC;IAED,OAAO,IAAI,CAAA;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;QAEzB,IAAI,IAAI,KAAK,SAAS;YAAE,MAAK;QAE7B,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClB,KAAK,IAAI,CAAC,CAAA;YACV,SAAQ;QACZ,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAC/B,MAAM,gBAAgB,CAAC,YAAY,IAAI,GAAG,CAAC,CAAA;QAC/C,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;QACtC,IAAI,GAAG,GAAG,KAAK,GAAG,CAAC,CAAA;QACnB,IAAI,KAAK,GAAkB,IAAI,CAAA;QAE/B,OAAO,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;YAE1B,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAK;YAEhC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjB,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;oBACnB,GAAG,IAAI,CAAC,CAAA;oBACR,SAAQ;gBACZ,CAAC;gBAED,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;oBACpB,KAAK,GAAG,IAAI,CAAA;gBAChB,CAAC;gBAED,SAAQ;YACZ,CAAC;YAED,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;gBACrC,KAAK,GAAG,OAAO,CAAA;gBACf,SAAQ;YACZ,CAAC;YAED,IAAI,OAAO,KAAK,KAAK;gBAAE,MAAK;QAChC,CAAC;QAED,IAAI,GAAG,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;YAC9C,MAAM,gBAAgB,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAA;QACpE,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;QACvC,KAAK,GAAG,GAAG,GAAG,CAAC,CAAA;IACnB,CAAC;IAED,OAAO,KAAK,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACpC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACrB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAErC,IACI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC;QAC9B,CAAC,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC;QAChC,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,GAAG,CAAC,EACpC,CAAC;QACC,MAAM,gBAAgB,CAAC,YAAY,KAAK,GAAG,CAAC,CAAA;IAChD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,KAAK,GAAG,CAAA;IAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAEvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACrC,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,IAAI,QAAQ,EAAE,CAAC;YACX,MAAM,gBAAgB,CAAC,cAAc,CAAC,CAAA;QAC1C,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QAE3B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,gBAAgB,CAAC,eAAe,KAAK,EAAE,CAAC,CAAA;QAClD,CAAC;QAED,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAE/B,OAAO;YACH,IAAI;YACJ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,IAAI;YACV,UAAU,EAAE,KAAK;SACpB,CAAA;IACL,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,gBAAgB,CAAC,YAAY,KAAK,GAAG,CAAC,CAAA;IAChD,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;IACvE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC/B,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACnE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,oBAAoB,CACzC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAC7C,KAAK,CACR,CAAA;IAED,IAAI,QAAQ,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,gBAAgB,CAAC,cAAc,KAAK,EAAE,CAAC,CAAA;IACjD,CAAC;IAED,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,CAAA;QAE9D,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACnC,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,CAAA;QACrD,CAAC;QAED,OAAO;YACH,IAAI;YACJ,IAAI;YACJ,QAAQ;YACR,IAAI,EAAE,KAAK;YACX,UAAU,EAAE,IAAI;YAChB,YAAY;YACZ,MAAM;SACT,CAAA;IACL,CAAC;IAED,OAAO;QACH,IAAI;QACJ,IAAI;QACJ,QAAQ;QACR,IAAI,EAAE,KAAK;QACX,UAAU,EAAE,KAAK;QACjB,MAAM;KACT,CAAA;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC5C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,IAAI,QAAQ,GAAG,KAAK,CAAA;IAEpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;QAEzB,IAAI,CAAC,IAAI;YAAE,SAAQ;QAEnB,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,gBAAgB,CAAC,UAAU,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;QAClD,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEpB,IAAI,QAAQ,EAAE,CAAC;YACX,MAAM,gBAAgB,CAAC,cAAc,CAAC,CAAA;QAC1C,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACX,MAAM,gBAAgB,CAAC,cAAc,CAAC,CAAA;QAC1C,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,gBAAgB,CAAC,YAAY,CAAC,CAAA;YACxC,CAAC;YAED,QAAQ,GAAG,IAAI,CAAA;YACf,SAAQ;QACZ,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACvB,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,gBAAgB,CAAC,YAAY,CAAC,CAAA;YACxC,CAAC;YAED,QAAQ,GAAG,IAAI,CAAA;QACnB,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,IAAI,YAAY,EAAE,CAAC;gBACf,MAAM,gBAAgB,CAAC,iBAAiB,CAAC,CAAA;YAC7C,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,YAAY,GAAG,IAAI,CAAA;QACvB,CAAC;IACL,CAAC;AACL,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAkB;IACtC,OAAO,KAAK;SACP,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACV,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO,OAAO,IAAI,CAAC,IAAI,GAAG,CAAA;QAC9B,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAA;QAEjE,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAA;IACpD,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC7B,IAAsB,EACtB,GAAW,EACX,IAAY;IAEZ,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAE1B,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM;YACP,OAAO,KAAK,CAAA;QAChB,KAAK,QAAQ,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAE/D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,MAAM,gBAAgB,CAAC,MAAM,IAAI,WAAW,CAAC,CAAA;YACjD,CAAC;YAED,OAAO,MAAM,CAAA;QACjB,CAAC;QACD,KAAK,SAAS,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAE/D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,MAAM,gBAAgB,CAAC,MAAM,IAAI,WAAW,CAAC,CAAA;YACjD,CAAC;YAED,OAAO,MAAM,CAAA;QACjB,CAAC;QACD,KAAK,SAAS,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;YAEnC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,gBAAgB,CAAC,MAAM,IAAI,YAAY,CAAC,CAAA;YAClD,CAAC;YAED,OAAO,OAAO,CAAA;QAClB,CAAC;QACD,KAAK,IAAI,CAAC;QACV,KAAK,OAAO;YACR,MAAM,gBAAgB,CAAC,MAAM,IAAI,SAAS,CAAC,CAAA;QAC/C,KAAK,MAAM,EAAE,CAAC;YACV,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;YAErC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,gBAAgB,CAAC,MAAM,IAAI,WAAW,CAAC,CAAA;YACjD,CAAC;YAED,OAAO,OAAO,CAAA;QAClB,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/core/plugin/params/input.d.ts

@@ -0,0 +1,5 @@
+import { type InputToken, type ParamSpec, type ParsedCommandParams } from './types.js';
+export declare function tokenizeInput(input: string, usage: string): InputToken[];
+export declare function parseValue(spec: ParamSpec, raw: string, usage: string): unknown;
+export declare function parseInput(specs: ParamSpec[], input: string, usage: string, quoteId: number | undefined): ParsedCommandParams;
+//# sourceMappingURL=input.d.ts.map

package/dist/core/plugin/params/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../src/core/plugin/params/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,mBAAmB,EAC3B,MAAM,YAAY,CAAA;AAGnB,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CA6FxE;AA4BD,wBAAgB,UAAU,CACtB,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACd,OAAO,CA+CT;AAED,wBAAgB,UAAU,CACtB,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,SAAS,GAC5B,mBAAmB,CA6FrB"}

package/dist/core/plugin/params/input.js

@@ -0,0 +1,196 @@
+import { CommandParamsError, } from './types.js';
+import { measureLength, parseAt, parseBoolean, parseTime } from './values.js';
+export function tokenizeInput(input, usage) {
+    const tokens = [];
+    let index = 0;
+    while (index < input.length) {
+        const char = input[index];
+        if (char === undefined)
+            break;
+        if (/\s/.test(char)) {
+            index += 1;
+            continue;
+        }
+        const start = index;
+        let value = '';
+        let quote = null;
+        while (index < input.length) {
+            const current = input[index];
+            if (current === undefined)
+                break;
+            if (quote !== null) {
+                if (current === '\\') {
+                    const next = input[index + 1];
+                    if (next !== undefined) {
+                        value += next;
+                        index += 2;
+                        continue;
+                    }
+                    value += current;
+                    index += 1;
+                    continue;
+                }
+                if (current === quote) {
+                    quote = null;
+                    index += 1;
+                    continue;
+                }
+                value += current;
+                index += 1;
+                continue;
+            }
+            if (/\s/.test(current))
+                break;
+            if (current === '[' && input.startsWith('[CQ:', index)) {
+                const close = input.indexOf(']', index + 4);
+                if (close >= 0) {
+                    value += input.slice(index, close + 1);
+                    index = close + 1;
+                    continue;
+                }
+            }
+            if (current === '"' || current === "'") {
+                quote = current;
+                index += 1;
+                continue;
+            }
+            if (current === '\\') {
+                const next = input[index + 1];
+                if (next !== undefined) {
+                    value += next;
+                    index += 2;
+                    continue;
+                }
+                value += current;
+                index += 1;
+                continue;
+            }
+            value += current;
+            index += 1;
+        }
+        if (quote !== null) {
+            throw new CommandParamsError('参数引号未闭合', usage);
+        }
+        tokens.push({ value, start });
+    }
+    return tokens;
+}
+function enforceLength(spec, value, usage) {
+    const length = spec.length;
+    if (length === undefined) {
+        return value;
+    }
+    const measured = measureLength(value);
+    if (length.min !== undefined && measured < length.min) {
+        throw new CommandParamsError(`参数 ${spec.name} 至少需要 ${length.min} 个字符`, usage);
+    }
+    if (length.max !== undefined && measured > length.max) {
+        throw new CommandParamsError(`参数 ${spec.name} 不能超过 ${length.max} 个字符`, usage);
+    }
+    return value;
+}
+export function parseValue(spec, raw, usage) {
+    switch (spec.type) {
+        case 'string':
+            return enforceLength(spec, raw, usage);
+        case 'text':
+            return raw;
+        case 'number': {
+            const value = raw.trim() === '' ? Number.NaN : Number(raw);
+            if (!Number.isFinite(value)) {
+                throw new CommandParamsError(`参数 ${spec.name} 需要是数字`, usage);
+            }
+            return value;
+        }
+        case 'integer': {
+            const value = raw.trim() === '' ? Number.NaN : Number(raw);
+            if (!Number.isInteger(value)) {
+                throw new CommandParamsError(`参数 ${spec.name} 需要是整数`, usage);
+            }
+            return value;
+        }
+        case 'boolean': {
+            const value = parseBoolean(raw);
+            if (value === null) {
+                throw new CommandParamsError(`参数 ${spec.name} 需要是布尔值`, usage);
+            }
+            return value;
+        }
+        case 'at':
+            return parseAt(raw, spec.name, usage);
+        case 'time':
+            return parseTime(raw, spec.name, usage);
+    }
+}
+export function parseInput(specs, input, usage, quoteId) {
+    const tokens = tokenizeInput(input, usage);
+    const args = [];
+    let index = 0;
+    for (const spec of specs) {
+        if (spec.type === 'reply') {
+            if (quoteId !== undefined) {
+                args.push(quoteId);
+            }
+            else if (spec.required) {
+                throw new CommandParamsError(`参数 ${spec.name} 需要引用一条消息`, usage);
+            }
+            else {
+                args.push(undefined);
+            }
+            continue;
+        }
+        if (spec.rest) {
+            for (let tokenIndex = index; tokenIndex < tokens.length; tokenIndex += 1) {
+                const token = tokens[tokenIndex];
+                if (token) {
+                    args.push(token.value);
+                }
+            }
+            index = tokens.length;
+            continue;
+        }
+        if (spec.type === 'text') {
+            const token = tokens[index];
+            if (!token) {
+                if (spec.hasDefault) {
+                    args.push(spec.defaultValue);
+                }
+                else if (spec.required) {
+                    throw new CommandParamsError(`缺少参数：${spec.name}`, usage);
+                }
+                else {
+                    args.push(undefined);
+                }
+                continue;
+            }
+            const remaining = tokens.length - index;
+            const value = remaining === 1 ? token.value : input.slice(token.start).trim();
+            args.push(enforceLength(spec, value, usage));
+            index = tokens.length;
+            continue;
+        }
+        const token = tokens[index];
+        if (!token) {
+            if (spec.hasDefault) {
+                args.push(spec.defaultValue);
+            }
+            else if (spec.required) {
+                throw new CommandParamsError(`缺少参数：${spec.name}`, usage);
+            }
+            else {
+                args.push(undefined);
+            }
+            continue;
+        }
+        index += 1;
+        args.push(parseValue(spec, token.value, usage));
+    }
+    while (args.length > 0 && args[args.length - 1] === undefined) {
+        args.pop();
+    }
+    const ignored = index < tokens.length
+        ? tokens.slice(index).map((token) => token.value)
+        : [];
+    return { args, ignored };
+}
+//# sourceMappingURL=input.js.map

package/dist/core/plugin/params/input.js.map

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

package/dist/core/plugin/params/reply.d.ts

@@ -0,0 +1,3 @@
+import { type OneBotMessageEvent } from '@snowluma/sdk';
+export declare function quoteIdOf(event: OneBotMessageEvent | undefined): number | undefined;
+//# sourceMappingURL=reply.d.ts.map

package/dist/core/plugin/params/reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply.d.ts","sourceRoot":"","sources":["../../../../src/core/plugin/params/reply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAoCtE,wBAAgB,SAAS,CACrB,KAAK,EAAE,kBAAkB,GAAG,SAAS,GACtC,MAAM,GAAG,SAAS,CAoBpB"}

package/dist/core/plugin/params/reply.js

@@ -0,0 +1,49 @@
+import { parseSegments } from '@snowluma/sdk';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function toMessageId(value) {
+    const raw = typeof value === 'string' ? value.trim() : value;
+    if (typeof raw !== 'number' && typeof raw !== 'string') {
+        return undefined;
+    }
+    const parsed = typeof raw === 'string'
+        ? /^-?\d+$/.test(raw)
+            ? Number(raw)
+            : Number.NaN
+        : raw;
+    return Number.isSafeInteger(parsed) && parsed !== 0 ? parsed : undefined;
+}
+function replyIdIn(segments) {
+    for (const segment of segments) {
+        if (!isRecord(segment) || segment.type !== 'reply')
+            continue;
+        const data = isRecord(segment.data) ? segment.data : undefined;
+        const id = toMessageId(data?.id);
+        if (id !== undefined)
+            return id;
+    }
+    return undefined;
+}
+export function quoteIdOf(event) {
+    if (!event)
+        return undefined;
+    const message = event.message;
+    if (typeof message === 'string') {
+        const id = replyIdIn(parseSegments(message));
+        if (id !== undefined)
+            return id;
+    }
+    else if (Array.isArray(message)) {
+        const id = replyIdIn(message);
+        if (id !== undefined)
+            return id;
+    }
+    else if (isRecord(message)) {
+        const id = replyIdIn([message]);
+        if (id !== undefined)
+            return id;
+    }
+    return replyIdIn(parseSegments(event.raw_message));
+}
+//# sourceMappingURL=reply.js.map

package/dist/core/plugin/params/reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply.js","sourceRoot":"","sources":["../../../../src/core/plugin/params/reply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA2B,MAAM,eAAe,CAAA;AAEtE,SAAS,QAAQ,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC/E,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IAC/B,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;IAE5D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrD,OAAO,SAAS,CAAA;IACpB,CAAC;IAED,MAAM,MAAM,GACR,OAAO,GAAG,KAAK,QAAQ;QACnB,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;YACjB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACb,CAAC,CAAC,MAAM,CAAC,GAAG;QAChB,CAAC,CAAC,GAAG,CAAA;IAEb,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AAC5E,CAAC;AAED,SAAS,SAAS,CAAC,QAA4B;IAC3C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO;YAAE,SAAQ;QAE5D,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;QAC9D,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAEhC,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,EAAE,CAAA;IACnC,CAAC;IAED,OAAO,SAAS,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,SAAS,CACrB,KAAqC;IAErC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAE5B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;IAE7B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA;QAE5C,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,EAAE,CAAA;IACnC,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;QAE7B,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,EAAE,CAAA;IACnC,CAAC;SAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;QAE/B,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,EAAE,CAAA;IACnC,CAAC;IAED,OAAO,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAA;AACtD,CAAC"}

package/dist/core/plugin/params/type-level.d.ts

@@ -0,0 +1,24 @@
+type Whitespace = ' ' | '\n' | '\r' | '\t' | '\v' | '\f';
+type TrimLeft<Source extends string> = Source extends `${Whitespace}${infer Rest}` ? TrimLeft<Rest> : Source;
+type TrimRight<Source extends string> = Source extends `${infer Rest}${Whitespace}` ? TrimRight<Rest> : Source;
+type Trim<Source extends string> = TrimLeft<TrimRight<Source>>;
+type StripLength<Type extends string> = Trim<Type> extends `${infer Base}(${string})` ? Trim<Base> : Trim<Type>;
+type ParamValue<Type extends string> = StripLength<Type> extends 'string' | 'text' ? string : StripLength<Type> extends 'number' | 'integer' | 'at' | 'reply' | 'time' ? number : StripLength<Type> extends 'boolean' ? boolean : unknown;
+interface VariadicParam {
+    readonly variadic: true;
+}
+type ParamType<Head extends string> = Head extends `${string}:${infer Type}` ? ParamValue<Type> : string;
+type ParamElement<Body extends string, Required extends boolean> = Trim<Body> extends `...${string}` ? VariadicParam : Trim<Body> extends `${infer Head}=${string}` ? ParamType<Head> : Required extends true ? ParamType<Body> : ParamType<Body> | undefined;
+type AppendParam<Acc extends unknown[], Element> = [Element] extends [
+    VariadicParam
+] ? [...Acc, ...string[]] : [...Acc, Element];
+type ParseCommandParams<Source extends string, Acc extends unknown[] = []> = Trim<Source> extends '' ? Acc : Trim<Source> extends `<${infer Body}>${infer Rest}` ? ParamElement<Body, true> extends VariadicParam ? any[] : ParseCommandParams<Rest, AppendParam<Acc, ParamElement<Body, true>>> : Trim<Source> extends `[${infer Body}]${infer Rest}` ? ParamElement<Body, false> extends VariadicParam ? Trim<Rest> extends '' ? [...Acc, ...string[]] : any[] : ParseCommandParams<Rest, AppendParam<Acc, ParamElement<Body, false>>> : any[];
+/**
+ * 把 `params` 声明字符串推导成 handler 的位置参数 tuple。
+ *
+ * 非字面量声明（例如运行时拼接的 `string`）或无法解析的声明会回退为
+ * `any[]`，以保证现有插件仍然可以编译。
+ */
+export type CommandParamArgs<Declaration extends string> = string extends Declaration ? any[] : ParseCommandParams<Declaration>;
+export {};
+//# sourceMappingURL=type-level.d.ts.map

package/dist/core/plugin/params/type-level.d.ts.map

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

package/dist/core/plugin/params/type-level.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type-level.js.map

package/dist/core/plugin/params/type-level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-level.js","sourceRoot":"","sources":["../../../../src/core/plugin/params/type-level.ts"],"names":[],"mappings":""}

package/dist/core/plugin/params/types.d.ts

@@ -0,0 +1,33 @@
+import type { OneBotMessageEvent } from '@snowluma/sdk';
+export type CommandParamType = 'string' | 'text' | 'number' | 'integer' | 'boolean' | 'at' | 'reply' | 'time';
+export interface ParsedCommandParams {
+    args: unknown[];
+    ignored: string[];
+}
+export interface CompiledCommandParams {
+    usage: string;
+    parse(input: string, event?: OneBotMessageEvent): ParsedCommandParams;
+}
+export declare class CommandParamsError extends Error {
+    readonly usage: string;
+    constructor(message: string, usage: string);
+}
+export interface ParamLength {
+    min?: number | undefined;
+    max?: number | undefined;
+}
+export interface ParamSpec {
+    name: string;
+    type: CommandParamType;
+    required: boolean;
+    rest: boolean;
+    hasDefault: boolean;
+    defaultValue?: unknown;
+    length?: ParamLength | undefined;
+}
+export interface InputToken {
+    value: string;
+    start: number;
+}
+export declare function declarationError(message: string): Error;
+//# sourceMappingURL=types.d.ts.map