@celestia-island/hikari 0.55.120 → 0.55.121

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celestia-island/hikari",
-  "version": "0.55.120",
+  "version": "0.55.121",
   "private": false,
   "type": "module",
   "description": "Hikari Vue 3 component library — production-grade UI components based on shittim-chest design system",

package/src/components/HkCopyBadge.tsx

@@ -1,7 +1,7 @@
 import { computed, defineComponent, ref, type PropType } from "vue";
 
 import HBadge, { type BadgeVariant } from "./HkBadge";
-import HTooltip from "./HkTooltip";
+import HTooltip, { type HkTooltipSlotProps } from "./HkTooltip";
 import { useI18n } from "../i18n/context";
 import { useClipboardWithToast } from "../runtime/useClipboard";
 import { useToast } from "../runtime/useToast";
@@ -140,7 +140,7 @@ export default defineComponent({
       if (props.disabled) return buildBadge();
       return (
         <HTooltip text={tooltipText.value}>
-          {(tip: { popupId: string; visible: boolean }) =>
+          {(tip?: HkTooltipSlotProps) =>
             buildBadge(tip?.visible ? tip.popupId : undefined)}
         </HTooltip>
       );

package/src/components/HkTooltip.test.tsx

@@ -1,7 +1,7 @@
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { createApp, h, nextTick } from "vue";
 
-import HkTooltip from "./HkTooltip";
+import HkTooltip, { type HkTooltipSlotProps } from "./HkTooltip";
 import { POPUP_Z_BANDS, POPUP_Z_STEP, usePopupManager } from "../runtime/usePopupManager";
 
 /**
@@ -176,18 +176,19 @@ describe("HkTooltip show/hide", () => {
   it("hands { popupId, visible } to the default slot for focus-target wiring", async () => {
     const container = document.createElement("div");
     document.body.appendChild(container);
-    let seen: { popupId?: string; visible?: boolean } = {};
+    let seen: Partial<HkTooltipSlotProps> = {};
     const app = createApp({
       render: () =>
         h(
           HkTooltip,
-          { text: "slot props", delay: 0 } as never,
-          // The scoped-slot child needs a cast: HkTooltip does not declare
-          // slot prop types, so h() types the default slot as no-arg.
-          ((slotProps: { popupId: string; visible: boolean }) => {
+          { text: "slot props", delay: 0 },
+          // Object-form scoped slot; the arg type comes from the local
+          // annotation against the exported contract (h()'s RawSlots has
+          // no SlotsType-aware overload), not from the slots declaration.
+          { default: (slotProps: HkTooltipSlotProps) => {
             seen = slotProps;
             return h("span", { class: "anchor-probe" }, "anchor");
-          }) as never,
+          } },
         ),
     });
     app.mount(container);

package/src/components/HkTooltip.tsx

@@ -1,8 +1,20 @@
-import { computed, defineComponent, onBeforeUnmount, ref, Teleport, type CSSProperties, type PropType } from "vue";
+import { computed, defineComponent, onBeforeUnmount, ref, Teleport, type CSSProperties, type PropType, type SlotsType } from "vue";
 import { usePopupManager, type PopupHandle } from "../runtime/usePopupManager";
 import { applyTooltipPosition, type TooltipPlacement } from "../runtime/tooltipPosition";
 import "./HkTooltip.scss";
 
+/**
+ * The default-slot payload, handed to every render of the trigger. An
+ * interactive trigger should bind `popupId` onto itself via
+ * aria-describedby while `visible` is true — the focus target is the
+ * trigger element, not this component's wrapper (HkCopyBadge is the
+ * reference consumer).
+ */
+export interface HkTooltipSlotProps {
+  popupId: string;
+  visible: boolean;
+}
+
 let popupSeq = 0;
 
 export default defineComponent({
@@ -13,6 +25,9 @@ export default defineComponent({
     delay: { type: Number, default: 300 },
     maxWidth: { type: String, default: undefined },
   },
+  slots: Object as SlotsType<{
+    default?: (props: HkTooltipSlotProps) => unknown;
+  }>,
   setup(props, { slots }) {
     const visible = ref(false);
     // Stable id for the aria-describedby link from the trigger wrapper to

package/src/index.ts

@@ -752,6 +752,7 @@ export { default as HkFileBrowserDialog } from "./components/HkFileBrowserDialog
 export { default as HkFilePickerField } from "./components/HkFilePickerField";
 export { default as HkToast } from "./components/HkToast";
 export { default as HkTooltip } from "./components/HkTooltip";
+export { type HkTooltipSlotProps } from "./components/HkTooltip";
 export { default as HkTree } from "./components/HkTree";
 export { default as HkWindowedItem } from "./components/HkWindowedItem";
 export { default as HkWaterfall } from "./components/HkWaterfall";