@iyulab/chat-components 0.6.0 → 0.7.0

package/dist/utilities/IntentPromptBuilder.d.ts

@@ -1,40 +0,0 @@
-import { PresetIntent, IntentDefinition, IntentSchema } from '../types/Intents.js';
-/**
- * Intent 등록, LLM 인스트럭션 빌드, 텍스트 추출을 통합 제공하는 유틸리티
- *
- * @example
- * IntentPromptBuilder.use(PresetIntent.All);
- * const prompt = IntentPromptBuilder.buildPrompt();
- * const [clean, templates] = IntentPromptBuilder.extractPrompt(llmText);
- */
-export declare class IntentPromptBuilder {
-    private static _instance;
-    private intents;
-    /**
-     * 싱글톤 인스턴스를 반환합니다. 최초 호출 시 인스턴스가 생성됩니다.
-     */
-    static get instance(): IntentPromptBuilder;
-    /**
-     * Intent 정의를 등록합니다. 같은 type이 이미 등록되어 있으면 에러를 던집니다.
-     * @throws {Error} 같은 type의 intent가 이미 등록된 경우
-     */
-    add(definition: IntentDefinition): IntentPromptBuilder;
-    /**
-     * 미리 정의된 프리셋 Intent를 등록합니다.
-     * @example
-     * IntentPromptBuilder.use(PresetIntent.Questions);
-     * IntentPromptBuilder.use(PresetIntent.All);
-     */
-    use(flags: PresetIntent): IntentPromptBuilder;
-    /**
-     * 등록된 intent들에 대한 LLM 시스템 프롬프트 인스트럭션을 생성합니다.
-     */
-    build(): string;
-    /**
-     * LLM 응답 텍스트에서 `intent-json` 코드블록을 추출합니다.
-     *
-     * @param value - LLM 응답 텍스트
-     * @returns `[intents, rest]` — intents는 파싱된 JSON 객체 배열, rest는 블록이 제거된 나머지 텍스트
-     */
-    parse(value: string): [IntentSchema[], string];
-}

package/dist/utilities/IntentPromptBuilder.js

@@ -1,95 +0,0 @@
-import { PRESET_INTENT_DEFINITIONS, PRESET_INTENT_LIST } from "../types/Intents.js";
-import intent_prompt_md_default from "../_virtual/_glob-assets_raw/intent-prompt.md.1907474e.js";
-//#region src/utilities/IntentPromptBuilder.ts
-/**
-* Intent 등록, LLM 인스트럭션 빌드, 텍스트 추출을 통합 제공하는 유틸리티
-*
-* @example
-* IntentPromptBuilder.use(PresetIntent.All);
-* const prompt = IntentPromptBuilder.buildPrompt();
-* const [clean, templates] = IntentPromptBuilder.extractPrompt(llmText);
-*/
-var IntentPromptBuilder = class IntentPromptBuilder {
-	constructor() {
-		this.intents = /* @__PURE__ */ new Map();
-	}
-	/**
-	* 싱글톤 인스턴스를 반환합니다. 최초 호출 시 인스턴스가 생성됩니다.
-	*/
-	static get instance() {
-		if (!this._instance) this._instance = new IntentPromptBuilder();
-		return this._instance;
-	}
-	/**
-	* Intent 정의를 등록합니다. 같은 type이 이미 등록되어 있으면 에러를 던집니다.
-	* @throws {Error} 같은 type의 intent가 이미 등록된 경우
-	*/
-	add(definition) {
-		if (this.intents.has(definition.type)) throw new Error(`Intent with type "${definition.type}" is already registered.`);
-		this.intents.set(definition.type, definition);
-		return this;
-	}
-	/**
-	* 미리 정의된 프리셋 Intent를 등록합니다.
-	* @example
-	* IntentPromptBuilder.use(PresetIntent.Questions);
-	* IntentPromptBuilder.use(PresetIntent.All);
-	*/
-	use(flags) {
-		for (const flag of PRESET_INTENT_LIST) if (flags & flag) {
-			const definition = PRESET_INTENT_DEFINITIONS.get(flag);
-			if (definition && !this.intents.has(definition.type)) this.intents.set(definition.type, definition);
-		}
-		return this;
-	}
-	/**
-	* 등록된 intent들에 대한 LLM 시스템 프롬프트 인스트럭션을 생성합니다.
-	*/
-	build() {
-		if (this.intents.size === 0) return "";
-		const docs = Array.from(this.intents.values()).map((def) => {
-			return [
-				`### ${def.type}`,
-				"",
-				"**JSON Schema:**",
-				"```intent-json",
-				JSON.stringify({
-					type: "object",
-					description: def.description,
-					properties: {
-						type: {
-							type: "string",
-							enum: [def.type]
-						},
-						properties: {
-							type: "object",
-							properties: def.properties || {},
-							required: def.required || []
-						}
-					},
-					required: ["type"]
-				}, null, 2),
-				"```"
-			].join("\n");
-		}).join("\n\n---\n\n");
-		return intent_prompt_md_default.replace("{{INTENT_DOCS}}", docs);
-	}
-	/**
-	* LLM 응답 텍스트에서 `intent-json` 코드블록을 추출합니다.
-	* 
-	* @param value - LLM 응답 텍스트
-	* @returns `[intents, rest]` — intents는 파싱된 JSON 객체 배열, rest는 블록이 제거된 나머지 텍스트
-	*/
-	parse(value) {
-		const pattern = /```(?:intent-json)\s*([\s\S]*?)```/g;
-		const intents = [];
-		return [intents, value.replace(pattern, (_, json) => {
-			try {
-				intents.push(JSON.parse(json.trim()));
-			} catch {}
-			return "";
-		}).trim()];
-	}
-};
-//#endregion
-export { IntentPromptBuilder };

package/dist/utilities/ViewPromptBuilder.d.ts

@@ -1,28 +0,0 @@
-import { PresetView, ViewDefinition } from '../types/Views.js';
-/**
- * 뷰 등록, LLM 인스트럭션 빌드, HTML 렌더링을 통합 제공하는 유틸리티
- */
-export declare class ViewPromptBuilder {
-    private static _instance;
-    private views;
-    /**
-     * 싱글톤 인스턴스를 반환합니다. 최초 호출 시 인스턴스가 생성됩니다.
-     */
-    static get instance(): ViewPromptBuilder;
-    /**
-     * 뷰 정의를 등록합니다. 같은 이름의 뷰이 이미 등록되어 있으면 에러를 던집니다.
-     * @throws {Error} 같은 이름의 뷰이 이미 등록된 경우 또는 같은 태그의 커스텀 요소가 다른 클래스에 의해 정의된 경우
-     */
-    add(definition: ViewDefinition): ViewPromptBuilder;
-    /**
-     * 미리 정의된 프리셋 뷰을 사용합니다.
-     * @example
-     * ViewRegistry.use(View.Images | View.Chart);
-     * ViewRegistry.use(View.All);
-     */
-    use(flags: PresetView): ViewPromptBuilder;
-    /**
-     * 등록된 뷰들에 대한 LLM 인스트럭션 문자열을 생성합니다.
-     */
-    build(): string;
-}

package/dist/utilities/ViewPromptBuilder.js

@@ -1,78 +0,0 @@
-import { PRESET_VIEW_DEFINITIONS, PRESET_VIEW_LIST } from "../types/Views.js";
-import view_prompt_md_default from "../_virtual/_glob-assets_raw/view-prompt.md.e0dbcffe.js";
-//#region src/utilities/ViewPromptBuilder.ts
-/**
-* 뷰 등록, LLM 인스트럭션 빌드, HTML 렌더링을 통합 제공하는 유틸리티
-*/
-var ViewPromptBuilder = class ViewPromptBuilder {
-	constructor() {
-		this.views = /* @__PURE__ */ new Map();
-	}
-	/**
-	* 싱글톤 인스턴스를 반환합니다. 최초 호출 시 인스턴스가 생성됩니다.
-	*/
-	static get instance() {
-		if (!this._instance) this._instance = new ViewPromptBuilder();
-		return this._instance;
-	}
-	/**
-	* 뷰 정의를 등록합니다. 같은 이름의 뷰이 이미 등록되어 있으면 에러를 던집니다.
-	* @throws {Error} 같은 이름의 뷰이 이미 등록된 경우 또는 같은 태그의 커스텀 요소가 다른 클래스에 의해 정의된 경우
-	*/
-	add(definition) {
-		if (this.views.has(definition.tag)) throw new Error(`View with tag "${definition.tag}" is already registered.`);
-		if (definition.element) {
-			const constructor = customElements.get(definition.tag);
-			if (constructor && constructor !== definition.element) throw new Error(`Custom element with tag "${definition.tag}" is already defined to a different class.`);
-		}
-		this.views.set(definition.tag, definition);
-		return this;
-	}
-	/**
-	* 미리 정의된 프리셋 뷰을 사용합니다.
-	* @example
-	* ViewRegistry.use(View.Images | View.Chart);
-	* ViewRegistry.use(View.All);
-	*/
-	use(flags) {
-		for (const flag of PRESET_VIEW_LIST) if (flags & flag) {
-			const definition = PRESET_VIEW_DEFINITIONS.get(flag);
-			if (definition) this.add(definition);
-		}
-		return this;
-	}
-	/**
-	* 등록된 뷰들에 대한 LLM 인스트럭션 문자열을 생성합니다.
-	*/
-	build() {
-		if (this.views.size === 0) return "";
-		const docs = Array.from(this.views.values()).map((def) => {
-			return [
-				`### ${def.tag}`,
-				"",
-				"**JSON Schema:**",
-				"```view-json",
-				JSON.stringify({
-					type: "object",
-					description: def.description,
-					properties: {
-						tag: {
-							type: "string",
-							enum: [def.tag]
-						},
-						properties: {
-							type: "object",
-							properties: def.properties || {},
-							required: def.required || []
-						}
-					},
-					required: ["tag"]
-				}, null, 2),
-				"```"
-			].join("\n");
-		}).join("\n\n---\n\n");
-		return view_prompt_md_default.replace("{{VIEW_DOCS}}", docs);
-	}
-};
-//#endregion
-export { ViewPromptBuilder };

package/dist/utilities/dom-agent/DOMAgent.d.ts

@@ -1,74 +0,0 @@
-import { DOMScanner } from './DOMScanner.js';
-import { DOMController } from './DOMController.js';
-import { ScanResult, ScanOptions, DOMCommand, ExecutionResult, HistoryItem, AutomationOptions, LLMCallback, ScanDiff } from './types.js';
-/**
- * DOM Agent 통합 오케스트레이터
- * Scanner와 Controller를 조합하여 전체 워크플로우 관리
- */
-export declare class DOMAgent extends EventTarget {
-    private scanner;
-    private controller;
-    private history;
-    private currentScan;
-    private lastScanRoot;
-    constructor();
-    /**
-     * 초기 스캔 및 세션 시작
-     */
-    start(root?: Element | ShadowRoot, options?: ScanOptions & {
-        includeScreenshot?: boolean;
-    }): Promise<ScanResult>;
-    /**
-     * 명령 실행 후 재스캔
-     */
-    executeAndRescan(commands: DOMCommand | DOMCommand[], options?: ScanOptions & {
-        includeScreenshot?: boolean;
-    }): Promise<{
-        execution: ExecutionResult[];
-        scan: ScanResult;
-    }>;
-    /**
-     * 현재 상태 가져오기
-     */
-    getCurrentState(): ScanResult | null;
-    /**
-     * 히스토리 조회
-     */
-    getHistory(): HistoryItem[];
-    /**
-     * 히스토리 초기화
-     */
-    clearHistory(): void;
-    /**
-     * 자동 모드: LLM 콜백과 함께 반복 실행
-     */
-    automate(llmCallback: LLMCallback, options?: AutomationOptions): Promise<void>;
-    /**
-     * 특정 요소 스캔
-     */
-    scanElement(elementId: string, options?: ScanOptions): Promise<ScanResult>;
-    /**
-     * 에러 이벤트 발생
-     */
-    private dispatchError;
-    /**
-     * 스크린샷 캡처 (html2canvas 사용)
-     */
-    private captureScreenshot;
-    /**
-     * Scanner 인스턴스 가져오기 (고급 사용)
-     */
-    getScanner(): DOMScanner;
-    /**
-     * Controller 인스턴스 가져오기 (고급 사용)
-     */
-    getController(): DOMController;
-    /**
-     * 이전 스캔과 현재 스캔 비교 (Diff)
-     */
-    scanDiff(previousScan: ScanResult, currentScan: ScanResult): ScanDiff;
-    /**
-     * 요소 변경 여부 확인
-     */
-    private isElementModified;
-}

package/dist/utilities/dom-agent/DOMController.d.ts

@@ -1,78 +0,0 @@
-import { DOMCommand, ExecutionResult } from './types.js';
-import { DOMScanner } from './DOMScanner.js';
-/**
- * DOM 명령 실행 엔진
- * LLM의 명령을 파싱하고 실제 DOM 조작 수행
- */
-export declare class DOMController {
-    private scanner;
-    constructor(scanner: DOMScanner);
-    /**
-     * 단일 명령 실행
-     */
-    execute(command: DOMCommand): Promise<ExecutionResult>;
-    /**
-     * 여러 명령 순차 실행
-     */
-    executeMany(commands: DOMCommand[]): Promise<ExecutionResult[]>;
-    /**
-     * 명령 실행 (내부)
-     */
-    private executeCommand;
-    /**
-     * 클릭 이벤트 실행
-     */
-    private click;
-    /**
-     * 텍스트 입력 (자연스러운 타이핑 시뮬레이션)
-     */
-    private input;
-    /**
-     * 옵션 선택
-     */
-    private selectOption;
-    /**
-     * 포커스
-     */
-    private focus;
-    /**
-     * 블러 (포커스 해제)
-     */
-    private blur;
-    /**
-     * 스크롤
-     */
-    private scroll;
-    /**
-     * 요소로 스크롤
-     */
-    private scrollTo;
-    /**
-     * 마우스 오버 (호버)
-     */
-    private hover;
-    /**
-     * 입력 필드 초기화
-     */
-    private clear;
-    /**
-     * 체크박스/라디오 토글
-     */
-    private check;
-    /**
-     * 대기
-     */
-    private wait;
-    /**
-     * 페이지 네비게이션 대기
-     */
-    private waitForNavigation;
-    /**
-     * 사람처럼 보이는 랜덤 딜레이
-     */
-    private simulateHumanDelay;
-    /**
-     * ID로 요소 가져오기 (Scanner의 매핑 활용)
-     */
-    private getElement;
-}

package/dist/utilities/dom-agent/DOMPromptBuilder.d.ts

@@ -1,54 +0,0 @@
-import { ScanResult, DOMCommand } from './types.js';
-/**
- * DOMPromptBuilder
- * ScanResult를 LLM이 이해하기 쉬운 프롬프트로 변환하고, LLM 응답에서 명령을 추출합니다.
- */
-export declare class DOMPromptBuilder {
-    private template;
-    constructor(template?: string);
-    /**
-     * 기본 프롬프트 템플릿
-     */
-    private getDefaultTemplate;
-    /**
-     * LLM 프롬프트 생성
-     */
-    buildPrompt(scan: ScanResult, options?: {
-        maxElements?: number;
-        includeInvisible?: boolean;
-        contextHint?: string;
-        template?: string;
-    }): string;
-    /**
-     * LLM 응답에서 명령 추출
-     */
-    extractCommands(llmResponse: string): DOMCommand[];
-    /**
-     * 명령 객체 정규화
-     */
-    private normalizeCommand;
-    /**
-     * 요소 리스트를 LLM 친화적 텍스트로 변환
-     */
-    private summarizeElements;
-    /**
-     * 단일 요소를 텍스트로 표현
-     */
-    private elementToText;
-    /**
-     * 스크린샷을 멀티모달 메시지로 변환 (Anthropic Claude, OpenAI GPT-4V 형식)
-     */
-    formatMultimodalMessage(scan: ScanResult, options?: {
-        maxElements?: number;
-        contextHint?: string;
-        screenshotFormat?: 'anthropic' | 'openai';
-    }): any;
-    /**
-     * 템플릿 변경
-     */
-    setTemplate(template: string): void;
-    /**
-     * 현재 템플릿 가져오기
-     */
-    getTemplate(): string;
-}

package/dist/utilities/dom-agent/DOMScanner.d.ts

@@ -1,83 +0,0 @@
-import { ScanResult, ScanOptions } from './types.js';
-/**
- * DOM 스캔 엔진
- * Shadow DOM을 포함한 전체 DOM 트리를 순회하며 인터랙티브 요소를 추출
- */
-export declare class DOMScanner {
-    private elementMap;
-    private idMap;
-    private totalElementsScanned;
-    private debug;
-    private cachedScan;
-    private prioritizeLandmarks;
-    /**
-     * DOM 스캔 수행 (Shadow DOM 포함)
-     * @param root 스캔 시작 루트 (기본값 document.body)
-     * @param options 스캔 옵션
-     */
-    scan(root?: Element | ShadowRoot, options?: ScanOptions): ScanResult;
-    /**
-     * ID로 요소 객체 가져오기 (빠른 조회)
-     */
-    getElement(id: string): Element | undefined;
-    /**
-     * 요소에서 ID 가져오기
-     */
-    getElementId(element: Element): string | undefined;
-    /**
-     * 단일 요소를 스캔하고 Shadow DOM도 탐색
-     */
-    private scanElement;
-    /**
-     * Shadow DOM 내부 스캔
-     */
-    private scanShadowRoot;
-    /**
-     * 인터랙티브 요소 여부 판단
-     */
-    private isInteractive;
-    /**
-     * 필터링 기준 충족 여부 (LLM에게 보여줄 가치가 있는지)
-     */
-    private shouldInclude;
-    /**
-     * 짧은 랜덤 ID 생성 (예: elm_a1b2c3)
-     */
-    private generateId;
-    /**
-     * 요소 정보 추출
-     */
-    private getElementInfo;
-    /**
-     * 요소의 레이블 가져오기
-     */
-    private getLabel;
-    /**
-     * 요소 타입 결정
-     */
-    private getElementType;
-    /**
-     * 요소가 시각적으로 보이는지 확인
-     */
-    private isVisible;
-    /**
-     * 우선순위 계산
-     */
-    private calculatePriority;
-    /**
-     * 요소 트리를 평탄화
-     */
-    private flattenElements;
-    /**
-     * 우선순위 기반 필터링
-     */
-    private filterByPriority;
-    /**
-     * DOM 해시 생성 (변경 감지용)
-     */
-    private generateDOMHash;
-    /**
-     * 디버그 로그 출력 (debug 모드일 때만)
-     */
-    private log;
-}

package/dist/utilities/dom-agent/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * DOM Interaction Module
- * LLM이 웹 페이지를 스캔하고 인터랙션할 수 있게 하는 유틸리티
- */
-export { DOMScanner } from './DOMScanner.js';
-export { DOMController } from './DOMController.js';
-export { DOMAgent } from './DOMAgent.js';
-export { DOMPromptBuilder } from './DOMPromptBuilder.js';
-export type { ElementType, ScannedElement, ScanResult, FilterStrategy, ScanOptions, DOMAction, DOMCommand, ExecutionResult, DOMAgentEvents, AutomationOptions, HistoryItem, LLMCallback } from './types.js';