@zomako/elearning-components 2.0.0 → 2.0.4

package/SortingActivity/index.tsx

@@ -0,0 +1,228 @@
+import React, { useState, useMemo, useCallback, useRef } from 'react';
+import {
+  DndContext,
+  closestCenter,
+  KeyboardSensor,
+  PointerSensor,
+  useSensor,
+  useSensors,
+  DragEndEvent,
+} from '@dnd-kit/core';
+import {
+  arrayMove,
+  SortableContext,
+  sortableKeyboardCoordinates,
+  useSortable,
+  verticalListSortingStrategy,
+} from '@dnd-kit/sortable';
+import { CSS } from '@dnd-kit/utilities';
+import styles from './style.module.css';
+
+export interface SortableItem {
+  id: string;
+  content: string;
+}
+
+export interface SortingActivityProps {
+  items: SortableItem[];
+  correctOrder: string[];
+  onComplete: (result: { isCorrect: boolean }) => void;
+}
+
+function shuffleArray<T>(array: T[]): T[] {
+  const shuffled = [...array];
+  for (let i = shuffled.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
+  }
+  return shuffled;
+}
+
+interface SortableItemRowProps {
+  item: SortableItem;
+  feedback: 'none' | 'correct' | 'incorrect';
+}
+
+function SortableItemRow({ item, feedback }: SortableItemRowProps) {
+  const {
+    attributes,
+    listeners,
+    setNodeRef,
+    transform,
+    transition,
+    isDragging,
+  } = useSortable({ id: item.id });
+
+  const style = {
+    transform: CSS.Transform.toString(transform),
+    transition,
+  };
+
+  const feedbackClass =
+    feedback === 'correct'
+      ? styles.itemCorrect
+      : feedback === 'incorrect'
+        ? styles.itemIncorrect
+        : '';
+
+  return (
+    <li
+      ref={setNodeRef}
+      style={style}
+      className={`${styles.item} ${feedbackClass} ${isDragging ? styles.itemDragging : ''}`}
+      {...attributes}
+      {...listeners}
+    >
+      <span className={styles.itemContent}>{item.content}</span>
+    </li>
+  );
+}
+
+const SortingActivity: React.FC<SortingActivityProps> = ({
+  items,
+  correctOrder,
+  onComplete,
+}) => {
+  const initialOrder = useRef<string[] | null>(null);
+  const [orderedIds, setOrderedIds] = useState<string[]>(() => {
+    const shuffled = shuffleArray(items).map((i) => i.id);
+    initialOrder.current = shuffled;
+    return shuffled;
+  });
+
+  const [feedbackState, setFeedbackState] = useState<'none' | 'correct' | 'incorrect'>('none');
+  const [feedbackMap, setFeedbackMap] = useState<Record<string, 'correct' | 'incorrect'>>({});
+
+  const sensors = useSensors(
+    useSensor(PointerSensor, {
+      activationConstraint: {
+        distance: 8,
+      },
+    }),
+    useSensor(KeyboardSensor, {
+      coordinateGetter: sortableKeyboardCoordinates,
+    })
+  );
+
+  const orderedItems = useMemo(() => {
+    const itemMap = Object.fromEntries(items.map((i) => [i.id, i]));
+    return orderedIds.map((id) => itemMap[id]).filter(Boolean);
+  }, [items, orderedIds]);
+
+  const handleDragEnd = useCallback((event: DragEndEvent) => {
+    const { active, over } = event;
+    if (over && active.id !== over.id) {
+      setOrderedIds((prev) => {
+        const oldIndex = prev.indexOf(active.id as string);
+        const newIndex = prev.indexOf(over.id as string);
+        return arrayMove(prev, oldIndex, newIndex);
+      });
+      setFeedbackState('none');
+      setFeedbackMap({});
+    }
+  }, []);
+
+  const handleCheckAnswer = useCallback(() => {
+    const isCorrect =
+      orderedIds.length === correctOrder.length &&
+      orderedIds.every((id, i) => id === correctOrder[i]);
+
+    if (isCorrect) {
+      setFeedbackState('correct');
+      setFeedbackMap(
+        Object.fromEntries(orderedIds.map((id) => [id, 'correct' as const]))
+      );
+    } else {
+      setFeedbackState('incorrect');
+      const map: Record<string, 'correct' | 'incorrect'> = {};
+      orderedIds.forEach((id, i) => {
+        map[id] = id === correctOrder[i] ? 'correct' : 'incorrect';
+      });
+      setFeedbackMap(map);
+    }
+
+    onComplete({ isCorrect });
+  }, [orderedIds, correctOrder, onComplete]);
+
+  const handleReset = useCallback(() => {
+    if (initialOrder.current) {
+      setOrderedIds([...initialOrder.current]);
+      setFeedbackState('none');
+      setFeedbackMap({});
+    }
+  }, []);
+
+  if (!items || items.length === 0) {
+    return (
+      <div className={styles.wrapper}>
+        <p className={styles.empty}>No items to sort.</p>
+      </div>
+    );
+  }
+
+  return (
+    <div className={styles.wrapper}>
+      <p className={styles.instruction}>
+        Drag and drop the items to put them in the correct order.
+      </p>
+
+      <DndContext
+        sensors={sensors}
+        collisionDetection={closestCenter}
+        onDragEnd={handleDragEnd}
+      >
+        <SortableContext
+          items={orderedIds}
+          strategy={verticalListSortingStrategy}
+        >
+          <ul className={styles.list} role="list">
+            {orderedItems.map((item) => (
+              <SortableItemRow
+                key={item.id}
+                item={item}
+                feedback={feedbackMap[item.id] ?? 'none'}
+              />
+            ))}
+          </ul>
+        </SortableContext>
+      </DndContext>
+
+      <div className={styles.actions}>
+        <button
+          type="button"
+          className={styles.buttonPrimary}
+          onClick={handleCheckAnswer}
+          aria-label="Check answer"
+        >
+          Check Answer
+        </button>
+        <button
+          type="button"
+          className={styles.buttonSecondary}
+          onClick={handleReset}
+          aria-label="Reset to initial order"
+        >
+          Reset
+        </button>
+      </div>
+
+      {feedbackState !== 'none' && (
+        <div
+          className={
+            feedbackState === 'correct'
+              ? styles.feedbackCorrect
+              : styles.feedbackIncorrect
+          }
+          role="status"
+          aria-live="polite"
+        >
+          {feedbackState === 'correct'
+            ? 'Correct! Well done.'
+            : "Not quite right. Check the highlighted items and try again."}
+        </div>
+      )}
+    </div>
+  );
+};
+
+export default SortingActivity;

package/SortingActivity/style.module.css

@@ -0,0 +1,200 @@
+/* ---- Wrapper ---- */
+.wrapper {
+  --sort-accent: #2563eb;
+  --sort-accent-hover: #1d4ed8;
+  --sort-bg: #f8fafc;
+  --sort-border: #e2e8f0;
+  --sort-text: #1e293b;
+  --sort-muted: #64748b;
+  --sort-success: #16a34a;
+  --sort-success-bg: #dcfce7;
+  --sort-error: #dc2626;
+  --sort-error-bg: #fee2e2;
+  --sort-radius: 12px;
+  --sort-shadow: 0 4px 20px rgba(0, 0, 0, 0.08);
+  font-family: 'Segoe UI', system-ui, -apple-system, sans-serif;
+  color: var(--sort-text);
+  max-width: 100%;
+  display: flex;
+  flex-direction: column;
+  gap: 1.25rem;
+}
+
+/* ---- Instruction ---- */
+.instruction {
+  margin: 0;
+  font-size: 0.9375rem;
+  color: var(--sort-muted);
+  line-height: 1.5;
+}
+
+/* ---- List ---- */
+.list {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+/* ---- Sortable items ---- */
+.item {
+  display: flex;
+  align-items: center;
+  padding: 1rem 1.25rem;
+  background: #fff;
+  border: 2px solid var(--sort-border);
+  border-radius: var(--sort-radius);
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.05);
+  cursor: grab;
+  transition:
+    transform 0.25s ease,
+    border-color 0.25s ease,
+    background-color 0.25s ease,
+    box-shadow 0.25s ease;
+  touch-action: none;
+}
+
+.item:hover {
+  border-color: var(--sort-accent);
+  box-shadow: 0 2px 8px rgba(37, 99, 235, 0.12);
+}
+
+.item:active {
+  cursor: grabbing;
+}
+
+.itemDragging {
+  opacity: 0.9;
+  transform: scale(1.02);
+  box-shadow: var(--sort-shadow);
+  border-color: var(--sort-accent);
+  z-index: 1;
+}
+
+.itemCorrect {
+  border-color: var(--sort-success);
+  background-color: var(--sort-success-bg);
+  animation: itemFeedbackIn 0.35s ease-out forwards;
+}
+
+.itemIncorrect {
+  border-color: var(--sort-error);
+  background-color: var(--sort-error-bg);
+  animation: itemFeedbackIn 0.35s ease-out forwards;
+}
+
+@keyframes itemFeedbackIn {
+  from {
+    transform: scale(0.98);
+    opacity: 0.85;
+  }
+  to {
+    transform: scale(1);
+    opacity: 1;
+  }
+}
+
+.itemContent {
+  font-size: 1rem;
+  font-weight: 500;
+  line-height: 1.4;
+  flex: 1;
+}
+
+/* ---- Action buttons ---- */
+.actions {
+  display: flex;
+  gap: 0.75rem;
+  flex-wrap: wrap;
+}
+
+.buttonPrimary {
+  padding: 0.625rem 1.25rem;
+  font-size: 0.9375rem;
+  font-weight: 600;
+  color: #fff;
+  background: var(--sort-accent);
+  border: none;
+  border-radius: var(--sort-radius);
+  cursor: pointer;
+  transition:
+    background-color 0.2s ease,
+    transform 0.2s ease;
+}
+
+.buttonPrimary:hover {
+  background: var(--sort-accent-hover);
+}
+
+.buttonPrimary:active {
+  transform: scale(0.98);
+}
+
+.buttonSecondary {
+  padding: 0.625rem 1.25rem;
+  font-size: 0.9375rem;
+  font-weight: 600;
+  color: var(--sort-text);
+  background: #fff;
+  border: 2px solid var(--sort-border);
+  border-radius: var(--sort-radius);
+  cursor: pointer;
+  transition:
+    border-color 0.2s ease,
+    background-color 0.2s ease,
+    transform 0.2s ease;
+}
+
+.buttonSecondary:hover {
+  border-color: var(--sort-accent);
+  background: var(--sort-bg);
+}
+
+.buttonSecondary:active {
+  transform: scale(0.98);
+}
+
+/* ---- Feedback message ---- */
+.feedbackCorrect {
+  padding: 0.875rem 1.25rem;
+  background: var(--sort-success-bg);
+  border: 1px solid var(--sort-success);
+  border-radius: var(--sort-radius);
+  color: var(--sort-success);
+  font-weight: 600;
+  font-size: 0.9375rem;
+  animation: feedbackSlideIn 0.3s ease-out forwards;
+}
+
+.feedbackIncorrect {
+  padding: 0.875rem 1.25rem;
+  background: var(--sort-error-bg);
+  border: 1px solid var(--sort-error);
+  border-radius: var(--sort-radius);
+  color: var(--sort-error);
+  font-weight: 600;
+  font-size: 0.9375rem;
+  animation: feedbackSlideIn 0.3s ease-out forwards;
+}
+
+@keyframes feedbackSlideIn {
+  from {
+    opacity: 0;
+    transform: translateY(-8px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+/* ---- Empty state ---- */
+.empty {
+  margin: 0;
+  padding: 2rem;
+  text-align: center;
+  color: var(--sort-muted);
+  font-size: 1rem;
+}

package/dist/elearning-components.css

@@ -1 +1 @@
-.flashcard-deck-container{display:flex;flex-direction:column;align-items:center;gap:2rem;padding:2rem;max-width:600px;margin:0 auto}.flashcard-deck-header{width:100%;text-align:center}.flashcard-counter{font-size:1rem;color:#666;font-weight:500}.flashcard-wrapper{perspective:1000px;width:100%;min-height:300px}.flashcard{position:relative;width:100%;height:300px;cursor:pointer;transform-style:preserve-3d}.flashcard-face{position:absolute;width:100%;height:100%;backface-visibility:hidden;border-radius:12px;box-shadow:0 4px 6px #0000001a,0 2px 4px #0000000f;display:flex;align-items:center;justify-content:center;padding:2rem;box-sizing:border-box}.flashcard-front{background:linear-gradient(135deg,#667eea,#764ba2);color:#fff;transform:rotateY(0)}.flashcard-back{background:linear-gradient(135deg,#f093fb,#f5576c);color:#fff;transform:rotateY(180deg)}.flashcard-content{font-size:1.25rem;text-align:center;word-wrap:break-word;overflow-wrap:break-word;line-height:1.6;font-weight:500}.flashcard-controls{display:flex;gap:1rem;width:100%;justify-content:center}.flashcard-button{padding:.75rem 2rem;font-size:1rem;font-weight:600;border:none;border-radius:8px;cursor:pointer;transition:all .3s ease;background-color:#667eea;color:#fff;min-width:120px}.flashcard-button:hover:not(:disabled){background-color:#5568d3;transform:translateY(-2px);box-shadow:0 4px 8px #667eea4d}.flashcard-button:active:not(:disabled){transform:translateY(0)}.flashcard-button:disabled{background-color:#e0e0e0;color:#9e9e9e;cursor:not-allowed;opacity:.6}.flashcard-empty-message{text-align:center;color:#666;font-size:1.1rem;padding:2rem}@media(max-width:768px){.flashcard-deck-container{padding:1rem}.flashcard{height:250px}.flashcard-content{font-size:1.1rem}.flashcard-button{padding:.625rem 1.5rem;font-size:.9rem;min-width:100px}}._accordion_1gkiv_1{width:100%;max-width:640px;margin:0 auto;font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;color:#1a1a1a}._empty_1gkiv_17{padding:1rem 0;margin:0;color:#64748b;font-size:.9375rem}._item_1gkiv_31{border:1px solid #e2e8f0;border-bottom:none}._item_1gkiv_31:last-of-type{border-bottom:1px solid #e2e8f0}._item_1gkiv_31:first-of-type{border-radius:8px 8px 0 0}._item_1gkiv_31:last-of-type{border-radius:0 0 8px 8px}._item_1gkiv_31:only-of-type{border-radius:8px}._heading_1gkiv_73{margin:0;font-size:1rem;font-weight:600}._trigger_1gkiv_85{display:flex;align-items:center;justify-content:space-between;width:100%;padding:1rem 1.25rem;background:#f8fafc;border:none;cursor:pointer;text-align:left;font-size:inherit;font-weight:inherit;color:inherit;transition:background-color .2s ease}._trigger_1gkiv_85:hover{background:#f1f5f9}._trigger_1gkiv_85:focus-visible{outline:2px solid #3b82f6;outline-offset:2px}._item_1gkiv_31[data-open=true] ._trigger_1gkiv_85{background:#fff;border-bottom:1px solid #e2e8f0}._title_1gkiv_145{flex:1;padding-right:.75rem}._icon_1gkiv_155{flex-shrink:0;font-size:.65rem;color:#64748b;transition:color .2s ease}._trigger_1gkiv_85:hover ._icon_1gkiv_155,._item_1gkiv_31[data-open=true] ._icon_1gkiv_155{color:#3b82f6}._panelWrapper_1gkiv_179,._panel_1gkiv_179{overflow:hidden}._content_1gkiv_195{padding:1rem 1.25rem 1.25rem;background:#fff;font-size:.9375rem;line-height:1.6;color:#334155}._content_1gkiv_195 :first-child{margin-top:0}._content_1gkiv_195 :last-child{margin-bottom:0}
+.flashcard-deck-container{display:flex;flex-direction:column;align-items:center;gap:2rem;padding:2rem;max-width:600px;margin:0 auto}.flashcard-deck-header{width:100%;text-align:center}.flashcard-counter{font-size:1rem;color:#666;font-weight:500}.flashcard-wrapper{perspective:1000px;width:100%;min-height:300px}.flashcard{position:relative;width:100%;height:300px;cursor:pointer;transform-style:preserve-3d;transition:transform .6s cubic-bezier(.34,1.56,.64,1)}.flashcard--flipped{transform:rotateY(180deg)}.flashcard-face{position:absolute;width:100%;height:100%;backface-visibility:hidden;border-radius:12px;box-shadow:0 4px 6px #0000001a,0 2px 4px #0000000f;display:flex;align-items:center;justify-content:center;padding:2rem;box-sizing:border-box}.flashcard-front{background:linear-gradient(135deg,#667eea,#764ba2);color:#fff;transform:rotateY(0)}.flashcard-back{background:linear-gradient(135deg,#f093fb,#f5576c);color:#fff;transform:rotateY(180deg)}.flashcard-content{font-size:1.25rem;text-align:center;word-wrap:break-word;overflow-wrap:break-word;line-height:1.6;font-weight:500}.flashcard-controls{display:flex;gap:1rem;width:100%;justify-content:center}.flashcard-button{padding:.75rem 2rem;font-size:1rem;font-weight:600;border:none;border-radius:8px;cursor:pointer;transition:all .3s ease;background-color:#667eea;color:#fff;min-width:120px}.flashcard-button:hover:not(:disabled){background-color:#5568d3;transform:translateY(-2px);box-shadow:0 4px 8px #667eea4d}.flashcard-button:active:not(:disabled){transform:translateY(0)}.flashcard-button:disabled{background-color:#e0e0e0;color:#9e9e9e;cursor:not-allowed;opacity:.6}.flashcard-empty-message{text-align:center;color:#666;font-size:1.1rem;padding:2rem}@media(max-width:768px){.flashcard-deck-container{padding:1rem}.flashcard{height:250px}.flashcard-content{font-size:1.1rem}.flashcard-button{padding:.625rem 1.5rem;font-size:.9rem;min-width:100px}}._accordion_1rfb4_1{width:100%;max-width:640px;margin:0 auto;font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;color:#1a1a1a}._empty_1rfb4_17{padding:1rem 0;margin:0;color:#64748b;font-size:.9375rem}._item_1rfb4_31{border:1px solid #e2e8f0;border-bottom:none}._item_1rfb4_31:last-of-type{border-bottom:1px solid #e2e8f0}._item_1rfb4_31:first-of-type{border-radius:8px 8px 0 0}._item_1rfb4_31:last-of-type{border-radius:0 0 8px 8px}._item_1rfb4_31:only-of-type{border-radius:8px}._heading_1rfb4_73{margin:0;font-size:1rem;font-weight:600}._trigger_1rfb4_85{display:flex;align-items:center;justify-content:space-between;width:100%;padding:1rem 1.25rem;background:#f8fafc;border:none;cursor:pointer;text-align:left;font-size:inherit;font-weight:inherit;color:inherit;transition:background-color .2s ease}._trigger_1rfb4_85:hover{background:#f1f5f9}._trigger_1rfb4_85:focus-visible{outline:2px solid #3b82f6;outline-offset:2px}._item_1rfb4_31[data-open=true] ._trigger_1rfb4_85{background:#fff;border-bottom:1px solid #e2e8f0}._title_1rfb4_145{flex:1;padding-right:.75rem}._icon_1rfb4_155{flex-shrink:0;font-size:.65rem;color:#64748b;transition:color .2s ease,transform .25s ease}._trigger_1rfb4_85:hover ._icon_1rfb4_155,._item_1rfb4_31[data-open=true] ._icon_1rfb4_155{color:#3b82f6}._item_1rfb4_31[data-open=true] ._icon_1rfb4_155{transform:rotate(180deg)}._panelWrapper_1rfb4_187{display:grid;grid-template-rows:0fr;transition:grid-template-rows .25s ease-in-out}._panelWrapper_1rfb4_187[data-open=true]{grid-template-rows:1fr}._panel_1rfb4_187{min-height:0;overflow:hidden}._content_1rfb4_217{padding:1rem 1.25rem 1.25rem;background:#fff;font-size:.9375rem;line-height:1.6;color:#334155}._content_1rfb4_217 :first-child{margin-top:0}._content_1rfb4_217 :last-child{margin-bottom:0}