@puresnake/snake-ui 0.0.0-stage → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PURESNAKE
+
+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/changelog.md

@@ -0,0 +1,83 @@
+# 更新日志
+
+## 0.0.2（2026-10-29）
+
+- 补齐 package.json `exports` 子路径：`./libs/*`、`./plugins/*`、`./locale/*`、`./iconfont.css`，接入方可以直接通过 `@puresnake/snake-ui/libs/...` 等子路径 import
+- 新增 `pnpm changelog:sync`：本文件单向同步到 `docs/components/changelog.md`，文档站更新日志随发版自动对齐
+
+## 0.0.1（2026-10-29）
+
+- 首个 npm 公开发布版本（`@puresnake/snake-ui`，MIT）
+- 基于 Vue 3 + TypeScript 的 uni-app 组件库，面向商城与 CMS 场景
+- 14 个配置驱动的 CMS 页面区块，统一由 `snake-cms` 渲染
+- 内置明暗主题（`theme.scss`）、`zh-CN` / `en-US` 多语言、基于 `uni.request` 的 HTTP 客户端与常用 hooks / 工具
+- easycom 按需引入，精简打包体积
+- 兼容 H5、微信小程序、App 等多端
+
+## 组件索引
+
+以下清单随组件目录更新，当前共 46 个通用组件入口。
+
+基础组件（12）
+
+- Parse 富文本解析
+- ConfigProvider 全局配置
+- Button 按钮
+- Icon 图标
+- Image 图片
+- QrCode 二维码
+- Loading 加载
+- Skeleton 骨架屏
+- Transition 过渡动画
+- RootPortal 根节点传送
+- Text 文本
+- Link 超链接
+
+表单组件（11）
+
+- Form 表单
+- Input 输入框
+- Textarea 文本域
+- Checkbox 复选框
+- Radio 单选框
+- Switch 开关
+- Slider 滑动选择器
+- Search 搜索框
+- Select 列选择器
+- Upload 文件上传
+- Calendar 日历
+
+数据组件（5）
+
+- Loadmore 加载更多
+- LineProgress 线形进度条
+- ReadMore 阅读更多
+- Empty 空状态
+- CountDown 倒计时
+
+反馈组件（5）
+
+- NoticeBar 通知栏
+- Overlay 遮罩层
+- Tooltip 文字提示
+- Popup 弹出层
+- NoNetwork 无网络提示
+
+布局组件（4）
+
+- Swiper 轮播图
+- Sticky 吸顶
+- Line 分隔线
+- Cell 单元格
+
+导航组件（9）
+
+- Navbar 导航栏
+- Tabbar 底部导航栏
+- Tabs 标签页
+- Subsection 分段器
+- ButtonSort 排序按钮
+- DropMenu 下拉菜单
+- IndexList 索引列表
+- IndexListPanel 容器索引列表
+- IndexAnchor 索引锚点

package/components/snake-activity-list/snake-activity-list.vue

@@ -0,0 +1,365 @@
+<template>
+    <view v-if="list.length" class="activity-list">
+        <scroll-view
+            class="scroll-view"
+            :scroll-x="list.length > 3"
+            :scroll-left="tabsScrollLeft"
+            :scroll-with-animation="true"
+        >
+            <view class="activity-list__nav" role="tablist" aria-label="活动场次">
+                <template v-for="(item, index) in list" :key="index">
+                    <view
+                        class="activity-list__item"
+                        :class="{
+                            'activity-list__item--active': current == item.id,
+                            'activity-list__item--clicking': clickingIndex == index
+                        }"
+                        role="tab"
+                        :aria-selected="current == item.id"
+                        :tabindex="current == item.id ? 0 : -1"
+                        @click="handelClick(item, index)"
+                        @keydown.enter.prevent="handelClick(item, index)"
+                        @keydown.space.prevent="handelClick(item, index)"
+                        @keydown.left.prevent="selectAdjacent(index, -1)"
+                        @keydown.right.prevent="selectAdjacent(index, 1)"
+                    >
+                        <!-- 图片 -->
+                        <image
+                            class="activity-list__image"
+                            :src="item.squareImage || 'https://s.qiuxietang.com/images/202507/1390637519904706560.png'"
+                            mode="aspectFill"
+                        ></image>
+                        <!-- 倒计时 -->
+                        <view class="activity-list__time" :style="timeStyle(item)">
+                            <view
+                                class="activity-list__time-box"
+                                v-if="item.endTime"
+                                :style="{
+                                    backgroundColor:
+                                        currentTime > item.startTime ? 'var(--snake-color-error, #ff525d)' : ''
+                                }"
+                            >
+                                <text v-if="currentTime < item.startTime">拍卖预告</text>
+                                <template v-else>
+                                    <view class="activity-list__time-icon">
+                                        <snake-icon
+                                            name="clock"
+                                            size="20rpx"
+                                            color="var(--snake-color-white, #ffffff)"
+                                        ></snake-icon>
+                                    </view>
+                                    <text class="activity-list__countdown">
+                                        {{ uni.$snake.formatTime(item.endTime, 'mm-dd hh:MM') }}
+                                    </text>
+                                </template>
+                            </view>
+                        </view>
+                        <!-- 标题 -->
+                        <view class="activity-list__title" v-if="index !== 0 || list.length === 1">
+                            <text class="activity-list__title-main">{{ item.name }}</text>
+                            <text class="activity-list__title-sub" v-if="currentTime > item.startTime">
+                                {{ item.subtitle }}
+                            </text>
+                            <text class="activity-list__title-time activity-list__title-time--din" v-else>
+                                {{ uni.$snake.formatTime(item.startTime, 'mm-dd') }}
+                                <text class="activity-list__title-time--open">开场</text>
+                            </text>
+                        </view>
+                    </view>
+                </template>
+            </view>
+        </scroll-view>
+    </view>
+</template>
+
+<script>
+/**
+ * @component ActivityList
+ * @description 横向展示拍卖活动入口、时间状态和当前选中项，并自动将当前项滚动到容器中部。
+ */
+
+import Icon from '../snake-icon/snake-icon.vue';
+
+export default {
+    name: 'activity-list',
+    options: { virtualHost: true, styleIsolation: 'shared' },
+    components: { SnakeIcon: Icon },
+    emits: ['change'],
+    props: {
+        list: {
+            type: Array,
+            default() {
+                return [];
+            }
+        },
+        current: {
+            type: [String, Number],
+            default: '001'
+        }
+    },
+    data() {
+        return {
+            tabsScrollLeft: 0,
+            currentIndex: 0,
+            clickingIndex: -1,
+            clickTimer: undefined
+        };
+    },
+    computed: {
+        currentTime() {
+            return Date.now();
+        },
+        timeStyle() {
+            return item => {
+                const style = {};
+                if (this.current === item.id) {
+                    style.top = '0rpx';
+                    style.left = '0rpx';
+                }
+                return style;
+            };
+        }
+    },
+    async mounted() {
+        await uni.$snake.sleep(30);
+        this.list.forEach((item, index) => {
+            if (this.current === item.id) {
+                this.currentIndex = index;
+                this.scrollIntoView();
+            }
+        });
+    },
+    beforeUnmount() {
+        clearTimeout(this.clickTimer);
+    },
+    methods: {
+        handelClick(item, index) {
+            // 触发点击动画
+            this.clickingIndex = index;
+
+            // 150ms后结束点击动画
+            clearTimeout(this.clickTimer);
+            this.clickTimer = setTimeout(() => {
+                this.clickingIndex = -1;
+            }, 150);
+
+            this.currentIndex = index;
+            this.$emit('change', item, index);
+            this.scrollIntoView();
+        },
+        selectAdjacent(index, direction) {
+            if (!this.list.length) return;
+            const nextIndex = (index + direction + this.list.length) % this.list.length;
+            this.handelClick(this.list[nextIndex], nextIndex);
+        },
+        // 计算tab位置
+        scrollIntoView() {
+            // item滚动
+            this.getElementData('.activity-list__nav', data => {
+                const list = data[0];
+                this.getElementData('.activity-list__item', data2 => {
+                    const el = data2[this.currentIndex];
+                    this.tabsScrollLeft = el && el.width / 2 + -list.left + el.left - list.width / 2;
+                });
+            });
+        },
+        getElementData(el, callback) {
+            uni.createSelectorQuery()
+                .in(this)
+                .selectAll(el)
+                .boundingClientRect()
+                .exec(data => {
+                    callback(data?.[0] || []);
+                });
+        }
+    }
+};
+</script>
+
+<style scoped lang="scss">
+/* 隐藏滚动条样式 */
+.scroll-view {
+    &::-webkit-scrollbar {
+        display: none;
+        width: 0;
+        height: 0;
+    }
+}
+
+.activity-list {
+    width: 100%;
+
+    /* 导航容器 */
+    &__nav {
+        display: flex;
+        align-items: flex-start;
+        width: 100%;
+        padding: 10rpx 20rpx;
+        // box-sizing: border-box;
+    }
+
+    /* 活动项 */
+    &__item {
+        position: relative;
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        width: 180rpx;
+        min-width: 180rpx;
+        height: 180rpx;
+        overflow: hidden;
+        cursor: pointer;
+        border-radius: 4rpx;
+        transform: translateZ(0); // 启用硬件加速
+        transition:
+            transform 0.3s cubic-bezier(0.4, 0, 0.2, 1),
+            border-color 0.3s cubic-bezier(0.4, 0, 0.2, 1),
+            box-shadow 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+        will-change: transform, box-shadow, border-color; // 性能优化
+
+        /* 相邻项间距 */
+        + .activity-list__item {
+            margin-left: 20rpx;
+        }
+
+        /* 点击动画效果 */
+        &--clicking {
+            transform: scale(0.95);
+            // filter: brightness(0.92);
+            // box-shadow: 0 1rpx 4rpx rgba(0, 0, 0, 0.12);
+        }
+
+        /* 激活状态样式 */
+        &--active {
+            width: 195rpx;
+            min-width: 195rpx;
+            height: 195rpx;
+            border: 4rpx solid #2d57e7;
+            border-radius: 4rpx;
+            // box-shadow: 0 6rpx 16rpx rgba(45, 87, 231, 0.3);
+            transform: translateY(-4rpx);
+        }
+    }
+
+    /* 活动图片 */
+    &__image {
+        display: block;
+        width: 100%;
+        height: 100%;
+        transition:
+            transform 0.3s cubic-bezier(0.4, 0, 0.2, 1),
+            box-shadow 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+    }
+
+    /* 点击时图片效果 */
+    &__item--clicking &__image {
+        transform: scale(1.02);
+    }
+
+    /* 激活时图片效果 */
+    &__item--active &__image {
+        box-shadow: inset 0 0 0 1rpx rgba(255, 255, 255, 0.3);
+    }
+
+    /* 倒计时容器 */
+    &__time {
+        position: absolute;
+        top: 0;
+        left: 0;
+        transition:
+            top 0.3s cubic-bezier(0.4, 0, 0.2, 1),
+            left 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+    }
+
+    /* 倒计时盒子 */
+    &__time-box {
+        display: flex;
+        align-items: center;
+        width: 100%;
+        height: 36rpx;
+        padding-right: 20rpx;
+        padding-left: 10rpx;
+        font-family: 'DIN-Schrift';
+        font-size: 20rpx;
+        line-height: 36rpx;
+        color: var(--snake-color-white, #ffffff);
+        background: var(--snake-color-text-secondary, #707184);
+        border-radius: 0rpx 0 4rpx 0;
+        transition: background-color 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+    }
+
+    /* 倒计时文本 */
+    &__countdown {
+        min-width: 100%;
+        height: 36rpx;
+    }
+
+    /* 倒计时图标 */
+    &__time-icon {
+        margin-right: 4rpx;
+    }
+
+    /* 标题容器 */
+    &__title {
+        position: absolute;
+        top: 44rpx;
+        left: 12rpx;
+        display: flex;
+        flex-direction: column;
+        font-family: PingFangSC-Semibold;
+        font-size: 26rpx;
+        color: var(--snake-color-text, #333);
+        transition:
+            transform 0.3s cubic-bezier(0.4, 0, 0.2, 1),
+            color 0.3s cubic-bezier(0.4, 0, 0.2, 1),
+            opacity 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+    }
+
+    /* 主标题 */
+    &__title-main {
+        font-family: PingFangSC-Semibold;
+        font-size: 26rpx;
+        font-weight: 600;
+        color: var(--snake-color-text, #333333);
+    }
+
+    /* 副标题 */
+    &__title-sub {
+        margin-top: 4rpx;
+        font-family: PingFangSC-Light;
+        font-size: 20rpx;
+        font-weight: 300;
+        color: var(--snake-color-text-secondary, #666666);
+    }
+
+    /* 激活状态标题样式 */
+    &__item--active &__title {
+        top: 48rpx;
+        left: 16rpx;
+    }
+
+    &__title-time {
+        margin-top: 4rpx;
+        font-size: 20rpx;
+        color: var(--snake-color-text-muted, #888891);
+    }
+
+    &__title-time--din {
+        font-family: 'DIN-Schrift';
+    }
+
+    &__title-time--open {
+        font-weight: 500;
+    }
+}
+
+@media (prefers-reduced-motion: reduce) {
+    .activity-list__item,
+    .activity-list__image,
+    .activity-list__time,
+    .activity-list__time-box,
+    .activity-list__title {
+        transition: none;
+    }
+}
+</style>

package/components/snake-activity-list/types.ts

@@ -0,0 +1,29 @@
+/** ActivityList 数据项。 */
+export interface ActivityListItem extends Record<string, any> {
+    /** 数据唯一标识。 */
+    id: string | number;
+    /** 数据项名称或唯一标识。 */
+    name?: string;
+    /** subtitle 配置。 */
+    subtitle?: string;
+    /** square image 配置。 */
+    squareImage?: string;
+    /** start time 配置。 */
+    startTime?: number;
+    /** end time 配置。 */
+    endTime?: number;
+}
+
+/** ActivityList 组件的公开属性。 */
+export interface ActivityListProps {
+    /** 用于渲染的数据列表。 */
+    list?: ActivityListItem[];
+    /** 当前激活项索引。 */
+    current?: string | number;
+}
+
+/** ActivityList 组件的事件契约。 */
+export type ActivityListEmits = {
+    /** change 事件携带的参数。 */
+    change: [item: ActivityListItem, index: number];
+};

package/components/snake-auxiliary-segmentation/snake-auxiliary-segmentation.vue

@@ -0,0 +1,44 @@
+<template>
+    <view class="auxiliarysegmentation">
+        <view
+            class="contan"
+            :style="{
+                height: addUnit(datas.blankHeight, 'px'),
+                padding: datas.paddType === 0 ? '0px' : '0px 15px',
+                backgroundColor: datas.bgColor
+            }"
+        >
+            <view
+                v-show="datas.segmentationtype === 1"
+                style="width: 100%; height: 1px; border-top-width: 1px"
+                :style="{
+                    'border-top-style': datas.bordertp,
+                    'border-top-color': datas.auxliarColor
+                }"
+            />
+        </view>
+    </view>
+</template>
+
+<script setup lang="ts">
+/**
+ * @component AuxiliarySegmentation
+ * @description 在装修页面中插入留白，或在留白区域中央绘制一条可配置分割线。
+ */
+
+import { addUnit } from '../../libs/function/unit';
+import type { AuxiliarySegmentationProps } from './types';
+
+defineOptions({ name: 'AuxiliarySegmentation', options: { virtualHost: true, styleIsolation: 'shared' } });
+withDefaults(defineProps<AuxiliarySegmentationProps>(), { datas: () => ({}) });
+</script>
+
+<style scoped lang="scss">
+.auxiliarysegmentation {
+    .contan {
+        display: flex;
+        align-items: center;
+        width: 100%;
+    }
+}
+</style>

package/components/snake-auxiliary-segmentation/types.ts

@@ -0,0 +1,5 @@
+/** AuxiliarySegmentation 组件的公开属性。 */
+export interface AuxiliarySegmentationProps<Data extends Record<string, any> = Record<string, any>> {
+    /** CMS 装修组件配置数据。 */
+    datas?: Data;
+}