Changelog

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

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)

lism-css v.0.18.0 (2026.05.17)

This release contains breaking changes.

Redesigned --sz--* tokens with unified px and 80px increments (#364)

• Unified --sz--* tokens (previously mixed px and rem) to px only
• Restructured all values as multiples of 80px (×5, ×8, ×11, ×15, ×20)
• xs: 32rem(512px) → 400px
• s: 42rem(672px) → 640px
• m: 56rem(896px) → 880px
• l: 1280px → 1200px
• xl: 1600px (unchanged)

Expanded spacing tokens and new set--var:s utility (#377)

• Added s25 (~20px) / s35 (~32px), filling s10–s40 with practical 4px-step values
• Restructured --s-unit to derive from --fz--base (calc(var(--fz--base) * 0.5))
• Added set--var:s utility class that switches --s-unit to 0.5em, allowing spacing to scale with element font size
• Removed bleed from sz tokens, moved to max-sz-specific preset

Other

• Excluded input[type='range'] from default form-field styles
• Fine-tuned oklch values for color palette tokens

lism-css v.0.17.0 (2026.05.09)

This release contains breaking changes.

Introducing -max-sz:bleed (#360)

• Removed -max-sz:container and introduced -max-sz:bleed, a new full-bleed utility that expands up to the outermost is--container width
• Set the initial-value of --sz--bleed to 100svi, providing a viewport-width fallback when no is--container ancestor exists

Removed --REM and simplified --fz--base

• Removed --REM and unified --fz--base to 1rem
• Aligned --hl-unit / --s-unit to be derived from --fz--base

Removed link decoration styles from a tag

• Removed --link-td-thickness / --link-td-color styles from the a tag

Bug Fixes

• Added inline-size: 100% to is--wrapper to prevent layout shifts inside stack (#356)
• Changed the default value of --td-p from var(--s10) to var(--s10) var(--s15)

Other

• Unified styles for blockquote and pre, and added italic style to q and blockquote
• Adjusted lts tokens and added xl size

@lism-css/ui v.0.17.0 (2026.05.09)

Deep path import support (#354)

• Each component can now be imported individually via @lism-css/ui/react/{Name} / @lism-css/ui/astro/{Name} deep paths.
• Deep path import is recommended in docs and examples since it reliably avoids pulling in unused components.

Other

• All components are now exposed as named exports (barrel imports remain compatible since they were already named).
• Added a gen:exports script that auto-generates exports from src/components/, regenerated and committed during build.

lism-css v.0.16.1 (2026.04.29)

• Changed the --list-px-s fallback value to 1.75em
• Added min-width: 0 to l--withSide flex children

lism-css v.0.16.0 (2026.04.21)

This release contains breaking changes.

Rename u--trimChildren and refine the exclusion rules (#324, #326)

The utility class that trims half-leading margins on children has been cleaned up.

Old	New
u--trimChildren / util="trimChildren"	u--trimAll / util="trimAll"

The old u--trimChildren / util="trimChildren" has been removed (no backward-compatible alias). Any direct usage must be replaced.

The selector strategy has also been refined to simply exclude elements that shouldn’t be trimmed (:empty, figure, picture, video, button, textarea, table). The :empty pseudo-class automatically covers void elements like img/hr and empty decorative divs (e.g. a--divider, a--spacer). If you need to exclude additional elements, add a rule like .u--trimAll > xxx { margin-block: 0 } on the consumer side.

Rename u--collapseGrid and add u--divide (#323)

The utility classes that draw dividing lines between children of a grid / flex container have been reorganized.

Old	New	Purpose
—	u--divide	Display dividers between children only (no outer frame)
u--collapseGrid	u--cells	Wrap each child with a border (table-cell / calendar style)

The pattern that previously required combining u--collapseGrid with p="0" and ov="clip" to show only interior dividers is now covered by the new u--divide class.

The old u--collapseGrid / util="collapseGrid" has been removed (no backward-compatible alias). Any direct usage must be replaced.

Opacity token renames (#316)

The opacity tokens have been renamed from the numeric step convention with three consecutive hyphens (--o---10) to semantic names derived from musical dynamic markings (the piano family). A new token for a light attenuation value (0.9) — previously untokenized — has been added, bringing the scale to four steps.

Old	New	Value
—	--o--mp / -o:mp	0.9 (new)
--o---10 / -o:-10	--o--p / -o:p	0.75
--o---20 / -o:-20	--o--pp / -o:pp	0.5
--o---30 / -o:-30	--o--ppp / -o:ppp	0.25

The old tokens (--o---10/-20/-30) and old utility classes (-o:-10/-20/-30) have been removed. Any direct usage must be replaced with the new names. -o:0 (fully transparent) remains unchanged.

Layout Primitive renames (#319)

The following Layout Primitive class names / component names / layout literal values have been renamed.

Old	New
l--sideMain / <SideMain> / layout="sideMain"	l--withSide / <WithSide> / layout="withSide"
l--fluidCols / <FluidCols> / layout="fluidCols"	l--autoColumns / <AutoColumns> / layout="autoColumns"
l--switchCols / <SwitchCols> / layout="switchCols"	l--switchColumns / <SwitchColumns> / layout="switchColumns"

The old React / Astro component names (<SideMain> / <FluidCols> / <SwitchCols>) remain as @deprecated aliases for now. They will be removed in the next major release, so migrate to the new names as soon as possible. There is no backward compatibility for the SCSS classes (l--sideMain, etc.) or layout literal values (layout="sideMain", etc.) — any direct usage must be updated.

Other changes

• Updated the formula for the top margin of headings inside l--flow
• Changed the -hov:-o opacity fallback from 0.7 to var(--o--p)
• Internal refactor: reorganized trait SCSS files into is/ and has/ subdirectories

@lism-css/ui v.0.16.0 (2026.04.21)

This release contains breaking changes.

• Aligned with lism-css 0.16.0 (Layout Primitive naming cleanup)
• Changed the Alert component’s layout prop literal value from "sideMain" to "withSide"

lism-css v.0.15.0 (2026.04.21)

This release contains breaking changes.

CSS Layer Restructuring (#304)

• Changed layer order to lism-trait → lism-primitive → lism-component
• Separated lism-trait layer and restored has--* Trait Classes
• Redesigned class output order: set-- → trait(is--/has--) → u-- → -prop
• Migrated set--mask to has--mask under the trait layer

set-- Class Overhaul (#304)

• Reclassified with var: prefix
  • set--hov → set--var:hov
  • set--shadow → set--var:sh
  • set--innerRs → set--var:bdrsInner
• Migrated set--mask to has--mask under the trait layer
• Added new set--revert (replaces automatic ul / ol detection with explicit class usage)

-hov: Class Naming Cleanup (#300)

• Renamed Property Class composition group to -hov:-{prop} format
  • -hov:c → -hov:-c
  • -hov:bgc → -hov:-bgc
  • -hov:bdc → -hov:-bdc
  • -hov:o → -hov:-o
  • -hov:bxsh → -hov:-bxsh
• Renamed set--var:hov group from -hov:to:* to -hov:in:*
• Added -hov:underline preset
• -hov:neutral etc. remain unchanged
• Removed auto-shortening of hov string values; unified behavior of object true values
• Removed class: key handling from hov prop object notation

Shadow Token Overhaul (#311)

The --shsz-- scale has been shifted down one step, and --shsz--5 was removed. To use the same shadow as before, shift the step by +10.

Old token	Value	New token
--shsz--10	0px 2px 6px	--shsz--20
--shsz--20	0px 4px 12px	--shsz--30
--shsz--30	0px 8px 24px	--shsz--40
--shsz--40	0px 16px 48px	--shsz--50

• New --shsz--10 is 0px 1px 3px (the new smallest size)
• Added --bxsh--50 / --shsz--50
• Adjusted --shc opacity from 12% → 15%

Other

• Removed prop="-" notation in favor of true only (#310)
• Removed overwriteBaseVar and merged into alwaysVar; improved BP class output
• Reorganized has--transition variables (--transProp → --transitionProps, --hov-duration → --transition-duration) and adjusted default duration to 0.25s
• Changed has--snap CSS variable defaults to element-side initialization
• Introduced AstroLayoutProps<L> and removed AstroFlowProps / AstroFlexProps
• Made LismElementProps['className'] type explicit (string | undefined)

@lism-css/ui v.0.15.0 (2026.04.21)

This release contains breaking changes.

Breaking Changes

• Aligned with lism-css 0.15.0 (-hov:-{prop} / -hov:in:* / set--var:* / shadow token scale changes, etc.)
• Changed default element of NavMenu.Link (Astro / React) from span to a. If you were using it without href, specify as="span" to keep the old behavior

TypeScript Support for Astro Components

• Added Props types to the following Astro components
  • Accordion / Alert / Avatar / Badge / Button / Callout / Chat / Details / Modal / NavMenu / ShapeDivider / Tabs
• Added Polymorphic<{as: Tag}> generics to Astro components
• Unified AstroFlowProps / AstroFlexProps into AstroLayoutProps<L>

Type System Improvements

• Added LismComponentProps<T> generics to React components
• Applied LayoutComponentProps<T, L> to layout components

Bug Fixes and Internal Improvements

• Changed client scripts to use tag-agnostic selectors and types (Accordion / Tabs / Modal)
• Made Accordion/react/Panel generic
• Used Flex component in Details/Summary
• Aligned Details/Content React implementation with Astro using Flow
• Used Flex / Flow in Accordion/Button / Panel
• Added gen:registry script to generate registry-index.json

lism-css v.0.14.0 (2026.04.17)

This release contains breaking changes.

Props system cleanup

• Removed lismClass / variant props in favor of unified className
• Removed dedicated clipPath / boxSizing props from Decorator

Property Class renames

• ysz → bsz (block-size)
• isolation → iso
• whspace → whs (white-space)
• ovwrap → ovw (overflow-wrap)

Trait Class / token cleanup

• Removed is--vertical; migrated to Property Class -wm:vertical-rl
• Disabled set--bp
• Renamed negative token variables from --o--n{N} to --o---{N}
• Removed --sz--min / --sz--full tokens

Other

• Changed fluidCols default min size to 20rem

@lism-css/ui v.0.14.0 (2026.04.17)

This release contains breaking changes.

• Aligned with lism-css 0.14.0 (removed lismClass / variant props, unified to className)
• Removed the DummyImage component (use the CDN dummy image URL directly instead, e.g. https://cdn.lism-css.com/dummy-image.jpg)
• Renamed internal files for Details / Tabs to the Root convention
• Added the buildModifierClass helper for BEM modifier composition
• Fixed an issue where component CSS imports were not included in the built output (vite.config adjustment)
• Fixed React/Astro initial props mismatches (6 components)
• Split React components into the same file structure as Astro
• Inlined getProps into components

lism-css v.0.13.1 (2026.04.15)

• Added the atomic prop

@lism-css/ui v.0.13.1 (2026.04.15)

• Aligned with lism-css 0.13.1
• Cleaned up Tabs styles

lism-css v.0.13.0 (2026.04.14)

This release contains breaking changes.

Module → Primitive concept rename

• Renamed concept Module → Primitive
  • CSS layer lism-modules → lism-primitive
  • SCSS directory src/scss/modules → src/scss/primitives
• Added new CSS layer lism-component

State → Trait identifier unification

Renamed State identifiers in the Props system to Trait.

• Type StateProps → TraitProps
• Constant STATES → TRAITS
• lism.config.js key states → traits
• File config/defaults/states.ts → config/defaults/traits.ts

Note: Prop names such as isContainer / isWrapper and is--* class names are unchanged.

set / util props unification

• Added util prop; unified set / util as strings with - prefix for exclusion

Trait Class / naming cleanup

• Renamed is--linkBox → is--boxLink
• Renamed u--expandedLink → is--coverLink
• Removed Container’s size prop in favor of isWrapper

Other

• Unified BEM element notation for c-- components to single _
• Reorganized class output order (moved set-- / u-- before property classes)

@lism-css/ui v.0.13.0 (2026.04.14)

• Aligned with lism-css 0.13.0
• Added util prop; unified set / util as strings with - prefix for exclusion
• Moved c-- components to the lism-component CSS layer
• Unified CSS layer names to singular (lism-components → lism-component)

@lism-css/ui v.0.12.0 (2026.04.10)

• Aligned with lism-css 0.12.0
• Migrated all .js/.jsx files to TypeScript (.ts/.tsx)
• Added Storybook stories for all components
• Fixed Tabs useId() conditional call (Rules of Hooks violation)

@lism-css/ui v.0.11.0 (2026.04.05)

• Adjusted Callout component styles to align with the shadow design changes in lism-css v0.11.0

v.0.12.0 (2026.04.10)

• Added TileGrid layout module (promoted from -gt:repeat)
• Added flex, grid, inline-grid, inline, inline-block to d (display)
• Changed gap shorthands from g-x/g-y to cg/rg
• Removed setXxxx individual props in favor of unified set="" unset=""
• Repositioned @layer lism-custom between modules and utility
• Changed list padding-inline-start to --list-px-s custom property
• Removed deprecated HTML component files
• Changed Property Class value abbreviations to CSS actual values (in-flex→inline-flex, rel→relative, abs→absolute, col→column, cc→current, etc.)
• Renamed “Prop Class” terminology to “Property Class”
• Removed --gtr/--gtc/--gta CSS variables and grid-template declarations from l--grid
• Removed unused --bdrs--5 token

v.0.11.0 (2026.04.05)

• Reduced bdrs/bxsh tokens, redesigned shadow system, removed --sh-inset
• Improved utility class (u--) specificity
• Simplified --td-p to s10

v.0.10.5 (2026.04.05)

• Removed set--cqUnit from core and moved to docs side

v.0.10.4 (2026.04.04)

• Fixed missed migrations from the @layer naming change (lism.xxx → lism-xxx).

v.0.10.3 (2026.04.04)

• Changed --fw--bold to 600 and reorganized fw tokens to light / normal / bold.
• Switched font-size calculation to CSS custom property-based (--fz-mol) approach, removing SCSS functions.

v.0.10.2 (2026.04.04)

• Media.astro now automatically maps as="img" / as="picture" to Astro’s built-in Image / Picture components.
• Introduced MediaPolymorphic type for Media.astro, enabling type completion for Image/Picture-specific props.
• Added AllowedTag type constraints to the as prop on semantic wrappers (Group, Text, Inline, List, Heading, etc.) for both React and Astro.
• Renamed CSS custom properties from --heading- to --headings- for consistency.
• Reorganized table element styles using --td- / --th- tokens.
• Adjusted base form control initial styles.
• Fixed type-related issues including distributive conditional type handling for OmitIndexSignature.

v.0.10.1 (2026.04.03)

• Negative margins can now be specified using spacing tokens. (e.g., my-s="-20", mt="-10")
• Special prop handling in certain components such as <Layer>, <Decorator>, and <Media> has been removed. This includes filter-related props (translate, rotate, scale, transform, blur, contrast, etc.) and prop sugars for objectFit / objectPosition.
• The <HTML.xxx> components have been removed and replaced with named components suited to their intended use.
• The <Dummy> component has been moved to @lism-css/ui and reimplemented as DummyText (for text) and DummyImage (for images).

Replacing <HTML.xxx> with semantic wrapper components

Component	Default as	Purpose
Text	p	Block-level text content elements
Inline	span	Inline elements
Group	div	Structural wrappers
Heading	h2	Headings (h1–h6 via the lv prop)
Link	a	Links
List	ul	Lists (as="ol" for ordered lists)
ListItem	li	List items

lism-css v.0.9.4 (2026.03.31)

• Fixed an issue where no shadow was applied to the -bxsh:5 class.
• Added types to Astro components.

@lism-css/ui v.0.9.3 (2026.03.30)

• Fixed the package to distribute compiled output from dist instead of raw source components.
• Fixed an issue where "use client" was being stripped during the build.

v.0.9.2 (2026.03.18)

• Updated README.md.

v.0.9.1 (2026.03.18)

• Removed the tag property from the <Lism> component and consolidated it into the as property.

v.0.9.0 (2026.03.17)

• Changes in lism-css
  • React components have been migrated to TypeScript, enabling property suggestions in editors.
  • set-xxx → set--xxx
  • u-xxx → u--xxx
  • u-trimItems → u--trimChildren
  • set-snap → u--snap
  • -content: → -contentSize:
• Full overhaul of @lism-css/ui.
• Published @lism-css/mcp updated to v.0.9.0.

v.0.8.3

• Minor CSS adjustments for linkbox.
• Minor adjustments to the default --divider color.

v.0.8.2

• Added -hov:to:zoom to the core.
• Minor adjustments to l--flow.

v.0.8 (Major changes)

[Breaking] Line-height specification changed

The system has been updated to manage line-height using half-leading.

See Typography & Scaling for details.

Layout module changes

Before	After	Notes
WithSide(l--withSide)	SideMain(l--sideMain)	Layout module renamed
<Grid gtc="liquid"> (-gtc:liquid)	<FluidCols>(l--fluidCols)	Extracted as a standalone layout module
	SwitchCols(l--switchCols)	New layout module added

Removal of Dynamic Modules

d--accordion, d--modal, and d--tabs have been removed.

<Accordion>, <Modal>, and <Tabs> are no longer available in lism-css.

They are now provided by the @lism-css/ui package instead.

Token / CSS variable changes

Before	After	Notes
--c--main	--brand	Color token renamed
--c--line	--divider	Color token renamed
--duration, --ease, --delay	--hov-duration, --hov-ease, --hov-delay	Hover-related variable names clarified
--isHov_	--_isHov	Naming convention changed
--gutter	--gutter-size	Variable name clarified

• Spacing scale has been overhauled.
• Color tokens have been globally adjusted.

Property Class changes

Before	After	Notes
ovw	ovwrap	overflow-wrap
whitespae	whspace
-td:under	Removed
-	-tt:upper, -tt:lower	Newly added

• translate, scale, and rotate have been removed from Property Classes.

Utility class changes

Before	After	Notes
-writing:vertical	is--vertical	Moved to State Class
u-bgclipText	Removed (opt-out)
u-itemDivider	u--collapseGrid	Class renamed
-gtc:liquid	l--fluidCols	Extracted as a layout class
-bd	Default value of --bdc changed	-bdc:current added

• Added set--bp.

Content size management class changes

is--container now only handles setting container-type. Content size management functionality has been separated into is--wrapper.

Before	After
-max-sz:outer	-max-sz:container
--sz--outer	--sz--container