@gcsa/console-core 0.1.0

package/src/index.ts

@@ -0,0 +1,237 @@
+import { z } from 'zod';
+
+export type GcsaNavItem = {
+  key: string;
+  label: string;
+  href?: string;
+  /** @deprecated use iconKey */
+  icon?: string;
+  iconKey?: 'dashboard' | 'alert' | 'assets' | 'settings' | 'users' | 'chat';
+};
+
+export type GcsaTableColumnAlign = 'left' | 'center' | 'right';
+/** 固定列方向；`true` 兼容 Element Plus，等价于左固定。 */
+export type GcsaTableColumnFixed = 'left' | 'right' | true;
+
+export type GcsaTableColumnFilter = {
+  type: 'text' | 'select';
+  placeholder?: string;
+  options?: GcsaSelectOption[];
+};
+
+export type GcsaTableColumn<T> = {
+  /** 列唯一键，对应插槽 `cell-{id}` / `header-{id}` */
+  id: string;
+  header: string;
+  accessorKey?: keyof T & string;
+  /** 是否可排序 */
+  sortable?: boolean;
+  /** 自定义客户端排序比较函数，返回值语义与 Array.sort 一致 */
+  sortCompare?: (a: T, b: T) => number;
+  width?: string;
+  /** 列最小宽度，避免窄容器下文字被挤成竖排 */
+  minWidth?: string;
+  /** 是否允许用户拖拽调整列宽 */
+  resizable?: boolean;
+  /** 内容过长时显示省略号，并通过 title 保留完整内容 */
+  showOverflowTooltip?: boolean;
+  align?: GcsaTableColumnAlign;
+  fixed?: GcsaTableColumnFixed;
+  hidden?: boolean;
+  filter?: GcsaTableColumnFilter;
+  /** 插槽后缀，默认与 id 相同 */
+  slot?: string;
+  /** 无插槽时的简易单元格渲染 */
+  cell?: (row: T) => unknown;
+  /** 默认单元格格式化；不改变排序和原始值，只改变展示内容 */
+  formatter?: (value: unknown, row: T, index: number) => unknown;
+  /** Grouped child columns; compatible with nested el-table-column definitions. */
+  columns?: GcsaTableColumn<T>[];
+};
+
+export { normalizeGcsaTableColumns } from './gcsaTableMigration';
+export type { GcsaLegacyTableColumn, GcsaTableMigration, GcsaTableMigrationOptions } from './gcsaTableMigration';
+
+export type GcsaChatMessageRole = 'user' | 'assistant' | 'system';
+
+export type GcsaChatMessage = {
+  id: string;
+  role: GcsaChatMessageRole;
+  content: string;
+  status?: 'streaming' | 'done' | 'error';
+  /** 消息时间，用于底部 meta 展示 */
+  createdAt?: string | number | Date;
+  /** 强制纯文本，不渲染 Markdown */
+  plainText?: boolean;
+  /** 系统就绪 / 提示类消息样式 */
+  systemReady?: boolean;
+  /** 错误消息样式 */
+  error?: boolean;
+};
+
+export {
+  formatGcsaChatTime,
+  gcsaChatAvatarLabel,
+  shouldRenderGcsaChatMarkdown
+} from './gcsaChat';
+export type { GcsaChatMarkdownMode } from './gcsaChat';
+export { renderGcsaMarkdown } from './gcsaMarkdown';
+export type { GcsaMessageType } from './gcsaMessage';
+export { GCSA_MESSAGE_DURATION_MS } from './gcsaMessage';
+export { copyGcsaText } from './gcsaClipboard';
+export { collectGcsaMenuBranchKeys, navItemsToMenuItems } from './gcsaMenu';
+export type { GcsaMenuIconKey, GcsaMenuItem, GcsaMenuMode } from './gcsaMenu';
+
+export const gcsaLoginSchema = z.object({
+  email: z.string().email('请输入有效邮箱'),
+  password: z.string().min(6, '至少 6 位密码')
+});
+
+export { formatGcsaDateParts, formatGcsaMonthParts, isGcsaDateString, isGcsaMonthString } from './gcsaDate';
+export {
+  GCSA_TIME_PICKER_CELL_HEIGHT,
+  GCSA_TIME_STRING_PATTERN,
+  gcsaBuildTimeOptions,
+  gcsaCurrentTimeOption,
+  gcsaMinutesToTime,
+  gcsaNearestTimeOption,
+  gcsaNormalizeTimeStep,
+  gcsaResolveTimeDraft,
+  gcsaTimePickerHours,
+  gcsaTimePickerMinutes,
+  gcsaTimePickerScrollIndex,
+  gcsaTimePickerScrollTop,
+  gcsaTimeToMinutes,
+  isGcsaTimeString
+} from './gcsaTime';
+export type { GcsaTimePickerOptions, GcsaTimeString } from './gcsaTime';
+export type {
+  GcsaDatePickerMode,
+  GcsaDateRangeValue,
+  GcsaDateString,
+  GcsaMonthRangeValue,
+  GcsaMonthString
+} from './gcsaDate';
+export {
+  GCSA_DEFAULT_LOCALE,
+  formatGcsaLocaleMessage,
+  getGcsaDatePickerMessages,
+  getGcsaLocaleMessages,
+  getGcsaStartOfWeek,
+  normalizeGcsaLocale
+} from './gcsaLocale';
+export type { GcsaConsoleLocale, GcsaConsoleLocaleMessages, GcsaDatePickerLocaleStrings } from './gcsaLocale';
+export {
+  clearGcsaTablePreferences,
+  normalizeGcsaTablePreferences,
+  readGcsaTablePreferences,
+  writeGcsaTablePreferences
+} from './gcsaTablePreferences';
+export type { GcsaTablePreferenceStorage, GcsaTablePreferences, GcsaTableSortingPreference } from './gcsaTablePreferences';
+export {
+  GCSA_TABLE_DEFAULT_COLUMN_MIN_WIDTH,
+  GCSA_TABLE_EXPAND_COLUMN_WIDTH,
+  GCSA_TABLE_MIN_WIDTH_FLOOR,
+  GCSA_TABLE_SELECTION_COLUMN_WIDTH,
+  getGcsaTableFixedOffset,
+  getGcsaTableMinWidth
+} from './gcsaTableLayout';
+export type { GcsaTableFixedOffsetOptions, GcsaTableLayoutColumn } from './gcsaTableLayout';
+export { getGcsaTableSortChange, getGcsaTableSorting } from './gcsaTableEvents';
+export type { GcsaTableColumnInfo, GcsaTableHeaderEvent, GcsaTableSortChange, GcsaTableSortOrder, GcsaTableSortingEntry } from './gcsaTableEvents';
+export { getGcsaTableDefaultExpandedKeys, getGcsaTableRowId } from './gcsaTableRows';
+export {
+  getGcsaPaginationItems,
+  parseGcsaPaginationLayout,
+  resolveGcsaPaginationLayout,
+  getGcsaPaginationAlignClass,
+  GCSA_PAGINATION_LAYOUT_PARTS
+} from './gcsaPagination';
+export type {
+  GcsaPaginationItem,
+  GcsaPaginationAlign,
+  GcsaPaginationLayoutPart
+} from './gcsaPagination';
+
+export const gcsaNotifySchema = z.object({
+  title: z.string().min(1, '标题不能为空'),
+  channel: z.enum(['email', 'webhook', 'sms']),
+  enabled: z.boolean()
+});
+
+export type GcsaNotifyValues = z.infer<typeof gcsaNotifySchema>;
+
+export type GcsaButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger' | 'link';
+export type GcsaButtonSize = 'sm' | 'md' | 'lg';
+export type { GcsaComponentSize } from './gcsaSize';
+import type { GcsaComponentSize } from './gcsaSize';
+export type GcsaSelectSize = GcsaComponentSize;
+export type GcsaInputNumberControls = 'both' | 'right' | 'none';
+export type GcsaConsoleTheme = 'dark' | 'light';
+export type GcsaDrawerPlacement = 'left' | 'right' | 'top' | 'bottom';
+
+export type GcsaSelectOption = {
+  label: string;
+  value: string;
+  /** 分组标题；同组选项使用相同 group */
+  group?: string;
+  disabled?: boolean;
+};
+
+export type GcsaCascaderOption = {
+  label: string;
+  value: string;
+  disabled?: boolean;
+  children?: GcsaCascaderOption[];
+};
+
+export type GcsaTransferOption = {
+  label: string;
+  value: string;
+  disabled?: boolean;
+};
+
+export type GcsaStepStatus = 'wait' | 'process' | 'finish' | 'error';
+export type GcsaStepItem = { key: string; title: string; description?: string; status?: GcsaStepStatus; disabled?: boolean };
+export type GcsaTimelineItem = { key: string; label?: string; content: string; time?: string; tone?: 'primary' | 'success' | 'warning' | 'danger' };
+
+export type GcsaRadioOption = {
+  label: string;
+  value: string;
+  disabled?: boolean;
+};
+
+export {
+  GCSA_DEFAULT_COMPONENT_SIZE,
+  gcsaControlSizeClass,
+  resolveGcsaButtonSize,
+  resolveGcsaComponentSize
+} from './gcsaSize';
+export {
+  createGcsaPopupPositioning,
+  type GcsaPopupPlacement,
+  type GcsaPopupPositioningOptions
+} from './gcsaPopupPositioning';
+export {
+  assertFloatingWithinViewport,
+  buildGcsaPopupMiddleware,
+  computeGcsaPopupPosition,
+  getFloatingBox,
+  type GcsaPopupRect,
+  type GcsaViewportRect
+} from './gcsaPopupCollision';
+export {
+  GCSA_POPUP_OVERFLOW_PADDING,
+  GCSA_POPUP_STYLE_CONTRACT,
+  GCSA_POPUP_VIEWPORT_CSS_INSET,
+  cssBlockIncludes,
+  extractCssRuleBlock,
+  validatePopupStyleContract,
+  type GcsaPopupStyleRule
+} from './gcsaPopupStyles';
+export { toCssLength } from './gcsaCssLength';
+export {
+  gcsaJoinDateTime,
+  gcsaSplitDateTime,
+  type GcsaDateTimeString
+} from './gcsaDateTimeValue';