@h-ai/ui 0.1.0-alpha.50 → 0.1.0-alpha.53

package/dist/components/scenes/ai/table/AiTableEditor.svelte

@@ -23,6 +23,7 @@
     AiTableEditorProps,
   } from './table-types.js'
   import { SvelteSet } from 'svelte/reactivity'
+  import { writeTextToClipboard } from '../../../../internal/browser-safety.js'
   import { uiM } from '../../../../messages.js'
   import { cn, getDataAttributes } from '../../../../utils.js'
   import AiDocumentDownloadMenu from '../AiDocumentDownloadMenu.svelte'
@@ -969,12 +970,9 @@
       return
     }
 
-    if (typeof navigator === 'undefined' || !navigator.clipboard) {
-      return
+    if (await writeTextToClipboard(text)) {
+      triggerCopiedFeedback()
     }
-
-    await navigator.clipboard.writeText(text)
-    triggerCopiedFeedback()
   }
 
   async function handleDownloadTable(): Promise<void> {

package/dist/internal/browser-safety.d.ts

@@ -4,6 +4,17 @@
  * 统一封装容易在受限 WebView、隐私模式或不安全上下文中失败的浏览器 API，
  * 让组件在能力缺失时优雅降级而不是抛出运行时错误。
  */
+/** 宿主页面剪贴板写入器（跨域 iframe 场景由嵌入方注入）。 */
+export type ClipboardHostWriter = (text: string) => Promise<boolean>;
+/**
+ * 注册宿主页面剪贴板写入器。
+ *
+ * 当 iframe 内 Clipboard API 与 execCommand 都不可用时，把文本交给宿主页面写入。
+ * 宿主页面是顶层文档，始终聚焦且持有完整剪贴板权限，是跨域 iframe 场景的最终兜底。
+ *
+ * @param writer - 宿主写入器；传入 null 注销
+ */
+export declare function registerClipboardHostWriter(writer: ClipboardHostWriter | null): void;
 /**
  * 安全读取 localStorage。
  *
@@ -21,7 +32,8 @@ export declare function writeStoredValue(key: string, value: string): boolean;
  * 安全写入剪贴板。
  *
  * 优先使用现代 Clipboard API；在不安全上下文（HTTP）、旧 WebView
- * 或浏览器策略禁用时回退到 `document.execCommand('copy')`，
+ * 或浏览器策略禁用时回退到 `document.execCommand('copy')`；
+ * 跨域 iframe 中上述两种方式都可能被权限/聚焦策略拒绝时，再回退到宿主页面写入器，
  * 确保尽可能多的环境下复制操作可用。
  */
 export declare function writeTextToClipboard(text: string): Promise<boolean>;

package/dist/internal/browser-safety.js

@@ -4,6 +4,18 @@
  * 统一封装容易在受限 WebView、隐私模式或不安全上下文中失败的浏览器 API，
  * 让组件在能力缺失时优雅降级而不是抛出运行时错误。
  */
+let clipboardHostWriter = null;
+/**
+ * 注册宿主页面剪贴板写入器。
+ *
+ * 当 iframe 内 Clipboard API 与 execCommand 都不可用时，把文本交给宿主页面写入。
+ * 宿主页面是顶层文档，始终聚焦且持有完整剪贴板权限，是跨域 iframe 场景的最终兜底。
+ *
+ * @param writer - 宿主写入器；传入 null 注销
+ */
+export function registerClipboardHostWriter(writer) {
+    clipboardHostWriter = writer;
+}
 /**
  * 安全读取 localStorage。
  *
@@ -42,15 +54,13 @@ export function writeStoredValue(key, value) {
  * 安全写入剪贴板。
  *
  * 优先使用现代 Clipboard API；在不安全上下文（HTTP）、旧 WebView
- * 或浏览器策略禁用时回退到 `document.execCommand('copy')`，
+ * 或浏览器策略禁用时回退到 `document.execCommand('copy')`；
+ * 跨域 iframe 中上述两种方式都可能被权限/聚焦策略拒绝时，再回退到宿主页面写入器，
  * 确保尽可能多的环境下复制操作可用。
  */
 export async function writeTextToClipboard(text) {
-    if (typeof navigator === 'undefined') {
-        return false;
-    }
     // 现代 Clipboard API（仅安全上下文可用）
-    if (navigator.clipboard?.writeText) {
+    if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
         try {
             await navigator.clipboard.writeText(text);
             return true;
@@ -60,20 +70,31 @@ export async function writeTextToClipboard(text) {
         }
     }
     // fallback：textarea + execCommand（兼容 HTTP、旧浏览器）
-    if (typeof document === 'undefined') {
-        return false;
-    }
-    try {
-        const textarea = document.createElement('textarea');
-        textarea.value = text;
-        textarea.style.cssText = 'position:fixed;left:-9999px;top:-9999px;opacity:0';
-        document.body.appendChild(textarea);
-        textarea.select();
-        const ok = document.execCommand('copy');
-        document.body.removeChild(textarea);
-        return ok;
+    if (typeof document !== 'undefined') {
+        try {
+            const textarea = document.createElement('textarea');
+            textarea.value = text;
+            textarea.style.cssText = 'position:fixed;left:-9999px;top:-9999px;opacity:0';
+            document.body.appendChild(textarea);
+            textarea.select();
+            const ok = document.execCommand('copy');
+            document.body.removeChild(textarea);
+            if (ok) {
+                return true;
+            }
+        }
+        catch {
+            // 继续尝试宿主写入器
+        }
     }
-    catch {
-        return false;
+    // 最终兜底：跨域 iframe 场景由宿主页面写入
+    if (clipboardHostWriter) {
+        try {
+            return await clipboardHostWriter(text);
+        }
+        catch {
+            return false;
+        }
     }
+    return false;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@h-ai/ui",
   "type": "module",
-  "version": "0.1.0-alpha.50",
+  "version": "0.1.0-alpha.53",
   "description": "Hai Framework UI component library for Svelte 5 Runes.",
   "license": "Apache-2.0",
   "svelte": "./dist/index.js",
@@ -52,7 +52,7 @@
     "mermaid": "^11.12.0",
     "shiki": "^4.0.2",
     "tailwind-merge": "^3.5.0",
-    "@h-ai/core": "0.1.0-alpha.50"
+    "@h-ai/core": "0.1.0-alpha.53"
   },
   "devDependencies": {
     "@sveltejs/package": "^2.5.7",