@usethink/cf-admin-fe 0.1.0

package/src/components/AdminPagination.vue

@@ -0,0 +1,271 @@
+<template>
+  <nav class="admin-pagination" :aria-label="$t('pagination.listLabel')">
+    <div class="pagination-left">
+      <span class="pagination-info">{{ $t('pagination.total', { total }) }}</span>
+    </div>
+    <div class="pagination-right">
+      <!-- 每页条数选择器 -->
+      <label class="pagination-limit">
+        {{ $t('pagination.perPage') }}
+        <select
+          :value="limit"
+          class="limit-select"
+          :disabled="disabled"
+          @change="onLimitChange"
+        >
+          <option :value="10">10</option>
+          <option :value="20">20</option>
+          <option :value="50">50</option>
+        </select>
+        {{ $t('pagination.perPageUnit') }}
+      </label>
+
+      <!-- 上下翻页 -->
+      <div class="pagination-controls">
+        <button
+          type="button"
+          class="btn btn-ghost btn-xs"
+          :disabled="disabled || page <= 1"
+          :aria-label="$t('pagination.prevLabel')"
+          @click="$emit('prev')"
+        >
+          {{ $t('pagination.prev') }}
+        </button>
+        <span v-if="cursorMode" class="pagination-page" aria-live="polite">{{ $t('pagination.page', { page }) }}</span>
+        <span v-else class="pagination-page" aria-live="polite">{{ $t('pagination.pageOf', { page, total: totalPages }) }}</span>
+        <button
+          type="button"
+          class="btn btn-ghost btn-xs"
+          :disabled="disabled || (cursorMode ? !hasMore : page >= totalPages)"
+          :aria-label="$t('pagination.nextLabel')"
+          @click="$emit('next')"
+        >
+          {{ $t('pagination.next') }}
+        </button>
+      </div>
+
+      <!-- 页码跳转 -->
+      <div v-if="!cursorMode" class="pagination-jump">
+        {{ $t('pagination.jumpTo') }}
+        <input
+          type="number"
+          :min="1"
+          :max="totalPages"
+          :step="1"
+          inputmode="numeric"
+          class="jump-input"
+          :disabled="disabled"
+          :aria-label="$t('pagination.jumpLabel')"
+          v-model.number="jumpValue"
+          @keyup.enter="handleJump"
+        />
+        {{ $t('pagination.jumpPage') }}
+        <button type="button" class="btn btn-ghost btn-xs" @click="handleJump" :disabled="disabled || !jumpValue">{{ $t('pagination.jump') }}</button>
+      </div>
+    </div>
+  </nav>
+</template>
+
+<script setup lang="ts">
+import { ref, watch } from 'vue'
+
+const props = defineProps<{
+  page: number
+  total: number
+  totalPages: number
+  limit?: number
+  cursorMode?: boolean
+  hasMore?: boolean
+  disabled?: boolean
+}>()
+
+const emit = defineEmits<{
+  prev: []
+  next: []
+  jump: [page: number]
+  'update:limit': [limit: number]
+}>()
+
+/** 跳转输入框的当前值，翻页后自动清空 */
+const jumpValue = ref<number | undefined>(undefined)
+
+function onLimitChange(e: Event) {
+  const val = Number((e.target as HTMLSelectElement).value)
+  if ([10, 20, 50].includes(val)) emit('update:limit', val)
+}
+
+function handleJump() {
+  const p = Number(jumpValue.value)
+  if (!Number.isFinite(p) || p <= 0) {
+    jumpValue.value = undefined
+    return
+  }
+  const clamped = Math.max(1, Math.min(Math.trunc(p), props.totalPages))
+  if (clamped !== props.page) {
+    emit('jump', clamped)
+  }
+  jumpValue.value = undefined
+}
+
+// 翻页后清空跳转输入
+watch(() => props.page, () => {
+  jumpValue.value = undefined
+})
+</script>
+
+<style scoped>
+/*
+ * 分页条紧凑：全局 select 默认 min-height:34px，会把整行撑高。
+ * 本组件控件统一 --admin-control-height-sm（26px）+ 上下 padding 0。
+ */
+.admin-pagination {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--admin-inline-gap, 8px);
+  flex-wrap: wrap;
+  background: var(--tg-secondary-bg, #151b28);
+  border: 1px solid var(--border, rgba(255, 255, 255, 0.1));
+  border-radius: var(--r-md, 8px);
+  /* 行高由 26px 控件决定；条内边距只留 4px */
+  padding: 4px 10px;
+  margin: 0;
+  flex-shrink: 0;
+  min-height: 0;
+  line-height: 1.2;
+}
+
+.pagination-info {
+  font-size: 12px;
+  color: var(--tg-hint, #9aa4b2);
+  line-height: 1.2;
+}
+
+.pagination-right {
+  display: flex;
+  align-items: center;
+  gap: var(--admin-inline-gap, 8px);
+  flex-wrap: wrap;
+}
+
+/* 每页条数 */
+.pagination-limit {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  font-size: 12px;
+  color: var(--tg-hint, #9aa4b2);
+  white-space: nowrap;
+  line-height: 1.2;
+}
+
+/*
+ * 覆盖 base.css select { min-height: 34px; line-height: 32px }。
+ * 固定 height + 上下 padding:0 + line-height = height - border，与工具栏铁律相同、高度更矮。
+ */
+.limit-select {
+  box-sizing: border-box;
+  height: var(--admin-control-height-sm, 26px);
+  min-height: var(--admin-control-height-sm, 26px);
+  max-height: var(--admin-control-height-sm, 26px);
+  padding: 0 22px 0 8px;
+  border: 1px solid var(--border, rgba(255, 255, 255, 0.1));
+  border-radius: var(--r-sm, 6px);
+  background-color: var(--tg-secondary-bg, #151b28);
+  color: var(--tg-text, #f0f2f5);
+  -webkit-text-fill-color: var(--tg-text, #f0f2f5);
+  font-size: 12px;
+  line-height: 24px;
+  outline: none;
+  cursor: pointer;
+  appearance: none;
+  -webkit-appearance: none;
+  color-scheme: dark;
+  vertical-align: middle;
+  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='10' height='10' viewBox='0 0 24 24' fill='none' stroke='%239aa4b2' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpolyline points='6 9 12 15 18 9'%3E%3C/polyline%3E%3C/svg%3E");
+  background-repeat: no-repeat;
+  background-position: right 6px center;
+  background-size: 10px;
+}
+
+/* 翻页控制 */
+.pagination-controls {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+
+.pagination-page {
+  font-size: 12px;
+  white-space: nowrap;
+  color: var(--tg-text, #f0f2f5);
+  line-height: 1.2;
+}
+
+/* 分页内按钮与 26px 控件对齐 */
+.admin-pagination :deep(.btn-xs),
+.admin-pagination :deep(.btn-sm) {
+  box-sizing: border-box;
+  height: var(--admin-control-height-sm, 26px);
+  min-height: var(--admin-control-height-sm, 26px);
+  padding: 0 8px;
+  font-size: 12px;
+  line-height: 24px;
+  border-radius: var(--r-sm, 6px);
+}
+
+/* 跳转输入 */
+.pagination-jump {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  font-size: 12px;
+  color: var(--tg-hint, #9aa4b2);
+  white-space: nowrap;
+  line-height: 1.2;
+}
+
+.jump-input {
+  box-sizing: border-box;
+  width: 40px;
+  height: var(--admin-control-height-sm, 26px);
+  min-height: var(--admin-control-height-sm, 26px);
+  padding: 0 4px;
+  border: 1px solid var(--border, rgba(255, 255, 255, 0.1));
+  border-radius: var(--r-sm, 6px);
+  background-color: var(--tg-secondary-bg, #151b28);
+  color: var(--tg-text, #f0f2f5);
+  font-size: 12px;
+  line-height: 24px;
+  text-align: center;
+  outline: none;
+  -moz-appearance: textfield;
+}
+
+.jump-input::-webkit-inner-spin-button,
+.jump-input::-webkit-outer-spin-button {
+  -webkit-appearance: none;
+  margin: 0;
+}
+
+@media (max-width: 640px) {
+  .admin-pagination,
+  .pagination-right {
+    align-items: stretch;
+  }
+
+  .pagination-right {
+    width: 100%;
+    gap: 8px;
+  }
+
+  .pagination-controls {
+    justify-content: space-between;
+    flex: 1;
+  }
+
+  .pagination-jump {
+    display: none;
+  }
+}
+</style>

package/src/components/ConfirmDialog.vue

@@ -0,0 +1,160 @@
+<template>
+  <AdminModal v-model="innerVisible" :title="$t('confirm.confirm')" max-width="460px" hide-actions>
+    <p class="confirm-message">{{ message }}</p>
+    <div v-if="options.length > 0" class="confirm-options" role="group" :aria-label="$t('confirm.delete')">
+      <label
+        v-for="opt in options"
+        :key="opt.key"
+        class="confirm-option"
+      >
+        <input
+          type="checkbox"
+          :checked="Boolean(optionValues[opt.key])"
+          :disabled="loading"
+          @change="onOptionChange(opt.key, ($event.target as HTMLInputElement).checked)"
+        />
+        <span class="confirm-option-body">
+          <span class="confirm-option-label">{{ opt.label }}</span>
+          <span v-if="opt.hint" class="confirm-option-hint">{{ opt.hint }}</span>
+        </span>
+      </label>
+    </div>
+    <template #actions>
+      <button type="button" class="btn btn-ghost" :disabled="loading" @click="handleClose">{{ $t('confirm.cancel') }}</button>
+      <button
+        class="btn"
+        type="button"
+        :class="danger ? 'btn-danger' : 'btn-primary'"
+        :disabled="loading"
+        @click="handleConfirm"
+      >
+        {{ $t('confirm.confirm') }}
+      </button>
+    </template>
+  </AdminModal>
+</template>
+
+<script setup lang="ts">
+import { ref, watch } from 'vue'
+import AdminModal from './AdminModal.vue'
+import type { ConfirmOptionDef } from '../composables/useConfirmDialog'
+
+const props = withDefaults(defineProps<{
+  modelValue: boolean
+  message: string
+  loading?: boolean
+  danger?: boolean
+  /** 可选勾选项定义；无则退化为纯确认框 */
+  options?: ConfirmOptionDef[]
+  /** key → 是否勾选（由 useConfirmDialog 托管） */
+  optionValues?: Record<string, boolean>
+}>(), {
+  loading: false,
+  danger: false,
+  options: () => [],
+  optionValues: () => ({}),
+})
+
+const emit = defineEmits<{
+  'update:modelValue': [value: boolean]
+  confirm: []
+  'update:option': [key: string, checked: boolean]
+}>()
+
+const innerVisible = ref(false)
+watch(() => props.modelValue, (val) => {
+  innerVisible.value = val
+}, { immediate: true })
+watch(innerVisible, (val, wasVisible) => {
+  if (!val && wasVisible && props.modelValue) emit('update:modelValue', false)
+})
+
+function close() {
+  emit('update:modelValue', false)
+}
+
+function handleClose() {
+  close()
+}
+
+function handleConfirm() {
+  if (!innerVisible.value || props.loading) return
+  emit('confirm')
+  close()
+}
+
+function onOptionChange(key: string, checked: boolean) {
+  emit('update:option', key, checked)
+}
+</script>
+
+<style scoped>
+.confirm-message {
+  font-size: 14px;
+  line-height: 1.65;
+  /* 支持 askConfirm(`...\n\n...`) 多段说明；否则 HTML 会把换行压成空格 */
+  white-space: pre-line;
+  color: var(--tg-text, #f0f2f5);
+}
+
+/* 选项区：与弹窗同属暗色表面体系，用 elevated surface 分层，禁止浅色底板 */
+.confirm-options {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  margin-top: 6px;
+  padding: 6px;
+  border-radius: var(--r-md, 8px);
+  background: var(--surface-2, rgba(255, 255, 255, 0.07));
+  border: 1px solid var(--border, rgba(255, 255, 255, 0.1));
+}
+
+.confirm-option {
+  display: flex;
+  align-items: flex-start;
+  gap: 10px;
+  cursor: pointer;
+  font-size: 13px;
+  line-height: 1.45;
+  color: var(--tg-text);
+  padding: 10px;
+  border-radius: var(--r-sm, 6px);
+  transition: background-color var(--duration-fast, 150ms) var(--ease-out, ease);
+}
+
+.confirm-option:hover {
+  background: var(--surface-hover, rgba(255, 255, 255, 0.1));
+}
+
+.confirm-option input {
+  margin-top: 2px;
+  flex-shrink: 0;
+  width: 14px;
+  height: 14px;
+  padding: 0;
+  border: none;
+  background: transparent;
+  accent-color: var(--admin-accent, #f59e0b);
+}
+
+.confirm-option-body {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  min-width: 0;
+}
+
+.confirm-option-label {
+  font-weight: 600;
+  font-size: 13px;
+  color: var(--tg-text);
+  letter-spacing: 0.01em;
+}
+
+.confirm-option-hint {
+  font-size: 12px;
+  color: var(--tg-hint);
+  line-height: 1.5;
+  opacity: 0.95;
+}
+</style>

package/src/components/ToastContainer.vue

@@ -0,0 +1,120 @@
+<template>
+  <Teleport to="body">
+    <div class="toast-container" role="status" aria-live="polite" aria-atomic="false">
+      <TransitionGroup name="toast">
+        <div
+          v-for="toast in toasts"
+          :key="toast.id"
+          class="toast-item"
+          :class="`toast-${toast.type}`"
+        >
+          <span class="toast-icon">{{ iconMap[toast.type] }}</span>
+          <span class="toast-message">{{ toast.message }}</span>
+        </div>
+      </TransitionGroup>
+    </div>
+  </Teleport>
+</template>
+
+<script setup lang="ts">
+import { useToast } from '../composables/useToast'
+
+const { toasts } = useToast()
+
+const iconMap: Record<string, string> = {
+  success: '✓',
+  error: '✕',
+  info: 'ℹ',
+}
+</script>
+
+<style scoped>
+.toast-container {
+  position: fixed;
+  top: 20px;
+  left: 50%;
+  transform: translateX(-50%);
+  z-index: 2000;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  pointer-events: none;
+  width: min(420px, calc(100% - 32px));
+}
+
+.toast-item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 10px 16px;
+  border-radius: 10px;
+  background: #1f2937;
+  color: #fff;
+  font-size: 14px;
+  line-height: 1.4;
+  box-shadow: 0 10px 30px rgba(0, 0, 0, 0.18);
+  pointer-events: auto;
+}
+
+.toast-icon {
+  width: 20px;
+  height: 20px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  font-size: 12px;
+  font-weight: 700;
+  flex-shrink: 0;
+}
+
+.toast-success {
+  border: 0.5px solid rgba(34, 197, 94, 0.5);
+}
+
+.toast-success .toast-icon {
+  background: rgba(34, 197, 94, 0.18);
+  color: #22c55e;
+}
+
+.toast-error {
+  border: 0.5px solid rgba(239, 68, 68, 0.5);
+}
+
+.toast-error .toast-icon {
+  background: rgba(239, 68, 68, 0.18);
+  color: #ef4444;
+}
+
+.toast-info {
+  border: 0.5px solid rgba(59, 130, 246, 0.5);
+}
+
+.toast-info .toast-icon {
+  background: rgba(59, 130, 246, 0.18);
+  color: #60a5fa;
+}
+
+.toast-message {
+  word-break: break-word;
+}
+
+.toast-enter-active,
+.toast-leave-active {
+  transition: all 0.25s ease;
+}
+
+.toast-enter-from {
+  opacity: 0;
+  transform: translateY(-8px) scale(0.98);
+}
+
+.toast-leave-to {
+  opacity: 0;
+  transform: translateY(-8px) scale(0.98);
+}
+
+.toast-move {
+  transition: transform 0.25s ease;
+}
+</style>

package/src/components/index.ts

@@ -0,0 +1,4 @@
+export { default as AdminPagination } from './AdminPagination.vue'
+export { default as AdminModal } from './AdminModal.vue'
+export { default as ConfirmDialog } from './ConfirmDialog.vue'
+export { default as ToastContainer } from './ToastContainer.vue'

package/src/composables/index.ts

@@ -0,0 +1,34 @@
+export {
+  useTablePagination,
+  type UseTablePaginationOptions,
+  type UseTablePaginationReturn,
+} from './useTablePagination'
+
+export {
+  useTableSelection,
+  type UseTableSelectionOptions,
+} from './useTableSelection'
+
+export {
+  useConfirmDialog,
+  type ConfirmOptionDef,
+  type ConfirmAskOptions,
+  type ConfirmResult,
+} from './useConfirmDialog'
+
+export {
+  useToast,
+  MAX_TOASTS,
+  type ToastType,
+  type ToastItem,
+} from './useToast'
+
+export {
+  useAdminBatchOperation,
+  type AdminBatchOperationResult,
+} from './useAdminBatchOperation'
+
+export {
+  writeClipboardText,
+  copyText,
+} from './useClipboard'

package/src/composables/useAdminBatchOperation.ts

@@ -0,0 +1,51 @@
+import { ref } from 'vue'
+
+export interface AdminBatchOperationResult<T> {
+  total: number
+  success: number
+  failed: number
+  failedItems: T[]
+}
+
+export function useAdminBatchOperation() {
+  const operating = ref(false)
+  const completed = ref(0)
+  const total = ref(0)
+
+  async function runSequential<T>(items: T[], action: (item: T) => Promise<void>): Promise<AdminBatchOperationResult<T> | null> {
+    if (operating.value) return null
+    operating.value = true
+    completed.value = 0
+    total.value = items.length
+    const result: AdminBatchOperationResult<T> = {
+      total: items.length,
+      success: 0,
+      failed: 0,
+      failedItems: [],
+    }
+
+    try {
+      for (const item of items) {
+        try {
+          await action(item)
+          result.success += 1
+        } catch {
+          result.failed += 1
+          result.failedItems.push(item)
+        } finally {
+          completed.value += 1
+        }
+      }
+      return result
+    } finally {
+      operating.value = false
+    }
+  }
+
+  return {
+    operating,
+    completed,
+    total,
+    runSequential,
+  }
+}

package/src/composables/useClipboard.ts

@@ -0,0 +1,37 @@
+/** 剪贴板工具：一键复制文本到剪贴板，带按钮视觉反馈 */
+
+const FEEDBACK_MS = 1500
+
+/** 复制文本，更新按钮文字反馈 */
+export async function writeClipboardText(text: string): Promise<void> {
+  if (navigator.clipboard?.writeText) {
+    await navigator.clipboard.writeText(text)
+    return
+  }
+
+  const textarea = document.createElement('textarea')
+  textarea.value = text
+  textarea.setAttribute('readonly', '')
+  textarea.style.position = 'fixed'
+  textarea.style.opacity = '0'
+  document.body.appendChild(textarea)
+  textarea.select()
+  const copied = document.execCommand('copy')
+  textarea.remove()
+  if (!copied) throw new Error('Clipboard copy failed')
+}
+
+export function copyText(text: string, e: Event) {
+  writeClipboardText(text).then(() => {
+    feedback(e, '✅')
+  }).catch(() => {
+    feedback(e, '❌')
+  })
+}
+
+function feedback(e: Event, icon: string) {
+  const btn = e.currentTarget as HTMLButtonElement
+  const original = btn.textContent
+  btn.textContent = icon
+  setTimeout(() => { btn.textContent = original }, FEEDBACK_MS)
+}