@pisell/materials 1.8.41 → 1.8.42

package/es/components/pisellRecordBoard/shellFrame/Calendar/view/BookingCalendarWeekView.js

@@ -0,0 +1,168 @@
+import { CALENDAR_EMPTY_DASHED_SLOT_CLASSNAME } from "../const/bookingCalendarConstants.js";
+import { CALENDAR_WEEKDAY_IDS, tCal } from "../calendarI18n.js";
+import { courtDaySummary, dayOccupancy, fmtDate, formatHourLabel } from "../utils/bookingCalendarDateUtils.js";
+import { getGridBookingRowStateClasses } from "../utils/BookingCalendarStyle.js";
+import { getRemainingToneClass } from "../bookingCalendarViewShared.js";
+import { BookingCalendarGroupRowHeader } from "./BookingCalendarGroupRowHeader.js";
+import React from "react";
+//#region src/components/pisellRecordBoard/shellFrame/Calendar/view/BookingCalendarWeekView.tsx
+/**
+* 周视图：7 日网格 + 左侧分组（可折叠），单元格调起日视图；格内 drop 触发改期草稿。
+*/
+function BookingCalendarWeekView({ calendarProps, isLight, weekDays, bookings, courts, hourSlots, slotStepHours, visibleCourts, visibleCourtRows, isBusinessHour, goToDayFromCell, handleGridDropMove, openBookingDetail, setDraggingItem, setCollapsedGroups, overflowPopover, setOverflowPopover, overflowListModal, setOverflowListModal, overflowPanelRef }) {
+	const props = calendarProps;
+	const todayKey = fmtDate(/* @__PURE__ */ new Date());
+	/** 与下方 grid `minmax(…px, 1fr)` 一致：窄屏由外层 overflow-auto + min-w-0 定视口宽，本值撑开 scrollWidth */
+	const weekDayColMinPx = 150;
+	const weekGridMinWidthPx = 132 + weekDays.length * weekDayColMinPx;
+	return /* @__PURE__ */ React.createElement("div", {
+		key: `week-${fmtDate(weekDays[0])}`,
+		className: "flex min-h-0 flex-1 flex-col"
+	}, /* @__PURE__ */ React.createElement("div", { className: "relative flex min-h-0 min-w-0 flex-1 flex-col" }, /* @__PURE__ */ React.createElement("div", {
+		className: "theme-panel pisell-scroll-hidden min-h-0 min-w-0 max-h-none flex-1 overflow-auto touch-pan-x touch-pan-y select-none",
+		style: { overscrollBehavior: "none" }
+	}, /* @__PURE__ */ React.createElement("div", {
+		className: "grid",
+		style: {
+			minWidth: weekGridMinWidthPx,
+			gridTemplateColumns: `132px repeat(${weekDays.length}, minmax(${weekDayColMinPx}px, 1fr))`
+		}
+	}, /* @__PURE__ */ React.createElement("div", {
+		className: "grid sticky top-0 z-50",
+		style: {
+			gridColumn: "1 / -1",
+			gridTemplateColumns: `132px repeat(${weekDays.length}, minmax(${weekDayColMinPx}px, 1fr))`,
+			isolation: "isolate"
+		}
+	}, /* @__PURE__ */ React.createElement("div", { className: `sticky left-0 z-30 flex w-[132px] min-w-[132px] max-w-[132px] items-center px-2.5 py-3 font-semibold border-b shadow-[8px_0_16px_rgba(0,0,0,0.08)] ${isLight ? "theme-sticky theme-border theme-text" : "bg-[#241d40] border-zinc-800"}` }, tCal("pisell2.recordBoard.calendar.week.headerCourtDate")), weekDays.map((day, i) => {
+		const key = fmtDate(day);
+		const isToday = key === todayKey;
+		bookings.filter((b) => b.date === key);
+		courts.every((court) => hourSlots.filter(isBusinessHour).every((h) => dayOccupancy(court.id, key, bookings, hourSlots, slotStepHours)[h]));
+		return /* @__PURE__ */ React.createElement("div", {
+			key,
+			className: `relative z-20 border-b border-l px-1.5 py-2 text-center shadow-[0_8px_16px_rgba(0,0,0,0.06)] ${isLight ? "theme-border theme-text" : "border-zinc-800"} ${isToday ? isLight ? "bg-gradient-to-b from-violet-50 to-white" : "bg-gradient-to-b from-violet-950 to-[#1a1a22]" : isLight ? "theme-panel-soft" : "bg-[#1a1a22]"}`
+		}, /* @__PURE__ */ React.createElement("div", { className: `text-sm leading-tight ${isLight ? "theme-text-faint" : "text-zinc-400"}` }, tCal(CALENDAR_WEEKDAY_IDS[i])), /* @__PURE__ */ React.createElement("div", { className: "mt-0.5 flex justify-center" }, /* @__PURE__ */ React.createElement("span", {
+			className: "grid h-10 w-10 place-items-center text-3xl font-semibold leading-none",
+			"aria-label": isToday ? "Today" : void 0
+		}, day.getDate())));
+	})), visibleCourtRows.map((row) => /* @__PURE__ */ React.createElement(React.Fragment, { key: row.id }, row.kind === "group" ? /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(BookingCalendarGroupRowHeader, {
+		isLight,
+		view: "week",
+		row: {
+			id: row.id,
+			label: row.label,
+			count: row.count,
+			collapsed: row.collapsed
+		},
+		renderResourceCell: props.renderResourceCell,
+		setCollapsedGroups
+	}), weekDays.map((day) => {
+		const key = fmtDate(day);
+		const groupCourts = visibleCourts.filter((court) => court.type === row.label);
+		const noRatioCell = groupCourts.length === 0;
+		const total = groupCourts.length;
+		let remaining = 0;
+		let ratio = 0;
+		if (!noRatioCell) {
+			remaining = total - groupCourts.filter((court) => {
+				return courtDaySummary(court.id, key, bookings, hourSlots, slotStepHours).items.length > 0;
+			}).length;
+			ratio = total > 0 ? remaining / total : 0;
+		}
+		return /* @__PURE__ */ React.createElement("div", {
+			key: `${row.id}-${key}`,
+			style: { minHeight: 44 },
+			className: `flex h-full items-center justify-center border-b border-l px-1.5 py-1 text-center text-sm font-medium ${isLight ? "theme-border" : "border-zinc-800"} ${noRatioCell ? isLight ? "bg-slate-100 theme-text-faint" : "bg-zinc-800/80 text-zinc-500" : isLight ? "theme-panel-soft" : "bg-[#151a2f] text-zinc-300"}`
+		}, noRatioCell ? /* @__PURE__ */ React.createElement("div", { className: "text-xs opacity-60" }, "—") : /* @__PURE__ */ React.createElement("div", { className: `text-xs font-semibold leading-none ${getRemainingToneClass(ratio, isLight)}` }, tCal("pisell2.recordBoard.calendar.day.freeRatio", {
+			remaining,
+			total
+		})));
+	})) : /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement("div", {
+		className: `sticky left-0 z-30 flex h-full min-h-0 w-[132px] min-w-[132px] max-w-[132px] items-center border-b px-2.5 py-1.5 shadow-[8px_0_16px_rgba(0,0,0,0.06)] ${isLight ? "theme-sticky theme-border" : "border-zinc-800 bg-[#1a1a22]"}`,
+		style: { minHeight: 44 }
+	}, props.renderResourceCell ? props.renderResourceCell({
+		view: "week",
+		row: {
+			kind: "court",
+			id: row.id,
+			name: row.name,
+			type: row.type
+		},
+		isLight
+	}) : /* @__PURE__ */ React.createElement("div", { className: "pisell-rb-cal-week-resource-name min-w-0 w-full font-semibold text-[16px] leading-tight" }, row.name)), weekDays.map((day) => {
+		const key = fmtDate(day);
+		const summary = courtDaySummary(row.id, key, bookings, hourSlots, slotStepHours);
+		const previewItems = summary.items.slice(0, 3);
+		const moreItems = summary.items.slice(3);
+		const moreCount = moreItems.length;
+		const showMoreTile = moreCount > 0 && previewItems.length > 0;
+		return /* @__PURE__ */ React.createElement("button", {
+			key: `${row.id}-${key}`,
+			onClick: () => goToDayFromCell(day, row.id, `week-${row.id}-${key}`),
+			onDragOver: (e) => e.preventDefault(),
+			onDrop: (e) => {
+				e.preventDefault();
+				handleGridDropMove(key, row.id);
+			},
+			style: { minHeight: 44 },
+			className: `relative flex h-full flex-col justify-start border-b border-l p-1 text-left align-top transition outline-none ${isLight ? "theme-border" : "border-zinc-700"} ${summary.fullyBooked ? isLight ? "bg-slate-100 theme-text-faint" : "bg-zinc-800 text-zinc-500" : summary.hasBlock ? isLight ? "bg-red-50 border-red-200" : "bg-red-950/30 border-red-800/40" : summary.occupiedHours.length > 0 ? isLight ? "bg-violet-50" : "bg-[#1c1630]" : isLight ? "theme-grid-cell" : "bg-zinc-900"}`
+		}, summary.fullyBooked ? /* @__PURE__ */ React.createElement("div", {
+			className: "min-h-[28px] w-full rounded-lg bg-zinc-700/70",
+			"aria-hidden": true
+		}) : summary.items.length > 0 ? /* @__PURE__ */ React.createElement("div", { className: "flex w-full flex-col items-start gap-1" }, previewItems.map((item, idx) => {
+			const isLastVisible = idx === previewItems.length - 1;
+			const shrinkForMore = showMoreTile && isLastVisible;
+			const layoutClassName = `rounded-lg px-2.5 py-1.5 text-xs text-left ${getGridBookingRowStateClasses(item)} ${shrinkForMore ? "flex-1 min-w-0" : "w-full"}`;
+			return /* @__PURE__ */ React.createElement("div", {
+				key: idx,
+				className: "flex w-full items-stretch gap-1.5"
+			}, props.renderMonthWeekBooking ? /* @__PURE__ */ React.createElement("div", { className: shrinkForMore ? "flex-1 min-w-0" : "w-full" }, props.renderMonthWeekBooking({
+				item,
+				dateKey: key,
+				view: "week",
+				isLight,
+				layoutClassName,
+				onOpenDetail: openBookingDetail,
+				onDragStart: (it) => setDraggingItem(it),
+				draggable: false
+			})) : /* @__PURE__ */ React.createElement("button", {
+				type: "button",
+				onClick: (e) => {
+					e.stopPropagation();
+					openBookingDetail(item);
+				},
+				className: layoutClassName
+			}, /* @__PURE__ */ React.createElement("div", { className: "truncate" }, item.name), /* @__PURE__ */ React.createElement("div", { className: "mt-1 opacity-80" }, formatHourLabel(item.startHour), " -", " ", formatHourLabel(item.endHour))), shrinkForMore && /* @__PURE__ */ React.createElement("div", {
+				className: "relative h-[52px] w-[52px] shrink-0",
+				ref: (overflowPopover === null || overflowPopover === void 0 ? void 0 : overflowPopover.courtId) === row.id && (overflowPopover === null || overflowPopover === void 0 ? void 0 : overflowPopover.date) === key ? overflowPanelRef : null
+			}, /* @__PURE__ */ React.createElement("button", {
+				onMouseEnter: (e) => {
+					e.stopPropagation();
+					setOverflowPopover({
+						courtId: row.id,
+						date: key,
+						items: moreItems,
+						pinned: false
+					});
+				},
+				onClick: (e) => {
+					e.stopPropagation();
+					setOverflowPopover(null);
+					setOverflowListModal((prev) => prev && prev.scope === row.id && prev.date === key ? null : {
+						scope: row.id,
+						date: key,
+						title: tCal("pisell2.recordBoard.calendar.overflow.listTitleAllBookings", { date: key }),
+						items: summary.items.filter((x) => x.kind === "booking")
+					});
+				},
+				className: "flex h-[52px] w-[52px] items-center justify-center rounded-xl bg-violet-700/90 text-sm font-semibold text-white"
+			}, "+", moreCount)));
+		})) : /* @__PURE__ */ React.createElement("div", {
+			className: `${CALENDAR_EMPTY_DASHED_SLOT_CLASSNAME} text-center ${isLight ? "border-[#d8d0eb] text-[#8f86a9]" : "border-zinc-700 text-zinc-500"}`,
+			"aria-hidden": true
+		}));
+	}))))))));
+}
+//#endregion
+export { BookingCalendarWeekView };

package/es/components/pisellRecordBoard/shellFrame/Calendar/view/bookingCalendarDayViewContext.js

@@ -0,0 +1,8 @@
+import React, { createContext } from "react";
+//#region src/components/pisellRecordBoard/shellFrame/Calendar/view/bookingCalendarDayViewContext.tsx
+const BookingCalendarDayChromeContext = createContext(null);
+function BookingCalendarDayChromeProvider({ children, value }) {
+	return /* @__PURE__ */ React.createElement(BookingCalendarDayChromeContext.Provider, { value }, children);
+}
+//#endregion
+export { BookingCalendarDayChromeProvider };

package/es/components/pisellRecordBoard/shellFrame/Calendar/view/day/useBookingCalendarDayHourRemaining.js

@@ -0,0 +1,33 @@
+import { dayOccupancy } from "../../utils/bookingCalendarDateUtils.js";
+import { useMemo } from "react";
+//#region src/components/pisellRecordBoard/shellFrame/Calendar/view/day/useBookingCalendarDayHourRemaining.ts
+/**
+* 日视图表头：每列整点仍空闲资源占比。
+*/
+function useBookingCalendarDayHourRemaining(visibleCourts, dayKey, bookings, hourSlots, slotStepHours, isBusinessHour) {
+	return useMemo(() => {
+		const total = visibleCourts.length;
+		return Object.fromEntries(hourSlots.map((hour) => {
+			if (!isBusinessHour(hour)) return [hour, {
+				remaining: 0,
+				total,
+				ratio: 0
+			}];
+			const remaining = visibleCourts.filter((court) => !dayOccupancy(court.id, dayKey, bookings, hourSlots, slotStepHours)[hour]).length;
+			return [hour, {
+				remaining,
+				total,
+				ratio: total > 0 ? remaining / total : 0
+			}];
+		}));
+	}, [
+		visibleCourts,
+		dayKey,
+		bookings,
+		hourSlots,
+		slotStepHours,
+		isBusinessHour
+	]);
+}
+//#endregion
+export { useBookingCalendarDayHourRemaining };

package/es/components/pisellRecordBoard/shellFrame/Calendar/view/day/useBookingCalendarDaySelection.js

@@ -0,0 +1,37 @@
+import { dayOccupancy, sameSlot } from "../../utils/bookingCalendarDateUtils.js";
+import { useCallback } from "react";
+//#region src/components/pisellRecordBoard/shellFrame/Calendar/view/day/useBookingCalendarDaySelection.ts
+/**
+* 日视图：空闲 / 锁台槽多选逻辑（状态仍在 Shell，便于与底部 SelectionBar 共用）。
+*/
+function useBookingCalendarDaySelection(dayKey, bookings, hourSlots, slotStepHours, courts, selectedFreeSlots, selectedBlockSlots, setSelectedFreeSlots, setSelectedBlockSlots) {
+	return {
+		isFreeSelected: useCallback((courtId, hour) => selectedFreeSlots.some((slot) => slot.courtId === courtId && slot.date === dayKey && slot.hour === hour), [selectedFreeSlots, dayKey]),
+		isBlockSelected: useCallback((courtId, hour) => selectedBlockSlots.some((slot) => slot.courtId === courtId && slot.date === dayKey && slot.hour === hour), [selectedBlockSlots, dayKey]),
+		toggleSlot: useCallback((courtId, hour) => {
+			const existing = dayOccupancy(courtId, dayKey, bookings, hourSlots, slotStepHours)[hour];
+			const court = courts.find((c) => c.id === courtId);
+			const slot = {
+				courtId,
+				court: court === null || court === void 0 ? void 0 : court.name,
+				date: dayKey,
+				hour
+			};
+			if (!existing) {
+				setSelectedFreeSlots((prev) => prev.some((s) => sameSlot(s, slot)) ? prev.filter((s) => !sameSlot(s, slot)) : [...prev, slot]);
+				return;
+			}
+			if (existing.kind === "block") setSelectedBlockSlots((prev) => prev.some((s) => sameSlot(s, slot)) ? prev.filter((s) => !sameSlot(s, slot)) : [...prev, slot]);
+		}, [
+			bookings,
+			courts,
+			dayKey,
+			hourSlots,
+			setSelectedBlockSlots,
+			setSelectedFreeSlots,
+			slotStepHours
+		])
+	};
+}
+//#endregion
+export { useBookingCalendarDaySelection };

package/es/components/pisellRecordBoard/shellFrame/Calendar/view/resource/useBookingCalendarResourceCellToggle.js

@@ -0,0 +1,18 @@
+import { useCallback } from "react";
+//#region src/components/pisellRecordBoard/shellFrame/Calendar/view/resource/useBookingCalendarResourceCellToggle.ts
+/**
+* 资源视图：cell (court, date) 整天选中切换（状态仍在 Shell，与 SelectionBar 共用）。
+*/
+function useBookingCalendarResourceCellToggle(setSelectedResourceCells) {
+	return useCallback((courtId, dateKey) => {
+		setSelectedResourceCells((prev) => {
+			if (prev.some((s) => s.courtId === courtId && s.dateKey === dateKey)) return prev.filter((s) => !(s.courtId === courtId && s.dateKey === dateKey));
+			return [...prev, {
+				courtId,
+				dateKey
+			}];
+		});
+	}, [setSelectedResourceCells]);
+}
+//#endregion
+export { useBookingCalendarResourceCellToggle };

package/es/components/pisellRecordBoard/shellFrame/Calendar/view/resource/useBookingCalendarResourceDayHeaderRemaining.js

@@ -0,0 +1,33 @@
+import { dayOccupancy, fmtDate, isHourInTimelineSlots } from "../../utils/bookingCalendarDateUtils.js";
+import { useMemo } from "react";
+//#region src/components/pisellRecordBoard/shellFrame/Calendar/view/resource/useBookingCalendarResourceDayHeaderRemaining.ts
+/**
+* 资源视图表头：每个自然日列上「营业时段内至少仍有一个空槽」的资源占比。
+*/
+function useBookingCalendarResourceDayHeaderRemaining(resourceMonthDays, visibleCourts, bookings, hourSlots, slotStepHours) {
+	return useMemo(() => {
+		const total = visibleCourts.length;
+		const map = {};
+		for (const d of resourceMonthDays) {
+			const dateKey = fmtDate(d);
+			const remaining = visibleCourts.filter((court) => hourSlots.some((hour) => {
+				if (!isHourInTimelineSlots(hour, hourSlots)) return false;
+				return !dayOccupancy(court.id, dateKey, bookings, hourSlots, slotStepHours)[hour];
+			})).length;
+			map[dateKey] = {
+				remaining,
+				total,
+				ratio: total > 0 ? remaining / total : 0
+			};
+		}
+		return map;
+	}, [
+		resourceMonthDays,
+		visibleCourts,
+		bookings,
+		hourSlots,
+		slotStepHours
+	]);
+}
+//#endregion
+export { useBookingCalendarResourceDayHeaderRemaining };

package/es/components/pisellRecordBoard/shellFrame/Calendar/view/useBookingCalendarGoToDayFromCell.js

@@ -0,0 +1,29 @@
+import { useCallback } from "react";
+//#region src/components/pisellRecordBoard/shellFrame/Calendar/view/useBookingCalendarGoToDayFromCell.ts
+/**
+* 月/周单元格「进入日视图」：锚定日、清多选、过渡动画方向（由 Shell 持有路由状态）。
+*/
+function useBookingCalendarGoToDayFromCell(anchorDate, commitAnchor, commitView, setNavDirection, setTransitioningToDay, setSelectedFreeSlots, setSelectedBlockSlots, setSelectedResourceCells, setFocusedCourtId) {
+	return useCallback((day, courtId, source) => {
+		setNavDirection(day > anchorDate ? 1 : -1);
+		setTransitioningToDay({ source });
+		setSelectedFreeSlots([]);
+		setSelectedBlockSlots([]);
+		setSelectedResourceCells([]);
+		commitAnchor(day);
+		setFocusedCourtId(courtId || null);
+		commitView("day");
+	}, [
+		anchorDate,
+		commitAnchor,
+		commitView,
+		setFocusedCourtId,
+		setNavDirection,
+		setSelectedBlockSlots,
+		setSelectedFreeSlots,
+		setSelectedResourceCells,
+		setTransitioningToDay
+	]);
+}
+//#endregion
+export { useBookingCalendarGoToDayFromCell };

package/es/components/pisellRecordBoard/shellFrame/ColumnSetting/index.js

@@ -13,7 +13,8 @@ import "./index.less";
 const RecordBoardColumnSetting = () => {
 	var _ctx$childComponentPr, _ctx$childComponentPr2, _ctx$columnVisibility, _ctx$columnOrder;
 	const ctx = useRecordBoardContext();
-	const compactToolbar = ((_ctx$childComponentPr = ctx.childComponentProps) === null || _ctx$childComponentPr === void 0 || (_ctx$childComponentPr = _ctx$childComponentPr.toolBar) === null || _ctx$childComponentPr === void 0 ? void 0 : _ctx$childComponentPr.toolbarDensity) === "compact";
+	const density = (_ctx$childComponentPr = ctx.childComponentProps) === null || _ctx$childComponentPr === void 0 || (_ctx$childComponentPr = _ctx$childComponentPr.toolBar) === null || _ctx$childComponentPr === void 0 ? void 0 : _ctx$childComponentPr.toolbarDensity;
+	const compactToolbar = density === "compact" || density === "compact-narrow";
 	const gridColumns = (_ctx$childComponentPr2 = ctx.childComponentProps) === null || _ctx$childComponentPr2 === void 0 || (_ctx$childComponentPr2 = _ctx$childComponentPr2.grid) === null || _ctx$childComponentPr2 === void 0 ? void 0 : _ctx$childComponentPr2.columns;
 	const columnVisibility = (_ctx$columnVisibility = ctx.columnVisibility) !== null && _ctx$columnVisibility !== void 0 ? _ctx$columnVisibility : {};
 	const onColumnVisibilityChange = ctx.onColumnVisibilityChange;

package/es/components/pisellRecordBoard/shellFrame/Pagination/index.js

@@ -34,7 +34,13 @@ const RecordBoardPagination = (props) => {
 		ctx.onPageChange,
 		(_ctx$childComponentPr3 = ctx.childComponentProps) === null || _ctx$childComponentPr3 === void 0 ? void 0 : _ctx$childComponentPr3.pagination
 	]);
-	if (typeof render === "function") return /* @__PURE__ */ React.createElement(React.Fragment, null, render(_objectSpread2(_objectSpread2({}, ctx), rest)));
+	/**
+	* 渲染优先级：组件 `render` prop > 容器根 props 透传过来的 `ctx.paginationRender` > 默认 materials Pagination。
+	* 这样业务方（如 reservation hud 抽屉）只需在 `<PisellRecordBoard paginationRender={...} />`
+	* 就能彻底替换默认分页（含外层 50px 高边框容器、Previous/Next 大按钮）为 antd 原生 small Pagination。
+	*/
+	const effectiveRender = render !== null && render !== void 0 ? render : ctx.paginationRender;
+	if (typeof effectiveRender === "function") return /* @__PURE__ */ React.createElement(React.Fragment, null, effectiveRender(_objectSpread2(_objectSpread2({}, ctx), rest)));
 	if (ctx.total === 0) return /* @__PURE__ */ React.createElement("div", {
 		"data-layout-slot": "pagination",
 		className: "record-board-shell-frame-pagination record-board-shell-frame-pagination-placeholder",

package/es/components/pisellRecordBoard/shellFrame/ResourceWall/NoteTicker.js

@@ -0,0 +1,43 @@
+import React, { useEffect, useState } from "react";
+import "./VenueWallMarquee.less";
+//#region src/components/pisellRecordBoard/shellFrame/ResourceWall/NoteTicker.tsx
+function usePrefersReducedMotion() {
+	const [reduced, setReduced] = useState(false);
+	useEffect(() => {
+		if (typeof window === "undefined" || !window.matchMedia) return;
+		const mq = window.matchMedia("(prefers-reduced-motion: reduce)");
+		setReduced(mq.matches);
+		const onChange = () => setReduced(mq.matches);
+		mq.addEventListener("change", onChange);
+		return () => mq.removeEventListener("change", onChange);
+	}, []);
+	return reduced;
+}
+const MARQUEE_COPY_COUNT = 3;
+/**
+* 底部说明条：短文案省略静态展示，长文案无缝跑马灯（多段 copy 与 `VenueWallMarquee.less` 中 -33.333% 动画配套）。
+* 系统「减少动态效果」时强制静态展示；跑马灯区对读屏 `aria-hidden` 避免重复朗读。
+*/
+const NoteTicker = React.memo(function NoteTicker({ text, color, duration = 24, shouldMarquee }) {
+	const reducedMotion = usePrefersReducedMotion();
+	if (!(shouldMarquee && !reducedMotion)) return /* @__PURE__ */ React.createElement("div", {
+		className: "pisell-resource-wall-note-marquee-static",
+		style: { color },
+		title: text
+	}, text);
+	return /* @__PURE__ */ React.createElement("div", {
+		className: "pisell-resource-wall-note-marquee-wrap",
+		"aria-hidden": true
+	}, /* @__PURE__ */ React.createElement("div", {
+		className: "pisell-resource-wall-note-marquee-track",
+		style: {
+			animationDuration: `${duration}s`,
+			color
+		}
+	}, Array.from({ length: MARQUEE_COPY_COUNT }, (_, i) => /* @__PURE__ */ React.createElement("div", {
+		key: i,
+		className: "pisell-resource-wall-note-marquee-copy"
+	}, text))));
+});
+//#endregion
+export { NoteTicker };

package/es/components/pisellRecordBoard/shellFrame/ResourceWall/PisellRecordBoardResourceWallView.d.ts

@@ -0,0 +1,14 @@
+import { RecordBoardResourceWallProps } from "../../types.js";
+import React from "react";
+//#region src/components/pisellRecordBoard/shellFrame/ResourceWall/PisellRecordBoardResourceWallView.d.ts
+/** 与 {@link RecordBoardResourceWallProps.filterFieldKey} 默认一致 */
+declare const DEFAULT_RESOURCE_WALL_FILTER_FIELD_KEY = "resource_wall_resource_ids";
+/**
+ * RecordBoard 大屏资源墙主视口：`cards` 提供全量卡数据；可见列表由
+ * `searchParams.filter.values[filterFieldKey]` 中的资源 id 与 `cards` 交集决定。
+ * 若 ToolBar `searchParams.sort` 指向状态列（默认字段名 `status`），则按占用态重排展示顺序。
+ * 支持网格分页轮播、浅深外观、伪全屏与控制台（布局 / 配色 / 选中资源）。
+ */
+declare const PisellRecordBoardResourceWallView: React.FC<RecordBoardResourceWallProps>;
+//#endregion
+export { DEFAULT_RESOURCE_WALL_FILTER_FIELD_KEY, PisellRecordBoardResourceWallView };