@chenzy-design/svelte 0.3.1 → 0.4.1

package/dist/calendar/Calendar.svelte.d.ts

@@ -1,115 +1,45 @@
-import { type Snippet } from 'svelte';
-import { type CalendarEvent, type Placement } from '@chenzy-design/core';
-type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
-type Mode = 'month' | 'week' | 'day';
-type SelectionMode = 'single' | 'range';
-type RangeValue = [Date, Date];
+import type { Snippet } from 'svelte';
+import { type CalendarEvent, type WeekStartsOn } from '@chenzy-design/core';
+type Mode = 'day' | 'week' | 'month' | 'range';
 interface Props {
-    value?: Date;
-    defaultValue?: Date;
-    mode?: Mode;
-    selectionMode?: SelectionMode;
-    events?: CalendarEvent[];
-    weekStartsOn?: WeekStart;
-    maxEventsPerDay?: number;
-    dayStartHour?: number;
-    dayEndHour?: number;
-    weekendDays?: number[];
-    markWeekend?: boolean;
-    disabledDate?: (date: Date) => boolean;
-    selectedDate?: Date;
-    defaultSelectedDate?: Date;
-    rangeValue?: RangeValue | null;
-    defaultRangeValue?: RangeValue | null;
-    locale?: string;
-    onChange?: (info: {
-        value: Date;
-    }) => void;
-    onSelect?: (info: {
-        date: Date;
-    }) => void;
-    onRangeChange?: (info: {
-        range: RangeValue;
-    }) => void;
-    onDateClick?: (info: {
-        date: Date;
-    }) => void;
-    onMoreClick?: (info: {
-        date: Date;
-        events: CalendarEvent[];
-    }) => void;
-    /** 点击/键盘激活事件块（spec §a11y：事件块 role=button + Enter/Space 触发）。 */
-    onEventClick?: (info: {
-        event: CalendarEvent;
-        nativeEvent: Event;
-    }) => void;
-    /** 关闭回调（popup 模式） */
-    onClose?: () => void;
-    dateCell?: Snippet<[
-        {
-            date: Date;
-            events: CalendarEvent[];
-            isToday: boolean;
-            isOutside: boolean;
-            disabled: boolean;
-        }
-    ]>;
-    event?: Snippet<[{
-        event: CalendarEvent;
-    }]>;
-    /** 自定义头部内容，替换默认头部 */
+    /** 展示锚点日期，默认 new Date() */
+    displayValue?: Date;
+    /** mode='range' 时必传，左闭右开 [start, end) */
+    range?: [Date, Date];
+    /** 自定义头部内容（对齐 Semi header；缺省不渲染头部） */
     header?: Snippet;
-    /** 自定义单元格额外内容 (dateString: 'YYYY-MM-DD', date: Date) */
-    dateGridRender?: (dateString: string, date: Date) => Snippet | null | undefined;
-    /** 自定义全天事件区域渲染 */
-    allDayEventsRender?: (events: CalendarEvent[]) => Snippet | null | undefined;
-    /** 自定义时间文案 (hour: 0-23) */
-    renderTimeDisplay?: (hour: number) => string;
-    /** 自定义日期文案 */
-    renderDateDisplay?: (date: Date) => string;
-    /** 是否显示当前时间红线（day/week 视图，默认 true） */
+    /** 事件列表 */
+    events?: CalendarEvent[];
+    /** 视图模式，默认 'week' */
+    mode?: Mode;
+    /** 显示当前时间红线（日/周/多日视图），默认 true */
     showCurrTime?: boolean;
-    /** day/week 视图默认滚动高度（px，默认 400） */
+    /** 周起始，默认 0（周日） */
+    weekStartsOn?: WeekStartsOn;
+    /** 日/周视图默认滚动高度（px），默认 400 */
     scrollTop?: number;
-    /** 事件块最小高度（px） */
+    /** 区分周末列（灰底），默认 false */
+    markWeekend?: boolean;
+    /** 日/周/多日视图事件最小高度（px），默认 Number.MIN_SAFE_INTEGER */
     minEventHeight?: number;
     /** 日历整体宽度 */
     width?: number | string;
-    /** 日历整体高度 */
+    /** 日历整体高度，默认 600 */
     height?: number | string;
-    /** 范围选择的日期区间（mode='range' 时用于初始化，同 rangeValue） */
-    range?: [Date, Date] | null;
-    /** 受控展示锚点（Semi API: displayValue，等同于 value） */
-    displayValue?: Date;
-    ariaLabel?: string;
-    /** 弹层模式：渲染 trigger，日历作为浮层弹出（复用 _floating 门户定位） */
-    popup?: boolean;
-    /** 受控展开态（popup 模式），受控时不回写仅 onOpenChange (红线 #1) */
-    open?: boolean;
-    /** 非受控初始展开态 */
-    defaultOpen?: boolean;
-    /** 展开态变化回调 */
-    onOpenChange?: (info: {
-        open: boolean;
-    }) => void;
-    /** 浮层相对 trigger 的位置 */
-    placement?: Placement;
-    /** 浮层门户挂载容器（默认 document.body） */
-    getContainer?: () => HTMLElement | null | undefined;
-    /** trigger 自定义内容（popup 模式）；不传则渲染默认按钮显示标题 */
-    trigger?: Snippet<[{
-        open: boolean;
-        toggle: () => void;
-    }]>;
-    /**
-     * day 视图小时时间轴虚拟化：当行数 ≥ virtualizeThreshold 时仅渲染视口行。
-     * 'auto'（默认）按阈值自动；true 强制；false 关闭。
-     */
-    virtualizeDay?: boolean | 'auto';
-    /** 触发虚拟化的最少行数（virtualizeDay='auto' 时生效） */
-    virtualizeThreshold?: number;
-    /** day 视图时间轴视口高度（px，虚拟化时滚动容器高度） */
-    timelineViewportHeight?: number;
+    /** 点击日期格（对齐 Semi function(e, date)）：日/周视图精确到半小时，月视图精确到日 */
+    onClick?: (e: Event, date: Date) => void;
+    /** 月视图 +N 卡片关闭回调（对齐 Semi function(e)） */
+    onClose?: (e: Event) => void;
+    /** 月视图点「还有 N 项」回调（对齐 Semi function(e, date, remaining)） */
+    onMoreClick?: (e: Event, date: Date, remaining: number) => void;
+    /** 自定义日/周视图时间文案 */
+    renderTimeDisplay?: (hour: number) => unknown;
+    /** 自定义日期文案（week/range 视图日期头）。对齐 Semi renderDateDisplay(date)=>ReactNode。 */
+    renderDateDisplay?: Snippet<[Date]>;
+    /** 自定义单元格/列（绝对定位）；返回 Snippet 覆盖默认渲染 */
+    dateGridRender?: (dateString: string, date: Date) => Snippet | null | undefined;
+    /** 自定义顶部全天区；返回 Snippet 覆盖默认全天渲染 */
+    allDayEventsRender?: (events: CalendarEvent[]) => Snippet | null | undefined;
 }
 declare const Calendar: import("svelte").Component<Props, {}, "">;
 type Calendar = ReturnType<typeof Calendar>;

package/dist/calendar/Calendar.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Calendar.svelte.d.ts","sourceRoot":"","sources":["../../src/calendar/Calendar.svelte.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Calendar.svelte.d.ts","sourceRoot":"","sources":["../../src/calendar/Calendar.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAiBH,KAAK,aAAa,EAGlB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAK7B,KAAK,IAAI,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/C,UAAU,KAAK;IACb,2BAA2B;IAC3B,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,yCAAyC;IACzC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrB,sCAAsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW;IACX,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,qBAAqB;IACrB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,iCAAiC;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mBAAmB;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACzC,yCAAyC;IACzC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAC7B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,mBAAmB;IACnB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,uCAAuC;IACvC,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAChF,mCAAmC;IACnC,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;CAC9E;AA0eH,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/calendar/meta.d.ts

@@ -1,237 +1,147 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
- * Calendar — see specs/components/show/Calendar.spec.md
+ * Calendar — 纯事件展示日历，对齐 Semi Design Calendar 契约。
  */
 export declare const meta: {
     readonly name: "Calendar";
     readonly category: "show";
-    readonly description: "月/周/日视图日历：日格网格 + 事件展示与 +N 折叠，today/selected/outside/weekend/disabled 态、导航（上一/今天/下一，月或周或天）；mode 切换月(6×7)/周(1×7)/日(单日时间轴)视图，day 模式纵向列出小时段(dayStartHour~dayEndHour)，带时间的事件按起始小时入对应时段、全天或跨天延续事件入顶部「全天」区，selectionMode 切换单选(selectedDate)/范围(rangeValue，起止+区间高亮+hover 预览)。受控 value(锚点)/selectedDate/rangeValue 不回写，仅通过 onChange/onSelect/onRangeChange/onDateClick/onMoreClick 通知。完整 WAI-ARIA grid roving 键盘焦点（方向键/PageUp-Down/Home-End/Enter-Space），popup 弹层模式（复用 _floating 门户 + 外部点击/Esc 关闭），day 视图时间轴虚拟化（复用 core fixedRange）。";
+    readonly description: "纯事件展示日历，对齐 Semi Design Calendar。四视图 mode=day/week/month/range：day 单日时间轴（左时间列 + 单日列，25×2 半小时可点击格 + 绝对定位事件）；week 星期表头 + 7 列 DayCol，跨天事件走顶部全天区（parseWeekSpanEvents）；range 结构同 week，列数=range 天数（左闭右开），跨天走 parseSpanEvents；month 6×7 网格，跨天条走 getMonthEvents，每格超额显示「还有 N 项」并用 Popover 弹卡片。displayValue 决定展示锚点；onClick 回调点击的精确时间点（日/周精确到半小时，月精确到日）。showCurrTime 当前时间红线（当天列，每 30s 刷新）。事件定位全部来自 @chenzy-design/core 纯算法（getDailyEvents/parseWeekSpanEvents/parseSpanEvents/getMonthEvents/calcRowHeight/allDayEventMap/getPos），本组件只把数值位置转成内联样式。事件外观由 event.children 承载（字符串直出 / snippet render），对齐 Semi children。头部对齐 Semi：无默认导航，仅当传入 header 时渲染自定义头部。";
     readonly exports: readonly ["Calendar"];
     readonly props: readonly [{
-        readonly name: "value";
-        readonly type: "Date";
-        readonly default: "undefined";
-        readonly desc: "受控锚点日期(决定展示月份/周)，受控时不回写";
-    }, {
-        readonly name: "defaultValue";
+        readonly name: "displayValue";
         readonly type: "Date";
         readonly default: "new Date()";
-        readonly desc: "非受控初始锚点";
+        readonly desc: "展示锚点日期（决定展示的天/周/月）";
     }, {
-        readonly name: "mode";
-        readonly type: "'month' | 'week' | 'day'";
-        readonly default: "'month'";
-        readonly desc: "视图模式：月(6×7)/周(1×7)/日(单日时间轴)";
+        readonly name: "range";
+        readonly type: "[Date, Date]";
+        readonly default: "undefined";
+        readonly desc: "mode='range' 时必传，左闭右开 [start, end)";
     }, {
-        readonly name: "selectionMode";
-        readonly type: "'single' | 'range'";
-        readonly default: "'single'";
-        readonly desc: "选择模式：单选或范围";
+        readonly name: "header";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "自定义头部内容（对齐 Semi header；缺省不渲染头部）";
     }, {
         readonly name: "events";
         readonly type: "CalendarEvent[]";
         readonly default: "[]";
-        readonly desc: "事件列表";
+        readonly desc: "事件列表（key 必填且唯一）";
+    }, {
+        readonly name: "mode";
+        readonly type: "'day' | 'week' | 'month' | 'range'";
+        readonly default: "'week'";
+        readonly desc: "视图模式";
+    }, {
+        readonly name: "showCurrTime";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "显示当前时间红线（日/周/多日视图，当天列）";
     }, {
         readonly name: "weekStartsOn";
         readonly type: "0|1|2|3|4|5|6";
         readonly default: "0";
         readonly desc: "一周起始(0=周日)";
     }, {
-        readonly name: "maxEventsPerDay";
-        readonly type: "number";
-        readonly default: "3";
-        readonly desc: "每格最多事件数，超出折叠 +N（month/week）";
-    }, {
-        readonly name: "dayStartHour";
-        readonly type: "number";
-        readonly default: "0";
-        readonly desc: "day 视图时间轴起始小时(0-23)";
-    }, {
-        readonly name: "dayEndHour";
+        readonly name: "scrollTop";
         readonly type: "number";
-        readonly default: "23";
-        readonly desc: "day 视图时间轴结束小时(0-23，含)";
-    }, {
-        readonly name: "weekendDays";
-        readonly type: "number[]";
-        readonly default: "[0, 6]";
-        readonly desc: "周末列序号";
+        readonly default: "400";
+        readonly desc: "日/周视图默认滚动区高度（px）";
     }, {
         readonly name: "markWeekend";
         readonly type: "boolean";
-        readonly default: "true";
-        readonly desc: "弱化高亮周末列";
-    }, {
-        readonly name: "disabledDate";
-        readonly type: "(date: Date) => boolean";
-        readonly default: "undefined";
-        readonly desc: "命中则该格禁用";
-    }, {
-        readonly name: "selectedDate";
-        readonly type: "Date";
-        readonly default: "undefined";
-        readonly desc: "受控选中日(边框态，single 模式)，受控时不回写";
-    }, {
-        readonly name: "defaultSelectedDate";
-        readonly type: "Date";
-        readonly default: "undefined";
-        readonly desc: "非受控选中日初值";
-    }, {
-        readonly name: "rangeValue";
-        readonly type: "[Date, Date] | null";
-        readonly default: "undefined";
-        readonly desc: "受控选中范围(range 模式)，受控时不回写";
-    }, {
-        readonly name: "defaultRangeValue";
-        readonly type: "[Date, Date] | null";
-        readonly default: "undefined";
-        readonly desc: "非受控范围初值";
-    }, {
-        readonly name: "locale";
-        readonly type: "string";
-        readonly default: "'zh-CN'";
-        readonly desc: "Intl 月份/星期名格式化语言";
-    }, {
-        readonly name: "ariaLabel";
-        readonly type: "string";
-        readonly default: "undefined";
-        readonly desc: "网格 aria-label，默认取月份标题";
-    }, {
-        readonly name: "popup";
-        readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "弹层模式：渲染 trigger，日历作为浮层弹出（复用 _floating 门户定位）";
+        readonly desc: "区分周末列（灰底）";
     }, {
-        readonly name: "open";
-        readonly type: "boolean";
-        readonly default: "undefined";
-        readonly desc: "受控展开态(popup)，受控时不回写仅 onOpenChange";
-    }, {
-        readonly name: "defaultOpen";
-        readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "非受控初始展开态";
+        readonly name: "minEventHeight";
+        readonly type: "number";
+        readonly default: "Number.MIN_SAFE_INTEGER";
+        readonly desc: "日/周/多日视图事件块最小高度（px）";
     }, {
-        readonly name: "onOpenChange";
-        readonly type: "(info: { open: boolean }) => void";
+        readonly name: "width";
+        readonly type: "number | string";
         readonly default: "undefined";
-        readonly desc: "展开态变化回调";
+        readonly desc: "日历整体宽度";
     }, {
-        readonly name: "placement";
-        readonly type: "Placement";
-        readonly default: "'bottomStart'";
-        readonly desc: "浮层相对 trigger 的位置";
+        readonly name: "height";
+        readonly type: "number | string";
+        readonly default: "600";
+        readonly desc: "日历整体高度";
     }, {
-        readonly name: "getContainer";
-        readonly type: "() => HTMLElement | null";
+        readonly name: "onClick";
+        readonly type: "(e: Event, date: Date) => void";
         readonly default: "undefined";
-        readonly desc: "浮层门户挂载容器(默认 body)";
+        readonly desc: "点击日期格（对齐 Semi function(e, date)）：日/周视图精确到半小时，月视图精确到日";
     }, {
-        readonly name: "trigger";
-        readonly type: "Snippet";
+        readonly name: "onClose";
+        readonly type: "(e: Event) => void";
         readonly default: "undefined";
-        readonly desc: "popup 模式 trigger 自定义内容 { open, toggle }";
-    }, {
-        readonly name: "virtualizeDay";
-        readonly type: "boolean | 'auto'";
-        readonly default: "'auto'";
-        readonly desc: "day 时间轴虚拟化：auto 按阈值/true 强制/false 关闭";
-    }, {
-        readonly name: "virtualizeThreshold";
-        readonly type: "number";
-        readonly default: "18";
-        readonly desc: "触发虚拟化的最少小时行数(auto 生效)";
-    }, {
-        readonly name: "timelineViewportHeight";
-        readonly type: "number";
-        readonly default: "360";
-        readonly desc: "day 时间轴虚拟化视口高度(px)";
+        readonly desc: "月视图 +N 卡片关闭回调（对齐 Semi function(e)）";
     }, {
-        readonly name: "onChange";
-        readonly type: "(info: { value: Date }) => void";
-        readonly default: "undefined";
-    }, {
-        readonly name: "onSelect";
-        readonly type: "(info: { date: Date }) => void";
-        readonly default: "undefined";
-    }, {
-        readonly name: "onRangeChange";
-        readonly type: "(info: { range: [Date, Date] }) => void";
+        readonly name: "onMoreClick";
+        readonly type: "(e: Event, date: Date, remaining: number) => void";
         readonly default: "undefined";
+        readonly desc: "月视图点「还有 N 项」回调（对齐 Semi function(e, date, remaining)）";
     }, {
-        readonly name: "onDateClick";
-        readonly type: "(info: { date: Date }) => void";
+        readonly name: "renderTimeDisplay";
+        readonly type: "(hour: number) => unknown";
         readonly default: "undefined";
+        readonly desc: "自定义日/周视图时间文案（返回字符串即可）";
     }, {
-        readonly name: "onMoreClick";
-        readonly type: "(info: { date: Date; events: CalendarEvent[] }) => void";
+        readonly name: "renderDateDisplay";
+        readonly type: "Snippet<[Date]>";
         readonly default: "undefined";
+        readonly desc: "自定义 week/range 视图日期表头（接收 date 的 Snippet，对齐 Semi ReactNode）";
     }, {
-        readonly name: "dateCell";
-        readonly type: "Snippet";
+        readonly name: "dateGridRender";
+        readonly type: "(dateString: string, date: Date) => Snippet | null | undefined";
         readonly default: "undefined";
-        readonly desc: "自定义整格内容";
+        readonly desc: "自定义单元格/列额外内容（dateString = date.toString()，对齐 Semi）";
     }, {
-        readonly name: "event";
-        readonly type: "Snippet";
+        readonly name: "allDayEventsRender";
+        readonly type: "(events: CalendarEvent[]) => Snippet | null | undefined";
         readonly default: "undefined";
-        readonly desc: "自定义事件块";
+        readonly desc: "自定义顶部全天区渲染";
     }];
     readonly events: readonly [{
-        readonly name: "onChange";
-        readonly desc: "锚点(翻月/翻周/今天)变化";
-    }, {
-        readonly name: "onSelect";
-        readonly desc: "选中某日(single 模式)";
-    }, {
-        readonly name: "onRangeChange";
-        readonly desc: "范围选择完成(range 模式，已排序)";
-    }, {
-        readonly name: "onDateClick";
-        readonly desc: "点击日格";
+        readonly name: "onClick";
+        readonly desc: "点击日期格（日/周半小时、月日）";
     }, {
         readonly name: "onMoreClick";
-        readonly desc: "点击 +N 折叠触发器";
+        readonly desc: "月视图点「还有 N 项」";
+    }, {
+        readonly name: "onClose";
+        readonly desc: "月视图 +N 卡片关闭";
     }];
     readonly slots: readonly [{
-        readonly name: "dateCell";
-        readonly desc: "自定义整格内容 { date, events, isToday, isOutside, disabled }";
-    }, {
-        readonly name: "event";
-        readonly desc: "自定义事件块 { event }";
-    }, {
-        readonly name: "trigger";
-        readonly desc: "popup 模式 trigger 自定义内容 { open, toggle }";
+        readonly name: "header";
+        readonly desc: "自定义头部内容（对齐 Semi header）";
     }];
     readonly a11y: {
         readonly hasRole: true;
         readonly focusable: true;
-        readonly note: "网格 role=grid，星期表头行 role=row 含 role=columnheader，每周一行 role=row 含 role=gridcell；today 设 aria-current=date，选中设 aria-selected，禁用设 aria-disabled。完整 WAI-ARIA grid roving 焦点：网格内仅活动格 tabindex=0（余 -1），方向键移动焦点（←→ 天、↑↓ 周、PageUp/Down 月、Home/End 周首末），跨月/周自动翻页并落焦，Enter/Space 选中。popup 模式：trigger aria-haspopup=dialog/aria-expanded，浮层 role=dialog，外部点击/Esc 关闭并归还焦点。";
+        readonly note: "根容器 role=grid + aria-label（取标题）。时间轴视图每列 role=gridcell（含 aria-label 日期），半小时格为 <button>（aria-label=日期+时:分）。week/range 视图有日期表头 role=columnheader（day 视图对齐 Semi 无列头）。month 视图：星期表头 role=columnheader，日格 role=gridcell，today 格 aria-current=date，日格可点击（Enter/Space）。月视图「还有 N 项」用 Popover（trigger=click，showCloseButton，title=日期），关闭回调 onClose。";
     };
-    readonly tokens: readonly ["--cd-calendar-bg", "--cd-calendar-border", "--cd-calendar-header-bg", "--cd-calendar-text", "--cd-calendar-text-secondary", "--cd-calendar-today-bg", "--cd-calendar-today-fg", "--cd-calendar-selected-border", "--cd-calendar-range-bg", "--cd-calendar-range-edge-bg", "--cd-calendar-week-cell-min-h", "--cd-calendar-hour-min-h", "--cd-calendar-hour-label-w", "--cd-calendar-weekend-bg", "--cd-calendar-cell-bg-hover", "--cd-calendar-event-default-bg", "--cd-calendar-event-fg", "--cd-calendar-disabled-bg", "--cd-calendar-more-color", "--cd-calendar-cell-min-h", "--cd-calendar-radius"];
+    readonly tokens: readonly ["--cd-calendar-color-bg", "--cd-calendar-color-bg-active", "--cd-calendar-color-text-active", "--cd-calendar-color-curr-border", "--cd-calendar-color-currcircle-bg-default", "--cd-calendar-color-date-text-default", "--cd-calendar-color-day-border", "--cd-calendar-color-day-text-default", "--cd-calendar-color-sticky-bg", "--cd-calendar-color-weekend-bg", "--cd-calendar-width-day-grid", "--cd-calendar-width-tag-col", "--cd-calendar-width-currcircle", "--cd-calendar-width-today-date", "--cd-calendar-width-card", "--cd-calendar-height-day-grid", "--cd-calendar-height-allday", "--cd-calendar-height-today-date", "--cd-calendar-height-month-day", "--cd-calendar-height-month-week-row-event-month", "--cd-calendar-radius-today-date", "--cd-calendar-spacing-time-padding-right", "--cd-calendar-spacing-time-item-span-top", "--cd-calendar-spacing-allday-tag-padding-right", "--cd-calendar-spacing-tag-child-padding-right", "--cd-calendar-spacing-grid-row-span-child-padding-x", "--cd-calendar-spacing-currcircle-margin-top", "--cd-calendar-spacing-skeleton-li-child-padding-top", "--cd-calendar-spacing-skeletion-grid-row-li-padding-right", "--cd-calendar-spacing-month-date-right", "--cd-calendar-spacing-month-event-card-wrapper-right", "--cd-calendar-spacing-month-event-card-wrapper-padding-top", "--cd-calendar-spacing-header-info-date-margin-top", "--cd-calendar-spacing-body-pading-x", "--cd-calendar-z-stickytop", "--cd-calendar-z-stickyleft", "--cd-calendar-z-curr", "--cd-calendar-z-item", "--cd-calendar-z-line", "--cd-color-bg-2", "--cd-font-size-regular", "--cd-font-size-small", "--cd-font-size-header", "--cd-focus-ring", "--cd-spacing-extra-tight", "--cd-border-radius-medium", "--cd-border-radius-small"];
     readonly responsive: false;
     readonly examples: readonly [{
-        readonly title: "基础月历";
+        readonly title: "基础周视图";
         readonly code: "<Calendar />";
     }, {
         readonly title: "带事件";
-        readonly code: "<Calendar events={[{ key: 1, start: new Date(), title: \"会议\" }]} />";
+        readonly code: "<Calendar events={[{ key: 1, start: new Date(), children: \"会议\" }]} />";
     }, {
-        readonly title: "周视图";
-        readonly code: "<Calendar mode=\"week\" />";
+        readonly title: "月视图";
+        readonly code: "<Calendar mode=\"month\" />";
     }, {
         readonly title: "日视图（单日时间轴）";
-        readonly code: "<Calendar mode=\"day\" dayStartHour={8} dayEndHour={20} events={[{ key: 1, start: new Date(), title: \"会议\" }]} />";
-    }, {
-        readonly title: "范围选择";
-        readonly code: "<Calendar selectionMode=\"range\" onRangeChange={(i) => console.log(i.range)} />";
+        readonly code: "<Calendar mode=\"day\" events={[{ key: 1, start: new Date(), children: \"会议\" }]} />";
     }, {
-        readonly title: "弹层模式";
-        readonly code: "<Calendar popup defaultOpen onSelect={(i) => console.log(i.date)} />";
+        readonly title: "多日视图（range）";
+        readonly code: "<Calendar mode=\"range\" range={[start, end]} />";
     }, {
-        readonly title: "弹层模式（自定义 trigger）";
-        readonly code: "<Calendar popup>{#snippet trigger({ toggle })}<button onclick={toggle}>选择日期</button>{/snippet}</Calendar>";
+        readonly title: "点击回调";
+        readonly code: "<Calendar onClick={(e, date) => console.log(date)} />";
     }];
 };
 //# sourceMappingURL=meta.d.ts.map

package/dist/calendar/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/calendar/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgHP,CAAC"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/calendar/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6JP,CAAC"}