@glasshome/ui

中文文档
1.40.0发布于 2026/11/16MITTypeScriptES Module构建来源已验证近 30 天下载 3377

用于 GlassHome 的 SolidJS 组件库, 建于 Kobalte 上

中文使用文档
文档目录9 节
  1. 安装
  2. 入境点
  3. @glasshome/ui 公用事业和地表食谱
  4. @glasshome/ui/solid - 构成部分
  5. @glasshome/ui/tokens - 设计符号作为数据
  6. 天体
  7. @glasshome/ui/styles - 有尾风 v4 CSS
  8. 发展
  9. 许可证

@ glasshome/ ui (英语)

用于 GlassHome 的 SolidJS 组件库, 以 科巴尔特。 。 。 .

70+可访问,有主题意识的组件外加框架-不可知的设计符号和Tailwind v4 CSS预设,所有你需要建造的智能家庭仪表板. 权力 格拉斯之家本地首个家庭助理仪表板.

整个图书馆都使用单一的玻璃材料(.glass 键入 --glass-* no. SPEC.md 是设计-系统合同;活廊bun run dev:gallery)是其可执行的形式.

安装

bun add @glasshome/ui solid-js @glasshome/sync-layer
# or
npm install @glasshome/ui solid-js @glasshome/sync-layer

同伴依赖性 :

软件包需要时间
solid-js ^1.9所有东西都放在下面 /solid
@glasshome/sync-layer/solid 仅(实体选择器、区域选择器、演示模式帮助器)

软件包是 仅限无害环境管理 以及载有在捆绑器和节点16+模块分辨率下解决的类别声明的现代无害环境管理船舶。 节点 >=20。 。 。 .

入境点

@glasshome/ui 公用事业和地表食谱

框架-不可知根:对被制裁的玻璃表面的类-字符串配方,安全地从Solid组件无法运行的服务器代码(如Astro前题)导入.

import { cn, buttonVariants, CARD_SURFACE, ALERT_TONES, OVERLAY_SURFACE } from "@glasshome/ui";

const cls = cn("px-4 py-2", condition && "text-white");
const btn = buttonVariants({ variant: "outline", size: "sm" });

@glasshome/ui/solid - 构成部分

所有组件都从一个子路径导出.

import { Button, Card, CardHeader, CardTitle, CardContent, Badge } from "@glasshome/ui/solid";

function DeviceCard() {
  return (
    <Card>
      <CardHeader>
        <CardTitle>Living Room</CardTitle>
        <Badge tone="var(--success)">Online</Badge>
      </CardHeader>
      <CardContent>
        <Button onClick={() => console.log("toggled")}>Toggle Light</Button>
      </CardContent>
    </Card>
  );
}

组成家庭: Accordion • 妇女 Alert • 妇女 AlertDialog • 妇女 AreaPicker • 妇女 AspectRatio • 妇女 Avatar • 妇女 Badge • 妇女 BottomSheet • 妇女 Breadcrumb • 妇女 Button • 妇女 ButtonGroup • 妇女 Card • 妇女 Carousel • 妇女 Charts (AreaChart, BarList, StackedBar, RangeToggle) • 妇女 Checkbox • 妇女 Collapsible • 妇女 ColorSlider • 妇女 ColorWheel • 妇女 ContextMenu • 妇女 CopyButton • 妇女 CountPill • 妇女 DataTable (TableSearchInput, TableFilterSelect, TableSortHeader, TableSkeleton, TableEmpty, TableError, TableBulkBar) • 妇女 Dialog • 妇女 Dock • 妇女 DropdownMenu • 妇女 Empty • 妇女 EntitySelector • 妇女 Field • 妇女 Form • 妇女 HeroAction • 妇女 HoverCard • 妇女 IconPicker • 妇女 ImagePicker • 妇女 Input • 妇女 InputGroup • 妇女 InputOTP • 妇女 Item • 妇女 Kbd • 妇女 Label • 妇女 Logo • 妇女 MediaTile • 妇女 NumberField • 妇女 OptionCard • 妇女 Overlay • 妇女 PageHeader • 妇女 Pagination • 妇女 PasswordInput • 妇女 PickerSearch • 妇女 Popover • 妇女 Progress • 妇女 RadioGroup • 妇女 Resizable • 妇女 ResponsiveDialog • 妇女 SchemaForm • 妇女 ScopeIndicator • 妇女 ScrollArea • 妇女 SectionCard • 妇女 Select • 妇女 SelectionScope (SelectionHighlight) • 妇女 Separator • 妇女 SettingsRow (SwitchRow, LabeledField, LabeledInput, LabeledIconPicker, RowActions, SectionAddButton, SectionEmpty) • 妇女 Sheet • 妇女 Skeleton • 妇女 Slider • 妇女 SlidingIndicator (deprecated) • 妇女 Sonner (toast) • 妇女 Spinner • 妇女 StepIndicator • 妇女 Switch • 妇女 Table • 妇女 Tabs • 妇女 Textarea • 妇女 TierBadge • 妇女 Toggle • 妇女 ToggleGroup • 妇女 Tooltip • 妇女 WidgetCard • 妇女 WidgetIdentity • 妇女 WidgetTrustBadge

Badge 纯玻璃 : tone 取任何 CSS 颜色( R)<Badge tone="var(--success)">;没有固体变体徽章.

@glasshome/ui/tokens - 设计符号作为数据

无框架主题模型:预设, oklch 解析/ 解析, 以及 oklch- hex 转换( gamut- maped, 用于无法解析 oklch 的渲染器) 。 在节点脚本,服务器中安全,并构建工具.

import { THEME_PRESETS, DEFAULT_THEME_ID, resolveThemeColors, oklchToHex } from "@glasshome/ui/tokens";

天体

.astro 文件导入 @glasshome/ui/solid 像任何Solid文件一样。 包裹的源头是 solid 导出条件, 因此 Astro 的 Solid 集成会编译它用于服务器; 一个组件没有 client: 指令生成静态的 HTML, 没有发送运行时间 .

@glasshome/ui/styles - 有尾风 v4 CSS

@import "@glasshome/ui/styles";

提供玻璃材料,设计标志(彩色,光线,动画),以及Tailwind v4主题层. @glasshome/ui/styles/theme 单独曝光符号调色板.

发展

bun install
bun run dev:gallery   # live component gallery on :5199, hot-reloads against src
bun run test          # vitest unit + render smoke tests
bun run lint          # biome
bun run check:tokens  # theme.css <-> tokens/presets.ts sync guard
bun run check:types   # typecheck src + tests
bun run build         # dist ESM + declarations
bun run check:publish # publint + arethetypeswrong

许可证

麻省理工学院

版本与发布记录

@glasshome/ui 共发布 84 个版本,首次发布于 2026/03/23;过去 12 个月发布了 84 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.40.0latest2026/11/16今天
1.39.02026/11/079 天前
1.38.02026/11/079 天前
1.37.22026/11/0610 天前
1.37.12026/11/0610 天前
1.37.02026/11/0610 天前

关于 @glasshome/ui 的常见问题

@glasshome/ui 是什么?

用于 GlassHome 的 SolidJS 组件库, 建于 Kobalte 上

如何安装 @glasshome/ui?

在项目目录运行 npm install @glasshome/ui,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:solid-js(^1.9.9)、tailwindcss(^4.1.13)、tw-animate-css(^1.4.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@glasshome/ui 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@glasshome/ui 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@glasshome/ui 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@glasshome/ui 可以商用吗?

@glasshome/ui 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@glasshome/ui 的下载量有多少?

根据 npm 官方下载统计,@glasshome/ui 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,377 次,日均约 113 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@glasshome/ui 还在维护吗?

最新版本 1.40.0 发布于 2026/11/16(今天);至今共发布 84 个版本,其中过去 12 个月发布了 84 个;首次发布于 2026/03/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。