@pisell/materials 6.11.55 → 6.11.57

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

@@ -1,58 +0,0 @@
-import type { RecordBoardResourceWallCardModel } from '../../types';
-import { type VenueWallStatusKey, type VenueWallStatusTone } from './venueWallUtils';
-/** 与平面图 empty / reserved / occupied 对齐的三种大屏展示态 */
-export declare type VenueWallFloorLikeStatus = 'empty' | 'reserved' | 'occupied';
-/**
- * 标题胶囊 5 态：在 floorLike 三大类基础上，把 `late` 与 `expired` 拆出独立色与文案，
- * 与当前区一档强调色（红）对齐。
- */
-export declare type VenueWallHeaderStatusKey = 'empty' | 'reserved' | 'late' | 'occupied' | 'expired';
-/** 由 {@link buildVenueWallCardPresentation} 产出，供 VenueWallCard 渲染层使用 */
-export declare type VenueWallCardPresentation = {
-    statusKey: VenueWallStatusKey;
-    floorLikeStatus: VenueWallFloorLikeStatus;
-    /** 标题栏右侧 5 态键，决定胶囊样式（描边/底色变体） */
-    headerStatusKey: VenueWallHeaderStatusKey;
-    /** 标题栏右侧：空闲 / 预约中 / 迟到 / 占用中 / 超时 */
-    headerStatusLabel: string;
-    /** 标题胶囊主色（迟到/超时为红，与一档强调色对齐） */
-    headerStatusColor: string;
-    /** 紫色渐变占用卡 vs 浅色强调卡 */
-    cardVariant: 'occupied' | 'accent';
-    mainColor: string;
-    subColor: string;
-    surfaceAccentColor: string;
-    /** 当前区一档：剩余时间 / 距开始 / 结束提示等（非布局「块」） */
-    primaryEmphasisLine: string;
-    primaryEmphasisColor: string;
-    /** 二档：预约时段文案 */
-    timeRangeLine: string;
-    /** 二档：联系人（「Available to Book」等占位已剥离） */
-    contactLine: string;
-    showProgress: boolean;
-    progress: number;
-    progressColor: string;
-    showEndingSoonMarquee: boolean;
-    marqueeText: string;
-    marqueeColor: string;
-    /** 跑马灯胶囊底：与 {@link primaryEmphasisColor} 同一强调色（半透明叠底） */
-    marqueeShellBackground: string;
-};
-/**
- * 纯函数：三态大屏文案 + 进度 + 条件跑马灯。
- * 右上角标题栏仅保留 empty/reserved/occupied；迟到/超时只出现在当前区一档主提示。
- */
-export declare function buildVenueWallCardPresentation(args: {
-    card: RecordBoardResourceWallCardModel;
-    toneMap: Record<VenueWallStatusKey, VenueWallStatusTone>;
-    wallNowMs: number;
-    liveRemainingMin: number;
-    liveRemainingPreciseMin: number;
-    liveStartsInMin: number;
-    liveLateMin: number;
-    boardingSoonBeforeMin: number;
-    idleMain: string;
-    idleSub: string;
-    occupiedCardColor: string;
-    availableCardColor: string;
-}): VenueWallCardPresentation;

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

@@ -1,64 +0,0 @@
-/**
- * 资源墙（Venue Wall）共用工具：六态键、默认色板、倒计时文案、卡片状态推导、配色合并与 diff。
- */
-import type { RecordBoardResourceWallCardModel } from '../../types';
-export declare type VenueWallStatusKey = 'inUse' | 'endingSoon' | 'expired' | 'available' | 'boardingSoon' | 'late';
-/** 单态展示配置（与 {@link VENUE_WALL_STATUS_COLOR_MAP} 值同形） */
-export declare type VenueWallStatusTone = {
-    key: VenueWallStatusKey;
-    label: string;
-    note: string;
-    color: string;
-    noteBg: string;
-};
-/** 仅覆盖部分字段；用于 Control Panel / localStorage */
-export declare type VenueWallStatusToneOverrides = Partial<Record<VenueWallStatusKey, Partial<VenueWallStatusTone>>>;
-/** 单外观（浅 / 深）下的占用/空闲色与六态覆盖；持久化时 light、dark 各存一份 */
-export declare type VenueWallAppearanceSlot = {
-    occupiedCardColor?: string;
-    availableCardColor?: string;
-    statusToneOverrides?: VenueWallStatusToneOverrides;
-};
-export declare type VenueWallAppearanceTheme = {
-    light?: VenueWallAppearanceSlot;
-    dark?: VenueWallAppearanceSlot;
-};
-export declare const VENUE_WALL_STATUS_KEYS: VenueWallStatusKey[];
-/**
- * 六态默认色与占位英文；`getVenueWallStatusToneMap` 会将 label/note 换为 i18n，此处仅作 merge 基底。
- */
-export declare const VENUE_WALL_STATUS_COLOR_MAP: Record<VenueWallStatusKey, VenueWallStatusTone>;
-/** 将 `#RGB` / `#RRGGBB` 转为 `rgba(...)`，供渐变与半透明底 */
-export declare function alphaColor(hex: string, alpha: number): string;
-/** 将数值限制在 [min, max]（布局行列、主文案比例等） */
-export declare const clamp: (value: number, min: number, max: number) => number;
-/** 由卡片字段推导状态键（与演示页 test.tsx 规则一致） */
-export declare function deriveVenueWallStatus(card: RecordBoardResourceWallCardModel): VenueWallStatusKey;
-/**
- * ToolBar Sort 写入的 `searchParams.sort`（如 `status:asc:string`）拆出字段名与升降序。
- */
-export declare function parseRecordBoardToolbarSortParam(sort: unknown): {
-    field: string;
-    dir: 'asc' | 'desc';
-} | null;
-/** 当 Sort 字段名匹配这些 key（忽略大小写）时，资源墙按占用态重排卡片 */
-export declare const DEFAULT_RESOURCE_WALL_STATUS_SORT_FIELD_KEYS: string[];
-export declare function matchesResourceWallStatusSortField(sortField: string, keys: readonly string[]): boolean;
-/**
- * 用于资源墙排序：占用/将结/已结束为 1，其余为 0（与 {@link deriveVenueWallStatus} 一致）。
- * asc → 空闲侧在前；desc → 占用侧在前。
- */
-export declare function venueWallOccupiedSortRank(card: RecordBoardResourceWallCardModel): 0 | 1;
-export declare function formatDurationHM(minAbs: number): string;
-/**
- * 将「剩余/超支分钟数」格式化为跑码条/主副标题用短文案（走 i18n 模板，负值表示 overtime）。
- */
-export declare function formatVenueWallCountdown(min: number): string;
-/**
- * 合并默认六态配色与业务覆盖，供 {@link VenueWallCard} 与 Control Panel 表单初值共用。
- */
-export declare function getVenueWallStatusToneMap(overrides?: VenueWallStatusToneOverrides | null): Record<VenueWallStatusKey, VenueWallStatusTone>;
-/**
- * 将编辑后的完整六态表压成「相对默认」的 overrides，便于持久化与 props 传递。
- */
-export declare function diffVenueWallStatusToneOverrides(draft: Record<VenueWallStatusKey, VenueWallStatusTone>): VenueWallStatusToneOverrides;

package/es/components/pisellRecordBoard/shellFrame/ShellBodyMetaContext.d.ts

@@ -1,24 +0,0 @@
-import React from 'react';
-import type { RecordBoardFloorMapProps, RecordBoardCalendarProps, RecordBoardResourceWallProps } from '../types';
-/**
- * ShellFrame 解析子节点后的元信息，供 ToolBar 等判断是否需要「表格 / 平面图 / 日历」Segmented。
- * 未处于 ShellFrame.Provider 内时为 undefined（如单独挂载 ToolBar）。
- */
-export interface RecordBoardShellBodyMeta {
-    /** 子组件 FloorMap props 与根级 floorMap 合并后的结果（子优先） */
-    effectiveFloorMapProps?: RecordBoardFloorMapProps;
-    /** 子组件 Calendar props 与根级 calendar 合并后的结果（子优先） */
-    effectiveCalendarProps?: RecordBoardCalendarProps;
-    /** ShellFrame 内是否存在 GridLayout / CardLayout 等非 FloorMap 子节点 */
-    hasGridContent: boolean;
-    /** 合并后是否存在可渲染的平面图配置 */
-    hasFloorMapSlot: boolean;
-    /** 合并后是否存在可渲染的日历配置 */
-    hasCalendarSlot: boolean;
-    /** 子组件 ResourceWall props 与根级 resourceWall 合并后的结果（子优先） */
-    effectiveResourceWallProps?: RecordBoardResourceWallProps;
-    /** 合并后是否存在大屏资源墙槽（根级或子节点声明即 true） */
-    hasResourceWallSlot: boolean;
-}
-export declare const RecordBoardShellBodyMetaContext: React.Context<RecordBoardShellBodyMeta | undefined>;
-export declare function useRecordBoardShellBodyMeta(): RecordBoardShellBodyMeta | undefined;

package/es/components/pisellRecordBoard/shellFrame/ToolBar/index.d.ts

@@ -1,12 +0,0 @@
-import React from 'react';
-import type { RecordBoardToolBarProps as ToolBarPropsType } from '../../types';
-import './ToolBarFilter.less';
-import './recordBoardToolbar.less';
-/**
- * RecordBoard 下的工具栏：使用 PisellToolBar。
- * 左侧默认 PisellFind（inline）；右侧默认 PisellFilter。通过 childComponentProps.toolBar.search / toolBar.filter 为对象时透传对应组件 props，为 false 时不渲染。
- * 可透传 topLeft、topRight、bottomLeft、bottomRight、tabs。
- */
-declare const RecordBoardToolBar: React.FC<RecordBoardToolBarProps>;
-export declare type RecordBoardToolBarProps = ToolBarPropsType;
-export default RecordBoardToolBar;

package/es/components/pisellRecordBoard/shellFrame/ToolBar/recordBoardToolBarConstants.d.ts

@@ -1,8 +0,0 @@
-/** 与 RecordBoard ToolBar 行为绑定的 searchParams 字段名 */
-export declare const DEFAULT_SEARCH_FIELD = "keyword";
-/** 筛选在 searchParams 中的字段名 */
-export declare const FILTER_PARAMS_FIELD = "filter";
-/** 排序在 searchParams 中的字段名 */
-export declare const SORT_PARAMS_FIELD = "sort";
-/** 与 ResourceWall 默认 `filterFieldKey` 一致 */
-export declare const RESOURCE_WALL_QUICK_FILTER_KEY = "resource_wall_resource_ids";

package/es/components/pisellRecordBoard/shellFrame/ToolBar/recordBoardToolBarI18n.d.ts

@@ -1,13 +0,0 @@
-import type { SortItemProps } from '../../../sort/types';
-import type { FilterValueType } from '../../../filter/components/FilterButton/types';
-/** 与 Quick Filter 同源：优先 utils，若 utils 返回 key（未命中）则用 materials 再回退 */
-export declare function getSortButtonText(): string;
-/** 资源墙无状态列派生项时注入：下拉仅「状态 → 空闲优先 / 占用优先」，仍渲染排序按钮 */
-export declare function buildResourceWallStatusSortFallbackItem(sortConfig: unknown): SortItemProps;
-export declare function getFilterButtonText(): string;
-export declare function getViewGridLabel(): string;
-export declare function getViewFloorMapLabel(): string;
-export declare function getViewCalendarLabel(): string;
-export declare function getViewResourceWallLabel(): string;
-/** 筛选无值时使用的默认筛选项；业务可通过 childComponentProps.toolBar.filter.defaultFilterValue 覆盖 */
-export declare function getDefaultFilterValue(): FilterValueType;

package/es/components/pisellRecordBoard/shellFrame/ToolBarQuickFilter/index.d.ts

@@ -1,17 +0,0 @@
-import React from 'react';
-import type { FilterItemProps } from '../../../filter/types';
-export interface ToolBarQuickFilterProps {
-    /** 快速筛选项列表（与 Filter 的 quickFilter 同结构），不传则从 columns 派生时由父级传入 */
-    filterList?: FilterItemProps[];
-    /** 表单字段前缀，与 PisellFilter 保持一致，默认 '' */
-    formFiltersPrefix?: string;
-    /** 表单项尺寸 */
-    size?: 'small' | 'middle' | 'large';
-}
-/**
- * RecordBoard 工具栏左侧内联快速筛选：将 quickFilter 直接展示在 ToolBar 左侧，不放入 Filter 弹层。
- * 与 searchParams.filter 联动，变更写入 searchParams.filter.values 并触发 onSearch。
- * 启用时建议 ToolBar 对 PisellFilter 传 hiddenQuickFilter: true，仅保留高级筛选在弹层内。
- */
-declare const ToolBarQuickFilter: React.FC<ToolBarQuickFilterProps>;
-export default ToolBarQuickFilter;

package/es/components/pisellRecordBoard/shellFrame/index.d.ts

@@ -1,30 +0,0 @@
-import React from 'react';
-import RecordBoardToolBar from './ToolBar';
-import RecordBoardBatchActionBar from './BatchActionBar';
-import RecordBoardPagination from './Pagination';
-import RecordBoardSearch from './Search';
-import './shellFrameFloorMap.less';
-import ToolBarReset from './ToolBarReset';
-import ToolBarQuickFilter from './ToolBarQuickFilter';
-import RecordBoardFloorMap from './FloorMap';
-import RecordBoardCalendar from './Calendar/RecordBoardCalendar';
-import RecordBoardResourceWall from './ResourceWall/RecordBoardResourceWall';
-/**
- * Shell Frame：基于 PisellShellFrame 的 RecordBoard 壳层。
- * 解析子节点：**GridLayout / CardLayout 等** 与可选 **FloorMap / Calendar / ResourceWall** 槽；
- * 子视图组合与 Segmented 切换由子节点与根级 props 决定；根级 `floorMap` / `calendar` / `resourceWall` 与子槽合并时**子组件优先**。
- */
-declare const RecordBoardShellFrame: React.FC<{
-    children?: React.ReactNode;
-    className?: string;
-    style?: React.CSSProperties;
-    /**
-     * 工具栏与表格主体之间的「附加条」插槽，透传给底层 PisellShellFrame.belowToolbar。
-     * 用于在不改 ToolBar 内部结构的前提下，紧贴 toolbar 下方插入轻量条目
-     * （例如 HUD 抽屉里的「当日总览」摘要栏）。
-     */
-    belowToolbar?: React.ReactNode;
-}>;
-export default RecordBoardShellFrame;
-export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter, RecordBoardFloorMap, RecordBoardCalendar, RecordBoardResourceWall, };
-export { useRecordBoardShellBodyMeta } from './ShellBodyMetaContext';