@chenzy-design/core 0.2.1 → 0.4.0

package/dist/chat.js

@@ -0,0 +1,210 @@
+/**
+ * Chat headless — framework-agnostic logic ported from Semi Design `ChatFoundation`
+ * (semi-foundation/chat). Pure helpers + a small adapter-driven controller; the
+ * svelte layer owns DOM (scroll container, wheel/resize listeners, upload widget).
+ *
+ * 严格对齐 Semi：
+ * - 常量 ROLE / CHAT_ALIGN / MESSAGE_STATUS / MODE / SEND_HOT_KEY / SHOW_SCROLL_GAP=100 / SCROLL_ANIMATION_TIME=300。
+ * - back-bottom 显隐阈值：scrollHeight - scrollTop - clientHeight <= SHOW_SCROLL_GAP → 隐藏。
+ * - enableUpload 三态判定 getUploadProps（boolean → 三态同值；对象 → 缺省各 true；其它 → 全 true）。
+ * - sendHotKey 判定 shouldSendOnEnter（enter：无 shift 才发；shift+enter：有 shift 才发）。
+ * - onMessageSend 组装 content（无附件 → 纯文本 string；有附件 → Content[] 图片/文件分流）。
+ * - clearContext 追加 divider（末尾已是 divider 则跳过）。
+ * - delete/like/dislike/reset 的 chats 变换。
+ *
+ * See specs/components/show/Chat.spec.md §3 + semi-foundation/lib/es/chat/foundation.js。
+ */
+// ---------------------------------------------------------------------------
+// 常量（对齐 Semi chat.constants）
+// ---------------------------------------------------------------------------
+/** 消息角色。 */
+export const CHAT_ROLE = {
+    USER: 'user',
+    ASSISTANT: 'assistant',
+    SYSTEM: 'system',
+    DIVIDER: 'divider',
+};
+/** 布局对齐。 */
+export const CHAT_ALIGN = {
+    LEFT_RIGHT: 'leftRight',
+    LEFT_ALIGN: 'leftAlign',
+};
+/** 气泡模式。 */
+export const CHAT_MODE = {
+    BUBBLE: 'bubble',
+    NO_BUBBLE: 'noBubble',
+    USER_BUBBLE: 'userBubble',
+};
+/** 消息状态。 */
+export const MESSAGE_STATUS = {
+    LOADING: 'loading',
+    INCOMPLETE: 'incomplete',
+    COMPLETE: 'complete',
+    ERROR: 'error',
+};
+/** 发送快捷键。 */
+export const SEND_HOT_KEY = {
+    ENTER: 'enter',
+    SHIFT_PLUS_ENTER: 'shift+enter',
+};
+/** 图片后缀与前缀（用于 onMessageSend 附件图片/文件分流）。 */
+export const PIC_SUFFIX_ARRAY = ['png', 'jpg', 'jpeg', 'gif', 'bmp', 'webp'];
+export const PIC_PREFIX = 'image/';
+/** 返回底部按钮显隐阈值（px）。 */
+export const SHOW_SCROLL_GAP = 100;
+/** 滚动到底动画时长（ms）。 */
+export const SCROLL_ANIMATION_TIME = 300;
+// ---------------------------------------------------------------------------
+// 纯函数（无副作用，直接单测）
+// ---------------------------------------------------------------------------
+/**
+ * back-bottom 按钮是否应可见。
+ * 对齐 Semi getScroll：距底部（scrollHeight - scrollTop - clientHeight）> SHOW_SCROLL_GAP → 显示。
+ */
+export function shouldShowBackBottom(scrollHeight, scrollTop, clientHeight, gap = SHOW_SCROLL_GAP) {
+    return scrollHeight - scrollTop - clientHeight > gap;
+}
+/**
+ * enableUpload 三态归一（对齐 Semi getUploadProps）。
+ * - boolean → 三态同值。
+ * - 对象 → 缺省字段各默认 true。
+ * - 其它（undefined 等）→ 全 true。
+ */
+export function resolveEnableUpload(enableUpload) {
+    if (enableUpload !== null &&
+        typeof enableUpload === 'object' &&
+        Object.prototype.toString.call(enableUpload) === '[object Object]') {
+        const { dragUpload = true, clickUpload = true, pasteUpload = true } = enableUpload;
+        return { dragUpload, clickUpload, pasteUpload };
+    }
+    if (typeof enableUpload === 'boolean') {
+        return {
+            dragUpload: enableUpload,
+            clickUpload: enableUpload,
+            pasteUpload: enableUpload,
+        };
+    }
+    return { dragUpload: true, clickUpload: true, pasteUpload: true };
+}
+/**
+ * 按 sendHotKey 判定一次 Enter 是否应触发发送（对齐 Semi onEnterPress）。
+ * - `'enter'`：按下 Shift 时不发送（换行）。
+ * - `'shift+enter'`：未按 Shift 时不发送（换行）。
+ */
+export function shouldSendOnEnter(sendHotKey, shiftKey) {
+    if (sendHotKey === SEND_HOT_KEY.SHIFT_PLUS_ENTER && shiftKey === false) {
+        return false;
+    }
+    if (sendHotKey === SEND_HOT_KEY.ENTER && shiftKey === true) {
+        return false;
+    }
+    return true;
+}
+/** 附件是否为图片（对齐 Semi：MIME 前缀 image/ 或后缀命中图片集）。 */
+export function isImageAttachment(item) {
+    const name = typeof item.name === 'string' ? item.name : '';
+    const suffix = name.split('.').pop()?.toLowerCase() ?? '';
+    const mime = item.fileInstance && typeof item.fileInstance.type === 'string'
+        ? item.fileInstance.type
+        : '';
+    return mime.startsWith(PIC_PREFIX) || PIC_SUFFIX_ARRAY.includes(suffix);
+}
+/**
+ * 组装一条发送消息的 content（对齐 Semi onMessageSend）。
+ * - 无附件（attachment 为空数组）→ 返回纯文本 string。
+ * - 有附件 → 返回 Content[]：先文本（若有），再各附件按图片/文件分流。
+ */
+export function buildSendContent(input, attachment) {
+    if (Boolean(attachment) && attachment.length === 0) {
+        return input;
+    }
+    const content = [];
+    if (input) {
+        content.push({ type: 'text', text: input });
+    }
+    for (const item of attachment ?? []) {
+        const { name = '', url = '', size } = item;
+        if (isImageAttachment(item)) {
+            content.push({ type: 'image_url', image_url: { url } });
+        }
+        else {
+            const fileType = item.fileInstance && typeof item.fileInstance.type === 'string'
+                ? item.fileInstance.type
+                : undefined;
+            const file_url = { url, name };
+            if (size !== undefined)
+                file_url.size = size;
+            if (fileType !== undefined)
+                file_url.type = fileType;
+            content.push({ type: 'file_url', file_url });
+        }
+    }
+    return content;
+}
+/**
+ * clearContext：末尾追加一条 divider 消息（对齐 Semi clearContext）。
+ * 若末尾已是 divider，则原样返回（不重复追加）。
+ * id / createAt 由调用方注入（保持核心纯净、可测）。
+ */
+export function appendDivider(chats, makeId, now = Date.now) {
+    const last = chats[chats.length - 1];
+    if (last && last.role === CHAT_ROLE.DIVIDER) {
+        return chats;
+    }
+    return [...chats, { role: CHAT_ROLE.DIVIDER, id: makeId(), createAt: now() }];
+}
+/** 构造一条 user 消息（对齐 Semi onMessageSend / onHintClick 的 newMessage）。 */
+export function makeUserMessage(content, makeId, now = Date.now) {
+    return {
+        role: CHAT_ROLE.USER,
+        id: makeId(),
+        createAt: now(),
+        content,
+    };
+}
+/** 删除指定 id 的消息（对齐 Semi deleteMessage）。 */
+export function deleteMessageFrom(chats, target) {
+    return chats.filter((item) => item.id !== target.id);
+}
+/**
+ * 切换 like（对齐 Semi likeMessage）：目标消息 like 取反、dislike 置 false，其余不变。
+ */
+export function toggleLike(chats, target) {
+    const index = chats.findIndex((item) => item.id === target.id);
+    if (index === -1)
+        return chats;
+    const current = chats[index];
+    const next = [...chats];
+    next[index] = { ...current, like: !current.like, dislike: false };
+    return next;
+}
+/**
+ * 切换 dislike（对齐 Semi dislikeMessage）：目标消息 dislike 取反、like 置 false，其余不变。
+ */
+export function toggleDislike(chats, target) {
+    const index = chats.findIndex((item) => item.id === target.id);
+    if (index === -1)
+        return chats;
+    const current = chats[index];
+    const next = [...chats];
+    next[index] = { ...current, like: false, dislike: !current.dislike };
+    return next;
+}
+/**
+ * 重置最后一条消息为 loading（对齐 Semi resetMessage）：
+ * 复制末条并置 status=loading / content='' / 新 id / 新 createAt，替换末条。
+ */
+export function resetLastMessage(chats, makeId, now = Date.now) {
+    if (chats.length === 0)
+        return chats;
+    const last = chats[chats.length - 1];
+    const reset = {
+        ...last,
+        status: MESSAGE_STATUS.LOADING,
+        content: '',
+        id: makeId(),
+        createAt: now(),
+    };
+    return chats.slice(0, -1).concat(reset);
+}
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"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"}

package/dist/chat.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chat.test.d.ts.map

package/dist/chat.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.test.d.ts","sourceRoot":"","sources":["../src/chat.test.ts"],"names":[],"mappings":""}

package/dist/chat.test.js

@@ -0,0 +1,181 @@
+import { describe, expect, it } from 'vitest';
+import { CHAT_ROLE, MESSAGE_STATUS, SEND_HOT_KEY, SHOW_SCROLL_GAP, SCROLL_ANIMATION_TIME, shouldShowBackBottom, resolveEnableUpload, shouldSendOnEnter, isImageAttachment, buildSendContent, appendDivider, makeUserMessage, deleteMessageFrom, toggleLike, toggleDislike, resetLastMessage, } from './chat.js';
+describe('chat constants', () => {
+    it('exposes Semi-aligned constants', () => {
+        expect(SHOW_SCROLL_GAP).toBe(100);
+        expect(SCROLL_ANIMATION_TIME).toBe(300);
+        expect(CHAT_ROLE.DIVIDER).toBe('divider');
+        expect(MESSAGE_STATUS.LOADING).toBe('loading');
+        expect(SEND_HOT_KEY.SHIFT_PLUS_ENTER).toBe('shift+enter');
+    });
+});
+describe('shouldShowBackBottom', () => {
+    it('hides within gap of the bottom', () => {
+        // distance = 1000 - 950 - 50 = 0 <= 100 → hidden
+        expect(shouldShowBackBottom(1000, 950, 50)).toBe(false);
+    });
+    it('shows when scrolled up beyond gap', () => {
+        // distance = 1000 - 300 - 50 = 650 > 100 → visible
+        expect(shouldShowBackBottom(1000, 300, 50)).toBe(true);
+    });
+    it('boundary: exactly gap → hidden', () => {
+        // distance = 1000 - 850 - 50 = 100, not > 100 → hidden
+        expect(shouldShowBackBottom(1000, 850, 50)).toBe(false);
+    });
+    it('boundary: one px beyond gap → visible', () => {
+        expect(shouldShowBackBottom(1000, 849, 50)).toBe(true);
+    });
+});
+describe('resolveEnableUpload (三态)', () => {
+    it('undefined → all true', () => {
+        expect(resolveEnableUpload(undefined)).toEqual({
+            dragUpload: true,
+            clickUpload: true,
+            pasteUpload: true,
+        });
+    });
+    it('boolean true → all true', () => {
+        expect(resolveEnableUpload(true)).toEqual({
+            dragUpload: true,
+            clickUpload: true,
+            pasteUpload: true,
+        });
+    });
+    it('boolean false → all false', () => {
+        expect(resolveEnableUpload(false)).toEqual({
+            dragUpload: false,
+            clickUpload: false,
+            pasteUpload: false,
+        });
+    });
+    it('object → per-field, missing defaults true', () => {
+        expect(resolveEnableUpload({ clickUpload: false })).toEqual({
+            dragUpload: true,
+            clickUpload: false,
+            pasteUpload: true,
+        });
+    });
+    it('object all false', () => {
+        expect(resolveEnableUpload({ clickUpload: false, dragUpload: false, pasteUpload: false })).toEqual({ dragUpload: false, clickUpload: false, pasteUpload: false });
+    });
+});
+describe('shouldSendOnEnter', () => {
+    it('enter: plain Enter sends', () => {
+        expect(shouldSendOnEnter('enter', false)).toBe(true);
+    });
+    it('enter: Shift+Enter does not send (newline)', () => {
+        expect(shouldSendOnEnter('enter', true)).toBe(false);
+    });
+    it('shift+enter: plain Enter does not send (newline)', () => {
+        expect(shouldSendOnEnter('shift+enter', false)).toBe(false);
+    });
+    it('shift+enter: Shift+Enter sends', () => {
+        expect(shouldSendOnEnter('shift+enter', true)).toBe(true);
+    });
+});
+describe('isImageAttachment', () => {
+    it('detects by MIME prefix', () => {
+        expect(isImageAttachment({ name: 'x', fileInstance: { type: 'image/png' } })).toBe(true);
+    });
+    it('detects by suffix', () => {
+        expect(isImageAttachment({ name: 'photo.JPEG' })).toBe(true);
+    });
+    it('non-image file', () => {
+        expect(isImageAttachment({ name: 'doc.pdf', fileInstance: { type: 'application/pdf' } })).toBe(false);
+    });
+});
+describe('buildSendContent', () => {
+    it('no attachment → plain text string', () => {
+        expect(buildSendContent('hello', [])).toBe('hello');
+    });
+    it('text + image + file → Content[]', () => {
+        const attachment = [
+            { name: 'a.png', url: 'blob:img', fileInstance: { type: 'image/png' } },
+            { name: 'b.pdf', url: 'blob:pdf', size: 10, fileInstance: { type: 'application/pdf' } },
+        ];
+        const content = buildSendContent('hi', attachment);
+        expect(content[0]).toEqual({ type: 'text', text: 'hi' });
+        expect(content[1]).toEqual({ type: 'image_url', image_url: { url: 'blob:img' } });
+        expect(content[2]).toEqual({
+            type: 'file_url',
+            file_url: { url: 'blob:pdf', name: 'b.pdf', size: 10, type: 'application/pdf' },
+        });
+    });
+    it('empty text with attachment → no leading text node', () => {
+        const content = buildSendContent('', [
+            { name: 'a.png', url: 'u', fileInstance: { type: 'image/png' } },
+        ]);
+        expect(content).toHaveLength(1);
+        expect(content[0].type).toBe('image_url');
+    });
+});
+describe('appendDivider (clearContext)', () => {
+    const makeId = () => 'id-div';
+    it('appends a divider message', () => {
+        const chats = [{ id: '1', role: 'user', content: 'x' }];
+        const next = appendDivider(chats, makeId, () => 1000);
+        expect(next).toHaveLength(2);
+        expect(next[1]).toEqual({ role: CHAT_ROLE.DIVIDER, id: 'id-div', createAt: 1000 });
+    });
+    it('skips when last already divider', () => {
+        const chats = [{ id: 'd', role: CHAT_ROLE.DIVIDER }];
+        expect(appendDivider(chats, makeId)).toBe(chats);
+    });
+});
+describe('makeUserMessage', () => {
+    it('builds a user message', () => {
+        const m = makeUserMessage('hi', () => 'uid', () => 42);
+        expect(m).toEqual({ role: CHAT_ROLE.USER, id: 'uid', createAt: 42, content: 'hi' });
+    });
+});
+describe('delete / like / dislike / reset', () => {
+    const base = [
+        { id: '1', role: 'user', content: 'a' },
+        { id: '2', role: 'assistant', content: 'b' },
+    ];
+    it('deleteMessageFrom removes by id', () => {
+        const next = deleteMessageFrom(base, { id: '1' });
+        expect(next).toHaveLength(1);
+        expect(next[0].id).toBe('2');
+    });
+    it('toggleLike sets like true, dislike false', () => {
+        const next = toggleLike(base, { id: '2' });
+        expect(next[1].like).toBe(true);
+        expect(next[1].dislike).toBe(false);
+        // untouched message unchanged
+        expect(next[0]).toBe(base[0]);
+    });
+    it('toggleLike is a toggle', () => {
+        const liked = toggleLike(base, { id: '2' });
+        const unliked = toggleLike(liked, { id: '2' });
+        expect(unliked[1].like).toBe(false);
+    });
+    it('toggleDislike sets dislike true, like false', () => {
+        const next = toggleDislike(base, { id: '2' });
+        expect(next[1].dislike).toBe(true);
+        expect(next[1].like).toBe(false);
+    });
+    it('like then dislike clears like', () => {
+        const liked = toggleLike(base, { id: '2' });
+        const disliked = toggleDislike(liked, { id: '2' });
+        expect(disliked[1].like).toBe(false);
+        expect(disliked[1].dislike).toBe(true);
+    });
+    it('resetLastMessage resets tail to loading', () => {
+        const next = resetLastMessage(base, () => 'new', () => 99);
+        expect(next[1]).toEqual({
+            id: 'new',
+            role: 'assistant',
+            content: '',
+            status: MESSAGE_STATUS.LOADING,
+            createAt: 99,
+        });
+        // previous untouched
+        expect(next[0]).toBe(base[0]);
+    });
+    it('missing target id is a no-op', () => {
+        expect(toggleLike(base, { id: 'nope' })).toBe(base);
+        expect(toggleDislike(base, { id: 'nope' })).toBe(base);
+    });
+});
+//# sourceMappingURL=chat.test.js.map

package/dist/chat.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.test.js","sourceRoot":"","sources":["../src/chat.test.ts"],"names":[],"mappings":"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"}

package/dist/code-highlight.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CodeHighlight helpers — framework-agnostic class-name resolution for a
+ * Prism-highlighted `<code>` element. Pure functions only; the render layer
+ * (svelte runes) owns the DOM effect that calls Prism.highlightElement.
+ *
+ * Mirrors Semi Design (semi-foundation/codeHighlight): the `<code>` element
+ * gets `language-<lang>` and, when line numbers are on, `line-numbers`.
+ * We keep Prism itself out of core so this package stays library-agnostic.
+ */
+export interface ResolveCodeClassNameOptions {
+    /** Prism language id, e.g. 'js' | 'ts' | 'css' | 'markup'. */
+    language: string;
+    /** When true, add Prism's `line-numbers` plugin class. */
+    lineNumber?: boolean;
+}
+/**
+ * Resolve the class string for the `<code>` element Prism highlights.
+ *
+ * Aligns with Semi: if a `language-*` class already exists on the element we
+ * do NOT add another (avoids duplicate/conflicting language classes across
+ * re-highlights); the required `line-numbers` class is added/kept when
+ * `lineNumber` is on and removed when off.
+ *
+ * @param currentClassName the code element's existing className (may be empty)
+ * @param language Prism language id
+ * @param lineNumber whether to enable the line-numbers plugin
+ * @returns the deduplicated, space-joined class string
+ */
+export declare function resolveCodeClassName(currentClassName: string, language: string, lineNumber?: boolean): string;
+//# sourceMappingURL=code-highlight.d.ts.map

package/dist/code-highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-highlight.d.ts","sourceRoot":"","sources":["../src/code-highlight.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,2BAA2B;IAC1C,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,UAAO,GAChB,MAAM,CAeR"}

package/dist/code-highlight.js

@@ -0,0 +1,37 @@
+/**
+ * CodeHighlight helpers — framework-agnostic class-name resolution for a
+ * Prism-highlighted `<code>` element. Pure functions only; the render layer
+ * (svelte runes) owns the DOM effect that calls Prism.highlightElement.
+ *
+ * Mirrors Semi Design (semi-foundation/codeHighlight): the `<code>` element
+ * gets `language-<lang>` and, when line numbers are on, `line-numbers`.
+ * We keep Prism itself out of core so this package stays library-agnostic.
+ */
+const LANGUAGE_CLASS_RE = /(^|\s)language-\S+/;
+/**
+ * Resolve the class string for the `<code>` element Prism highlights.
+ *
+ * Aligns with Semi: if a `language-*` class already exists on the element we
+ * do NOT add another (avoids duplicate/conflicting language classes across
+ * re-highlights); the required `line-numbers` class is added/kept when
+ * `lineNumber` is on and removed when off.
+ *
+ * @param currentClassName the code element's existing className (may be empty)
+ * @param language Prism language id
+ * @param lineNumber whether to enable the line-numbers plugin
+ * @returns the deduplicated, space-joined class string
+ */
+export function resolveCodeClassName(currentClassName, language, lineNumber = true) {
+    const classes = (currentClassName ?? '')
+        .split(/\s+/)
+        .filter((c) => c && c !== 'line-numbers');
+    const hasLanguage = LANGUAGE_CLASS_RE.test(currentClassName ?? '');
+    if (!hasLanguage && language) {
+        classes.push(`language-${language}`);
+    }
+    if (lineNumber) {
+        classes.push('line-numbers');
+    }
+    return classes.join(' ');
+}
+//# sourceMappingURL=code-highlight.js.map

package/dist/code-highlight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-highlight.js","sourceRoot":"","sources":["../src/code-highlight.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAClC,gBAAwB,EACxB,QAAgB,EAChB,UAAU,GAAG,IAAI;IAEjB,MAAM,OAAO,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;SACrC,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,cAAc,CAAC,CAAC;IAE5C,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC,WAAW,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC"}

package/dist/code-highlight.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=code-highlight.test.d.ts.map

package/dist/code-highlight.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-highlight.test.d.ts","sourceRoot":"","sources":["../src/code-highlight.test.ts"],"names":[],"mappings":""}

package/dist/code-highlight.test.js

@@ -0,0 +1,36 @@
+import { describe, expect, it } from 'vitest';
+import { resolveCodeClassName } from './code-highlight.js';
+describe('resolveCodeClassName', () => {
+    it('adds language-<lang> when empty', () => {
+        expect(resolveCodeClassName('', 'js', false)).toBe('language-js');
+    });
+    it('adds line-numbers when lineNumber on', () => {
+        expect(resolveCodeClassName('', 'ts', true)).toBe('language-ts line-numbers');
+    });
+    it('defaults lineNumber to true', () => {
+        expect(resolveCodeClassName('', 'css')).toBe('language-css line-numbers');
+    });
+    it('does not duplicate an existing language class', () => {
+        expect(resolveCodeClassName('language-js', 'js', false)).toBe('language-js');
+    });
+    it('keeps an existing (different) language class and does not add a new one', () => {
+        // aligns with Semi: presence of any language-* short-circuits adding
+        expect(resolveCodeClassName('language-python', 'js', false)).toBe('language-python');
+    });
+    it('preserves unrelated existing classes', () => {
+        expect(resolveCodeClassName('foo bar', 'js', false)).toBe('foo bar language-js');
+    });
+    it('removes line-numbers when lineNumber is off', () => {
+        expect(resolveCodeClassName('language-js line-numbers', 'js', false)).toBe('language-js');
+    });
+    it('does not duplicate line-numbers when already present and on', () => {
+        expect(resolveCodeClassName('language-js line-numbers', 'js', true)).toBe('language-js line-numbers');
+    });
+    it('omits language class when language is empty', () => {
+        expect(resolveCodeClassName('', '', false)).toBe('');
+    });
+    it('handles extra whitespace in the incoming className', () => {
+        expect(resolveCodeClassName('  foo   ', 'js', false)).toBe('foo language-js');
+    });
+});
+//# sourceMappingURL=code-highlight.test.js.map

package/dist/code-highlight.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-highlight.test.js","sourceRoot":"","sources":["../src/code-highlight.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,oBAAoB,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,oBAAoB,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,oBAAoB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,oBAAoB,CAAC,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,qEAAqE;QACrE,MAAM,CAAC,oBAAoB,CAAC,iBAAiB,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,oBAAoB,CAAC,0BAA0B,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,oBAAoB,CAAC,0BAA0B,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CACvE,0BAA0B,CAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,oBAAoB,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,oBAAoB,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/collapsible.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Collapsible headless — 折叠容器原语的渲染/可见性派生逻辑。
+ * 无 DOM 依赖的纯函数，供 Collapsible.svelte 与单测复用。
+ *
+ * 对齐 Semi collapsible foundation：
+ *  - visible：内容当前是否「视觉可见」（展开中或展开完成）；折叠过渡结束后置 false。
+ *  - shouldRender：内容 DOM 是否应挂载（keepDOM × lazyRender × isOpen × collapseHeight 组合）。
+ */
+export interface CollapsibleRenderInput {
+    /** 是否展开 */
+    isOpen: boolean;
+    /** 折叠时是否保留 DOM（false 则完全折叠后卸载内容） */
+    keepDOM: boolean;
+    /** 首次展开前不渲染（配合 keepDOM 的首帧惰性） */
+    lazyRender: boolean;
+    /** 折叠时保留的高度（>0 时内容常驻以呈现「展开更多」截断） */
+    collapseHeight: number;
+    /** 内容当前视觉可见（展开中/展开完成，折叠过渡结束前仍为 true） */
+    visible: boolean;
+    /** 内容此前是否已被渲染过（lazyRender 用；普通簿记，非响应式） */
+    hasBeenRendered: boolean;
+}
+/**
+ * 是否应把内容挂载到 DOM。对齐 Semi：
+ *   keepDOM && (lazyRender ? hasBeenRendered : true)
+ *   || collapseHeight !== 0
+ *   || visible
+ *   || isOpen
+ *
+ * - keepDOM 且非 lazyRender：内容常驻。
+ * - keepDOM 且 lazyRender：首次展开（hasBeenRendered）后才常驻。
+ * - collapseHeight>0：折叠仍保留部分高度，故内容必须挂载。
+ * - 其余：展开中/展开完成（visible）或正在展开（isOpen）时挂载，完全折叠后卸载。
+ */
+export declare function collapsibleShouldRender(input: CollapsibleRenderInput): boolean;
+/**
+ * 折叠态实际保留高度：collapseHeightAdaptive 时不超过实测内容高度，
+ * 否则直接用 collapseHeight。domHeight 为已测内容高度（无测量时传 0）。
+ */
+export declare function collapsibleCollapsedHeight(collapseHeight: number, collapseHeightAdaptive: boolean, domHeight: number): number;
+//# sourceMappingURL=collapsible.d.ts.map

package/dist/collapsible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collapsible.d.ts","sourceRoot":"","sources":["../src/collapsible.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,sBAAsB;IACrC,WAAW;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAI9E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,MAAM,EACtB,sBAAsB,EAAE,OAAO,EAC/B,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}

package/dist/collapsible.js

@@ -0,0 +1,33 @@
+/**
+ * Collapsible headless — 折叠容器原语的渲染/可见性派生逻辑。
+ * 无 DOM 依赖的纯函数，供 Collapsible.svelte 与单测复用。
+ *
+ * 对齐 Semi collapsible foundation：
+ *  - visible：内容当前是否「视觉可见」（展开中或展开完成）；折叠过渡结束后置 false。
+ *  - shouldRender：内容 DOM 是否应挂载（keepDOM × lazyRender × isOpen × collapseHeight 组合）。
+ */
+/**
+ * 是否应把内容挂载到 DOM。对齐 Semi：
+ *   keepDOM && (lazyRender ? hasBeenRendered : true)
+ *   || collapseHeight !== 0
+ *   || visible
+ *   || isOpen
+ *
+ * - keepDOM 且非 lazyRender：内容常驻。
+ * - keepDOM 且 lazyRender：首次展开（hasBeenRendered）后才常驻。
+ * - collapseHeight>0：折叠仍保留部分高度，故内容必须挂载。
+ * - 其余：展开中/展开完成（visible）或正在展开（isOpen）时挂载，完全折叠后卸载。
+ */
+export function collapsibleShouldRender(input) {
+    const { isOpen, keepDOM, lazyRender, collapseHeight, visible, hasBeenRendered } = input;
+    const keptByDOM = keepDOM && (lazyRender ? hasBeenRendered : true);
+    return keptByDOM || collapseHeight !== 0 || visible || isOpen;
+}
+/**
+ * 折叠态实际保留高度：collapseHeightAdaptive 时不超过实测内容高度，
+ * 否则直接用 collapseHeight。domHeight 为已测内容高度（无测量时传 0）。
+ */
+export function collapsibleCollapsedHeight(collapseHeight, collapseHeightAdaptive, domHeight) {
+    return collapseHeightAdaptive ? Math.min(domHeight, collapseHeight) : collapseHeight;
+}
+//# sourceMappingURL=collapsible.js.map

package/dist/collapsible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collapsible.js","sourceRoot":"","sources":["../src/collapsible.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAA6B;IACnE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC;IACxF,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,SAAS,IAAI,cAAc,KAAK,CAAC,IAAI,OAAO,IAAI,MAAM,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,cAAsB,EACtB,sBAA+B,EAC/B,SAAiB;IAEjB,OAAO,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;AACvF,CAAC"}

package/dist/collapsible.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=collapsible.test.d.ts.map

package/dist/collapsible.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collapsible.test.d.ts","sourceRoot":"","sources":["../src/collapsible.test.ts"],"names":[],"mappings":""}