ansiq

ansiq 是推荐新用户首先依赖的总包。

如果你只想尽快写出一个应用，而不是一开始就理解 crate 分层，用它最合适。

什么时候用 ansiq

适合：

• 第一次接触 Ansiq
• 写教程、示例、小型应用
• 想用一个依赖拿到最常见入口

不适合：

• 你已经明确知道自己只需要某个低层 crate
• 你在做框架集成或贡献，需要更精确地控制分层

推荐导入方式

use ansiq::prelude::*;
use ansiq::{run_app, view};

这两行覆盖了大多数入门应用需要的东西。

顶层导出了什么

最常用的入口直接在顶层：

• App
• RuntimeHandle
• run_app
• run_app_with_policy
• Viewport
• ViewportPolicy
• signal
• computed
• effect
• Cx
• ViewCtx
• Element
• IntoElement
• Rect
• Color
• Style
• view

prelude 里有什么

ansiq::prelude::* 主要放高频使用项：

• App, RuntimeHandle, ViewCtx
• signal, computed, effect
• Color, Style, Rect
• Element, IntoElement
• 常用 widgets：Box, Block, Text, Paragraph, Input, List, Tabs, Table, ScrollView, Scrollbar, Shell, StatusBar
• 常用 state：ListState, TableState, ScrollbarState

它的目标是让“第一个应用”尽量短，而不是替代全部 API。

什么时候切回子 crate

如果你开始需要：

• 只依赖某个边界更清晰的低层模块
• 查更精确的 crate 责任
• 在大型应用里明确依赖层次

就可以切回：

• ansiq-core
• ansiq-runtime
• ansiq-surface
• ansiq-widgets

ansiq 是入口，不是对底层 crate 的替代。