@voplus/morpho-workspace 11.2.3 → 11.2.6

package/es/modules/calendar-board/event-meta.js

@@ -0,0 +1,329 @@
+import dayjs from "dayjs";
+/**
+ * 分类色板：沿用 calendar-recreation.html 的事件卡原色（蓝 / 红 / 绿 / 橙）。
+ *
+ * 顺序即取色顺序，见 buildColorMap —— 同一 source.type 永远落在同一颜色上，
+ * 与现有 CalendarMonth 用 generateLightColorFromHash(source.type) 的意图一致。
+ */
+export const CATEGORY_COLORS = ["blue", "red", "green", "orange"];
+/**
+ * 「其他」分类统一用的中性色。
+ *
+ * 指固定 3 项（Task / Case / Work）之外的一切分类，含没有 source.type 的 Other：
+ * 它们在整页只有这一种颜色 —— 图例的 Others 圆点、网格里的事件卡、侧栏 UPCOMING 的
+ * 圆点都取它（见 resolveEventColor），所以「不属于固定分类」这件事一眼可辨。
+ *
+ * 刻意不进 CATEGORY_COLORS：它不是分类色、不参与轮转 —— 掺进去会让现有分类的配色整体挪位。
+ */
+export const NEUTRAL_COLOR = "grey";
+/**
+ * 事件卡配色：逐字取自 HTML 的 `border border-{c}-400 bg-{c}-50 text-{c}-600`。
+ *
+ * grey 是后加的「其他」专用色，不在设计稿的四个分类色里，按同一公式取灰阶
+ * （400 描边 + 50 浅底）。
+ */
+export const CHIP_COLOR_CLASS = {
+    blue: "border-blue-400 bg-blue-50",
+    red: "border-red-400 bg-red-50",
+    green: "border-green-400 bg-green-50",
+    orange: "border-amber-400 bg-amber-50",
+    grey: "border-gray-400 bg-gray-50",
+};
+/** 事件卡内的时间行配色，取自 calendar-day-view.html 的 `text-amber-600` / `text-red-500` */
+export const CHIP_TIME_CLASS = {
+    blue: "text-blue-500",
+    red: "text-red-500",
+    green: "text-green-600",
+    orange: "text-amber-600",
+    grey: "text-gray-500",
+};
+/**
+ * 图例 / 侧栏分类列表的圆点配色，取自 HTML 的 `bg-blue-600 / bg-red-500 / ...`。
+ *
+ * grey 与卡片同理，是同灰阶里更深的那一档（对应分类色的 500 / 600）。
+ */
+export const DOT_COLOR_CLASS = {
+    blue: "bg-blue-600",
+    red: "bg-red-500",
+    green: "bg-green-600",
+    orange: "bg-amber-500",
+    grey: "bg-gray-500",
+};
+/**
+ * 事件卡外壳：HTML 的 `text-[10px] font-bold uppercase rounded-md px-2 py-0.5 border-l-4 truncate`。
+ *
+ * 用 overflow-hidden 而不是 truncate：日视图的卡片里还有第二行时间文案，
+ * 文字截断交给内层每一行的 truncate。
+ */
+export const CHIP_BASE_CLASS = "border border-l-4 text-2xs text-font-primary font-bold uppercase rounded-base px-2 py-0.5 cursor-pointer overflow-hidden";
+/** 没有 source.type 时归入的分类名 */
+export const DEFAULT_CATEGORY_TYPE = "Other";
+/** 事件的分类名（source.type） */
+export const getEventType = (event) => event.source?.type || DEFAULT_CATEGORY_TYPE;
+/**
+ * 事件的起始时间。
+ *
+ * ICalendar 声明的是 startDate，FullCalendar 读的是 start，两者都被兼容；
+ * 都缺失时退回 dueDate，仍缺失则返回 undefined（该事件不参与侧栏推导）。
+ */
+export const getEventStart = (event) => {
+    const source = event;
+    const raw = event.start ?? source.startDate ?? source.dueDate;
+    if (!raw)
+        return undefined;
+    const date = dayjs(raw);
+    return date.isValid() ? date.toDate() : undefined;
+};
+/** 事件标题：优先 FullCalendar 解析出的 title，退回 source.title */
+export const getEventTitle = (event) => event.title || event.source?.title || "";
+/**
+ * 事件 source → <NodePropertiesView> 需要的 node。
+ *
+ * 两处形状差异，收在这里而不是散在页面里：
+ * - `nodeType`：NodePropertiesView 的 props 把它声明成必填，但派发其实只看 type
+ *   （DocumentMetaStore.getPropertiesView = getMeta(document.type)），
+ *   source 拿不到时补空串即可；
+ * - `title`：node 不需要，顺手剥掉，避免带进组件。
+ */
+export const toPropertiesTarget = (source) => ({
+    id: source.id,
+    type: source.type,
+    nodeType: source.nodeType ?? "",
+});
+/**
+ * Action 事件的 source.type。
+ *
+ * Action 不是文档节点：它的 meta 注册在另一个 store（morpho-collaboration-action 的
+ * ActionMetaStore），DocumentMetaStore 里没有 "Action"（只有 Board / WorkScheduleNode /
+ * Meeting / MeetingsFolder / Work / Task / WorkType）。所以 Type 为 Action 的事件不能走
+ * <NodePropertiesView>，要另走 action 自己的加载器，见 CalendarActionProperties。
+ */
+export const ACTION_SOURCE_TYPE = "Action";
+/**
+ * 事件 source 是不是 Action —— 决定点开后打开哪一个属性视图。
+ *
+ * 判定只看 type：`nodeType` 运行时不一定下发（见 CalendarBoardSource.nodeType）。
+ */
+export const isActionSource = (source) => source?.type === ACTION_SOURCE_TYPE;
+/**
+ * 按 source.type 去重排序后依次取色。
+ *
+ * 排序保证映射只取决于「出现了哪些 type」，与事件顺序无关，
+ * 因此事件卡、图例、侧栏分类三处拿到的颜色必然一致。
+ */
+export const buildColorMap = (types) => new Map(Array.from(new Set(types))
+    .sort()
+    .map((type, index) => [type, CATEGORY_COLORS[index % CATEGORY_COLORS.length]]));
+/** 一次算出 type → 颜色映射与分类明细（计数 + 成员），供事件卡、图例、侧栏共用 */
+export const summarizeEvents = (events) => {
+    const colorMap = buildColorMap(events.map(getEventType));
+    const groups = new Map();
+    events.forEach((event) => {
+        const type = getEventType(event);
+        const group = groups.get(type);
+        if (group) {
+            group.push(event);
+        }
+        else {
+            groups.set(type, [event]);
+        }
+    });
+    const categories = Array.from(groups, ([type, group]) => ({
+        type,
+        count: group.length,
+        color: colorMap.get(type) ?? CATEGORY_COLORS[0],
+        events: sortByStart(group),
+    })).sort((a, b) => b.count - a.count || a.type.localeCompare(b.type));
+    return { colorMap, categories };
+};
+/** 按开始时间升序；拿不到时间的排在最后（保持稳定，不改变其余相对顺序） */
+const sortByStart = (events) => events
+    .map((event, index) => ({ event, index, time: getEventStart(event)?.getTime() ?? Infinity }))
+    .sort((a, b) => a.time - b.time || a.index - b.index)
+    .map((item) => item.event);
+/**
+ * 图例固定展示的三个分类。
+ *
+ * 数组顺序即图例顺序，与事件多少无关：这四项是「位置」而不是「榜单」，
+ * 因此某一项当期没有事件时也占位（计数 0），图例不会随数据跳动。
+ * 匹配的是 source.type 原文（大小写敏感）。
+ */
+export const LEGEND_FIXED_TYPES = ["Task", "Case", "Work"];
+/** 固定项之外的事件全部折叠进这一项 */
+export const OTHERS_CATEGORY_TYPE = "Others";
+/** type 是不是固定分类（大小写敏感，与 LEGEND_FIXED_TYPES 同口径） */
+const isLegendFixedType = (type) => LEGEND_FIXED_TYPES.includes(type);
+/**
+ * Others 的圆点颜色 = 中性色。
+ *
+ * 与网格里「其他」事件卡同一个来源（NEUTRAL_COLOR 的三张表），
+ * 所以图例圆点、事件卡、侧栏圆点在「不属于固定分类」这件事上是一致的。
+ */
+export const OTHERS_DOT_CLASS = DOT_COLOR_CLASS[NEUTRAL_COLOR];
+/**
+ * 把分类明细折叠成图例要渲染的项：固定 3 项（Task / Case / Work）+ Others。
+ *
+ * 折叠只发生在**展示层**：`summarizeEvents` 的 colorMap 仍按全量分类计算，
+ * 所以固定项的取色与事件卡一致 —— 有事件时沿用它的原色（三处同色）。
+ *
+ * 0 计数的固定项没有原色可用，按固定下标取兜底色（Task → blue、Case → red、
+ * Work → green），否则三项会一起退回首色、挤成一个颜色。
+ *
+ * Others 只在真有其他分类时出现（否则就是一个恒为 0 的多余项）；它的条目是
+ * 其余分类的事件合并后按开始时间升序 —— 与单个分类浮层同一口径，不按原分类分块。
+ */
+export const buildLegendCategories = (categories) => {
+    const byType = new Map(categories.map((category) => [category.type, category]));
+    const fixed = LEGEND_FIXED_TYPES.map((type, index) => {
+        const category = byType.get(type);
+        return {
+            type,
+            count: category?.count ?? 0,
+            events: category?.events ?? [],
+            dotClass: category
+                ? DOT_COLOR_CLASS[category.color]
+                : DOT_COLOR_CLASS[CATEGORY_COLORS[index % CATEGORY_COLORS.length]],
+        };
+    });
+    // 服务端真的下发了一个叫 Others 的分类时，它同样落在这里、被并进聚合项，
+    // 不会和图例自己的 Others 渲染成两项
+    const rest = categories.filter((category) => !isLegendFixedType(category.type));
+    if (rest.length === 0)
+        return fixed;
+    return [
+        ...fixed,
+        {
+            type: OTHERS_CATEGORY_TYPE,
+            count: rest.reduce((total, category) => total + category.count, 0),
+            events: sortByStart(rest.flatMap((category) => category.events)),
+            dotClass: OTHERS_DOT_CLASS,
+        },
+    ];
+};
+/**
+ * 整页事件的取色入口：固定分类（Task / Case / Work）用分类原色，其余一切用中性色。
+ *
+ * 网格里的事件卡、侧栏 UPCOMING 的圆点、小屏底部条的圆点都走这里，于是
+ * 「不在固定分类里」在整页是同一个灰 —— 否则同一条事件会出现「网格里是灰卡、
+ * 侧栏里还是蓝点」这种自相矛盾的呈现。
+ *
+ * 注意与 resolveColor 的区别：那个是纯「分类色轮转」，这里才是事件的最终颜色。
+ */
+export const resolveEventColor = (colorMap, type) => (isLegendFixedType(type) ? resolveColor(colorMap, type) : NEUTRAL_COLOR);
+/** 取某个分类色（按 type 轮转）；映射缺失时退回色板首色。整页取色请走 resolveEventColor */
+export const resolveColor = (colorMap, type) => colorMap.get(type) ?? CATEGORY_COLORS[0];
+/**
+ * 本地过滤：搜索关键字 + 被隐藏的分类。
+ *
+ * 纯前端过滤，不触发重新请求；日历与侧栏 UPCOMING 列表共用同一份结果。
+ */
+export const filterEvents = (events, options) => {
+    const keyword = options?.search?.trim().toLowerCase() ?? "";
+    const hidden = new Set(options?.hiddenTypes ?? []);
+    return events.filter((event) => {
+        if (hidden.has(getEventType(event)))
+            return false;
+        if (!keyword)
+            return true;
+        return getEventTitle(event).toLowerCase().includes(keyword);
+    });
+};
+/** 侧栏 UPCOMING DEADLINES 的默认条数，与 HTML 稿一致 */
+export const UPCOMING_LIMIT = 5;
+/** 相对今天还有几天（今天为 0D） */
+export const formatRemaining = (start, from) => `${Math.max(0, dayjs(start).startOf("day").diff(from.startOf("day"), "day"))}D`;
+/**
+ * UPCOMING DEADLINES：今天及以后的事件，按起始时间升序取前 N 条。
+ *
+ * @param from 以哪一天为「今天」，默认取当前时间；测试注入固定日期用。
+ */
+export const buildUpcoming = (events, summary, options) => {
+    const from = options?.from ?? dayjs();
+    const limit = options?.limit ?? UPCOMING_LIMIT;
+    return events
+        .map((event) => ({ event, start: getEventStart(event) }))
+        .filter((item) => {
+        if (!item.start)
+            return false;
+        return !dayjs(item.start).startOf("day").isBefore(from.startOf("day"));
+    })
+        .sort((a, b) => a.start.getTime() - b.start.getTime())
+        .slice(0, limit)
+        .map(({ event, start }) => {
+        const type = getEventType(event);
+        return {
+            id: event.id,
+            title: getEventTitle(event),
+            type,
+            color: resolveEventColor(summary.colorMap, type),
+            timeLabel: event.allDay
+                ? dayjs(start).format("MMM D")
+                : `${dayjs(start).format("MMM D")} | ${dayjs(start).format("hA")}`,
+            remainingLabel: formatRemaining(start, from),
+            source: event.source,
+        };
+    });
+};
+/**
+ * 写回服务端时的时间格式：**本地时间**，不带时区后缀。
+ *
+ * 与仓库里其它写时间属性的地方保持一致（见 MeetingHeader 的 StartTime/EndTime）。
+ * 注意不要用 toISOString()：它产出 UTC 时刻，UTC+8 下把事件拖到某天零点时，
+ * 日期部分会退回前一天，服务端按本地时间解析就落到错误的日期上。
+ */
+export const DATE_TIME_FORMAT = "YYYY-MM-DDTHH:mm:ss.SSS";
+/**
+ * 把 FullCalendar 给出的落点转成服务端载荷。
+ *
+ * @returns 起止时间都拿不到（或非法）时返回 undefined，调用方应当放弃这次拖拽
+ */
+export const buildDropPayload = (options) => {
+    const start = options.start ? dayjs(options.start) : undefined;
+    if (!start || !start.isValid())
+        return undefined;
+    const payload = { Start: start.format(DATE_TIME_FORMAT) };
+    const end = options.end ? dayjs(options.end) : undefined;
+    if (end && end.isValid())
+        payload.End = end.format(DATE_TIME_FORMAT);
+    return payload;
+};
+/**
+ * 事件 id 比较。
+ *
+ * FullCalendar 会把事件 id 强转成字符串（其内部 EVENT_NON_DATE_REFINERS 里 id: String），
+ * 所以服务端下发的数字 id 到了这边就成了 "123" —— 用 `===` 直接比会永远不相等，
+ * 拖拽结果就同步不回列表。这里统一按字符串比。
+ */
+const isSameEvent = (item, id) => item.id !== undefined && item.id !== null && String(item.id) === id;
+/** 按事件 id 在列表里找对应的那条（id 比较规则见 isSameEvent） */
+export const findEventById = (events, id) => id ? events.find((item) => isSameEvent(item, id)) : undefined;
+/**
+ * 把拖拽结果写回页面自己的事件列表。
+ *
+ * 必须做这一步：`state.listOptions` 只在挂载时加载一次，而事件数据会交给 FullCalendar
+ * 当 eventSources —— 列表里还是旧位置的话，任何一次事件源重置都会把刚拖出去的事件打回原位。
+ *
+ * ⚠️ 没命中任何一条时必须**原样返回同一个数组**：`.map()` 那种写法即使什么都没改也会造出
+ * 新引用，而新引用本身就会触发 FullCalendar 重置事件源，反而把拖拽结果覆盖掉。
+ */
+export const applyDropToEvents = (events, id, drop) => {
+    const index = events.findIndex((item) => isSameEvent(item, id));
+    if (index === -1)
+        return events;
+    const next = { ...events[index] };
+    if (drop.start) {
+        next.start = drop.start;
+        next.startDate = dayjs(drop.start).toDate();
+    }
+    if (drop.end)
+        next.end = drop.end;
+    const result = events.slice();
+    result[index] = next;
+    return result;
+};
+/** 图例浮层里的日期文案，设计稿是 `Aug 3`；拿不到时间时返回空串 */
+export const formatEventDate = (event) => {
+    const start = getEventStart(event);
+    return start ? dayjs(start).format("MMM D") : "";
+};
+//# sourceMappingURL=event-meta.js.map

package/es/modules/calendar-board/event-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-meta.js","sourceRoot":"","sources":["../../../src/modules/calendar-board/event-meta.ts"],"names":[],"mappings":"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"}

package/es/modules/calendar-board/layout.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CalendarBoard 的响应式布局分派。
+ *
+ * 三条规则的唯一落点：
+ * - 小屏（< 1024px）：不渲染右侧栏，Upcoming 固定在底部条；Day / Month / Week 收进 Filter 浮层；
+ * - 桌面端（≥ 1024px）：右侧属性面板展开时，Upcoming 面板不显示。
+ *
+ * 抽成纯函数而不是散在页面的 JSX 里：判定输入只有「是不是小屏」和「aside 是否打开」两个布尔量，
+ * 规则可以被直接测；不抽的话就只能靠挂载整个 CalendarBoard（AsideContent + FullCalendar +
+ * tab / store / filter 上下文）来验证这三条，代价高且脆弱。
+ */
+export interface IBoardLayout {
+    /** 是否渲染右侧栏（Search + UPCOMING / ACTIVITY 面板） */
+    showSidebar: boolean;
+    /** 是否渲染底部固定条（小屏专用，内容为 UPCOMING + 圆点总数 + 首条 title） */
+    showUpcomingBar: boolean;
+    /** 视图切换放哪里：true = Filter 浮层里多一列 By View，false = 留在工具栏 */
+    viewSwitcherInFilter: boolean;
+}
+/**
+ * @param isSmallScreen 视口是否 < 1024px（来自 useMediaQuery(SMALL_SCREEN_QUERY)）
+ * @param isAsideOpen 右侧属性面板是否有内容（来自 asideContext.asideContent）
+ */
+export declare const resolveBoardLayout: (options: {
+    isSmallScreen: boolean;
+    isAsideOpen: boolean;
+}) => IBoardLayout;

package/es/modules/calendar-board/layout.js

@@ -0,0 +1,20 @@
+/**
+ * @param isSmallScreen 视口是否 < 1024px（来自 useMediaQuery(SMALL_SCREEN_QUERY)）
+ * @param isAsideOpen 右侧属性面板是否有内容（来自 asideContext.asideContent）
+ */
+export const resolveBoardLayout = (options) => {
+    /*
+     * 小屏分支不看 isAsideOpen：小屏本来就没有右侧栏，Upcoming 只能靠底部条进入，
+     * 属性面板打开是另一回事（Modal 与 aside 互不干扰，各自占满自己的层）。
+     */
+    if (options.isSmallScreen) {
+        return { showSidebar: false, showUpcomingBar: true, viewSwitcherInFilter: true };
+    }
+    return {
+        // 需求 3：右侧面板展开时 Upcoming 面板让位（aside 自己会占掉这块宽度）
+        showSidebar: !options.isAsideOpen,
+        showUpcomingBar: false,
+        viewSwitcherInFilter: false,
+    };
+};
+//# sourceMappingURL=layout.js.map

package/es/modules/calendar-board/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../src/modules/calendar-board/layout.ts"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAGlC,EAAgB,EAAE;IAClB;;;OAGG;IACH,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;IAClF,CAAC;IAED,OAAO;QACN,8CAA8C;QAC9C,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW;QACjC,eAAe,EAAE,KAAK;QACtB,oBAAoB,EAAE,KAAK;KAC3B,CAAC;AACH,CAAC,CAAC"}

package/es/modules/calendar-board/pages/CalendarBoard/index.css

@@ -0,0 +1,262 @@
+/*
+ * CalendarBoard 的 FullCalendar 皮肤。
+ *
+ * FullCalendar 的内部 DOM（表格、日期格、时间轴、+N 徽标）由它自己生成，挂不上 Tailwind 类，
+ * 因此这里用官方 CSS 变量（--fc-*）为主、少量选择器覆盖为辅。覆盖的选择器都取自
+ * FullCalendar 6.1 实际注入的默认样式（见 daygrid / timegrid 的 internal.js）。
+ *
+ * 颜色一律走 morpho-theme token（var(--color-*) / var(--font-size-*)），不写死色值；
+ * 事件卡的分类原色在 event-meta.ts 的 CHIP_COLOR_CLASS 里，不走这里。
+ */
+
+.calendar-board {
+	/* ═══ FullCalendar 官方 CSS 变量：把内置皮肤换成设计稿的灰白体系 ═══ */
+	--fc-border-color: var(--color-border);
+	--fc-page-bg-color: var(--color-bg-white);
+	--fc-neutral-bg-color: var(--color-bg-table);
+	--fc-neutral-text-color: var(--color-font-grey);
+	--fc-today-bg-color: var(--color-bg-blue-data);
+	--fc-highlight-color: var(--color-bg-blue-data);
+	--fc-now-indicator-color: var(--color-font-secondary);
+	--fc-more-link-bg-color: transparent;
+	--fc-more-link-text-color: inherit;
+	/* 事件节点本身不画底色 / 边框：描边浅底由 .calendar-event-chip 负责 */
+	--fc-event-bg-color: transparent;
+	--fc-event-border-color: transparent;
+	--fc-event-text-color: inherit;
+	--fc-small-font-size: var(--font-size-2xs);
+
+	/* 最后一个事件卡要给 +N 让出的宽度 */
+	--board-more-gutter: 36px;
+
+	.fc {
+		font-size: var(--font-size-xs);
+	}
+
+	/* ═══ 事件节点：剥掉 FullCalendar 自带外观，只剩我们的卡片 ═══ */
+	.fc-h-event {
+		border: 0;
+		background: transparent;
+	}
+
+	.fc-event-main {
+		height: 100%;
+		padding: 0;
+	}
+
+	/*
+	 * ═══ 只去掉最外圈的边框（内部网格线全部保留）═══
+	 *
+	 * 边缘线一共有三层，来自不同元素，必须分别处理：
+	 *
+	 *   1. .fc-scrollgrid 自身 —— 但 FullCalendar 只让它的上 + 左可见
+	 *      （.fc .fc-scrollgrid 把 right/bottom 清零了）；
+	 *   2. .fc-scrollgrid 自己的格子（每个 section 一行、一行一个 th/td）——
+	 *      右 + 下都在（FullCalendar 只把它们的 left/top 清零）；
+	 *   3. 紧贴外框的内层表格（列头 / 日期网格 / 时间轴）——
+	 *      它们的最后一列、最后一行同样各画一条边线。
+	 *
+	 * 选择器的安全性：每一层每行的**最后一个**格子才是右侧边缘
+	 * （时间轴与泳道的分隔线在行内前两个格子之间，不受影响）；
+	 * 底边则只取最后一行的格子，并排除 .fc-col-header —— 它的底边是
+	 * 「列头与日期格之间」的内部线，必须留着。
+	 */
+	.fc-theme-standard .fc-scrollgrid {
+		border: 0;
+	}
+
+	/** 右边缘：所有层级的最后一个格子 */
+	.fc-scrollgrid tr > *:last-child {
+		border-right-width: 0;
+	}
+
+	/** 下边缘：外框自身的最后一行 */
+	.fc-scrollgrid > tbody > tr:last-child > * {
+		border-bottom-width: 0;
+	}
+
+	/**
+	 * 下边缘：最底部那张内层表的最后一行。
+	 *
+	 * 限定在「外框最后一行格子的内部」，而不是所有内层表 ——
+	 * 日视图里全天行在外框第 2 行、并不贴底，它的底边是全天区与时间轴之间的
+	 * 内部分隔线（那条由 .fc-timegrid-divider 负责画），不该被清掉。
+	 */
+	.fc-scrollgrid > tbody > tr:last-child > * table:not(.fc-col-header) tr:last-child > * {
+		border-bottom-width: 0;
+	}
+
+	/* ═══ 列头 SUN / MON / ... ═══ */
+	.fc-col-header-cell {
+		background-color: var(--color-bg-white);
+	}
+
+	.fc-col-header-cell-cushion {
+		padding: var(--space-sm) var(--space-md);
+		font-size: var(--font-size-2xs);
+		font-weight: 600;
+		letter-spacing: 0.05em;
+		text-transform: uppercase;
+		color: var(--color-font-grey);
+		text-decoration: none;
+	}
+
+	/* ═══ 月 / 周视图的日期格 ═══ */
+	/* FullCalendar 默认 row-reverse（日期数字靠右），设计稿是左上角 */
+	.fc .fc-daygrid-day-top {
+		flex-direction: row;
+	}
+
+	.fc-daygrid-day-number {
+		padding: var(--space-sm) var(--space-md);
+		font-weight: 500;
+		color: var(--color-font-primary);
+		text-decoration: none;
+	}
+
+	.fc-day-today .fc-daygrid-day-number {
+		font-weight: 600;
+		color: var(--color-font-secondary);
+	}
+
+	.fc-day-other .fc-daygrid-day-number {
+		color: var(--color-font-disabled);
+	}
+
+	.fc .fc-daygrid-day-events {
+		margin: 0 var(--space-sm) var(--space-sm);
+	}
+
+	.fc-daygrid-event {
+		margin-top: var(--space-xs);
+		border-radius: 0;
+		/* 旧 index.css 同样关掉 nowrap，让长标题能换行 */
+		white-space: normal;
+	}
+
+	/* ═══ +N 徽标：外观由 CalendarMoreLink 负责 ═══ */
+	.fc-daygrid-more-link {
+		margin: 0;
+		padding: 0;
+		border-radius: 0;
+		text-decoration: none;
+	}
+
+	.fc-daygrid-more-link:hover {
+		background-color: transparent;
+	}
+
+	/*
+	 * +N 与最后一个可见事件卡同排。
+	 *
+	 * 设计稿就是这么排的：最后一张卡让位收窄、+N 紧跟在它右边，而不是单独占一行。
+	 * FullCalendar 没有「内联 +N」的选项；搬运 DOM 也不行 —— Preact 重渲染时会把
+	 * .fc-daygrid-day-bottom 重新插回 .fc-daygrid-day-events，徽标跳回原位
+	 * （实测：setOption("eventSources") 之后节点身份不变，但父级被还原）。
+	 * 因此只能用 CSS 叠回去，好处是天然不受重渲染影响。
+	 *
+	 * 两步：
+	 *   1) 让 +N 脱离文档流，钉在最后一张卡那一行的右侧；
+	 *   2) 让最后一张「可见」卡右侧留出 +N 的位置。
+	 *
+	 * 第 1 步用 position: absolute + bottom: 0，而不是「上移一行」的负 margin：
+	 * 容器底部就是最后一张卡的底部，这样不需要写死卡片高度 —— 卡片样式随时可能调，
+	 * 任何像素常量都会在别人改 py-/text- 的时候静默失准。容器本身有 position: relative
+	 * （FullCalendar 的 unbalanced / balanced 两种布局都会给它定位）。
+	 *
+	 * 门禁用 .fc-daygrid-more-link 而不是 .fc-daygrid-day-bottom：
+	 * 后者是**每个格子都会渲染**的空容器，拿它当条件等于恒真，会让所有格子的
+	 * 最后一张卡都被平白缩窄（这个坑是测试先发现的）。
+	 *
+	 * 关于「最后一个可见卡」：被收起的事件仍然留在 DOM 里（带 inline 的
+	 * visibility: hidden），所以要按可见性过滤。这里刻意拆成两条规则
+	 * （先给所有可见卡留位，再把后面还有可见卡的取消），避免写 :not(:has(~ …))
+	 * 这种嵌套形式 —— 部分 CSS 引擎不支持，那会导致 +N 叠在卡片上面而不是并排。
+	 */
+	.fc-daygrid-day-events:has(.fc-daygrid-more-link)
+		> .fc-daygrid-event-harness:not([style*="visibility: hidden"]) {
+		padding-right: var(--board-more-gutter);
+	}
+
+	.fc-daygrid-day-events:has(.fc-daygrid-more-link)
+		> .fc-daygrid-event-harness:not([style*="visibility: hidden"]):has(
+			~ .fc-daygrid-event-harness:not([style*="visibility: hidden"])
+		) {
+		padding-right: 0;
+	}
+
+	.fc .fc-daygrid-day-events:has(.fc-daygrid-more-link) > .fc-daygrid-day-bottom {
+		position: absolute;
+		right: 0;
+		bottom: 0;
+		display: flex;
+		justify-content: flex-end;
+		/* 抵消 FullCalendar 给它的行偏移与左右外边距 */
+		margin: 0 !important;
+	}
+
+	/* ═══ 日视图：时间轴 ═══ */
+	.fc .fc-timegrid-axis-cushion,
+	.fc .fc-timegrid-slot-label-cushion {
+		padding: 0 var(--space-md) 0 0;
+		font-size: var(--font-size-xs);
+		color: var(--color-font-grey);
+	}
+
+	.fc .fc-timegrid-axis-cushion {
+		max-width: none;
+	}
+
+	.fc-timegrid-event {
+		border-radius: var(--radius-base);
+	}
+
+	/* 卡片撑满 FullCalendar 按事件时长算出的定位盒子 */
+	.fc-timegrid-event .calendar-event-chip {
+		height: 100%;
+	}
+
+	.fc .fc-timegrid-now-indicator-line {
+		border-width: 1.5px 0 0;
+	}
+
+	/* ═══ 溢出弹层（moreLinkClick 默认 popover）═══ */
+	.fc-more-popover {
+		border-radius: var(--radius-base);
+		box-shadow: var(--shadow-card);
+	}
+
+	.fc-popover-header {
+		background-color: var(--color-bg-table);
+	}
+
+	/* ═══ 滚动条：沿用旧 index.css 的细条写法 ═══ */
+	.fc-scroller {
+		&::-webkit-scrollbar {
+			width: 7px;
+			height: 7px;
+		}
+		&::-webkit-scrollbar-track {
+			background-color: transparent;
+			border-radius: 2em;
+		}
+		&::-webkit-scrollbar-thumb {
+			background-color: rgba(0, 0, 0, 0.2);
+			background-clip: padding-box;
+			border-radius: 2em;
+		}
+	}
+}
+
+/**
+ * 盖在标题上的透明 DatePicker。
+ *
+ * 沿用 CalendarMonth 的 .calendar-ant-picker 做法：点标题即可跳到某月 / 某周 / 某天。
+ */
+.calendar-board-picker {
+	position: absolute;
+	inset: 0;
+	width: 100%;
+	height: 100%;
+	opacity: 0;
+}

package/es/modules/calendar-board/pages/CalendarBoard/index.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import "./index.css";
+declare const CalendarBoard: () => React.JSX.Element;
+export default CalendarBoard;