Skip to content

b12480

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 17 Nov 19:11
7f106b5

ui: Llama UI design system: tokens, surfaces and fonts (#32468)

  • ui: bring @ggml-org/llama-ui into ui/lib/ui

The design system package (tokens, fonts, surfaces, components and Model UI), so far in the temporary ggml-org/llama-ui
repository at edaf518, moves to its home in ui/lib/ui, built with @sveltejs/package and published as @ggml-org/llama-ui
from here. ui/lib holds the packages, one folder each. Its references to tools/ui now name ui/apps/chat, its
package.json points at this repository, and the UI workflow type-checks and packs it. ui/README.md describes the
layout.

Assisted-by: Claude (Opus 5.5 Medium)

  • ui: Llama UI design system: tokens, surfaces and brand

The design system from allozaur/docs/storybook-overhaul: three tiers of
tokens, matte glass surfaces, Llama Sans and Llama Mono, and the base
components on the new tokens (Tabs and GlassKey among them). It also
restyles the stack's features with it, replacing the plain stand-ins they
used until now. DESIGN.md is generated from the tokens. The Storybook that
documents it is the next PR.

Assisted-by: Claude (Opus 5.5 Medium)

  • ui: have Llama Chat use @ggml-org/llama-ui for its base components, tokens and fonts

Llama Chat kept its own copy of the design system: 29 base components, the
three tiers of tokens, the surfaces, the theme and the fonts, next to the 12
components ui/lib/ui held. The copy goes, and the library gets what it lacked.

ui/lib/ui

  • the 17 base components the app had and the library did not (alert,
    alert-dialog, button-group, checkbox, collapsible, context-menu, dialog,
    drawer, dropdown-menu, empty, hover-card, radio-group, scroll-area,
    skeleton, table, tabs, textarea), with vaul-svelte for the drawer
  • the inset-group and selected-row tokens and surfaces
  • sources import each other by relative path instead of $lib, which in an
    app points at the app's own src/lib
  • theme.css no longer imports tw-animate-css: it is a peer dependency that
    the consumer imports before the theme, as it does Tailwind
  • 0.3.0

ui/apps/chat

  • imports the base components as @ggml-org/llama-ui/ui/ and cn/tv as
    @ggml-org/llama-ui/utils; app.css imports the library's theme.css
  • compiles the library from source, with no install or build of it:
    scripts/vite-plugin-llama-ui.ts resolves its entry points and what it
    imports, and svelte.config.js gives TypeScript the same paths
  • src/lib/components/ui, styles/tokens, styles/surfaces.css and assets/fonts
    are removed; components.json moves to the library

Builds

  • CMake stages ui/lib/ui next to the app, keeping the layout of ui/, and
    rebuilds when a library source changes
  • the Dockerfiles copy the library's sources; the Nix derivation takes ui/
    as its source

The built CSS has the same rules in the same order, apart from one
zero-specificity rule and the @font-face rules moving, plus ten utilities
and two tokens that only the library's own components use.

Assisted-by: Claude (Opus 5.5 Medium)

  • ui: AGENTS.md places Llama UI in ui/lib/ui

Llama Chat's AGENTS.md says where each part lives: Llama UI is
ui/lib/ui, and Chat imports its tokens, fonts and base components
from there.

Assisted-by: Claude (Opus 5.5 Medium)

  • ui: Llama Sans and Llama Mono from llama-brand's latest, and shell commands marked in bash code

The fonts in ui/lib/ui come from llama-brand's latest, with optical sizes
from 10 to 36. Bash code blocks mark shell commands and flags.

Assisted-by: Claude (Opus 5.5 Medium)

  • ui: open submenus outside the menu they come from

A submenu was rendered inside its parent menu, so the menu's scroll box
clipped it: the glass menus' backdrop filter, and the filter and transform
of the open animation, make the menu the containing block even for the
fixed-position submenu. Dropdown and context submenus now render in a
portal, like the menus themselves.

Assisted-by: Claude (Opus 5.5 Medium)

  • ui: draw submenus like the menu they open from

Submenus had smaller corners than their menus, and context menus had none
of the dropdown's glass. Context-menu parts now match the dropdown's, and
both submenus take the menu's corners and height cap, with their first row
level with the row that opens them, 4px past the menu's edge. Sub-triggers
take the items' radius and pointer.

The submenus' height cap and zoom origin named the dropdown's CSS variables,
which bits-ui does not set on submenus; they now use its --bits-menu-* ones.
The chat group submenu takes the actions menu's z-[999999] layer, as it no
longer renders inside that menu.

Assisted-by: Claude (Opus 5.5 Medium)

  • ui: keep a late current-node write off a closed or switched conversation

updateCurrentNode checked the active conversation, awaited the database write, then wrote currNode to whatever was active after it. When the conversation closed during the write it threw, and the reply ended in a streaming error dialog. When another conversation opened, that one got the wrong node.

Assisted-by: Claude (Fable 5.2)

  • ui: have Llama Chat use the library's Model UI and app components

Llama Chat still kept its own copies of what the library holds above the
base components. It now takes them from @ggml-org/llama-ui too, and its
copies go.

ui/lib/ui

  • ModelId gains what Chat's had: the model's own draft kind, draft
    sidecars with their quant (ModelDraftSidecars, new), aliases, hideName
    and a tooltip, in the same badge order
  • entry points for them, like ui/: @ggml-org/llama-ui/app/
    (actions, content, forms, misc) and @ggml-org/llama-ui/models

ui/apps/chat

  • ActionIcon, SearchInput, SyntaxHighlightedCode, Logo,
    ModelCapabilityIcons, ModelDownloadProgressBar and ModelDraftSidecars
    come from the library; Chat's copies and the two constants only they
    used are removed
  • ModelId and ModelOrgAvatar stay as thin wrappers: ModelId parses the raw
    id and applies the user's display settings, ModelOrgAvatar hides the
    avatar while Hub metadata is off
  • the svelte/* TypeScript path falls back to Svelte's types/index.d.ts:
    svelte/reactivity has no file of its own, so a library source importing
    it got its types from ui/lib/ui's own install when there was one

Assisted-by: Claude (Opus 5.5 Medium)

  • ui: Llama UI takes the brand's colours and logo from llama-brand

@ggml-org/llama-brand is now a dependency of the library, by the same GitHub
tarball Llama Chat already installs, which now names it @ggml-org/llama-brand
too.

  • primitives.css drops the 25 tokens it held copies of (the neutral
    greys, sand, the skies and cinder) and builds on llama-brand's
    css/colors.css instead; the skies' gradients point at llama-brand's.
    Apps import that file before theme.css, as they do Tailwind and
    tw-animate-css: the library's stylesheets import no package, so an app
    that compiles them from source resolves it from its own node_modules
  • Logo draws llama-brand's icon, in currentColor, and assets/logo.svg goes
  • Llama Chat's TypeScript paths resolve llama-brand from its own
    node_modules, like the library's other dependencies

The fonts stay as the library's WOFF2 copies until llama-brand ships
WOFF2 builds of them.

Assisted-by: Claude (Opus 5.5 Medium)

  • ui: have Llama Chat take the library's constants, enums and helpers

Llama Chat redefined most of what the library exports next to its
components. Where the two were the same, Chat now re-exports the library's
from the files that held them, so its own imports stay as they are.

  • the library gets entry points for them: @ggml-org/llama-ui/constants,
    @ggml-org/llama-ui/enums and @ggml-org/llama-ui/code, and
    @ggml-org/llama-ui/models carries the model data with the Model UI
  • from the library now: the shared CSS classes and code-block constants,
    the byte units, the memory-fit constants and minMemoryTierGb, the bit
    depth labels, the capability and modality icons, labels and order,
    ColorMode, TooltipSide, BooleanString, the model enums, ModelModalities,
    formatParameters, highlightCode and trimCodePadding
  • the library's modality order follows Chat's: vision, video, audio
  • Chat keeps its own where they differ: UI_DATA_ATTRS and
    ModelDownloadProgress are supersets of the library's (the latter extends
    it now), and formatFileSize counts in 1024s

Assisted-by: Claude (Opus 5.5 Medium)

  • ui: give the chat form's add key and model selector a tighter shadow

In light, the two keys inside the chat form, white on its white glass, took
the control elevation, whose soft spread blended into the form. They take a
new elevation-key instead: a 0.5px hairline all round and a 1px drop. In
dark they keep the control elevation. Chosen from the options in
Scrapbook › UI › Composer keys.

  • semantic tokens: --elevation-key (light: the hairline and the drop; dark:
    the control elevation)
  • component token: --chat-form-key-shadow, for the add key and every model
    selector trigger
  • DESIGN.md names it next to the other elevations

Assisted-by: Claude (Opus 5.5 Medium)

Website:

Attestations:

macOS/iOS:

Linux:

Android:

Windows:

openEuler:

  • DISABLED
  • openEuler x86 (310p)
  • openEuler x86 (910b, ACL Graph)
  • openEuler aarch64 (310p)
  • openEuler aarch64 (910b, ACL Graph)

UI: