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

package/dist/components/scenes/crud/crud-controller.svelte.js

@@ -0,0 +1,265 @@
+/**
+ * @h-ai/ui — CRUD 控制器（SPA 数据 + 导航托管）
+ *
+ * 为 `CrudPage` 提供两个框架级适配器，业务应用无需在各自项目里重复实现：
+ *   1. `defineCrud`：由声明式资源定义生成 `CrudPage` 所需的 `crud` 对象（字段筛选、列映射、默认值），
+ *      不依赖 `@h-ai/kit`，纯 SPA / Tauri / Capacitor 均可直接使用。
+ *   2. `createCrudController`：在纯客户端（无 SvelteKit SSR）下托管 `CrudPage` 的 `data` 与 `nav`，
+ *      把 `CrudPage` 通过 URL query 同步的搜索/过滤/分页参数解析回本地状态并重新拉取列表。
+ *
+ * 控制器特性：latest-wins（seq + AbortSignal 双保险）、失败保留旧数据、惰性加载、并发去重、
+ * 查询串回填地址栏（保留 pathname 与 hash，不整页跳转）。
+ *
+ * @module crud-controller
+ */
+import { SvelteURLSearchParams } from 'svelte/reactivity';
+/**
+ * 解析可能是 i18n 函数的文本。
+ */
+function resolveText(text) {
+    return typeof text === 'function' ? text() : text;
+}
+/**
+ * 映射分页结果的 `items`，保留 total / page / pageSize。
+ *
+ * @description 标准 `PaginatedResult<T>` 适配器：业务页面只需转换条目本身，
+ *   无需重复搬运分页元数据，配合 `CrudApi.list` 消除 page/pageSize/total 样板。
+ *
+ * @param result - 后端返回的分页结果。
+ * @param map - 单条映射函数。
+ * @returns 条目被映射、分页元数据不变的新分页结果。
+ *
+ * @example
+ * list: async (params) => mapPaginated(await api.listUsers(params), toRow)
+ */
+export function mapPaginated(result, map) {
+    return {
+        items: result.items.map(map),
+        total: result.total,
+        page: result.page,
+        pageSize: result.pageSize,
+    };
+}
+/**
+ * 由声明式资源定义生成 `CrudPage` 所需的 `crud` 对象。
+ *
+ * @description 仅做字段筛选、列映射与默认值收集，不依赖 `@h-ai/kit`，可在纯 SPA 直接使用。
+ *
+ * @param resource - 资源定义（字段、标签、API）。
+ * @returns `CrudPage` 可直接消费的 `crud` 对象。
+ *
+ * @example
+ * const userCrud = defineCrud<User>({
+ *   name: 'user',
+ *   label: () => m.users_title(),
+ *   fields: [{ id: 'name', label: () => m.user_name(), type: 'text', filterable: true }],
+ *   api: { list: params => listUsers(params) },
+ * })
+ */
+export function defineCrud(resource) {
+    const fields = [...resource.fields].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+    return {
+        resource,
+        getListFields: () => fields.filter(f => f.inList !== false),
+        getFilterFields: () => fields.filter(f => f.filterable === true),
+        // readonly 仅表示“编辑态禁用”（由 CrudEditPanel 在 edit 模式 disable），新建仍可填写；
+        // 因此创建表单只按 inCreate 过滤，不排除 readonly 字段。
+        getCreateFields: () => fields.filter(f => f.inCreate !== false),
+        getEditFields: () => fields.filter(f => f.inEdit !== false),
+        getDetailFields: () => fields.filter(f => f.inDetail !== false),
+        toTableColumns: () => fields
+            .filter(f => f.inList !== false)
+            .map(f => ({
+            key: f.id,
+            label: resolveText(f.label),
+            width: f.width,
+            align: f.align,
+            render: f.render ? (item) => f.render(item[f.id], item) : undefined,
+        })),
+        getDefaultValues: () => Object.fromEntries(fields.filter(f => f.defaultValue !== undefined).map(f => [f.id, f.defaultValue])),
+        api: resource.api,
+    };
+}
+/**
+ * 在纯客户端（无 SvelteKit SSR）下为 `CrudPage` 创建数据 + 导航控制器。
+ *
+ * @description `CrudPage` 通过 `nav.navigate(url)` 把搜索/过滤/分页写进 URL query，再调用 `nav.refresh()`
+ *   触发列表刷新。本控制器把 query 解析回参数、调用 `crud.api.list` 更新本地 `data`，并把查询串回填地址栏，
+ *   不触发整页跳转（避免刷新与登录态丢失）。连续请求只允许最新一轮更新状态（seq + AbortSignal 双保险），
+ *   失败时保留已有数据并暴露错误供页面重试。
+ *
+ * @param crud - `defineCrud` 的返回值。
+ * @param options - 加载策略；默认立即加载、失败保留旧数据、回填地址栏。
+ * @returns 含响应式 `data`、`nav` 适配器与 `load` / `reload` 的控制器。
+ *
+ * @example
+ * const controller = createCrudController(userCrud)
+ * // <CrudPage crud={userCrud} data={controller.data} nav={controller.nav}
+ * //   loading={controller.loading} loaded={controller.loaded}
+ * //   error={controller.error} onRetry={controller.reload} />
+ */
+export function createCrudController(crud, options = {}) {
+    const defaultPageSize = crud.resource.defaultPageSize ?? 10;
+    const keepPreviousData = options.keepPreviousData !== false;
+    const syncUrl = options.syncUrl !== false;
+    const filterIds = crud.getFilterFields().map(f => f.id);
+    const data = $state({
+        items: [],
+        total: 0,
+        page: 1,
+        pageSize: defaultPageSize,
+        filters: {},
+    });
+    // 最近一次解析出的查询参数（供 refresh 使用）。
+    let pending = { search: '', page: 1, pageSize: defaultPageSize };
+    // 单调递增请求号；只有最新一轮请求可写回状态（latest-wins）。
+    let listRequestSeq = 0;
+    // 最新一轮请求的取消控制器；新请求发起前 abort 上一轮。
+    let abortController;
+    // 并发去重：同参数请求在途时复用同一 Promise。
+    let inFlightKey;
+    let inFlightPromise;
+    let loading = $state(false);
+    let loaded = $state(false);
+    let error = $state(undefined);
+    /** 生成参数的稳定 key（用于并发去重）。 */
+    function paramsKey(params) {
+        return JSON.stringify(Object.entries(params).sort(([a], [b]) => a.localeCompare(b)));
+    }
+    /** 把成功响应写回响应式 data，并回填 filters 供筛选栏回显。 */
+    function applyResult(result, params) {
+        data.items = result.items;
+        data.total = result.total;
+        data.page = result.page;
+        data.pageSize = result.pageSize;
+        const filters = { search: params.search ?? '' };
+        for (const id of filterIds) {
+            if (params[id] !== undefined)
+                filters[id] = params[id];
+        }
+        data.filters = filters;
+    }
+    /**
+     * 按参数拉取列表并写回响应式 data。
+     *
+     * @description 暴露查询中、已成功加载和错误三种状态；连续请求只允许最新响应更新状态与数据，
+     *   旧请求被 abort 且其结果被丢弃；失败时按 keepPreviousData 决定是否保留旧列表。
+     *
+     * @param params - 搜索、过滤与分页参数。
+     * @returns 最新请求结算后完成；错误被保存在控制器中，避免未处理 Promise 拒绝。
+     */
+    function fetchList(params) {
+        const key = paramsKey(params);
+        // 并发去重：同参数请求在途时直接复用，避免重复打后端。
+        if (inFlightPromise && inFlightKey === key)
+            return inFlightPromise;
+        const requestSeq = ++listRequestSeq;
+        // 取消上一轮在途请求，实现 latest-wins 的第一重保险。
+        abortController?.abort();
+        const ac = new AbortController();
+        abortController = ac;
+        loading = true;
+        error = undefined;
+        // 不保留旧数据时立即清空，展示查询中占位；保留时维持旧列表避免闪烁。
+        if (!keepPreviousData) {
+            data.items = [];
+            data.total = 0;
+        }
+        inFlightKey = key;
+        const promise = (async () => {
+            try {
+                const result = await crud.api.list(params, { signal: ac.signal });
+                // 旧请求晚返回：seq 已被新请求覆盖时丢弃，绝不污染用户当前看到的结果。
+                if (requestSeq !== listRequestSeq)
+                    return;
+                applyResult(result, params);
+                loaded = true;
+            }
+            catch (cause) {
+                // 被新请求取代而 abort 的旧请求：静默丢弃，不写错误。
+                if (ac.signal.aborted || (cause instanceof Error && cause.name === 'AbortError'))
+                    return;
+                // 列表加载失败（慢响应/重启/超时）时保留上一次结果，绝不用空列表覆盖，避免误显示“0 条记录”；
+                // 同时暴露错误给页面：首次失败不能被当成一次成功的空结果。
+                if (requestSeq === listRequestSeq)
+                    error = cause instanceof Error ? cause : new Error(String(cause));
+            }
+            finally {
+                if (requestSeq === listRequestSeq) {
+                    loading = false;
+                    inFlightPromise = undefined;
+                    inFlightKey = undefined;
+                    abortController = undefined;
+                }
+            }
+        })();
+        inFlightPromise = promise;
+        return promise;
+    }
+    /** 从 CrudPage 生成的 URL 中解析查询参数。 */
+    function parseParams(url) {
+        const qs = url.includes('?') ? url.slice(url.indexOf('?') + 1) : '';
+        const sp = new SvelteURLSearchParams(qs);
+        const params = {
+            search: sp.get('search') ?? '',
+            page: sp.get('page') ? Number(sp.get('page')) : 1,
+            pageSize: sp.get('pageSize') ? Number(sp.get('pageSize')) : defaultPageSize,
+        };
+        for (const key of ['sortBy', 'sortDirection']) {
+            const v = sp.get(key);
+            if (v !== null && v !== '')
+                params[key] = v;
+        }
+        for (const id of filterIds) {
+            const v = sp.get(id);
+            if (v !== null && v !== '')
+                params[id] = v;
+        }
+        return params;
+    }
+    /** 把查询串回填地址栏，保留 pathname 与 hash，不触发跳转；SSR / 无 history 环境静默跳过。 */
+    function writeUrl(url) {
+        if (!syncUrl)
+            return;
+        const his = globalThis.history;
+        const loc = globalThis.location;
+        if (!his?.replaceState || !loc)
+            return;
+        const qs = url.includes('?') ? url.slice(url.indexOf('?')) : '';
+        try {
+            his.replaceState(his.state, '', `${loc.pathname}${qs}${loc.hash}`);
+        }
+        catch {
+            // 隐私模式 / 跨域等限制下忽略，不影响数据加载。
+        }
+    }
+    const nav = {
+        pathname: '',
+        navigate: (url) => {
+            // 仅解析参数并回填地址栏，不做真实跳转。
+            pending = parseParams(url);
+            writeUrl(url);
+        },
+        refresh: () => fetchList(pending),
+    };
+    // 默认立即加载；惰性页签显式关闭，避免挂载时抢占后端资源，在首次激活时调用 load()。
+    if (options.autoLoad !== false)
+        void fetchList(pending);
+    return {
+        get data() {
+            return data;
+        },
+        nav,
+        load: () => fetchList(pending),
+        reload: () => fetchList(pending),
+        get loading() {
+            return loading;
+        },
+        get loaded() {
+            return loaded;
+        },
+        get error() {
+            return error;
+        },
+    };
+}

package/dist/components/scenes/crud/index.d.ts

@@ -1,9 +1,13 @@
 /**
  * @h-ai/ui — CRUD 场景组件
  *
- * 提供声明式 CRUD 页面组件，基于 kit.crud.define() 定义自动渲染列表、搜索过滤、分页、详情/编辑面板和删除确认。
+ * 提供声明式 CRUD 页面组件与框架级控制器：
+ * - `CrudPage` 组件：自动渲染列表、搜索过滤、分页、详情/编辑面板、删除确认，以及查询中/失败/空态。
+ * - `defineCrud` / `createCrudController`：纯客户端（无 SvelteKit SSR）下托管数据与导航，
+ *   业务应用无需自建 CRUD 适配层。
  * @module crud
  */
+export * from './crud-controller.svelte.js';
 export type * from './crud-types.js';
 export { default as CrudDeleteConfirm } from './CrudDeleteConfirm.svelte';
 export { default as CrudDetailPanel } from './CrudDetailPanel.svelte';

package/dist/components/scenes/crud/index.js

@@ -1,9 +1,13 @@
 /**
  * @h-ai/ui — CRUD 场景组件
  *
- * 提供声明式 CRUD 页面组件，基于 kit.crud.define() 定义自动渲染列表、搜索过滤、分页、详情/编辑面板和删除确认。
+ * 提供声明式 CRUD 页面组件与框架级控制器：
+ * - `CrudPage` 组件：自动渲染列表、搜索过滤、分页、详情/编辑面板、删除确认，以及查询中/失败/空态。
+ * - `defineCrud` / `createCrudController`：纯客户端（无 SvelteKit SSR）下托管数据与导航，
+ *   业务应用无需自建 CRUD 适配层。
  * @module crud
  */
+export * from './crud-controller.svelte.js';
 export { default as CrudDeleteConfirm } from './CrudDeleteConfirm.svelte';
 export { default as CrudDetailPanel } from './CrudDetailPanel.svelte';
 export { default as CrudEditPanel } from './CrudEditPanel.svelte';

package/dist/index.d.ts

@@ -6,6 +6,7 @@
  */
 export * from './components/index.js';
 export * from './i18n.svelte.js';
+export * from './internal/browser-safety.js';
 export * from './message.svelte.js';
 export * from './messagebox.svelte.js';
 export * from './theme-config.js';

package/dist/index.js

@@ -8,6 +8,8 @@
 export * from './components/index.js';
 // ─── i18n 国际化（Paraglide 辅助工具） ───
 export * from './i18n.svelte.js';
+// ─── 浏览器能力安全辅助（剪贴板、localStorage 等降级方案） ───
+export * from './internal/browser-safety.js';
 // ─── Message 轻量消息提示（类似 ElementUI Message） ───
 export * from './message.svelte.js';
 // ─── MessageBox 命令式弹框（类似 ElementUI MessageBox） ───

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

@@ -20,7 +20,8 @@ export declare function writeStoredValue(key: string, value: string): boolean;
 /**
  * 安全写入剪贴板。
  *
- * 在不安全上下文、旧 WebView 或浏览器策略禁用时直接返回 false，
- * 让上层决定是否展示成功反馈。
+ * 优先使用现代 Clipboard API；在不安全上下文（HTTP）、旧 WebView
+ * 或浏览器策略禁用时回退到 `document.execCommand('copy')`，
+ * 确保尽可能多的环境下复制操作可用。
  */
 export declare function writeTextToClipboard(text: string): Promise<boolean>;

package/dist/internal/browser-safety.js

@@ -41,16 +41,37 @@ export function writeStoredValue(key, value) {
 /**
  * 安全写入剪贴板。
  *
- * 在不安全上下文、旧 WebView 或浏览器策略禁用时直接返回 false，
- * 让上层决定是否展示成功反馈。
+ * 优先使用现代 Clipboard API；在不安全上下文（HTTP）、旧 WebView
+ * 或浏览器策略禁用时回退到 `document.execCommand('copy')`，
+ * 确保尽可能多的环境下复制操作可用。
  */
 export async function writeTextToClipboard(text) {
-    if (typeof navigator === 'undefined' || !navigator.clipboard?.writeText) {
+    if (typeof navigator === 'undefined') {
+        return false;
+    }
+    // 现代 Clipboard API（仅安全上下文可用）
+    if (navigator.clipboard?.writeText) {
+        try {
+            await navigator.clipboard.writeText(text);
+            return true;
+        }
+        catch {
+            // Clipboard API 失败时继续尝试 fallback
+        }
+    }
+    // fallback：textarea + execCommand（兼容 HTTP、旧浏览器）
+    if (typeof document === 'undefined') {
         return false;
     }
     try {
-        await navigator.clipboard.writeText(text);
-        return true;
+        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;
     }
     catch {
         return false;

package/dist/messages/en-US.json

@@ -262,12 +262,14 @@
   "crud_edit": "Edit",
   "crud_detail": "Detail",
   "crud_delete": "Delete",
+  "crud_load_failed": "Failed to load",
+  "crud_retry": "Retry",
   "crud_save": "Save",
   "crud_cancel": "Cancel",
   "crud_close": "Close",
   "crud_search_placeholder": "Search...",
   "crud_no_data": "No data",
-  "crud_loading": "Loading...",
+  "crud_loading": "Querying…",
   "crud_delete_title": "Confirm Delete",
   "crud_delete_message": "Are you sure you want to delete this record? This action cannot be undone.",
   "crud_submit_success": "Operation successful",

package/dist/messages/zh-CN.json

@@ -262,12 +262,14 @@
   "crud_edit": "编辑",
   "crud_detail": "详情",
   "crud_delete": "删除",
+  "crud_load_failed": "加载失败",
+  "crud_retry": "重试",
   "crud_save": "保存",
   "crud_cancel": "取消",
   "crud_close": "关闭",
   "crud_search_placeholder": "搜索...",
   "crud_no_data": "暂无数据",
-  "crud_loading": "加载中...",
+  "crud_loading": "查询中…",
   "crud_delete_title": "确认删除",
   "crud_delete_message": "确定要删除此记录吗？此操作不可恢复。",
   "crud_submit_success": "操作成功",

package/dist/toast.svelte.d.ts

@@ -42,4 +42,50 @@ declare class ToastState {
  * Toast 单例
  */
 export declare const toast: ToastState;
+/**
+ * 弹出操作成功提示（右上角）。
+ *
+ * @description 统一封装 toast 单例，业务应用无需自建 toast 工具文件即可获得一致的成功反馈。
+ *
+ * @param message - 用户可见的成功文案（已本地化）。
+ * @param duration - 可选停留时长（毫秒），默认 3000。
+ *
+ * @example
+ * notifySuccess(m.submit_submitted())
+ */
+export declare function notifySuccess(message: string, duration?: number): string;
+/**
+ * 弹出操作失败提示（右上角）。
+ *
+ * @description 接受 `Error` 或字符串；`Error` 取其 message，其余回退到 fallback，
+ *   避免各业务页面重复实现错误文案兜底逻辑。
+ *
+ * @param error - 错误对象或已本地化的错误文案。
+ * @param fallback - 当 error 非 Error 且为空时使用的兜底文案。
+ * @param duration - 可选停留时长（毫秒），默认 5000。
+ *
+ * @example
+ * notifyError(error, m.submit_failed())
+ */
+export declare function notifyError(error: unknown, fallback?: string, duration?: number): string;
+/**
+ * 弹出信息提示（右上角）。
+ *
+ * @param message - 用户可见文案（已本地化）。
+ * @param duration - 可选停留时长（毫秒），默认 3000。
+ *
+ * @example
+ * notifyInfo(m.common_saved())
+ */
+export declare function notifyInfo(message: string, duration?: number): string;
+/**
+ * 弹出警告提示（右上角）。
+ *
+ * @param message - 用户可见文案（已本地化）。
+ * @param duration - 可选停留时长（毫秒），默认 5000。
+ *
+ * @example
+ * notifyWarning(m.quota_almost_reached())
+ */
+export declare function notifyWarning(message: string, duration?: number): string;
 export {};

package/dist/toast.svelte.js

@@ -75,3 +75,64 @@ class ToastState {
  * Toast 单例
  */
 export const toast = new ToastState();
+/** 成功提示默认停留时长（毫秒）。 */
+const SUCCESS_DURATION = 3000;
+/** 失败提示默认停留时长（毫秒），比成功略长便于阅读错误信息。 */
+const ERROR_DURATION = 5000;
+/**
+ * 弹出操作成功提示（右上角）。
+ *
+ * @description 统一封装 toast 单例，业务应用无需自建 toast 工具文件即可获得一致的成功反馈。
+ *
+ * @param message - 用户可见的成功文案（已本地化）。
+ * @param duration - 可选停留时长（毫秒），默认 3000。
+ *
+ * @example
+ * notifySuccess(m.submit_submitted())
+ */
+export function notifySuccess(message, duration = SUCCESS_DURATION) {
+    return toast.success(message, duration);
+}
+/**
+ * 弹出操作失败提示（右上角）。
+ *
+ * @description 接受 `Error` 或字符串；`Error` 取其 message，其余回退到 fallback，
+ *   避免各业务页面重复实现错误文案兜底逻辑。
+ *
+ * @param error - 错误对象或已本地化的错误文案。
+ * @param fallback - 当 error 非 Error 且为空时使用的兜底文案。
+ * @param duration - 可选停留时长（毫秒），默认 5000。
+ *
+ * @example
+ * notifyError(error, m.submit_failed())
+ */
+export function notifyError(error, fallback = '', duration = ERROR_DURATION) {
+    const message = error instanceof Error
+        ? error.message
+        : (typeof error === 'string' ? error : fallback);
+    return toast.error(message || fallback, duration);
+}
+/**
+ * 弹出信息提示（右上角）。
+ *
+ * @param message - 用户可见文案（已本地化）。
+ * @param duration - 可选停留时长（毫秒），默认 3000。
+ *
+ * @example
+ * notifyInfo(m.common_saved())
+ */
+export function notifyInfo(message, duration = SUCCESS_DURATION) {
+    return toast.info(message, duration);
+}
+/**
+ * 弹出警告提示（右上角）。
+ *
+ * @param message - 用户可见文案（已本地化）。
+ * @param duration - 可选停留时长（毫秒），默认 5000。
+ *
+ * @example
+ * notifyWarning(m.quota_almost_reached())
+ */
+export function notifyWarning(message, duration = ERROR_DURATION) {
+    return toast.warning(message, duration);
+}

package/dist/types.d.ts

@@ -516,6 +516,11 @@ export interface TooltipProps extends DataAttributes {
     class?: string;
     /** 触发元素插槽 */
     children?: Snippet;
+    /**
+     * 启用 portal 模式：提示内容通过 document.body 渲染，
+     * 不受父容器 overflow 裁剪。适用于表格、滚动容器等场景。
+     */
+    portal?: boolean;
 }
 /**
  * 加载属性
@@ -666,6 +671,18 @@ export interface TabItem {
     /** 图标 */
     icon?: string;
 }
+/**
+ * 标签页内容上下文
+ *
+ * 传给 `Tabs` 的 `children` 插槽，支持惰性挂载：只渲染已激活过的页签内容，
+ * 不预加载不可见页签。
+ */
+export interface TabsContentContext {
+    /** 当前激活的标签 key */
+    active: string;
+    /** 指定标签是否已被激活过（`lazy` 为 false 时恒为 true） */
+    isActivated: (key: string) => boolean;
+}
 /**
  * 标签页属性
  */
@@ -682,8 +699,12 @@ export interface TabsProps extends DataAttributes {
     class?: string;
     /** 变化事件 */
     onchange?: (key: string) => void;
-    /** 内容插槽 */
-    children?: Snippet;
+    /** 页签首次激活时触发一次；用于惰性加载对应内容（如调用控制器的 load） */
+    onactivate?: (key: string) => void;
+    /** 是否惰性挂载页签内容：为 true 时未激活过的页签不渲染，`isActivated` 据此判断 */
+    lazy?: boolean;
+    /** 内容插槽；参数提供当前激活项与惰性挂载判断 */
+    children?: Snippet<[TabsContentContext]>;
 }
 /**
  * 头像属性
@@ -727,8 +748,8 @@ export interface DropdownItem {
 export interface DropdownProps extends DataAttributes {
     /** 菜单项 */
     items: DropdownItem[];
-    /** 触发方式 */
-    trigger?: 'click' | 'hover';
+    /** 触发方式；`manual` 由外部完全控制 open 状态。 */
+    trigger?: 'click' | 'hover' | 'manual';
     /** 位置 */
     position?: Position;
     /** 对齐 */
@@ -977,6 +998,8 @@ export interface PopoverProps extends DataAttributes {
     trigger?: 'click' | 'hover';
     /** 偏移量 */
     offset?: number;
+    /** 是否将内容挂到 body，以逃逸祖先 overflow 和堆叠上下文。 */
+    portal?: boolean;
     /** 自定义类名 */
     class?: string;
     /** 打开事件 */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@h-ai/ui",
   "type": "module",
-  "version": "0.1.0-alpha.48",
+  "version": "0.1.0-alpha.50",
   "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.48"
+    "@h-ai/core": "0.1.0-alpha.50"
   },
   "devDependencies": {
     "@sveltejs/package": "^2.5.7",