@iyulab/chat-components 0.12.2 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## [0.13.0] - 2026-09-28
+
+### Fixed
+
+- **Escape in a file preview or an image lightbox opened inside a dialog closes only the viewer.**
+  Both listened for Escape on the document themselves, so one press closed the viewer and the
+  dialog under it. They now join `@iyulab/components`' layer stack, where one Escape closes the
+  most recently opened layer. Arrow keys still page the lightbox. Requires `@iyulab/components`
+  1.49.0 or later.
+
+### Changed
+
+- 🔴 **Breaking — `u-ref-card` no longer requests a favicon unless you choose where from.** A web
+  card used to load `https://www.google.com/s2/favicons?domain=<host>` for every card, with no way to
+  point it elsewhere or turn it off — each card sent the site's host name to a third party, and on a
+  closed network every card made a request that failed. Cards now show no favicon by default. Set
+  `URefCard.defaultFaviconUrl` (every card, including those inside `u-ref-block` and
+  `u-ref-card-group`) or a card's `faviconUrl` property to a `(url) => string | undefined` resolver.
+  A card without a `url` no longer falls back to the app's own `/favicon.ico`.
+  Migration, to keep the previous look: `URefCard.defaultFaviconUrl = googleFaviconUrl;` (both
+  exported from `@iyulab/chat-components`).
+
+- The file preview and the image lightbox read `--u-layer-overlay` (9999, as before) — the shared
+  stacking token from `@iyulab/components` — instead of their own number, so they stack in the
+  same order as dialogs and drawers.
+
+## [0.12.3] - 2026-09-21
+
+### Documentation
+
+- **The file and table blocks now list the CSS parts they expose.** Neither reference page had
+  a `CSS Parts` section, so `card-main` (the file block's clickable card body) and
+  `sort-button` (a table column header's sort toggle) were styleable but undocumented.
+
 ## [0.12.2] - 2026-09-20
 
 ### Fixed

package/dist/_virtual/{_@oxc-project_runtime@0.150.0 → _@oxc-project_runtime@0.151.0}/helpers/esm/decorate.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.150.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);

package/dist/_virtual/{_@oxc-project_runtime@0.150.0 → _@oxc-project_runtime@0.151.0}/helpers/esm/decorateMetadata.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.150.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorateMetadata.js
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }

package/dist/components/blocks/UCodeBlock.js

@@ -1,6 +1,6 @@
 import { styles } from "./UCodeBlock.styles.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { html } from "lit";
 import { customElement, property } from "lit/decorators.js";
 import { unsafeHTML } from "lit/directives/unsafe-html.js";

package/dist/components/blocks/UElementBlock.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { UDataElement } from "../UDataElement.js";
 import { styles } from "./UElementBlock.styles.js";
 import { html, nothing } from "lit";

package/dist/components/blocks/UFileBlock.d.ts

@@ -1,3 +1,4 @@
+import { PropertyValues } from 'lit';
 import { UElement } from '@iyulab/components/dist/components/UElement.js';
 /**
  * 단일 파일을 표시하는 블록 컴포넌트입니다.
@@ -18,8 +19,9 @@ export declare class UFileBlock extends UElement {
     url?: string;
     /** 미리보기 오버레이가 열려있는지 여부 */
     private previewOpen;
-    connectedCallback(): void;
     disconnectedCallback(): void;
+    /** 열린 미리보기는 층이다 — Escape 는 components 의 층 스택이 «가장 나중에 연 층 하나» 에만 준다. */
+    protected updated(changed: PropertyValues): void;
     private get isImage();
     private get isVideo();
     /** 클릭 시 오버레이로 미리볼 수 있는 타입인지 여부 */
@@ -29,7 +31,6 @@ export declare class UFileBlock extends UElement {
     private renderCardMain;
     private handleCardClick;
     private closePreview;
-    private handleKeyDown;
     private handleRemoveClick;
     /** MIME 타입 → Tabler Icon 이름 */
     private resolveIcon;

package/dist/components/blocks/UFileBlock.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { messages } from "../../utilities/messages.js";
 import { styles } from "./UFileBlock.styles.js";
 import { html, nothing } from "lit";
@@ -7,6 +7,7 @@ import { customElement, property, state } from "lit/decorators.js";
 import "@iyulab/components/dist/components/icon/UIcon.js";
 import { UElement } from "@iyulab/components/dist/components/UElement.js";
 import "@iyulab/components/dist/components/button/UButton.js";
+import { OverlayManager } from "@iyulab/components/dist/utilities/OverlayManager.js";
 //#region src/components/blocks/UFileBlock.ts
 var UFileBlock = class UFileBlock extends UElement {
 	constructor(..._args) {
@@ -21,9 +22,6 @@ var UFileBlock = class UFileBlock extends UElement {
 			e?.stopPropagation();
 			this.previewOpen = false;
 		};
-		this.handleKeyDown = (e) => {
-			if (this.previewOpen && e.key === "Escape") this.closePreview();
-		};
 		this.handleRemoveClick = (e) => {
 			e.stopPropagation();
 			if (this.fire("remove")) this.remove();
@@ -32,14 +30,17 @@ var UFileBlock = class UFileBlock extends UElement {
 	static {
 		this.styles = [super.styles, styles];
 	}
-	connectedCallback() {
-		super.connectedCallback();
-		document.addEventListener("keydown", this.handleKeyDown);
-	}
 	disconnectedCallback() {
-		document.removeEventListener("keydown", this.handleKeyDown);
+		OverlayManager.closeLayer(this);
 		super.disconnectedCallback();
 	}
+	/** 열린 미리보기는 층이다 — Escape 는 components 의 층 스택이 «가장 나중에 연 층 하나» 에만 준다. */
+	updated(changed) {
+		super.updated(changed);
+		if (!changed.has("previewOpen")) return;
+		if (this.previewOpen) OverlayManager.openLayer(this, () => this.closePreview());
+		else OverlayManager.closeLayer(this);
+	}
 	get isImage() {
 		return !!this.url && !!this.type?.startsWith("image/");
 	}

package/dist/components/blocks/UFileBlock.styles.js

@@ -138,7 +138,7 @@ var styles = css`
   .preview-overlay {
     position: fixed;
     inset: 0;
-    z-index: 9999;
+    z-index: var(--u-layer-overlay, 9999);
     display: flex;
     flex-direction: column;
     background: rgba(0, 0, 0, 0.92);

package/dist/components/blocks/UMarkedBlock.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import "./UCodeBlock.js";
 import { escapeHtmlAttr, escapeHtmlHref, escapeHtmlText, stripZeroWidth } from "../../utilities/sanitizers.js";
 import { HtmlBuilder } from "../../utilities/HtmlBuilder.js";

package/dist/components/blocks/URefBlock.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import "../references/URefCard.js";
 import { styles } from "./URefBlock.styles.js";
 import { html } from "lit";

package/dist/components/blocks/UTableBlock.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { UDataElement } from "../UDataElement.js";
 import { messages } from "../../utilities/messages.js";
 import { styles } from "./UTableBlock.styles.js";

package/dist/components/blocks/UTextBlock.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { styles } from "./UTextBlock.styles.js";
 import { html } from "lit";
 import { customElement, property, query } from "lit/decorators.js";

package/dist/components/message/UMessage.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { styles } from "./UMessage.styles.js";
 import { html } from "lit";
 import { customElement, property } from "lit/decorators.js";

package/dist/components/prompt/UPrompt.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { messages } from "../../utilities/messages.js";
 import "../blocks/UFileBlock.js";
 import { styles } from "./UPrompt.styles.js";

package/dist/components/references/URefCard.d.ts

@@ -1,10 +1,27 @@
 import { UDataElement } from '../UDataElement.js';
+/**
+ * 웹 참조 카드의 파비콘 이미지 URL 을 정한다. `undefined` 를 돌려주면 파비콘 없이 그린다.
+ * @param url 카드의 `url`
+ */
+export type FaviconResolver = (url: string) => string | undefined;
+/**
+ * 구글 공개 파비콘 서비스를 쓰는 리졸버(opt-in). 카드마다 사이트의 호스트 이름을 구글에 보낸다 —
+ * 공용 인터넷에 닿지 않는 망에서는 쓰지 말 것.
+ *
+ * @example URefCard.defaultFaviconUrl = googleFaviconUrl;
+ */
+export declare const googleFaviconUrl: FaviconResolver;
 /**
  * 참조 소스를 카드 형태로 표시하는 공통 컴포넌트입니다.
  * Web과 Document 타입 모두 지원합니다.
  */
 export declare class URefCard extends UDataElement {
     static styles: import('lit').CSSResultGroup[];
+    /**
+     * 자기 `faviconUrl` 이 없는 모든 카드가 쓰는 리졸버. 기본값 `undefined` 는 파비콘을 요청하지 않는다 —
+     * 카드가 밖으로 나가는 요청을 스스로 만들지 않는다. 카드가 그려지기 전에 정할 것.
+     */
+    static defaultFaviconUrl?: FaviconResolver;
     /** 카드 타입 (web 또는 document) */
     type: 'web' | 'document';
     /** 외부 링크 URL */
@@ -15,6 +32,8 @@ export declare class URefCard extends UDataElement {
     snippet?: string;
     /** 태그 목록 */
     tags?: string[];
+    /** 이 카드의 파비콘 리졸버 — `URefCard.defaultFaviconUrl` 보다 우선한다. */
+    faviconUrl?: FaviconResolver;
     render(): import('lit-html').TemplateResult<1>;
     /**
      * script-payload(UMarkedBlock 툴팁)와 property 바인딩(URefBlock) 두 사용
@@ -24,8 +43,8 @@ export declare class URefCard extends UDataElement {
     protected load(data?: object): Promise<void>;
     /** 링크 클릭 핸들러 */
     private handleAnchorClick;
-    /** URL에서 Google의 파비콘 URL을 반환합니다. */
-    private getFaviconUrl;
+    /** 리졸버가 URL 을 돌려줄 때만 파비콘을 그린다(장식 — 제목이 이름을 나른다). */
+    private renderFavicon;
     /** URL에서 도메인 사이트 주소를 반환합니다. */
     private getDomainName;
 }

package/dist/components/references/URefCard.js

@@ -1,14 +1,31 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { UDataElement } from "../UDataElement.js";
 import { styles } from "./URefCard.styles.js";
-import { html } from "lit";
+import { html, nothing } from "lit";
 import { customElement, property } from "lit/decorators.js";
 import "@iyulab/components/dist/components/icon/UIcon.js";
 import { ifDefined } from "lit/directives/if-defined.js";
 import { arrayAttrConverter } from "@iyulab/components/dist/utilities/converters.js";
 //#region src/components/references/URefCard.ts
+var _URefCard;
+/**
+* 구글 공개 파비콘 서비스를 쓰는 리졸버(opt-in). 카드마다 사이트의 호스트 이름을 구글에 보낸다 —
+* 공용 인터넷에 닿지 않는 망에서는 쓰지 말 것.
+*
+* @example URefCard.defaultFaviconUrl = googleFaviconUrl;
+*/
+var googleFaviconUrl = (url) => {
+	try {
+		return `https://www.google.com/s2/favicons?sz=64&domain=${encodeURIComponent(new URL(url).hostname)}`;
+	} catch {
+		return;
+	}
+};
 var URefCard = class URefCard extends UDataElement {
+	static {
+		_URefCard = this;
+	}
 	constructor(..._args) {
 		super(..._args);
 		this.type = "web";
@@ -22,11 +39,7 @@ var URefCard = class URefCard extends UDataElement {
       <a href="${ifDefined(this.url)}" target="_blank" rel="noopener noreferrer"
         @click=${this.handleAnchorClick}>
         <div class="header">
-          <img class="favicon" 
-            src="${this.getFaviconUrl(this.url)}" 
-            alt=""
-            aria-hidden="true"
-          />
+          ${this.renderFavicon()}
           <div class="title">
             ${this.title || this.getDomainName(this.url)}
           </div>
@@ -68,14 +81,12 @@ var URefCard = class URefCard extends UDataElement {
 			e.stopPropagation();
 		}
 	}
-	/** URL에서 Google의 파비콘 URL을 반환합니다. */
-	getFaviconUrl(url) {
-		if (!url) return `/favicon.ico`;
-		try {
-			return `https://www.google.com/s2/favicons?sz=64&domain=${new URL(url).hostname}`;
-		} catch {
-			return `/favicon.ico`;
-		}
+	/** 리졸버가 URL 을 돌려줄 때만 파비콘을 그린다(장식 — 제목이 이름을 나른다). */
+	renderFavicon() {
+		const resolve = this.faviconUrl ?? _URefCard.defaultFaviconUrl;
+		const src = this.url && resolve ? resolve(this.url) : void 0;
+		if (!src) return nothing;
+		return html`<img class="favicon" src=${src} alt="" aria-hidden="true" />`;
 	}
 	/** URL에서 도메인 사이트 주소를 반환합니다. */
 	getDomainName(url) {
@@ -98,6 +109,7 @@ __decorate([property({
 	type: Array,
 	converter: arrayAttrConverter((v) => v)
 }), __decorateMetadata("design:type", Array)], URefCard.prototype, "tags", void 0);
-URefCard = __decorate([customElement("u-ref-card")], URefCard);
+__decorate([property({ attribute: false }), __decorateMetadata("design:type", Object)], URefCard.prototype, "faviconUrl", void 0);
+URefCard = _URefCard = __decorate([customElement("u-ref-card")], URefCard);
 //#endregion
-export { URefCard };
+export { URefCard, googleFaviconUrl };

package/dist/components/references/URefCardGroup.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { messages } from "../../utilities/messages.js";
 import { URefCard } from "./URefCard.js";
 import { styles } from "./URefCardGroup.styles.js";

package/dist/components/references/URefTag.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { styles } from "./URefTag.styles.js";
 import { html } from "lit";
 import { customElement, property } from "lit/decorators.js";

package/dist/components-extra/UChartBlock.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { messages } from "../utilities/messages.js";
 import { styles } from "./UChartBlock.styles.js";
 import { html, nothing } from "lit";

package/dist/components-extra/UImagesBlock.d.ts

@@ -1,4 +1,4 @@
-import { nothing } from 'lit';
+import { nothing, PropertyValues } from 'lit';
 import { UElement } from '@iyulab/components/dist/components/UElement.js';
 export interface ImageSlide {
     src: string;
@@ -16,6 +16,8 @@ export declare class UImagesBlock extends UElement {
     private index;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    /** 열린 라이트박스는 층이다 — Escape 는 components 의 층 스택이 «가장 나중에 연 층 하나» 에만 준다. */
+    protected updated(changed: PropertyValues): void;
     render(): typeof nothing | import('lit-html').TemplateResult<1>;
     private renderLightbox;
     open: (i: number) => void;

package/dist/components-extra/UImagesBlock.js

@@ -1,11 +1,12 @@
-import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { messages } from "../utilities/messages.js";
 import { styles } from "./UImagesBlock.styles.js";
 import { html, nothing } from "lit";
 import { customElement, property, state } from "lit/decorators.js";
 import "@iyulab/components/dist/components/icon/UIcon.js";
 import { UElement } from "@iyulab/components/dist/components/UElement.js";
+import { OverlayManager } from "@iyulab/components/dist/utilities/OverlayManager.js";
 import { repeat } from "lit/directives/repeat.js";
 import "@iyulab/components/dist/components/carousel/UCarousel.js";
 //#region src/components-extra/UImagesBlock.ts
@@ -36,8 +37,7 @@ var UImagesBlock = class UImagesBlock extends UElement {
 		};
 		this.handleKeyDown = (e) => {
 			if (this.index === null) return;
-			if (e.key === "Escape") this.close();
-			else if (e.key === "ArrowLeft") this.prev();
+			if (e.key === "ArrowLeft") this.prev();
 			else if (e.key === "ArrowRight") this.next();
 		};
 	}
@@ -50,8 +50,16 @@ var UImagesBlock = class UImagesBlock extends UElement {
 	}
 	disconnectedCallback() {
 		document.removeEventListener("keydown", this.handleKeyDown);
+		OverlayManager.closeLayer(this);
 		super.disconnectedCallback();
 	}
+	/** 열린 라이트박스는 층이다 — Escape 는 components 의 층 스택이 «가장 나중에 연 층 하나» 에만 준다. */
+	updated(changed) {
+		super.updated(changed);
+		if (!changed.has("index")) return;
+		if (this.index !== null) OverlayManager.openLayer(this, () => this.close());
+		else OverlayManager.closeLayer(this);
+	}
 	render() {
 		if (!this.items?.length) return nothing;
 		const count = this.items.length;

package/dist/components-extra/UImagesBlock.styles.js

@@ -58,7 +58,7 @@ var styles = css`
   .lb-overlay {
     position: fixed;
     inset: 0;
-    z-index: 9999;
+    z-index: var(--u-layer-overlay, 9999);
     display: flex;
     flex-direction: column;
     background: rgba(0, 0, 0, 0.92);

package/dist/components-extra/UMapBlock.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { styles } from "./UMapBlock.styles.js";
 import { html, nothing } from "lit";
 import { customElement, property } from "lit/decorators.js";

package/dist/components-extra/UVideoBlock.js

@@ -1,5 +1,5 @@
-import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import { styles } from "./UVideoBlock.styles.js";
 import { html, nothing } from "lit";
 import { customElement, property } from "lit/decorators.js";

package/dist/index.js

@@ -4,7 +4,7 @@ import { HtmlBuilder } from "./utilities/HtmlBuilder.js";
 import { UElementBlock } from "./components/blocks/UElementBlock.js";
 import { UFileBlock } from "./components/blocks/UFileBlock.js";
 import { URefTag } from "./components/references/URefTag.js";
-import { URefCard } from "./components/references/URefCard.js";
+import { URefCard, googleFaviconUrl } from "./components/references/URefCard.js";
 import { URefCardGroup } from "./components/references/URefCardGroup.js";
 import { UTableBlock } from "./components/blocks/UTableBlock.js";
 import { UMarkedBlock } from "./components/blocks/UMarkedBlock.js";
@@ -13,4 +13,4 @@ import { URefBlock } from "./components/blocks/URefBlock.js";
 import { UMessage } from "./components/message/UMessage.js";
 import { UPrompt } from "./components/prompt/UPrompt.js";
 import { ElementPromptBuilder } from "./utilities/PromptBuilder.js";
-export { ElementPromptBuilder, HtmlBuilder, UCodeBlock, UElementBlock, UFileBlock, UMarkedBlock, UMessage, UPrompt, URefBlock, URefCard, URefCardGroup, URefTag, UTableBlock, UTextBlock, escapeHtmlAttr, escapeHtmlHref, escapeHtmlText, stripZeroWidth };
+export { ElementPromptBuilder, HtmlBuilder, UCodeBlock, UElementBlock, UFileBlock, UMarkedBlock, UMessage, UPrompt, URefBlock, URefCard, URefCardGroup, URefTag, UTableBlock, UTextBlock, escapeHtmlAttr, escapeHtmlHref, escapeHtmlText, googleFaviconUrl, stripZeroWidth };

package/dist/node_modules/katex/dist/katex.js

@@ -20846,7 +20846,7 @@ function parseArray(parser, _ref, style) {
 			parser.consume();
 		} else if (next === "\\end") {
 			endRow();
-			if (row.length === 1 && cell.type === "styling" && cell.body.length === 1 && cell.body[0].type === "ordgroup" && cell.body[0].body.length === 0 && (body.length > 1 || !emptySingleRow) && !Array.isArray(tags == null ? void 0 : tags[tags.length - 1])) body.pop();
+			if (row.length === 1 && cell.type === "styling" && cell.body.length === 1 && cell.body[0].type === "ordgroup" && cell.body[0].body.length === 0 && (body.length > 1 || !emptySingleRow) && !Array.isArray(tags == null ? void 0 : tags[tags.length - 1]) && !(autoTag && (tags == null ? void 0 : tags[tags.length - 1]) === true)) body.pop();
 			if (hLinesBeforeRow.length < body.length + 1) hLinesBeforeRow.push([]);
 			break;
 		} else if (next === "\\\\") {
@@ -26276,7 +26276,7 @@ var renderToHTMLTree = function renderToHTMLTree(expression, options) {
 		return renderError(error, expression, settings);
 	}
 };
-var version = "0.18.7";
+var version = "0.18.9";
 var __domTree = {
 	Span,
 	Anchor,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/chat-components",
   "description": "llm chat components for building chat interfaces",
-  "version": "0.12.2",
+  "version": "0.13.0",
   "author": "iyulab",
   "license": "MIT",
   "keywords": [
@@ -67,7 +67,7 @@
     "marked": "^18.0.6"
   },
   "peerDependencies": {
-    "@iyulab/components": ">=1.23.0",
+    "@iyulab/components": ">=1.49.0",
     "@lit/react": ">=1.0.8",
     "chart.js": ">=4.5.1",
     "react": ">=18.0.0"

package/skills/iyulab-chat-components/references/components/file-block.md

@@ -38,6 +38,12 @@ Clicking anywhere on the card opens a full-size preview overlay, but only for im
 | `size` | `number` | `undefined` | — | File size in bytes; auto-formatted to KB/MB/GB |
 | `url` | `string` | `undefined` | — | File URL, used for the image/video thumbnail and preview overlay |
 
+## CSS Parts
+
+| Part | Description |
+|------|-------------|
+| `card-main` | The clickable card body (rendered only when the block is actionable) |
+
 ## Events
 
 | Event | Detail | Description |

package/skills/iyulab-chat-components/references/components/ref-card.md

@@ -6,7 +6,7 @@ import '@iyulab/chat-components/dist/components/references/URefCard.js';
 
 **Tag:** `u-ref-card`
 
-Displays a single reference source as a card. Supports `web` and `document` types. For web sources, automatically fetches a favicon via the Google Favicon API.
+Displays a single reference source as a card. Supports `web` and `document` types. A web card shows a favicon only when you give it a resolver — by default it makes no request of its own (see [Favicon](#favicon)).
 
 Extends `UDataElement`, so data can also be injected via a `<script type="application/json">` slot.
 
@@ -46,3 +46,22 @@ Extends `UDataElement`, so data can also be injected via a `<script type="applic
 | `title` | `string` | `''` | — | Card title (falls back to domain name for web type) |
 | `snippet` | `string` | `undefined` | — | Excerpt text |
 | `tags` | `string[]` | `undefined` | — | Tag list. Pass as JSON array string via HTML attribute |
+| `faviconUrl` | `FaviconResolver` | `undefined` | — | Favicon resolver for this card (property only). Overrides `URefCard.defaultFaviconUrl` |
+
+---
+
+## Favicon
+
+```ts
+import { URefCard, googleFaviconUrl } from '@iyulab/chat-components';
+
+// type FaviconResolver = (url: string) => string | undefined
+URefCard.defaultFaviconUrl = (url) => `/favicons/${new URL(url).hostname}.png`; // your own host
+// or, where the public internet is reachable and sending host names to Google is acceptable:
+URefCard.defaultFaviconUrl = googleFaviconUrl;
+```
+
+- **Default: no favicon, no request.** The card never contacts a third party unless you choose one — safe on a closed network.
+- `URefCard.defaultFaviconUrl` applies to every card, including those rendered inside `u-ref-block`, `u-ref-card-group` and marked-block tooltips. Set it before cards render.
+- A card's own `faviconUrl` property wins over the module-wide one. Returning `undefined` draws the card without a favicon.
+- `googleFaviconUrl` sends each card's host name (not the full URL) to `www.google.com`.

package/skills/iyulab-chat-components/references/components/table-block.md

@@ -59,6 +59,12 @@ There is no size property or custom property for this — the host is the lever.
 | `headers` | `TableCell[]` | `[]` | Header cells, each with `text` and `align` |
 | `rows` | `TableCell[][]` | `[]` | Row data; each row is an array of `TableCell` |
 
+## CSS Parts
+
+| Part | Description |
+|------|-------------|
+| `sort-button` | A column header's sort toggle |
+
 ## TableCell Type
 
 ```ts