@kkwww/casual-ui 0.0.0-stage → 2.0.3

package/UPGRADE-1.5.md

@@ -0,0 +1,46 @@
+# 1.5.0 日期检查与通知位置
+
+## 通知位置
+
+支持 `top-left`（左上）、`bottom-left`（左下）、`top-right`（右上）、`bottom-right`（右下，默认）、`center`（中间）、`top-center`（中上）、`bottom-center`（中下）。
+
+全局默认位置：
+
+```vue
+<template>
+  <CuToastProvider position="top-right" :duration="5000">
+    <NuxtPage />
+  </CuToastProvider>
+</template>
+```
+
+单条通知覆盖默认位置：
+
+```ts
+const toast = useCasualToast()
+toast.add({
+  title: '保存成功',
+  description: '业务文案通过项目自己的国际化字典提供。',
+  position: 'top-center',
+  variant: 'success',
+  duration: 5000,
+})
+```
+
+普通 Vue 使用 `useToast()`；支持从 `@kkwww/casual-ui` 或 `/feedback` 导入 `toastPositions`、`ToastPosition` 类型。已有 `add`、`update`、`remove`、`clear` 接口不变，`update(id, {position:'center'})` 可移动现有通知。
+
+同一位置的通知堆叠，不同位置可以同时显示；全局保留最近五条。位置优先级为单条通知、显式 ToastViewport、ToastProvider、默认右下。自定义 ToastViewport 时，设置 Provider 的 `:viewport="false"`，避免重复渲染。默认样式最大宽度 384px，窄屏缩至视口宽度，保留内边距，支持滚动和键盘关闭。
+
+## 日期选择器
+
+CalendarPicker、DatePicker、DateRangePicker、DateTimePicker、DateTimeRangePicker 使用同一个日历样式。跨月补位日期不重复显示选中、范围预览或今天的背景；所属月份正常高亮。保留灰色补位日期及原有点击行为。
+
+在线日期示例和 Nuxt 示例增加跨月、跨年、闰年场景切换。桌面区间默认双月，手机默认单月，日期时间区间的时间输入在手机上纵向排列；长日期结果允许换行。
+
+验证：四种日期选择弹窗 × 三种日期场景 × 三种尺寸共 36 组；手机跨年翻月；七个通知位置的桌面和手机布局。日期和时间格式、业务值、接口未改变。
+
+## 1.5.1 时间滚轮
+
+TimePicker、DateTimePicker 及 DateTimeRangePicker 的开始/结束时间均支持滚轮。鼠标停在时、分、秒上，向上增加、向下减少；每次只调整当前段，循环规则与方向键一致（秒 59 向上变为 00，不进位到分钟）。触控板小幅滚动会累积，避免数字跳动过快。
+
+禁用、只读状态不响应。Ctrl/Meta 缩放、Shift 和横向滚动保留浏览器行为；冒号、图标及组件外滚动仍由页面处理。区间滚轮编辑保持草稿，点击应用后提交。SSR、日期格式和原有校验方式不变，无需修改接入 API。

package/UPGRADE-2.0.md

@@ -0,0 +1,45 @@
+# Casual UI 2.0.2
+
+此次是完整命名迁移，不提供旧包名、旧组件名、旧配置键或旧函数的兼容别名。
+
+## 安装
+
+通过 pnpm 远程安装 Vue / Nuxt 包：
+
+```sh
+pnpm add --save-exact @kkwww/casual-ui@2.0.2
+```
+
+包名是 `@kkwww/casual-ui`。Vue/Nuxt 包从 npm 官方 registry 安装。
+
+## Nuxt
+
+```ts
+export default defineNuxtConfig({
+  modules: ['@kkwww/casual-ui/nuxt'],
+  casualUI: { prefix: 'Cu', locale: 'zh-CN' },
+})
+```
+
+```vue
+<template>
+  <CuToastProvider position="top-right">
+    <NuxtLayout><NuxtPage /></NuxtLayout>
+  </CuToastProvider>
+</template>
+```
+
+自动导入的组合式函数为 `useCasualI18n()`、`useCasualLocale()`、`useCasualToast()`。品牌组件为 `CuCasualLogo`，普通 Vue 导出名为 `CasualLogo`。
+
+## Vue
+
+```ts
+import { Button, DateTimeRangePicker, CasualLogo, installCasualI18n, installCasualConfig, installCasualToast } from '@kkwww/casual-ui'
+import '@kkwww/casual-ui/styles.css'
+```
+
+其余通用组件与 `useI18n()`、`useToast()` 等无品牌名称的导出不变。组件行为、日期模型、秒级滚轮、通知七种位置、SSR 和国际化能力不变。
+
+CSS 内部类名前缀为 `cu-`，语言持久化与注入键也使用 Casual 命名。迁移时删除旧包依赖及模块注册，替换所有带品牌的导入、组件前缀、配置及函数调用；不要同时注册两套模块。清理针对旧内部类名的覆盖样式，优先使用组件公开属性和插槽。
+
+默认组件前缀是 Cu，也可通过 prefix 明确设置项目自己的前缀。示例和文档全部使用默认新命名。