@sentropic/design-system-svelte 0.33.0 → 0.34.20

package/dist/DumbbellChart.svelte

@@ -0,0 +1,403 @@
+<script lang="ts" module>
+  /**
+   * DumbbellChart — pour chaque catégorie, une ligne horizontale reliant une
+   * valeur BASSE à une valeur HAUTE, avec un cercle plein à chaque extrémité
+   * (la basse et la haute portent deux teintes distinctes). Idéal pour comparer
+   * deux mesures par catégorie : avant/après, min/max, objectif/réalisé.
+   * API canonique (référence Svelte ; React/Vue s'alignent).
+   *
+   * Props obligatoires :
+   *   data   DumbbellChartDatum[]  - tableau {category, low, high}
+   *   label  string                - aria-label du graphique
+   *
+   * Props optionnelles :
+   *   lowTone   "category1".."category8"  (défaut "category1") - cercle BAS
+   *   highTone  "category1".."category8"  (défaut "category2") - cercle HAUT
+   *   lowLabel  string  (défaut "Bas")  - libellé légende du cercle bas
+   *   highLabel string  (défaut "Haut") - libellé légende du cercle haut
+   *   width   number  (défaut 480)
+   *   height  number  (défaut 240)
+   *   class   string
+   *
+   * Les catégories sont distribuées sur l'axe vertical (une ligne par
+   * catégorie) ; l'axe horizontal porte l'échelle de valeurs graduée.
+   */
+  export type DumbbellChartTone =
+    | "category1"
+    | "category2"
+    | "category3"
+    | "category4"
+    | "category5"
+    | "category6"
+    | "category7"
+    | "category8";
+
+  export type DumbbellChartDatum = {
+    category: string;
+    low: number;
+    high: number;
+  };
+</script>
+
+<script lang="ts">
+  import ChartDataList from "./ChartDataList.svelte";
+  import GraphLegend from "./GraphLegend.svelte";
+
+  type DumbbellChartProps = {
+    data: DumbbellChartDatum[];
+    width?: number;
+    height?: number;
+    lowTone?: DumbbellChartTone;
+    highTone?: DumbbellChartTone;
+    lowLabel?: string;
+    highLabel?: string;
+    label: string;
+    class?: string;
+  };
+
+  let {
+    data = [],
+    width = 480,
+    height = 240,
+    lowTone = "category1",
+    highTone = "category2",
+    lowLabel = "Bas",
+    highLabel = "Haut",
+    label,
+    class: className
+  }: DumbbellChartProps = $props();
+
+  const MARGIN = { top: 16, right: 20, bottom: 32, left: 96 };
+  const DOT_RADIUS = 5;
+
+  function niceTicks(min: number, max: number, target = 5): number[] {
+    if (!Number.isFinite(min) || !Number.isFinite(max) || min === max) {
+      const base = Number.isFinite(max) ? max : 0;
+      return [base];
+    }
+    const range = max - min;
+    const rough = range / Math.max(target - 1, 1);
+    const pow = Math.pow(10, Math.floor(Math.log10(rough)));
+    const norm = rough / pow;
+    let step: number;
+    if (norm < 1.5) step = 1 * pow;
+    else if (norm < 3) step = 2 * pow;
+    else if (norm < 7) step = 5 * pow;
+    else step = 10 * pow;
+    const start = Math.floor(min / step) * step;
+    const end = Math.ceil(max / step) * step;
+    const ticks: number[] = [];
+    for (let v = start; v <= end + step / 2; v += step) {
+      ticks.push(Number(v.toFixed(10)));
+    }
+    return ticks;
+  }
+
+  function scaleLinear(v: number, d0: number, d1: number, r0: number, r1: number) {
+    if (d1 === d0) return r0;
+    return r0 + ((v - d0) * (r1 - r0)) / (d1 - d0);
+  }
+
+  function formatTick(v: number): string {
+    if (Math.abs(v) >= 1000) return `${(v / 1000).toFixed(v % 1000 === 0 ? 0 : 1)}k`;
+    if (Number.isInteger(v)) return String(v);
+    return v.toFixed(1);
+  }
+
+  // Normalise un point : low/high finis, ordonnés (lo <= hi).
+  function normalize(d: DumbbellChartDatum): { lo: number; hi: number } | null {
+    if (!Number.isFinite(d.low) || !Number.isFinite(d.high)) return null;
+    return { lo: Math.min(d.low, d.high), hi: Math.max(d.low, d.high) };
+  }
+
+  // Données valides : low + high finis.
+  const validData = $derived(data.filter((d) => normalize(d) !== null));
+
+  const dataValueItems = $derived(
+    validData.map((d) => {
+      const r = normalize(d)!;
+      return `${d.category}: ${r.lo} – ${r.hi}`;
+    })
+  );
+
+  // Réduit la police des étiquettes de catégorie quand l'espace réservé (marge
+  // gauche) est plus petit que le défaut de référence, pour éviter le rognage
+  // (cf. fix lollipop : adapter la taille au conteneur).
+  const categoryFontSize = $derived.by(() => {
+    const ratio = Math.min(1, MARGIN.left / 96);
+    return Math.max(0.5, 0.6875 * ratio);
+  });
+
+  let hoveredIndex: number | null = $state(null);
+
+  const plotWidth = $derived(Math.max(width - MARGIN.left - MARGIN.right, 1));
+  const plotHeight = $derived(Math.max(height - MARGIN.top - MARGIN.bottom, 1));
+
+  const xTicks = $derived.by(() => {
+    if (validData.length === 0) return [0];
+    const lows = validData.map((d) => normalize(d)!.lo);
+    const highs = validData.map((d) => normalize(d)!.hi);
+    const minRaw = Math.min(...lows);
+    const maxRaw = Math.max(...highs);
+    const padded = (maxRaw - minRaw) * 0.08 || Math.max(Math.abs(maxRaw), 1) * 0.1;
+    return niceTicks(minRaw - padded, maxRaw + padded, 5);
+  });
+
+  const xDomain = $derived.by(() => {
+    if (xTicks.length === 0) return { min: 0, max: 1 };
+    return { min: xTicks[0], max: xTicks[xTicks.length - 1] };
+  });
+
+  const rows = $derived.by(() => {
+    if (validData.length === 0) return [];
+    const band = plotHeight / validData.length;
+    return validData.map((d, i) => {
+      const r = normalize(d)!;
+      const cy = MARGIN.top + band * (i + 0.5);
+      const xLow = MARGIN.left + scaleLinear(r.lo, xDomain.min, xDomain.max, 0, plotWidth);
+      const xHigh = MARGIN.left + scaleLinear(r.hi, xDomain.min, xDomain.max, 0, plotWidth);
+      return {
+        datum: d,
+        range: r,
+        cy,
+        xLow,
+        xHigh,
+        index: i
+      };
+    });
+  });
+
+  const gridLines = $derived(
+    xTicks.map((tick) => ({
+      value: tick,
+      x: MARGIN.left + scaleLinear(tick, xDomain.min, xDomain.max, 0, plotWidth)
+    }))
+  );
+
+  const legendEntries = $derived([
+    { label: lowLabel, shape: "circle" as const, tone: lowTone },
+    { label: highLabel, shape: "circle" as const, tone: highTone }
+  ]);
+
+  function handleLeave() {
+    hoveredIndex = null;
+  }
+  function handleVisualPointerMove(event: PointerEvent) {
+    const target = event.target;
+    if (!(target instanceof Element)) {
+      hoveredIndex = null;
+      return;
+    }
+    const index = Number(target.getAttribute("data-chart-index"));
+    hoveredIndex = Number.isInteger(index) ? index : null;
+  }
+
+  const classes = () => ["st-dumbbellChart", className].filter(Boolean).join(" ");
+</script>
+
+<div class={classes()}>
+  <div
+    class="st-dumbbellChart__visual"
+    role="img"
+    aria-label={label}
+    onpointermove={handleVisualPointerMove}
+    onpointerleave={handleLeave}
+  >
+    <svg
+      viewBox="0 0 {width} {height}"
+      preserveAspectRatio="xMidYMid meet"
+      width="100%"
+      height="100%"
+      focusable="false"
+      aria-hidden="true"
+    >
+      <!-- gridlines + X axis ticks -->
+      {#each gridLines as g (g.value)}
+        <line
+          class="st-dumbbellChart__grid"
+          x1={g.x}
+          x2={g.x}
+          y1={MARGIN.top}
+          y2={height - MARGIN.bottom}
+        />
+        <text
+          class="st-dumbbellChart__tickLabel"
+          x={g.x}
+          y={height - MARGIN.bottom + 16}
+          text-anchor="middle"
+        >
+          {formatTick(g.value)}
+        </text>
+      {/each}
+
+      <!-- axes -->
+      <line
+        class="st-dumbbellChart__axis"
+        x1={MARGIN.left}
+        x2={MARGIN.left}
+        y1={MARGIN.top}
+        y2={height - MARGIN.bottom}
+      />
+      <line
+        class="st-dumbbellChart__axis"
+        x1={MARGIN.left}
+        x2={width - MARGIN.right}
+        y1={height - MARGIN.bottom}
+        y2={height - MARGIN.bottom}
+      />
+
+      <!-- category labels + dumbbells -->
+      {#each rows as row (row.index)}
+        <text
+          class="st-dumbbellChart__categoryLabel"
+          x={MARGIN.left - 8}
+          y={row.cy}
+          text-anchor="end"
+          dominant-baseline="middle"
+          style="font-size: {categoryFontSize}rem"
+        >
+          {row.datum.category}
+        </text>
+        <line
+          class="st-dumbbellChart__connector"
+          x1={row.xLow}
+          x2={row.xHigh}
+          y1={row.cy}
+          y2={row.cy}
+        />
+        <circle
+          class="st-dumbbellChart__dot st-dumbbellChart__dot--low st-dumbbellChart__dot--{lowTone}"
+          cx={row.xLow}
+          cy={row.cy}
+          r={DOT_RADIUS}
+          data-chart-index={row.index}
+        />
+        <circle
+          class="st-dumbbellChart__dot st-dumbbellChart__dot--high st-dumbbellChart__dot--{highTone}"
+          cx={row.xHigh}
+          cy={row.cy}
+          r={DOT_RADIUS}
+          data-chart-index={row.index}
+        />
+      {/each}
+    </svg>
+    <GraphLegend class="st-dumbbellChart__legend" entries={legendEntries} />
+  </div>
+
+  <ChartDataList {label} items={dataValueItems} />
+
+  {#if hoveredIndex !== null && rows[hoveredIndex]}
+    {@const row = rows[hoveredIndex]}
+    <div
+      class="st-dumbbellChart__tooltip"
+      role="presentation"
+      style="left: {((row.xLow + row.xHigh) / 2 / width) * 100}%; top: {(row.cy / height) * 100}%"
+    >
+      <span class="st-dumbbellChart__tooltipLabel">{row.datum.category}</span>
+      <span class="st-dumbbellChart__tooltipValue">{row.range.lo} – {row.range.hi}</span>
+    </div>
+  {/if}
+</div>
+
+<style>
+  .st-dumbbellChart {
+    color: var(--st-semantic-data-category1);
+    display: block;
+    font-family: inherit;
+    position: relative;
+    width: 100%;
+  }
+
+  .st-dumbbellChart svg {
+    display: block;
+    overflow: visible;
+  }
+
+  .st-dumbbellChart__visual {
+    display: block;
+    position: relative;
+  }
+
+  .st-dumbbellChart__legend {
+    position: absolute;
+    right: 0.25rem;
+    top: 0.25rem;
+  }
+
+  .st-dumbbellChart__grid {
+    stroke: var(--st-component-dumbbellChart-gridStroke, var(--st-semantic-border-subtle));
+    stroke-dasharray: 2 3;
+    stroke-width: 1;
+    opacity: 0.7;
+  }
+
+  .st-dumbbellChart__axis {
+    stroke: var(--st-component-dumbbellChart-axisStroke, var(--st-semantic-border-subtle));
+    stroke-width: 1;
+  }
+
+  .st-dumbbellChart__tickLabel,
+  .st-dumbbellChart__categoryLabel {
+    fill: var(--st-component-dumbbellChart-labelColor, var(--st-semantic-text-secondary));
+    font-size: 0.6875rem;
+  }
+
+  .st-dumbbellChart__connector {
+    stroke: var(--st-component-dumbbellChart-connectorStroke, var(--st-semantic-border-strong));
+    stroke-width: 2;
+    stroke-linecap: round;
+    opacity: 0.6;
+  }
+
+  .st-dumbbellChart__dot {
+    fill: currentColor;
+    stroke: var(--st-semantic-surface-default);
+    stroke-width: 1.5;
+    cursor: pointer;
+    transition: r 120ms ease;
+  }
+
+  .st-dumbbellChart__dot:hover {
+    r: 7;
+  }
+
+  .st-dumbbellChart__dot--category1 { fill: var(--st-semantic-data-category1); }
+  .st-dumbbellChart__dot--category2 { fill: var(--st-semantic-data-category2); }
+  .st-dumbbellChart__dot--category3 { fill: var(--st-semantic-data-category3); }
+  .st-dumbbellChart__dot--category4 { fill: var(--st-semantic-data-category4); }
+  .st-dumbbellChart__dot--category5 { fill: var(--st-semantic-data-category5); }
+  .st-dumbbellChart__dot--category6 { fill: var(--st-semantic-data-category6); }
+  .st-dumbbellChart__dot--category7 { fill: var(--st-semantic-data-category7); }
+  .st-dumbbellChart__dot--category8 { fill: var(--st-semantic-data-category8); }
+
+  @media (prefers-reduced-motion: reduce) {
+    .st-dumbbellChart__dot {
+      transition: none;
+    }
+  }
+
+  .st-dumbbellChart__tooltip {
+    background: var(--st-component-dumbbellChart-tooltipBackground, var(--st-semantic-surface-inverse));
+    border-radius: var(--st-radius-sm, 0.25rem);
+    color: var(--st-component-dumbbellChart-tooltipText, var(--st-semantic-text-inverse));
+    display: inline-flex;
+    flex-direction: column;
+    font-size: 0.75rem;
+    gap: 0.125rem;
+    line-height: 1.2;
+    padding: 0.375rem 0.5rem;
+    pointer-events: none;
+    position: absolute;
+    transform: translate(-50%, calc(-100% - 8px));
+    white-space: nowrap;
+    z-index: 1;
+  }
+
+  .st-dumbbellChart__tooltipLabel {
+    font-weight: 600;
+  }
+
+  .st-dumbbellChart__tooltipValue {
+    opacity: 0.85;
+  }
+</style>

package/dist/DumbbellChart.svelte.d.ts

@@ -0,0 +1,44 @@
+/**
+ * DumbbellChart — pour chaque catégorie, une ligne horizontale reliant une
+ * valeur BASSE à une valeur HAUTE, avec un cercle plein à chaque extrémité
+ * (la basse et la haute portent deux teintes distinctes). Idéal pour comparer
+ * deux mesures par catégorie : avant/après, min/max, objectif/réalisé.
+ * API canonique (référence Svelte ; React/Vue s'alignent).
+ *
+ * Props obligatoires :
+ *   data   DumbbellChartDatum[]  - tableau {category, low, high}
+ *   label  string                - aria-label du graphique
+ *
+ * Props optionnelles :
+ *   lowTone   "category1".."category8"  (défaut "category1") - cercle BAS
+ *   highTone  "category1".."category8"  (défaut "category2") - cercle HAUT
+ *   lowLabel  string  (défaut "Bas")  - libellé légende du cercle bas
+ *   highLabel string  (défaut "Haut") - libellé légende du cercle haut
+ *   width   number  (défaut 480)
+ *   height  number  (défaut 240)
+ *   class   string
+ *
+ * Les catégories sont distribuées sur l'axe vertical (une ligne par
+ * catégorie) ; l'axe horizontal porte l'échelle de valeurs graduée.
+ */
+export type DumbbellChartTone = "category1" | "category2" | "category3" | "category4" | "category5" | "category6" | "category7" | "category8";
+export type DumbbellChartDatum = {
+    category: string;
+    low: number;
+    high: number;
+};
+type DumbbellChartProps = {
+    data: DumbbellChartDatum[];
+    width?: number;
+    height?: number;
+    lowTone?: DumbbellChartTone;
+    highTone?: DumbbellChartTone;
+    lowLabel?: string;
+    highLabel?: string;
+    label: string;
+    class?: string;
+};
+declare const DumbbellChart: import("svelte").Component<DumbbellChartProps, {}, "">;
+type DumbbellChart = ReturnType<typeof DumbbellChart>;
+export default DumbbellChart;
+//# sourceMappingURL=DumbbellChart.svelte.d.ts.map

package/dist/DumbbellChart.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DumbbellChart.svelte.d.ts","sourceRoot":"","sources":["../src/lib/DumbbellChart.svelte.ts"],"names":[],"mappings":"AAGE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAOF,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AA+LJ,QAAA,MAAM,aAAa,wDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}