@iyulab/editor-components 0.0.2 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.1.1] - 2026-07-19
+
+### Added
+- **테스트 인프라 도입** — 이 패키지에는 자동 테스트가 없었다(`tests/` 는 수동 preview 앱). 모노레포의 다른 컴포넌트 패키지와 동일한 vitest + playwright 브라우저 스택을 붙이고 `UTextEditor` 생명주기 계약 테스트 5건을 추가했다(mount → 편집 → detach → re-attach, 공개 접근자의 teardown 후 안전성). 기존 `npm test`(preview 앱 실행)는 `npm run preview` 로 이름을 옮겼다.
+
+### Documentation
+- 0.1.0 의 `UTextEditor` 항목 서술을 정정 — "해제 후 접근에서 깨질 수 있던" 이라 썼으나 **실제로는 런타임에 도달하지 않는 경로**였다(호출부가 이미 `if (this.quill)` 로 감싸여 있었다). 타입 정직성 개선의 값은 예방에 있지 live-bug 수정이 아니다. 테스트로 확인한 사실에 맞게 문구를 바로잡았다.
+
+## [0.1.0] - 2026-07-19
+
+### Fixed
+- **`UTextEditor` 의 타입 거짓말 제거(예방적)** — `quill` 필드가 `Quill`(non-null 단언)로 선언돼 있는데 `disconnectedCallback` 은 `null as any` 로 null 을 대입하고 있었다. 두 거짓말이 상쇄되어 null 가드 없는 역참조 5곳이 타입 검사를 통과하고 있었다. 필드를 `Quill | null` 로 정직하게 선언하고, `text-change` 핸들러는 생성 시점 지역 참조를 캡처하도록, `setQuillContents` 는 방어 가드를 갖도록 고쳤다. **다만 이는 런타임 버그 수정이 아니다** — 해당 호출부는 모두 `updated()` 의 `if (this.quill)` 안에 있어 실제로는 도달하지 않았다. 값은 앞으로 가드 없는 호출이 추가될 때 tsc 가 즉시 잡아준다는 데 있다.
+
+### Changed
+- **이 패키지의 eslint 가 실제로 동작하기 시작했다.** `files` 패턴의 확장자 누락과 배열 프리셋 객체 스프레드 결함을 수정했다. `build` 스크립트의 `eslint &&` 게이트는 매칭 파일이 0개라 항상 통과하고 있었다. 위 null 결함은 이 복구로 처음 드러났다.
+- `npm run lint` / `npm run lint:fix` 스크립트 추가.
+- **Delta 타입 정밀화(소비자 영향 가능)**: `getDelta()` 가 `any` → `QuillDelta | null`, `setDelta()` 파라미터가 `any` → `QuillDeltaInput` 으로 좁혀졌다. 두 타입은 `quill-delta` 를 새 의존성으로 들이지 않고 Quill 자체 시그니처(`ReturnType<Quill['getContents']>` 등)에서 유도하므로 Quill 버전 변화를 자동으로 따라간다. `getDelta()` 가 `null` 을 반환할 수 있음이 이제 타입에 드러난다.
+- Lit 생명주기 파라미터(`firstUpdated`/`updated`)의 `any` 를 `PropertyValues` 로, Monaco worker 의 `(self as any)` 를 명시적 인터페이스로 교체.
+
 ## [0.0.2] - 2026-07-17
 
 ### Fixed

package/dist/components/code-editor/UCodeEditor.d.ts

@@ -1,3 +1,4 @@
+import { PropertyValues } from 'lit';
 import { UElement } from '@iyulab/components/dist/components/UElement.js';
 /**
  * code editor component used by monaco-editor
@@ -28,8 +29,8 @@ export declare class UCodeEditor extends UElement {
     private observer;
     connectedCallback(): void;
     disconnectedCallback(): void;
-    protected firstUpdated(changedProperties: any): Promise<void>;
-    protected updated(changedProperties: any): Promise<void>;
+    protected firstUpdated(changedProperties: PropertyValues): Promise<void>;
+    protected updated(changedProperties: PropertyValues): Promise<void>;
     render(): import('lit-html').TemplateResult<1>;
 }
 declare global {

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

@@ -1,4 +1,9 @@
+import { PropertyValues } from 'lit';
+import { default as Quill } from 'quill';
 import { UElement } from '@iyulab/components/dist/components/UElement.js';
+/** Quill 의 Delta 타입. quill-delta 를 직접 의존하지 않고 Quill 시그니처에서 유도한다. */
+type QuillDelta = ReturnType<Quill["getContents"]>;
+type QuillDeltaInput = Parameters<Quill["setContents"]>[0];
 /**
  * A rich text editor component built using Quill.js, providing a customizable and user-friendly interface for text editing. It supports various formatting options, themes, and can be configured to be read-only or editable.
  *
@@ -27,8 +32,8 @@ export declare class UTextEditor extends UElement {
     private observer;
     connectedCallback(): void;
     disconnectedCallback(): void;
-    protected firstUpdated(changedProperties: any): Promise<void>;
-    protected updated(changedProperties: any): Promise<void>;
+    protected firstUpdated(changedProperties: PropertyValues): Promise<void>;
+    protected updated(changedProperties: PropertyValues): Promise<void>;
     /** HTML을 Quill Delta로 변환해 silent source로 주입한다 — 프로그램적 콘텐츠 세팅이
      *  text-change(→ change 이벤트)로 위장되지 않도록 하기 위함. */
     private setQuillContents;
@@ -45,7 +50,7 @@ export declare class UTextEditor extends UElement {
     /**
      * Get the current content as Quill Delta
      */
-    getDelta(): any;
+    getDelta(): QuillDelta | null;
     /**
      * Set content from HTML.
      * 프로그램적 세팅이므로 change 이벤트는 발화하지 않는다 (value 프로퍼티 경로와 동일).
@@ -55,7 +60,7 @@ export declare class UTextEditor extends UElement {
      * Set content from Quill Delta.
      * 프로그램적 세팅이므로 change 이벤트는 발화하지 않는다.
      */
-    setDelta(delta: any): void;
+    setDelta(delta: QuillDeltaInput): void;
     /**
      * Clear all content.
      * 프로그램적 세팅이므로 change 이벤트는 발화하지 않는다.
@@ -71,3 +76,4 @@ declare global {
         "u-text-editor": UTextEditor;
     }
 }
+export {};

package/dist/components/text-editor/UTextEditor.js

@@ -20,6 +20,7 @@ var UTextEditor = class UTextEditor extends UElement {
 		this.value = "";
 		this.height = 300;
 		this.container = createRef();
+		this.quill = null;
 		this.observer = new MutationObserver(() => {
 			const theme = Theme.get();
 			if (this.theme !== theme) this.theme = theme;
@@ -89,14 +90,15 @@ var UTextEditor = class UTextEditor extends UElement {
 			modules: { toolbar: this.toolbar || defaultToolbar }
 		});
 		if (this.value) this.setQuillContents(this.value);
-		this.quill.on("text-change", (_delta, _oldDelta, source) => {
+		const quill = this.quill;
+		quill.on("text-change", (_delta, _oldDelta, source) => {
 			if (source !== "user") return;
-			const html = this.quill.root.innerHTML;
+			const html = quill.root.innerHTML;
 			this.value = html;
 			this.dispatchEvent(new CustomEvent("change", { detail: {
 				html,
-				text: this.quill.getText(),
-				delta: this.quill.getContents()
+				text: quill.getText(),
+				delta: quill.getContents()
 			} }));
 		});
 		this.updateEditorHeight();
@@ -114,6 +116,7 @@ var UTextEditor = class UTextEditor extends UElement {
 	/** HTML을 Quill Delta로 변환해 silent source로 주입한다 — 프로그램적 콘텐츠 세팅이
 	*  text-change(→ change 이벤트)로 위장되지 않도록 하기 위함. */
 	setQuillContents(htmlValue) {
+		if (!this.quill) return;
 		const delta = this.quill.clipboard.convert({ html: htmlValue });
 		this.quill.setContents(delta, Quill.sources.SILENT);
 	}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/editor-components",
   "description": "various editor components by iyulab",
-  "version": "0.0.2",
+  "version": "0.1.1",
   "keywords": [
     "iyulab",
     "web-components",
@@ -36,7 +36,11 @@
     }
   },
   "scripts": {
-    "test": "vite",
+    "preview": "vite",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
     "build": "eslint && vite build"
   },
   "dependencies": {
@@ -60,12 +64,14 @@
   "devDependencies": {
     "@eslint/js": "^9.39.4",
     "@types/node": "^26.1.1",
+    "@vitest/browser-playwright": "^4.1.10",
     "eslint": "^9.39.4",
     "glob": "^13.0.6",
     "globals": "^17.7.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.64.0",
     "vite": "^8.1.4",
-    "vite-plugin-dts": "^5.0.3"
+    "vite-plugin-dts": "^5.0.3",
+    "vitest": "^4.1.10"
   }
 }