@icen.ai/ui 0.9.0 → 0.11.0

package/dist/components/modal.css

@@ -1,20 +1,21 @@
+@layer icen.components {
 /*
  * @icen.ai/ui — Component: modal（对话框 + 贴边 Sheet，与 behaviors/modal 配套）
  *
  * 完整契约：
- *   <div class="modal-backdrop" data-modal="id" hidden>
- *     <div class="modal [--sm|--lg|--xl|--full] [role=dialog] aria-modal="true" aria-labelledby="title-id">
- *       <div class="modal-header">
+ *   <div class="icen-modal-backdrop" data-icen-modal="id" hidden>
+ *     <div class="icen-modal [--sm|--lg|--xl|--full] [role=dialog] aria-modal="true" aria-labelledby="title-id">
+ *       <div class="icen-modal-header">
  *         <div>
- *           <h2 class="modal-title" id="title-id">标题</h2>
- *           <p class="modal-description">副标题（可选）</p>
+ *           <h2 class="icen-modal-title" id="title-id">标题</h2>
+ *           <p class="icen-modal-description">副标题（可选）</p>
          </div>
- *         <button class="modal-close" aria-label="关闭">…</button>
+ *         <button class="icen-modal-close" aria-label="关闭">…</button>
  *       </div>
- *       <div class="modal-body">…</div>
- *       <div class="modal-footer [modal-footer--between|modal-footer--start|modal-footer--column]">
- *         <button class="btn">取消</button>
- *         <button class="btn btn-primary">确认</button>
+ *       <div class="icen-modal-body">…</div>
+ *       <div class="icen-modal-footer [icen-modal-footer--between|icen-modal-footer--start|icen-modal-footer--column]">
+ *         <button class="icen-btn">取消</button>
+ *         <button class="icen-btn icen-btn-primary">确认</button>
  *       </div>
  *     </div>
  *   </div>
@@ -23,191 +24,188 @@
  * behavior 维护：focus trap、ESC 关闭、点击 backdrop 关闭、scroll lock。
  */
 
-.modal-backdrop {
+.icen-modal-backdrop {
   position: fixed;
   inset: 0;
-  z-index: var(--z-dialog);
+  z-index: var(--icen-z-dialog);
   display: flex;
   align-items: center;
   justify-content: center;
-  padding: var(--density-space-md);
-  background: color-mix(in srgb, var(--token-text) 45%, transparent);
-  backdrop-filter: blur(4px);
-  -webkit-backdrop-filter: blur(4px);
-  animation: icen-modal-fade-in var(--icen-tx-normal);
-}
-.modal-backdrop[hidden] { display: none; }
+  padding: var(--icen-density-space-md);
+  background: var(--icen-token-scrim);
+  backdrop-filter: none;
+  -webkit-backdrop-filter: none;
+  opacity: 1;
+  transition: opacity var(--icen-duration-fast) var(--icen-ease-out), display var(--icen-duration-fast) allow-discrete;
+}
+.icen-modal-backdrop[hidden] { display: none; opacity: 0; pointer-events: none; }
 
-.modal {
+.icen-modal {
   display: flex;
   flex-direction: column;
   overflow: hidden;
   width: 100%;
   max-width: 480px;
   max-height: calc(100vh - 32px);
-  background: var(--token-card-strong);
-  color: var(--token-text);
-  border: 1px solid var(--token-outline);
-  box-shadow: var(--token-shadow-overlay);
-  border-radius: var(--radius-xl);
-  animation: icen-modal-scale-in var(--icen-tx-slow);
-}
-.modal:focus { outline: none; }
-.modal:focus-visible {
-  box-shadow: var(--token-shadow-overlay), var(--icen-ring-soft);
+  max-block-size: calc(100dvh - 2 * var(--icen-density-space-md));
+  background: var(--icen-token-surface);
+  color: var(--icen-token-text);
+  border: 1px solid var(--icen-token-material-edge);
+  box-shadow: var(--icen-token-material-light), var(--icen-token-shadow-overlay);
+  border-radius: var(--icen-radius-xl);
+  --modal-enter-transform: translateY(4px) scale(.985);
+  opacity: 1;
+  transform: translate(0, 0) scale(1);
+  transition: opacity var(--icen-duration-fast) var(--icen-ease-out), transform var(--icen-duration-normal) var(--icen-ease-enter);
+}
+.icen-modal:focus { outline: none; }
+.icen-modal:focus-visible {
+  box-shadow: var(--icen-token-shadow-overlay), var(--icen-ring-soft);
 }
 
 /* ── 尺寸档 ── */
-.modal--sm { max-width: 360px; }
-.modal--lg { max-width: 640px; }
-.modal--xl { max-width: 800px; }
-.modal--full {
+.icen-modal--sm { max-width: 360px; }
+.icen-modal--lg { max-width: 640px; }
+.icen-modal--xl { max-width: 800px; }
+.icen-modal--full {
   width: calc(100vw - 32px);
   max-width: none;
-  height: calc(100vh - 32px);
+  height: calc(100dvh - 32px);
   max-height: none;
-  border-radius: var(--radius-lg);
+  border-radius: var(--icen-radius-lg);
 }
 
 /* ── 头部 / 主体 / 底栏 ── */
-.modal-header {
+.icen-modal-header {
   display: flex;
   align-items: flex-start;
   justify-content: space-between;
-  gap: var(--density-space-md);
-  padding: var(--density-space-lg) var(--density-space-lg) var(--density-space-sm);
+  gap: var(--icen-density-space-md);
+  padding: var(--icen-density-space-lg) var(--icen-density-space-lg) var(--icen-density-space-xs);
 }
-.modal-title {
+.icen-modal-title {
   margin: 0;
-  font-size: var(--density-font-size-lg);
-  font-weight: 600;
+  font-size: var(--icen-font-size-title);
+  font-weight: var(--icen-font-weight-title);
+  letter-spacing: -.01em;
   line-height: 1.3;
-  font-family: var(--font-heading);
+  font-family: var(--icen-font-heading);
 }
-.modal-description {
-  margin: 2px 0 0;
-  font-size: var(--density-font-size-sm);
-  color: var(--token-text-muted);
+.icen-modal-description {
+  margin: 3px 0 0;
+  font-size: var(--icen-density-font-size-sm);
+  color: var(--icen-token-text-muted);
   line-height: 1.5;
 }
-.modal-close {
+.icen-modal-close {
   display: inline-flex;
   align-items: center;
   justify-content: center;
-  width: 28px;
-  height: 28px;
+  inline-size: 28px;
+  block-size: 28px;
   padding: 0;
   flex-shrink: 0;
   background: none;
   border: 0;
   cursor: pointer;
-  color: var(--token-text-faint);
-  font-size: var(--density-font-size-lg);
+  color: var(--icen-token-text-muted);
+  font-size: var(--icen-density-font-size-lg);
   line-height: 1;
-  border-radius: var(--radius-sm);
+  border-radius: var(--icen-radius-full);
   transition:
     background-color var(--icen-tx-fast),
     color var(--icen-tx-fast);
 }
-.modal-close:hover {
-  background: var(--token-surface-hover);
-  color: var(--token-text);
+.icen-modal-close > svg { inline-size: 14px; block-size: 14px; }
+.icen-modal-close:hover {
+  background: var(--icen-token-fill-hover);
+  color: var(--icen-token-text);
 }
-.modal-close:focus-visible {
+.icen-modal-close:focus-visible {
   outline: none;
   box-shadow: var(--icen-ring);
 }
 
-.modal-body {
+.icen-modal-body {
   flex: 1;
   overflow-y: auto;
   overscroll-behavior: contain;
-  padding: 0 var(--density-space-lg) var(--density-space-md);
-  font-size: var(--density-font-size-md);
-  line-height: 1.6;
+  padding: var(--icen-density-space-xs) var(--icen-density-space-lg) var(--icen-density-space-lg);
+  font-size: var(--icen-font-size-control);
+  line-height: 1.55;
 }
 
-.modal-footer {
+.icen-modal-footer {
   display: flex;
   justify-content: flex-end;
-  gap: var(--density-space-sm);
-  padding: var(--density-space-md) var(--density-space-lg);
-  border-top: 1px solid color-mix(in srgb, var(--token-line-soft) 40%, transparent);
-}
-.modal-footer--start { justify-content: flex-start; }
-.modal-footer--between { justify-content: space-between; }
-.modal-footer--column { flex-direction: column; }
-.modal-footer--column > * { width: 100%; }
+  gap: var(--icen-density-space-sm);
+  padding: var(--icen-density-space-sm) var(--icen-density-space-lg);
+  background: var(--icen-token-surface-chrome);
+  border-top: 1px solid var(--icen-token-separator-soft);
+}
+.icen-modal-footer--start { justify-content: flex-start; }
+.icen-modal-footer--between { justify-content: space-between; }
+.icen-modal-footer--column { flex-direction: column; }
+.icen-modal-footer--column > * { width: 100%; }
 
 /* ── Sheet 变体：面板 fixed 贴边，radius 只保留非贴边侧 ── */
-.modal--sheet-left,
-.modal--sheet-right,
-.modal--sheet-top,
-.modal--sheet-bottom {
+.icen-modal--sheet-left,
+.icen-modal--sheet-right,
+.icen-modal--sheet-top,
+.icen-modal--sheet-bottom {
   position: fixed;
   max-width: none;
   max-height: none;
+  max-inline-size: 100vw;
+  max-block-size: 100dvh;
   border-radius: 0;
 }
-.modal--sheet-left {
-  left: 0; top: 0; bottom: 0;
+.icen-modal--sheet-left {
+  left: 0; top: 0; bottom: 0; /* guard:allow-physical --sheet-left 是按物理侧边命名的变体（贴左缘抽屉），RTL 语义不变 */
   width: 360px;
   height: 100%;
-  border-radius: 0 var(--radius-xl) var(--radius-xl) 0;
-  animation-name: icen-modal-slide-left;
+  border-radius: 0 var(--icen-radius-lg) var(--icen-radius-lg) 0; /* guard:allow-physical 圆角贴着物理左缘（sheet-left 变体），RTL 语义不变 */
+  --modal-enter-transform: translateX(-16px);
 }
-.modal--sheet-right {
-  right: 0; top: 0; bottom: 0;
+.icen-modal--sheet-right {
+  right: 0; top: 0; bottom: 0; /* guard:allow-physical --sheet-right 是按物理侧边命名的变体（贴右缘抽屉），RTL 语义不变 */
   width: 360px;
   height: 100%;
-  border-radius: var(--radius-xl) 0 0 var(--radius-xl);
-  animation-name: icen-modal-slide-right;
+  border-radius: var(--icen-radius-lg) 0 0 var(--icen-radius-lg); /* guard:allow-physical 圆角贴着物理右缘（sheet-right 变体），RTL 语义不变 */
+  --modal-enter-transform: translateX(16px);
 }
-.modal--sheet-top {
-  top: 0; left: 0; right: 0;
+.icen-modal--sheet-top {
+  top: 0; inset-inline: 0;
   width: 100%;
   height: 300px;
-  border-radius: 0 0 var(--radius-xl) var(--radius-xl);
-  animation-name: icen-modal-slide-top;
+  border-radius: 0 0 var(--icen-radius-lg) var(--icen-radius-lg);
+  --modal-enter-transform: translateY(-16px);
 }
-.modal--sheet-bottom {
-  bottom: 0; left: 0; right: 0;
+.icen-modal--sheet-bottom {
+  bottom: 0; inset-inline: 0;
   width: 100%;
   height: 300px;
-  border-radius: var(--radius-xl) var(--radius-xl) 0 0;
-  animation-name: icen-modal-slide-bottom;
+  border-radius: var(--icen-radius-lg) var(--icen-radius-lg) 0 0;
+  --modal-enter-transform: translateY(16px);
 }
-.modal--sheet-left.modal--sm, .modal--sheet-right.modal--sm { width: 280px; }
-.modal--sheet-left.modal--lg, .modal--sheet-right.modal--lg { width: 480px; }
-.modal--sheet-top.modal--sm, .modal--sheet-bottom.modal--sm { height: 200px; }
-.modal--sheet-top.modal--lg, .modal--sheet-bottom.modal--lg { height: 50vh; }
+.icen-modal--sheet-left.icen-modal--sm, .icen-modal--sheet-right.icen-modal--sm { width: 280px; }
+.icen-modal--sheet-left.icen-modal--lg, .icen-modal--sheet-right.icen-modal--lg { width: 480px; }
+.icen-modal--sheet-top.icen-modal--sm, .icen-modal--sheet-bottom.icen-modal--sm { height: 200px; }
+.icen-modal--sheet-top.icen-modal--lg, .icen-modal--sheet-bottom.icen-modal--lg { height: 50vh; }
 
-/* ── 进场动画 ── */
-@keyframes icen-modal-fade-in {
-  from { opacity: 0; }
-  to { opacity: 1; }
-}
-@keyframes icen-modal-scale-in {
-  from { opacity: 0; transform: scale(0.96) translateY(8px); }
-  to { opacity: 1; transform: scale(1) translateY(0); }
-}
-@keyframes icen-modal-slide-left {
-  from { opacity: 0; transform: translateX(-40px); }
-  to { opacity: 1; transform: translateX(0); }
+/* Hidden keeps native semantics while display transitions retire the surface.
+   Unsupported browsers fall back to immediate hide; no JS timing owns visibility. */
+.icen-modal-backdrop[hidden] .icen-modal { opacity: 0; transform: var(--modal-enter-transform); }
+@starting-style {
+  .icen-modal-backdrop:not([hidden]) { opacity: 0; }
+  .icen-modal-backdrop:not([hidden]) .icen-modal { opacity: 0; transform: var(--modal-enter-transform); }
 }
-@keyframes icen-modal-slide-right {
-  from { opacity: 0; transform: translateX(40px); }
-  to { opacity: 1; transform: translateX(0); }
+@media (pointer: coarse) {
+  .icen-modal-close { min-inline-size: 44px; min-block-size: 44px; }
 }
-@keyframes icen-modal-slide-top {
-  from { opacity: 0; transform: translateY(-40px); }
-  to { opacity: 1; transform: translateY(0); }
-}
-@keyframes icen-modal-slide-bottom {
-  from { opacity: 0; transform: translateY(40px); }
-  to { opacity: 1; transform: translateY(0); }
+@media (prefers-reduced-motion: reduce) {
+  .icen-modal-backdrop, .icen-modal { transition: none; }
 }
 
-@media (prefers-reduced-motion: reduce) {
-  .modal-backdrop, .modal { animation: none; }
+
 }

package/dist/components/modal.d.mts

@@ -0,0 +1,2 @@
+// kit: modal 类型面（构建产物，勿手改）
+export * from '../behaviors/modal.mjs';