yuque-ai-mcp 2.7.4

package/dist/common/config.js.map

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

package/dist/common/copy-common.d.ts

@@ -0,0 +1,8 @@
+/**
+ * common/copy-common — 跨知识库文档复制公共逻辑
+ *
+ * 职责：源链接追尾。
+ * TOC 缓存与目录创建已迁移到 common/toc-cache.ts。
+ */
+/** 在 body 末尾追加源文档链接（markdown 格式） */
+export declare function appendSourceLink(body: string, sourceUrl: string, sourceTitle: string): string;

package/dist/common/copy-common.js

@@ -0,0 +1,13 @@
+/**
+ * common/copy-common — 跨知识库文档复制公共逻辑
+ *
+ * 职责：源链接追尾。
+ * TOC 缓存与目录创建已迁移到 common/toc-cache.ts。
+ */
+// ─── 源链接追尾 ──────────────────────────────────────────
+/** 在 body 末尾追加源文档链接（markdown 格式） */
+export function appendSourceLink(body, sourceUrl, sourceTitle) {
+    const footer = `\n\n---\n> 📋 源文档：[${sourceTitle}](${sourceUrl})`;
+    return body + footer;
+}
+//# sourceMappingURL=copy-common.js.map

package/dist/common/copy-common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-common.js","sourceRoot":"","sources":["../../src/common/copy-common.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uDAAuD;AAEvD,oCAAoC;AACpC,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,SAAiB,EACjB,WAAmB;IAEnB,MAAM,MAAM,GAAG,sBAAsB,WAAW,KAAK,SAAS,GAAG,CAAC;IAClE,OAAO,IAAI,GAAG,MAAM,CAAC;AACvB,CAAC"}

package/dist/common/errors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * errors — 语雀 API 错误码处理
+ *
+ * 职责：统一映射 HTTP 状态码 + 语雀业务 code → 错误描述，提供 handleApiError 工具函数
+ */
+/**
+ * 解析语雀 API 响应错误，返回结构化错误信息
+ *
+ * @param res - fetch Response 对象
+ * @param context - 操作上下文（如「获取用户信息」），用于拼错误前缀
+ * @returns 格式化的错误对象，可直接作为 MCP tool 返回值
+ */
+export declare function handleApiError(res: Response, context: string): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+}>;
+/**
+ * 删除操作二次确认参数 schema
+ *
+ * 用法：在需要确认的删除工具 inputSchema 中展开此对象
+ */
+export declare const confirmationParam: {
+    readonly confirm: {
+        readonly type: "string";
+        readonly description: "Confirmation token. Must be set to the exact string 'DELETE' to proceed. This is a safety guard against accidental deletion.";
+    };
+};
+/**
+ * 检查确认参数，未确认则返回错误
+ *
+ * @returns null 表示确认通过，否则返回错误对象
+ */
+export declare function checkConfirmation(args: Record<string, unknown> | undefined): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+} | null;
+/** 检测是否为语雀"知识库已满"的错误（超过 5000 文档） */
+export declare function isBookFullError(err: unknown): boolean;

package/dist/common/errors.js

@@ -0,0 +1,164 @@
+/**
+ * errors — 语雀 API 错误码处理
+ *
+ * 职责：统一映射 HTTP 状态码 + 语雀业务 code → 错误描述，提供 handleApiError 工具函数
+ */
+/** HTTP 状态码 → 错误描述 */
+const STATUS_MAP = {
+    400: "Bad request — invalid parameters",
+    401: "Unauthorized — token missing or invalid",
+    403: "Forbidden — insufficient permissions",
+    404: "Not found — entity does not exist",
+    422: "Unprocessable — parameter validation failed",
+    429: "Rate limited — too many requests",
+    500: "Internal server error",
+};
+/** 语雀业务 code → 错误描述 */
+const YUQUE_CODE_MAP = {
+    invalid_params: "参数无效，请检查必填字段和格式 / Invalid parameters — check required fields and formats",
+    not_found: "Entity not found — check the ID or slug",
+    permission_denied: "Permission denied — check token scope or team membership",
+    user_not_found: "User not found — check login or ID",
+    book_not_found: "Repository not found — check book_id or namespace",
+    doc_not_found: "Document not found — check doc ID or slug",
+    note_not_found: "Note not found — check note ID",
+    group_not_found: "Group not found — check group login or ID",
+    recycle_not_found: "Recycle bin item not found — check recycle_id",
+    version_not_found: "Version not found — check version ID",
+    toc_not_found: "TOC not found — check book_id",
+    slug_conflict: "Slug conflict — a document with this slug already exists",
+    book_slug_conflict: "Repository slug conflict — a repo with this slug already exists",
+    token_expired: "Token expired — regenerate your API token",
+    token_invalid: "Token invalid — check your API token",
+    scope_insufficient: "Scope insufficient — token lacks required API scope",
+    rate_limit: "Rate limit exceeded — slow down and retry",
+    upload_failed: "Upload failed — check file size, type, and cookie/ctoken",
+    cookie_required: "Cookie required — this operation needs cookie + ctoken in config.json",
+    membership_required: "Membership required — upgrade to access this feature",
+    body_parse_failed: "Request body parse failed — check JSON format",
+    too_many_requests: "Too many requests — back off and retry",
+    book_full: "cannot create more than 5000 documents in a book from api",
+};
+/** 解析语雀业务 code */
+function parseYuqueCode(body) {
+    try {
+        const parsed = JSON.parse(body);
+        if (parsed?.code && typeof parsed.code === "string") {
+            return parsed.code;
+        }
+        if (parsed?.message && typeof parsed.message === "string") {
+            // 有些端点不返回 code，只返回 message
+            return undefined;
+        }
+    }
+    catch {
+        // body 不是 JSON
+    }
+    return undefined;
+}
+/**
+ * 解析语雀 API 响应错误，返回结构化错误信息
+ *
+ * @param res - fetch Response 对象
+ * @param context - 操作上下文（如「获取用户信息」），用于拼错误前缀
+ * @returns 格式化的错误对象，可直接作为 MCP tool 返回值
+ */
+export async function handleApiError(res, context) {
+    const status = res.status;
+    const statusLabel = STATUS_MAP[status] ?? `Unknown error (HTTP ${status})`;
+    let detail = "";
+    let body = "";
+    // 读取响应 body
+    try {
+        body = await res.text();
+    }
+    catch {
+        // 读 body 失败，忽略
+    }
+    // 先尝试解析语雀业务 code
+    const yuqueCode = body ? parseYuqueCode(body) : undefined;
+    const yuqueLabel = yuqueCode ? YUQUE_CODE_MAP[yuqueCode] : undefined;
+    // 构建详情
+    if (yuqueLabel) {
+        detail += `\nYuque code: ${yuqueCode} — ${yuqueLabel}`;
+    }
+    else if (body) {
+        // 尝试提取 message 字段
+        try {
+            const parsed = JSON.parse(body);
+            if (parsed?.message && typeof parsed.message === "string") {
+                detail += `\nMessage: ${parsed.message}`;
+            }
+            else if (body.length < 500) {
+                detail += `\nResponse: ${body}`;
+            }
+        }
+        catch {
+            if (body.length < 500)
+                detail += `\nResponse: ${body}`;
+        }
+    }
+    // 429 限流：提取 X-RateLimit-* 头
+    if (status === 429) {
+        const limit = res.headers.get("X-RateLimit-Limit");
+        const remaining = res.headers.get("X-RateLimit-Remaining");
+        const retryAfter = res.headers.get("Retry-After");
+        const parts = [];
+        if (limit)
+            parts.push(`Limit: ${limit}/hour`);
+        if (remaining !== null)
+            parts.push(`Remaining: ${remaining}`);
+        if (retryAfter)
+            parts.push(`Retry-After: ${retryAfter}s`);
+        if (parts.length)
+            detail += `\nRate info: ${parts.join(", ")}`;
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${context} failed — ${statusLabel}${detail}`,
+            },
+        ],
+        isError: true,
+    };
+}
+/**
+ * 删除操作二次确认参数 schema
+ *
+ * 用法：在需要确认的删除工具 inputSchema 中展开此对象
+ */
+export const confirmationParam = {
+    confirm: {
+        type: "string",
+        description: "Confirmation token. Must be set to the exact string 'DELETE' to proceed. This is a safety guard against accidental deletion.",
+    },
+};
+/**
+ * 检查确认参数，未确认则返回错误
+ *
+ * @returns null 表示确认通过，否则返回错误对象
+ */
+export function checkConfirmation(args) {
+    if (args?.confirm !== "DELETE") {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "⚠️ 危险操作需二次确认，请将参数 `confirm` 设为 'DELETE' 后重试 / Destructive operation requires confirmation. Set parameter `confirm` to the exact string 'DELETE' to proceed.",
+                },
+            ],
+            isError: true,
+        };
+    }
+    return null;
+}
+/** 检测是否为语雀"知识库已满"的错误（超过 5000 文档） */
+export function isBookFullError(err) {
+    const e = err;
+    if (!e?.isError || !e?.content?.[0]?.text)
+        return false;
+    const msg = e.content[0].text.toLowerCase();
+    return msg.includes(YUQUE_CODE_MAP.book_full);
+}
+//# sourceMappingURL=errors.js.map

package/dist/common/errors.js.map

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

package/dist/common/export-common.d.ts

@@ -0,0 +1,32 @@
+/**
+ * common/export-common — 导出工具公共函数
+ *
+ * 被 export-repo.ts（批量导出）和 export-doc.ts（单篇导出）共享。
+ */
+export interface ResourceRef {
+    url: string;
+    localPath: string;
+    type: "image" | "attachment";
+}
+/** 从 body_html 中提取所有资源引用 */
+export declare function extractResources(bodyHtml: string, imagesDir: string, attachmentsDir: string): ResourceRef[];
+export interface DownloadResult {
+    url: string;
+    localPath: string;
+    success: boolean;
+    error?: string;
+}
+export declare function downloadFile(url: string, destPath: string, token: string): Promise<DownloadResult>;
+export declare function formatFrontMatter(doc: {
+    title: string;
+    slug: string;
+    created_at: string;
+    updated_at: string;
+    word_count: number;
+    description?: string;
+}): string;
+/** 安全文件名：去除非法字符 */
+export declare function sanitizeFilename(name: string): string;
+/** 简单 HTML → Markdown 转换 */
+export declare function htmlToMarkdown(html: string): string;
+export { unescapeHtml } from "./text-utils.js";

package/dist/common/export-common.js

@@ -0,0 +1,125 @@
+/**
+ * common/export-common — 导出工具公共函数
+ *
+ * 被 export-repo.ts（批量导出）和 export-doc.ts（单篇导出）共享。
+ */
+import { writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { unescapeHtml } from "./text-utils.js";
+/** 从 body_html 中提取所有资源引用 */
+export function extractResources(bodyHtml, imagesDir, attachmentsDir) {
+    const resources = [];
+    const seen = new Set();
+    // 提取 <img src="...">
+    const imgRegex = /<img[^>]+src="([^"]+)"/gi;
+    let match;
+    while ((match = imgRegex.exec(bodyHtml)) !== null) {
+        const url = match[1];
+        if (seen.has(url))
+            continue;
+        seen.add(url);
+        const name = urlToFilename(url);
+        resources.push({ url, localPath: join(imagesDir, name), type: "image" });
+    }
+    // 提取 Markdown 图片 ![](url)
+    const mdImgRegex = /!\[.*?\]\(([^)]+)\)/g;
+    while ((match = mdImgRegex.exec(bodyHtml)) !== null) {
+        const url = match[1];
+        if (seen.has(url))
+            continue;
+        seen.add(url);
+        const name = urlToFilename(url);
+        resources.push({ url, localPath: join(imagesDir, name), type: "image" });
+    }
+    return resources;
+}
+/** URL → 安全文件名 */
+function urlToFilename(url) {
+    try {
+        const parsed = new URL(url);
+        const pathname = parsed.pathname;
+        const base = pathname.split("/").pop() || "file";
+        const clean = base.split("?")[0];
+        return clean || `file_${Date.now()}`;
+    }
+    catch {
+        return `file_${Date.now()}`;
+    }
+}
+export async function downloadFile(url, destPath, token) {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 15_000);
+        const res = await fetch(url, {
+            headers: {
+                "X-Auth-Token": token,
+                "User-Agent": "yuque-ai-mcp/2.1.0",
+            },
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        if (!res.ok) {
+            return { url, localPath: destPath, success: false, error: `HTTP ${res.status}` };
+        }
+        const buffer = Buffer.from(await res.arrayBuffer());
+        await writeFile(destPath, buffer);
+        return { url, localPath: destPath, success: true };
+    }
+    catch (err) {
+        return {
+            url,
+            localPath: destPath,
+            success: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+// ─── Markdown 生成 ────────────────────────────────────
+export function formatFrontMatter(doc) {
+    return [
+        "---",
+        `title: "${doc.title.replace(/"/g, '\\"')}"`,
+        `slug: ${doc.slug}`,
+        `created: ${doc.created_at}`,
+        `updated: ${doc.updated_at}`,
+        `word_count: ${doc.word_count}`,
+        ...(doc.description ? [`description: "${doc.description.replace(/"/g, '\\"')}"`] : []),
+        "---",
+        "",
+    ].join("\n");
+}
+// ─── 辅助函数 ─────────────────────────────────────────
+/** 安全文件名：去除非法字符 */
+export function sanitizeFilename(name) {
+    return name.replace(/[<>:"/\\|?*]/g, "_").substring(0, 200);
+}
+/** 简单 HTML → Markdown 转换 */
+export function htmlToMarkdown(html) {
+    let md = html;
+    md = md.replace(/<h1[^>]*>(.*?)<\/h1>/gi, (_, c) => `\n# ${stripHtml(c)}\n`);
+    md = md.replace(/<h2[^>]*>(.*?)<\/h2>/gi, (_, c) => `\n## ${stripHtml(c)}\n`);
+    md = md.replace(/<h3[^>]*>(.*?)<\/h3>/gi, (_, c) => `\n### ${stripHtml(c)}\n`);
+    md = md.replace(/<h4[^>]*>(.*?)<\/h4>/gi, (_, c) => `\n#### ${stripHtml(c)}\n`);
+    md = md.replace(/<h5[^>]*>(.*?)<\/h5>/gi, (_, c) => `\n##### ${stripHtml(c)}\n`);
+    md = md.replace(/<h6[^>]*>(.*?)<\/h6>/gi, (_, c) => `\n###### ${stripHtml(c)}\n`);
+    md = md.replace(/<(strong|b)[^>]*>(.*?)<\/(strong|b)>/gi, "**$2**");
+    md = md.replace(/<(em|i)[^>]*>(.*?)<\/(em|i)>/gi, "*$2*");
+    md = md.replace(/<a[^>]+href="([^"]*)"[^>]*>(.*?)<\/a>/gi, "[$2]($1)");
+    md = md.replace(/<img[^>]+src="([^"]*)"[^>]*\/?>/gi, "![]($1)");
+    md = md.replace(/<p[^>]*>(.*?)<\/p>/gi, (_, c) => `\n${stripHtml(c)}\n`);
+    md = md.replace(/<br\s*\/?>/gi, "\n");
+    md = md.replace(/<li[^>]*>(.*?)<\/li>/gi, (_, c) => `- ${stripHtml(c)}`);
+    md = md.replace(/<pre[^>]*><code[^>]*>(.*?)<\/code><\/pre>/gi, (_, c) => `\n\`\`\`\n${unescapeHtml(c)}\n\`\`\`\n`);
+    md = md.replace(/<code[^>]*>(.*?)<\/code>/gi, "`$1`");
+    md = md.replace(/<(del|s|strike)[^>]*>(.*?)<\/(del|s|strike)>/gi, "~~$2~~");
+    md = md.replace(/<hr\s*\/?>/gi, "\n---\n");
+    md = md.replace(/<[^>]+>/g, "");
+    md = unescapeHtml(md);
+    md = md.replace(/\n{3,}/g, "\n\n");
+    return md.trim();
+}
+function stripHtml(html) {
+    return html.replace(/<[^>]+>/g, "");
+}
+export { unescapeHtml } from "./text-utils.js";
+//# sourceMappingURL=export-common.js.map

package/dist/common/export-common.js.map

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

package/dist/common/format.d.ts

@@ -0,0 +1,247 @@
+/**
+ * 公共格式化函数 — 对 API 原始响应做字段裁剪，减少 AI token 消耗
+ *
+ * 默认精简输出，传 raw=true 可获取全量原始 JSON
+ */
+/** 语雀用户原始数据 */
+interface YuqueUserRaw {
+    id: number;
+    login: string;
+    name: string;
+    description?: string;
+    avatar_url?: string;
+    books_count?: number;
+    followers_count?: number;
+}
+/** 语雀团队原始数据 */
+interface YuqueGroupRaw {
+    id: number;
+    login: string;
+    name: string;
+    description?: string;
+    avatar_url?: string;
+}
+/** 语雀文档原始数据 */
+interface YuqueDocRaw {
+    id: number;
+    slug: string;
+    title: string;
+    format?: string;
+    public?: number;
+    word_count?: number;
+    body?: string;
+    body_html?: string;
+    description?: string;
+    book_id?: number;
+    user_id?: number;
+    created_at?: string;
+    updated_at?: string;
+}
+/** 语雀文档版本原始数据 */
+interface YuqueDocVersionRaw {
+    id: number;
+    doc_id: number;
+    title: string;
+    version: number;
+    created_at?: string;
+    content_changed?: boolean;
+}
+/** 语雀知识库原始数据 */
+interface YuqueRepoRaw {
+    id: number;
+    slug: string;
+    name: string;
+    namespace?: string;
+    description?: string;
+    public?: number;
+    items_count?: number;
+    likes_count?: number;
+    user_id?: number;
+    created_at?: string;
+    updated_at?: string;
+}
+/** 语雀团队成员原始数据 */
+interface YuqueGroupUserRaw {
+    id: number;
+    login: string;
+    name: string;
+    role?: number;
+    avatar_url?: string;
+    created_at?: string;
+    user?: YuqueUserRaw;
+}
+/** 语雀小记原始数据 */
+interface YuqueNoteRaw {
+    id: number;
+    slug: string;
+    title?: string;
+    content?: string | {
+        abstract?: string;
+    };
+    word_count?: number;
+    public?: number;
+    book_id?: number;
+    created_at?: string;
+    updated_at?: string;
+    note_url?: string;
+}
+/** 语雀 TOC 节点原始数据 */
+interface YuqueTocNodeRaw {
+    title: string;
+    uuid: string;
+    type?: string;
+    doc_id?: number;
+    level?: number;
+    visible?: boolean;
+    url?: string;
+    child_uuid?: string;
+    parent_uuid?: string;
+}
+/** 语雀回收站项目原始数据 */
+interface YuqueRecycleRaw {
+    id: number;
+    title: string;
+    type?: string;
+    slug?: string;
+    deleted_at?: string;
+    user_id?: number;
+    book_id?: number;
+}
+/** 带 data 包装的 API 响应 */
+interface ApiResponse<T> {
+    data?: T;
+    meta?: unknown;
+}
+export declare function formatUser(data: ApiResponse<YuqueUserRaw> | YuqueUserRaw): {
+    id: number;
+    login: string;
+    name: string;
+    description: string | undefined;
+    avatar_url: string | undefined;
+    books_count: number | undefined;
+    followers_count: number | undefined;
+};
+export declare function formatUserGroup(data: YuqueGroupRaw): {
+    id: number;
+    login: string;
+    name: string;
+    description: string | undefined;
+    avatar_url: string | undefined;
+};
+export declare function formatDoc(data: ApiResponse<YuqueDocRaw> | YuqueDocRaw): {
+    id: number;
+    slug: string;
+    title: string;
+    format: string | undefined;
+    public: number | undefined;
+    word_count: number | undefined;
+    body: string | undefined;
+    body_html: string | undefined;
+    description: string | undefined;
+    book_id: number | undefined;
+    user_id: number | undefined;
+    created_at: string | undefined;
+    updated_at: string | undefined;
+};
+export declare function formatDocSummary(data: ApiResponse<YuqueDocRaw> | YuqueDocRaw): {
+    id: number;
+    slug: string;
+    title: string;
+    format: string | undefined;
+    public: number | undefined;
+    word_count: number | undefined;
+    updated_at: string | undefined;
+};
+export declare function formatDocVersion(data: YuqueDocVersionRaw): {
+    id: number;
+    doc_id: number;
+    title: string;
+    version: number;
+    created_at: string | undefined;
+    content_changed: boolean | undefined;
+};
+export declare function formatRepo(data: ApiResponse<YuqueRepoRaw> | YuqueRepoRaw): {
+    id: number;
+    slug: string;
+    name: string;
+    namespace: string | undefined;
+    description: string | undefined;
+    public: number | undefined;
+    items_count: number | undefined;
+    likes_count: number | undefined;
+    user_id: number | undefined;
+    created_at: string | undefined;
+    updated_at: string | undefined;
+};
+export declare function formatGroupUser(data: YuqueGroupUserRaw): {
+    id: number;
+    login: string;
+    name: string;
+    role: number | undefined;
+    avatar_url: string | undefined;
+    created_at: string | undefined;
+};
+export declare function formatNote(data: ApiResponse<YuqueNoteRaw> | YuqueNoteRaw): {
+    id: number;
+    slug: string;
+    title: string | undefined;
+    content: string | {
+        abstract?: string;
+    } | undefined;
+    word_count: number | undefined;
+    public: number | undefined;
+    book_id: number | undefined;
+    created_at: string | undefined;
+    updated_at: string | undefined;
+    note_url: string | undefined;
+};
+export declare function formatNoteSummary(data: ApiResponse<YuqueNoteRaw> | YuqueNoteRaw): {
+    id: number;
+    slug: string;
+    word_count: number | undefined;
+    updated_at: string | undefined;
+    abstract: string;
+};
+export declare function formatToc(data: YuqueTocNodeRaw[]): {
+    title: string;
+    uuid: string;
+    type: string | undefined;
+    doc_id: number | undefined;
+    level: number | undefined;
+    visible: boolean | undefined;
+    url: string | undefined;
+    child_uuid: string | undefined;
+    parent_uuid: string | undefined;
+}[];
+export declare function formatRecycle(data: YuqueRecycleRaw): {
+    id: number;
+    title: string;
+    type: string | undefined;
+    slug: string | undefined;
+    deleted_at: string | undefined;
+    user_id: number | undefined;
+    book_id: number | undefined;
+};
+/**
+ * 对工具返回做格式化包装：
+ * - 默认调 formatFn 裁剪
+ * - 如果用户传了 raw=true，透传原始 JSON
+ */
+export declare function wrapResult(data: unknown, formatFn?: (item: any) => unknown, raw?: boolean): string;
+/**
+ * 统一处理 API 调用结果：检查错误 → 格式化 → 包装 content 返回
+ * 消除 32 处 handler 末尾重复的 isErrorResult + wrapResult 模式。
+ */
+export declare function handleApiCall(data: unknown, formatFn: (item: any) => unknown, raw?: boolean): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+} | {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+};
+export {};