@expcat/tigercat-react 2.2.0 → 2.3.0

package/dist/chunk-NCVZCG4W.mjs

@@ -0,0 +1,138 @@
+import {
+  Timeline
+} from "./chunk-4DFN6RZ4.mjs";
+import {
+  Tag
+} from "./chunk-FVA5VKN2.mjs";
+import {
+  Button
+} from "./chunk-WFLXJOFU.mjs";
+
+// src/components/WorkflowTimeline.tsx
+import { useMemo } from "react";
+import {
+  classNames,
+  resolveWorkflowActionButtonProps,
+  shouldShowWorkflowActions,
+  timelineDescriptionClasses,
+  timelineLabelClasses,
+  workflowStepsToTimelineItems,
+  workflowStepStatusLabel,
+  workflowStepStatusTagVariant
+} from "@expcat/tigercat-core";
+import { jsx, jsxs } from "react/jsx-runtime";
+var workflowTimelineRootClasses = "flex flex-col gap-4";
+var workflowActionBarClasses = "flex flex-wrap items-center gap-2";
+var workflowStepHeaderClasses = "flex flex-wrap items-center gap-2";
+var workflowStepActorClasses = "text-sm text-[var(--tiger-text-muted,#6b7280)]";
+var workflowStepCommentClasses = "text-sm text-[var(--tiger-text-secondary,#4b5563)] mt-1";
+function isWorkflowTimelineItem(item) {
+  return typeof item === "object" && item != null && "step" in item && "status" in item && typeof item.status === "string";
+}
+function renderStepContent(item) {
+  const step = item.step;
+  const title = step.title ?? step.label;
+  const statusLabel = workflowStepStatusLabel(item.status);
+  return /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
+    step.time ? /* @__PURE__ */ jsx("div", { className: timelineLabelClasses, children: step.time }) : null,
+    /* @__PURE__ */ jsxs("div", { className: workflowStepHeaderClasses, children: [
+      title ? /* @__PURE__ */ jsx("div", { className: timelineDescriptionClasses, children: title }) : null,
+      /* @__PURE__ */ jsx(Tag, { variant: workflowStepStatusTagVariant(item.status), size: "sm", pill: true, children: statusLabel })
+    ] }),
+    step.actor?.name ? /* @__PURE__ */ jsx("div", { className: workflowStepActorClasses, children: step.actor.name }) : null,
+    step.comment ? /* @__PURE__ */ jsx("div", { className: workflowStepCommentClasses, children: step.comment }) : null
+  ] });
+}
+var WorkflowActionBar = ({
+  items,
+  disabled,
+  ariaLabel,
+  className,
+  style,
+  onAction,
+  "aria-label": ariaLabelAttr,
+  ...rest
+}) => {
+  const toolbarClasses = useMemo(() => classNames(workflowActionBarClasses, className), [className]);
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ...rest,
+      className: toolbarClasses,
+      style,
+      role: "toolbar",
+      "aria-label": ariaLabel ?? ariaLabelAttr ?? "Workflow actions",
+      children: (items ?? []).map((item) => {
+        const buttonProps = resolveWorkflowActionButtonProps(item);
+        const isDisabled = Boolean(disabled || item.disabled);
+        return /* @__PURE__ */ jsx(
+          Button,
+          {
+            size: "sm",
+            variant: buttonProps.variant,
+            danger: buttonProps.danger,
+            disabled: isDisabled,
+            onClick: () => {
+              if (isDisabled) return;
+              onAction?.(item);
+            },
+            children: item.label
+          },
+          item.key
+        );
+      })
+    }
+  );
+};
+var WorkflowTimeline = ({
+  steps,
+  actions,
+  showActions,
+  mode = "left",
+  pending = false,
+  pendingDot,
+  pendingContent,
+  reverse = false,
+  className,
+  style,
+  onAction,
+  renderItem,
+  renderDot,
+  renderActions,
+  "aria-label": ariaLabel,
+  ...rest
+}) => {
+  const timelineItems = useMemo(() => workflowStepsToTimelineItems(steps), [steps]);
+  const showActionBar = shouldShowWorkflowActions(steps, actions, showActions);
+  const rootClasses = useMemo(() => classNames(workflowTimelineRootClasses, className), [className]);
+  const handleRenderItem = (item, index) => {
+    if (renderItem) return renderItem(item, index);
+    if (isWorkflowTimelineItem(item)) return renderStepContent(item);
+    return null;
+  };
+  const actionBar = showActionBar && actions ? renderActions ? renderActions(actions) : /* @__PURE__ */ jsx(WorkflowActionBar, { items: actions, onAction }) : null;
+  return /* @__PURE__ */ jsxs("div", { ...rest, className: rootClasses, style, children: [
+    /* @__PURE__ */ jsx(
+      Timeline,
+      {
+        items: timelineItems,
+        mode,
+        pending,
+        pendingDot,
+        pendingContent,
+        reverse,
+        renderItem: handleRenderItem,
+        renderDot,
+        "aria-label": ariaLabel ?? "Workflow timeline"
+      }
+    ),
+    actionBar
+  ] });
+};
+var WorkflowTimeline_default = WorkflowTimeline;
+
+export {
+  WorkflowActionBar,
+  WorkflowTimeline,
+  WorkflowTimeline_default
+};

package/dist/components/Badge.d.mts

@@ -4,7 +4,7 @@ import { BadgeProps as BadgeProps$1 } from '@expcat/tigercat-core';
 type BadgeProps = BadgeProps$1 & Omit<React__default.HTMLAttributes<HTMLSpanElement>, 'children' | 'content'> & {
     children?: React__default.ReactNode;
 };
-declare const Badge: React__default.ForwardRefExoticComponent<BadgeProps$1 & Omit<React__default.HTMLAttributes<HTMLSpanElement>, "children" | "content"> & {
+declare const Badge: React__default.ForwardRefExoticComponent<BadgeProps$1 & Omit<React__default.HTMLAttributes<HTMLSpanElement>, "content" | "children"> & {
     children?: React__default.ReactNode;
 } & React__default.RefAttributes<HTMLSpanElement>>;
 

package/dist/components/Popconfirm.d.mts

@@ -16,7 +16,7 @@ type PopconfirmProps = Omit<PopconfirmProps$1, 'style' | 'placement' | 'onConfir
     className?: string;
     style?: React__default.CSSProperties;
 };
-declare const Popconfirm: React__default.ForwardRefExoticComponent<Omit<PopconfirmProps$1, "style" | "placement" | "onCancel" | "onConfirm"> & Omit<React__default.HTMLAttributes<HTMLDivElement>, "children" | "className" | "style" | "title"> & {
+declare const Popconfirm: React__default.ForwardRefExoticComponent<Omit<PopconfirmProps$1, "style" | "placement" | "onCancel" | "onConfirm"> & Omit<React__default.HTMLAttributes<HTMLDivElement>, "className" | "style" | "title" | "children"> & {
     children?: React__default.ReactNode | ((state: {
         open: boolean;
     }) => React__default.ReactNode);

package/dist/components/Popover.d.mts

@@ -14,7 +14,7 @@ type PopoverProps = Omit<PopoverProps$1, 'style' | 'placement'> & Omit<React__de
     asChild?: boolean;
     onOpenChange?: (open: boolean) => void;
 };
-declare const Popover: React__default.ForwardRefExoticComponent<Omit<PopoverProps$1, "style" | "placement"> & Omit<React__default.HTMLAttributes<HTMLDivElement>, "children" | "className" | "style" | "title"> & {
+declare const Popover: React__default.ForwardRefExoticComponent<Omit<PopoverProps$1, "style" | "placement"> & Omit<React__default.HTMLAttributes<HTMLDivElement>, "className" | "style" | "title" | "children"> & {
     children?: React__default.ReactNode | ((state: {
         open: boolean;
     }) => React__default.ReactNode);

package/dist/components/Segmented.d.mts

@@ -6,6 +6,6 @@ interface SegmentedProps extends SegmentedProps$1 {
     defaultValue?: string | number;
     onChange?: (value: string | number) => void;
 }
-declare const Segmented: React__default.ForwardRefExoticComponent<SegmentedProps & Omit<React__default.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> & React__default.RefAttributes<HTMLDivElement>>;
+declare const Segmented: React__default.ForwardRefExoticComponent<SegmentedProps & Omit<React__default.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> & React__default.RefAttributes<HTMLDivElement>>;
 
 export { Segmented, type SegmentedProps };

package/dist/components/Space.d.mts

@@ -6,7 +6,7 @@ type SpaceProps = SpaceProps$1 & Omit<React__default.HTMLAttributes<HTMLDivEleme
     className?: string;
     style?: React__default.CSSProperties;
 };
-declare const Space: React__default.ForwardRefExoticComponent<SpaceProps$1 & Omit<React__default.HTMLAttributes<HTMLDivElement>, "children" | "className" | "style"> & {
+declare const Space: React__default.ForwardRefExoticComponent<SpaceProps$1 & Omit<React__default.HTMLAttributes<HTMLDivElement>, "className" | "style" | "children"> & {
     children?: React__default.ReactNode;
     className?: string;
     style?: React__default.CSSProperties;

package/dist/components/Text.d.mts

@@ -6,7 +6,7 @@ type TextProps = TextProps$1 & Omit<React__default.HTMLAttributes<HTMLElement>,
     locale?: Partial<TigerLocale>;
     onCopy?: (text: string) => void;
 };
-declare const Text: React__default.ForwardRefExoticComponent<TextProps$1 & Omit<React__default.HTMLAttributes<HTMLElement>, "children" | "color"> & Pick<React__default.LabelHTMLAttributes<HTMLLabelElement>, "htmlFor"> & {
+declare const Text: React__default.ForwardRefExoticComponent<TextProps$1 & Omit<React__default.HTMLAttributes<HTMLElement>, "color" | "children"> & Pick<React__default.LabelHTMLAttributes<HTMLLabelElement>, "htmlFor"> & {
     children?: React__default.ReactNode;
     locale?: Partial<TigerLocale>;
     onCopy?: (text: string) => void;

package/dist/components/Tooltip.d.mts

@@ -11,7 +11,7 @@ type TooltipProps = Omit<TooltipProps$1, 'content' | 'placement'> & Omit<React__
     asChild?: boolean;
     onOpenChange?: (open: boolean) => void;
 };
-declare const Tooltip: React__default.ForwardRefExoticComponent<Omit<TooltipProps$1, "content" | "placement"> & Omit<React__default.HTMLAttributes<HTMLDivElement>, "children" | "className" | "style" | "title" | "content"> & {
+declare const Tooltip: React__default.ForwardRefExoticComponent<Omit<TooltipProps$1, "content" | "placement"> & Omit<React__default.HTMLAttributes<HTMLDivElement>, "className" | "style" | "title" | "content" | "children"> & {
     children?: React__default.ReactNode;
     content?: React__default.ReactNode;
     className?: string;

package/dist/components/WorkflowTimeline.d.mts

@@ -0,0 +1,20 @@
+import React__default from 'react';
+import { WorkflowActionBarProps as WorkflowActionBarProps$1, WorkflowActionBarItem, WorkflowTimelineProps as WorkflowTimelineProps$1, TimelineItem } from '@expcat/tigercat-core';
+
+interface WorkflowActionBarProps extends WorkflowActionBarProps$1, Omit<React__default.HTMLAttributes<HTMLDivElement>, 'children'> {
+    onAction?: (item: WorkflowActionBarItem) => void;
+}
+interface WorkflowTimelineProps extends Omit<WorkflowTimelineProps$1, 'pendingDot'>, Omit<React__default.HTMLAttributes<HTMLDivElement>, 'children'> {
+    pendingDot?: React__default.ReactNode;
+    pendingContent?: React__default.ReactNode;
+    onAction?: (item: WorkflowActionBarItem) => void;
+    renderItem?: (item: TimelineItem, index: number) => React__default.ReactNode;
+    renderDot?: (item: TimelineItem, options: {
+        pending: boolean;
+    }) => React__default.ReactNode;
+    renderActions?: (actions: WorkflowActionBarItem[]) => React__default.ReactNode;
+}
+declare const WorkflowActionBar: React__default.FC<WorkflowActionBarProps>;
+declare const WorkflowTimeline: React__default.FC<WorkflowTimelineProps>;
+
+export { WorkflowActionBar, type WorkflowActionBarProps, WorkflowTimeline, type WorkflowTimelineProps, WorkflowTimeline as default };

package/dist/components/WorkflowTimeline.mjs

@@ -0,0 +1,15 @@
+import {
+  WorkflowActionBar,
+  WorkflowTimeline,
+  WorkflowTimeline_default
+} from "../chunk-NCVZCG4W.mjs";
+import "../chunk-4DFN6RZ4.mjs";
+import "../chunk-FVA5VKN2.mjs";
+import "../chunk-WFLXJOFU.mjs";
+import "../chunk-G5NPND2T.mjs";
+import "../chunk-RUIFGSVN.mjs";
+export {
+  WorkflowActionBar,
+  WorkflowTimeline,
+  WorkflowTimeline_default as default
+};

package/dist/index.d.mts

@@ -63,6 +63,7 @@ export { ImageAnnotation, ImageAnnotationProps } from './components/ImageAnnotat
 export { List, ListProps } from './components/List.mjs';
 export { Descriptions, DescriptionsProps } from './components/Descriptions.mjs';
 export { Timeline, TimelineProps } from './components/Timeline.mjs';
+export { WorkflowActionBar, WorkflowActionBarProps, WorkflowTimeline, WorkflowTimelineProps } from './components/WorkflowTimeline.mjs';
 export { Countdown, CountdownProps } from './components/Countdown.mjs';
 export { Tree, TreeProps } from './components/Tree.mjs';
 export { Skeleton, SkeletonProps } from './components/Skeleton.mjs';
@@ -172,6 +173,6 @@ import 'react';
  * React components for Tigercat UI library
  */
 
-declare const version = "2.2.0";
+declare const version = "2.3.0";
 
 export { version };

package/dist/index.mjs

@@ -136,6 +136,8 @@ export {
   EMPTY_TREE_KEYS,
   EMPTY_VIRTUAL_TABLE_COLUMNS,
   EMPTY_VIRTUAL_TABLE_ROWS,
+  EMPTY_WORKFLOW_ACTION_BAR_ITEMS,
+  EMPTY_WORKFLOW_TIMELINE_STEPS,
   EN_US_DATEPICKER_LOCALE,
   FORM_VALIDATION_PRESETS,
   FormValidationCancelledError,
@@ -265,6 +267,11 @@ export {
   VIEW_TRANSITION_CSS,
   VIRTUAL_TABLE_HEADER_ROW_HEIGHT,
   WATERMARK_DEFAULT_INK,
+  WORKFLOW_STEP_STATUSES,
+  WORKFLOW_STEP_STATUS_COLORS,
+  WORKFLOW_STEP_STATUS_LABELS,
+  WORKFLOW_STEP_STATUS_TAG_VARIANTS,
+  WORKFLOW_TERMINAL_STEP_STATUSES,
   activateScrollSpyClick,
   activeOpacityClasses,
   activePressClasses,
@@ -743,6 +750,7 @@ export {
   countDecimalPlaces,
   countLines,
   countMaskTokens,
+  countWorkflowStepsByStatus,
   countdownBaseClasses,
   countdownPrefixClasses,
   countdownSuffixClasses,
@@ -1001,6 +1009,7 @@ export {
   filterHiddenColumns,
   filterHiddenFiles,
   filterMentionOptions,
+  filterMenuByPermission,
   filterMenuItems,
   filterOptions,
   filterTableData,
@@ -1343,6 +1352,7 @@ export {
   getCropperHandleStyle,
   getCurrentActiveTourStep,
   getCurrentTime,
+  getCurrentWorkflowStep,
   getCyclicIndex,
   getDataExportCellValue,
   getDataExportFormatLabel,
@@ -2314,6 +2324,11 @@ export {
   isValidUrl,
   isVirtualTableCellControlTarget,
   isWipExceeded,
+  isWorkflowStepActive,
+  isWorkflowStepPending,
+  isWorkflowStepTerminal,
+  isWorkflowTimelineStepStatus,
+  isWorkflowTimelineTerminal,
   kanbanAddColumnClasses,
   kanbanCardCountClasses,
   kanbanFilterHighlightClasses,
@@ -2457,6 +2472,7 @@ export {
   menuKeyId,
   menuLightThemeClasses,
   menuModeClasses,
+  menuSchemaToMenuItems,
   menuSearchEmptyClasses,
   menuSearchFieldClasses,
   menuSearchInputClasses,
@@ -2564,6 +2580,7 @@ export {
   normalizeSvgAttrs,
   normalizeTabKey,
   normalizeTreeSelectValue,
+  normalizeWorkflowTimelineSteps,
   notificationActionButtonClasses,
   notificationActionButtonTypeClasses,
   notificationActionsClasses,
@@ -3034,6 +3051,8 @@ export {
   resolveVirtualTableWidth,
   resolveVisibleResizeHandles,
   resolveWatermarkFont,
+  resolveWorkflowActionButtonProps,
+  resolveWorkflowStepStatus,
   restoreFocus,
   resultBaseClasses,
   resultExtraClasses,
@@ -3169,6 +3188,7 @@ export {
   shouldShowMenuSearch,
   shouldShowSelectClear,
   shouldShowTreeSelectClear,
+  shouldShowWorkflowActions,
   shouldSkipNavigationMenuOpenDelay,
   shouldSkipTableLocalProcessing,
   shouldTrackChartPointer,
@@ -3223,6 +3243,7 @@ export {
   sortDescendingIcon,
   sortFileItems,
   sortNotificationGroups,
+  sortWorkflowTimelineSteps,
   sparklesIcon,
   splitButtonDropdownClasses,
   splitButtonPrimaryBlockClasses,
@@ -3565,6 +3586,11 @@ export {
   watermarkWrapperClasses,
   wifiIcon,
   withCropFile,
+  workflowStepHighlight,
+  workflowStepStatusColor,
+  workflowStepStatusLabel,
+  workflowStepStatusTagVariant,
+  workflowStepsToTimelineItems,
   writeCommentLikeOverlay,
   yieldDataExportFrame,
   zoomInIcon,
@@ -3635,6 +3661,7 @@ export { ImageAnnotation } from './components/ImageAnnotation.mjs';
 export { List } from './components/List.mjs';
 export { Descriptions } from './components/Descriptions.mjs';
 export { Timeline } from './components/Timeline.mjs';
+export { WorkflowTimeline, WorkflowActionBar } from './components/WorkflowTimeline.mjs';
 export { Countdown } from './components/Countdown.mjs';
 export { Tree } from './components/Tree.mjs';
 export { Skeleton } from './components/Skeleton.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expcat/tigercat-react",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "React components for Tigercat UI library",
   "license": "MIT",
   "author": "Yizhe Wang",
@@ -904,6 +904,16 @@
       "import": "./dist/components/Watermark.mjs",
       "default": "./dist/components/Watermark.mjs"
     },
+    "./WorkflowActionBar": {
+      "types": "./dist/components/WorkflowTimeline.d.mts",
+      "import": "./dist/components/WorkflowTimeline.mjs",
+      "default": "./dist/components/WorkflowTimeline.mjs"
+    },
+    "./WorkflowTimeline": {
+      "types": "./dist/components/WorkflowTimeline.d.mts",
+      "import": "./dist/components/WorkflowTimeline.mjs",
+      "default": "./dist/components/WorkflowTimeline.mjs"
+    },
     "./useDrag": {
       "types": "./dist/hooks/useDrag.d.mts",
       "import": "./dist/hooks/useDrag.mjs",
@@ -927,7 +937,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@expcat/tigercat-core": "2.2.0"
+    "@expcat/tigercat-core": "2.3.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",