Changelog
v.1.0リリースまでしばらく激しい変更が続く可能性があるため、変更点をここに記載して行く予定です。
lism-css v.0.17.0 (2026.05.09)
破壊的変更を含むリリースです。
-max-sz:bleed の新設 (#360)
-max-sz:containerを廃止し、最外側のis--container幅まで広がる full-bleed 用途のクラスとして-max-sz:bleedを新設--sz--bleedの initial-value を100sviにすることで、is--container祖先がない場合は viewport 幅まで広がる fallback を提供
--REM 廃止と --fz--base の簡素化
--REMを廃止し、--fz--baseを1remに統一--hl-unit/--s-unitを--fz--base経由に統一
a タグのリンク装飾スタイル廃止
aタグから--link-td-thickness/--link-td-colorのスタイルを廃止
Bug Fixes
is--wrapper直下にinline-size: 100%を付与し、stack配下でのガタつきを解消 (#356)--td-pのデフォルト値をvar(--s10)からvar(--s10) var(--s15)に変更
その他
blockquote,preのスタイルを共通化し、q,blockquoteにイタリックを追加ltsトークンを微調整しxlを追加
@lism-css/ui v.0.17.0 (2026.05.09)
Deep path import 対応 (#354)
- 各コンポーネントを
@lism-css/ui/react/{Name}/@lism-css/ui/astro/{Name}の deep path から個別に import できるよう exports に追加 - 未使用コンポーネントの混入を確実に避けられるため、ドキュメント・サンプルでは原則 deep path 形式を推奨
その他
- 全コンポーネントを named export に統一(barrel 経由は従来から named のため互換)
src/components/から exports を自動生成するgen:exportsスクリプトを追加し、ビルド時に再生成・commit
lism-css v.0.16.1 (2026.04.29)
--list-px-sのフォールバック値を1.75emに変更l--withSideの flex 子要素にmin-width: 0を追加
lism-css v.0.16.0 (2026.04.21)
破壊的変更を含むリリースです。
u--trimChildren のリネームと除外方式の整理 (#324, #326)
子要素のハーフレディング分の余白を一括トリミングするユーティリティクラスを整理しました。
| 旧 | 新 |
|---|---|
u--trimChildren / util="trimChildren" | u--trimAll / util="trimAll" |
旧 u--trimChildren / util="trimChildren" は削除されました(後方互換エイリアスなし)。直接使用している箇所はすべて置き換えが必要です。
トリミング対象の指定方式も整理され、トリムすべきでない要素(:empty, figure, picture, video, button, textarea, table)のみを除外するシンプルな形になりました。:empty により img や hr などの void element、中身のない装飾 div(a--divider / a--spacer 等)は自動で除外されます。追加で除外したい要素は、利用側で .u--trimAll > xxx { margin-block: 0 } のように個別打ち消しで対応してください。
u--collapseGrid のリネームと u--divide の追加 (#323)
Grid / Flex の子要素間に区切り線を表示するユーティリティクラスを整理しました。
| 旧 | 新 | 用途 |
|---|---|---|
| — | u--divide | 子要素間にのみ区切り線を表示(外周なし) |
u--collapseGrid | u--cells | 各セルを枠で囲む(table セル/カレンダー風) |
u--collapseGrid + p="0" + ov="clip" の組み合わせで実現していた「間の区切りのみ」のパターンは、新規の u--divide に一本化されました。
旧 u--collapseGrid / util="collapseGrid" は削除されました(後方互換エイリアスなし)。直接使用している箇所はすべて置き換えが必要です。
opacity トークンの命名変更 (#316)
opacity トークンを「ハイフン3連続(--o---10)」の数値段階命名から、音楽の強弱記号(piano 系列)を用いたセマンティック命名に変更しました。合わせて、従来トークン化されていなかった軽い減衰帯 (0.9) を新規トークンとして追加し、4段階構成としています。
| 旧 | 新 | 値 |
|---|---|---|
| — | --o--mp / -o:mp | 0.9(新規) |
--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 |
旧トークン (--o---10/-20/-30) および旧 utility クラス (-o:-10/-20/-30) は削除されました。直接使用している箇所はすべて新命名への置き換えが必要です。-o:0(完全透明)は変更ありません。
Layout Primitive の命名整理 (#319)
以下の Layout Primitive のクラス名・コンポーネント名・layout リテラル値を変更しました。
| 旧 | 新 |
|---|---|
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" |
React / Astro のコンポーネント名については、旧名 (<SideMain> / <FluidCols> / <SwitchCols>) を @deprecated エイリアスとして暫定的に残しています。次のメジャーアップデートで削除予定のため、新名称への置き換えを推奨します。
SCSS クラス (l--sideMain 等) と layout リテラル値 (layout="sideMain" 等) には後方互換はありません。直接使用している箇所はすべて置き換えが必要です。
その他
l--flowの見出し上部マージン計算式を変更-hov:-oの opacity フォールバック値を0.7からvar(--o--p)に変更- trait の SCSS を
is/とhas/サブディレクトリに整理(内部リファクタ)
@lism-css/ui v.0.16.0 (2026.04.21)
破壊的変更を含むリリースです。
- lism-css 0.16.0 への追従(Layout Primitive 命名整理)
Alertコンポーネントのlayoutプロパティで受け付けるリテラル値を"sideMain"→"withSide"に変更
lism-css v.0.15.0 (2026.04.21)
破壊的変更を含むリリースです。
CSSレイヤー構造の再編 (#304)
- レイヤー順序を
lism-trait → lism-primitive → lism-componentに変更 lism-traitレイヤーを独立させ、has--*Trait Class を復活- クラス出力順を
set-- → trait(is--/has--) → u-- → -propに再設計 set--maskをhas--maskとして trait レイヤーに移行
set-- クラスの刷新 (#304)
var:プレフィックスによる分類刷新set--hov→set--var:hovset--shadow→set--var:shset--innerRs→set--var:bdrsInner
set--maskをhas--maskとして trait レイヤーに移行set--revertを新設(ul/olの自動判定を明示的なクラス運用に変更)
-hov: クラスの命名整理 (#300)
- Property Class 合成系を
-hov:-{prop}形式に変更-hov:c→-hov:-c-hov:bgc→-hov:-bgc-hov:bdc→-hov:-bdc-hov:o→-hov:-o-hov:bxsh→-hov:-bxsh
set--var:hov連動系を-hov:to:*→-hov:in:*に変更-hov:underlineプリセットを追加-hov:neutralなどは据え置き- hov 文字列指定の短縮名自動変換を廃止、オブジェクト
true値の挙動を統一 - hov prop のオブジェクト指定から
class:キー処理を削除
シャドウトークンの刷新 (#311)
--shsz-- のサイズスケールを 1段階ずつずらし、--shsz--5 を削除しました。旧来と同じシャドウを使うには段階を +10 してください。
| 旧トークン | 値 | 新トークン |
|---|---|---|
--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 |
- 新しい
--shsz--10は0px 1px 3px(新規の最小サイズ) --bxsh--50/--shsz--50を新規追加--shcの透明度を 12% → 15% に調整
その他
prop="-"指定を廃止しtrueに一本化 (#310)overwriteBaseVarを廃止しalwaysVarに統合、BPクラス出力を改善has--transitionの変数整理(--transProp→--transitionProps、--hov-duration→--transition-duration)とデフォルト duration を 0.25s に調整has--snapの CSS 変数デフォルト値を要素側初期化に変更AstroLayoutProps<L>を導入しAstroFlowProps/AstroFlexPropsを削除LismElementPropsのclassName型をstring | undefinedに明示化
@lism-css/ui v.0.15.0 (2026.04.21)
破壊的変更を含むリリースです。
破壊的変更
- lism-css 0.15.0 への追従(
-hov:-{prop}/-hov:in:*/set--var:*/ シャドウトークンスケール変更など) NavMenu.Link(Astro / React)のデフォルト要素をspan→aに変更。hrefを渡さずに使用していた場合はas="span"を明示してください
Astro コンポーネントの TypeScript 対応
- 以下の Astro コンポーネントに Props 型を追加
- Accordion / Alert / Avatar / Badge / Button / Callout / Chat / Details / Modal / NavMenu / ShapeDivider / Tabs
- Astro コンポーネントに
Polymorphic<{as: Tag}>ジェネリクスを追加 AstroFlowProps/AstroFlexPropsをAstroLayoutProps<L>に統一
型システムの整備
- React コンポーネントに
LismComponentProps<T>ジェネリクスを追加 - レイアウトコンポーネントに
LayoutComponentProps<T, L>を適用
バグ修正・内部改善
- クライアントスクリプトをタグ非依存なセレクタ・型に変更(Accordion / Tabs / Modal)
- Accordion / react / Panel をジェネリクス化
Details/SummaryでFlexコンポーネントを使用Details/ContentReact 実装を Astro に合わせFlowを使用Accordion/Button/PanelでFlex/Flowを使用registry-index.jsonを生成するgen:registryスクリプトを追加
lism-css v.0.14.0 (2026.04.17)
破壊的変更を含むリリースです。
Props システムの整理
lismClass/variantprops を削除し、className一本に集約DecoratorからclipPath/boxSizing専用 props を削除
Property Class のリネーム
ysz→bsz(block-size 系)isolation→isowhspace→whs(white-space)ovwrap→ovw(overflow-wrap)
Trait Class / トークンの整理
is--verticalを削除し、Property Class-wm:vertical-rlに移行set--bpを無効化- ネガティブトークン変数を
--o--n{N}から--o---{N}に変更 --sz--min/--sz--fullトークンを削除
その他
fluidColsのデフォルト min サイズを 20rem に変更
@lism-css/ui v.0.14.0 (2026.04.17)
破壊的変更を含むリリースです。
- lism-css 0.14.0 への追従(
lismClass/variantprops を削除しclassName一本に集約) DummyImageコンポーネントを削除(cdn.lism-css.comのダミー画像URL を直接使用してください)Details/Tabsの内部ファイルをRoot命名規則にリネーム- BEM modifier 組み立て用の
buildModifierClassヘルパーを追加 importしたコンポーネント CSS がビルド出力に含まれず読み込まれない不具合を修正(vite.config 調整)- React/Astro 初期 props 不一致の修正(6件)
- React 側コンポーネントを Astro と同じファイル構成に分割
getPropsをコンポーネントにインライン化し不要ファイルを削除
lism-css v.0.13.1 (2026.04.15)
atomicprop を新設
@lism-css/ui v.0.13.1 (2026.04.15)
- lism-css 0.13.1 の変更に追従
Tabsのスタイルを整理
lism-css v.0.13.0 (2026.04.14)
破壊的変更を含むリリースです。
Module → Primitive 概念リネーム
- 概念名
Module→Primitiveにリネーム- CSS レイヤー
lism-modules→lism-primitive - SCSS ディレクトリ
src/scss/modules→src/scss/primitives
- CSS レイヤー
- 新規 CSS レイヤー
lism-componentを追加
State → Trait 識別子の統一
Props システムの State 系識別子を Trait に統一リネーム。
- 型
StateProps→TraitProps - 定数
STATES→TRAITS lism.config.jsの設定キーstates→traits- 参照ファイル
config/defaults/states.ts→config/defaults/traits.ts
※ isContainer, isWrapper 等の props 名や is--* クラス名は変更なし。
set / util props の統一
utilprop を追加し、set/utilを string に統一。-prefix で除外する仕様に変更
Trait Class / 命名整理
is--linkBoxをis--boxLinkにリネームu--expandedLinkをis--coverLinkにリネームContainerのsizeプロパティを廃止し、isWrapperに統一
その他
c--コンポーネントの BEM element 記法を単一_に統一- クラス出力順を整理(
set--/u--を property class より前に移動)
@lism-css/ui v.0.13.0 (2026.04.14)
- lism-css 0.13.0 への追従
utilprop を追加し、set/utilを string に統一。-prefix で除外する仕様に変更c--コンポーネントをlism-componentレイヤーに移動- CSS レイヤー名を単数形に統一(
lism-components→lism-component)
@lism-css/ui v.0.12.0 (2026.04.10)
- lism-css 0.12.0 への追従
.js/.jsxを TypeScript (.ts/.tsx) に全面移行- 全コンポーネントに Storybook stories を追加
- Tabs の useId() 条件呼び出しを修正(Rules of Hooks 違反を修正)
@lism-css/ui v.0.11.0 (2026.04.05)
- Callout コンポーネントのスタイルを lism-css v0.11.0 の shadow 設計変更に合わせて調整
v.0.12.0 (2026.04.10)
- TileGrid レイアウトモジュールを追加(
-gt:repeatから昇格) d(display) に flex, grid, inline-grid, inline, inline-block を追加- gap 系 shorthand を
g-x/g-yからcg/rgに変更 setXxxx個別 props を廃止し、set=""unset=""に統一@layer lism-customを modules と utility の間に再配置- リストの padding-inline-start を
--list-px-sカスタムプロパティに変更 - 非推奨の HTML コンポーネントファイルを削除
- Property Class の値略記を CSS 実値ベースに変更(
in-flex→inline-flex,rel→relative,abs→absolute,col→column,cc→current等) - 用語「Prop Class」を「Property Class」にリネーム
l--gridから--gtr/--gtc/--gtaCSS 変数と grid-template 宣言を削除- 未使用トークン
--bdrs--5の削除
v.0.11.0 (2026.04.05)
bdrs・bxshトークン削減、shadow 設計変更、--sh-inset廃止- ユーティリティクラス(
u--)の詳細度を改善 --td-pをシンプルにs10へ変更
v.0.10.5 (2026.04.05)
set--cqUnitをコアから削除し、docs 側に移設
v.0.10.4 (2026.04.04)
@layer命名変更(lism.xxx→lism-xxx)の移行漏れを修正しました。
v.0.10.3 (2026.04.04)
--fw--boldを 600 に変更し、fwトークンをlight/normal/boldに整理しました。- フォントサイズの計算を CSS 変数ベース(
--fz-mol)に変更し、SCSS 関数を削除しました。
v.0.10.2 (2026.04.04)
- Media.astro で
as="img"/as="picture"指定時に Astro の Image / Picture コンポーネントへ自動マッピングされるようになりました。 - Media.astro に MediaPolymorphic 型を導入し、Image / Picture 固有 props の型補完に対応しました。
- セマンティックラッパー(Group, Text, Inline, List, Heading 等)の
asprop に AllowedTag 型制約を導入しました(React / Astro 共通)。 - CSS 変数名
--heading-を--headings-に改名しました。 - テーブル要素のスタイルを
--td-/--th-トークンに整理しました。 - ベースのフォームコントロール初期スタイルを調整しました。
- OmitIndexSignature の distributive conditional type 対応など型周りの修正を行いました。
v.0.10.1 (2026.04.03)
- ネガティブマージンをスペーストークンで指定できるようになりました。(例:
my-s="-20",mt="-10") <Layer>,<Decorator>,<Media>など一部のコンポーネントでの特殊なpropの扱い(translate,rotate,scale,transform,blur,contrast等の filter 系、およびobjectFit/objectPositionの prop sugar) を廃止しました。<HTML.xxx>コンポーネントを廃止し、用途に応じた名前付きコンポーネントに置き換えました。<Dummy>コンポーネントを@lism-css/uiへ移動し、DummyText(テキスト用)とDummyImage(画像用)として再実装しました。
<HTML.xxx> を廃止し、セマンティックラッパーコンポーネントに置き換え
| コンポーネント | デフォルト as | 用途 |
|---|---|---|
Text | p | テキストコンテンツ系ブロック要素 |
Inline | span | 文中要素 |
Group | div | 構造ラッパー |
Heading | h2 | 見出し(lv prop で h1〜h6) |
Link | a | リンク |
List | ul | リスト(as="ol" で順序付き) |
ListItem | li | リストアイテム |
lism-css v.0.9.4 (2026.03.31)
-bxsh:5クラスにシャドウが適用されない問題を修正。- Astroコンポーネントに型を追加しました。
@lism-css/ui v.0.9.3 (2026.03.30)
- packageのsrcをコンポーネントとして配信していたものを dist に修正.
- “use client” がビルドで消えていた問題を修正。
v.0.9.2 (2026.03.18)
README.md更新
v.0.9.1 (2026.03.18)
<Lism>コンポーネントからtagプロパティを削除し、asプロパティへ統合しました。
v.0.9.0 (2026.03.17)
lism-cssの変更点- React コンポーネントのts化を行いました。これにより、プロパティのサジェストが効くようになりました。
set-xxx→set--xxxに変更しました。u-xxx→u--xxxに変更しました。u-trimItems→u--trimChildrenに変更しました。set-snap→u--snapに変更しました。-content:→-contentSize:に変更しました。
@lism-css/uiの大幅調整を行いました。@lism-css/mcpを v.0.9.0に合わせて公開しました。
v.0.8.3
- linkboxのCSSを微調整
- デフォルト —dividerカラーの微調整
v.0.8.2
-hov:to:zoomをコアに追加しました。l--flowの微調整を行いました
v.0.8 (大幅な変更)
[重要] line-heightの仕様を変更しました。
ハーフレディングで管理するシステムへ変更しました。
詳しくは タイポグラフィ・スケーリングの説明 を参照してください。
レイアウトモジュールの変更点
| 変更前 | 変更後 | 備考 |
|---|---|---|
WithSide(l--withSide) | SideMain(l--sideMain) | レイアウトモジュール名の変更 |
<Grid gtc="liquid"> (-gtc:liquid) | <FluidCols>(l--fluidCols) | レイアウトモジュールとして独立 |
SwitchCols(l--switchCols) | レイアウトモジュールの新規追加 |
ダイナミックモジュールの削除
d--accordion, d--modal, d--tabs を削除しました。
<Accordion>, <Modal>, <Tabs> も lism-cssからは使用できなくなりました。
代わりに、@lism-css/ui パッケージで提供しています。
トークン・CSS変数の変更点
| 変更前 | 変更後 | 備考 |
|---|---|---|
--c--main | --brand | カラートークン名の変更 |
--c--line | --divider | カラートークン名の変更 |
--duration, --ease, --delay | --hov-duration, --hov-ease, --hov-delay | hover関連の変数名を明確化 |
--isHov_ | --_isHov | 命名規則の変更 |
--gutter | --gutter-size | 変数名の明確化 |
- 余白スケーリングを全体的に変更しました。
- カラートークンを全体的に調整しました。
Property Class の変更点
| 変更前 | 変更後 | 備考 |
|---|---|---|
ovw | ovwrap | overflow-wrap |
whitespae | whspace | |
-td:under | 廃止 | |
| - | -tt:upper, -tt:lower | 新規追加 |
translate,scale,rotateを Property Class から削除しました。
ユーティリティクラスの変更点
| 変更前 | 変更後 | 備考 |
|---|---|---|
-writing:vertical | is--vertical | State Classへ移行 |
u-bgclipText | 廃止(オプトアウト) | |
u-itemDivider | u--collapseGrid | クラス名変更 |
-gtc:liquid | l--fluidCols | レイアウトクラスとして独立 |
-bd | --bdc のデフォルト値変更 | -bdc:current を追加 |
set--bpを追加しました。
コンテンツサイズ管理クラスの変更点
is--container は container-type のセットのみを担当するように変更しました。
コンテンツサイズ管理機能は is--wrapper へ分離しました。
| 変更前 | 変更後 |
|---|---|
-max-sz:outer | -max-sz:container |
--sz--outer | --sz--container |