@icen.ai/ui 0.2.0 → 0.3.0

package/dist/components/segmented.css

@@ -1,112 +1,261 @@
 /*
  * @icen.ai/ui — Component: segmented（分段控件 / 切换组 / 数字步进器 / OTP）
+ *
  * 规格源自 opengal primitives/input.tsx 的 SegmentedControl 与 advanced-input.tsx
  * 的 ToggleButtonGroup / NumberStepper / OtpInput。
- * segmented 与 toggle-group 是纯 CSS 状态组件（.is-active）；stepper 由使用方接线；
- * otp 单元格交互见 behaviors/input.ts 的 initInput。
+ *
+ * 完整契约：
+ *   1) 分段控件（排他单选）：
+ *      <div class="segmented [segmented--sm|segmented--lg]" role="radiogroup">
+ *        <button class="segmented-item [.is-active]" role="radio" [aria-checked="true"]>…</button>
+ *      </div>
+ *
+ *   2) 切换组（同族变体，更松散）：
+ *      <div class="toggle-group [toggle-group--sm]">
+ *        <button class="toggle-item [.is-active]">…</button>
+ *      </div>
+ *
+ *   3) 数字步进器：
+ *      <div class="stepper">
+ *        <button class="stepper-btn" data-step="-1">−</button>
+ *        <input class="stepper-input" type="number" min="0" max="100" />
+ *        <button class="stepper-btn" data-step="1">+</button>
+ *      </div>
+ *
+ *   4) OTP 验证码单元格：
+ *      <div class="otp otp--sm" role="group" aria-label="一次性验证码">
+ *        <input class="otp-cell" maxlength="1" />
+ *        …
+ *      </div>
+ *
+ * segmented/toggle 是纯 CSS 状态组件（.is-active）；stepper/otp 由 behaviors/input.ts 接线。
  */
 
 /* ── 分段控件（排他单选） ── */
 .segmented {
-  display: inline-flex; align-items: center; gap: 2px; padding: 2px;
+  display: inline-flex;
+  align-items: center;
+  gap: 2px;
+  padding: 2px;
   background: var(--token-panel);
   border: 1px solid var(--token-outline-soft);
-  border-radius: var(--radius-lg);
+  border-radius: var(--radius-md);
   box-shadow: var(--token-shadow-inset);
 }
 
 .segmented-item {
-  display: flex; align-items: center; gap: 6px;
-  padding: 6px 12px; font-size: 12px; font-weight: 500;
-  border: none; background: transparent; cursor: pointer;
-  border-radius: var(--radius-md);
+  display: flex;
+  align-items: center;
+  gap: var(--density-space-xs);
+  padding: var(--density-space-xs) calc(var(--density-space-sm) + 2px);
+  font-size: var(--density-font-size-sm);
+  font-weight: 500;
+  border: none;
+  background: transparent;
+  cursor: pointer;
+  border-radius: var(--radius-sm);
   color: var(--token-text-muted);
+  -webkit-tap-highlight-color: transparent;
+  transition:
+    background-color var(--icen-tx-fast),
+    color var(--icen-tx-fast),
+    box-shadow var(--icen-tx-fast);
 }
-.segmented-item:hover:not(.is-active) {
-  color: var(--token-text); background: var(--token-surface-hover);
+.segmented-item:hover:not(.is-active):not(:disabled) {
+  color: var(--token-text);
+  background: var(--token-surface-hover);
 }
-.segmented-item.is-active {
-  background: var(--token-accent); color: var(--token-on-accent, #fff);
+.segmented-item:focus-visible {
+  outline: none;
+  box-shadow: var(--icen-ring);
+}
+.segmented-item.is-active,
+.segmented-item[aria-checked='true'] {
+  background: var(--token-accent);
+  color: var(--token-on-accent, #fff);
   box-shadow: var(--token-shadow-elevated);
 }
-.segmented-item:disabled { opacity: 0.4; cursor: not-allowed; }
+.segmented-item:disabled,
+.segmented-item[aria-disabled='true'] {
+  opacity: var(--icen-disabled-opacity);
+  cursor: not-allowed;
+}
+.segmented-item svg { width: 13px; height: 13px; flex-shrink: 0; }
 
-/* 尺寸：容器修饰符驱动 item 内边距 / 字号 */
-.segmented--sm .segmented-item { padding: 4px 10px; font-size: 11px; }
+/* 尺寸 */
+.segmented--sm .segmented-item {
+  padding: 2px var(--density-space-sm);
+  font-size: var(--density-font-size-xs);
+}
+.segmented--lg .segmented-item {
+  padding: var(--density-space-xs) var(--density-space-md);
+  font-size: var(--density-font-size-md);
+}
 
-/* ── 切换组（segmented 同族变体：更松的 padding、item 更小圆角、active 阴影更轻） ── */
+/* ── 切换组（segmented 同族变体） ── */
 .toggle-group {
-  display: inline-flex; align-items: center; gap: 4px; padding: 4px;
+  display: inline-flex;
+  align-items: center;
+  gap: var(--density-space-xs);
+  padding: var(--density-space-xs);
   background: var(--token-panel);
   border: 1px solid var(--token-outline-soft);
-  border-radius: var(--radius-lg);
+  border-radius: var(--radius-md);
 }
 
 .toggle-item {
-  display: flex; align-items: center; gap: 6px;
-  padding: 6px 12px; font-size: 12px; font-weight: 500;
-  border: none; background: transparent; cursor: pointer;
+  display: flex;
+  align-items: center;
+  gap: var(--density-space-xs);
+  padding: var(--density-space-xs) var(--density-space-sm);
+  font-size: var(--density-font-size-sm);
+  font-weight: 500;
+  border: none;
+  background: transparent;
+  cursor: pointer;
   border-radius: var(--radius-xs);
   color: var(--token-text-muted);
+  transition:
+    background-color var(--icen-tx-fast),
+    color var(--icen-tx-fast);
 }
-.toggle-item:hover:not(.is-active) {
-  color: var(--token-text); background: var(--token-control-hover);
+.toggle-item:hover:not(.is-active):not(:disabled) {
+  color: var(--token-text);
+  background: var(--token-control-hover);
 }
-.toggle-item.is-active {
-  background: var(--token-accent); color: var(--token-on-accent, #fff);
+.toggle-item:focus-visible {
+  outline: none;
+  box-shadow: var(--icen-ring);
+}
+.toggle-item.is-active,
+.toggle-item[aria-checked='true'] {
+  background: var(--token-accent);
+  color: var(--token-on-accent, #fff);
   box-shadow: var(--token-shadow-card);
 }
-.toggle-item:disabled { opacity: 0.4; cursor: not-allowed; }
-.toggle-group--sm .toggle-item { padding: 4px 10px; font-size: 11px; }
+.toggle-item:disabled,
+.toggle-item[aria-disabled='true'] {
+  opacity: var(--icen-disabled-opacity);
+  cursor: not-allowed;
+}
+.toggle-group--sm .toggle-item {
+  padding: 2px var(--density-space-sm);
+  font-size: var(--density-font-size-xs);
+}
 
 /* ── 数字步进器 ── */
 .stepper {
-  display: inline-flex; align-items: stretch;
+  display: inline-flex;
+  align-items: stretch;
   background: var(--token-control);
   border: 1px solid var(--token-outline-soft);
-  border-radius: var(--radius-lg);
+  border-radius: var(--radius-md);
   overflow: hidden;
+  transition: border-color var(--icen-tx-fast), box-shadow var(--icen-tx-fast);
+}
+.stepper:hover { border-color: var(--icen-hover-border); }
+.stepper:focus-within {
+  border-color: var(--icen-control-focus-border);
+  box-shadow: var(--icen-control-focus-shadow);
 }
 
 .stepper-btn {
-  display: inline-flex; align-items: center; justify-content: center;
-  padding: 0 10px; border: none; background: transparent; cursor: pointer;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0 var(--density-space-sm);
+  border: none;
+  background: transparent;
+  cursor: pointer;
   color: var(--token-text-muted);
-  transition: background-color var(--duration-normal) var(--ease-out),
-    color var(--duration-normal) var(--ease-out);
+  font-size: var(--density-font-size-md);
+  font-weight: 600;
+  -webkit-tap-highlight-color: transparent;
+  transition:
+    background-color var(--icen-tx-fast),
+    color var(--icen-tx-fast);
+}
+.stepper-btn:hover:not(:disabled) {
+  background: var(--token-control-hover);
+  color: var(--token-text);
+}
+.stepper-btn:focus-visible {
+  outline: none;
+  box-shadow: inset 0 0 0 2px color-mix(in srgb, var(--token-accent) 50%, transparent);
+}
+.stepper-btn:disabled,
+.stepper-btn[aria-disabled='true'] {
+  opacity: var(--icen-disabled-opacity);
+  cursor: not-allowed;
 }
-.stepper-btn:hover { background: var(--token-control-hover); color: var(--token-text); }
-.stepper-btn:disabled { opacity: 0.4; cursor: not-allowed; }
 
 .stepper-input {
-  width: 56px; padding: 8px 0;
-  text-align: center; font-variant-numeric: tabular-nums;
-  background: transparent; outline: none; border: none;
+  width: 56px;
+  padding: var(--density-space-sm) 0;
+  text-align: center;
+  font-variant-numeric: tabular-nums;
+  background: transparent;
+  outline: none;
+  border: none;
   border-left: 1px solid var(--token-outline-soft);
   border-right: 1px solid var(--token-outline-soft);
-  color: var(--token-text); font: inherit; font-size: 13px;
+  color: var(--token-text);
+  font: inherit;
+  font-size: var(--density-font-size-md);
 }
 /* 隐藏原生 number 箭头（± 交给 .stepper-btn） */
 .stepper-input::-webkit-outer-spin-button,
-.stepper-input::-webkit-inner-spin-button { -webkit-appearance: none; margin: 0; }
-.stepper-input[type='number'] { -moz-appearance: textfield; appearance: textfield; }
+.stepper-input::-webkit-inner-spin-button {
+  -webkit-appearance: none;
+  margin: 0;
+}
+.stepper-input[type='number'] {
+  -moz-appearance: textfield;
+  appearance: textfield;
+}
 
 /* ── OTP 验证码单元格 ── */
-.otp { display: inline-flex; align-items: center; gap: 8px; }
-
+.otp {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--density-space-sm);
+}
 .otp-cell {
-  width: 40px; height: 48px; padding: 0;
-  text-align: center; font-size: 18px; font-weight: 600;
+  width: 40px;
+  height: 48px;
+  padding: 0;
+  text-align: center;
+  font-size: 18px;
+  font-weight: 600;
+  font-family: var(--font-mono);
   color: var(--token-text);
   background: var(--token-control);
   border: 1px solid var(--token-outline-soft);
-  border-radius: var(--radius-sm);
+  border-radius: var(--radius-md);
   outline: none;
-  transition: border-color var(--duration-normal) var(--ease-out),
-    box-shadow var(--duration-normal) var(--ease-out);
+  transition:
+    border-color var(--icen-tx-fast),
+    box-shadow var(--icen-tx-fast);
+}
+.otp-cell:hover {
+  border-color: var(--icen-hover-border);
 }
 .otp-cell:focus-visible {
+  border-color: var(--icen-control-focus-border);
+  box-shadow: var(--icen-control-focus-shadow);
+}
+.otp-cell.is-filled {
   border-color: var(--token-accent);
-  box-shadow: 0 0 0 2px var(--token-accent-subtle);
+  background: var(--token-accent-subtle);
+}
+.otp-cell:disabled,
+.otp-cell[aria-disabled='true'] {
+  opacity: var(--icen-disabled-opacity);
+  cursor: not-allowed;
+}
+.otp--sm .otp-cell { width: 32px; height: 40px; font-size: var(--density-font-size-lg); }
+.otp--lg .otp-cell { width: 48px; height: 56px; font-size: 22px; }
+
+@media (prefers-reduced-motion: reduce) {
+  .segmented-item, .toggle-item, .stepper-btn, .stepper, .otp-cell { transition: none; }
 }
-.otp-cell:disabled { opacity: 0.4; cursor: not-allowed; }

package/dist/components/segmented.mjs

@@ -0,0 +1,2 @@
+// @icen.ai/ui — kit: segmented（CSS + behavior 一行入口；构建产物，勿手改）
+import './segmented.css';

package/dist/components/select.css

@@ -2,78 +2,179 @@
  * @icen.ai/ui — Component: select（弹层选择器）
  * 规格源自 opengal primitives/input.tsx 的 Select；与 behaviors/select.ts 配套。
  *
- * 契约：
- *   <div class="select" data-select>
- *     <button class="select-trigger pressable focus-ring" aria-haspopup="listbox" aria-expanded="false">
- *       <span class="select-leading">…</span>        可选前缀
+ * 完整契约：
+ *   <div class="select [data-disabled] [.is-open]" data-select>
+ *     <button class="select-trigger pressable focus-ring [--sm|--lg]" aria-haspopup="listbox"
+ *             aria-expanded="false" [disabled]>
+ *       <span class="select-leading">…</span>           可选前缀
  *       <span class="select-value is-empty">占位</span>
  *       <svg class="select-chevron">…</svg>
  *     </button>
- *     <div class="select-panel" hidden>
- *       <button class="select-option" data-value="x">…</button>
+ *     <div class="select-panel" hidden role="listbox">
+ *       <button class="select-option [.is-focused|.is-selected|.is-disabled]" data-value="x">…</button>
  *     </div>
  *     <input type="hidden" data-select-value />     可选，behavior 同步 value
  *   </div>
- * 状态：容器 .is-open；选项 .is-focused / .is-selected（尾部 ✓）/ .is-disabled；
- *       .select-value.is-empty = 未选占位（faint 色，behavior 选中后移除）。
+ *
+ * behavior 维护：
+ *   - .select.is-open ↔ aria-expanded；panel [hidden] 切换；ESC/外部点击关闭
+ *   - 选项 .is-focused 跟随键盘箭头；Enter 选中 → 写回 .select-value / .is-selected
  */
 
-.select { position: relative; width: 100%; }
+.select {
+  position: relative;
+  width: 100%;
+  isolation: isolate; /* panel 不被后面兄弟节点的层叠遮挡 */
+}
 
 .select-trigger {
-  display: flex; align-items: center; gap: 8px; width: 100%;
-  height: 36px; padding: 0 12px; font-size: 13px; text-align: left;
-  background: var(--token-control); color: var(--token-text);
+  display: flex;
+  align-items: center;
+  gap: var(--density-space-xs);
+  width: 100%;
+  height: var(--density-input-height-md);
+  padding: 0 var(--density-space-sm);
+  font-size: var(--density-font-size-md);
+  text-align: left;
+  background: var(--token-control);
+  color: var(--token-text);
   border: 1px solid var(--token-outline-soft);
-  border-radius: var(--radius-lg);
+  border-radius: var(--radius-md);
   box-shadow: var(--token-shadow-inset);
   cursor: pointer;
+  transition:
+    border-color var(--icen-tx-fast),
+    box-shadow var(--icen-tx-fast);
+}
+.select-trigger:hover:not(:disabled) {
+  border-color: var(--icen-hover-border);
+}
+.select-trigger:focus-visible {
+  outline: none;
+  border-color: var(--icen-control-focus-border);
+  box-shadow: var(--icen-control-focus-shadow);
+}
+.select-trigger:disabled,
+.select[data-disabled] .select-trigger,
+.select[aria-disabled='true'] .select-trigger {
+  opacity: var(--icen-disabled-opacity);
+  cursor: not-allowed;
+  pointer-events: none;
 }
-.select-trigger:focus-visible { border-color: var(--token-accent); }
-.select-trigger:disabled { opacity: 0.4; cursor: not-allowed; }
 
-.select-trigger--sm { height: 32px; padding: 0 10px; font-size: 12px; }
-.select-trigger--lg { height: 40px; padding: 0 14px; font-size: 14px; }
+/* 尺寸变体（与 input-wrap 对齐） */
+.select-trigger--sm { height: var(--density-input-height-sm); padding: 0 10px; font-size: var(--density-font-size-sm); }
+.select-trigger--lg { height: var(--density-input-height-lg); padding: 0 var(--density-space-md); font-size: var(--density-font-size-lg); }
 
 .select-leading {
-  display: inline-flex; align-items: center; flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  flex-shrink: 0;
   color: var(--token-text-faint);
 }
-.select-value { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-.select-value.is-empty { color: var(--token-text-faint); }
+.select-leading svg { width: 14px; height: 14px; }
+
+.select-value {
+  flex: 1;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.select-value.is-empty {
+  color: color-mix(in srgb, var(--token-text-faint) 60%, transparent);
+}
 
 .select-chevron {
-  width: 14px; height: 14px; flex-shrink: 0;
+  width: 14px;
+  height: 14px;
+  flex-shrink: 0;
   color: var(--token-text-faint);
-  transition: transform var(--duration-fast) var(--ease-out);
+  transition: transform var(--icen-tx-fast);
 }
 .select.is-open .select-chevron { transform: rotate(180deg); }
 
 .select-panel {
-  position: absolute; top: calc(100% + 4px); left: 0;
-  min-width: 100%; max-height: 240px; overflow-y: auto; padding: 4px;
+  position: absolute;
+  top: calc(100% + 4px);
+  left: 0;
+  min-width: 100%;
+  max-height: 240px;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+  padding: 4px;
   background: var(--token-card-strong);
   border: 1px solid var(--token-outline);
-  border-radius: var(--radius-lg);
+  border-radius: var(--radius-md);
   box-shadow: var(--token-shadow-overlay);
   z-index: var(--z-popover);
   transform-origin: top center;
-  animation: select-panel-in var(--duration-fast) var(--ease-out);
+  animation: select-panel-in var(--icen-tx-fast);
 }
 @keyframes select-panel-in {
-  from { opacity: 0; transform: scale(0.95); }
-  to { opacity: 1; transform: scale(1); }
+  from { opacity: 0; transform: scale(0.96) translateY(-4px); }
+  to { opacity: 1; transform: scale(1) translateY(0); }
+}
+@media (prefers-reduced-motion: reduce) {
+  .select-panel { animation: none; }
 }
 
+/* 选项 */
 .select-option {
-  display: flex; align-items: center; gap: 8px; width: 100%;
-  padding: 6px 10px; font-size: 12px; text-align: left;
-  border: none; background: transparent; color: var(--token-text);
-  border-radius: var(--radius-sm); cursor: pointer;
-  transition: background-color var(--duration-fast) var(--ease-out),
-    color var(--duration-fast) var(--ease-out);
-}
-.select-option.is-focused { background: var(--token-fill-2); }
-.select-option.is-selected { color: var(--token-accent); }
-.select-option.is-selected::after { content: '✓'; margin-left: auto; flex-shrink: 0; }
-.select-option.is-disabled { opacity: 0.4; cursor: not-allowed; }
+  display: flex;
+  align-items: center;
+  gap: var(--density-space-xs);
+  width: 100%;
+  padding: 6px var(--density-space-sm);
+  font-size: var(--density-font-size-sm);
+  text-align: left;
+  border: none;
+  background: transparent;
+  color: var(--token-text);
+  border-radius: var(--radius-sm);
+  cursor: pointer;
+  transition:
+    background-color var(--icen-tx-fast),
+    color var(--icen-tx-fast);
+}
+.select-option:hover:not(.is-disabled) { background: var(--token-fill-1); }
+.select-option.is-focused {
+  background: var(--token-fill-2);
+  color: var(--token-text);
+}
+.select-option.is-selected {
+  color: var(--token-accent);
+  font-weight: 500;
+  background: var(--token-accent-subtle);
+}
+.select-option.is-selected::after {
+  content: '✓';
+  margin-left: auto;
+  flex-shrink: 0;
+  color: var(--token-accent);
+}
+.select-option.is-disabled {
+  opacity: 0.4;
+  cursor: not-allowed;
+}
+
+/* 分组（行为可选渲染 optgroup） */
+.select-group {
+  padding: 0 4px;
+  margin-top: 4px;
+}
+.select-group-label {
+  padding: 6px var(--density-space-sm) 2px;
+  font-size: var(--density-font-size-xs);
+  color: var(--token-text-faint);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+/* 空状态（behavior 渲染 no-match） */
+.select-empty {
+  padding: var(--density-space-md);
+  font-size: var(--density-font-size-sm);
+  color: var(--token-text-faint);
+  text-align: center;
+}

package/dist/components/select.mjs

@@ -0,0 +1,3 @@
+// @icen.ai/ui — kit: select（CSS + behavior 一行入口；构建产物，勿手改）
+import './select.css';
+export * from '../behaviors/select.mjs';