@94ai-plus/nf-date-picker 0.0.0-stage → 1.0.0-alpha.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 94AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,70 @@
-# Temporary Holding Version
+<!-- common-ui-plus:brand:start -->
+<h1 align="center">
+  <a href="https://oss.xccjh.top/common-ui-plus/index.html">
+    <img src="https://cdn.jsdelivr.net/npm/@94ai-plus/nf-date-picker@1.0.0-alpha.5/dist/readme/94logo.png" width="150" height="50" alt="94AI" />
+    &nbsp;
+    <img src="https://cdn.jsdelivr.net/npm/@94ai-plus/nf-date-picker@1.0.0-alpha.5/dist/readme/common-plus.svg" width="300" height="50" alt="common-ui+" />
+  </a>
+</h1>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<p align="center">
+  <a href="https://www.npmjs.com/package/@94ai-plus/nf-date-picker"><img src="https://img.shields.io/npm/v/%4094ai-plus/nf-date-picker/latest.svg?label=version" alt="npm latest 版本" /></a>
+  <a href="https://nodejs.org/en/blog/release/v22.13.0"><img src="https://img.shields.io/badge/Node.js-22.13.0-5FA04E.svg" alt="开发环境 Node.js 22.13.0" /></a>
+  <a href="https://vuejs.org/"><img src="https://img.shields.io/badge/Vue-3.5-42B883.svg" alt="Vue 3.5" /></a>
+  <a href="https://cdn.jsdelivr.net/npm/@94ai-plus/nf-date-picker@1.0.0-alpha.5/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License" /></a>
+  <a href="https://oss.xccjh.top/common-ui-plus-badges/test-pass-rate.svg"><img src="https://oss.xccjh.top/common-ui-plus-badges/test-pass-rate.svg" alt="Repository test pass rate (default branch), not per-package results" /></a>
+  <a href="https://oss.xccjh.top/common-ui-plus-badges/coverage.svg"><img src="https://oss.xccjh.top/common-ui-plus-badges/coverage.svg" alt="Repository source line coverage (default branch), not per-package coverage" /></a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@94ai-plus/nf-date-picker"><img src="https://nodei.co/npm/@94ai-plus/nf-date-picker.svg?downloads=true&amp;downloadRank=true" width="360" alt="NPM" /></a>
+</p>
+<!-- common-ui-plus:brand:end -->
+
+# @94ai-plus/nf-date-picker
+
+## [HomePage](https://oss.xccjh.top/common-ui-plus/index.html)
+
+[官网](https://oss.xccjh.top/common-ui-plus/index.html) · [项目仓库](http://gitlab.94ai.pro/ui/common-ui-plus)
+
+Vue 3 / Element Plus 半年、半年区间和周区间选择器。季度、季度区间、周、年和年区间直接使用 Element Plus 原生类型。
+
+```ts
+import NfDatePicker, { NfHalfYearPicker, NfHalfYearRangePicker, NfWeekRangePicker } from '@94ai-plus/nf-date-picker'
+import '@94ai-plus/nf-date-picker/style.css'
+app.use(NfDatePicker)
+```
+
+```vue
+<NfHalfYearPicker v-model="half" value-format="YYYY-MM-DD" />
+<NfHalfYearRangePicker v-model="halves" value-format="YYYY-MM-DD" />
+<NfWeekRangePicker v-model="weeks" value-format="YYYY-MM-DD" />
+```
+
+默认返回 Date / Date[]，valueFormat 指定时返回字符串，清空返回 null。半年使用 1 月 1 日／7 月 1 日作为值；半年区间返回两个半年起始日。周区间复用日期区间面板，选择完成后补齐完整周，周首日跟随 Element Plus 语言，也可用 weekStartsOn 指定。半年 disabledDate 判定半年起始日，周区间禁用包含不可选日期的整周。
+
+支持 standalone install、CommonUI 注册、自动导入、GlobalComponents 类型、八语言和 Chalk／OEM 主题。提供 change、calendar-change、visible-change、clear、focus、blur 事件及 focus/blur/handleOpen/handleClose 方法。半年选择通过只读面板完成。
+
+[完整 API 和示例](https://oss.xccjh.top/common-ui-plus/components/date-picker)
+
+## 全局默认配置
+
+通过总包的 `NfConfigProvider` 的 `nfDatePicker` 配置项设置默认属性；三个专用选择器也可分别通过 `nfHalfYearPicker`、`nfHalfYearRangePicker`、`nfWeekRangePicker` 覆盖；专用配置中未设置的属性回退到 `nfDatePicker`，组件显式属性优先于两者。支持响应式更新和嵌套继承，优先级为组件显式属性 → 最近一层配置 → 外层配置 → 组件原有默认值。`undefined` 继续继承，`false`、`0` 和空字符串保留；按属性合并，数组、对象和函数整体替换，不深度合并。初始化选项仍按组件原有生命周期生效，事件、插槽和原生 attributes 在组件上设置，必填业务数据仍需显式提供。详见[全局配置文档](https://oss.xccjh.top/common-ui-plus/components/fixture#component-defaults)。
+
+<!-- common-ui-plus:footer:start -->
+## Contributors
+
+感谢每一位参与项目建设的贡献者！
+
+![最近三个月的贡献者气泡图](https://cdn.jsdelivr.net/npm/@94ai-plus/nf-date-picker@1.0.0-alpha.5/dist/readme/contributors.svg)
+
+![最近三个月的贡献者头像墙（使用姓名首字母）](https://cdn.jsdelivr.net/npm/@94ai-plus/nf-date-picker@1.0.0-alpha.5/dist/readme/contributors-wall.svg)
+
+以上为随本版本发布的贡献者统计快照，统计日期与分支见图中说明；仅统计 Git 非合并提交，头像使用姓名首字母，不是 GitLab 个人照片。
+
+## License
+
+本项目采用 [MIT License](https://cdn.jsdelivr.net/npm/@94ai-plus/nf-date-picker@1.0.0-alpha.5/LICENSE) 开源许可。
+
+Copyright (c) 2026-present Jiahe Zou, 94 Intelligent Technology Co., Ltd.
+<!-- common-ui-plus:footer:end -->