@vlian/framework

Secra Framework - kernel-only runtime package

简介

@vlian/framework@2.0.0 开始只保留 kernel 运行时能力。根入口 @vlian/framework 与子路径 @vlian/framework/kernel 都只导出 kernel API，历史上的 utils、state、library、components、analytics 已从当前版本移除。

安装

pnpm add @vlian/framework i18next @vlian/logger @vlian/utils

快速开始

import { getKernel, startup } from '@vlian/framework';
import { registerThemeManager } from '@vlian/framework/theme';

const kernel = await startup({}, 'app');

await registerThemeManager(kernel, {
  initial: {
    mode: 'light',
  },
});

导出范围

• @vlian/framework
• @vlian/framework/kernel
• @vlian/framework/theme
• @vlian/framework/i18n

@vlian/framework 与 @vlian/framework/kernel 导出相同的 kernel API，包括 Kernel、startup、getKernel、kernelStartApp 以及相关类型。 theme、i18n 改为独立子路径导出，按需从 @vlian/framework/theme、@vlian/framework/i18n 引入并注册到 kernel，可让消费方在 Vite 打包时获得更稳定的分包边界。

迁移说明

• 删除所有 @vlian/framework/utils、@vlian/framework/state、@vlian/framework/library、@vlian/framework/components、@vlian/framework/analytics 的导入。
• 旧模块如果仍有业务价值，需要迁移到应用侧或拆分为独立包维护。
• theme、i18n 不再从根入口或 kernel 入口聚合导出；需要时请显式从 @vlian/framework/theme、@vlian/framework/i18n 引入并注册自定义管理器。
• 推荐围绕 kernel manager 收口日志、缓存，以及按需挂载的主题和国际化能力。

依赖要求

• i18next: ^23.0.0 || ^24.0.0 || ^25.0.0
• @vlian/logger: ^0.1.0
• @vlian/utils: ^2.0.1

许可证

Apache-2.0

相关链接

• 变更日志
• Codex/AI 协作文档