foucui 1.0.1

package/components/QiuWatermark/index.vue

@@ -0,0 +1,121 @@
+<template>
+  <div ref="rootRef" class="qiu-watermark">
+    <div class="qiu-watermark__layer" :style="layerStyle" aria-hidden="true" />
+    <div class="qiu-watermark__content">
+      <slot />
+    </div>
+  </div>
+</template>
+
+<script lang="ts" setup>
+defineOptions({ name: 'QiuWatermark' })
+
+const props = withDefaults(
+  defineProps<{
+    content?: string | string[]
+    font?: {
+      color?: string
+      fontSize?: number
+      fontFamily?: string
+      fontWeight?: string | number
+    }
+    gap?: [number, number]
+    rotate?: number
+    zIndex?: number
+    offset?: [number, number]
+  }>(),
+  {
+    content: '',
+    font: () => ({
+      color: 'rgba(0,0,0,0.12)',
+      fontSize: 16,
+      fontFamily: 'sans-serif',
+      fontWeight: 'normal',
+    }),
+    gap: () => [100, 100],
+    rotate: -22,
+    zIndex: 9,
+    offset: () => [0, 0],
+  }
+)
+
+const rootRef = ref<HTMLElement | null>(null)
+const bgUrl = ref('')
+
+const lines = computed(() => {
+  if (Array.isArray(props.content)) return props.content
+  return props.content ? [props.content] : []
+})
+
+const buildWatermark = () => {
+  if (!lines.value.length) {
+    bgUrl.value = ''
+    return
+  }
+
+  const [gapX, gapY] = props.gap
+  const [offsetX, offsetY] = props.offset
+  const font = props.font
+  const canvas = document.createElement('canvas')
+  const ctx = canvas.getContext('2d')
+  if (!ctx) return
+
+  const fontSize = font.fontSize ?? 16
+  const fontFamily = font.fontFamily ?? 'sans-serif'
+  const fontWeight = font.fontWeight ?? 'normal'
+  ctx.font = `${fontWeight} ${fontSize}px ${fontFamily}`
+
+  const maxWidth = Math.max(...lines.value.map((l) => ctx.measureText(l).width))
+  const lineHeight = fontSize * 1.4
+  const textHeight = lines.value.length * lineHeight
+
+  canvas.width = gapX + maxWidth + 20
+  canvas.height = gapY + textHeight + 20
+
+  ctx.clearRect(0, 0, canvas.width, canvas.height)
+  ctx.translate(canvas.width / 2 + offsetX, canvas.height / 2 + offsetY)
+  ctx.rotate((props.rotate * Math.PI) / 180)
+  ctx.fillStyle = font.color ?? 'rgba(0,0,0,0.12)'
+  ctx.font = `${fontWeight} ${fontSize}px ${fontFamily}`
+  ctx.textAlign = 'center'
+  ctx.textBaseline = 'middle'
+
+  const startY = -((lines.value.length - 1) * lineHeight) / 2
+  lines.value.forEach((line, i) => {
+    ctx.fillText(line, 0, startY + i * lineHeight)
+  })
+
+  bgUrl.value = canvas.toDataURL()
+}
+
+const layerStyle = computed(() => ({
+  zIndex: String(props.zIndex),
+  backgroundImage: bgUrl.value ? `url(${bgUrl.value})` : undefined,
+}))
+
+watch(
+  () => [props.content, props.gap, props.rotate, props.font, props.offset],
+  () => buildWatermark(),
+  { deep: true, immediate: true }
+)
+
+onMounted(() => buildWatermark())
+</script>
+
+<style lang="scss" scoped>
+.qiu-watermark {
+  position: relative;
+
+  &__layer {
+    position: absolute;
+    inset: 0;
+    pointer-events: none;
+    background-repeat: repeat;
+  }
+
+  &__content {
+    position: relative;
+    z-index: 1;
+  }
+}
+</style>

package/components/useBodyScrollLock.ts

@@ -0,0 +1,28 @@
+/**
+ * 共享的 body 滚动锁：使用引用计数，保证 Drawer / Dialog 等多实例同时打开时，
+ * 仅当最后一个实例关闭后才真正释放 body 滚动，避免「关闭一个弹层背景就滚动」的问题。
+ * 同时仅在 body 之前没有自定义 overflow 时才接管，关闭时恢复原值。
+ */
+let lockCount = 0
+let prevOverflow = ''
+
+export function useBodyScrollLock() {
+  const lock = () => {
+    if (lockCount === 0) {
+      prevOverflow = document.body.style.overflow
+      document.body.style.overflow = 'hidden'
+    }
+    lockCount += 1
+  }
+
+  const unlock = () => {
+    if (lockCount === 0) return
+    lockCount -= 1
+    if (lockCount === 0) {
+      document.body.style.overflow = prevOverflow
+      prevOverflow = ''
+    }
+  }
+
+  return { lock, unlock }
+}

package/dist/components/QiuAnchor/context.d.ts

@@ -0,0 +1,15 @@
+import { InjectionKey, Ref } from 'vue';
+export interface QiuAnchorLinkRecord {
+    href: string;
+    title: string;
+    el: HTMLElement | null;
+}
+export interface QiuAnchorContext {
+    offset: Ref<number>;
+    bound: Ref<string>;
+    activeLink: Ref<string>;
+    registerLink: (link: QiuAnchorLinkRecord) => void;
+    unregisterLink: (href: string) => void;
+    scrollToLink: (href: string) => void;
+}
+export declare const QIU_ANCHOR_KEY: InjectionKey<QiuAnchorContext>;

package/dist/components/QiuAnchorLink/index.vue.d.ts

@@ -0,0 +1,23 @@
+type __VLS_Props = {
+    href: string;
+    title?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLAnchorElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    title: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLAnchorElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/QiuBadge/api/index.d.ts

@@ -0,0 +1,110 @@
+import { BadgeTemplateDoc } from '../shared/badgeTemplate';
+type ApiOk<T> = {
+    code: number;
+    data: T;
+    msg?: string;
+};
+export interface BadgeTemplateRow {
+    id: number;
+    competition_id: number;
+    name: string;
+    width_mm: number;
+    height_mm: number;
+    is_default: boolean;
+    update_time: string;
+    doc?: BadgeTemplateDoc | null;
+    default_test_json?: Record<string, unknown> | null;
+    kind?: 'badge' | 'desk';
+}
+export interface BadgeLibraryImage {
+    id: number;
+    url: string;
+    name: string;
+    create_time: string;
+}
+/** —— competition / template —— */
+export declare const getCompetitions: (params?: any) => Promise<ApiOk<{
+    list: any[];
+    total: number;
+    page: number;
+    page_size: number;
+}>>;
+export declare const getCompetition: (id: number) => Promise<ApiOk<any>>;
+export declare const listBadgeTemplates: (competitionId: number) => Promise<ApiOk<{
+    list: BadgeTemplateRow[];
+}>>;
+export declare const createBadgeTemplate: (competitionId: number, data: {
+    name: string;
+}) => Promise<ApiOk<BadgeTemplateRow>>;
+export declare const getBadgeTemplateOne: (competitionId: number, templateId: number) => Promise<ApiOk<any>>;
+export declare const getBadgeTemplate: (competitionId: number) => Promise<ApiOk<any>>;
+export declare const putBadgeTemplateOne: (competitionId: number, templateId: number, data: Record<string, unknown>) => Promise<ApiOk<any>>;
+export declare const deleteBadgeTemplate: (competitionId: number, templateId: number) => Promise<ApiOk<boolean>>;
+export declare const setDefaultBadgeTemplate: (competitionId: number, templateId: number) => Promise<ApiOk<boolean>>;
+/** desk label templates */
+export declare const listDeskLabelTemplates: (competitionId: number) => Promise<ApiOk<{
+    list: BadgeTemplateRow[];
+}>>;
+export declare const createDeskLabelTemplate: (competitionId: number, data: {
+    name: string;
+}) => Promise<ApiOk<BadgeTemplateRow>>;
+export declare const getDeskLabelTemplateOne: (competitionId: number, templateId: number) => Promise<ApiOk<any>>;
+export declare const getDeskLabelTemplate: (competitionId: number) => Promise<ApiOk<any>>;
+export declare const putDeskLabelTemplateOne: (competitionId: number, templateId: number, data: Record<string, unknown>) => Promise<ApiOk<any>>;
+export declare const deleteDeskLabelTemplate: (competitionId: number, templateId: number) => Promise<ApiOk<boolean>>;
+export declare const setDefaultDeskLabelTemplate: (competitionId: number, templateId: number) => Promise<ApiOk<boolean>>;
+/** —— upload / library —— */
+export declare const getBadgeLibraryImages: (params?: {
+    page?: number;
+    page_size?: number;
+}) => Promise<ApiOk<{
+    list: BadgeLibraryImage[];
+    total: number;
+    page: number;
+    page_size: number;
+}>>;
+export declare const uploadBadgeLibraryImage: (file: File) => Promise<ApiOk<BadgeLibraryImage>>;
+export declare const deleteBadgeLibraryImage: (id: number) => Promise<ApiOk<boolean>>;
+/** —— student / print data stubs —— */
+export declare const getBadgeSchools: (_competitionId: number) => Promise<ApiOk<{
+    id: number;
+    name: string;
+    short_name: string;
+}[]>>;
+export declare const getBadges: (_competitionId: number, _params?: any) => Promise<ApiOk<{
+    list: {
+        id: number;
+        student_name: string;
+        competition_no: string;
+        school_name: string;
+        age_group: string;
+        competition_room: string;
+        seat_no: string;
+    }[];
+    total: number;
+}>>;
+export declare const getBadgesExportData: (competitionId: number, params?: any) => Promise<ApiOk<{
+    list: {
+        id: number;
+        student_name: string;
+        competition_no: string;
+        school_name: string;
+        age_group: string;
+        competition_room: string;
+        seat_no: string;
+    }[];
+    total: number;
+}>>;
+export declare const getStudents: (_competitionId: number, _params?: any) => Promise<ApiOk<{
+    list: any[];
+    total: number;
+}>>;
+export declare const finalizeSeatAssignmentLock: (_competitionId: number, _data?: any) => Promise<ApiOk<boolean>>;
+export declare const getDeskLabels: (_competitionId: number) => Promise<ApiOk<{
+    id: number;
+    competition_room: string;
+    seat_no: string;
+    student_name: string;
+    school_name: string;
+}[]>>;
+export {};

package/dist/components/QiuBadge/components/BadgeImagePickerDialog.vue.d.ts

@@ -0,0 +1,16 @@
+type __VLS_Props = {
+    modelValue: boolean;
+    defaultTab?: 'lib' | 'up';
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (args_0: boolean) => any;
+    pick: (args_0: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: (args_0: boolean) => any;
+    onPick?: (args_0: string) => any;
+}>, {
+    defaultTab: "lib" | "up";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    fileInputRef: HTMLInputElement;
+}, any>;
+export default _default;

package/dist/components/QiuBadge/components/BadgeLibraryManagerDialog.vue.d.ts

@@ -0,0 +1,9 @@
+type __VLS_Props = {
+    modelValue: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (args_0: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: (args_0: boolean) => any;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/QiuBadge/components/BadgeLibraryPanel.vue.d.ts

@@ -0,0 +1,5 @@
+declare function load(): Promise<void>;
+declare const _default: import('vue').DefineComponent<{}, {
+    load: typeof load;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+export default _default;

package/dist/components/QiuBadge/composables/useTableHostHeight.d.ts

@@ -0,0 +1,7 @@
+/** 测量容器高度供 qiu-table 的 `height` 使用，使表格占满剩余区域。
+ * 使用 ResizeObserver（宿主为表格外层 div，非表格根节点）+ window resize，避免仅靠窗口尺寸遗漏侧栏折叠等变化。 */
+export declare function useTableHostHeight(minHeight?: number): {
+    hostRef: globalThis.Ref<HTMLElement, HTMLElement>;
+    tableHeight: globalThis.Ref<number, number>;
+    recalcTableHeight: () => void;
+};

package/dist/components/QiuBadge/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * QiuBadge — 证件 / 桌签制作插件
+ * 源码迁自 zhihui web-admin + shared，先落地再调。
+ */
+/** 编辑器真源在 QiuCanvasKit；此入口保持兼容 */
+export { default as QiuBadgeTemplateEditor } from '../QiuCanvasKit/QiuCanvasEditor.vue';
+export { default as QiuBadgeTemplateList } from './views/BadgeTemplateListView.vue';
+export { default as QiuBadgeManage } from './views/BadgeManageView.vue';
+export { default as QiuBadgeLibrary } from './views/BadgeLibraryView.vue';
+export { default as QiuDeskLabel } from './views/DeskLabelView.vue';
+export { default as QiuDeskLabelTemplateList } from './views/DeskLabelTemplateListView.vue';
+export { default as QiuBadgeTemplateRenderer } from './shared/BadgeTemplateRenderer.vue';
+export { default as QiuBadgeImagePickerDialog } from './components/BadgeImagePickerDialog.vue';
+export { default as QiuBadgeLibraryManagerDialog } from './components/BadgeLibraryManagerDialog.vue';
+export { default as QiuBadgeLibraryPanel } from './components/BadgeLibraryPanel.vue';
+export * from './shared/badgeTemplate';
+export * from './shared/assetUrl';
+export * as QiuBadgeApi from './api/index';

package/dist/components/QiuBadge/shared/BadgeTemplateRenderer.vue.d.ts

@@ -0,0 +1,14 @@
+import { BadgeTemplateDoc } from './badgeTemplate';
+import { MergeContext } from '../../QiuCanvasKit/types';
+type __VLS_Props = {
+    doc: BadgeTemplateDoc | null;
+    mergeData?: MergeContext | Record<string, string>;
+    screenScale?: number;
+    enableLinks?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    mergeData: MergeContext | Record<string, string>;
+    screenScale: number;
+    enableLinks: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/QiuBadge/shared/assetUrl.d.ts

@@ -0,0 +1 @@
+export declare function resolveAssetUrl(src: string | null | undefined): string;

package/dist/components/QiuBadge/shared/badgeTemplate.d.ts

@@ -0,0 +1,132 @@
+/** 与后端 BadgeData 及 allowedBadgePlaceholderKeys 一致 */
+export declare const BADGE_PLACEHOLDER_KEYS: readonly ["competition_name", "student_name", "competition_no", "school_name", "school_short_name", "age_group", "competition_room", "seat_no", "floor", "teacher_name", "date", "session", "enroll_teacher_name", "teacher_phone", "signup_teacher_name", "signup_teacher_phone", "signup_teacher_department", "signup_teacher_position", "signup_teacher_id_card", "signup_teacher_email", "signup_teacher_username", "venue_name", "venue_address", "competition_daily_start", "competition_daily_end"];
+export type BadgePlaceholderKey = (typeof BADGE_PLACEHOLDER_KEYS)[number];
+export declare const BADGE_PLACEHOLDER_LABELS: Record<string, string>;
+export interface BadgeTemplateCanvas {
+    widthMm: number;
+    heightMm: number;
+    background?: string;
+    backgroundImage?: string;
+    /** 是否绘制画布边框（编辑/预览/打印一致） */
+    showBorder?: boolean;
+    borderColor?: string;
+    /** 边框宽度（mm） */
+    borderWidthMm?: number;
+}
+export interface BadgeCanvasRegion {
+    id: string;
+    name: string;
+    xMm: number;
+    yMm: number;
+    wMm: number;
+    hMm: number;
+    background?: string;
+    backgroundImage?: string;
+}
+/** 元素跳转链接（Banner 热区 / 按钮形态） */
+export type BadgeElementLink = {
+    href: string;
+    target?: '_blank' | '_self';
+};
+export interface BadgeTextElement {
+    id: string;
+    type: 'text';
+    zIndex: number;
+    xMm: number;
+    yMm: number;
+    wMm: number;
+    hMm: number;
+    rotation?: number;
+    flipX?: boolean;
+    flipY?: boolean;
+    groupId?: string;
+    regionId?: string;
+    align?: string;
+    text: string;
+    fontSize: number;
+    fontFamily: string;
+    color: string;
+    textDirection?: 'horizontal' | 'vertical';
+    link?: BadgeElementLink;
+}
+export interface BadgeImageElement {
+    id: string;
+    type: 'image' | 'seal';
+    zIndex: number;
+    xMm: number;
+    yMm: number;
+    wMm: number;
+    hMm: number;
+    rotation?: number;
+    flipX?: boolean;
+    flipY?: boolean;
+    groupId?: string;
+    regionId?: string;
+    align?: string;
+    src: string;
+    clipboardSource?: 'clipboard';
+    clipboardUploadState?: 'pending' | 'uploaded';
+    clipboardUploadKey?: string;
+    clipboardImageId?: number;
+    clipboardOrigName?: string;
+    link?: BadgeElementLink;
+}
+export interface BadgeShapeElement {
+    id: string;
+    type: 'shape';
+    shape: 'rect' | 'circle' | 'triangle' | 'line' | 'polygon' | 'trapezoid';
+    zIndex: number;
+    xMm: number;
+    yMm: number;
+    wMm: number;
+    hMm: number;
+    rotation?: number;
+    flipX?: boolean;
+    flipY?: boolean;
+    groupId?: string;
+    regionId?: string;
+    background?: string;
+    lockAspectRatio?: boolean;
+    showStroke?: boolean;
+    strokeColor?: string;
+    strokeWidthMm?: number;
+    opacity?: number;
+    polygonSides?: number;
+    link?: BadgeElementLink;
+}
+export type BadgeElement = BadgeTextElement | BadgeImageElement | BadgeShapeElement;
+export interface BadgeGuideLine {
+    id: string;
+    axis: 'horizontal' | 'vertical';
+    offsetMm: number;
+}
+export interface BadgeTemplateDoc {
+    version: number;
+    canvas: BadgeTemplateCanvas;
+    elements: BadgeElement[];
+    guides?: BadgeGuideLine[];
+    regions?: BadgeCanvasRegion[];
+    /** 可选：画布级数据模块（与 QiuCanvasKit 对齐） */
+    dataModules?: Array<{
+        id: string;
+        label: string;
+        fields: Array<{
+            key: string;
+            label: string;
+            type?: string;
+        }>;
+        sample?: Record<string, string>;
+        builtin?: boolean;
+        enabled?: boolean;
+    }>;
+}
+export declare function mergeBadgeText(text: string, data: Record<string, string>): string;
+/** 将接口返回的一条证件（参赛证/工作证等）记录转为占位符合并表 */
+export declare function flattenBadgeForMerge(b: Record<string, unknown>, competitionNameFallback?: string): Record<string, string>;
+export declare function sortBadgeElements(els: BadgeElement[]): BadgeElement[];
+/** 桌面贴模板可用占位符：与参赛证保持一致，实际值由 DeskLabels 接口尽量补齐 */
+export declare const DESK_LABEL_PLACEHOLDER_KEYS: readonly ["competition_name", "student_name", "competition_no", "school_name", "school_short_name", "age_group", "competition_room", "seat_no", "floor", "teacher_name", "date", "session", "enroll_teacher_name", "teacher_phone", "signup_teacher_name", "signup_teacher_phone", "signup_teacher_department", "signup_teacher_position", "signup_teacher_id_card", "signup_teacher_email", "signup_teacher_username", "venue_name", "venue_address", "competition_daily_start", "competition_daily_end"];
+export type DeskLabelPlaceholderKey = BadgePlaceholderKey;
+export declare const DESK_LABEL_PLACEHOLDER_LABELS: Record<string, string>;
+/** 单条桌面贴数据 → 与证件模板相同的合并表（未用字段留空，便于复用 BadgeTemplateRenderer） */
+export declare function flattenDeskLabelForMerge(row: Record<string, unknown>, competitionNameFallback?: string): Record<string, string>;

package/dist/components/QiuBadge/utils/chinaAreaData.d.ts

@@ -0,0 +1,9 @@
+export interface ChinaAreaNode {
+    value: string;
+    label: string;
+    children?: ChinaAreaNode[];
+}
+/** 与 element-china-area-data 的 regionData 同形 */
+export declare const regionData: ChinaAreaNode[];
+/** code → 中文名 */
+export declare const codeToText: Record<string, string>;

package/dist/components/QiuBadge/utils/hostRegion.d.ts

@@ -0,0 +1,3 @@
+/** host_region 存省市区 code 的 JSON 数组字符串，如 ["110000","110100","110105"]；旧数据为纯文本则原样展示 */
+export declare function parseHostRegionCodes(raw: unknown): string[];
+export declare function formatHostRegionLabel(raw: unknown, codeToText: Record<string, string>): string;