jaspr-styling

用途：为 Jaspr 组件编写类型安全的 CSS-in-Dart 样式，主要面向组件样式、主题实现和 CSS 属性使用。核心能力：通过 Styles 类提供原生类型安全样式 API；支持组件级 @css 注解（静态 getter 返回 List<StyleRule>）、内联样式、全局 @css 样式以及全局外部样式表。使用方式：组件级样式需在静态 getter 上使用 @css，并用具体选择器（如 .main、#id）避免样式泄漏；内联样式仅用于动态样式，静态样式须用 @css，媒体查询、悬停、动画不得用内联；全局 @css 仅支持 server 和 static 模式，置于顶层或静态 getter；原始 .css 或 sass/scss、tailwind 等需通过 Document(head: [...]) 的 link 元素（server/static）或 web/index.html（client）引入。Styles 支持盒模型、Flexbox、Grid、文本、背景等属性，属性须按类定义顺序书写，可用点简写（如 padding: .all(10.px)、justifyContent: .center），不支持的属性用 raw。限制：@css 为全局作用域需谨慎命名；全局 @css 不支持 client 模式；内联样式不支持复杂规则与动画。编写特定区域样式前须阅读对应 reference 文件（sizing、color、box、typography、flexbox、grid、animation）。