@kungal/ui-core 1.6.0 → 1.6.2

package/CHANGELOG.md

@@ -0,0 +1,360 @@
+# @kungal/ui-core
+
+## 1.6.2
+
+### Patch Changes
+
+- 05f2bee: chore: ship CHANGELOG.md in the published packages
+
+  `CHANGELOG.md` is now included in each package's npm tarball (added to `files`),
+  so downstream can read the per-version changes straight from the npm package
+  page — not only from the GitHub repo. (Releases also now appear on GitHub
+  Releases and the docs site's auto-generated /changelog page.)
+
+## 1.6.1
+
+## 1.6.0
+
+## 1.5.0
+
+### Minor Changes
+
+- 13005ea: fix(vue): legible foreground on solid/filled color variants (esp. dark mode)
+
+  Solid fills painted white text on `bg-{color}`, which has two problems verified
+  by contrast measurement:
+
+  1. The dark color scale is inverted, so a plain `bg-{color}` renders **pale** in
+     dark mode — white text dropped to ~1.0–2.5:1 (the `solid` Info `info` callout
+     was essentially invisible, white on near-white).
+  2. The light hues (secondary / success / warning / info) are light in **both**
+     modes, so white text fails WCAG everywhere (~2:1), not just in dark mode.
+
+  New single source of truth in `@kungal/ui-core` — `kunSolidClasses`,
+  `kunSolidBgClasses`, `kunSolidFgClasses` — pairs each fill with a `dark:bg-*`
+  pin (stays saturated in dark mode) and a contrast-correct foreground: the dark
+  hues (default / primary / danger) keep white, the light hues take dark text.
+  Every solid foreground now clears WCAG AA in both modes (≈4.1–10.3:1).
+
+  Applied to: Button / Chip (shared variant matrix), Info (`solid` / `shadow` — the
+  reported bug; its title no longer overrides the box foreground), Badge, Progress
+  (on-bar label), Tab (`solid` / `pills`), DatePicker (selected day), CheckBox
+  (checked fill + check/dash mark), Switch (on-track).
+
+  Visible change: `secondary` / `success` / `warning` / `info` solid components now
+  use dark text instead of (illegible) white.
+
+## 1.4.2
+
+## 1.4.1
+
+## 1.4.0
+
+## 1.3.0
+
+## 1.2.0
+
+## 1.1.1
+
+## 1.1.0
+
+## 1.0.0
+
+### Major Changes
+
+- ac0bd4e: 1.0.0 — first stable release.
+
+  The component set (57 Vue components) and the design-token system are stable and
+  documented. Over the 0.14 → 0.22 line every cross-cutting surface was routed
+  through a single source of truth: borders (`--color-kun-border` / `border-kun`),
+  focus rings (`kunFocusRingClasses`), corner radius (`rounded-kun-*` /
+  `--kun-radius-scale`), elevation (`--shadow-kun-*`), motion (`--kun-dur-*` +
+  `duration-kun-*` + `ease-kun-*`), and sizing (`kunControlSize` /
+  `kunSelectionSize` / `kunChipSize`).
+
+  Also fixes a registration gap surfaced while completing the docs: `KunAutocomplete`,
+  `KunNumberInput`, and `KunPinInput` (added in 0.14.0) were never added to the Nuxt
+  layer's auto-import list, so Nuxt consumers hit "Failed to resolve component". They
+  now auto-import like every other component (plain-Vue `app.use(KunUI)` already
+  registered them). Their docs pages, prop tables, and `llms.txt` entries are added.
+
+## 0.22.4
+
+## 0.22.3
+
+## 0.22.2
+
+### Patch Changes
+
+- 957cb52: fix(core): `shadow` button variant now actually casts its colored glow
+
+  The `shadow` variant set a shadow _color_ (`shadow-{color}/40`) but never a shadow
+  _size_, so `--tw-shadow` stayed empty and the button rendered with `box-shadow:
+none` — it looked identical to `solid`. Added `shadow-lg` to every entry so the
+  geometry exists and the tint applies: each shadow button now floats with a soft
+  diffuse glow in its own color (the button's `overflow-hidden` doesn't clip an
+  outset box-shadow, so it shows in both themes).
+
+## 0.22.1
+
+### Patch Changes
+
+- be17775: fix(core): consistent dark-mode fill for solid / shadow buttons
+
+  Filled (`solid` / `shadow`) buttons keep white text in both themes, but the dark
+  color scale is inverted — `bg-{color}` (a `-500`/`-600` step) renders _light_ in
+  dark mode, so the fills came out pale and at wildly different levels: `info`
+  ≈ L88% (near-white, white text barely legible), `default` ≈ L65%, `secondary`
+  ≈ L72%, and `success` disagreed between the two variants (solid pinned
+  `dark:bg-success-300` ≈ L35% while shadow used the un-pinned `bg-success-600`
+  ≈ L66%).
+
+  Each color now pins a `dark:bg-{color}-{n}` so every solid/shadow button lands at
+  a consistent ~L44–55% in dark mode (info/success/default → ~L44–46, the rest
+  ~L47–55) — one saturated tier with legible white text. Light mode is unchanged.
+
+## 0.22.0
+
+## 0.21.0
+
+### Minor Changes
+
+- 3e841f0: feat: align form labels / error text and unify the chip-tag size scale
+
+  The core size system was already consistent (form controls share
+  `kunControlSizeClasses`, checkbox/radio share `kunSelectionSizeClasses`). The
+  drift was in the peripheral bits:
+
+  - **Form labels** now identical everywhere: `KunTextarea` and `KunDatePicker`
+    labels gained the `text-default-700` tint, and `KunDatePicker` dropped its odd
+    `mb-2` for the standard `mb-1`.
+  - **Error messages** now identical: `KunTextarea` switched from `text-danger-600`
+    (and a `<div>`) to the standard `text-danger` `<p>`; `KunDatePicker` and
+    `KunRadioGroup` dropped `mt-2` for `mt-1`.
+  - **Chip / tag size**: new `kunChipSizeClasses` in `@kungal/ui-core` is the single
+    source for chip/tag pills. `KunChip` and the tags inside `KunTagInput` now share
+    it (and the pill `rounded-full` shape), so a tag looks identical to a standalone
+    `<KunChip>` of the same size instead of being a one-off smaller rounded-rect.
+
+  Tab keeps its intentionally-compact tab scale; Switch/Slider keep their
+  dimension-specific scales.
+
+## 0.20.0
+
+## 0.19.1
+
+## 0.19.0
+
+### Minor Changes
+
+- d8e7e76: feat: KunTab `align` prop + one unified focus ring across every control
+
+  **KunTab `align`** — new `align?: 'start' | 'center' | 'end'` (default `'center'`)
+  controls how each tab's content sits inside its box. Mainly for vertical /
+  full-width tabs, where the box is wider than its label.
+
+  **Unified focus ring** — focus indication was a mess: `:focus` vs `:focus-within`
+  vs `:focus-visible`, ring widths `1`/`2`/`4`, opacities `/25`/`/40`/`/50`/full,
+  some controls dropped their border to fake a ring (a jarring jump), and Button /
+  CheckBox had **no** focus ring at all. Everything now routes through one recipe:
+
+  - New `kunFocusRingClasses` (direct controls) and `kunFocusRingWithinClasses`
+    (composite wrappers) in `@kungal/ui-core`. One recipe: keyboard-only
+    (`focus-visible`; text fields still show it on click), a flush **2px** ring in
+    the control's semantic color at **/50**, no border-transparent jump.
+  - Migrated Input, Textarea, Select, Autocomplete, NumberInput, DatePicker,
+    PinInput, TagInput, Pagination, RadioGroup, **Button** (offset ring, added) and
+    **CheckBox** (added) onto it. Composite widgets (NumberInput / TagInput) ring
+    the wrapper via `focus-within` and the inner `<input>` has no ring of its own,
+    so there's exactly one indicator.
+  - Invalid controls turn the ring **danger** (same mechanism, swapped color).
+  - **Deprecated:** `kunRingClasses` (mixed `:focus`/`:focus-within`, off-opacity).
+    Use `kunFocusRingClasses` / `kunFocusRingWithinClasses`.
+
+  No prop/API removals — purely additive plus a visual refinement of focus states.
+
+## 0.18.1
+
+## 0.18.0
+
+## 0.17.2
+
+## 0.17.1
+
+## 0.17.0
+
+## 0.16.0
+
+## 0.15.0
+
+## 0.14.0
+
+### Minor Changes
+
+- cd404aa: 表单 / 输入控件第一批升级:对标 HeroUI / Mantine / Ant Design / PrimeVue / Naive,补齐 API 完备性、一致性与高级控件。
+
+  新增组件
+
+  - **KunNumberInput** —— 数字步进输入:`min`/`max`/`step`/`precision` 钳制与四舍五入、−/+ 步进按钮(到边界自动禁用)、`ArrowUp/Down`·`PageUp/Down` 键盘、`role="spinbutton"` 无障碍、`name` 原生表单收集。
+  - **KunPinInput** —— OTP / 验证码分段输入:`length`、`type`(numeric/text)、`mask`、自动前进/退格回退、粘贴自动分发、方向键、`complete` 事件、`autocomplete="one-time-code"`。
+  - **KunAutocomplete** —— 组合框(combobox):文本输入 + 建议列表,客户端过滤或 `manualFilter` + `@search`(远程),`allowCustomValue`、`clearable`、键盘导航、`aria-autocomplete`。
+
+  升级
+
+  - **KunSelect** —— 补齐键盘可达性(P0):方向键 / Enter / Space / Esc / Home / End / 首字母 type-ahead + `aria-activedescendant`,禁用项自动跳过;新增 `searchable`(列表内过滤)、`multiple`(可移除 chips)、`clearable`、`description`、`name`(隐藏域)、选项 `disabled`。
+  - **KunSlider** —— 默认 `min`/`max` 由 17–77 改为 **0–100**;修复 `reactive(props)` 拷贝导致改 prop 不更新的响应式缺陷;新增 `disabled`、`label`/`ariaLabel`、`error`/`description`、`color`、`marks`、值气泡 `showTooltip`、`showValue`、`formatValue`、`change` 事件。
+  - **KunCheckBox** —— 新增 `indeterminate`(三态,用于全选)+ `error`/`description`。
+  - **KunInput** —— 新增 `isClearable`、`revealPassword`(密码可见性切换)、`isInvalid` + `aria-invalid`/`aria-describedby`。
+  - **KunSwitch** —— 新增 `error`/`description`。
+
+  统一
+
+  - 辅助文案统一为 `description`(对齐 HeroUI / React-Aria);`helperText`(Input/TagInput)与 `hint`(Textarea/FileInput/Upload)保留为 **已弃用别名**,仍可用,内部回退到 `description`。
+
+  Breaking(0.x minor)
+
+  - `KunSlider` 默认 `min`/`max` 改为 0–100(此前 17–77):依赖旧默认值的调用需显式传入。
+  - `KunSelect` 的 v-model 类型放宽为 `T | T[] | null`(支持 `multiple` 与清除);单选用法不受运行时影响,仅 TS 类型变宽。
+
+  新增打包图标(构建期内联,运行时零请求):`lucide:minus`、`eye`、`eye-off`、`search`。
+
+## 0.13.0
+
+## 0.12.0
+
+## 0.11.0
+
+## 0.10.0
+
+## 0.9.0
+
+## 0.8.0
+
+### Minor Changes
+
+- 7624924: Extend the unified size system to the non-text controls.
+
+  The first sizing pass only covered text controls (button/input/select/…). This
+  brings the selection + display controls onto the same coherent system, grounded
+  in how HeroUI / PrimeVue / Naive UI / Mantine / Ant size them.
+
+  - **New shared selection scale (`kunSelectionSizeClasses`, @kungal/ui-core)** —
+    KunCheckBox and KunRadioGroup now use **identical** box sizes (every major
+    library does this), so a checkbox and a radio of the same size match. Box px by
+    size: 12 / 14 / 16 / 20 / 24 — ≈ 0.5× the text-control height and ≈ 1.2–1.4× the
+    label font, so the box sits optically level with its label.
+  - **KunCheckBox gains a `size` prop** (`xs`–`xl`, default `md`). It was hardcoded
+    at 20px while its sibling KunRadioGroup scaled 12→24 — now they share one scale
+    (md box is 16px). The check glyph and label scale with it.
+  - **KunSwitch gains a `size` prop.** Track/thumb scale on clean steps (track
+    28×16 → 64×32, thumb = track height − 4); `md` is the original switch size.
+  - **KunSlider gains a `size` prop.** Track 4→12px, thumb 14→28px; `md` unchanged.
+  - **KunChip** moved onto its proper compact sub-scale (≈ 0.7× the button height at
+    the same keyword — a tag is text + tight padding, not a tap target); its `md`/
+    `lg`/`xl` vertical padding is slightly tighter so chips no longer read as tall
+    as buttons.
+
+  Components sized by their content/padding rather than a height (KunTooltip,
+  KunDropdown/KunContextMenu menus, KunPopover, KunInfo) intentionally keep no
+  `size` prop — no surveyed library gives them one.
+
+## 0.7.0
+
+### Minor Changes
+
+- 29a39a7: Unify form-control sizing on one shared scale, and fix the `lg`/`xl` button
+  proportions.
+
+  - **New `kunControlSizeClasses` (@kungal/ui-core)** — a single source of truth for
+    the per-size font + padding of every text-like form control. Padding-driven,
+    `md` (~38px) as the anchor, `px:py` a clean 2:1, horizontal padding growing
+    faster than vertical so a bigger control gets wider, not flatter.
+  - **KunButton `lg`/`xl` fixed** — `lg` was `px-6 py-2` (3:1) and `xl` was
+    `px-8 py-2.5` (3.2:1, a wide flat bar). They're now `px-5 py-2.5` and
+    `px-6 py-3` (both 2:1), so large buttons look proportional. `md` is unchanged.
+  - **One scale across controls** — KunButton, KunInput, KunSelect, KunDatePicker,
+    KunTextarea and KunTagInput all consume the shared scale, so a button, input,
+    select and date-picker of the same size line up at the same height in a row
+    (md = 38px).
+  - **KunSelect / KunDatePicker / KunTextarea gain a `size` prop** (`xs`–`xl`,
+    default `md`). Previously they had no size and were locked one notch tighter
+    than buttons (`px-3` / `p-3`); their default horizontal padding is now `px-4`,
+    matching KunButton/KunInput `md`.
+
+  Pill/compact display components (KunChip, KunBadge, KunAvatar) are intentionally
+  not part of this form-control scale and keep their compact sizing.
+
+## 0.6.2
+
+## 0.6.1
+
+## 0.6.0
+
+## 0.5.2
+
+## 0.5.1
+
+## 0.5.0
+
+## 0.4.1
+
+## 0.4.0
+
+## 0.3.4
+
+## 0.3.3
+
+## 0.3.2
+
+## 0.3.1
+
+## 0.3.0
+
+### Minor Changes
+
+- 9b8cbae: Remove the `faded` variant.
+
+  `faded` (tinted fill + border) was visually almost indistinguishable from
+  `ghost`, so it's been dropped from `KunUIVariant`. This affects every variant
+  consumer — `KunButton`, `KunChip`, `KunDropdown` and `KunInfo`.
+
+  **Migration:** replace `variant="faded"` with `variant="flat"` (tinted fill, no
+  border) or `variant="bordered"` (visible colored border); `ghost` stays for the
+  outline look it overlapped with.
+
+## 0.2.5
+
+## 0.2.4
+
+### Patch Changes
+
+- 0ec98f9: Fix invisible outline variants (`bordered` / `faded` / `ghost`) and the
+  off-center checkbox check.
+
+  - **Variant table**: entries set `border-{color}` but never a border _width_ —
+    which paints nothing in Tailwind v4, so `bordered` / `faded` / `ghost` showed
+    no border on KunButton, KunChip and KunDropdown. Every variant now carries an
+    explicit `border` width (transparent on `solid` / `light` / `flat` / `shadow`
+    so box sizes stay uniform when switching variants), so the outline variants
+    render again.
+  - **KunCheckBox**: the checkmark was a full-size (1em) icon nudged down by its
+    baseline offset, so it sat off-center and cramped the 20px box edge-to-edge.
+    It's now an explicitly-sized 14px check centered with flexbox.
+
+## 0.2.3
+
+## 0.2.2
+
+## 0.2.1
+
+## 0.2.0
+
+### Minor Changes
+
+- 35358f2: Settle on the `@kungal/ui-*` package namespace; the four packages are versioned and released together.
+
+## 0.1.1
+
+### Patch Changes
+
+- c532a02: Add npm `keywords` to every package for better discoverability on the npm registry.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kungal/ui-core",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "KunUI framework-agnostic core — design types, cn(), variant matrix, radius system, utils. No Vue/React.",
   "type": "module",
   "keywords": [
@@ -25,6 +25,7 @@
   },
   "sideEffects": false,
   "files": [
+    "CHANGELOG.md",
     "dist"
   ],
   "main": "./dist/index.cjs",