ai-progress-controls 0.1.0

package/src/core/batch-progress/index.ts

@@ -0,0 +1,14 @@
+export { BatchProgress } from './BatchProgress';
+export type {
+  BatchProgressConfig,
+  BatchProgressState,
+  BatchProgressUpdate,
+  BatchItem,
+  BatchItemStatus,
+  BatchStartEvent,
+  BatchItemUpdateEvent,
+  BatchCompleteEvent,
+  BatchCancelEvent,
+  BatchItemCompleteEvent,
+  BatchItemFailedEvent,
+} from './types';

package/src/core/batch-progress/styles.ts

@@ -0,0 +1,480 @@
+export const styles = `
+  :host {
+    /* CSS variables inherit from document root with fallback defaults */
+    display: block;
+    font-family: var(--ai-font-family, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif);
+    font-size: var(--ai-font-size, 14px);
+    color: var(--ai-text-color, #1f2937);
+  }
+
+  :host([style*="cursor: progress"]) .container {
+    cursor: progress;
+  }
+
+  :host([style*="cursor: not-allowed"]) .container {
+    cursor: not-allowed;
+  }
+
+  :host([style*="cursor: default"]) .container {
+    cursor: default;
+  }
+
+  .container {
+    background: var(--ai-background-color, #ffffff);
+    border: 1px solid var(--ai-border-color, #e5e7eb);
+    border-radius: var(--ai-border-radius, 8px);
+    padding: var(--ai-spacing, 12px);
+  }
+
+  .header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: var(--ai-spacing, 12px);
+  }
+
+  .status-message {
+    font-weight: 600;
+    color: var(--ai-text-color, #1f2937);
+    font-size: 14px;
+  }
+
+  .status-badge {
+    padding: 4px 10px;
+    border-radius: 12px;
+    font-size: 12px;
+    font-weight: 600;
+    text-transform: uppercase;
+  }
+
+  .status-badge.processing {
+    background: #dbeafe;
+    color: #1e40af;
+  }
+
+  .status-badge.completed {
+    background: #d1fae5;
+    color: #065f46;
+  }
+
+  .status-badge.cancelled {
+    background: #fee2e2;
+    color: #991b1b;
+  }
+
+  .stats {
+    display: flex;
+    gap: 16px;
+    margin-bottom: var(--ai-spacing, 12px);
+    padding: 8px;
+    background: #f9fafb;
+    border-radius: 6px;
+  }
+
+  .stat-item {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+  }
+
+  .stat-label {
+    font-size: 11px;
+    color: #6b7280;
+    text-transform: uppercase;
+    font-weight: 600;
+    letter-spacing: 0.5px;
+  }
+
+  .stat-value {
+    font-size: 18px;
+    font-weight: 700;
+    color: var(--ai-text-color, #1f2937);
+  }
+
+  .stat-value.success {
+    color: var(--ai-secondary-color, #10b981);
+  }
+
+  .stat-value.error {
+    color: #ef4444;
+  }
+
+  .stat-value.rate {
+    color: var(--ai-primary-color, #3b82f6);
+  }
+
+  .overall-progress {
+    margin-bottom: var(--ai-spacing, 12px);
+  }
+
+  .progress-header {
+    display: flex;
+    justify-content: space-between;
+    margin-bottom: 6px;
+    font-size: 12px;
+    color: #6b7280;
+  }
+
+  .progress-bar {
+    width: 100%;
+    height: 8px;
+    background: #f3f4f6;
+    border-radius: 4px;
+    overflow: hidden;
+    position: relative;
+  }
+
+  .progress-fill {
+    height: 100%;
+    background: linear-gradient(90deg, var(--ai-primary-color, #3b82f6), var(--ai-secondary-color, #10b981));
+    transition: width 0.3s ease;
+    border-radius: 4px;
+  }
+
+  .items-container {
+    max-height: 400px;
+    overflow-y: auto;
+    border: 1px solid var(--ai-border-color, #e5e7eb);
+    border-radius: 6px;
+    background: white;
+  }
+
+  .batch-item {
+    padding: 10px 12px;
+    border-bottom: 1px solid var(--ai-border-color, #e5e7eb);
+    transition: background 0.2s;
+  }
+
+  .batch-item:last-child {
+    border-bottom: none;
+  }
+
+  .batch-item.processing {
+    background: #eff6ff;
+  }
+
+  .batch-item.completed {
+    background: #f0fdf4;
+  }
+
+  .batch-item.failed {
+    background: #fef2f2;
+  }
+
+  .batch-item.collapsed {
+    opacity: 0.6;
+    max-height: 0;
+    padding: 0 12px;
+    overflow: hidden;
+    transition: max-height 0.3s, padding 0.3s, opacity 0.3s;
+  }
+
+  .item-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: 4px;
+  }
+
+  .item-label {
+    font-size: 13px;
+    font-weight: 500;
+    color: var(--ai-text-color, #1f2937);
+    flex: 1;
+  }
+
+  .item-status {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    font-size: 11px;
+    font-weight: 600;
+  }
+
+  .item-status.pending {
+    color: #6b7280;
+  }
+
+  .item-status.processing {
+    color: var(--ai-primary-color, #3b82f6);
+  }
+
+  .item-status.completed {
+    color: var(--ai-secondary-color, #10b981);
+  }
+
+  .item-status.failed {
+    color: #ef4444;
+  }
+
+  .item-status-icon {
+    font-size: 14px;
+  }
+
+  .item-progress-bar {
+    height: 4px;
+    background: #e5e7eb;
+    border-radius: 2px;
+    overflow: hidden;
+    margin-top: 4px;
+  }
+
+  .item-progress-fill {
+    height: 100%;
+    background: var(--ai-primary-color, #3b82f6);
+    transition: width 0.3s ease;
+    border-radius: 2px;
+  }
+
+  .item-error {
+    margin-top: 4px;
+    padding: 6px 8px;
+    background: #fee2e2;
+    border-left: 3px solid #ef4444;
+    border-radius: 4px;
+    font-size: 12px;
+    color: #991b1b;
+  }
+
+  .controls {
+    margin-top: var(--ai-spacing, 12px);
+    display: flex;
+    justify-content: flex-end;
+  }
+
+  .cancel-btn {
+    padding: 8px 16px;
+    background: #fee2e2;
+    color: #991b1b;
+    border: 1px solid #fecaca;
+    border-radius: 6px;
+    font-size: 13px;
+    font-weight: 600;
+    cursor: pointer;
+    transition: background 0.2s;
+  }
+
+  .cancel-btn:hover:not(:disabled) {
+    background: #fecaca;
+  }
+
+  .cancel-btn:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+  }
+
+  .spinner {
+    display: inline-block;
+    width: 12px;
+    height: 12px;
+    border: 2px solid currentColor;
+    border-radius: 50%;
+    border-top-color: transparent;
+    animation: spin 0.6s linear infinite;
+  }
+
+  @keyframes spin {
+    to { transform: rotate(360deg); }
+  }
+
+  .empty-state {
+    text-align: center;
+    padding: 40px 20px;
+    color: #9ca3af;
+  }
+
+  .empty-state-icon {
+    font-size: 48px;
+    margin-bottom: 12px;
+  }
+
+  /* Visual Variants */
+
+  /* Minimal variant - clean, no shadows */
+  :host([variant="minimal"]) .container {
+    box-shadow: none;
+    border: 1px solid var(--ai-border-color, #e5e7eb);
+  }
+
+  :host([variant="minimal"]) .progress-bar {
+    background: transparent;
+    border: 1px solid var(--ai-border-color, #e5e7eb);
+  }
+
+  /* Gradient variant - colorful gradients */
+  :host([variant="gradient"]) .progress-fill {
+    background: linear-gradient(
+      90deg,
+      var(--ai-primary-color, #3b82f6),
+      var(--ai-secondary-color, #10b981),
+      var(--ai-primary-color, #3b82f6)
+    );
+    background-size: 200% 100%;
+    animation: gradient-shift 3s ease-in-out infinite;
+  }
+
+  @keyframes gradient-shift {
+    0%, 100% { background-position: 0% 50%; }
+    50% { background-position: 100% 50%; }
+  }
+
+  /* Override default animation when animation attribute is set */
+  :host([animation][variant="gradient"]) .progress-fill {
+    animation: none !important;
+  }
+
+  /* Glassmorphic variant - frosted glass effect */
+  :host([variant="glassmorphic"]) .container {
+    background: rgba(255, 255, 255, 0.1);
+    backdrop-filter: blur(10px);
+    -webkit-backdrop-filter: blur(10px);
+    border: 1px solid rgba(255, 255, 255, 0.2);
+    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.1);
+  }
+
+  :host([variant="glassmorphic"]) .progress-bar {
+    background: rgba(0, 0, 0, 0.1);
+  }
+
+  :host([variant="glassmorphic"]) .progress-fill {
+    background: linear-gradient(
+      90deg,
+      rgba(59, 130, 246, 0.8),
+      rgba(16, 185, 129, 0.8)
+    );
+  }
+
+  /* Animation Effects */
+
+  /* Striped animation */
+  :host([animation="striped"]) .progress-fill {
+  background-image: 
+    linear-gradient(
+      45deg,
+      rgba(255, 255, 255, 0.2) 25%,
+      transparent 25%,
+      transparent 50%,
+      rgba(255, 255, 255, 0.2) 50%,
+      rgba(255, 255, 255, 0.2) 75%,
+      transparent 75%,
+      transparent
+    ),
+    linear-gradient(to right, var(--ai-primary-color, #3b82f6), var(--ai-primary-color, #3b82f6)) !important;
+  background-size: 2rem 2rem, 100% 100% !important;
+  animation: progress-stripes 3s linear infinite !important;
+}
+
+@keyframes progress-stripes {
+  0% { background-position: 0 0, 0 0; }
+  100% { background-position: 2rem 0, 0 0; }
+}
+
+/* Pulse animation */
+:host([animation="pulse"]) .progress-fill {
+  animation: progress-pulse 4s ease-in-out infinite !important;
+}
+
+@keyframes progress-pulse {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.3; }
+}
+
+/* Glow animation */
+:host([animation="glow"]) .progress-fill {
+  animation: progress-glow 4s ease-in-out infinite !important;
+}
+
+@keyframes progress-glow {
+  0%, 100% { 
+    box-shadow: 0 0 5px var(--ai-primary-color, #3b82f6),
+                0 0 10px var(--ai-primary-color, #3b82f6);
+  }
+  50% { 
+    box-shadow: 0 0 20px var(--ai-primary-color, #3b82f6), 
+                0 0 35px var(--ai-primary-color, #3b82f6),
+                0 0 50px var(--ai-primary-color, #3b82f6);
+  }
+}
+
+  /* Size variants */
+  :host([size="compact"]) .container {
+    padding: 8px;
+    font-size: 12px;
+  }
+
+  :host([size="compact"]) .progress-bar {
+    height: 6px;
+  }
+
+  :host([size="compact"]) .status-message {
+    font-size: 12px;
+  }
+
+  :host([size="compact"]) .status-badge {
+    padding: 3px 8px;
+    font-size: 10px;
+  }
+
+  :host([size="compact"]) .stat-value {
+    font-size: 16px;
+  }
+
+  :host([size="compact"]) .stat-label {
+    font-size: 10px;
+  }
+
+  :host([size="large"]) .container {
+    padding: 16px;
+    font-size: 16px;
+  }
+
+  :host([size="large"]) .progress-bar {
+    height: 10px;
+  }
+
+  :host([size="large"]) .status-message {
+    font-size: 16px;
+  }
+
+  :host([size="large"]) .status-badge {
+    padding: 5px 12px;
+    font-size: 13px;
+  }
+
+  :host([size="large"]) .stat-value {
+    font-size: 20px;
+  }
+
+  :host([size="large"]) .stat-label {
+    font-size: 12px;
+  }
+
+  /* Accessibility */
+  @media (prefers-reduced-motion: reduce) {
+    .progress-fill,
+    .item-progress-fill,
+    .spinner {
+      animation: none;
+      transition: none;
+    }
+  }
+
+  /* Scrollbar styling */
+  .items-container::-webkit-scrollbar {
+    width: 8px;
+  }
+
+  .items-container::-webkit-scrollbar-track {
+    background: #f3f4f6;
+    border-radius: 4px;
+  }
+
+  .items-container::-webkit-scrollbar-thumb {
+    background: #d1d5db;
+    border-radius: 4px;
+  }
+
+  .items-container::-webkit-scrollbar-thumb:hover {
+    background: #9ca3af;
+  }
+`;

package/src/core/batch-progress/types.ts

@@ -0,0 +1,169 @@
+/**
+ * Status of a batch item
+ */
+export type BatchItemStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled';
+
+/**
+ * Individual batch item
+ */
+export interface BatchItem {
+  id: string;
+  label?: string;
+  status: BatchItemStatus;
+  progress?: number; // 0-100
+  error?: string;
+  result?: any;
+  startTime?: number;
+  endTime?: number;
+}
+
+/**
+ * Configuration options for BatchProgress
+ */
+export interface BatchProgressConfig {
+  /** Total number of items in batch */
+  totalItems?: number;
+
+  /** Maximum concurrent operations */
+  concurrency?: number;
+
+  /** Show individual item progress */
+  showItems?: boolean;
+
+  /** Maximum items to display */
+  maxDisplayItems?: number;
+
+  /** Show overall progress bar */
+  showProgressBar?: boolean;
+
+  /** Show statistics (success/fail counts) */
+  showStats?: boolean;
+
+  /** Show elapsed time */
+  showTime?: boolean;
+
+  /** Show processing rate (items/sec) */
+  showRate?: boolean;
+
+  /** Allow cancellation */
+  allowCancel?: boolean;
+
+  /** Cancel button label */
+  cancelLabel?: string;
+
+  /** Automatically collapse completed items */
+  collapseCompleted?: boolean;
+
+  /** Status message */
+  message?: string;
+
+  /** Enable automatic cursor state changes based on component state */
+  cursorFeedback?: boolean;
+
+  /** Component size variant */
+  size?: 'compact' | 'default' | 'large';
+
+  /** Visual style variant */
+  variant?: 'default' | 'minimal' | 'gradient' | 'glassmorphic';
+
+  /** Animation style */
+  animation?: 'none' | 'striped' | 'pulse' | 'glow';
+
+  /** Disabled state */
+  disabled?: boolean;
+
+  /** Enable debug logging */
+  debug?: boolean;
+
+  /** Additional CSS class */
+  className?: string;
+
+  /** ARIA label for accessibility */
+  ariaLabel?: string;
+}
+
+/**
+ * Internal state of the BatchProgress
+ */
+export interface BatchProgressState {
+  status: 'idle' | 'processing' | 'completed' | 'paused' | 'cancelled';
+  items: Map<string, BatchItem>;
+  totalItems: number;
+  completedCount: number;
+  failedCount: number;
+  successCount: number;
+  currentConcurrency: number;
+  startTime: number | null;
+  endTime: number | null;
+  message: string;
+}
+
+/**
+ * Update parameters for batch progress
+ */
+export interface BatchProgressUpdate {
+  itemId: string;
+  status?: BatchItemStatus;
+  progress?: number;
+  error?: string;
+  result?: any;
+  label?: string;
+}
+
+/**
+ * Event detail for batch start
+ */
+export interface BatchStartEvent {
+  totalItems: number;
+  startTime: number;
+}
+
+/**
+ * Event detail for batch item update
+ */
+export interface BatchItemUpdateEvent extends BatchItem {
+  totalCompleted: number;
+  totalFailed: number;
+  overallProgress: number;
+}
+
+/**
+ * Event detail for batch complete
+ */
+export interface BatchCompleteEvent {
+  totalItems: number;
+  successCount: number;
+  failedCount: number;
+  duration: number;
+  averageRate: number;
+  startTime: number;
+  endTime: number;
+}
+
+/**
+ * Event detail for batch cancel
+ */
+export interface BatchCancelEvent {
+  completedCount: number;
+  failedCount: number;
+  cancelledCount: number;
+  reason?: string;
+}
+
+/**
+ * Event detail for batch item complete
+ */
+export interface BatchItemCompleteEvent {
+  item: BatchItem;
+  totalCompleted: number;
+  remainingItems: number;
+}
+
+/**
+ * Event detail for batch item failed
+ */
+export interface BatchItemFailedEvent {
+  item: BatchItem;
+  error: string;
+  totalFailed: number;
+}