@iyulab/chat-components 0.2.0 → 0.4.0

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

@@ -0,0 +1,140 @@
+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

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

package/dist/components/widgets/UWidget.js

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

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

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

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

@@ -0,0 +1,33 @@
+import { css } from 'lit';
+
+const styles = css`
+  :host {
+    display: contents;
+  }
+
+  /* ── 스켈레톤: 카드(좌) + 문서(우) ── */
+  .sk-container {
+    display: flex;
+    flex-direction: row;
+    align-items: stretch;
+    gap: 1em;
+    margin: 0.75em 0;
+    width: 100%;
+  }
+
+  .sk-card {
+    flex: 0 0 40%;
+    display: flex;
+    flex-direction: column;
+    gap: 0.55em;
+  }
+
+  .sk-doc {
+    flex: 1;
+    display: flex;
+    flex-direction: column;
+    justify-content: space-between;
+  }
+`;
+
+export { styles };

package/dist/index.d.ts

@@ -1,23 +1,36 @@
 export * from './components/blocks/UCodeBlock.js';
+export * from './components/blocks/UFilesBlock.js';
 export * from './components/blocks/UJsonBlock.js';
 export * from './components/blocks/UMarkedBlock.js';
 export * from './components/blocks/UTextBlock.js';
 export * from './components/blocks/UThinkBlock.js';
 export * from './components/blocks/UToolBlock.js';
+export * from './components/blocks/URefBlock.js';
+export * from './components/blocks/UTableBlock.js';
 export * from './components/buttons/UAttachButton.js';
 export * from './components/buttons/UCopyButton.js';
 export * from './components/buttons/UVoteButton.js';
 export * from './components/buttons/UReportButton.js';
 export * from './components/buttons/URetryButton.js';
 export * from './components/buttons/UShareButton.js';
-export * from './components/loaders/UDotLoader.js';
 export * from './components/message/UMessage.js';
 export * from './components/prompt/UPrompt.js';
 export * from './components/references/URefTag.js';
 export * from './components/references/URefCard.js';
 export * from './components/references/URefCardGroup.js';
+export * from './components/actions/UQuestionAction.js';
+export * from './components/widgets/UImagesWidget.js';
+export * from './components/widgets/UVideoWidget.js';
+export * from './components/widgets/UMapWidget.js';
+export * from './components/widgets/UChartWidget.js';
+export * from './components/widgets/UWidget.js';
 export type * from './types/BlockItem';
-export type * from './types/BlockReference';
 export type * from './types/JsonNode';
+export type * from './types/JsonSchema';
+export type * from './types/References';
+export * from './types/Actions';
+export * from './types/Widgets';
 export type * from './events/UCancelEvent';
 export type * from './events/USubmitEvent';
+export * from './utilities/ActionPromptBuilder.js';
+export * from './utilities/WidgetPromptBuilder.js';

package/dist/index.js

@@ -1,36 +1,56 @@
 import './components/blocks/UCodeBlock.js';
+import './components/blocks/UFilesBlock.js';
 import './components/blocks/UJsonBlock.js';
 import './components/blocks/UMarkedBlock.js';
 import './components/blocks/UTextBlock.js';
 import './components/blocks/UThinkBlock.js';
 import './components/blocks/UToolBlock.js';
+import './components/blocks/URefBlock.js';
+import './components/blocks/UTableBlock.js';
 import './components/buttons/UAttachButton.js';
 import './components/buttons/UCopyButton.js';
 import './components/buttons/UVoteButton.js';
 import './components/buttons/UReportButton.js';
 import './components/buttons/URetryButton.js';
 import './components/buttons/UShareButton.js';
-import './components/loaders/UDotLoader.js';
 import './components/message/UMessage.js';
 import './components/prompt/UPrompt.js';
 import './components/references/URefTag.js';
 import './components/references/URefCard.js';
 import './components/references/URefCardGroup.js';
+import './components/actions/UQuestionAction.js';
+import './components/widgets/UImagesWidget.js';
+import './components/widgets/UVideoWidget.js';
+import './components/widgets/UMapWidget.js';
+import './components/widgets/UChartWidget.js';
+import './components/widgets/UWidget.js';
+export { PRESET_ACTION_DEFINITIONS, PRESET_ACTION_LIST, PresetAction } from './types/Actions.js';
+export { PRESET_WIDGET_DEFINITIONS, PRESET_WIDGET_LIST, PresetWidget } from './types/Widgets.js';
+export { ActionPromptBuilder } from './utilities/ActionPromptBuilder.js';
+export { WidgetPromptBuilder } from './utilities/WidgetPromptBuilder.js';
+export { UAttachButton } from './components/buttons/UAttachButton.component.js';
+export { UChartWidget } from './components/widgets/UChartWidget.component.js';
 export { UCodeBlock } from './components/blocks/UCodeBlock.component.js';
+export { UCopyButton } from './components/buttons/UCopyButton.component.js';
+export { UFilesBlock } from './components/blocks/UFilesBlock.component.js';
+export { UImagesWidget } from './components/widgets/UImagesWidget.component.js';
 export { UJsonBlock } from './components/blocks/UJsonBlock.component.js';
+export { UMapWidget } from './components/widgets/UMapWidget.component.js';
 export { UMarkedBlock } from './components/blocks/UMarkedBlock.component.js';
-export { UTextBlock } from './components/blocks/UTextBlock.component.js';
-export { UThinkBlock } from './components/blocks/UThinkBlock.component.js';
-export { UToolBlock } from './components/blocks/UToolBlock.component.js';
-export { UAttachButton } from './components/buttons/UAttachButton.component.js';
-export { UCopyButton } from './components/buttons/UCopyButton.component.js';
-export { UVoteButton } from './components/buttons/UVoteButton.component.js';
-export { UReportButton } from './components/buttons/UReportButton.component.js';
-export { URetryButton } from './components/buttons/URetryButton.component.js';
-export { UShareButton } from './components/buttons/UShareButton.component.js';
-export { UDotLoader } from './components/loaders/UDotLoader.component.js';
 export { UMessage } from './components/message/UMessage.component.js';
 export { UPrompt } from './components/prompt/UPrompt.component.js';
-export { URefTag } from './components/references/URefTag.component.js';
+export { UQuestionAction } from './components/actions/UQuestionAction.component.js';
+export { URefBlock } from './components/blocks/URefBlock.component.js';
 export { URefCard } from './components/references/URefCard.component.js';
 export { URefCardGroup } from './components/references/URefCardGroup.component.js';
+export { URefTag } from './components/references/URefTag.component.js';
+export { UReportButton } from './components/buttons/UReportButton.component.js';
+export { URetryButton } from './components/buttons/URetryButton.component.js';
+export { UShareButton } from './components/buttons/UShareButton.component.js';
+export { UTableBlock } from './components/blocks/UTableBlock.component.js';
+export { UTextBlock } from './components/blocks/UTextBlock.component.js';
+export { UThinkBlock } from './components/blocks/UThinkBlock.component.js';
+export { UToolBlock } from './components/blocks/UToolBlock.component.js';
+export { UVideoWidget } from './components/widgets/UVideoWidget.component.js';
+export { UVoteButton } from './components/buttons/UVoteButton.component.js';
+export { UWidget } from './components/widgets/UWidget.component.js';

package/dist/types/Actions.d.ts

@@ -0,0 +1,24 @@
+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

@@ -0,0 +1,34 @@
+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/BlockItem.d.ts

@@ -1,4 +1,4 @@
-import { BlockReference } from './BlockReference';
+import { ReferenceSource, ReferenceCitation } from './References';
 import { JsonNode } from './JsonNode';
 /** LLM 추론 텍스트 블록입니다. */
 export interface ThinkingBlockItem {
@@ -17,8 +17,8 @@ export interface MarkdownBlockItem {
     type: "markdown";
     /** 마크다운 텍스트 */
     value?: string;
-    /** 마크다운 내 인용 출처들 */
-    refs?: BlockReference[];
+    /** 마크다운 내 인용 정보 들 */
+    refs?: ReferenceCitation[];
 }
 /** 툴 사용 블록입니다. */
 export interface ToolBlockItem {
@@ -30,7 +30,44 @@ export interface ToolBlockItem {
     /** 도구 블록 출력값(json) */
     output?: JsonNode;
 }
+/** 출처 정보 */
+export interface ReferenceBlockItem {
+    type: "reference";
+    /** 출처 목록 */
+    sources: ReferenceSource[];
+}
+/** 파일 첨부 블록입니다. */
+export type FileUploadStatus = {
+    phase: "uploading";
+    progress?: number;
+} | {
+    phase: "done";
+} | {
+    phase: "error";
+    message?: string;
+};
+/** 파일 하나의 데이터 구조입니다. */
+export interface FileItem {
+    /** 파일 ID (옵션) */
+    fileId?: string;
+    /** 파일 이름 */
+    name: string;
+    /** MIME 타입 (예: "image/png", "application/pdf") */
+    type?: string;
+    /** 파일 크기 (bytes) */
+    size?: number;
+    /** 파일 업로드 상태 */
+    upload?: FileUploadStatus;
+    /** 다운로드 URL */
+    downloadUrl?: string;
+}
+/** 복수 파일 첨부 블록입니다. */
+export interface FilesBlockItem {
+    type: "files";
+    /** 파일 목록 */
+    files: FileItem[];
+}
 /**
  * 타입별 메시지 컨텐츠 아이템
  */
-export type BlockItem = (ThinkingBlockItem | TextBlockItem | MarkdownBlockItem | ToolBlockItem);
+export type BlockItem = (ThinkingBlockItem | TextBlockItem | MarkdownBlockItem | ToolBlockItem | ReferenceBlockItem | FilesBlockItem);

package/dist/types/JsonSchema.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 위젯 정의용 JSON Schema 타입
+ *
+ * 위젯의 속성을 LLM에게 설명하기 위한 최소한의 스키마 정의만 포함.
+ * 복잡한 검증 기능이나 메타 정보는 제외하여 단순화함.
+ *
+ * 제외된 기능들:
+ * - $schema, $id 등 메타 정보 (위젯 정의에 불필요)
+ * - pattern, format 등 고급 검증 (LLM이 직접 생성하므로 불필요)
+ * - allOf, anyOf 등 조합 스키마 (복잡도 증가, 위젯에 과도함)
+ * - 조건부 스키마 if/then/else (위젯 속성에 불필요)
+ * - 고급 object/array 검증들 (단순한 구조만으로 충분)
+ */
+export interface BaseJsonSchema {
+    /** 속성에 대한 설명 (LLM용) */
+    description?: string;
+    /** 기본값 */
+    default?: any;
+    /** 허용 가능한 값들 (제한된 선택지) */
+    enum?: any[];
+    /** 예시 값들 (LLM이 이해하기 쉽도록) */
+    examples?: any[];
+}
+export interface BooleanJsonSchema extends BaseJsonSchema {
+    type: 'boolean';
+}
+export interface StringJsonSchema extends BaseJsonSchema {
+    type: 'string';
+    /** 최소 문자열 길이 */
+    minLength?: number;
+    /** 최대 문자열 길이 */
+    maxLength?: number;
+}
+export interface NumberJsonSchema extends BaseJsonSchema {
+    type: 'number' | 'integer';
+    /** 최솟값 */
+    minimum?: number;
+    /** 최댓값 */
+    maximum?: number;
+}
+export interface ArrayJsonSchema extends BaseJsonSchema {
+    type: 'array';
+    /** 배열 아이템의 스키마 */
+    items?: JsonSchema;
+    /** 최소 아이템 개수 */
+    minItems?: number;
+    /** 최대 아이템 개수 */
+    maxItems?: number;
+}
+export interface ObjectJsonSchema extends BaseJsonSchema {
+    type: 'object';
+    /** 객체의 속성들 */
+    properties?: Record<string, JsonSchema>;
+    /** 필수 속성 목록 */
+    required?: string[];
+    /** 정의되지 않은 추가 속성 허용 여부 */
+    additionalProperties?: boolean;
+}
+export type JsonSchema = BooleanJsonSchema | StringJsonSchema | NumberJsonSchema | ArrayJsonSchema | ObjectJsonSchema;

package/dist/types/{BlockReference.d.ts → References.d.ts}

@@ -1,11 +1,11 @@
 /**
- * 블록 참조에서 사용되는 참조 내용입니다.
+ * 참조에서 사용되는 원본 내용입니다.
  */
 export interface ReferenceSource {
     /** 자료의 종류 입니다. */
     type: 'web' | 'document';
     /** 참조 링크 URL */
-    url: string;
+    url?: string;
     /** 제목 */
     title?: string;
     /** 발췌 내용 */
@@ -14,19 +14,15 @@ export interface ReferenceSource {
     tags?: string[];
 }
 /**
- * 텍스트 컨텐츠 내 인용 참조 블록
+ * 본문 내 참조 인용 정보입니다.
  */
-export interface TextBlockReference {
-    /** 인용 출처 이름 */
-    name: string;
+export interface ReferenceCitation {
     /** 참조 텍스트 시작 위치 (문자 인덱스) */
     startIndex: number;
     /** 참조 텍스트 종료 위치 (문자 인덱스) */
     endIndex: number;
+    /** 본문에 표시될 참조 라벨 (예: [1], (Smith et al., 2023)) */
+    label?: string;
     /** 원본 참조 내용 */
     sources: ReferenceSource[];
 }
-/**
- * 메시지 컨텐츠 내에서 인용 참조 블록
- */
-export type BlockReference = TextBlockReference;

package/dist/types/Widgets.d.ts

@@ -0,0 +1,34 @@
+import { JsonSchema } from './JsonSchema.js';
+/**
+ * 위젯을 정의하는 구조체
+ */
+export interface WidgetDefinition {
+    /** 등록할 커스텀 엘리먼트 클래스 */
+    element: CustomElementConstructor;
+    /** 등록할 커스텀 엘리먼트 태그명 */
+    tag: string;
+    /** LLM용 설명 */
+    description: string;
+    /** LLM용 속성 스키마 */
+    properties?: Record<string, JsonSchema>;
+    /** 필수 속성 목록 */
+    required?: string[];
+}
+/**
+ * 프리셋 위젯 비트 플래그
+ */
+export declare enum PresetWidget {
+    Images = 1,
+    Video = 2,
+    Map = 8,
+    Chart = 16,
+    All = 27
+}
+/**
+ * 전체 프리셋 위젯 플래그 목록
+ */
+export declare const PRESET_WIDGET_LIST: readonly [PresetWidget.Images, PresetWidget.Video, PresetWidget.Map, PresetWidget.Chart];
+/**
+ * 프리셋 위젯 정의
+ */
+export declare const PRESET_WIDGET_DEFINITIONS: Map<PresetWidget, WidgetDefinition>;

package/dist/types/Widgets.js

@@ -0,0 +1,115 @@
+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 };