@iyulab/chat-components 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.8.0] - 2026-07-19
+
+### Fixed
+- **채팅 메시지의 이모지가 조용히 분해되던 결함 수정** — `stripZeroWidth` 가 보이지 않는 문자를 제거하면서 ZWJ(U+200D)까지 지웠다. ZWJ 는 이모지 시퀀스를 결합하는 조판 문자이므로, `UMarkedBlock` 이 메시지 본문에 이 함수를 적용할 때 가족·직업 이모지가 낱개로 쪼개졌다(👨‍👩‍👧 → 👨👩👧). 이제 표시 경로는 ZWJ 를 보존하고, URL 위생 경로(`escapeHtmlHref`)는 종전대로 ZWJ 까지 제거해 `java<ZWJ>script:` 형태의 protocol 우회를 계속 차단한다. 두 경로의 요구가 반대이므로 문자 집합을 분리했다. 회귀 테스트 7건 추가.
+
+### Changed
+- **이 패키지의 eslint 가 실제로 동작하기 시작했다.** `eslint.config.js` 의 두 결함 — (1) `files: ["src/**/*"]` 가 ESLint 9 에서 universal 패턴이라 `.ts` 를 opt-in 하지 못함, (2) 배열 프리셋(`tseslint.configs.recommended`)을 객체 스프레드해 프리셋이 무력화됨 — 을 수정했다. `build` 스크립트의 `eslint &&` 게이트는 매칭 파일이 0개라 항상 통과하고 있었다. 위 이모지 결함은 이 복구로 처음 드러났다.
+- `npm run lint` / `npm run lint:fix` 스크립트 추가.
+- **타입 정밀화(소비자 영향 가능)**: `BaseJsonSchema` 의 `default`/`enum`/`examples` 가 `any` → 새 `JsonValue` 타입으로, `FileBlockItem.data` 가 `any` → `unknown` 으로 좁혀졌다. 값을 그대로 사용하던 코드는 좁히기(narrowing)나 캐스팅이 필요할 수 있다.
+- `UMarkedBlock`: 재할당 없는 `let` → `const`.
+
 ## [0.7.1] - 2026-07-12
 
 ### Fixed

package/dist/components/blocks/UMarkedBlock.js

@@ -68,7 +68,7 @@ var UMarkedBlock = class UMarkedBlock extends UElement {
 		this.placeholder.reset();
 		value = stripZeroWidth(value);
 		if (this.refs?.length) value = this.insertRefs(value, this.refs);
-		let html = this.parser.parse(value, { async: false });
+		const html = this.parser.parse(value, { async: false });
 		return unsafeHTML(this.placeholder.restore(html));
 	}
 	/** 

package/dist/types/BlockItem.d.ts

@@ -25,7 +25,7 @@ export interface FileBlockItem {
     /** 다운로드 URL */
     url?: string;
     /** 실제 파일 데이터 (선택적, 필요에 따라 사용) */
-    data?: any;
+    data?: unknown;
 }
 /** 출처 정보 */
 export interface ReferenceBlockItem {

package/dist/types/Schema.d.ts

@@ -11,15 +11,22 @@
  * - 조건부 스키마 if/then/else (위젯 속성에 불필요)
  * - 고급 object/array 검증들 (단순한 구조만으로 충분)
  */
+/**
+ * JSON 으로 표현 가능한 임의의 값.
+ * 스키마의 default/enum/examples 는 임의 JSON 을 담으므로 `any` 대신 이 타입을 쓴다.
+ */
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
 export interface BaseJsonSchema {
     /** 속성에 대한 설명 (LLM용) */
     description?: string;
     /** 기본값 */
-    default?: any;
+    default?: JsonValue;
     /** 허용 가능한 값들 (제한된 선택지) */
-    enum?: any[];
+    enum?: JsonValue[];
     /** 예시 값들 (LLM이 이해하기 쉽도록) */
-    examples?: any[];
+    examples?: JsonValue[];
 }
 export interface BooleanJsonSchema extends BaseJsonSchema {
     type: 'boolean';

package/dist/utilities/sanitizers.d.ts

@@ -7,10 +7,6 @@
  * - escapeHtmlAttr : HTML attribute 값에 삽입할 때
  * - escapeHtmlHref : href/src 같은 URL attribute에 삽입할 때
  */
-/**
- * Zero Width Space / LTR / RTL mark / BOM 등
- * 화면에 표시되지 않는 유니코드 문자를 제거합니다.
- */
 export declare function stripZeroWidth(value: string): string;
 /**
  * HTML 텍스트 노드(context)에 삽입할 문자열을 escape합니다.

package/dist/utilities/sanitizers.js

@@ -12,9 +12,24 @@
 * Zero Width Space / LTR / RTL mark / BOM 등
 * 화면에 표시되지 않는 유니코드 문자를 제거합니다.
 */
+/**
+* \uD45C\uC2DC \uACBD\uB85C\uC5D0\uC11C \uC81C\uAC70\uD560 zero-width \uBB38\uC790.
+*
+* ZWJ(U+200D)\uB294 **\uC758\uB3C4\uC801\uC73C\uB85C \uC81C\uC678**\uD55C\uB2E4. ZWJ \uB294 \uC774\uBAA8\uC9C0 \uC2DC\uD000\uC2A4\uB97C \uACB0\uD569\uD558\uB294
+* \uC870\uD310 \uBB38\uC790\uB77C, \uC81C\uAC70\uD558\uBA74 \uC0AC\uC6A9\uC790\uAC00 \uC785\uB825\uD55C \uAC00\uC871\u00B7\uC9C1\uC5C5 \uC774\uBAA8\uC9C0\uAC00 \uB0B1\uAC1C\uB85C \uBD84\uD574\uB41C\uB2E4
+* (\uD83D\uDC68\u200D\uD83D\uDC69\u200D\uD83D\uDC67 \u2192 \uD83D\uDC68\uD83D\uDC69\uD83D\uDC67). \uD45C\uC2DC \uACBD\uB85C\uC5D0\uC11C\uB294 \uCF58\uD150\uCE20 \uBCF4\uC874\uC774 \uC6B0\uC120\uC774\uB2E4.
+*/
+var ZERO_WIDTH_DISPLAY_REGEX = /[\u200B\u200C\u200E\u200F\uFEFF]/gu;
+/**
+* URL \uC704\uC0DD \uACBD\uB85C\uC5D0\uC11C \uC81C\uAC70\uD560 zero-width \uBB38\uC790.
+*
+* URL \uC548\uC5D0\uC11C\uB294 zero-width \uBB38\uC790\uC5D0 \uC815\uB2F9\uD55C \uC870\uD310 \uC758\uBBF8\uAC00 \uC5C6\uACE0 protocol \uC6B0\uD68C
+* \uB09C\uB3C5\uD654\uC5D0 \uC4F0\uC77C \uC218 \uC788\uC73C\uBBC0\uB85C ZWJ \uAE4C\uC9C0 \uC804\uBD80 \uC81C\uAC70\uD55C\uB2E4 \u2014 \uACB0\uD569 \uC2DC\uD000\uC2A4 \uD574\uCCB4\uAC00
+* \uC5EC\uAE30\uC11C\uB294 \uC758\uB3C4\uB41C \uB3D9\uC791\uC774\uBBC0\uB85C \uADDC\uCE59\uC744 \uBA85\uC2DC\uC801\uC73C\uB85C \uD574\uC81C\uD55C\uB2E4.
+*/
+var ZERO_WIDTH_STRICT_REGEX = /[\u200B\u200C\u200D\u200E\u200F\uFEFF]/gu;
 function stripZeroWidth(value) {
-	const ZERO_WIDTH_REGEX = /[\u200B\u200C\u200D\u200E\u200F\uFEFF]/g;
-	return ZERO_WIDTH_REGEX.test(value) ? value.replace(ZERO_WIDTH_REGEX, "") : value;
+	return ZERO_WIDTH_DISPLAY_REGEX.test(value) ? value.replace(ZERO_WIDTH_DISPLAY_REGEX, "") : value;
 }
 /** HTML text context escape 대상 문자 */
 var HTML_TEXT_ESCAPE_REGEX = /[&<>"']/g;
@@ -53,7 +68,10 @@ var HTML_ATTR_ESCAPE_MAP = {
 function escapeHtmlAttr(value) {
 	return HTML_ATTR_ESCAPE_REGEX.test(value) ? value.replace(HTML_ATTR_ESCAPE_REGEX, (ch) => HTML_ATTR_ESCAPE_MAP[ch]) : value;
 }
-/** protocol 우회 공격 방지를 위한 공백/제어문자 제거 */
+/**
+* protocol 우회 공격 방지를 위한 공백/제어문자 제거.
+* 제어문자 매칭이 이 상수의 목적 자체이므로 no-control-regex 를 의도적으로 해제한다.
+*/
 var HREF_STRIP_CHARS_REGEX = /[\u0000-\u001F\u007F\s]+/g;
 /** href/src에서 차단해야 하는 위험 protocol */
 var HREF_UNSAFE_PROTOCOL_REGEX = /^(?:javascript|data|vbscript):/i;
@@ -64,7 +82,7 @@ var HREF_UNSAFE_PROTOCOL_REGEX = /^(?:javascript|data|vbscript):/i;
 *  <a href="{value}">
 */
 function escapeHtmlHref(value) {
-	let normalized = stripZeroWidth(value).trim();
+	let normalized = value.replace(ZERO_WIDTH_STRICT_REGEX, "").trim();
 	if (HREF_STRIP_CHARS_REGEX.test(normalized)) normalized = normalized.replace(HREF_STRIP_CHARS_REGEX, "");
 	normalized = normalized.replace(/\\/g, "/");
 	if (normalized.startsWith("//")) return "#";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/chat-components",
   "description": "llm chat components for building chat interfaces",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "author": "iyulab",
   "license": "MIT",
   "keywords": [
@@ -40,14 +40,16 @@
     "start": "vite",
     "build": "eslint && vite build",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix"
   },
   "dependencies": {
-    "@iyulab/components": "^1.5.0",
+    "@iyulab/components": "^1.5.1",
     "highlight.js": "^11.11.1",
     "katex": "^0.17.0",
     "lit": "^3.3.3",
-    "marked": "^18.0.5",
+    "marked": "^18.0.6",
     "marked-katex-extension": "^5.1.10"
   },
   "peerDependencies": {
@@ -68,17 +70,17 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.4",
-    "@types/node": "^26.1.0",
+    "@types/node": "^26.1.1",
     "@vitest/browser-playwright": "^4.1.10",
     "chart.js": "^4.5.1",
     "eslint": "^9.39.4",
     "eslint-plugin-lit": "^2.3.1",
     "glob": "^13.0.6",
     "globals": "^17.7.0",
-    "openai": "^6.45.0",
+    "openai": "^6.47.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.63.0",
-    "vite": "^8.1.3",
+    "typescript-eslint": "^8.64.0",
+    "vite": "^8.1.4",
     "vite-plugin-dts": "^5.0.3",
     "vitest": "^4.1.10"
   }