@iyulab/editor-components 0.0.2 → 0.1.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.1.0] - 2026-07-19
+
+### Fixed
+- **`UTextEditor` 가 해제 후 접근에서 깨질 수 있던 타입 거짓말 제거** — `quill` 필드가 `Quill`(non-null 단언)로 선언돼 있는데 `disconnectedCallback` 은 `null as any` 로 null 을 대입하고 있었다. 타입 시스템을 속인 탓에 null 검사 누락 5곳이 가려져 있었다. 필드를 `Quill | null` 로 정직하게 선언하고, `text-change` 핸들러는 생성 시점의 지역 참조를 캡처하도록, `setQuillContents` 는 초기화 전/해제 후 호출을 무시하도록 고쳤다.
+
+### 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.0",
   "keywords": [
     "iyulab",
     "web-components",
@@ -37,6 +37,8 @@
   },
   "scripts": {
     "test": "vite",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
     "build": "eslint && vite build"
   },
   "dependencies": {