hiwork-core 0.0.2 → 0.0.3

package/README.md

@@ -103,6 +103,9 @@ ctx.inject(['hiworkFeatureCenter'], (scope) => {
   其余项按 order 排序。`icon` 是内联 SVG 字符串；缺省用兜底图标，保证侧栏折叠成
   56px 图标栏时每个入口仍有可辨识图形（折叠态由宿主加在侧栏根上的 `*_collapsed`
   类驱动纯 CSS：隐藏文字、图标放大到 18px，与原生控件同形）。
+  折叠态悬停 500ms 弹出提示气泡，黑底白字、圆角与字号逐项对齐框架 `ui-primitives`
+  的 `Tooltip`（`--dsw-alias-tooltip-bg`），取代浏览器自带的浅色 `title` 提示；
+  展开态文字已可见，与原生控件一致（`Tooltip disabled={wide}`）不出气泡。
   找不到原生按钮时不抛错、不隐藏任何入口，菜单只列 feature（安全降级）。
 - **中央区 takeover**：挂一个 `[data-hiwork-feature-root]` React root，用
   `html[data-hiwork-active-page]` 上的纯 CSS 规则隐藏原生会话子树（保持挂载、保留状态）；

package/lib/client.js

@@ -2352,6 +2352,8 @@ var MENU_ATTRIBUTE = "data-hiwork-feature-menu";
 var MENU_ITEM_ATTRIBUTE = "data-hiwork-feature-menu-item";
 var MENU_ICON_ATTRIBUTE = "data-hiwork-feature-menu-icon";
 var MENU_LABEL_ATTRIBUTE = "data-hiwork-feature-menu-label";
+var TOOLTIP_ATTRIBUTE = "data-hiwork-feature-tooltip";
+var TOOLTIP_VISIBLE_ATTRIBUTE = "data-hiwork-feature-tooltip-visible";
 var NATIVE_HIDDEN_ATTRIBUTE = "data-hiwork-native-new-session";
 var FEATURE_ROOT_ATTRIBUTE = "data-hiwork-feature-root";
 var OWNER_ATTRIBUTE = "data-hiwork-owner";
@@ -2359,6 +2361,8 @@ var ACTIVE_PAGE_ATTRIBUTE = "data-hiwork-active-page";
 var NATIVE_MENU_ITEM_ID = "__native_new_session__";
 var DEFAULT_NEW_SESSION_LABEL = "\u65B0\u4F1A\u8BDD";
 var STYLE_ELEMENT_ID = "hiwork-feature-center-styles";
+var TOOLTIP_DELAY_MS = 500;
+var TOOLTIP_GAP_PX = 8;
 var DEFAULT_NEW_SESSION_ICON = '<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true"><path d="M8 3.4v9.2M3.4 8h9.2" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/></svg>';
 var DEFAULT_FEATURE_ICON = '<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true"><rect x="2.75" y="2.75" width="10.5" height="10.5" rx="3" stroke="currentColor" stroke-width="1.5"/><circle cx="8" cy="8" r="1.4" fill="currentColor"/></svg>';
 var SESSION_ROW_SELECTOR = [
@@ -2382,6 +2386,12 @@ var featureCenterCss = [
   `[class*="sidebarCol"] [class*="collapsed"] [${MENU_LABEL_ATTRIBUTE}] { display: none; }`,
   `[class*="sidebarCol"] [class*="collapsed"] [${MENU_ITEM_ATTRIBUTE}] { justify-content: center; padding: 8px 0; }`,
   `[class*="sidebarCol"] [class*="collapsed"] [${MENU_ICON_ATTRIBUTE}], [class*="sidebarCol"] [class*="collapsed"] [${MENU_ICON_ATTRIBUTE}] > svg { width: 18px; height: 18px; }`,
+  // 折叠态提示气泡：几何与配色逐项对齐框架 `ui-primitives` 的 `Tooltip.module.css`
+  // （黑底白字、3px 7px 内边距、8px 圆角、13/20 字号、150ms 淡入、最大半屏宽）。
+  `[${TOOLTIP_ATTRIBUTE}] { position: fixed; z-index: 100; display: none; width: max-content; max-width: 50vw; padding: 3px 7px; border-radius: 8px; background: var(--dsw-alias-tooltip-bg, #2c2c2e); color: var(--dsw-static-neutral-bluish-00, #fff); font-size: 13px; line-height: 20px; white-space: pre-line; overflow-wrap: break-word; pointer-events: none; transform: translateY(-50%); }`,
+  `[${TOOLTIP_ATTRIBUTE}][${TOOLTIP_VISIBLE_ATTRIBUTE}="true"] { display: block; animation: hiwork-feature-tooltip-in 150ms var(--ds-ease-in-out, ease); }`,
+  `@keyframes hiwork-feature-tooltip-in { from { opacity: 0; } }`,
+  `@media (prefers-reduced-motion: reduce) { [${TOOLTIP_ATTRIBUTE}][${TOOLTIP_VISIBLE_ATTRIBUTE}="true"] { animation: none; } }`,
   // 与原生会话根同一背景（`background: var(--dsw-alias-bg-base)`）；不显式上色的话
   // takeover 区会透出框架灰底，和侧栏同色而不是原生页面的白色/深色。
   `[${FEATURE_ROOT_ATTRIBUTE}] { display: flex; flex-direction: column; flex: 1; min-width: 0; min-height: 0; overflow: hidden; background: var(--dsw-alias-bg-base, #fff); }`,
@@ -2418,6 +2428,12 @@ function nativeNewSessionButton(root) {
 function conversationContainer() {
   return document.querySelector(CONVERSATION_SELECTOR) ?? void 0;
 }
+function isCollapsedRail(item) {
+  const host = item.closest('[class*="collapsed"]');
+  if (host === null) return false;
+  const column = item.closest(SIDEBAR_SELECTOR);
+  return column === null || column.contains(host);
+}
 function mountFeatureCenter(options) {
   const { registry } = options;
   const interval = options.retryIntervalMs ?? 200;
@@ -2428,7 +2444,7 @@ function mountFeatureCenter(options) {
     return { dispose: () => void 0, openNativeHome: () => void 0 };
   }
   const isActiveOwner = () => activeOwner === owner;
-  for (const stale of Array.from(document.querySelectorAll(`[${MENU_ATTRIBUTE}], [${FEATURE_ROOT_ATTRIBUTE}], #${STYLE_ELEMENT_ID}`))) {
+  for (const stale of Array.from(document.querySelectorAll(`[${MENU_ATTRIBUTE}], [${FEATURE_ROOT_ATTRIBUTE}], [${TOOLTIP_ATTRIBUTE}], #${STYLE_ELEMENT_ID}`))) {
     stale.remove();
   }
   for (const hidden of Array.from(document.querySelectorAll(`[${NATIVE_HIDDEN_ATTRIBUTE}]`))) {
@@ -2449,6 +2465,58 @@ function mountFeatureCenter(options) {
   let retryTimer;
   let retries = 0;
   let disposed = false;
+  let tooltipElement;
+  let tooltipTimer;
+  let tooltipItem;
+  const hideTooltip = () => {
+    if (tooltipTimer !== void 0) {
+      clearTimeout(tooltipTimer);
+      tooltipTimer = void 0;
+    }
+    tooltipItem = void 0;
+    tooltipElement?.removeAttribute(TOOLTIP_VISIBLE_ATTRIBUTE);
+  };
+  const ensureTooltip = () => {
+    let element = tooltipElement;
+    if (element === void 0) {
+      element = document.createElement("div");
+      element.setAttribute(TOOLTIP_ATTRIBUTE, "");
+      element.setAttribute(OWNER_ATTRIBUTE, owner);
+      element.setAttribute("role", "tooltip");
+      document.body.appendChild(element);
+      tooltipElement = element;
+    }
+    return element;
+  };
+  const placeTooltip = (item, element) => {
+    const rect = item.getBoundingClientRect();
+    const width = element.offsetWidth;
+    const overflowRight = rect.right + TOOLTIP_GAP_PX + width > window.innerWidth;
+    const left = overflowRight ? rect.left - TOOLTIP_GAP_PX - width : rect.right + TOOLTIP_GAP_PX;
+    element.style.left = `${Math.max(0, left)}px`;
+    element.style.top = `${rect.top + rect.height / 2}px`;
+  };
+  const showTooltip = (item, label) => {
+    const element = ensureTooltip();
+    element.textContent = label;
+    element.setAttribute(TOOLTIP_VISIBLE_ATTRIBUTE, "true");
+    tooltipItem = item;
+    placeTooltip(item, element);
+  };
+  const bindTooltip = (item, label) => {
+    item.addEventListener("pointerenter", () => {
+      hideTooltip();
+      tooltipTimer = setTimeout(() => {
+        tooltipTimer = void 0;
+        if (disposed || !item.isConnected || !isCollapsedRail(item)) return;
+        showTooltip(item, label);
+      }, TOOLTIP_DELAY_MS);
+    });
+    item.addEventListener("pointerleave", () => {
+      if (tooltipItem === item || tooltipTimer !== void 0) hideTooltip();
+    });
+  };
+  document.addEventListener("scroll", hideTooltip, true);
   const clearTakeover = () => {
     const reactRoot = root;
     root = void 0;
@@ -2494,6 +2562,7 @@ function mountFeatureCenter(options) {
     if (!(target instanceof Element)) return;
     const item = target.closest(`[${MENU_ITEM_ATTRIBUTE}]`);
     if (item === null || !(menuElement?.contains(item) ?? false)) return;
+    hideTooltip();
     const id = item.getAttribute(MENU_ITEM_ATTRIBUTE);
     if (id === null) return;
     if (id === NATIVE_MENU_ITEM_ID) {
@@ -2507,7 +2576,8 @@ function mountFeatureCenter(options) {
     item.type = "button";
     item.setAttribute(MENU_ITEM_ATTRIBUTE, id);
     if (active) item.setAttribute("data-hiwork-feature-active", "true");
-    item.title = label;
+    item.setAttribute("aria-label", label);
+    bindTooltip(item, label);
     const iconSpan = document.createElement("span");
     iconSpan.setAttribute(MENU_ICON_ATTRIBUTE, "");
     iconSpan.innerHTML = icon;
@@ -2538,6 +2608,7 @@ function mountFeatureCenter(options) {
     ].join("|");
     if (signature === menuSignature) return;
     menuSignature = signature;
+    hideTooltip();
     const items = [];
     if (native !== void 0) items.push(createMenuItem(NATIVE_MENU_ITEM_ID, newSessionLabel, nativeIcon(native), false));
     for (const item of features) {
@@ -2675,6 +2746,11 @@ function mountFeatureCenter(options) {
       unsubscribeRegistry();
       unsubscribeLocale?.();
       document.removeEventListener("click", onDocumentClickCapture, true);
+      document.removeEventListener("scroll", hideTooltip, true);
+      hideTooltip();
+      const tooltip = tooltipElement;
+      tooltipElement = void 0;
+      if (tooltip !== void 0 && tooltip.getAttribute(OWNER_ATTRIBUTE) === owner) tooltip.remove();
       clearTakeover();
       const element = menuElement;
       menuElement = void 0;

package/lib/index.js

@@ -3137,7 +3137,7 @@ function isUnloading(ctx) {
 }
 
 // src/version.ts
-var PKG_VERSION = false ? "dev" : "0.0.2";
+var PKG_VERSION = false ? "dev" : "0.0.3";
 
 // src/ai-router-client.ts
 var GatewayError = class extends Error {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hiwork-core",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "description": "HiWork 企业统一登录与模型自动供给插件（ai-router 网关登录，Web 表单，无 CLI 认证）",
   "license": "UNLICENSED",