@iyulab/chat-components 0.4.0 → 0.5.1

package/dist/components/widgets/UWidget.component.js

@@ -1,140 +0,0 @@
-import { html, nothing } from 'lit';
-import { property, state } from 'lit/decorators.js';
-import { UJsonElement } from '@iyulab/components/dist/components/UJsonElement.js';
-import { USkeleton } from '@iyulab/components/dist/components/skeleton/USkeleton.component.js';
-import { styles } from './UWidget.styles.js';
-
-var __defProp = Object.defineProperty;
-var __decorateClass = (decorators, target, key, kind) => {
-  var result = void 0 ;
-  for (var i = decorators.length - 1, decorator; i >= 0; i--)
-    if (decorator = decorators[i])
-      result = (decorator(target, key, result) ) || result;
-  if (result) __defProp(target, key, result);
-  return result;
-};
-const DEFAULT_BLACKLIST = ["innerHTML", "outerHTML", "textContent", "innerText", "outerText", "srcdoc"];
-class UWidget extends UJsonElement {
-  constructor() {
-    super(...arguments);
-    this.loading = false;
-    this.blacklist = DEFAULT_BLACKLIST;
-    this.element = null;
-  }
-  static {
-    this.styles = [super.styles, styles];
-  }
-  static {
-    this.dependencies = {
-      "u-skeleton": USkeleton
-    };
-  }
-  willUpdate(changedProperties) {
-    super.willUpdate(changedProperties);
-    if (changedProperties.has("tag")) {
-      this.updateElement(this.tag);
-    }
-    if (changedProperties.has("properties") && this.element) {
-      this.updateProperties(this.element, this.properties);
-    }
-    if (changedProperties.has("blacklist") && this.element && this.properties) {
-      this.updateProperties(this.element, this.properties);
-    }
-  }
-  render() {
-    if (this.loading === true) {
-      return html`
-        <div class="sk-container">
-          <div class="sk-card">
-            <u-skeleton effect="shimmer" width="100%" height="5em"   shape="default"></u-skeleton>
-            <u-skeleton effect="shimmer" width="80%"  height="0.8em" shape="rounded"></u-skeleton>
-            <u-skeleton effect="shimmer" width="40%"  height="0.75em" shape="rounded"></u-skeleton>
-          </div>
-          <div class="sk-doc">
-            <u-skeleton effect="shimmer" width="40%"  height="0.75em" shape="rounded"></u-skeleton>
-            <u-skeleton effect="shimmer" width="80%"  height="0.75em" shape="rounded"></u-skeleton>
-            <u-skeleton effect="shimmer" width="60%" height="0.8em"  shape="rounded"></u-skeleton>
-            <u-skeleton effect="shimmer" width="100%" height="0.8em"  shape="rounded"></u-skeleton>
-            <u-skeleton effect="shimmer" width="80%"  height="0.8em"  shape="rounded"></u-skeleton>
-          </div>
-        </div>`;
-    }
-    if (this.element != null) {
-      return this.element;
-    }
-    return nothing;
-  }
-  /** 
-   * `loading`이 `true`인 경우, 에러 UI로 대체하지 않습니다. 
-   */
-  async error(error) {
-    if (this.loading) return;
-    await super.error(error);
-  }
-  /**
-   * `tag` 프로퍼티에 등록된 커스텀 엘리먼트를 렌더링하는 컴포넌트입니다.
-   * `tag`가 변경될 때마다 등록된 커스텀 엘리먼트를 새로 생성하여 렌더링합니다.
-   * `tag`가 유효하지 않거나 등록된 커스텀 엘리먼트가 아닌 경우, 에러 처리합니다.
-   */
-  updateElement(tag) {
-    tag = tag?.trim();
-    if (!tag) {
-      this.element = null;
-      void super.error(new Error("Tag is required"));
-      return;
-    }
-    if (!customElements.get(tag)) {
-      this.element = null;
-      void super.error(new Error(`Unknown tag: ${tag}`));
-      return;
-    }
-    this.element = document.createElement(tag);
-  }
-  /**
-   * `properties` 객체의 키가 렌더링된 엘리먼트의 프로퍼티 이름과 일치하면 자동으로 할당됩니다.
-   * `properties` 객체에 위험한 프로퍼티가 포함되어 있는지 검증하여, 유효한 경우에만 할당합니다.
-   * 할당 중 오류가 발생한 경우, 에러 처리합니다.
-   */
-  updateProperties(element, props) {
-    if (this.validateProperties(props)) {
-      try {
-        Object.assign(element, props);
-      } catch (error) {
-        void super.error(error);
-      }
-    } else {
-      void super.error(new Error(`Not allowed properties: ${JSON.stringify(props)}`));
-    }
-  }
-  /**
-   * `properties` 객체에 위험한 프로퍼티가 포함되어 있는지 검증합니다.
-   * DOM 조작이나 이벤트 핸들러로 악용될 수 있는 프로퍼티를 최소한으로 차단합니다.
-   */
-  validateProperties(props) {
-    if (typeof props !== "object" || props === null || Array.isArray(props)) {
-      return false;
-    }
-    const obj = props;
-    for (const key of Object.keys(obj)) {
-      if (this.blacklist.includes(key)) return false;
-    }
-    return true;
-  }
-}
-__decorateClass([
-  property({ type: Boolean, reflect: true })
-], UWidget.prototype, "loading");
-__decorateClass([
-  property({ type: String })
-], UWidget.prototype, "tag");
-__decorateClass([
-  property({ type: Object })
-], UWidget.prototype, "properties");
-__decorateClass([
-  property({ type: Array })
-], UWidget.prototype, "blacklist");
-__decorateClass([
-  state()
-], UWidget.prototype, "element");
-
-export { UWidget };

package/dist/components/widgets/UWidget.d.ts

@@ -1,7 +0,0 @@
-import { UWidget } from './UWidget.component.js';
-declare global {
-    interface HTMLElementTagNameMap {
-        "u-widget": UWidget;
-    }
-}
-export { UWidget };

package/dist/components/widgets/UWidget.js

@@ -1,5 +0,0 @@
-import { UWidget } from './UWidget.component.js';
-
-UWidget.define("u-widget");
-
-export { UWidget };

package/dist/components/widgets/UWidget.styles.d.ts

@@ -1 +0,0 @@
-export declare const styles: import('lit').CSSResult;

package/dist/events/UCancelEvent.d.ts

@@ -1,6 +0,0 @@
-export type UCancelEvent = CustomEvent<undefined>;
-declare global {
-    interface HTMLElementEventMap {
-        'u-cancel': UCancelEvent;
-    }
-}

package/dist/events/USubmitEvent.d.ts

@@ -1,6 +0,0 @@
-export type USubmitEvent = CustomEvent<string>;
-declare global {
-    interface HTMLElementEventMap {
-        'u-submit': USubmitEvent;
-    }
-}

package/dist/types/Actions.d.ts

@@ -1,24 +0,0 @@
-import { JsonSchema } from '../types/JsonSchema.js';
-/** LLM에서 action-json 블록으로 출력되는 구조입니다.*/
-export interface ActionSchema {
-    type: string;
-    properties?: Record<string, unknown>;
-}
-/** Action 정의 구조체 */
-export interface ActionDefinition {
-    /** action 식별자 (action-json의 "type" 필드와 매칭) */
-    type: string;
-    /** LLM용 설명 */
-    description: string;
-    /** LLM용 속성 스키마 */
-    properties?: Record<string, JsonSchema>;
-}
-/** 프리셋 Action 비트 플래그 */
-export declare enum PresetAction {
-    Questions = 1,
-    All = 1
-}
-/** 프리셋 Action 목록 (비트 플래그 순서대로) */
-export declare const PRESET_ACTION_LIST: readonly [PresetAction];
-/** 프리셋 Action 정의 매핑 */
-export declare const PRESET_ACTION_DEFINITIONS: Map<PresetAction, ActionDefinition>;

package/dist/types/Actions.js

@@ -1,34 +0,0 @@
-var PresetAction = /* @__PURE__ */ ((PresetAction2) => {
-  PresetAction2[PresetAction2["Questions"] = 1] = "Questions";
-  PresetAction2[PresetAction2["All"] = 1 /* Questions */] = "All";
-  return PresetAction2;
-})(PresetAction || {});
-const PRESET_ACTION_LIST = [
-  1 /* Questions */
-];
-const PRESET_ACTION_DEFINITIONS = /* @__PURE__ */ new Map([
-  [
-    1 /* Questions */,
-    {
-      type: "question",
-      description: "Present a question to the user with clickable choices",
-      properties: {
-        question: {
-          type: "string",
-          description: 'Optional question text displayed above the choices (e.g. "What would you like to explore?")',
-          examples: ["What would you like to do next?"]
-        },
-        choices: {
-          type: "array",
-          items: { type: "string" },
-          minItems: 1,
-          maxItems: 5,
-          description: "Clickable choice buttons (1–5 items)",
-          examples: [["What are the main differences?", "Can you show me an example?", "What should I learn next?"]]
-        }
-      }
-    }
-  ]
-]);
-
-export { PRESET_ACTION_DEFINITIONS, PRESET_ACTION_LIST, PresetAction };

package/dist/types/Widgets.js

@@ -1,115 +0,0 @@
-import { UImagesWidget } from '../components/widgets/UImagesWidget.component.js';
-import { UVideoWidget } from '../components/widgets/UVideoWidget.component.js';
-import { UMapWidget } from '../components/widgets/UMapWidget.component.js';
-import { UChartWidget } from '../components/widgets/UChartWidget.component.js';
-
-var PresetWidget = /* @__PURE__ */ ((PresetWidget2) => {
-  PresetWidget2[PresetWidget2["Images"] = 1] = "Images";
-  PresetWidget2[PresetWidget2["Video"] = 2] = "Video";
-  PresetWidget2[PresetWidget2["Map"] = 8] = "Map";
-  PresetWidget2[PresetWidget2["Chart"] = 16] = "Chart";
-  PresetWidget2[PresetWidget2["All"] = 27] = "All";
-  return PresetWidget2;
-})(PresetWidget || {});
-const PRESET_WIDGET_LIST = [
-  1 /* Images */,
-  2 /* Video */,
-  8 /* Map */,
-  16 /* Chart */
-];
-const PRESET_WIDGET_DEFINITIONS = /* @__PURE__ */ new Map([
-  [
-    1 /* Images */,
-    {
-      element: UImagesWidget,
-      tag: "u-images-widget",
-      description: "Display multiple images in a scrollable gallery",
-      properties: {
-        items: {
-          type: "array",
-          items: {
-            type: "object",
-            properties: {
-              src: { type: "string", description: "Image URL" },
-              alt: { type: "string", description: "Alt text for accessibility" },
-              caption: { type: "string", description: "Image caption" }
-            },
-            required: ["src"]
-          },
-          minItems: 1,
-          description: "Array of image objects"
-        }
-      },
-      required: ["items"]
-    }
-  ],
-  [
-    2 /* Video */,
-    {
-      element: UVideoWidget,
-      tag: "u-video-widget",
-      description: "Embed video from YouTube, Vimeo, or Others. Provide a direct video file URL or a platform URL.",
-      properties: {
-        src: { type: "string", description: "Video URL (YouTube, Vimeo, or direct video file URL)" },
-        poster: { type: "string", description: "Poster image URL" },
-        ratio: {
-          type: "string",
-          enum: ["16:9", "4:3", "1:1"],
-          default: "16:9",
-          description: "Video aspect ratio"
-        }
-      },
-      required: ["src"]
-    }
-  ],
-  [
-    8 /* Map */,
-    {
-      element: UMapWidget,
-      tag: "u-map-widget",
-      description: "Display a map showing a single location",
-      properties: {
-        lat: { type: "number", description: "Latitude coordinate" },
-        lng: { type: "number", description: "Longitude coordinate" },
-        zoom: {
-          type: "integer",
-          minimum: 1,
-          maximum: 20,
-          default: 15,
-          description: "Map zoom level"
-        },
-        label: { type: "string", description: "Location title" },
-        description: { type: "string", description: "Location description" }
-      },
-      required: ["lat", "lng"]
-    }
-  ],
-  [
-    16 /* Chart */,
-    {
-      element: UChartWidget,
-      tag: "u-chart-widget",
-      description: "Display charts using Chart.js v4 format. Use standard Chart.js configuration (type, data, options). The widget accepts the exact same structure as Chart.js - no conversion needed.",
-      properties: {
-        type: {
-          type: "string",
-          enum: ["bar", "line", "pie", "doughnut", "radar", "polarArea", "bubble", "scatter"],
-          description: "Chart.js chart type"
-        },
-        data: {
-          type: "object",
-          description: "Chart.js data configuration",
-          additionalProperties: true
-        },
-        options: {
-          type: "object",
-          description: "Chart.js options configuration (optional)",
-          additionalProperties: true
-        }
-      },
-      required: ["type", "data"]
-    }
-  ]
-]);
-
-export { PRESET_WIDGET_DEFINITIONS, PRESET_WIDGET_LIST, PresetWidget };

package/dist/utilities/ActionPromptBuilder.d.ts

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

package/dist/utilities/ActionPromptBuilder.js

@@ -1,93 +0,0 @@
-import template from '../assets/action-prompt.md.js';
-import { PRESET_ACTION_LIST, PRESET_ACTION_DEFINITIONS } from '../types/Actions.js';
-
-class ActionPromptBuilder {
-  constructor() {
-    this.actions = /* @__PURE__ */ new Map();
-  }
-  /**
-   * 싱글톤 인스턴스를 반환합니다. 최초 호출 시 인스턴스가 생성됩니다.
-   */
-  static get instance() {
-    if (!this._instance) {
-      this._instance = new ActionPromptBuilder();
-    }
-    return this._instance;
-  }
-  /**
-   * Action 정의를 등록합니다. 같은 type이 이미 등록되어 있으면 에러를 던집니다.
-   * @throws {Error} 같은 type의 action이 이미 등록된 경우
-   */
-  add(definition) {
-    if (this.actions.has(definition.type)) {
-      throw new Error(`Action with type "${definition.type}" is already registered.`);
-    }
-    this.actions.set(definition.type, definition);
-    return this;
-  }
-  /**
-   * 미리 정의된 프리셋 Action을 등록합니다.
-   * @example
-   * ActionPromptBuilder.use(PresetAction.Questions);
-   * ActionPromptBuilder.use(PresetAction.All);
-   */
-  use(flags) {
-    for (const flag of PRESET_ACTION_LIST) {
-      if (flags & flag) {
-        const definition = PRESET_ACTION_DEFINITIONS.get(flag);
-        if (definition && !this.actions.has(definition.type)) {
-          this.actions.set(definition.type, definition);
-        }
-      }
-    }
-    return this;
-  }
-  /**
-   * 등록된 action들에 대한 LLM 시스템 프롬프트 인스트럭션을 생성합니다.
-   */
-  build() {
-    if (this.actions.size === 0) return "";
-    const defs = Array.from(this.actions.values());
-    const actionList = defs.map((d) => `- \`${d.type}\`: ${d.description}`).join("\n");
-    const actionDocs = defs.map((def) => {
-      const lines = [
-        `### ${def.type}`,
-        "",
-        def.description,
-        "",
-        `**Type:** \`${def.type}\``
-      ];
-      if (def.properties) {
-        lines.push(
-          "",
-          "**Properties (JSON Schema):**",
-          "```json",
-          JSON.stringify({ type: "object", properties: def.properties }, null, 2),
-          "```"
-        );
-      }
-      return lines.join("\n");
-    }).join("\n\n---\n\n");
-    return template.replace("{{ACTION_LIST}}", actionList).replace("{{ACTION_DOCS}}", actionDocs);
-  }
-  /**
-   * LLM 응답 텍스트에서 `action-json` 코드블록을 추출합니다.
-   * 
-   * @param value - LLM 응답 텍스트
-   * @returns `[actions, rest]` — actions는 파싱된 JSON 객체 배열, rest는 블록이 제거된 나머지 텍스트
-   */
-  parse(value) {
-    const pattern = /```action-json\s*([\s\S]*?)```/g;
-    const actions = [];
-    const rest = value.replace(pattern, (_, json) => {
-      try {
-        actions.push(JSON.parse(json.trim()));
-      } catch {
-      }
-      return "";
-    }).trim();
-    return [actions, rest];
-  }
-}
-
-export { ActionPromptBuilder };

package/dist/utilities/WidgetPromptBuilder.d.ts

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

package/dist/utilities/WidgetPromptBuilder.js

@@ -1,87 +0,0 @@
-import template from '../assets/widget-prompt.md.js';
-import { UElement } from '@iyulab/components/dist/components/UElement.js';
-import { PRESET_WIDGET_LIST, PRESET_WIDGET_DEFINITIONS } from '../types/Widgets.js';
-
-class WidgetPromptBuilder {
-  constructor() {
-    this.widgets = /* @__PURE__ */ new Map();
-  }
-  /**
-   * 싱글톤 인스턴스를 반환합니다. 최초 호출 시 인스턴스가 생성됩니다.
-   */
-  static get instance() {
-    if (!this._instance) {
-      this._instance = new WidgetPromptBuilder();
-    }
-    return this._instance;
-  }
-  /**
-   * 위젯 정의를 등록합니다. 같은 이름의 위젯이 이미 등록되어 있으면 에러를 던집니다.
-   * @throws {Error} 같은 이름의 위젯이 이미 등록된 경우 또는 같은 태그의 커스텀 요소가 다른 클래스에 의해 정의된 경우
-   */
-  add(definition) {
-    if (this.widgets.has(definition.tag)) {
-      throw new Error(`Widget with tag "${definition.tag}" is already registered.`);
-    }
-    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.`);
-    }
-    if (definition.element.prototype instanceof UElement) {
-      definition.element.define(definition.tag);
-    } else {
-      customElements.define(definition.tag, definition.element);
-    }
-    this.widgets.set(definition.tag, definition);
-    return this;
-  }
-  /**
-   * 미리 정의된 프리셋 위젯을 사용합니다.
-   * @example
-   * WidgetRegistry.use(Widget.Images | Widget.Chart);
-   * WidgetRegistry.use(Widget.All);
-   */
-  use(flags) {
-    for (const flag of PRESET_WIDGET_LIST) {
-      if (flags & flag) {
-        const definition = PRESET_WIDGET_DEFINITIONS.get(flag);
-        if (definition) {
-          this.add(definition);
-        }
-      }
-    }
-    return this;
-  }
-  /**
-   * 등록된 위젯들에 대한 LLM 인스트럭션 문자열을 생성합니다.
-   */
-  build() {
-    if (this.widgets.size === 0) return "";
-    const widgets = Array.from(this.widgets.values());
-    const widgetList = widgets.map((w) => `- \`${w.tag}\`: ${w.description}`).join("\n");
-    const widgetDocs = widgets.map((w) => {
-      const lines = [
-        `### ${w.tag}`,
-        "",
-        `**Tag:** \`${w.tag}\``
-      ];
-      if (w.properties) {
-        lines.push(
-          "",
-          "**Properties (JSON Schema):**",
-          "```json",
-          JSON.stringify({
-            type: "object",
-            properties: w.properties,
-            ...w.required ? { required: w.required } : {}
-          }, null, 2),
-          "```"
-        );
-      }
-      return lines.join("\n");
-    }).join("\n\n---\n\n");
-    return template.replace("{{WIDGET_LIST}}", widgetList).replace("{{WIDGET_DOCS}}", widgetDocs);
-  }
-}
-
-export { WidgetPromptBuilder };

package/dist/utilities/converters.d.ts

@@ -1,9 +0,0 @@
-import { JsonNode } from '../types/JsonNode';
-/**
- * 이 컨버터는 JsonNode 타입을 사용하여 JSON 데이터를 처리합니다.
- * 문자열 어트리뷰트로 전달된 JSON 문자열을 객체로 변환/직렬화합니다.
- */
-export declare const jsonAttrConverter: {
-    fromAttribute: (value: string | null) => JsonNode;
-    toAttribute: (value: JsonNode) => string;
-};

package/dist/utilities/converters.js

@@ -1,19 +0,0 @@
-const jsonAttrConverter = {
-  fromAttribute: (value) => {
-    if (!value || !value.trim()) return {};
-    try {
-      return JSON.parse(value);
-    } catch {
-      return {};
-    }
-  },
-  toAttribute: (value) => {
-    try {
-      return JSON.stringify(value);
-    } catch {
-      return "{}";
-    }
-  }
-};
-
-export { jsonAttrConverter };