@h-ai/ui 0.1.0-alpha.18 → 0.1.0-alpha.20

package/dist/internal/browser-safety.js

@@ -0,0 +1,58 @@
+/**
+ * @h-ai/ui — 浏览器能力安全辅助
+ *
+ * 统一封装容易在受限 WebView、隐私模式或不安全上下文中失败的浏览器 API，
+ * 让组件在能力缺失时优雅降级而不是抛出运行时错误。
+ */
+/**
+ * 安全读取 localStorage。
+ *
+ * 某些浏览器隐私模式或嵌入式 WebView 会在访问 localStorage 时直接抛出 SecurityError，
+ * 这里统一吞掉异常并回退为 null。
+ */
+export function readStoredValue(key) {
+    if (typeof localStorage === 'undefined') {
+        return null;
+    }
+    try {
+        return localStorage.getItem(key);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 安全写入 localStorage。
+ *
+ * 返回值显式告诉调用方持久化是否成功，方便调用方在失败时继续使用内存态而不必中断交互。
+ */
+export function writeStoredValue(key, value) {
+    if (typeof localStorage === 'undefined') {
+        return false;
+    }
+    try {
+        localStorage.setItem(key, value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 安全写入剪贴板。
+ *
+ * 在不安全上下文、旧 WebView 或浏览器策略禁用时直接返回 false，
+ * 让上层决定是否展示成功反馈。
+ */
+export async function writeTextToClipboard(text) {
+    if (typeof navigator === 'undefined' || !navigator.clipboard?.writeText) {
+        return false;
+    }
+    try {
+        await navigator.clipboard.writeText(text);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/theme-config.d.ts

@@ -81,9 +81,10 @@ export declare const DEFAULT_THEME = "light";
  */
 export declare const THEME_STORAGE_KEY = "theme";
 /**
- * 获取主题初始化脚本（用于 app.html 防闪烁）
+ * 获取主题初始化脚本（用于 HTML shell 防闪烁）
  *
- * 使用方式：在 app.html 的 <head> 中添加 <script>{getThemeInitScript()}</script>
+ * 返回值是“脚本标签内的文本内容”，适合宿主在构建阶段或服务端模板中注入。
+ * 对于 SvelteKit `app.html`，请直接粘贴这段脚本字符串的内容，不能写 `{@html getThemeInitScript()}`。
  */
 export declare function getThemeInitScript(): string;
 /**

package/dist/theme-config.js

@@ -4,6 +4,7 @@
  * DaisyUI 主题元数据和配置
  * @module theme-config
  */
+import { readStoredValue, writeStoredValue } from './internal/browser-safety.js';
 /**
  * DaisyUI 内置主题配置（精选）
  */
@@ -83,12 +84,13 @@ export const DEFAULT_THEME = 'light';
  */
 export const THEME_STORAGE_KEY = 'theme';
 /**
- * 获取主题初始化脚本（用于 app.html 防闪烁）
+ * 获取主题初始化脚本（用于 HTML shell 防闪烁）
  *
- * 使用方式：在 app.html 的 <head> 中添加 <script>{getThemeInitScript()}</script>
+ * 返回值是“脚本标签内的文本内容”，适合宿主在构建阶段或服务端模板中注入。
+ * 对于 SvelteKit `app.html`，请直接粘贴这段脚本字符串的内容，不能写 `{@html getThemeInitScript()}`。
  */
 export function getThemeInitScript() {
-    return `(function(){var t=localStorage.getItem('${THEME_STORAGE_KEY}')||'${DEFAULT_THEME}';document.documentElement.setAttribute('data-theme',t)})()`;
+    return `(function(){var t='${DEFAULT_THEME}';try{var s=localStorage.getItem('${THEME_STORAGE_KEY}');if(s)t=s}catch{}document.documentElement.setAttribute('data-theme',t)})()`;
 }
 /**
  * 应用主题
@@ -99,8 +101,8 @@ export function applyTheme(theme, persist = true) {
     if (typeof document === 'undefined')
         return;
     document.documentElement.setAttribute('data-theme', theme);
-    if (persist && typeof localStorage !== 'undefined') {
-        localStorage.setItem(THEME_STORAGE_KEY, theme);
+    if (persist) {
+        writeStoredValue(THEME_STORAGE_KEY, theme);
     }
 }
 /**
@@ -115,9 +117,7 @@ export function getCurrentTheme() {
  * 获取保存的主题（从 localStorage）
  */
 export function getSavedTheme() {
-    if (typeof localStorage === 'undefined')
-        return DEFAULT_THEME;
-    return localStorage.getItem(THEME_STORAGE_KEY) ?? DEFAULT_THEME;
+    return readStoredValue(THEME_STORAGE_KEY) ?? DEFAULT_THEME;
 }
 /**
  * DaisyUI 主题配置字符串（用于 app.css）

package/dist/types.d.ts

@@ -908,7 +908,7 @@ export interface StepsProps {
  * 图标按钮属性
  */
 export interface IconButtonProps {
-    /** 图标（HTML/SVG 字符串或 Snippet） */
+    /** 图标（受信任的内联 SVG 字符串或 Snippet） */
     icon?: string | Snippet;
     /** 标签（无障碍） */
     label?: string;

package/package.json

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