@mathscan/math-exercise-engine 1.2.1 → 1.2.3

package/dist/style.css

@@ -2630,6 +2630,806 @@ th.exercise-table-cell.exercise-table-cell--last-row:last-child {
   transform: none;
 }
 
+/**
+ * Chart widget styles
+ *
+ * All colours and sizes are driven by CSS custom properties defined inside
+ * `.math-exercise-renderer` (variables.css).  Consumer apps can override any
+ * of these variables on a parent selector to theme the chart without touching
+ * engine code.
+ *
+ * Override surface example (student app):
+ *
+ *   .my-exercise-wrapper {
+ *     --chart-bar-color:         #4f46e5;
+ *     --chart-bar-correct-color: #22c55e;
+ *     --chart-bar-wrong-color:   #ef4444;
+ *     --chart-height:            320px;
+ *   }
+ *
+ * `--chart-height` is the exception: bar charts write it inline, and pictographs
+ * derive theirs from `--picto-cell-size` / `--picto-cell-gap`, so resize a
+ * pictograph through those two tokens rather than through `--chart-height`.
+ */
+
+/* ── Token definitions (inside renderer scope) ─────────────────────────────── */
+
+.math-exercise-renderer {
+  /* Bar colours */
+  --chart-bar-color:          var(--exercise-accent, #705DC0);
+  --chart-bar-correct-color:  var(--exercise-correct, #22c55e);
+  --chart-bar-wrong-color:    var(--exercise-incorrect, #ef4444);
+
+  /* Axis / grid */
+  --chart-grid-color:         #e5e5e5;
+  --chart-axis-color:         var(--exercise-accent, #705DC0);
+  --chart-axis-width:         2.35rem;  /* width of the Y-axis label column */
+
+  /* Sizing */
+  --chart-height:             clamp(13rem, 34vw, 18rem);
+  --chart-bar-slot-width:     clamp(4.25rem, 11vw, 6rem);
+  --chart-bar-width:          clamp(2.7rem, 7vw, 4.1rem);
+  --chart-bar-gap:            clamp(0.65rem, 2.5vw, 1.5rem);
+  --chart-content-width:      24rem;
+
+  /* Pictograph cells (fixed size — the plot height is derived from these) */
+  --picto-cell-size:          2.6rem;
+  --picto-cell-gap:           2px;
+
+  --chart-border-radius:      8px 8px 0 0;
+
+  /* Typography */
+  --chart-font-size:          clamp(0.78rem, 1.7vw, 1rem);
+  --chart-label-font-size:    clamp(0.85rem, 1.8vw, 1.08rem);
+  --chart-font-weight:        500;
+  --chart-label-min-height:   2.4em;
+
+  /* Handle */
+  --chart-handle-size:        clamp(0.9rem, 2vw, 1.15rem);
+}
+
+/* ── Chart container (wraps title + chart grid) ────────────────────────────── */
+
+.chart-container {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  width: 100%;
+  max-width: 560px;
+  margin-block: 1rem;
+}
+
+.chart-title {
+  grid-column: 3;
+  grid-row: 1;
+  align-self: end;
+  font-size: var(--chart-label-font-size);
+  font-weight: 600;
+  color: var(--exercise-accent, #6c5fc7);
+  text-align: center;
+  padding-block: 0.5rem 0.4rem;
+  overflow-wrap: break-word;
+  white-space: normal;
+}
+
+.chart-title,
+.chart-plot,
+.chart-axis-x-numeric,
+.chart-axis-title--x-category,
+.chart-axis-x {
+  width: var(--chart-content-width);
+  min-width: var(--chart-content-width);
+}
+
+/* ── Root container ─────────────────────────────────────────────────────────── */
+
+.chart-scroll {
+  width: 100%;
+}
+
+.chart {
+  display: grid;
+  /* columns: [y-title] [y-axis] [plot] */
+  grid-template-columns: auto var(--chart-axis-width) 1fr;
+  grid-template-rows: auto 1fr auto auto;   /* title/padding | plot | x labels | x title */
+  align-items: end;
+  width: max-content;
+  min-width: 0;
+  margin-inline: auto;
+  padding-block-start: calc(var(--chart-font-size) * 0.75);
+}
+
+/* Hidden axes: remove the matching plot-border axis line. */
+
+.chart.chart--no-xaxis .chart-plot {
+  border-bottom: none;
+}
+
+.chart.chart--no-yaxis .chart-plot {
+  border-left: none;
+  border-inline-start: none;
+}
+
+/* Vertical chart with no Y axis — collapse the Y-axis columns as well. */
+
+.chart--no-yaxis:not(.chart--horizontal) {
+  grid-template-columns: 1fr;
+}
+
+/* ── Y axis ─────────────────────────────────────────────────────────────────── */
+
+.chart-axis-tick-y,
+.chart-axis-tick-x-num {
+  position: absolute;
+  font-size: var(--chart-font-size);
+  font-weight: var(--chart-font-weight);
+  color: var(--chart-axis-color);
+  line-height: 1;
+  white-space: nowrap;
+  pointer-events: none;
+  user-select: none;
+}
+
+.chart-axis-y {
+  grid-column: 2;
+  grid-row: 2;
+  position: relative;
+  height: var(--chart-height);
+  width: var(--chart-axis-width);
+}
+
+.chart-axis-tick-y {
+  right: 0.45rem;
+  transform: translateY(50%);
+}
+
+/* ── Plot area ──────────────────────────────────────────────────────────────── */
+
+.chart-plot {
+  grid-column: 3;
+  grid-row: 2;
+  position: relative;
+  height: var(--chart-height);
+  border-left: 2px solid var(--chart-axis-color);
+  border-bottom: 2px solid var(--chart-axis-color);
+  overflow: hidden;
+}
+
+/* ── Grid lines ─────────────────────────────────────────────────────────────── */
+
+.chart-gridline {
+  position: absolute;
+  inset-inline: 0;
+  height: 1px;
+  background: var(--chart-grid-color);
+  pointer-events: none;
+}
+
+/* ── Bars container inside plot ─────────────────────────────────────────────── */
+
+.chart-bars {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: flex-end;
+  justify-content: center;
+  padding-inline: var(--chart-bar-gap);
+  gap: var(--chart-bar-gap);
+}
+
+/* ── Single bar wrapper ─────────────────────────────────────────────────────── */
+
+.chart-bar-wrapper {
+  flex: 0 0 var(--chart-bar-slot-width);
+  width: var(--chart-bar-slot-width);
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  height: 100%;
+}
+
+/* The full-height drag track (transparent, captures pointer events) */
+
+.chart-bar-track {
+  width: var(--chart-bar-width);
+  height: 100%;
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  justify-content: flex-end;
+}
+
+.chart-bar-track--interactive {
+  touch-action: none; /* prevent scroll while dragging */
+}
+
+/* ── The filled bar ─────────────────────────────────────────────────────────── */
+
+.chart-bar {
+  width: 100%;
+  /* Height driven by --bar-fill (0–1) × plot height; peek animation adds a
+     temporary --peek-fill-offset to hint the bar is draggable */
+  height: calc(min(1, var(--bar-fill, 0) + var(--peek-fill-offset, 0)) * 100%);
+  background-color: var(--chart-bar-instance-color, var(--chart-bar-color));
+  border-radius: var(--chart-border-radius);
+  position: relative;
+  transition: height 120ms ease, background-color 180ms ease, filter 180ms ease;
+}
+
+.chart-bar--horizontal {
+  border-radius: 0 8px 8px 0;
+}
+
+/* Colour overrides based on validation */
+
+.chart-bar-correct {
+  background-color: var(--chart-bar-correct-color) !important;
+}
+
+.chart-bar-incorrect {
+  background-color: var(--chart-bar-wrong-color) !important;
+}
+
+/* Hover tint on interactive bars */
+
+.chart-bar-interactive {
+  cursor: ns-resize;
+  outline: none;
+  touch-action: none;
+}
+
+.chart--horizontal .chart-bar-interactive {
+  cursor: ew-resize;
+}
+
+.chart-bar-interactive.chart-bar-at-min {
+  background-color: transparent;
+  opacity: 0.7;
+}
+
+.chart-bar-interactive.chart-bar-at-min.chart-bar-correct,
+.chart-bar-interactive.chart-bar-at-min.chart-bar-incorrect {
+  background-color: transparent !important;
+}
+
+.chart:not(.chart--horizontal) .chart-bar-interactive.chart-bar-at-min {
+  min-height: var(--chart-handle-size);
+  border-bottom: 3px dashed var(--chart-bar-instance-color, var(--chart-bar-color));
+}
+
+.chart-bar-interactive:not(.chart-bar-correct):not(.chart-bar-incorrect):hover,
+.chart-bar-interactive:not(.chart-bar-correct):not(.chart-bar-incorrect):focus-visible,
+.chart-bar-interactive:not(.chart-bar-correct):not(.chart-bar-incorrect):active {
+  background-color: color-mix(
+    in srgb,
+    var(--chart-bar-instance-color, var(--chart-bar-color)) 78%,
+    white
+  ) !important;
+}
+
+.chart-bar-interactive:focus-visible {
+  box-shadow: 0 0 0 3px color-mix(in srgb, var(--chart-axis-color) 24%, transparent);
+}
+
+.chart-bar-interactive.chart-bar-at-min:not(.chart-bar-correct):not(.chart-bar-incorrect):is(:hover, :focus-visible, :active) {
+  background-color: transparent !important;
+  opacity: 1;
+}
+
+.chart:not(.chart--horizontal) .chart-bar-interactive.chart-bar-at-min.chart-bar-correct {
+  border-bottom-color: var(--chart-bar-correct-color);
+}
+
+.chart:not(.chart--horizontal) .chart-bar-interactive.chart-bar-at-min.chart-bar-correct .chart-bar-handle {
+  color: var(--chart-bar-correct-color);
+  opacity: 1;
+}
+
+.chart:not(.chart--horizontal) .chart-bar-interactive.chart-bar-at-min.chart-bar-incorrect {
+  border-bottom-color: var(--chart-bar-wrong-color);
+}
+
+.chart:not(.chart--horizontal) .chart-bar-interactive.chart-bar-at-min.chart-bar-incorrect .chart-bar-handle {
+  color: var(--chart-bar-wrong-color);
+  opacity: 1;
+}
+
+/* ── Drag handle ────────────────────────────────────────────────────────────── */
+
+.chart-bar-handle {
+  position: absolute;
+  top: 0.15rem;
+  left: 50%;
+  transform: translateX(-50%);
+  width: var(--chart-handle-size);
+  height: var(--chart-handle-size);
+  color: white;
+  pointer-events: none;
+  z-index: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.chart-bar-handle svg {
+  width: 100%;
+  height: 100%;
+}
+
+.chart:not(.chart--horizontal) .chart-bar-interactive.chart-bar-at-min .chart-bar-handle {
+  top: 50%;
+  transform: translateX(-50%) translateY(-50%);
+  color: var(--chart-bar-instance-color, var(--chart-bar-color));
+  opacity: 0.75;
+}
+
+/* ── X axis numeric ticks (when categoryAxis is present) ───────────────────── */
+
+.chart-axis-x-numeric {
+  grid-column: 3;
+  grid-row: 3;
+  padding-top: 0.35rem;
+}
+
+.chart-axis-x-numeric-ticks {
+  position: relative;
+  height: 1.4rem;
+  overflow: visible;
+}
+
+.chart-axis-tick-x-num {
+  top: 0;
+  transform: translateX(-50%);
+}
+
+/* ── Axis titles (inline content from axis body { ... }) ────────────────────── */
+
+.chart-axis-title {
+  font-size: calc(var(--chart-font-size) * 0.9);
+  color: var(--chart-axis-color);
+  text-align: center;
+  line-height: 1.2;
+}
+
+.chart-axis-title--y,
+.chart-axis-title--y-h {
+  align-self: center;
+  justify-self: center;
+  font-size: calc(var(--chart-font-size) * 0.85);
+  writing-mode: vertical-rl;
+  transform: rotate(180deg);
+  white-space: nowrap;
+  padding-inline: 0.2rem;
+}
+
+.chart-axis-title--x,
+.chart-axis-title--x-category {
+  font-size: calc(var(--chart-font-size) * 0.85);
+  font-weight: var(--chart-font-weight);
+  white-space: nowrap;
+}
+
+.chart-axis-title--y {
+  grid-column: 1;
+  grid-row: 2 / 3;
+}
+
+.chart-axis-title--x {
+  display: block;
+  margin-top: 0.35rem;
+}
+
+/* X-axis title when bar labels are present (placed in grid row 4) */
+
+.chart-axis-title--x-category {
+  grid-column: 3;
+  grid-row: 4;
+  padding-block-start: 0.3rem;
+}
+
+/* ── X axis (category or value labels row) ──────────────────────────────────── */
+
+.chart-axis-x {
+  grid-column: 3;
+  grid-row: 3;
+  display: flex;
+  justify-content: center;
+  padding-inline: var(--chart-bar-gap);
+  gap: var(--chart-bar-gap);
+  padding-top: 0.55rem;
+  align-items: flex-start;
+}
+
+.chart-axis-tick-x {
+  flex: 0 0 var(--chart-bar-slot-width);
+  min-width: 0;
+  min-height: var(--chart-label-min-height);
+  font-size: var(--chart-label-font-size);
+  font-weight: var(--chart-font-weight);
+  color: var(--chart-axis-color);
+  line-height: 1.15;
+  display: flex;
+  justify-content: center;
+  align-items: flex-start;
+}
+
+.chart-axis-tick-x-inner {
+  display: -webkit-box;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 3;
+  line-clamp: 3;
+  overflow: hidden;
+  width: 100%;
+  text-align: center;
+}
+
+.chart-axis-tick-x .text-item {
+  display: inline-block;
+  max-width: 100%;
+  overflow-wrap: anywhere;
+}
+
+.chart-axis-tick-x .inline-input-droppable {
+  max-width: 100%;
+}
+
+.chart-axis-tick-x .inline-input,
+.chart-axis-tick-x .inline-input-chip {
+  max-width: 100%;
+  box-sizing: border-box;
+  padding: 0.2rem 0.35rem;
+  font-size: 0.82rem;
+  line-height: 1.1;
+}
+
+/* ═══════════════════════════════════════════════════════════════════════════
+   HORIZONTAL BAR CHART  (.chart--horizontal)
+   Grid: [y-labels col] [plot col]
+         [empty        ] [x-axis row]
+   ═══════════════════════════════════════════════════════════════════════════ */
+
+.chart--horizontal {
+  grid-template-columns: auto auto 1fr;
+  grid-template-rows: auto 1fr auto;
+  align-items: start;  /* override vertical align-items: end */
+}
+
+/* In horizontal mode, chart-title goes above the plot column */
+
+.chart--horizontal .chart-title {
+  grid-column: 3;
+  grid-row: 1;
+  align-self: end;
+  width: max(100%, var(--chart-h-value-width, 16rem));
+}
+
+/* ── Horizontal: Y-side category labels ─────────────────────────────────── */
+
+.chart--horizontal .chart-axis-y--categories {
+  grid-column: 2;
+  grid-row: 2;
+  display: flex;
+  flex-direction: column;
+  justify-content: flex-start;
+  height: var(--chart-height);
+  padding-block: var(--chart-bar-gap);
+  gap: var(--chart-bar-gap);
+  min-width: max-content;
+}
+
+.chart--horizontal .chart-bar-y-label {
+  flex: 0 0 var(--chart-bar-slot-width);
+  height: var(--chart-bar-slot-width);
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  padding-inline-end: 0.6rem;
+  padding-inline-start: 0.35rem;
+  font-size: var(--chart-label-font-size);
+  font-weight: var(--chart-font-weight);
+  color: var(--exercise-text-primary, #1f2937);
+  white-space: nowrap;
+}
+
+/* ── Horizontal: plot area ───────────────────────────────────────────────── */
+
+.chart--horizontal .chart-plot {
+  grid-column: 3;
+  grid-row: 2;
+  width: max(100%, var(--chart-h-value-width, 16rem));
+  border-inline-start: 2px solid var(--chart-axis-color);
+  border-bottom: 2px solid var(--chart-axis-color);
+}
+
+/* ── Horizontal: bars container ─────────────────────────────────────────── */
+
+.chart--horizontal .chart-bars {
+  flex-direction: column;
+  align-items: flex-start;
+  justify-content: flex-start;
+  padding-inline: 0;
+  padding-block: var(--chart-bar-gap);
+}
+
+.chart--horizontal .chart-bar-wrapper {
+  flex: 0 0 var(--chart-bar-slot-width);
+  height: var(--chart-bar-slot-width);
+  width: 100%;
+  flex-direction: row;
+  align-items: center;
+}
+
+.chart--horizontal .chart-bar-track {
+  width: 100%;
+  height: var(--chart-bar-width);
+  flex-direction: row;
+  justify-content: flex-start;
+}
+
+/* Bar grows along X (width instead of height) */
+
+.chart--horizontal .chart-bar {
+  width: calc(min(1, var(--bar-fill, 0) + var(--peek-fill-offset, 0)) * 100%);
+  height: 100%;
+  transition: width 120ms ease, background-color 180ms ease, filter 180ms ease;
+}
+
+/* Interactive handle for horizontal: same SVG rotated 90° → ">>" */
+
+.chart--horizontal .chart-bar-handle {
+  top: 50%;
+  left: unset;
+  right: 0.55rem;
+  transform: translateY(-50%) rotate(90deg);
+}
+
+.chart--horizontal .chart-bar-interactive.chart-bar-at-min {
+  min-width: var(--chart-handle-size);
+  border-left: 3px dashed var(--chart-bar-instance-color, var(--chart-bar-color));
+}
+
+.chart--horizontal .chart-bar-interactive.chart-bar-at-min .chart-bar-handle {
+  left: 50%;
+  right: auto;
+  top: 50%;
+  transform: translateX(-50%) translateY(-50%) rotate(90deg);
+  color: var(--chart-bar-instance-color, var(--chart-bar-color));
+  opacity: 0.75;
+}
+
+.chart--horizontal .chart-bar-interactive.chart-bar-at-min.chart-bar-correct {
+  border-left-color: var(--chart-bar-correct-color);
+}
+
+.chart--horizontal .chart-bar-interactive.chart-bar-at-min.chart-bar-correct .chart-bar-handle {
+  color: var(--chart-bar-correct-color);
+  opacity: 1;
+}
+
+.chart--horizontal .chart-bar-interactive.chart-bar-at-min.chart-bar-incorrect {
+  border-left-color: var(--chart-bar-wrong-color);
+}
+
+.chart--horizontal .chart-bar-interactive.chart-bar-at-min.chart-bar-incorrect .chart-bar-handle {
+  color: var(--chart-bar-wrong-color);
+  opacity: 1;
+}
+
+/* ── Horizontal: grid (vertical lines) ──────────────────────────────────── */
+
+.chart--horizontal .chart-gridline {
+  width: 1px;
+  height: 100%;
+  top: 0;
+  bottom: 0;
+  inset-inline: unset;
+}
+
+/* ── Horizontal: numeric X axis (below plot) ─────────────────────────────── */
+
+.chart--horizontal .chart-axis-x-numeric {
+  grid-column: 3;
+  grid-row: 3;
+  width: max(100%, var(--chart-h-value-width, 16rem));
+}
+
+/* ── Horizontal: Y-axis title (shown above labels column) ───────────────── */
+
+.chart-axis-title--y-h {
+  grid-column: 1;
+  grid-row: 2;
+}
+
+/* ── Draggable-hint peek animation ──────────────────────────────────────────── */
+
+@property --peek-fill-offset { syntax: '<number>'; inherits: false; initial-value: 0; }
+
+@keyframes chart-bar-peek {
+  0%, 100% { --peek-fill-offset: 0;    }
+  40%      { --peek-fill-offset: 0.15; }
+  70%      { --peek-fill-offset: 0.05; }
+}
+
+@keyframes chart-bar-peek-zero {
+  0%, 100% { --peek-fill-offset: 0;    background-color: transparent; opacity: 0.7;  }
+  40%      { --peek-fill-offset: 0.15; background-color: color-mix(in srgb, var(--chart-bar-instance-color, var(--chart-bar-color)) 72%, transparent); opacity: 0.95; }
+  70%      { --peek-fill-offset: 0.05; background-color: color-mix(in srgb, var(--chart-bar-instance-color, var(--chart-bar-color)) 52%, transparent); opacity: 0.82; }
+}
+
+@keyframes chart-bar-peek-handle-v {
+  0%, 100% { top: 50%;       transform: translateX(-50%) translateY(-50%);                       color: var(--chart-bar-instance-color, var(--chart-bar-color)); opacity: 0.75; }
+  40%, 70% { top: 0.15rem;   transform: translateX(-50%);                                        color: white; opacity: 1; }
+}
+
+@keyframes chart-bar-peek-handle-h {
+  0%, 100% { left: 50%;                  transform: translateX(-50%) translateY(-50%) rotate(90deg); color: var(--chart-bar-instance-color, var(--chart-bar-color)); opacity: 0.75; }
+  40%, 70% { left: calc(100% - 0.55rem); transform: translateX(-50%) translateY(-50%) rotate(90deg); color: white; opacity: 1; }
+}
+
+.chart-bar--peek                  { transition: filter 180ms ease; animation: chart-bar-peek      0.7s ease-in-out 0.3s 2 both; }
+
+.chart-bar-at-min.chart-bar--peek {                                animation: chart-bar-peek-zero 0.7s ease-in-out 0.3s 2 both; }
+
+.chart:not(.chart--horizontal) .chart-bar-at-min.chart-bar--peek .chart-bar-handle { animation: chart-bar-peek-handle-v 0.7s ease-in-out 0.3s 2 both; }
+
+.chart--horizontal               .chart-bar-at-min.chart-bar--peek .chart-bar-handle { animation: chart-bar-peek-handle-h 0.7s ease-in-out 0.3s 2 both; }
+
+/* ── Pictograph chart ────────────────────────────────────────────────────────── */
+
+/* A vertical pictograph's --chart-height is emitted inline by
+   computePictographChartStyle(), because the inline --chart-height that every chart
+   already carries would outrank any rule written here. Overriding these two tokens
+   still resizes the plot: the inline height is a calc() over them. */
+
+/* The hint animation lifts and scales an icon past its cell, so the stack must not clip. */
+
+.chart--pictograph .chart-plot {
+  overflow: visible;
+}
+
+.chart-picto-column-wrapper {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: flex-end;
+  height: 100%;
+}
+
+.chart-picto-column-wrapper--h {
+  flex-direction: row;
+  justify-content: flex-start;
+  align-items: center;
+  height: auto;
+  width: 100%;
+}
+
+.chart-picto-cells {
+  display: flex;
+  flex-direction: column-reverse;
+  gap: var(--picto-cell-gap);
+}
+
+.chart-picto-cells--h {
+  flex-direction: row;
+  gap: var(--picto-cell-gap);
+}
+
+.picto-cell {
+  width: var(--picto-cell-size);
+  height: var(--picto-cell-size);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 4px;
+}
+
+.picto-cell img {
+  width: 85%;
+  height: 85%;
+  object-fit: contain;
+  transition: filter 150ms ease, transform 150ms ease;
+}
+
+.picto-cell--inactive img {
+  filter: grayscale(100%) brightness(0.9);
+}
+
+.picto-cell--interactive {
+  cursor: pointer;
+}
+
+.picto-cell--locked {
+  cursor: default;
+}
+
+.picto-cell--interactive:focus-visible {
+  outline: 2px solid var(--chart-bar-color, #6366f1);
+  outline-offset: 1px;
+}
+
+/* Hover sur cellule ACTIVE : légère luminosité, reste clairement actif */
+
+.picto-cell--interactive:not(.picto-cell--inactive):hover img {
+  filter: brightness(1.18);
+}
+
+/* Hover sur cellule INACTIVE : reste grise, juste légèrement plus lumineuse */
+
+.picto-cell--inactive.picto-cell--interactive:hover img {
+  filter: grayscale(100%) brightness(1.12);
+}
+
+.picto-column--correct .picto-cell:not(.picto-cell--inactive) img {
+  filter: drop-shadow(0 0 3px var(--exercise-correct, #22c55e));
+}
+
+.picto-column--incorrect .picto-cell:not(.picto-cell--inactive) img {
+  filter: drop-shadow(0 0 3px var(--exercise-incorrect, #ef4444));
+}
+
+/* ── Pictograph validation animations ──────────────────────────────────────── */
+
+@keyframes picto-pop {
+  0%   { transform: scale(1); }
+  35%  { transform: scale(1.32); }
+  60%  { transform: scale(0.91); }
+  80%  { transform: scale(1.07); }
+  100% { transform: scale(1); }
+}
+
+@keyframes picto-jiggle {
+  0%, 100% { transform: translate(0, 0) rotate(0deg); }
+  12%      { transform: translate(-5px, 0) rotate(-10deg); }
+  25%      { transform: translate(5px, 0) rotate(10deg); }
+  37%      { transform: translate(-4px, 0) rotate(-7deg); }
+  50%      { transform: translate(4px, 0) rotate(7deg); }
+  62%      { transform: translate(-2px, 0) rotate(-4deg); }
+  75%      { transform: translate(2px, 0) rotate(4deg); }
+  87%      { transform: translate(-1px, 0) rotate(-2deg); }
+}
+
+.picto-cell--pop img {
+  animation: picto-pop 0.5s cubic-bezier(0.34, 1.56, 0.64, 1) both;
+}
+
+.picto-cell--jiggle img {
+  animation: picto-jiggle 0.55s ease-in-out both;
+}
+
+@keyframes picto-hint {
+  0%, 100% { transform: translateY(0)    scale(1);    }
+  30%       { transform: translateY(-5px) scale(1.12); }
+  55%       { transform: translateY(-1px) scale(1.04); }
+  75%       { transform: translateY(-3px) scale(1.09); }
+}
+
+.picto-cell--hint img {
+  animation: picto-hint 0.65s cubic-bezier(0.34, 1.2, 0.64, 1) both;
+}
+
+/* ── Pictograph cell grid lines ─────────────────────────────────────────────── */
+
+.picto-gridline {
+  position: absolute;
+  pointer-events: none;
+  background: var(--chart-grid-color);
+}
+
+/* Horizontal separators (between rows of picto cells) */
+
+.picto-gridline--row {
+  inset-inline: 0;
+  height: 1px;
+}
+
+/* Vertical separators (between picto columns) */
+
+.picto-gridline--col {
+  top: 0;
+  bottom: 0;
+  width: 1px;
+}
+
 /* Responsive Overrides - must be last */
 
 /**