orquesta-cli 0.1.12

package/src/tools/office/common/index.ts

@@ -0,0 +1,133 @@
+/**
+ * Office Common Module
+ *
+ * Barrel export for shared utilities, constants, and types
+ * used by Office tools (Word, Excel, PowerPoint)
+ */
+
+// =============================================================================
+// Utilities
+// =============================================================================
+
+export {
+  saveScreenshot,
+  hexToRgb,
+  hexToBgrColor,
+  hasKoreanText,
+  getRecommendedFont,
+  escapePowerShellString,
+  columnLetterToNumber,
+  columnNumberToLetter,
+} from './utils.js';
+
+// =============================================================================
+// Constants
+// =============================================================================
+
+export {
+  // Directory constants
+  OFFICE_SCREENSHOT_DIR,
+  OFFICE_SCREENSHOT_PATH_DESC,
+  OFFICE_CATEGORIES,
+
+  // Word alignment constants
+  WORD_PARAGRAPH_ALIGNMENT,
+  WORD_PAGE_NUMBER_ALIGNMENT,
+  WORD_BREAK_TYPES,
+  WORD_SHAPE_TYPES,
+
+  // Excel alignment constants
+  EXCEL_HORIZONTAL_ALIGNMENT,
+  EXCEL_VERTICAL_ALIGNMENT,
+
+  // Excel chart constants
+  EXCEL_CHART_TYPES,
+
+  // Excel border constants
+  EXCEL_BORDER_STYLES,
+  EXCEL_BORDER_WEIGHTS,
+  EXCEL_BORDER_EDGES,
+
+  // Excel conditional format constants
+  EXCEL_CONDITION_TYPES,
+  EXCEL_COMPARISON_OPERATORS,
+
+  // Excel validation constants
+  EXCEL_VALIDATION_TYPES,
+  EXCEL_VALIDATION_OPERATORS,
+
+  // PowerPoint alignment constants
+  POWERPOINT_HORIZONTAL_ALIGNMENT,
+  POWERPOINT_VERTICAL_ALIGNMENT,
+  POWERPOINT_SHAPE_ALIGNMENT,
+  POWERPOINT_DISTRIBUTE,
+
+  // PowerPoint animation/transition constants
+  POWERPOINT_ANIMATION_EFFECTS,
+  POWERPOINT_TRANSITION_TYPES,
+
+  // PowerPoint shape/chart constants
+  POWERPOINT_SHAPE_TYPES,
+  POWERPOINT_CHART_TYPES,
+} from './constants.js';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export type {
+  // Re-exported from tools/types.js
+  ToolResult,
+  ToolCategory,
+  LLMSimpleTool,
+
+  // Re-exported from office-client-base.js
+  OfficeResponse,
+  ScreenshotResponse,
+
+  // Alignment types
+  HorizontalAlignment,
+  VerticalAlignment,
+  ShapeAlignment,
+
+  // Font types
+  FontOptions,
+  ExtendedFontOptions,
+
+  // Color types
+  RgbColor,
+
+  // Excel types
+  ExcelAlignmentOptions,
+  ExcelBorderStyle,
+  ExcelBorderEdge,
+  ExcelBorderOptions,
+  ExcelChartType,
+  ExcelConditionalFormatType,
+  ExcelComparisonOperator,
+  ExcelValidationType,
+  ExcelValidationOperator,
+  ExcelClearType,
+
+  // PowerPoint types
+  PowerPointShapeType,
+  PowerPointAnimationEffect,
+  PowerPointTransitionType,
+  PowerPointChartType,
+  PowerPointDistribution,
+
+  // Word types
+  WordParagraphAlignment,
+  WordBreakType,
+  WordPageOrientation,
+  WordGotoWhat,
+  WordShapeType,
+
+  // Common option interfaces
+  PositionOptions,
+  SizeOptions,
+  BoundsOptions,
+  PageMarginOptions,
+  ShadowOptions,
+  ReflectionOptions,
+} from './types.js';

package/src/tools/office/common/types.ts

@@ -0,0 +1,286 @@
+/**
+ * Office Common Types
+ *
+ * Shared type definitions for Office tools (Word, Excel, PowerPoint)
+ */
+
+// Re-export from tools/types.js for convenience
+export type { ToolResult, ToolCategory, LLMSimpleTool } from '../../types.js';
+
+// Re-export from office-client-base.js
+export type { OfficeResponse, ScreenshotResponse } from '../office-client-base.js';
+
+// =============================================================================
+// Alignment Types
+// =============================================================================
+
+/**
+ * Horizontal alignment options (common across Word, Excel, PowerPoint)
+ */
+export type HorizontalAlignment = 'left' | 'center' | 'right' | 'justify';
+
+/**
+ * Vertical alignment options (common across Excel, PowerPoint)
+ */
+export type VerticalAlignment = 'top' | 'center' | 'middle' | 'bottom';
+
+/**
+ * Shape alignment options (PowerPoint)
+ */
+export type ShapeAlignment = 'left' | 'center' | 'right' | 'top' | 'middle' | 'bottom';
+
+// =============================================================================
+// Font Options Types
+// =============================================================================
+
+/**
+ * Common font options used across Office applications
+ */
+export interface FontOptions {
+  fontName?: string;
+  fontSize?: number;
+  bold?: boolean;
+  italic?: boolean;
+  underline?: boolean;
+  color?: string;
+}
+
+/**
+ * Extended font options with strikethrough
+ */
+export interface ExtendedFontOptions extends FontOptions {
+  strikethrough?: boolean;
+}
+
+// =============================================================================
+// Color Types
+// =============================================================================
+
+/**
+ * RGB color representation
+ */
+export interface RgbColor {
+  r: number;
+  g: number;
+  b: number;
+}
+
+// =============================================================================
+// Excel-specific Types
+// =============================================================================
+
+/**
+ * Excel cell alignment options
+ */
+export interface ExcelAlignmentOptions {
+  horizontal?: 'left' | 'center' | 'right';
+  vertical?: 'top' | 'center' | 'bottom';
+  wrapText?: boolean;
+  orientation?: number;
+}
+
+/**
+ * Excel border style options
+ */
+export type ExcelBorderStyle = 'thin' | 'medium' | 'thick' | 'double' | 'dotted' | 'dashed';
+
+/**
+ * Excel border edge options
+ */
+export type ExcelBorderEdge = 'left' | 'right' | 'top' | 'bottom' | 'all';
+
+/**
+ * Excel border options
+ */
+export interface ExcelBorderOptions {
+  style?: ExcelBorderStyle;
+  color?: string;
+  edges?: ExcelBorderEdge[];
+}
+
+/**
+ * Excel chart types
+ */
+export type ExcelChartType = 'column' | 'bar' | 'line' | 'pie' | 'area' | 'scatter' | 'doughnut';
+
+/**
+ * Excel conditional format types
+ */
+export type ExcelConditionalFormatType = 'cellValue' | 'colorScale' | 'dataBar' | 'iconSet' | 'duplicates' | 'top10';
+
+/**
+ * Excel comparison operators
+ */
+export type ExcelComparisonOperator = 'greater' | 'less' | 'equal' | 'between' | 'notBetween';
+
+/**
+ * Excel validation types
+ */
+export type ExcelValidationType = 'list' | 'whole' | 'decimal' | 'date' | 'textLength' | 'custom';
+
+/**
+ * Excel validation operators
+ */
+export type ExcelValidationOperator = 'between' | 'notBetween' | 'equal' | 'notEqual' | 'greater' | 'less' | 'greaterEqual' | 'lessEqual';
+
+/**
+ * Excel clear range types
+ */
+export type ExcelClearType = 'all' | 'contents' | 'formats' | 'comments';
+
+// =============================================================================
+// PowerPoint-specific Types
+// =============================================================================
+
+/**
+ * PowerPoint shape types
+ */
+export type PowerPointShapeType =
+  | 'rectangle'
+  | 'rounded_rectangle'
+  | 'oval'
+  | 'diamond'
+  | 'triangle'
+  | 'right_triangle'
+  | 'pentagon'
+  | 'hexagon'
+  | 'arrow_right'
+  | 'arrow_left'
+  | 'arrow_up'
+  | 'arrow_down'
+  | 'star_5'
+  | 'star_6'
+  | 'heart'
+  | 'lightning'
+  | 'callout';
+
+/**
+ * PowerPoint animation effect types
+ */
+export type PowerPointAnimationEffect =
+  | 'appear'
+  | 'fade'
+  | 'fly_in'
+  | 'float_in'
+  | 'split'
+  | 'wipe'
+  | 'shape'
+  | 'wheel'
+  | 'random_bars'
+  | 'grow_and_turn'
+  | 'zoom'
+  | 'swivel'
+  | 'bounce';
+
+/**
+ * PowerPoint transition types
+ */
+export type PowerPointTransitionType =
+  | 'none'
+  | 'fade'
+  | 'push'
+  | 'wipe'
+  | 'split'
+  | 'reveal'
+  | 'random_bars'
+  | 'shape'
+  | 'uncover'
+  | 'cover'
+  | 'flash';
+
+/**
+ * PowerPoint chart types (same as Excel)
+ */
+export type PowerPointChartType = ExcelChartType;
+
+/**
+ * PowerPoint distribution options
+ */
+export type PowerPointDistribution = 'horizontal' | 'vertical';
+
+// =============================================================================
+// Word-specific Types
+// =============================================================================
+
+/**
+ * Word paragraph alignment options
+ */
+export type WordParagraphAlignment = 'left' | 'center' | 'right' | 'justify';
+
+/**
+ * Word break types
+ */
+export type WordBreakType = 'page' | 'line' | 'section';
+
+/**
+ * Word page orientation
+ */
+export type WordPageOrientation = 'portrait' | 'landscape';
+
+/**
+ * Word navigation target types
+ */
+export type WordGotoWhat = 'page' | 'line' | 'bookmark';
+
+/**
+ * Word shape types (same as PowerPoint)
+ */
+export type WordShapeType = PowerPointShapeType;
+
+// =============================================================================
+// Common Option Interfaces
+// =============================================================================
+
+/**
+ * Position options (x, y coordinates)
+ */
+export interface PositionOptions {
+  left?: number;
+  top?: number;
+}
+
+/**
+ * Size options (width, height)
+ */
+export interface SizeOptions {
+  width?: number;
+  height?: number;
+}
+
+/**
+ * Combined position and size options
+ */
+export interface BoundsOptions extends PositionOptions, SizeOptions {}
+
+/**
+ * Page margin options
+ */
+export interface PageMarginOptions {
+  top?: number;
+  bottom?: number;
+  left?: number;
+  right?: number;
+}
+
+/**
+ * Shadow effect options
+ */
+export interface ShadowOptions {
+  visible?: boolean;
+  blur?: number;
+  offsetX?: number;
+  offsetY?: number;
+  color?: string;
+  transparency?: number;
+}
+
+/**
+ * Reflection effect options
+ */
+export interface ReflectionOptions {
+  visible?: boolean;
+  size?: number;
+  transparency?: number;
+  offset?: number;
+  blur?: number;
+}

package/src/tools/office/common/utils.ts

@@ -0,0 +1,116 @@
+/**
+ * Office Common Utilities
+ *
+ * Shared utility functions for Office tools (Word, Excel, PowerPoint)
+ */
+
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { OFFICE_SCREENSHOT_DIR } from './constants.js';
+
+/**
+ * Save a base64-encoded screenshot to the office screenshots directory
+ * @param base64Image - Base64 encoded image data
+ * @param appName - Application name (e.g., 'word', 'excel', 'powerpoint')
+ * @returns The full path to the saved screenshot file
+ */
+export async function saveScreenshot(base64Image: string, appName: string): Promise<string> {
+  await fs.mkdir(OFFICE_SCREENSHOT_DIR, { recursive: true });
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+  const filename = `${appName}_${timestamp}.png`;
+  const filePath = path.join(OFFICE_SCREENSHOT_DIR, filename);
+  const buffer = Buffer.from(base64Image, 'base64');
+  await fs.writeFile(filePath, buffer);
+  return filePath;
+}
+
+/**
+ * Convert hex color string to RGB values
+ * @param hex - Hex color string (e.g., '#FF0000' or 'FF0000')
+ * @returns RGB object or null if invalid format
+ */
+export function hexToRgb(hex: string): { r: number; g: number; b: number } | null {
+  const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+  if (!result || !result[1] || !result[2] || !result[3]) return null;
+  return {
+    r: parseInt(result[1], 16),
+    g: parseInt(result[2], 16),
+    b: parseInt(result[3], 16),
+  };
+}
+
+/**
+ * Convert RGB to Office BGR color value
+ * Office COM uses BGR format: B + G*256 + R*65536
+ * @param hex - Hex color string
+ * @returns BGR color value for Office COM or 0 if invalid
+ */
+export function hexToBgrColor(hex: string): number {
+  const rgb = hexToRgb(hex);
+  if (!rgb) return 0;
+  return rgb.r + rgb.g * 256 + rgb.b * 65536;
+}
+
+/**
+ * Check if text contains Korean characters
+ * @param text - Text to check
+ * @returns true if contains Korean characters
+ */
+export function hasKoreanText(text: string): boolean {
+  return /[가-힣ㄱ-ㅎㅏ-ㅣ]/.test(text);
+}
+
+/**
+ * Default Korean font name (English name works on all Windows regardless of UI language)
+ */
+export const KOREAN_FONT = 'Malgun Gothic';
+
+/**
+ * Get recommended font name for text (auto-detect Korean)
+ * @param text - Text to check
+ * @param defaultFont - Default font for non-Korean text (optional)
+ * @returns Font name ('Malgun Gothic' for Korean, defaultFont otherwise)
+ */
+export function getRecommendedFont(text: string, defaultFont?: string): string | undefined {
+  if (hasKoreanText(text)) {
+    return KOREAN_FONT;
+  }
+  return defaultFont;
+}
+
+/**
+ * Escape single quotes for PowerShell string
+ * @param str - String to escape
+ * @returns Escaped string
+ */
+export function escapePowerShellString(str: string): string {
+  return str.replace(/'/g, "''");
+}
+
+/**
+ * Convert column letter (A, B, ..., Z, AA, AB, ...) to number (1, 2, ..., 26, 27, 28, ...)
+ * @param column - Column letter(s)
+ * @returns Column number (1-based)
+ */
+export function columnLetterToNumber(column: string): number {
+  let result = 0;
+  for (let i = 0; i < column.length; i++) {
+    result = result * 26 + (column.charCodeAt(i) - 'A'.charCodeAt(0) + 1);
+  }
+  return result;
+}
+
+/**
+ * Convert column number (1, 2, ..., 26, 27, 28, ...) to letter (A, B, ..., Z, AA, AB, ...)
+ * @param num - Column number (1-based)
+ * @returns Column letter(s)
+ */
+export function columnNumberToLetter(num: number): string {
+  let result = '';
+  while (num > 0) {
+    num--;
+    result = String.fromCharCode('A'.charCodeAt(0) + (num % 26)) + result;
+    num = Math.floor(num / 26);
+  }
+  return result;
+}