Repository navigation
Design system v0.9.3
Three additions since ds-v0.9.2 (#42): the Solara adapter resolves a skin and a palette, every packaged weight is a token, and the Python side has tests. No React component changes. Portals pinning ds-v0.9.2 upgrade for the resolvers and the guide; each portal's migration PR moves its skin lookup onto theme.skin() and converts its own weight literals.
theme.skin(resources, default, requested) takes the value of a portal's skin setting and returns a Skin holding the name and text of the stylesheet it names. The lookup that produces the value is the portal's — <APP>_SKIN else KBASE_SKIN today — and the package reads no environment. none selects nothing and the text is ""; None or blank selects the portal's declared default; a bare name reads resources/<name>.css from the portal's package; a path is read from disk on every call. A name with no file falls to the default rather than refusing the page, and Skin.note carries the reason for the portal's doctor to print.
theme.tokens(skin_css, scheme) resolves every opaque colour token to hex for one scheme, with a skin's overrides carried through the oklch(from var(--x) …) derivations, for code that draws outside the page's CSS: a plot rendered on the server, an SVG in a sandboxed iframe. The four translucent tokens are omitted: each carries an alpha, so it has no single hex until it is drawn over something. theme.vuetify() reads the same table and returns what ds-v0.9.2's did.
The sheets. Every font-weight is var(--fw-normal) or var(--fw-bold); only 400 and 700 are loaded, so the literal 600s rendered as 700 and the token states the weight that rendered. Fira Code's import loads 400;700 — ds-v0.9.2 loaded 400;500, so the browser had no bold face for code and synthesised one. --w-page: 1180px is the portals gallery's column. .v-btn.kb-row is square: the named-class reset's border-radius: inherit had handed a row inside a flush Frame the Frame's radius. prose.css gives h5 and h6 fallbacks — h5 at --fs-4, h6 the same in --c-ink3 — where they had rendered at h4's size; the utilities stay .h1–.h4.
Tests run against an install (pip install '.[dev]', pytest), because the name they import, kbase_design_system, exists only in one; the wheel job installs the wheel it just built and runs them. theme.tokens() agrees with Chromium within one unit per channel for all 59 tokens in both schemes.
solara/MIGRATING.md §2 requires the dependency in [project.dependencies] from the first migration PR; the optional extra, its guard and the stop-line PR are gone. A portal serves three kinds of look through its skin setting — none, a kbase sheet that sets only the portal's gallery colour, and any number of brands — and a new invariant puts a literal weight beside a literal hex. §9's matrix is none × every shipped skin × light and dark, for every PR, and the PR body opens with whatever the PR leaves outstanding.