Changelog

Breaking changes may continue until v1.0, so all notable changes are documented here.

lism-css v.0.25.0 (2026.08.06)

Structural variables can now be overridden from lism.config (#530)

• Moved --L / --C / --fz-mol / --hl-unit / --s-unit into a new vars token group, so they can be overridden via tokens in lism.config.
• Moved the shadow color --shadow into color.shadow (the CSS variable name is unchanged).

Directional spacing props are now class-based in main.css (#531)

• All 18 directional spacing props (ps / pe / pl / pt / ms / mt / cg / rg, etc.) now emit token classes such as -ps:20 and breakpoint classes such as -pl_sm in main.css.
• As a result, main.css grew by about 1.5KB (gzipped). The size of full.css is unchanged.

Expanded color Property Classes (#533)

• -c:keycolor / -bgc:keycolor / -bdc:keycolor are now emitted in main.css.
• In full.css, all color tokens are now class-based for c / bgc / bdc (e.g. -bgc:red).
• Added -bgc:current (currentColor).

Other

• Fixed set--plain losing to the default form styles for input on specificity. (#537)
• Added .browserslistrc and removed unnecessary vendor prefixes.

@lism-css/plugin v.0.4.2 (2026.08.06)

• Aligned color Property Class generation with the union of color and palette, so the full.css build output matches the runtime resolution rules. (#533)
• Added loadDefaultConfig() for callers that only need the pre-merge default config. (#539)

@lism-css/ui v.0.25.0 (2026.08.06)

• A follow-up release for lism-css v0.25.0. No component changes.

lism-css v.0.24.1 (2026.08.04)

• Fixed a conflict that prevented border Property Classes (.-bd etc.) from working in full.css. (#513)
• Fixed an issue where UA-derived text-align (button) and letter-spacing (form elements) were not being reset. (#516)
• Removed the l value from the flow token in tokens.ts, as it was not implemented in CSS.
• Updated dependencies and cleaned up internal type definitions. (No API changes)

@lism-css/ui v.0.24.1 (2026.08.04)

• A follow-up release for lism-css v0.24.1. No component changes.
• Updated dependencies.

@lism-css/plugin v.0.4.1 (2026.08.04)

• Export lismConfigAlias from @lism-css/plugin/vite (#521)
• Updated dependencies (Dependabot alert fixes) (#509)

lism-css v.0.24.0 (2026.07.06)

• Derive config values (utils / presets / token) into component-side autocompletion (#505)
• Add LismConfig type for authoring lism.config (#472)
• Add display: flow-root to body to prevent extra vertical scrolling caused by margin collapse
• Change default styles for pre (removed background-color / padding) (#477)
• Exclude coverLink inside boxLink and adjust stacking order

AI skills overhaul (#459)

• Enhanced and streamlined lism-css-guide, and added a new lism-css-refactor skill for refactoring
• Improved implementation accuracy: separated verification into subagents and structurally prevented check skipping (#469, #473)
• Expanded the antipatterns collection (#488)

@lism-css/plugin v.0.4.0 (2026.07.06)

• Support loading lism.config.ts (TypeScript config files) (#461)
• Derive types from config values (utils / presets / token) for component-side autocompletion (#505)
• purge: scan and rewrite references in server output for Astro SSR / hybrid setups (#495)
• purge: stricter hash detection and byte-accurate size reports (#503)

@lism-css/ui v.0.24.0 (2026.07.06)

• Follow-up release for lism-css v0.24.0 (no functional changes to components)
• Added unit tests for Accordion / Modal / Tabs (#365)

lism-css v.0.23.0 (2026.06.19)

This release contains breaking changes.

Split the build/plugin layer into @lism-css/plugin (#439)

• Separated the Vite / Astro integration, purge, and the npx lism-css build CLI from the core, moving them into the new @lism-css/plugin package
• Removed exports such as lism-css/vite, lism-css/purge/*, and lism-css/vite-plugin

Unified tokens into a single value-bearing source (#434)

• Consolidated tokens into a flat “key: value” map (defining values, generating utilities, and accepting props in one place)
• Removed the tokenValues channel, renamed c to color, and removed the fz.root / writing tokens

Breakpoints / full build

• Added xs breakpoint support (opt-in for both CSS output and types) (#428)
• Added full.css / full_no_layer.css (all props extended up to the lg breakpoint) and isFullMode (#423, #425)
• Expanded the default standard-support breakpoint from md to lg

Other

• Added hl="0" and migrated lh to the recommended hl property (#437)
• Revised the default font families (--ff--base / --ff--accent)
• Removed redundant explicit bp:0 on props (output unchanged)

@lism-css/plugin v.0.3.0 (2026.06.19)

New package. Provides the build / framework-integration layer for lism-css.

• Dynamic build plugin that makes lism.config.js the single source of truth for CSS output (lismCss() / lismCssAstro())
• Lightweight CSS purge (@lism-css/plugin/purge/vite / /astro, or purge: true on the integrated plugin)
• Next.js 16 (@lism-css/plugin/next) / WordPress (@lism-css/plugin/wordpress) adapters
• Auto-generates lism-env.d.ts from breakpoints

@lism-css/ui v.0.23.0 (2026.06.19)

• Migrated lh to the recommended hl property in Badge / Button / Chat (following the hl addition in lism-css v0.23.0)
• Moved the CSS build layer to @lism-css/plugin’s compileCssTree

lism-css v.0.22.2 (2026.06.03)

• Slightly adjusted the saturation of the --green color token
• Changed the alert icon in Icon presets to an octagon (warning-octagon) style

@lism-css/ui v.0.22.2 (2026.06.03)

• Added a tip preset to Alert / Callout (an alias of point)
• Unified and reorganized Alert / Callout presets (added info to Callout, changed note to gray, added note to Alert)
• Fixed the body Flow of Alert to use w="100%", correcting the layout when layout="withSide"

lism-css v.0.22.1 (2026.05.30)

• Treat a bare : as a true-equivalent flag (for paths that can’t pass a boolean, such as text form inputs)
• Fix 0.22.0 packaging issues (corrected ./config / ./default-config targets and distributed files)
• Remove the deprecated ./next-js/* export

@lism-css/ui v.0.22.1 (2026.06.02)

• Added a default hov="-bgc" to NavMenu.Link (so a background color appears on hover)
• Added an isOpen prop to Accordion.Item to allow expanding by default (also adjusted the toggle icon)
• Prevented horizontal layout shift caused by the scrollbar disappearing when a Modal opens (#413)

lism-css v.0.22.0 (2026.05.28)

This release contains breaking changes.

AutoColumns default mode change (#408)

• Changed the default mode of AutoColumns from auto-fit to auto-fill

Utility and token renaming

• Renamed u--cells to u--enclose (#412)
• Reorganized table cell variables under --cells-p (#410)
• Restructured --gutter-size into --gutter / --gutter--base (#409)
• Removed the --under-offset variable; set text-underline-offset and tab-size directly on body

Form control style adjustments

• Removed border-radius from form controls
• Changed form control padding to em units

Other

• Reorganized and adjusted logo icon sizes

@lism-css/ui v.0.22.0 (2026.05.28)

• Catch-up release for lism-css v0.22.0

lism-css v.0.21.0 (2026.05.26)

This release contains breaking changes.

Renamed set classes (#404)

• Reverted the set--var:xxx format back to set--xxx (set--var:hov → set--hov, set--var:bxsh → set--bxsh, set--var:bdrsInner → set--bdrsInner, set--var:s → set--s)
• The set prop value is also updated accordingly (e.g., set="var:hov" → set="hov")
• No backward-compatibility aliases are provided since this is still a beta release

Added contentSize Prop and set—bleed (#405)

• Added contentSize as a Lism Prop (preset values s / m / l / xl output as classes, arbitrary values as CSS variables)
• Added set--bleed to the core CSS, providing --bleed variable generation for one-sided bleed layouts
• Reorganized the Wrapper component around the isWrapper + contentSize combination

Other

• Added isWrapper="xl" preset support
• Added breakpoint support (bp: 1) for pos and order properties
• Added label tag to InlineAllowedTag

@lism-css/ui v.0.21.0 (2026.05.26)

• Aligned with lism-css core set class renaming (set--var:xxx → set--xxx).

lism-css v.0.20.0 (2026.05.20)

This release contains breaking changes.

Renamed directional Property Classes (#378)

• Unified directional properties (inline-start / block-start, etc.) into shorter, more readable names (no backward-compatible aliases, since this is v0)
• padding / margin: px-s/px-e/py-s/py-e → ps/pe/pbs/pbe, mx-s/mx-e/my-s/my-e → ms/me/mbs/mbe
• border: bd-x-s/bd-x-e/bd-y-s/bd-y-e → bd-s/bd-e/bd-bs/bd-be
• inset: i-x-s/i-x-e/i-y-s/i-y-e → i-s/i-e/i-bs/i-be
• CSS variable --list-px-s → --list-ps

Reorganized breakpoint-supported properties (#394)

• Reviewed default breakpoint support to reduce the size of main.css
• Dropped breakpoint support: pl/pr/pt/pb, ml/mr/mt/mb, hl, lts, cg, rg, bg
• Extended breakpoint support up to lg: d, cols, g, gta/gtc/gtr, ga/gc/gr
• Added a development-time warning when a breakpoint is specified on a bp:0 property

Changed default hover color (#381)

• Changed the default color of -hov:-bgc from var(--base-2) to a neutral mix (color-mix), so it works on both light and dark backgrounds
• Added the --neutral token and removed the -hov:neutral class
• Added --hov-bgc--default so projects can override the default

Other

• Moved the --flow default value definition to root and set a slightly wider value for lang="ja"
• Minor adjustments to base styles

@lism-css/ui v.0.20.0 (2026.05.20)

• Added a default background blur (backdrop-filter) to Modal (customizable via --modal-blur)
• Removed the default box-shadow from Callout / Alert for a flatter look
• Cleaned up the icon/title markup of Callout (fixed the Icon size to 1.25em)
• Followed the directional Property Class renaming in lism-css core (bd-x-s → bd-s, px-s → ps)

v0.18.0 and earlier

For releases prior to v0.18.0, only the key changes are listed below.

• v0.18.0 (2026.05.17): Redesigned --sz--* tokens as px-based values in 80px increments (#364). Expanded spacing tokens and introduced set--var:s, which ties --s-unit to the element’s font size (#377)
• v0.17.0 (2026.05.09): Removed -max-sz:container and introduced -max-sz:bleed for full-bleed layouts (#360). Removed --REM and unified --fz--base to 1rem. Removed link decoration styles from the a tag. Added deep path import support to @lism-css/ui (@lism-css/ui/react/{Name}, etc.) (#354)
• v0.16.x (2026.04.21–04.29): Reorganized utility classes (u--trimChildren → u--trimAll, u--collapseGrid → u--cells, added u--divide) (#323, #324). Renamed opacity tokens to semantic names (-o:p / -o:pp / -o:ppp) (#316). Renamed Layout Primitives (l--sideMain → l--withSide, l--fluidCols → l--autoColumns, l--switchCols → l--switchColumns) (#319)
• v0.15.0 (2026.04.21): Restructured the CSS layer order, separating out the lism-trait layer (#304). Introduced the var: prefix for set-- classes (set--hov → set--var:hov, etc.). Reorganized -hov: classes into the -hov:-{prop} format (#300). Shifted the shadow token scale by one step (#311)
• v0.14.0 (2026.04.17): Removed the lismClass / variant props in favor of className. Renamed Property Classes such as ysz → bsz. Removed is--vertical in favor of -wm:vertical-rl
• v0.13.x (2026.04.14–04.15): Unified the concept naming — Module → Primitive, State → Trait. Renamed is--linkBox → is--boxLink and u--expandedLink → is--coverLink. Added the util prop
• v0.12.0 (2026.04.10): Added the TileGrid layout. Changed gap shorthands to cg / rg. Removed individual setXxxx props in favor of set / unset
• v0.11.0 (2026.04.05): Redesigned the shadow system and reduced bdrs / bxsh tokens
• v0.10.x (2026.04.03–04.05): Removed <HTML.xxx> in favor of semantic wrapper components (Text / Inline / Group / Heading / Link / List, etc.). Added support for spacing-token negative margins (e.g., mt="-10"). Renamed @layers to the lism-xxx format
• v0.9.x (2026.03.17–03.31): Migrated React components to TypeScript. Changed class naming to use -- separators (set-xxx → set--xxx, u-xxx → u--xxx). Published the initial releases of @lism-css/ui / @lism-css/mcp
• v0.8.x: Switched to managing line-height via half-leading. Reorganized layout modules (WithSide → SideMain, extracted FluidCols, added SwitchCols). Removed the dynamic modules (accordion / modal / tabs) and migrated them to @lism-css/ui. Renamed many tokens (e.g., --c--main → --brand, --c--line → --divider)