@iyulab/editor-components 0.6.1 → 0.6.3

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.6.3] - 2026-10-06
+
+### Documentation
+
+- README **Quick Start** — a first page with `u-text-editor` (its module only, so Monaco stays out of the bundle) that
+  reads the typed `change` detail. Checked against the published package in a clean Vite consumer: build, strict `tsc`
+  and a headless render.
+
+## [0.6.2] - 2026-10-06
+
+### Fixed
+
+- **`u-text-editor`'s `change` is typed for TypeScript listeners** (`UTextEditorEventMap`): a listener
+  gets `CustomEvent<{ html, text, delta }>` instead of the native `Event`, so `e.detail.html` compiles.
+
 ## [0.6.1] - 2026-10-05
 
 ### Fixed

package/README.md

@@ -21,6 +21,33 @@ React 래퍼는 `/react` 서브패스로 제공됩니다:
 import { UCodeEditor, UTextEditor } from '@iyulab/editor-components/react';
 ```
 
+## Quick Start
+
+첫 페이지 — 리치 텍스트 에디터 하나와 그 내용 읽기(Vite 기준, `index.html` 이 `src/main.ts` 를 모듈로 싣는다).
+`u-text-editor` 만 쓰면 그 모듈만 불러 Monaco 를 번들에 넣지 않는다.
+
+```bash
+npm install @iyulab/editor-components @iyulab/components
+```
+
+```ts
+// src/main.ts
+import '@iyulab/components/styles/tokens.css';
+import '@iyulab/editor-components/dist/components/text-editor/UTextEditor.js';
+
+const editor = document.createElement('u-text-editor');
+editor.label = 'Note';
+editor.value = '<p>Hello <strong>editor</strong>.</p>';
+editor.style.height = '320px'; // 호스트 상자가 높이를 정한다 — 아래 「크기」
+
+const preview = document.createElement('pre');
+editor.addEventListener('change', (e) => {
+  preview.textContent = e.detail.text; // e.detail: { html, text, delta } — 타입이 붙는다
+});
+
+document.body.append(editor, preview);
+```
+
 ## 포함된 컴포넌트
 
 ### `u-code-editor` (UCodeEditor)

package/dist/components/text-editor/UTextEditor.d.ts

@@ -82,6 +82,24 @@ export declare class UTextEditor extends UElement {
      */
     focus(): void;
 }
+/** Events `<u-text-editor>` dispatches — bubbling and composed. `change` is a CustomEvent here, not the native one. */
+export interface UTextEditorEventMap {
+    /** The user edited the text (not programmatic `value` changes). `delta` is Quill's document model. */
+    'change': CustomEvent<{
+        html: string;
+        text: string;
+        delta: ReturnType<Quill['getContents']>;
+    }>;
+}
+/** Typed listeners for {@link UTextEditorEventMap} — element-scoped, the DOM's own pattern (`HTMLMediaElementEventMap`). */
+export interface UTextEditor {
+    addEventListener<K extends keyof UTextEditorEventMap>(type: K, listener: (this: UTextEditor, ev: UTextEditorEventMap[K]) => unknown, options?: boolean | AddEventListenerOptions): void;
+    addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: UTextEditor, ev: HTMLElementEventMap[K]) => unknown, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof UTextEditorEventMap>(type: K, listener: (this: UTextEditor, ev: UTextEditorEventMap[K]) => unknown, options?: boolean | EventListenerOptions): void;
+    removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: UTextEditor, ev: HTMLElementEventMap[K]) => unknown, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+}
 declare global {
     interface HTMLElementTagNameMap {
         "u-text-editor": UTextEditor;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/editor-components",
   "description": "various editor components by iyulab",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "keywords": [
     "iyulab",
     "web-components",
@@ -50,6 +50,7 @@
   "scripts": {
     "preversion": "node -e \"if(require('fs').existsSync('../../scripts/preversion-check.mjs'))require('child_process').execFileSync('node',['../../scripts/preversion-check.mjs'],{stdio:'inherit'})\"",
     "preview": "vite",
+    "pretest": "node -e \"if(require('fs').existsSync('../../scripts/sibling-dist-check.js'))require('child_process').execFileSync('node',['../../scripts/sibling-dist-check.js'],{stdio:'inherit'})\"",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint src/",