@lingxiao-office/sdk 1.0.0

package/dist/tools/implementations/WorkNoteTool.js

@@ -0,0 +1,238 @@
+import { join } from 'path';
+import { z } from 'zod';
+import { buildWorkNoteAwarenessBlock } from '../../core/ArtifactAwareness.js';
+import { WorkNoteManager } from '../../core/WorkNoteManager.js';
+import { createToolError, Tool } from '../Tool.js';
+const WorkNotePhaseSchema = z.enum(['research', 'coding', 'testing', 'reviewing', 'other']);
+const WriteWorkNoteSchema = z.object({
+    agentId: z.string().optional().describe('Agent ID，默认使用当前运行上下文的 agentId；正常 Agent 运行时省略该字段。'),
+    agentName: z.string().optional().describe('当前 agentName；等于当前上下文 agentName 时工具会自动映射为当前 agentId。'),
+    taskId: z.string().optional().describe('任务 ID，默认使用当前 taskId；当前上下文没有 taskId 时可显式填写。'),
+    phase: WorkNotePhaseSchema.default('other').describe('当前阶段'),
+    summary: z.string().min(1).optional().describe('一句话摘要，必须包含实质内容（必填，与 title 二选一）'),
+    title: z.string().min(1).optional().describe('内部输入字段；运行时会归一到 summary'),
+    details: z.string().optional().describe('详细说明'),
+    artifacts: z.array(z.string()).optional().describe('涉及的文件列表'),
+    blockers: z.array(z.string()).optional().describe('阻塞项列表'),
+    nextSteps: z.array(z.string()).optional().describe('下一步建议'),
+    keyFindings: z.array(z.string()).optional().describe('关键发现，建议包含 文件路径:行号 - 说明'),
+    impactAnalysis: z.string().optional().describe('改动影响范围分析'),
+});
+const ExposedWriteWorkNoteSchema = WriteWorkNoteSchema.omit({ agentId: true, agentName: true, title: true }).extend({
+    summary: z.string().min(1).describe('一句话摘要，必须包含实质内容'),
+});
+const ReadWorkNotesSchema = z.object({
+    agentId: z.string().optional().describe('可选，按 Agent ID 过滤'),
+    agentName: z.string().optional().describe('可选，按 agentName 过滤；如果和当前上下文 agentName 相同会自动映射到当前 agentId'),
+    taskId: z.string().optional().describe('可选，按任务 ID 过滤'),
+    offset: z.number().int().min(0).default(0).optional().describe('跳过前 N 条笔记，默认 0；用于续读'),
+    limit: z.number().int().positive().max(50).default(10).optional().describe('返回条数上限，默认 10'),
+});
+const ExposedReadWorkNotesSchema = ReadWorkNotesSchema.omit({ agentName: true }).extend({
+    agentId: z.string().optional().describe('可选，按真实 Agent ID 过滤；通常省略以读取当前 session 全部工作笔记'),
+});
+const RequestWorkNoteSchema = z.object({
+    agentId: z.string().describe('目标 Agent 名称或 ID'),
+});
+function getManager(context) {
+    const workspace = typeof context?.workspace === 'string' && context.workspace.length > 0
+        ? context.workspace
+        : undefined;
+    return new WorkNoteManager(workspace ? join(workspace, '.lingxiao') : undefined);
+}
+function requireSession(context) {
+    return typeof context?.sessionId === 'string' && context.sessionId.length > 0 ? context.sessionId : null;
+}
+function formatNotes(notes) {
+    if (notes.length === 0) {
+        return '未找到工作笔记';
+    }
+    return `工作笔记 (${notes.length} 条):\n\n${notes.map((note, index) => {
+        const time = new Date(note.timestamp).toLocaleString();
+        const lines = [`[${index + 1}] [${note.phase}] ${note.agentId} task=${note.taskId} @ ${time}`];
+        const awareness = buildWorkNoteAwarenessBlock(note);
+        if (awareness) {
+            lines.push(awareness);
+        }
+        else {
+            lines.push(`summary: ${note.summary}`);
+        }
+        return lines.join('\n');
+    }).join('\n\n')}`;
+}
+export class WriteWorkNoteTool extends Tool {
+    name = 'write_work_note';
+    description = '写入当前 Agent 的结构化工作笔记。默认自动使用当前 agentId/taskId。每次任务完成或重要阶段必须记录实质进展、产物、关键发现和影响范围。';
+    parameters = WriteWorkNoteSchema;
+    exposedParameters = ExposedWriteWorkNoteSchema;
+    async execute(args, context) {
+        const params = args;
+        const sessionId = requireSession(context);
+        if (!sessionId) {
+            return createToolError({
+                code: 'WORK_NOTE_SESSION_REQUIRED',
+                message: '缺少 sessionId，无法写入工作笔记',
+                retryable: true,
+                fix: '在有效 session 上下文中调用 write_work_note。',
+            });
+        }
+        // 归一外部运行器或内部调用携带的标题字段。
+        const summary = params.summary || params.title;
+        if (!summary) {
+            return createToolError({
+                code: 'WORK_NOTE_SUMMARY_REQUIRED',
+                message: '必须提供 summary（或 title）字段',
+                retryable: true,
+                fix: '提供包含实质内容的 summary 字段后重试。',
+            });
+        }
+        const currentAgentId = typeof context?.agentId === 'string' ? context.agentId : '';
+        const currentAgentName = typeof context?.agentName === 'string' ? context.agentName : '';
+        const requestedAgentId = params.agentId || params.agentName;
+        const requestedLooksLikeCurrentName = requestedAgentId && currentAgentName && requestedAgentId.trim().replace(/^@+/, '') === currentAgentName.trim().replace(/^@+/, '');
+        const agentId = !requestedAgentId || requestedLooksLikeCurrentName ? currentAgentId : requestedAgentId;
+        const taskId = params.taskId || (typeof context?.taskId === 'string' ? context.taskId : '');
+        if (!agentId || !taskId) {
+            return createToolError({
+                code: 'WORK_NOTE_CONTEXT_REQUIRED',
+                message: 'write_work_note 缺少 agentId 或 taskId。',
+                retryable: true,
+                cause: 'write_work_note 需要 agentId/taskId；正常 Agent 运行时会从上下文自动注入。',
+                fix: '如果 currentAgentId/currentTaskId 存在，请省略 agentId/taskId 后重试；否则只能显式传真实 agentId 和 taskId。',
+                hints: { currentAgentId: currentAgentId || null, currentTaskId: context?.taskId ?? null },
+                example_args: { phase: params.phase, summary, details: params.details },
+            });
+        }
+        if (currentAgentId && agentId !== currentAgentId) {
+            return createToolError({
+                code: 'WORK_NOTE_AGENT_MISMATCH',
+                message: '只能写入自己的工作笔记。',
+                retryable: true,
+                cause: `只能写入自己的工作笔记。requested=${agentId} 不是当前 agentId=${currentAgentId}。如果 requested 是当前 agentName=${currentAgentName || '<unknown>'}，工具会自动映射；否则这是跨 agent 写笔记。`,
+                fix: '省略 agentId/agentName，使用当前运行上下文自动注入的身份；跨 agent 进展通过 read_work_notes 读取后引用。',
+                hints: {
+                    currentAgentId,
+                    requestedAgentId: agentId,
+                    currentTaskId: taskId,
+                    recommended_args: { phase: params.phase, summary, details: params.details, artifacts: params.artifacts, blockers: params.blockers, nextSteps: params.nextSteps, keyFindings: params.keyFindings, impactAnalysis: params.impactAnalysis },
+                },
+                example_args: { phase: params.phase, summary, details: params.details },
+            });
+        }
+        const manager = getManager(context);
+        const note = await manager.writeNoteWithSession(sessionId, {
+            agentId,
+            taskId,
+            phase: params.phase,
+            summary,
+            details: params.details,
+            artifacts: params.artifacts,
+            blockers: params.blockers,
+            nextSteps: params.nextSteps,
+            keyFindings: params.keyFindings,
+            impactAnalysis: params.impactAnalysis,
+        });
+        context?.emitter?.emit('work_note:written', { sessionId, agentId, note });
+        return {
+            success: true,
+            data: `笔记已写入: ${note.id} (agent=${agentId}, task=${taskId}, phase=${note.phase})`,
+        };
+    }
+}
+export class ReadWorkNotesTool extends Tool {
+    name = 'read_work_notes';
+    description = '读取当前 session 的工作笔记，可按真实 Agent ID 或任务过滤；通常省略 agentId 读取全部工作笔记，用于跨 Agent 了解进展和前序结论。';
+    parameters = ReadWorkNotesSchema;
+    exposedParameters = ExposedReadWorkNotesSchema;
+    async execute(args, context) {
+        const params = args;
+        const sessionId = requireSession(context);
+        if (!sessionId) {
+            return createToolError({
+                code: 'WORK_NOTE_SESSION_REQUIRED',
+                message: '缺少 sessionId，无法读取工作笔记',
+                retryable: true,
+                fix: '在有效 session 上下文中调用 read_work_notes。',
+            });
+        }
+        const manager = getManager(context);
+        const currentAgentId = typeof context?.agentId === 'string' ? context.agentId : '';
+        const currentAgentName = typeof context?.agentName === 'string' ? context.agentName : '';
+        const requestedAgent = params.agentId || params.agentName;
+        const normalizedRequested = requestedAgent?.trim().replace(/^@+/, '');
+        const normalizedCurrentName = currentAgentName.trim().replace(/^@+/, '');
+        const filterAgentId = normalizedRequested && normalizedRequested === normalizedCurrentName ? currentAgentId : params.agentId;
+        let notes = filterAgentId
+            ? await manager.getAgentNotes(sessionId, filterAgentId)
+            : await manager.getAllNotes(sessionId);
+        if (params.taskId) {
+            notes = notes.filter((note) => note.taskId === params.taskId);
+        }
+        const total = notes.length;
+        const offset = Math.max(0, params.offset || 0);
+        const limit = Math.max(1, Math.min(params.limit || 10, 50));
+        const page = notes.slice(offset, offset + limit);
+        const nextOffset = offset + page.length;
+        const truncated = nextOffset < total;
+        return {
+            success: true,
+            data: {
+                text: formatNotes(page),
+                notes: page,
+                count: page.length,
+                total,
+                offset,
+                limit,
+                truncated,
+                ...(truncated ? {
+                    next_offset: nextOffset,
+                    continuation_tool_call: {
+                        tool: 'read_work_notes',
+                        args: {
+                            ...(params.agentId ? { agentId: params.agentId } : {}),
+                            ...(params.agentName ? { agentName: params.agentName } : {}),
+                            ...(params.taskId ? { taskId: params.taskId } : {}),
+                            offset: nextOffset,
+                            limit,
+                        },
+                    },
+                } : {}),
+            },
+        };
+    }
+}
+export class RequestWorkNoteTool extends Tool {
+    name = 'request_work_note';
+    description = '请求另一个 Agent 更新工作笔记。目标 Agent 正在运行时会通过消息总线收到提醒。';
+    parameters = RequestWorkNoteSchema;
+    async execute(args, context) {
+        const params = args;
+        const sessionId = requireSession(context);
+        if (!sessionId) {
+            return createToolError({
+                code: 'WORK_NOTE_SESSION_REQUIRED',
+                message: '缺少 sessionId，无法请求工作笔记',
+                retryable: true,
+                fix: '在有效 session 上下文中调用 request_work_note。',
+            });
+        }
+        const requesterAgentId = typeof context?.agentId === 'string' ? context.agentId : 'unknown';
+        const requesterName = typeof context?.agentName === 'string' ? context.agentName : requesterAgentId;
+        if (!context?.bus) {
+            return createToolError({
+                code: 'WORK_NOTE_BUS_UNAVAILABLE',
+                message: '消息总线不可用，无法投递 request_work_note',
+                retryable: false,
+                fix: '确保在 Agent 运行上下文中调用此工具（非独立测试环境）。',
+            });
+        }
+        context.bus.send(`${sessionId}:${requesterName}`, `${sessionId}:${params.agentId}`, 'request_work_note', { sessionId, requesterAgentId });
+        context?.emitter?.emit('work_note:requested', {
+            sessionId,
+            requesterAgentId,
+            targetAgentId: params.agentId,
+        });
+        return { success: true, data: `已请求 ${params.agentId} 更新工作笔记` };
+    }
+}
+//# sourceMappingURL=WorkNoteTool.js.map

package/dist/tools/implementations/WorkNoteTool.js.map

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

package/dist/tools/implementations/WriteFactTool.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class WriteFactTool extends Tool {
+    readonly name = "write_fact";
+    readonly description = "\u5411\u77E5\u8BC6\u56FE\u8C31\u5199\u5165\u4E00\u6761\u5DF2\u786E\u8BA4\u4E8B\u5B9E\u3002Fact \u4E00\u65E6\u5199\u5165\u4E0D\u53EF\u4FEE\u6539\uFF0C\u53EA\u80FD\u88AB\u65B0 Fact \u66FF\u4EE3\u3002";
+    readonly parameters: z.ZodObject<{
+        title: z.ZodString;
+        content: z.ZodString;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        confidence: z.ZodOptional<z.ZodEnum<{
+            confirmed: "confirmed";
+            likely: "likely";
+            tentative: "tentative";
+        }>>;
+        evidence: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                file: "file";
+                tool_result: "tool_result";
+                url: "url";
+                task_result: "task_result";
+                test_result: "test_result";
+                log_output: "log_output";
+                observation: "observation";
+                artifact: "artifact";
+                blackboard_node: "blackboard_node";
+            }>;
+            ref: z.ZodString;
+            location: z.ZodOptional<z.ZodString>;
+            snippet: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=WriteFactTool.d.ts.map

package/dist/tools/implementations/WriteFactTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WriteFactTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/WriteFactTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAWrE,qBAAa,aAAc,SAAQ,IAAI;IACrC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,2MAAgD;IACpE,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;sBAAmB;IAEhC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA6BzE"}

package/dist/tools/implementations/WriteFactTool.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { Tool } from '../Tool.js';
+import { ConfidenceSchema, EvidenceItemSchema } from '../../core/blackboard/schemas.js';
+const WriteFactSchema = z.object({
+    title: z.string().describe('Fact 标题'),
+    content: z.string().describe('Fact 详细内容'),
+    tags: z.array(z.string()).optional().describe('标签列表，用于分类和检索'),
+    confidence: ConfidenceSchema.optional().describe('置信度: confirmed=已确认, likely=很可能, tentative=待验证'),
+    evidence: z.array(EvidenceItemSchema).optional().describe('支撑证据列表'),
+});
+export class WriteFactTool extends Tool {
+    name = 'write_fact';
+    description = '向知识图谱写入一条已确认事实。Fact 一旦写入不可修改，只能被新 Fact 替代。';
+    parameters = WriteFactSchema;
+    async execute(args, context) {
+        const params = args;
+        const graph = context?.blackboardGraph;
+        const sessionId = context?.sessionId;
+        if (!graph || !sessionId) {
+            return { success: false, data: null, error: '黑板图未初始化或 sessionId 缺失' };
+        }
+        try {
+            const node = graph.addFact({
+                sessionId,
+                title: params.title,
+                content: params.content,
+                tags: params.tags ?? [],
+                createdBy: context.taskId ?? context.agentId ?? 'unknown',
+                confidence: params.confidence ?? 'confirmed',
+                evidence: params.evidence,
+            });
+            return {
+                success: true,
+                data: `Fact ${node.id} 已写入: ${node.title}`,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { success: false, data: null, error: `写入 Fact 失败: ${msg}` };
+        }
+    }
+}
+//# sourceMappingURL=WriteFactTool.js.map

package/dist/tools/implementations/WriteFactTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WriteFactTool.js","sourceRoot":"","sources":["../../../src/tools/implementations/WriteFactTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAqC,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAExF,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC7D,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IACjG,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;CACpE,CAAC,CAAC;AAEH,MAAM,OAAO,aAAc,SAAQ,IAAI;IAC5B,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,4CAA4C,CAAC;IAC3D,UAAU,GAAG,eAAe,CAAC;IAEtC,KAAK,CAAC,OAAO,CAAC,IAAa,EAAE,OAAqB;QAChD,MAAM,MAAM,GAAG,IAAuC,CAAC;QACvD,MAAM,KAAK,GAAG,OAAO,EAAE,eAAe,CAAC;QACvC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;QAErC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QACxE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC;gBACzB,SAAS;gBACT,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;gBACvB,SAAS,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,SAAS;gBACzD,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,WAAW;gBAC5C,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,QAAQ,IAAI,CAAC,EAAE,SAAS,IAAI,CAAC,KAAK,EAAE;aAC3C,CAAC;QACJ,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,GAAG,EAAE,EAAE,CAAC;QACrE,CAAC;IACH,CAAC;CACF"}

package/dist/tools/implementations/office/ConditionalFormattingBuilder.d.ts

@@ -0,0 +1,149 @@
+/**
+ * ConditionalFormattingBuilder.ts
+ *
+ * Excel Conditional Formatting implementation for XLSX files.
+ * Supports Data Bars, Color Scales, Icon Sets, and formula-based rules.
+ *
+ * Based on OOXML SpreadsheetML specification.
+ */
+export type CfvoType = 'min' | 'max' | 'num' | 'percent' | 'percentile' | 'formula';
+export interface Cfvo {
+    type: CfvoType;
+    val?: string | number;
+}
+export interface DataBarRule {
+    type: 'dataBar';
+    minValue: Cfvo;
+    maxValue: Cfvo;
+    color: string;
+    showValue?: boolean;
+}
+export interface ColorScaleRule {
+    type: 'colorScale';
+    minValue: Cfvo;
+    minColor: string;
+    midValue?: Cfvo;
+    midColor?: string;
+    maxValue: Cfvo;
+    maxColor: string;
+}
+export type IconSetType = '3Arrows' | '3ArrowsGray' | '3Flags' | '3TrafficLights1' | '3TrafficLights2' | '3Signs' | '3Symbols' | '3Symbols2' | '4Arrows' | '4ArrowsGray' | '4RedToBlack' | '4Rating' | '4TrafficLights' | '5Arrows' | '5ArrowsGray' | '5Rating' | '5Quarters';
+export interface IconSetRule {
+    type: 'iconSet';
+    iconSet: IconSetType;
+    values: Cfvo[];
+    reverse?: boolean;
+    showValue?: boolean;
+}
+export interface CellIsRule {
+    type: 'cellIs';
+    operator: 'lessThan' | 'lessThanOrEqual' | 'equal' | 'notEqual' | 'greaterThanOrEqual' | 'greaterThan' | 'between' | 'notBetween';
+    formula: string | string[];
+    dxfId: number;
+}
+export interface ExpressionRule {
+    type: 'expression';
+    formula: string;
+    dxfId: number;
+}
+export interface Top10Rule {
+    type: 'top10';
+    rank: number;
+    bottom?: boolean;
+    percent?: boolean;
+    dxfId: number;
+}
+export type ConditionalFormattingRule = DataBarRule | ColorScaleRule | IconSetRule | CellIsRule | ExpressionRule | Top10Rule;
+export interface ConditionalFormatting {
+    sqref: string;
+    rules: ConditionalFormattingRule[];
+}
+/**
+ * Generate Data Bar conditional formatting rule XML
+ */
+export declare function dataBarRuleXml(rule: DataBarRule, priority: number): string;
+/**
+ * Generate Color Scale conditional formatting rule XML
+ */
+export declare function colorScaleRuleXml(rule: ColorScaleRule, priority: number): string;
+/**
+ * Generate Icon Set conditional formatting rule XML
+ */
+export declare function iconSetRuleXml(rule: IconSetRule, priority: number): string;
+/**
+ * Generate Cell Is conditional formatting rule XML
+ */
+export declare function cellIsRuleXml(rule: CellIsRule, priority: number): string;
+/**
+ * Generate Expression conditional formatting rule XML
+ */
+export declare function expressionRuleXml(rule: ExpressionRule, priority: number): string;
+/**
+ * Generate Top 10 conditional formatting rule XML
+ */
+export declare function top10RuleXml(rule: Top10Rule, priority: number): string;
+/**
+ * Generate conditional formatting rule XML based on type
+ */
+export declare function conditionalFormattingRuleXml(rule: ConditionalFormattingRule, priority: number): string;
+/**
+ * Generate complete conditional formatting XML for a range
+ */
+export declare function conditionalFormattingXml(cf: ConditionalFormatting, startPriority?: number): string;
+/**
+ * Generate multiple conditional formatting blocks
+ */
+export declare function multipleConditionalFormattingXml(formats: ConditionalFormatting[]): string;
+/**
+ * Helper: Create a data bar rule with default settings
+ */
+export declare function createDataBarRule(color: string, showValue?: boolean): DataBarRule;
+/**
+ * Helper: Create a two-color scale rule
+ */
+export declare function createTwoColorScale(minColor: string, maxColor: string): ColorScaleRule;
+/**
+ * Helper: Create a three-color scale rule
+ */
+export declare function createThreeColorScale(minColor: string, midColor: string, maxColor: string): ColorScaleRule;
+/**
+ * Helper: Create a 3-icon set rule with percentile thresholds
+ */
+export declare function createIconSetRule(iconSet: IconSetType, reverse?: boolean, showValue?: boolean): IconSetRule;
+/**
+ * Helper: Create a 5-icon set rule with percentile thresholds
+ */
+export declare function createFiveIconSetRule(iconSet: IconSetType, reverse?: boolean, showValue?: boolean): IconSetRule;
+/**
+ * Predefined color schemes
+ */
+export declare const ColorSchemes: {
+    RedYellowGreen: {
+        min: string;
+        mid: string;
+        max: string;
+    };
+    BlueWhiteRed: {
+        min: string;
+        mid: string;
+        max: string;
+    };
+    GreenWhiteRed: {
+        min: string;
+        mid: string;
+        max: string;
+    };
+    BlueGradient: {
+        min: string;
+        max: string;
+    };
+    GreenGradient: {
+        min: string;
+        max: string;
+    };
+    RedGradient: {
+        min: string;
+        max: string;
+    };
+};
+//# sourceMappingURL=ConditionalFormattingBuilder.d.ts.map

package/dist/tools/implementations/office/ConditionalFormattingBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConditionalFormattingBuilder.d.ts","sourceRoot":"","sources":["../../../../src/tools/implementations/office/ConditionalFormattingBuilder.ts"],"names":[],"mappings":"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"}