@lark-apaas/client-toolkit 1.2.16 → 1.2.17-alpha.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/client-toolkit",
-  "version": "1.2.16",
+  "version": "1.2.17-alpha.1",
   "types": "./lib/index.d.ts",
   "main": "./lib/index.js",
   "files": [
@@ -71,6 +71,11 @@
       "require": "./lib/apis/utils/*.js",
       "types": "./lib/apis/utils/*.d.ts"
     },
+    "./aily-chat": {
+      "import": "./lib/apis/aily-chat.js",
+      "require": "./lib/apis/aily-chat.js",
+      "types": "./lib/apis/aily-chat.d.ts"
+    },
     "./auth": {
       "import": "./lib/auth.js",
       "require": "./lib/auth.js",
@@ -94,10 +99,11 @@
     "@ant-design/colors": "^7.2.1",
     "@ant-design/cssinjs": "^1.24.0",
     "@data-loom/js": "0.4.7",
+    "@lark-apaas/aily-web-sdk": ">=0.0.1",
     "@lark-apaas/auth-sdk": "^0.1.0",
     "@lark-apaas/client-capability": "^0.1.4",
-    "@lark-apaas/miaoda-inspector": "^1.0.15",
-    "@lark-apaas/observable-web": "^1.0.1",
+    "@lark-apaas/miaoda-inspector": "^1.0.16",
+    "@lark-apaas/observable-web": "^1.0.2-alpha.2",
     "@radix-ui/react-avatar": "^1.1.10",
     "@radix-ui/react-popover": "^1.1.15",
     "@radix-ui/react-slot": "^1.2.3",
@@ -168,4 +174,4 @@
     "react-router-dom": ">=6.26.2",
     "styled-jsx": ">=5.0.0"
   }
-}
+}

package/lib/apis/components/ActiveLink.d.ts

@@ -1,26 +0,0 @@
-import React from 'react';
-import { type NavLinkProps } from 'react-router-dom';
-export interface ActiveLinkProps extends Omit<NavLinkProps, 'to'> {
-    to: string;
-}
-/**
- * ActiveLink 组件
- *
- * 替换 react-router-dom 的 NavLink，扩展支持 hash 路由跳转和激活态功能
- *
- * @example
- * // 普通路由跳转
- * <ActiveLink to="/dashboard">Dashboard</ActiveLink>
- *
- * // hash 路由跳转
- * <ActiveLink to="#section1">Section 1</ActiveLink>
- *
- * // 使用函数式 className 显示激活态
- * <ActiveLink
- *   to="#features"
- *   className={({isActive}) => isActive ? 'active' : ''}
- * >
- *   Features
- * </ActiveLink>
- */
-export declare const ActiveLink: React.ForwardRefExoticComponent<ActiveLinkProps & React.RefAttributes<HTMLAnchorElement>>;

package/lib/apis/components/ActiveLink.js

@@ -1,66 +0,0 @@
-import { jsx } from "react/jsx-runtime";
-import { forwardRef, useEffect, useState } from "react";
-import { NavLink } from "react-router-dom";
-const ActiveLink = /*#__PURE__*/ forwardRef(({ to, onClick, className, style, children, ...rest }, ref)=>{
-    const [currentHash, setCurrentHash] = useState(()=>'undefined' != typeof window ? window.location.hash : '');
-    const isHashRoute = 'string' == typeof to && to.startsWith('#');
-    useEffect(()=>{
-        if (!isHashRoute) return;
-        const handleHashChange = ()=>{
-            setCurrentHash(window.location.hash);
-        };
-        window.addEventListener('hashchange', handleHashChange);
-        return ()=>window.removeEventListener('hashchange', handleHashChange);
-    }, [
-        isHashRoute
-    ]);
-    const isActive = isHashRoute && currentHash === to;
-    if (!isHashRoute) return /*#__PURE__*/ jsx(NavLink, {
-        ref: ref,
-        to: to,
-        onClick: onClick,
-        className: className,
-        style: style,
-        ...rest,
-        children: children
-    });
-    const handleHashClick = (e)=>{
-        onClick?.(e);
-        if (e.defaultPrevented) return;
-        e.preventDefault();
-        const targetId = to.slice(1);
-        const targetElement = document.getElementById(targetId);
-        history.pushState(null, '', to);
-        setCurrentHash(to);
-        window.dispatchEvent(new Event('hashchange'));
-        if (targetElement && 'function' == typeof targetElement.scrollIntoView) targetElement.scrollIntoView({
-            behavior: 'smooth'
-        });
-    };
-    const computedClassName = 'function' == typeof className ? className({
-        isActive,
-        isPending: false,
-        isTransitioning: false
-    }) : className;
-    const computedStyle = 'function' == typeof style ? style({
-        isActive,
-        isPending: false,
-        isTransitioning: false
-    }) : style;
-    const computedChildren = 'function' == typeof children ? children({
-        isActive,
-        isPending: false,
-        isTransitioning: false
-    }) : children;
-    return /*#__PURE__*/ jsx("a", {
-        ref: ref,
-        href: to,
-        onClick: handleHashClick,
-        className: computedClassName,
-        style: computedStyle,
-        ...rest,
-        children: computedChildren
-    });
-});
-ActiveLink.displayName = 'ActiveLink';
-export { ActiveLink };

package/lib/apis/hooks/useScrollReveal.d.ts

@@ -1 +0,0 @@
-export * from '../../hooks/useScrollReveal';

package/lib/apis/hooks/useScrollReveal.js

@@ -1 +0,0 @@
-export * from "../../hooks/useScrollReveal.js";

package/lib/apis/utils/getEnv.d.ts

@@ -1 +0,0 @@
-export { getEnv } from '../../utils/getParentOrigin';

package/lib/apis/utils/getEnv.js

@@ -1,2 +0,0 @@
-import { getEnv } from "../../utils/getParentOrigin.js";
-export { getEnv };

package/lib/apis/utils/scopedStorage.d.ts

@@ -1 +0,0 @@
-export { scopedStorage } from '../../utils/scopedStorage';

package/lib/apis/utils/scopedStorage.js

@@ -1,2 +0,0 @@
-import { scopedStorage } from "../../utils/scopedStorage.js";
-export { scopedStorage };

package/lib/auth.d.ts

@@ -1 +0,0 @@
-export { CanRole, AbilityContext, ROLE_SUBJECT } from '@lark-apaas/auth-sdk';

package/lib/auth.js

@@ -1,2 +0,0 @@
-import { AbilityContext, CanRole, ROLE_SUBJECT } from "@lark-apaas/auth-sdk";
-export { AbilityContext, CanRole, ROLE_SUBJECT };

package/lib/components/ui/toast.d.ts

@@ -1,2 +0,0 @@
-/** 显示 toast 提示（兼容 PC/移动端） */
-export declare function showToast(message: string, duration?: number): Promise<void>;

package/lib/components/ui/toast.js

@@ -1,53 +0,0 @@
-function showToast(message, duration = 3000) {
-    return new Promise((resolve)=>{
-        const toast = document.createElement('div');
-        const iconSvg = `<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
-      <path fill-rule="evenodd" clip-rule="evenodd" d="M8 1.333a6.667 6.667 0 1 1 0 13.334A6.667 6.667 0 0 1 8 1.333ZM8 10a.667.667 0 1 0 0 1.333A.667.667 0 0 0 8 10Zm0-5.333a.667.667 0 0 0-.667.666v3.334a.667.667 0 0 0 1.334 0V5.333A.667.667 0 0 0 8 4.667Z" fill="#ff811a"/>
-    </svg>`;
-        const iconWrapper = document.createElement('span');
-        iconWrapper.innerHTML = iconSvg;
-        Object.assign(iconWrapper.style, {
-            display: 'flex',
-            alignItems: 'center',
-            marginRight: '8px',
-            flexShrink: '0'
-        });
-        const textWrapper = document.createElement('span');
-        textWrapper.textContent = message;
-        toast.appendChild(iconWrapper);
-        toast.appendChild(textWrapper);
-        Object.assign(toast.style, {
-            position: 'fixed',
-            top: '32px',
-            left: '50%',
-            transform: 'translate(-50%, -50%)',
-            display: 'flex',
-            alignItems: 'center',
-            padding: '12px 16px',
-            backgroundColor: '#fff',
-            color: '#1f2329',
-            border: '1px solid #dee0e3',
-            borderRadius: '6px',
-            fontSize: '14px',
-            lineHeight: '1.5',
-            zIndex: '99999',
-            maxWidth: '80vw',
-            wordBreak: 'break-word',
-            boxShadow: '0 4px 8px rgba(0, 0, 0, 0.03), 0 3px 6px rgba(0, 0, 0, 0.05), 0 6px 18px rgba(0, 0, 0, 0.03)',
-            opacity: '0',
-            transition: 'opacity 0.3s ease'
-        });
-        document.body.appendChild(toast);
-        requestAnimationFrame(()=>{
-            toast.style.opacity = '1';
-        });
-        setTimeout(()=>{
-            toast.style.opacity = '0';
-            setTimeout(()=>{
-                document.body.removeChild(toast);
-                resolve();
-            }, 300);
-        }, duration);
-    });
-}
-export { showToast };

package/lib/hooks/useScrollReveal.d.ts

@@ -1,61 +0,0 @@
-import { RefObject } from 'react';
-/**
- * Options for useScrollReveal hook
- */
-export interface UseScrollRevealOptions<T extends HTMLElement = HTMLElement> {
-    /** Ref to the container element to scope the query (default: document.body) */
-    containerRef?: RefObject<T | null>;
-    /** IntersectionObserver threshold - element visibility percentage to trigger (default: 0.1) */
-    threshold?: number;
-    /** IntersectionObserver rootMargin - margin around root (default: '0px 0px -50px 0px') */
-    rootMargin?: string;
-    /** CSS class to add when element becomes visible (default: 'visible') */
-    visibleClass?: string;
-    /** CSS selector for elements to observe (default: '.scroll-reveal') */
-    selector?: string;
-}
-/**
- * Hook to enable scroll reveal animations using IntersectionObserver.
- *
- * Observes elements with the specified selector and adds a visibility class
- * when they enter the viewport.
- *
- * @param options - Configuration options
- *
- * @example
- * ```tsx
- * // Usage without parameters (queries entire document.body)
- * import { useScrollReveal } from '@lark-apaas/client-toolkit/hooks/useScrollReveal';
- *
- * function MyComponent() {
- *   useScrollReveal();
- *
- *   return <div className="scroll-reveal">I will fade in on scroll!</div>;
- * }
- * ```
- *
- * @example
- * ```tsx
- * // Usage with container ref
- * import { useRef } from 'react';
- * import { useScrollReveal } from '@lark-apaas/client-toolkit/hooks/useScrollReveal';
- *
- * function MyComponent() {
- *   const containerRef = useRef<HTMLDivElement>(null);
- *   useScrollReveal({ containerRef });
- *
- *   return (
- *     <div ref={containerRef}>
- *       <div className="scroll-reveal">I will fade in on scroll!</div>
- *     </div>
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // Usage with custom options
- * useScrollReveal({ threshold: 0.2, visibleClass: 'animate-in' });
- * ```
- */
-export declare function useScrollReveal<T extends HTMLElement = HTMLElement>(options?: UseScrollRevealOptions<T>): void;

package/lib/hooks/useScrollReveal.js

@@ -1,37 +0,0 @@
-import { useEffect } from "react";
-const DEFAULT_OPTIONS = {
-    threshold: 0.1,
-    rootMargin: '0px 0px -50px 0px',
-    visibleClass: 'visible',
-    selector: '.scroll-reveal'
-};
-function useScrollReveal(options) {
-    const { containerRef, threshold, rootMargin, visibleClass, selector } = {
-        ...DEFAULT_OPTIONS,
-        ...options
-    };
-    useEffect(()=>{
-        const container = containerRef?.current ?? document.body;
-        if (!container) return;
-        const observer = new IntersectionObserver((entries)=>{
-            entries.forEach((entry)=>{
-                if (entry.isIntersecting) entry.target.classList.add(visibleClass);
-            });
-        }, {
-            threshold,
-            rootMargin
-        });
-        const elements = container.querySelectorAll(selector);
-        elements.forEach((el)=>observer.observe(el));
-        return ()=>{
-            observer.disconnect();
-        };
-    }, [
-        containerRef,
-        threshold,
-        rootMargin,
-        visibleClass,
-        selector
-    ]);
-}
-export { useScrollReveal };

package/lib/runtime/axios.d.ts

@@ -1,5 +0,0 @@
-/**
- * Axios 配置初始化
- * 从原有的 axiosConfig.ts 迁移
- */
-export { initAxiosConfig } from '../utils/axiosConfig';

package/lib/runtime/axios.js

@@ -1,2 +0,0 @@
-import { initAxiosConfig } from "../utils/axiosConfig.js";
-export { initAxiosConfig };

package/lib/runtime/dayjs.d.ts

@@ -1,5 +0,0 @@
-/**
- * Dayjs 插件注册
- * 从原有的 dayjsPlugins.ts 迁移
- */
-export { registerDayjsPlugins } from '../components/AppContainer/dayjsPlugins';

package/lib/runtime/dayjs.js

@@ -1,2 +0,0 @@
-import { registerDayjsPlugins } from "../components/AppContainer/dayjsPlugins.js";
-export { registerDayjsPlugins };

package/lib/runtime/iframe-bridge.d.ts

@@ -1,11 +0,0 @@
-/**
- * Iframe Bridge Runtime
- *
- * 开发环境下的 iframe 通信初始化：
- * - connectParent - 通过 penpal 连接父页面，建立双向通信
- */
-/**
- * 初始化 iframe bridge（仅开发环境）
- * - 连接父页面
- */
-export declare function initIframeBridge(): void;

package/lib/runtime/iframe-bridge.js

@@ -1,29 +0,0 @@
-import { connectToParent } from "penpal";
-import { resolveParentOrigin, submitPostMessage } from "../utils/postMessage.js";
-import { batchLogInfo } from "../logger/batch-logger.js";
-import { childApi } from "../components/AppContainer/utils/childApi.js";
-async function connectParent() {
-    submitPostMessage({
-        type: 'PreviewReady',
-        data: {}
-    });
-    batchLogInfo('info', JSON.stringify({
-        type: 'PreviewReady',
-        timestamp: Date.now(),
-        url: window.location.href
-    }));
-    const parentOrigin = resolveParentOrigin();
-    if (!parentOrigin) return;
-    const connection = connectToParent({
-        parentOrigin,
-        methods: {
-            ...childApi
-        }
-    });
-    await connection.promise;
-}
-function initIframeBridge() {
-    if (window.parent === window) return;
-    connectParent();
-}
-export { initIframeBridge };

package/lib/runtime/index.d.ts

@@ -1,23 +0,0 @@
-/**
- * Client Toolkit Runtime
- *
- * 全局初始化逻辑，通过 rspack-plugin 自动注入到用户入口之前
- * 无论用户是否使用 AppContainer，这些基础能力始终可用
- *
- * 执行顺序：
- * 1. 全局样式
- * 2. Dayjs 插件注册
- * 3. Axios 配置
- * 4. 可观测初始化
- * 5. Server Log SSE (开发环境)
- *
- * 兼容性说明：
- * - 使用 __FULLSTACK_RUNTIME_INITIALIZED__ 标志位防止重复初始化
- * - 旧版 AppContainer 和新版 runtime 可以共存
- */
-import './styles';
-declare global {
-    interface Window {
-        __FULLSTACK_RUNTIME_INITIALIZED__?: boolean;
-    }
-}

package/lib/runtime/index.js

@@ -1,16 +0,0 @@
-import "./styles.js";
-import { registerDayjsPlugins } from "./dayjs.js";
-import { initAxiosConfig } from "./axios.js";
-import { initObservable } from "./observable.js";
-import { initServerLog } from "./server-log.js";
-import { initIframeBridge } from "./iframe-bridge.js";
-if (!window.__FULLSTACK_RUNTIME_INITIALIZED__) {
-    window.__FULLSTACK_RUNTIME_INITIALIZED__ = true;
-    registerDayjsPlugins();
-    initAxiosConfig();
-    initObservable();
-    if ('production' !== process.env.NODE_ENV) {
-        initServerLog();
-        initIframeBridge();
-    }
-}

package/lib/runtime/observable.d.ts

@@ -1,5 +0,0 @@
-/**
- * 可观测初始化
- * 从原有的 observable.ts 迁移
- */
-export { initObservable } from '../components/AppContainer/utils/observable';

package/lib/runtime/observable.js

@@ -1,2 +0,0 @@
-import { initObservable } from "../components/AppContainer/utils/observable.js";
-export { initObservable };

package/lib/runtime/server-log.d.ts

@@ -1,5 +0,0 @@
-/**
- * 初始化 Server Log SSE 客户端
- * 仅在开发环境且在 iframe 中时启用
- */
-export declare function initServerLog(): void;

package/lib/runtime/server-log.js

@@ -1,41 +0,0 @@
-import { ServerLogSSEClient } from "../server-log/index.js";
-let client = null;
-function initServerLog() {
-    if (window.parent === window) return;
-    try {
-        const backendUrl = window.location.origin;
-        client = new ServerLogSSEClient({
-            serverUrl: backendUrl,
-            sseEndpoint: '/dev/logs/server-logs/stream',
-            debug: true
-        });
-        client.start();
-        console.log('[Runtime] Server log SSE client started');
-        document.addEventListener('visibilitychange', handleVisibilityChange);
-        window.addEventListener('beforeunload', cleanup);
-        window.addEventListener('unload', cleanup);
-    } catch (error) {
-        console.error('[Runtime] Failed to start server log SSE client:', error);
-    }
-}
-function handleVisibilityChange() {
-    if (!client) return;
-    if (document.hidden) {
-        client.pause();
-        console.log('[Runtime] Tab hidden, SSE paused');
-    } else {
-        client.resume();
-        console.log('[Runtime] Tab visible, SSE resumed');
-    }
-}
-function cleanup() {
-    if (client) {
-        document.removeEventListener('visibilitychange', handleVisibilityChange);
-        window.removeEventListener('beforeunload', cleanup);
-        window.removeEventListener('unload', cleanup);
-        client.stop();
-        client = null;
-        console.log('[Runtime] Server log SSE client stopped');
-    }
-}
-export { initServerLog };

package/lib/runtime/styles.d.ts

@@ -1,5 +0,0 @@
-/**
- * 全局样式导入
- * 在 runtime 中最先执行，确保样式优先加载
- */
-import '../index.css';

package/lib/runtime/styles.js

@@ -1 +0,0 @@
-import "../index.css";

package/lib/utils/hmr-api.d.ts

@@ -1,39 +0,0 @@
-/**
- * 统一 HMR API
- *
- * 提供统一的 HMR 成功/失败回调接口，屏蔽 Webpack 和 Vite 的差异。
- *
- * - Webpack/Rspack: 通过 import.meta.webpackHot 或 module.hot
- * - Vite: 通过 error-overlay 注入的 window.__VITE_HMR__
- *
- * @see docs/RFC_HMR_API.md
- */
-export interface HmrApi {
-    /**
-     * 注册 HMR 成功回调
-     * @param callback 成功回调函数
-     * @returns cleanup 函数，用于取消注册
-     */
-    onSuccess(callback: () => void): () => void;
-    /**
-     * 注册 HMR 失败回调
-     * @param callback 失败回调函数，参数为错误信息
-     * @returns cleanup 函数，用于取消注册
-     */
-    onError(callback: (error: unknown) => void): () => void;
-}
-declare global {
-    interface Window {
-        __VITE_HMR__?: HmrApi;
-    }
-}
-/**
- * 获取 HMR API 实例
- *
- * 自动检测当前构建工具（Webpack/Vite）并返回对应实现：
- * - Webpack/Rspack: 使用内置适配器
- * - Vite: 使用 error-overlay 注入的 window.__VITE_HMR__
- *
- * @returns HmrApi 实例，如果不在开发环境或不支持 HMR 则返回 null
- */
-export declare function getHmrApi(): HmrApi | null;

package/lib/utils/hmr-api.js

@@ -1,36 +0,0 @@
-function createWebpackHmrApi(hot) {
-    return {
-        onSuccess (callback) {
-            let lastStatus = null;
-            const handler = (status)=>{
-                if ('idle' === status && 'apply' === lastStatus) try {
-                    callback();
-                } catch (e) {
-                    console.error('[HMR] Success callback error:', e);
-                }
-                lastStatus = status;
-            };
-            hot.addStatusHandler(handler);
-            return ()=>hot.removeStatusHandler(handler);
-        },
-        onError (callback) {
-            const handler = (status)=>{
-                if ('fail' === status || 'abort' === status) try {
-                    callback(new Error(`HMR ${status}`));
-                } catch (e) {
-                    console.error('[HMR] Error callback error:', e);
-                }
-            };
-            hot.addStatusHandler(handler);
-            return ()=>hot.removeStatusHandler(handler);
-        }
-    };
-}
-function getHmrApi() {
-    if ('production' === process.env.NODE_ENV) return null;
-    if (import.meta.webpackHot) return createWebpackHmrApi(import.meta.webpackHot);
-    'undefined' != typeof module && module.hot;
-    if (window.__VITE_HMR__) return window.__VITE_HMR__;
-    return null;
-}
-export { getHmrApi };

package/lib/utils/scopedStorage.d.ts

@@ -1,5 +0,0 @@
-/**
- * 按 appId 隔离的 localStorage 封装
- * API 与原生 localStorage 保持一致
- */
-export declare const scopedStorage: Storage;

package/lib/utils/scopedStorage.js

@@ -1,46 +0,0 @@
-import { getAppId } from "./getAppId.js";
-function getPrefix() {
-    const appId = getAppId(window.location.pathname);
-    const namespace = appId || '__global__';
-    return `__miaoda_${namespace}__:`;
-}
-function getScopedKeys() {
-    const prefix = getPrefix();
-    const keys = [];
-    for(let i = 0; i < localStorage.length; i++){
-        const key = localStorage.key(i);
-        if (key && key.startsWith(prefix)) keys.push(key.substring(prefix.length));
-    }
-    return keys;
-}
-const scopedStorage = {
-    getItem (key) {
-        const prefixedKey = getPrefix() + key;
-        return localStorage.getItem(prefixedKey);
-    },
-    setItem (key, value) {
-        const prefixedKey = getPrefix() + key;
-        localStorage.setItem(prefixedKey, value);
-    },
-    removeItem (key) {
-        const prefixedKey = getPrefix() + key;
-        localStorage.removeItem(prefixedKey);
-    },
-    clear () {
-        const prefix = getPrefix();
-        const keysToRemove = [];
-        for(let i = 0; i < localStorage.length; i++){
-            const key = localStorage.key(i);
-            if (key && key.startsWith(prefix)) keysToRemove.push(key);
-        }
-        keysToRemove.forEach((key)=>localStorage.removeItem(key));
-    },
-    key (index) {
-        const keys = getScopedKeys();
-        return keys[index] || null;
-    },
-    get length () {
-        return getScopedKeys().length;
-    }
-};
-export { scopedStorage };