@yh-ui/components 0.1.10 → 0.1.12

package/dist/ai-bubble/src/ai-bubble.vue.d.ts

@@ -0,0 +1,110 @@
+import 'highlight.js/styles/atom-one-dark.css';
+declare var __VLS_1: {}, __VLS_15: {}, __VLS_17: {}, __VLS_55: {};
+type __VLS_Slots = {} & {
+    avatar?: (props: typeof __VLS_1) => any;
+} & {
+    header?: (props: typeof __VLS_15) => any;
+} & {
+    default?: (props: typeof __VLS_17) => any;
+} & {
+    footer?: (props: typeof __VLS_55) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    readonly content: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly markdown: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    readonly role: {
+        readonly type: import("vue").PropType<"user" | "assistant" | "system">;
+        readonly default: "assistant";
+    };
+    readonly placement: {
+        readonly type: import("vue").PropType<"start" | "end">;
+    };
+    readonly shape: {
+        readonly type: import("vue").PropType<"round" | "corner">;
+        readonly default: "round";
+    };
+    readonly variant: {
+        readonly type: import("vue").PropType<"filled" | "outlined" | "borderless" | "shadow">;
+        readonly default: "filled";
+    };
+    readonly time: StringConstructor;
+    readonly avatar: StringConstructor;
+    readonly loading: BooleanConstructor;
+    readonly typing: BooleanConstructor;
+    readonly citations: {
+        readonly type: import("vue").PropType<import("./ai-bubble").AiCitation[]>;
+        readonly default: () => never[];
+    };
+    readonly multimodal: {
+        readonly type: import("vue").PropType<import("./ai-bubble").AiMultimodal[]>;
+        readonly default: () => never[];
+    };
+    readonly themeOverrides: {
+        readonly type: import("vue").PropType<import("@yh-ui/theme").ComponentThemeVars>;
+        readonly default: undefined;
+    };
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    readonly content: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly markdown: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    readonly role: {
+        readonly type: import("vue").PropType<"user" | "assistant" | "system">;
+        readonly default: "assistant";
+    };
+    readonly placement: {
+        readonly type: import("vue").PropType<"start" | "end">;
+    };
+    readonly shape: {
+        readonly type: import("vue").PropType<"round" | "corner">;
+        readonly default: "round";
+    };
+    readonly variant: {
+        readonly type: import("vue").PropType<"filled" | "outlined" | "borderless" | "shadow">;
+        readonly default: "filled";
+    };
+    readonly time: StringConstructor;
+    readonly avatar: StringConstructor;
+    readonly loading: BooleanConstructor;
+    readonly typing: BooleanConstructor;
+    readonly citations: {
+        readonly type: import("vue").PropType<import("./ai-bubble").AiCitation[]>;
+        readonly default: () => never[];
+    };
+    readonly multimodal: {
+        readonly type: import("vue").PropType<import("./ai-bubble").AiMultimodal[]>;
+        readonly default: () => never[];
+    };
+    readonly themeOverrides: {
+        readonly type: import("vue").PropType<import("@yh-ui/theme").ComponentThemeVars>;
+        readonly default: undefined;
+    };
+}>> & Readonly<{}>, {
+    readonly themeOverrides: import("@yh-ui/theme").ComponentThemeVars;
+    readonly content: string;
+    readonly variant: "filled" | "outlined" | "borderless" | "shadow";
+    readonly loading: boolean;
+    readonly markdown: boolean;
+    readonly role: "user" | "assistant" | "system";
+    readonly shape: "round" | "corner";
+    readonly typing: boolean;
+    readonly citations: import("./ai-bubble").AiCitation[];
+    readonly multimodal: import("./ai-bubble").AiMultimodal[];
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/ai-chat/__tests__/ai-chat.ssr.test.cjs

@@ -0,0 +1,82 @@
+"use strict";
+
+var _vitest = require("vitest");
+var _serverRenderer = require("@vue/server-renderer");
+var _vue = require("vue");
+_vitest.vi.mock("markdown-it", async () => {
+  class MockMd {
+    inline = {
+      ruler: {
+        after: _vitest.vi.fn()
+      }
+    };
+    render(content) {
+      return `<p>${content}</p>`;
+    }
+  }
+  return {
+    default: MockMd
+  };
+});
+_vitest.vi.mock("highlight.js", () => ({
+  default: {
+    getLanguage: () => false,
+    highlight: _vitest.vi.fn(),
+    highlightAuto: _vitest.vi.fn(() => ({
+      value: ""
+    }))
+  }
+}));
+_vitest.vi.mock("highlight.js/styles/atom-one-dark.css", () => ({}));
+const {
+  default: AiChat
+} = await Promise.resolve().then(() => require("../src/ai-chat.vue"));
+(0, _vitest.describe)("YhAiChat SSR", () => {
+  (0, _vitest.it)("should render to string on server", async () => {
+    const html = await (0, _serverRenderer.renderToString)((0, _vue.h)(AiChat));
+    (0, _vitest.expect)(html).toContain("yh-ai-chat");
+  });
+  (0, _vitest.it)("should render content area on server", async () => {
+    const html = await (0, _serverRenderer.renderToString)((0, _vue.h)(AiChat));
+    (0, _vitest.expect)(html).toContain("yh-ai-chat__content");
+  });
+  (0, _vitest.it)("should render footer on server", async () => {
+    const html = await (0, _serverRenderer.renderToString)((0, _vue.h)(AiChat));
+    (0, _vitest.expect)(html).toContain("yh-ai-chat__footer");
+  });
+  (0, _vitest.it)("should render message content on server", async () => {
+    const html = await (0, _serverRenderer.renderToString)((0, _vue.h)(AiChat, {
+      messages: [{
+        id: "1",
+        role: "user",
+        content: "SSR hello"
+      }]
+    }));
+    (0, _vitest.expect)(html).toContain("SSR hello");
+  });
+  (0, _vitest.it)("should render suggestions on server when messages empty", async () => {
+    const html = await (0, _serverRenderer.renderToString)((0, _vue.h)(AiChat, {
+      messages: [],
+      suggestions: ["Write code", "Translate"]
+    }));
+    (0, _vitest.expect)(html).toContain("Write code");
+    (0, _vitest.expect)(html).toContain("Translate");
+  });
+  (0, _vitest.it)("should render header with clear button when messages exist on server", async () => {
+    const html = await (0, _serverRenderer.renderToString)((0, _vue.h)(AiChat, {
+      messages: [{
+        id: "1",
+        role: "user",
+        content: "hi"
+      }]
+    }));
+    (0, _vitest.expect)(html).toContain("yh-ai-chat__header");
+  });
+  (0, _vitest.it)("should render loading bubble on server when loading=true", async () => {
+    const html = await (0, _serverRenderer.renderToString)((0, _vue.h)(AiChat, {
+      loading: true,
+      messages: []
+    }));
+    (0, _vitest.expect)(html).toContain("is-loading");
+  });
+});

package/dist/ai-chat/__tests__/ai-chat.ssr.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ai-chat/__tests__/ai-chat.ssr.test.mjs

@@ -0,0 +1,69 @@
+import { describe, it, expect, vi } from "vitest";
+import { renderToString } from "@vue/server-renderer";
+import { h } from "vue";
+vi.mock("markdown-it", async () => {
+  class MockMd {
+    inline = {
+      ruler: {
+        after: vi.fn()
+      }
+    };
+    render(content) {
+      return `<p>${content}</p>`;
+    }
+  }
+  return { default: MockMd };
+});
+vi.mock("highlight.js", () => ({
+  default: {
+    getLanguage: () => false,
+    highlight: vi.fn(),
+    highlightAuto: vi.fn(() => ({ value: "" }))
+  }
+}));
+vi.mock("highlight.js/styles/atom-one-dark.css", () => ({}));
+const { default: AiChat } = await import("../src/ai-chat.vue");
+describe("YhAiChat SSR", () => {
+  it("should render to string on server", async () => {
+    const html = await renderToString(h(AiChat));
+    expect(html).toContain("yh-ai-chat");
+  });
+  it("should render content area on server", async () => {
+    const html = await renderToString(h(AiChat));
+    expect(html).toContain("yh-ai-chat__content");
+  });
+  it("should render footer on server", async () => {
+    const html = await renderToString(h(AiChat));
+    expect(html).toContain("yh-ai-chat__footer");
+  });
+  it("should render message content on server", async () => {
+    const html = await renderToString(
+      h(AiChat, {
+        messages: [{ id: "1", role: "user", content: "SSR hello" }]
+      })
+    );
+    expect(html).toContain("SSR hello");
+  });
+  it("should render suggestions on server when messages empty", async () => {
+    const html = await renderToString(
+      h(AiChat, {
+        messages: [],
+        suggestions: ["Write code", "Translate"]
+      })
+    );
+    expect(html).toContain("Write code");
+    expect(html).toContain("Translate");
+  });
+  it("should render header with clear button when messages exist on server", async () => {
+    const html = await renderToString(
+      h(AiChat, {
+        messages: [{ id: "1", role: "user", content: "hi" }]
+      })
+    );
+    expect(html).toContain("yh-ai-chat__header");
+  });
+  it("should render loading bubble on server when loading=true", async () => {
+    const html = await renderToString(h(AiChat, { loading: true, messages: [] }));
+    expect(html).toContain("is-loading");
+  });
+});

package/dist/ai-chat/__tests__/ai-chat.test.cjs

@@ -0,0 +1,169 @@
+"use strict";
+
+var _vitest = require("vitest");
+var _testUtils = require("@vue/test-utils");
+_vitest.vi.mock("markdown-it", async () => {
+  class MockMd {
+    inline = {
+      ruler: {
+        after: _vitest.vi.fn()
+      }
+    };
+    render(content) {
+      return `<p>${content}</p>`;
+    }
+  }
+  return {
+    default: MockMd
+  };
+});
+_vitest.vi.mock("highlight.js", () => ({
+  default: {
+    getLanguage: () => false,
+    highlight: _vitest.vi.fn(),
+    highlightAuto: _vitest.vi.fn(() => ({
+      value: ""
+    }))
+  }
+}));
+_vitest.vi.mock("highlight.js/styles/atom-one-dark.css", () => ({}));
+const {
+  default: AiChat
+} = await Promise.resolve().then(() => require("../src/ai-chat.vue"));
+const makeMsg = (id, role, content, status) => ({
+  id,
+  role,
+  content,
+  ...(status ? {
+    status
+  } : {})
+});
+(0, _vitest.describe)("YhAiChat", () => {
+  (0, _vitest.it)("should render with base class", () => {
+    const wrapper = (0, _testUtils.mount)(AiChat);
+    (0, _vitest.expect)(wrapper.find(".yh-ai-chat").exists()).toBe(true);
+  });
+  (0, _vitest.it)("should render content area", () => {
+    const wrapper = (0, _testUtils.mount)(AiChat);
+    (0, _vitest.expect)(wrapper.find(".yh-ai-chat__content").exists()).toBe(true);
+  });
+  (0, _vitest.it)("should render footer with sender by default", () => {
+    const wrapper = (0, _testUtils.mount)(AiChat);
+    (0, _vitest.expect)(wrapper.find(".yh-ai-chat__footer").exists()).toBe(true);
+  });
+  (0, _vitest.it)("should not render header when no messages and no header slot", () => {
+    const wrapper = (0, _testUtils.mount)(AiChat, {
+      props: {
+        messages: []
+      }
+    });
+    (0, _vitest.expect)(wrapper.find(".yh-ai-chat__header").exists()).toBe(false);
+  });
+  (0, _vitest.it)("should render header with clear button when messages exist", () => {
+    const wrapper = (0, _testUtils.mount)(AiChat, {
+      props: {
+        messages: [makeMsg("1", "user", "hello")]
+      }
+    });
+    (0, _vitest.expect)(wrapper.find(".yh-ai-chat__header").exists()).toBe(true);
+  });
+  (0, _vitest.it)("should render suggestions when messages are empty", () => {
+    const wrapper = (0, _testUtils.mount)(AiChat, {
+      props: {
+        messages: [],
+        suggestions: ["Help me", "Write code"]
+      }
+    });
+    const buttons = wrapper.findAll(".yh-ai-chat__suggestions .yh-button");
+    (0, _vitest.expect)(buttons.length).toBe(2);
+    (0, _vitest.expect)(buttons[0].text()).toBe("Help me");
+  });
+  (0, _vitest.it)("should not render suggestions when messages exist", () => {
+    const wrapper = (0, _testUtils.mount)(AiChat, {
+      props: {
+        messages: [makeMsg("1", "user", "hi")],
+        suggestions: ["Suggestion"]
+      }
+    });
+    (0, _vitest.expect)(wrapper.find(".yh-ai-chat__suggestions").exists()).toBe(false);
+  });
+  (0, _vitest.it)("should show loading bubble when loading=true and no messages", () => {
+    const wrapper = (0, _testUtils.mount)(AiChat, {
+      props: {
+        loading: true,
+        messages: []
+      }
+    });
+    (0, _vitest.expect)(wrapper.html()).toContain("is-loading");
+  });
+  (0, _vitest.it)("should emit send when suggestion clicked", async () => {
+    const wrapper = (0, _testUtils.mount)(AiChat, {
+      props: {
+        messages: [],
+        suggestions: ["Write me code"]
+      }
+    });
+    await wrapper.find(".yh-ai-chat__suggestions .yh-button").trigger("click");
+    (0, _vitest.expect)(wrapper.emitted("send")).toBeTruthy();
+    (0, _vitest.expect)(wrapper.emitted("send")[0][0]).toBe("Write me code");
+  });
+  (0, _vitest.it)("should emit clear and update:messages on clear button click", async () => {
+    const wrapper = (0, _testUtils.mount)(AiChat, {
+      props: {
+        messages: [makeMsg("1", "user", "hello")]
+      }
+    });
+    await wrapper.find(".yh-ai-chat__header .yh-button").trigger("click");
+    (0, _vitest.expect)(wrapper.emitted("clear")).toBeTruthy();
+    (0, _vitest.expect)(wrapper.emitted("update:messages")).toBeTruthy();
+    (0, _vitest.expect)(wrapper.emitted("update:messages")[0][0]).toEqual([]);
+  });
+  (0, _vitest.it)("should render message content from messages prop", () => {
+    const wrapper = (0, _testUtils.mount)(AiChat, {
+      props: {
+        messages: [makeMsg("1", "user", "test message content")]
+      }
+    });
+    (0, _vitest.expect)(wrapper.html()).toContain("test message content");
+  });
+  (0, _vitest.it)("should render multiple messages", () => {
+    const messages = [makeMsg("1", "user", "Hello"), makeMsg("2", "assistant", "Hi there")];
+    const wrapper = (0, _testUtils.mount)(AiChat, {
+      props: {
+        messages
+      }
+    });
+    (0, _vitest.expect)(wrapper.html()).toContain("Hello");
+    (0, _vitest.expect)(wrapper.html()).toContain("Hi there");
+  });
+  (0, _vitest.it)("should render header slot", () => {
+    const wrapper = (0, _testUtils.mount)(AiChat, {
+      props: {
+        messages: [makeMsg("1", "user", "hi")]
+      },
+      slots: {
+        header: '<div class="custom-header">Custom Header</div>'
+      }
+    });
+    (0, _vitest.expect)(wrapper.find(".custom-header").exists()).toBe(true);
+  });
+  (0, _vitest.it)("should render sender slot", () => {
+    const wrapper = (0, _testUtils.mount)(AiChat, {
+      slots: {
+        sender: '<div class="custom-sender">Custom Sender</div>'
+      }
+    });
+    (0, _vitest.expect)(wrapper.find(".custom-sender").exists()).toBe(true);
+  });
+  (0, _vitest.it)("should render custom message via message slot", () => {
+    const wrapper = (0, _testUtils.mount)(AiChat, {
+      props: {
+        messages: [makeMsg("1", "user", "any")]
+      },
+      slots: {
+        message: '<div class="custom-msg">Custom Message</div>'
+      }
+    });
+    (0, _vitest.expect)(wrapper.find(".custom-msg").exists()).toBe(true);
+  });
+});

package/dist/ai-chat/__tests__/ai-chat.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ai-chat/__tests__/ai-chat.test.mjs

@@ -0,0 +1,121 @@
+import { describe, it, expect, vi } from "vitest";
+import { mount } from "@vue/test-utils";
+vi.mock("markdown-it", async () => {
+  class MockMd {
+    inline = {
+      ruler: {
+        after: vi.fn()
+      }
+    };
+    render(content) {
+      return `<p>${content}</p>`;
+    }
+  }
+  return { default: MockMd };
+});
+vi.mock("highlight.js", () => ({
+  default: {
+    getLanguage: () => false,
+    highlight: vi.fn(),
+    highlightAuto: vi.fn(() => ({ value: "" }))
+  }
+}));
+vi.mock("highlight.js/styles/atom-one-dark.css", () => ({}));
+const { default: AiChat } = await import("../src/ai-chat.vue");
+const makeMsg = (id, role, content, status) => ({ id, role, content, ...status ? { status } : {} });
+describe("YhAiChat", () => {
+  it("should render with base class", () => {
+    const wrapper = mount(AiChat);
+    expect(wrapper.find(".yh-ai-chat").exists()).toBe(true);
+  });
+  it("should render content area", () => {
+    const wrapper = mount(AiChat);
+    expect(wrapper.find(".yh-ai-chat__content").exists()).toBe(true);
+  });
+  it("should render footer with sender by default", () => {
+    const wrapper = mount(AiChat);
+    expect(wrapper.find(".yh-ai-chat__footer").exists()).toBe(true);
+  });
+  it("should not render header when no messages and no header slot", () => {
+    const wrapper = mount(AiChat, { props: { messages: [] } });
+    expect(wrapper.find(".yh-ai-chat__header").exists()).toBe(false);
+  });
+  it("should render header with clear button when messages exist", () => {
+    const wrapper = mount(AiChat, {
+      props: { messages: [makeMsg("1", "user", "hello")] }
+    });
+    expect(wrapper.find(".yh-ai-chat__header").exists()).toBe(true);
+  });
+  it("should render suggestions when messages are empty", () => {
+    const wrapper = mount(AiChat, {
+      props: { messages: [], suggestions: ["Help me", "Write code"] }
+    });
+    const buttons = wrapper.findAll(".yh-ai-chat__suggestions .yh-button");
+    expect(buttons.length).toBe(2);
+    expect(buttons[0].text()).toBe("Help me");
+  });
+  it("should not render suggestions when messages exist", () => {
+    const wrapper = mount(AiChat, {
+      props: {
+        messages: [makeMsg("1", "user", "hi")],
+        suggestions: ["Suggestion"]
+      }
+    });
+    expect(wrapper.find(".yh-ai-chat__suggestions").exists()).toBe(false);
+  });
+  it("should show loading bubble when loading=true and no messages", () => {
+    const wrapper = mount(AiChat, { props: { loading: true, messages: [] } });
+    expect(wrapper.html()).toContain("is-loading");
+  });
+  it("should emit send when suggestion clicked", async () => {
+    const wrapper = mount(AiChat, {
+      props: { messages: [], suggestions: ["Write me code"] }
+    });
+    await wrapper.find(".yh-ai-chat__suggestions .yh-button").trigger("click");
+    expect(wrapper.emitted("send")).toBeTruthy();
+    expect(wrapper.emitted("send")[0][0]).toBe("Write me code");
+  });
+  it("should emit clear and update:messages on clear button click", async () => {
+    const wrapper = mount(AiChat, {
+      props: { messages: [makeMsg("1", "user", "hello")] }
+    });
+    await wrapper.find(".yh-ai-chat__header .yh-button").trigger("click");
+    expect(wrapper.emitted("clear")).toBeTruthy();
+    expect(wrapper.emitted("update:messages")).toBeTruthy();
+    expect(wrapper.emitted("update:messages")[0][0]).toEqual([]);
+  });
+  it("should render message content from messages prop", () => {
+    const wrapper = mount(AiChat, {
+      props: { messages: [makeMsg("1", "user", "test message content")] }
+    });
+    expect(wrapper.html()).toContain("test message content");
+  });
+  it("should render multiple messages", () => {
+    const messages = [makeMsg("1", "user", "Hello"), makeMsg("2", "assistant", "Hi there")];
+    const wrapper = mount(AiChat, { props: { messages } });
+    expect(wrapper.html()).toContain("Hello");
+    expect(wrapper.html()).toContain("Hi there");
+  });
+  it("should render header slot", () => {
+    const wrapper = mount(AiChat, {
+      props: { messages: [makeMsg("1", "user", "hi")] },
+      slots: { header: '<div class="custom-header">Custom Header</div>' }
+    });
+    expect(wrapper.find(".custom-header").exists()).toBe(true);
+  });
+  it("should render sender slot", () => {
+    const wrapper = mount(AiChat, {
+      slots: { sender: '<div class="custom-sender">Custom Sender</div>' }
+    });
+    expect(wrapper.find(".custom-sender").exists()).toBe(true);
+  });
+  it("should render custom message via message slot", () => {
+    const wrapper = mount(AiChat, {
+      props: { messages: [makeMsg("1", "user", "any")] },
+      slots: {
+        message: '<div class="custom-msg">Custom Message</div>'
+      }
+    });
+    expect(wrapper.find(".custom-msg").exists()).toBe(true);
+  });
+});

package/dist/ai-chat/index.cjs

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  YhAiChat: true
+};
+module.exports = exports.YhAiChat = void 0;
+var _utils = require("@yh-ui/utils");
+var _aiChat = _interopRequireDefault(require("./src/ai-chat.vue"));
+var _aiChat2 = require("./src/ai-chat.cjs");
+Object.keys(_aiChat2).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _aiChat2[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _aiChat2[key];
+    }
+  });
+});
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const YhAiChat = exports.YhAiChat = (0, _utils.withInstall)(_aiChat.default);
+module.exports = YhAiChat;

package/dist/ai-chat/index.d.ts

@@ -0,0 +1,3 @@
+export declare const YhAiChat: any;
+export default YhAiChat;
+export * from './src/ai-chat';

package/dist/ai-chat/index.mjs

@@ -0,0 +1,5 @@
+import { withInstall } from "@yh-ui/utils";
+import AiChat from "./src/ai-chat.vue";
+export const YhAiChat = withInstall(AiChat);
+export default YhAiChat;
+export * from "./src/ai-chat.mjs";

package/dist/ai-chat/src/ai-chat.cjs

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.aiChatProps = exports.aiChatEmits = void 0;
+const aiChatProps = exports.aiChatProps = {
+  /**
+   * @description 消息列表
+   */
+  messages: {
+    type: Array,
+    default: () => []
+  },
+  /**
+   * @description 是否全域加载中 (通常指整个对话框的加载态)
+   */
+  loading: {
+    type: Boolean,
+    default: false
+  },
+  /**
+   * @description 默认建议提示词
+   */
+  suggestions: {
+    type: Array,
+    default: () => []
+  },
+  /**
+   * @description 主题覆盖变量
+   */
+  themeOverrides: {
+    type: Object,
+    default: void 0
+  }
+};
+const aiChatEmits = exports.aiChatEmits = {
+  send: message => typeof message === "string",
+  "update:messages": messages => Array.isArray(messages),
+  clear: () => true
+};