open-index/open-npm huggingface dataset:
npm package: @quantabit/ab-test-sdk
Description: QuantaBit A/B测试 SDK - 实验管理、流量分配、效果分析、多变量测试
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/ab-test-sdk

QuantaBit A/B测试 SDK - 实验管理、流量分配、效果分析、多变量测试

## 安装

```bash
npm install @quantabit/ab-test-sdk
# 或
yarn add @quantabit/ab-test-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/ab-test-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/account-link-sdk
Description: 子账号关联SDK - 家庭组、企业员工号
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/account-link-sdk

子账号关联SDK - 家庭组、企业员工号

## 安装

```bash
npm install @quantabit/account-link-sdk
# 或
yarn add @quantabit/account-link-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/account-link-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/account-merge-sdk
Description: 账号合并SDK - 数据迁移
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/account-merge-sdk

账号合并SDK - 数据迁移

## 安装

```bash
npm install @quantabit/account-merge-sdk
# 或
yarn add @quantabit/account-merge-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/account-merge-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/account-switch-sdk
Description: 账号切换SDK - 多身份切换
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/account-switch-sdk

账号切换SDK - 多身份切换

## 安装

```bash
npm install @quantabit/account-switch-sdk
# 或
yarn add @quantabit/account-switch-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/account-switch-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/account-type-sdk
Description: 账号类别管理SDK - 个人/企业/创作者
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/account-type-sdk

账号类别管理SDK - 个人/企业/创作者

## 安装

```bash
npm install @quantabit/account-type-sdk
# 或
yarn add @quantabit/account-type-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/account-type-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/achievement-sdk
Description: QuantaBit 成就系统 SDK - 提供成就徽章、里程碑、解锁动画功能
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/achievement-sdk

> QuantaBit 成就系统 SDK - 提供成就徽章、里程碑、解锁动画功能

## 📦 安装

```bash
npm install @quantabit/achievement-sdk
# 或
yarn add @quantabit/achievement-sdk
```

## 🚀 快速开始

### 1. 引入 Provider

```jsx
import {
  AchievementProvider,
  UnlockAnimation,
} from "@quantabit/achievement-sdk";
import "@quantabit/achievement-sdk/styles.css";

function App() {
  return (
    <AchievementProvider
      apiUrl="https://api.example.com/v1"
      token="your-auth-token"
      onUnlock={(achievement) => console.log("解锁成就:", achievement)}
    >
      <YourComponent />
      <UnlockAnimation /> {/* 全局解锁动画 */}
    </AchievementProvider>
  );
}
```

### 2. 使用组件

```jsx
import { AchievementBadge } from "@quantabit/achievement-sdk";

// 成就徽章
<AchievementBadge
  achievement={achievementData}
  size="medium"
  showProgress
  onClick={(a) => viewDetail(a)}
/>;
```

### 3. 使用 Hooks

```jsx
import { useAchievement } from "@quantabit/achievement-sdk";

function MyComponent() {
  const {
    achievements, // 所有成就
    myAchievements, // 我的成就
    stats, // 统计数据
    loadAchievements, // 加载成就
    claimReward, // 领取奖励
    showUnlockAnimation, // 显示解锁动画
  } = useAchievement();

  return <div>...</div>;
}
```

### 4. 触发解锁动画

```jsx
const { showUnlockAnimation } = useAchievement();

// 当检测到新成就解锁时
showUnlockAnimation({
  id: "first_login",
  name: "初次登录",
  icon: "🎉",
  rarity: "common",
  reward: { name: "积分", amount: 100, icon: "⭐" },
});
```

## 🏆 稀有度等级

```javascript
import { Rarity } from "@quantabit/achievement-sdk";

Rarity.COMMON; // ⚪ 普通
Rarity.RARE; // 🔵 稀有
Rarity.EPIC; // 🟣 史诗
Rarity.LEGENDARY; // 🟠 传说
```

## 📄 许可证

MIT License
npm package: @quantabit/activity-sdk
Description: QuantaBit 活动配置 SDK - 提供运营活动、抽奖、促销等功能
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/activity-sdk

> QuantaBit 活动配置 SDK - 提供运营活动、抽奖、促销等功能

## 📦 安装

```bash
npm install @quantabit/activity-sdk
# 或
yarn add @quantabit/activity-sdk
```

## 🚀 快速开始

### 1. 引入 Provider

```jsx
import { ActivityProvider } from "@quantabit/activity-sdk";
import "@quantabit/activity-sdk/styles.css";

function App() {
  return (
    <ActivityProvider
      apiUrl="https://api.example.com/v1"
      token="your-auth-token"
      language="zh"
      onWin={(prize) => console.log("恭喜中奖:", prize)}
    >
      <YourComponent />
    </ActivityProvider>
  );
}
```

### 2. 使用组件

```jsx
import { ActivityList, ActivityCard, LotteryWheel } from '@quantabit/activity-sdk';

// 活动列表
<ActivityList
  showFilter
  onActivityClick={(activity) => console.log(activity)}
/>

// 活动卡片
<ActivityCard
  activity={activityData}
  showCountdown
  onParticipate={handleParticipate}
/>

// 转盘抽奖
<LotteryWheel
  prizes={[
    { id: '1', name: '10积分', icon: '🪙' },
    { id: '2', name: '优惠券', icon: '🎫' },
    { id: '3', name: '谢谢参与', icon: '🙏' },
  ]}
  chances={3}
  onDraw={handleDraw}
  onComplete={(prize) => console.log('获得:', prize)}
/>
```

### 3. 使用 Hooks

```jsx
import { useActivity } from "@quantabit/activity-sdk";

function MyComponent() {
  const {
    activities, // 活动列表
    currentActivity, // 当前活动
    myPrizes, // 我的奖品
    loading,
    loadActivities, // 加载活动
    participate, // 参与活动
    draw, // 执行抽奖
  } = useActivity();

  return <div>...</div>;
}
```

## 📚 组件列表

| 组件           | 描述                               |
| -------------- | ---------------------------------- |
| `LotteryWheel` | 转盘抽奖组件                       |
| `ActivityCard` | 活动卡片（封面、倒计时、参与按钮） |
| `ActivityList` | 活动列表，支持状态筛选             |

## 📖 活动类型

```javascript
import { ActivityType, LotteryType } from "@quantabit/activity-sdk";

// 活动类型
ActivityType.LOTTERY; // 抽奖
ActivityType.PROMOTION; // 促销
ActivityType.CAMPAIGN; // 营销活动
ActivityType.AIRDROP; // 空投
ActivityType.CONTEST; // 竞赛

// 抽奖方式
LotteryType.WHEEL; // 转盘
LotteryType.CARD; // 翻牌
LotteryType.BOX; // 盲盒
LotteryType.SCRATCH; // 刮刮乐
```

## 📄 许可证

MIT License
npm package: @quantabit/ai-support-sdk
Description: QuantaBit AI客服/机器人 SDK - 智能客服、自动化回复、意图识别、知识库问答
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/ai-support-sdk

QuantaBit AI客服/机器人 SDK - 智能客服、自动化回复、意图识别、知识库问答

## 安装

```bash
npm install @quantabit/ai-support-sdk
# 或
yarn add @quantabit/ai-support-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/ai-support-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/analytics-sdk
Description: QuantaBit 数据分析 SDK - 埋点统计、用户行为追踪、数据报表、运营看板
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/analytics-sdk

QuantaBit 数据分析 SDK - 埋点统计、用户行为追踪、数据报表、运营看板

## 安装

```bash
npm install @quantabit/analytics-sdk
# 或
yarn add @quantabit/analytics-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/analytics-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/attribution-sdk
Description: QuantaBit 渠道归因 SDK - 多触点归因模型、UTM追踪、来源分析、营销ROI计算
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/attribution-sdk

QuantaBit 渠道归因 SDK - 多触点归因模型、UTM追踪、来源分析、营销ROI计算

## 安装

```bash
npm install @quantabit/attribution-sdk
# 或
yarn add @quantabit/attribution-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/attribution-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/audit-sdk
Description: QuantaBit 操作审计日志 SDK - 管理员/用户操作记录、合规审计
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/audit-sdk

QuantaBit 操作审计日志 SDK - 管理员/用户操作记录、合规审计

## 安装

```bash
npm install @quantabit/audit-sdk
# 或
yarn add @quantabit/audit-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/audit-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/banner-sdk
Description: QuantaBit 横幅/广告位 SDK - 广告位管理、素材轮播、点击追踪、智能推荐
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/banner-sdk

QuantaBit 横幅/广告位 SDK - 广告位管理、素材轮播、点击追踪、智能推荐

## 安装

```bash
npm install @quantabit/banner-sdk
# 或
yarn add @quantabit/banner-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/banner-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/blacklist-sdk
Description: QuantaBit 黑白名单管理 SDK - IP/设备/用户黑白名单、动态封禁、规则引擎
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/blacklist-sdk

QuantaBit 黑白名单管理 SDK - IP/设备/用户黑白名单、动态封禁、规则引擎

## 安装

```bash
npm install @quantabit/blacklist-sdk
# 或
yarn add @quantabit/blacklist-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/blacklist-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/calendar-sdk
Description: QBit 日历 SDK - 日程管理与活动排期组件
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/calendar-sdk

QuantaBit Calendar Sdk

## 安装

```bash
npm install @quantabit/calendar-sdk
# 或
yarn add @quantabit/calendar-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/calendar-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/campaign-sdk
Description: QuantaBit 批量触达 SDK - 邮件/短信/站内信批量营销、模板化发送
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/campaign-sdk

QuantaBit 批量触达 SDK - 邮件/短信/站内信批量营销、模板化发送

## 安装

```bash
npm install @quantabit/campaign-sdk
# 或
yarn add @quantabit/campaign-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/campaign-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/chat-sdk
Description: QBit 聊天 SDK - 即时通讯与消息管理组件
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/chat-sdk

QuantaBit Chat Sdk

## 安装

```bash
npm install @quantabit/chat-sdk
# 或
yarn add @quantabit/chat-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/chat-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/checkin-sdk
Description: QBit 签到 SDK - 用户每日签到与连续签到奖励
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/checkin-sdk

QuantaBit Checkin Sdk

## 安装

```bash
npm install @quantabit/checkin-sdk
# 或
yarn add @quantabit/checkin-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/checkin-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/community-sdk
Description: QBit 社区 SDK - 社区话题、讨论与内容管理
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/community-sdk

QuantaBit Community Sdk

## 安装

```bash
npm install @quantabit/community-sdk
# 或
yarn add @quantabit/community-sdk
```

## 快速开始

```javascript
import { /* 组件或方法 */ } from '@quantabit/community-sdk';

// 请参考 API 文档了解详细用法
```

## 依赖

本 SDK 依赖 `@quantabit/sdk-config` 进行统一配置管理。
请确保在应用启动时初始化配置：

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantabit/config-sdk
Description: QuantaBit 配置中心 SDK - 远程动态配置、特征开关、灰度发布、版本回溯、环境隔离
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/config-sdk

> QuantaBit 配置中心 SDK - 提供远程动态配置、Feature Flag、灰度发布功能

## 📦 安装

```bash
npm install @quantabit/config-sdk
# 或
yarn add @quantabit/config-sdk
```

## 🚀 快速开始

### 1. 引入 Provider

```jsx
import { ConfigProvider } from "@quantabit/config-sdk";
import "@quantabit/config-sdk/styles.css";

function App() {
  return (
    <ConfigProvider apiUrl="https://api.example.com/v1" token="your-auth-token">
      <YourComponent />
    </ConfigProvider>
  );
}
```

### 2. 使用 Feature Flag

```jsx
import { FeatureFlag, useFeatureFlag } from "@quantabit/config-sdk";

// 声明式
<FeatureFlag flag="new_feature" fallback={<OldComponent />}>
  <NewComponent />
</FeatureFlag>;

// Hooks
function MyComponent() {
  const { enabled, loading } = useFeatureFlag("new_feature");
  return enabled ? <NewFeature /> : <OldFeature />;
}
```

### 3. 使用配置面板

```jsx
import { ConfigPanel } from "@quantabit/config-sdk";

<ConfigPanel namespace="app" title="应用配置" editable={false} showRefresh />;
```

### 4. 使用 Hooks

```jsx
import { useConfig } from "@quantabit/config-sdk";

function MyComponent() {
  const {
    configs, // 配置列表
    getConfig, // 获取配置
    getFeatureFlag, // 获取 Feature Flag
    updateConfig, // 更新配置
  } = useConfig();

  return <div>...</div>;
}
```

## ⚙️ 功能特性

- **远程配置**: 从服务端获取配置，支持热更新
- **Feature Flag**: 功能开关控制，支持灰度发布
- **环境隔离**: 支持多环境配置（dev/staging/prod）
- **版本回溯**: 配置变更历史记录

## 📄 许可证

MIT License
npm package: @quantabit/coupon-sdk
Description: QuantaBit 优惠券 SDK - 提供优惠券发放、领取、核销功能
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/coupon-sdk

> QuantaBit 优惠券 SDK - 提供优惠券发放、领取、核销功能

## 📦 安装

```bash
npm install @quantabit/coupon-sdk
# 或
yarn add @quantabit/coupon-sdk
```

## 🚀 快速开始

### 1. 引入 Provider

```jsx
import { CouponProvider } from "@quantabit/coupon-sdk";
import "@quantabit/coupon-sdk/styles.css";

function App() {
  return (
    <CouponProvider
      apiUrl="https://api.example.com/v1"
      token="your-auth-token"
      language="zh"
      onClaim={(coupon) => console.log("领取成功:", coupon)}
    >
      <YourComponent />
    </CouponProvider>
  );
}
```

### 2. 使用组件

```jsx
import { CouponCard, CouponList } from '@quantabit/coupon-sdk';

// 优惠券卡片
<CouponCard
  coupon={couponData}
  onClaim={(coupon) => handleClaim(coupon)}
/>

// 我的优惠券列表
<CouponList
  type="my"
  showFilter
  onUse={(coupon) => handleUse(coupon)}
/>

// 可领取优惠券列表
<CouponList
  type="available"
  onClaim={(coupon) => handleClaim(coupon)}
/>

// 选择优惠券（结算页面）
<CouponList
  type="my"
  selectable
  selectedId={selectedCouponId}
  onSelect={(coupon) => setSelectedCoupon(coupon)}
/>
```

### 3. 使用 Hooks

```jsx
import { useCoupon } from "@quantabit/coupon-sdk";

function MyComponent() {
  const {
    availableCoupons, // 可领取优惠券
    myCoupons, // 我的优惠券
    stats, // 统计（可用/已用/过期数量）
    loading,
    claimCoupon, // 领取优惠券
    getUsableCoupons, // 获取订单可用优惠券
  } = useCoupon();

  return <div>...</div>;
}
```

## 📚 组件列表

| 组件         | 描述                                  |
| ------------ | ------------------------------------- |
| `CouponCard` | 优惠券卡片（价值展示、领取/使用按钮） |
| `CouponList` | 优惠券列表，支持筛选和选择模式        |

## 📖 类型定义

```javascript
import { CouponType, CouponStatus } from "@quantabit/coupon-sdk";

// 优惠券类型
CouponType.DISCOUNT; // 折扣券
CouponType.AMOUNT; // 满减券
CouponType.CASH; // 现金券
CouponType.GIFT; // 礼品券
CouponType.FREESHIP; // 包邮券

// 优惠券状态
CouponStatus.AVAILABLE; // 可使用
CouponStatus.USED; // 已使用
CouponStatus.EXPIRED; // 已过期
CouponStatus.LOCKED; // 已锁定
```

## 🧮 优惠计算

```javascript
import { calculateDiscount, isCouponUsable } from "@quantabit/coupon-sdk";

// 检查优惠券是否可用
const usable = isCouponUsable(userCoupon, orderAmount);

// 计算优惠金额
const discount = calculateDiscount(coupon, orderAmount);
```

## 📄 许可证

MIT License
npm package: @quantabit/dashboard-sdk
Description: QuantaBit 运营看板 SDK - 实时监控、核心指标大屏、异常告警
Author: QuantaBit Team
Latest version: 1.0.1

# @quantabit/dashboard-sdk

> QuantaBit 数据报表/仪表盘 SDK - 提供 BI 看板、指标统计、可视化图表功能

## 📦 安装

```bash
npm install @quantabit/dashboard-sdk
# 或
yarn add @quantabit/dashboard-sdk
```

## 🚀 快速开始

### 1. 引入 Provider

```jsx
import { DashboardProvider } from "@quantabit/dashboard-sdk";
import "@quantabit/dashboard-sdk/styles.css";

function App() {
  return (
    <DashboardProvider
      apiUrl="https://api.example.com/v1"
      token="your-auth-token"
    >
      <Dashboard />
    </DashboardProvider>
  );
}
```

### 2. 使用组件

```jsx
import { MetricCard, DateRangeSelector } from '@quantabit/dashboard-sdk';

// 指标卡片
<MetricCard
  title="日活跃用户"
  value={12500}
  change={5.2}
  changeType="vsYesterday"
  icon="👥"
  trend={[80, 85, 90, 88, 95, 100]}
/>

// 日期范围选择器
<DateRangeSelector
  onChange={(range) => loadData(range)}
/>
```

### 3. 使用 Hooks

```jsx
import { useDashboard } from "@quantabit/dashboard-sdk";

function Dashboard() {
  const {
    metrics, // 指标数据
    trends, // 趋势数据
    dateRange, // 当前日期范围
    loadOverview, // 加载概览
    loadTrend, // 加载趋势
    exportData, // 导出数据
    changeDateRange, // 切换日期范围
  } = useDashboard();

  useEffect(() => {
    loadOverview();
  }, [dateRange]);

  return <div>...</div>;
}
```

## 📊 指标类型

```javascript
import { MetricType } from "@quantabit/dashboard-sdk";

MetricType.DAU; // 日活跃用户
MetricType.MAU; // 月活跃用户
MetricType.REVENUE; // 收入
MetricType.ORDERS; // 订单数
MetricType.CONVERSION; // 转化率
MetricType.RETENTION; // 留存率
```

## 📅 日期范围

- 今日 / 昨日
- 近7天 / 近30天
- 本月 / 上月
- 自定义范围

## 📄 许可证

MIT License
npm package: @quantabit/tag-cloud-sdk
Description: QBit Tag Cloud SDK - 标签云组件与服务
Author: QuantaBit Team
Latest version: 1.0.4

# @quantabit/tag-cloud-sdk

> QuantaBit Tag Cloud SDK - Tag cloud components and services

## Installation

```bash
npm install @quantabit/tag-cloud-sdk
# or
yarn add @quantabit/tag-cloud-sdk
```

## Quick Start

```javascript
import { /* components or methods */ } from '@quantabit/tag-cloud-sdk';

// Please refer to the API documentation for detailed usage
```

## Dependencies

This SDK depends on `@quantabit/sdk-config` for unified configuration management.
Make sure to initialize the configuration at application startup:

```javascript
import { initConfig } from '@quantabit/sdk-config';

initConfig({
  apiBaseUrl: 'https://your-api-domain.com/api/v1',
});
```

## License

MIT © QuantaBit
npm package: @quantajs/core
Description: A compact, scalable, and developer-friendly state management library designed for any JavaScript environment. It includes a reactivity system that enables efficient and flexible data handling, making complex state management easy.
Author: Jeel Gajera
Latest version: 2.0.0

# @quantajs/core

![QuantaJS Banner](https://raw.githubusercontent.com/quanta-js/quanta/master/assets/quantajs_banner.png)

[![CI](https://github.com/quanta-js/quanta/actions/workflows/ci.yml/badge.svg)](https://github.com/quanta-js/quanta/actions/workflows/ci.yml)

A fast, framework-agnostic reactivity and store engine for modern JavaScript apps.

## ✨ Why You'll Like It

- ⚡ Fast reactive updates with predictable behavior
- 🧠 Clean API for stores, watchers, computed values, and batching
- 🧱 Scales from tiny apps to complex state graphs
- 💾 Built-in persistence and migrations support
- 🛡️ Strong TypeScript experience

## 📦 Installation

```bash
npm install @quantajs/core
# or
pnpm add @quantajs/core
# or
yarn add @quantajs/core
```

## 🚀 Quick Start

```ts
import { createStore } from '@quantajs/core';

const counter = createStore('counter', {
    state: () => ({ count: 0 }),
    getters: {
        doubled: (s) => s.count * 2,
    },
    actions: {
        increment() {
            this.count++;
        },
    },
});

counter.increment();
console.log(counter.count); // 1
console.log(counter.doubled); // 2
```

## 🧩 Core Reactivity

```ts
import { reactive, computed, watch, batchEffects } from '@quantajs/core';

const state = reactive({ a: 1, b: 2 });
const sum = computed(() => state.a + state.b);

watch(
    () => sum.value,
    (next, prev) => {
        console.log('sum changed', prev, '->', next);
    },
);

batchEffects(() => {
    state.a = 10;
    state.b = 20;
});
```

## 💾 Persistence Example

```ts
import { createStore } from '@quantajs/core';
import { createLocalStorageAdapter } from '@quantajs/core/persistence';

const settings = createStore('settings', {
    state: () => ({ theme: 'light' as 'light' | 'dark' }),
    persist: {
        adapter: createLocalStorageAdapter('app-settings'),
        include: ['theme'],
    },
});
```

## 🛠️ Main Exports

- `createStore`, `useStore`
- `reactive`, `computed`, `watch`, `isReactive`, `batchEffects`
- Persistence APIs from `@quantajs/core/persistence`
- `logger`, `createLogger`, `LogLevel`

## 📌 Notes

- Store names must be unique in one runtime.
- Use `store.$destroy()` to remove runtime-created stores.

## 🤝 Contributing

Contributions are welcome. Open an issue or PR if you want to improve docs, APIs, tests, or performance.

## ⭐ Support

If QuantaJS helps your project, please star the repo:
https://github.com/quanta-js/quanta

## 📜 License

MIT
npm package: @quantajs/devtools
Description: DevTools for QuantaJS
Author: Jeel Gajera
Latest version: 2.0.0

# @quantajs/devtools

![QuantaJS Banner](https://raw.githubusercontent.com/quanta-js/quanta/master/assets/quantajs_banner.png)

[![CI](https://github.com/quanta-js/quanta/actions/workflows/ci.yml/badge.svg)](https://github.com/quanta-js/quanta/actions/workflows/ci.yml)

Powerful DevTools for QuantaJS with real-time state inspection and action/event tracking.

## ✨ Why You'll Like It

- 🔍 Live store state explorer
- 🧾 Action timeline with payload inspection
- 🛡️ Safe serialization for complex/circular objects
- 🔌 Simple mount API for any app setup

## 📦 Installation

```bash
npm install @quantajs/devtools @quantajs/core
# or
pnpm add @quantajs/devtools @quantajs/core
# or
yarn add @quantajs/devtools @quantajs/core
```

## 🚀 Quick Start

```ts
import { createStore } from '@quantajs/core';
import { mountDevTools } from '@quantajs/devtools';

createStore('counter', {
    state: () => ({ count: 0 }),
    actions: {
        increment() {
            this.count++;
        },
    },
});

const cleanup = mountDevTools(); // auto-detects dev mode
```

## ⚙️ Mount with Options

```ts
import { mountDevTools } from '@quantajs/devtools';

mountDevTools({ visible: true });
mountDevTools({ target: '#devtools-root' });
mountDevTools({
    target: document.body,
    onError(error) {
        console.warn('DevTools mount issue:', error.message);
    },
});
```

### `DevToolsOptions`

```ts
interface DevToolsOptions {
    visible?: boolean;
    target?: HTMLElement | string;
    onError?: (error: Error) => void;
}
```

## 🛠️ Exports

- `mountDevTools(options?)`
- `DevTools` (Preact component)

## ⚛️ React Users

If you use `@quantajs/react`, you can render `QuantaDevTools` directly from that package.

## 🤝 Contributing

Contributions are welcome. Share bug reports, DX feedback, and UI/UX improvements through issues and PRs.

## ⭐ Support

If QuantaJS helps your team, please star the repo:
https://github.com/quanta-js/quanta

## 📜 License

MIT
npm package: @quantajs/react
Description: React integration for QuantaJS - A compact, scalable, and developer-friendly state management library for React applications.
Author: Jeel Gajera
Latest version: 2.0.0

# @quantajs/react

![QuantaJS Banner](https://raw.githubusercontent.com/quanta-js/quanta/master/assets/quantajs_banner.png)

[![CI](https://github.com/quanta-js/quanta/actions/workflows/ci.yml/badge.svg)](https://github.com/quanta-js/quanta/actions/workflows/ci.yml)

React bindings for QuantaJS with stable subscriptions, smart selectors, and ergonomic provider usage.

## ✨ Why You'll Like It

- ⚛️ React-friendly subscription model
- 🎯 Selector hooks for minimal re-renders
- 🧠 Great TypeScript inference and DX
- 🔌 Works directly with QuantaJS core APIs

## 📦 Installation

```bash
npm install @quantajs/react @quantajs/core
# or
pnpm add @quantajs/react @quantajs/core
# or
yarn add @quantajs/react @quantajs/core
```

## 🚀 Quick Start

```tsx
import React from 'react';
import { createStore, QuantaProvider, useStore } from '@quantajs/react';

const counterStore = createStore('counter', {
    state: () => ({ count: 0 }),
    actions: {
        increment() {
            this.count++;
        },
    },
});

function Counter() {
    const counter = useStore('counter');

    return (
        <button onClick={() => counter.increment()}>
            Count: {counter.count}
        </button>
    );
}

export default function App() {
    return (
        <QuantaProvider stores={{ counter: counterStore }}>
            <Counter />
        </QuantaProvider>
    );
}
```

## 🎯 Selector Example

```tsx
import { useQuantaSelector } from '@quantajs/react';

function CounterValue({ store }: { store: any }) {
    const count = useQuantaSelector(store, (s) => s.count);
    return <span>{count}</span>;
}
```

## 🧪 Component-Scoped Store

```tsx
import { useCreateStore } from '@quantajs/react';

function DraftEditor() {
    const draft = useCreateStore(
        'draft-editor',
        () => ({ text: '' }),
        undefined,
        {
            setText(value: string) {
                this.text = value;
            },
        },
    );

    return (
        <textarea
            value={draft.text}
            onChange={(e) => draft.setText(e.currentTarget.value)}
        />
    );
}
```

## 🛠️ Main Exports

- Hooks: `useQuantaStore`, `useQuantaSelector`, `useStore`, `useStoreSelector`, `useCreateStore`, `useWatch`, `useComputed`
- Components: `QuantaProvider`, `QuantaDevTools`
- Core re-exports: `createStore`, `reactive`, `computed`, `watch`, `logger`

## 📌 Notes

- `QuantaProvider` expects `stores={{ [name]: store }}`.
- `useStore(name)` and `useStoreSelector(name, selector)` use that exact key.

## 🤝 Contributing

Contributions are welcome. If you spot docs gaps, edge-case hook behavior, or type improvements, open an issue/PR.

## ⭐ Support

If QuantaJS helps your app, please star the repo:
https://github.com/quanta-js/quanta

## 📜 License

MIT
npm package: @quantalytix/react-dropdownbox
Description: A lightweight react select box that allows for nested and grouped results.
Author: quantalytix
Latest version: 1.0.8

# react-dropdownbox

> 

[![NPM](https://img.shields.io/npm/v/@quantalytix/react-dropdownbox.svg)](https://www.npmjs.com/package/@quantalytix/react-dropdownbox) [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)

## Install

```bash
npm i @quantalytix/react-dropdownbox
```
## Demo Screenshot

![ScreenShot](/docs/img/dropdown-sample.png)

## Usage

```jsx
import React, { Component } from 'react'

import ReactDropdown from '@quantalytix/react-dropdownbox'
import '@quantalytix/react-dropdownbox/dist/index.es.css'

class Example extends Component {
  render () {
    const sampleList = [
      {
        key: 1, text: 'Fictional Characters', value: 'Fictional Characters', children: [
          { key: 1, text:'Joker', value: 'Joker' },
          { key: 2, text:'Batman', value: 'Batman' },
          { key: 3, text:'Robin', value: 'Robin' },
          { key: 4, text:'Two-Face', value: 'Two-Face' },
          {
            key: 5, text:'Not a Superhero', value: 'Not a Superhero', children: [
              { key: 1, text:'Koolaid Man', value: 'Koolaid Man' },
              { key: 1, text:'Koolaid Woman', value: 'Koolaid Woman' },
              { key: 1, text:'Koolaid Woman Twin', value: 'Koolaid Woman Twin' },
              { key: 2, text:'Joe Dirt', value: 'Joe Dirt' },
            ]
          },
        ]
      },
      {
        key: 2, text:'Real People', value: 'Real People', children: [
          { key: 2, text:'Jenn', value: 'Jenn' },
          { key: 3, text:'Will', value: 'Will' },
          { key: 3, text:'Chris', value: 'Chris' },
          { key: 3, text:'Bradley', value: 'Bradley' },
          { key: 3, text:'Ben', value: 'Ben' },
          { key: 3, text:'Min', value: 'Min' },
          { key: 3, text:'Luke', value: 'Luke' }          
        ]
      }
    ]

    return (
      <ReactDropdown data={sampleList} placeholder='search or select' initialValue='Fictional Characters' onSelect={()=>{}}/>
    )
  }
}
```

## License

MIT © [quantalytix](https://github.com/quantalytix)