@wasto/cms-components 1.5.10 → 1.5.12

package/src/helpers/generateQuizQuestions.ts

@@ -1,247 +1,247 @@
-export type QuizQuestionKind = "waste_bin" | "ab_image" | "mcq";
-
-export type QuizAnswerOption = {
-    id: string;
-    text: string;
-    wasteTypeId?: string;
-    imageUrl?: string;
-    type: "correct" | "wrong";
-};
-
-export type GeneratedQuizQuestion = {
-    kind: QuizQuestionKind;
-    id: string;
-    question: string;
-    correctAnswer: string;
-    /** Identifiant de la bonne option (wasteTypeId ou choice id). */
-    correctOptionId: string;
-    /** @deprecated Alias de correctOptionId pour waste_bin. */
-    correctWasteTypeId: string;
-    answers: QuizAnswerOption[];
-    material?: string;
-    imageUrl?: string;
-    /** Explication affichée après validation de la réponse. */
-    explanation?: string;
-};
-
-type QuizQuestionSource = {
-    id: string;
-    question?: string;
-    correctWasteTypeId?: string | null;
-    order?: number;
-    material?: string;
-    imageUrl?: string | null;
-    kind?: string | null;
-    options?: unknown;
-    explanationText?: string | null;
-    explanationDetailId?: string | null;
-    explanationDetail?: {
-        material?: string | null;
-        description?: string | null;
-        instructions?: string | null;
-    } | null;
-};
-
-export function resolveQuizExplanation(source: {
-    explanationText?: string | null;
-    explanationDetail?: {
-        material?: string | null;
-        description?: string | null;
-        instructions?: string | null;
-    } | null;
-}): string | undefined {
-    const free = typeof source.explanationText === "string"
-        ? source.explanationText.trim()
-        : "";
-    if (free) return free;
-    const detail = source.explanationDetail;
-    if (!detail) return undefined;
-    const fromDetail = (detail.instructions || detail.description || "").trim();
-    if (!fromDetail) return undefined;
-    const material = detail.material?.trim();
-    return material ? `${material} : ${fromDetail}` : fromDetail;
-}
-
-function asAbImageOptions(options: unknown): {
-    choices: Array<{ id: string; imageUrl: string; label?: string }>;
-    correctChoiceId: string;
-} | null {
-    if (!options || typeof options !== "object") return null;
-    const raw = options as {
-        choices?: Array<{ id?: string; imageUrl?: string; label?: string }>;
-        correctChoiceId?: string;
-    };
-    const choices = Array.isArray(raw.choices)
-        ? raw.choices
-              .map((c, i) => ({
-                  id: String(c?.id ?? (i === 0 ? "a" : "b")),
-                  imageUrl: String(c?.imageUrl ?? "").trim(),
-                  label: c?.label ? String(c.label) : undefined,
-              }))
-              .filter((c) => c.imageUrl)
-        : [];
-    if (choices.length < 2) return null;
-    const correctChoiceId = String(raw.correctChoiceId ?? "").trim();
-    if (!choices.some((c) => c.id === correctChoiceId)) return null;
-    return { choices: choices.slice(0, 2), correctChoiceId };
-}
-
-function asMcqOptions(options: unknown): {
-    choices: Array<{ id: string; text: string }>;
-    correctChoiceId: string;
-} | null {
-    if (!options || typeof options !== "object") return null;
-    const raw = options as {
-        choices?: Array<{ id?: string; text?: string }>;
-        correctChoiceId?: string;
-    };
-    const choices = Array.isArray(raw.choices)
-        ? raw.choices
-              .map((c, i) => ({
-                  id: String(c?.id ?? `c${i}`),
-                  text: String(c?.text ?? "").trim(),
-              }))
-              .filter((c) => c.text)
-        : [];
-    if (choices.length < 2) return null;
-    const correctChoiceId = String(raw.correctChoiceId ?? "").trim();
-    if (!choices.some((c) => c.id === correctChoiceId)) return null;
-    return { choices, correctChoiceId };
-}
-
-export function generateQuizQuestions(
-    wasteTypes: Array<{ id: string; name?: string }>,
-    serie?: {
-        id: string;
-        quizQuestions?: QuizQuestionSource[];
-    } | null
-): GeneratedQuizQuestion[] {
-    const questionsToUse = [...(serie?.quizQuestions ?? [])].sort(
-        (a, b) => (a.order ?? 0) - (b.order ?? 0)
-    );
-
-    if (questionsToUse.length === 0) {
-        return [];
-    }
-
-    return questionsToUse
-        .map((quizItem): GeneratedQuizQuestion | null => {
-            const kind = (quizItem.kind as QuizQuestionKind) || "waste_bin";
-
-            if (kind === "ab_image") {
-                const opts = asAbImageOptions(quizItem.options);
-                if (!opts) return null;
-                const correct = opts.choices.find((c) => c.id === opts.correctChoiceId);
-                return {
-                    kind: "ab_image",
-                    id: quizItem.id,
-                    question: quizItem.question || "Quelle image est la bonne ?",
-                    correctAnswer: correct?.label || "Image correcte",
-                    correctOptionId: opts.correctChoiceId,
-                    correctWasteTypeId: opts.correctChoiceId,
-                    answers: opts.choices.map((choice) => ({
-                        id: choice.id,
-                        text: choice.label || (choice.id === "a" ? "A" : "B"),
-                        imageUrl: choice.imageUrl,
-                        type: choice.id === opts.correctChoiceId ? "correct" : "wrong",
-                    })),
-                    material: quizItem.material,
-                    explanation: resolveQuizExplanation(quizItem),
-                };
-            }
-
-            if (kind === "mcq") {
-                const opts = asMcqOptions(quizItem.options);
-                if (!opts) return null;
-                const correct = opts.choices.find((c) => c.id === opts.correctChoiceId);
-                const shuffled = [...opts.choices].sort(() => Math.random() - 0.5);
-                return {
-                    kind: "mcq",
-                    id: quizItem.id,
-                    question: quizItem.question || "Choisis la bonne réponse",
-                    correctAnswer: correct?.text || "Réponse correcte",
-                    correctOptionId: opts.correctChoiceId,
-                    correctWasteTypeId: opts.correctChoiceId,
-                    answers: shuffled.map((choice) => ({
-                        id: choice.id,
-                        text: choice.text,
-                        type: choice.id === opts.correctChoiceId ? "correct" : "wrong",
-                    })),
-                    material: quizItem.material,
-                    imageUrl:
-                        typeof quizItem.imageUrl === "string" && quizItem.imageUrl.trim()
-                            ? quizItem.imageUrl.trim()
-                            : undefined,
-                    explanation: resolveQuizExplanation(quizItem),
-                };
-            }
-
-            // waste_bin (legacy default)
-            if (wasteTypes.length === 0) return null;
-            const correctWasteType = wasteTypes.find(
-                (wt) => wt.id === quizItem.correctWasteTypeId
-            );
-            const otherWasteTypes = wasteTypes.filter(
-                (wt) => wt.id !== quizItem.correctWasteTypeId
-            );
-            const correctId = quizItem.correctWasteTypeId || "";
-
-            const answers: QuizAnswerOption[] = [
-                {
-                    id: correctId,
-                    text: correctWasteType?.name || "Poubelle incorrecte",
-                    wasteTypeId: correctId,
-                    type: "correct",
-                },
-                {
-                    id: otherWasteTypes[0]?.id || "wrong-0",
-                    text: otherWasteTypes[0]?.name || "Poubelle incorrecte",
-                    wasteTypeId: otherWasteTypes[0]?.id || "",
-                    type: "wrong",
-                },
-                {
-                    id: otherWasteTypes[1]?.id || "wrong-1",
-                    text: otherWasteTypes[1]?.name || "Poubelle incorrecte",
-                    wasteTypeId: otherWasteTypes[1]?.id || "",
-                    type: "wrong",
-                },
-            ];
-
-            const shuffledAnswers = [...answers].sort(() => Math.random() - 0.5);
-
-            return {
-                kind: "waste_bin",
-                id: quizItem.id,
-                question: quizItem.question || "Où jeter cet objet ?",
-                correctAnswer: correctWasteType?.name || "Poubelle",
-                correctOptionId: correctId,
-                correctWasteTypeId: correctId,
-                answers: shuffledAnswers,
-                material: quizItem.material,
-                imageUrl:
-                    typeof quizItem.imageUrl === "string" && quizItem.imageUrl.trim()
-                        ? quizItem.imageUrl.trim()
-                        : undefined,
-                explanation: resolveQuizExplanation(quizItem),
-            };
-        })
-        .filter((q): q is GeneratedQuizQuestion => q !== null);
-}
-
-export function quizStarCount(correct: number, total: number): number {
-    if (total === 0) return 0;
-    const percentage = (correct / total) * 100;
-    if (percentage === 100) return 5;
-    if (percentage >= 80) return 4;
-    if (percentage >= 60) return 3;
-    if (percentage >= 40) return 2;
-    return 1;
-}
-
-export function quizResultMessage(correct: number, total: number): string {
-    if (total === 0) return "Aucune question pour cette série.";
-    const percentage = (correct / total) * 100;
-    if (percentage >= 80) return "Excellent ! Tu es un vrai champion du tri !";
-    if (percentage >= 50) return "Super, encore un petit effort !";
-    return "Continue d'apprendre, tu vas y arriver !";
-}
+export type QuizQuestionKind = "waste_bin" | "ab_image" | "mcq";
+
+export type QuizAnswerOption = {
+    id: string;
+    text: string;
+    wasteTypeId?: string;
+    imageUrl?: string;
+    type: "correct" | "wrong";
+};
+
+export type GeneratedQuizQuestion = {
+    kind: QuizQuestionKind;
+    id: string;
+    question: string;
+    correctAnswer: string;
+    /** Identifiant de la bonne option (wasteTypeId ou choice id). */
+    correctOptionId: string;
+    /** @deprecated Alias de correctOptionId pour waste_bin. */
+    correctWasteTypeId: string;
+    answers: QuizAnswerOption[];
+    material?: string;
+    imageUrl?: string;
+    /** Explication affichée après validation de la réponse. */
+    explanation?: string;
+};
+
+type QuizQuestionSource = {
+    id: string;
+    question?: string;
+    correctWasteTypeId?: string | null;
+    order?: number;
+    material?: string;
+    imageUrl?: string | null;
+    kind?: string | null;
+    options?: unknown;
+    explanationText?: string | null;
+    explanationDetailId?: string | null;
+    explanationDetail?: {
+        material?: string | null;
+        description?: string | null;
+        instructions?: string | null;
+    } | null;
+};
+
+export function resolveQuizExplanation(source: {
+    explanationText?: string | null;
+    explanationDetail?: {
+        material?: string | null;
+        description?: string | null;
+        instructions?: string | null;
+    } | null;
+}): string | undefined {
+    const free = typeof source.explanationText === "string"
+        ? source.explanationText.trim()
+        : "";
+    if (free) return free;
+    const detail = source.explanationDetail;
+    if (!detail) return undefined;
+    const fromDetail = (detail.instructions || detail.description || "").trim();
+    if (!fromDetail) return undefined;
+    const material = detail.material?.trim();
+    return material ? `${material} : ${fromDetail}` : fromDetail;
+}
+
+function asAbImageOptions(options: unknown): {
+    choices: Array<{ id: string; imageUrl: string; label?: string }>;
+    correctChoiceId: string;
+} | null {
+    if (!options || typeof options !== "object") return null;
+    const raw = options as {
+        choices?: Array<{ id?: string; imageUrl?: string; label?: string }>;
+        correctChoiceId?: string;
+    };
+    const choices = Array.isArray(raw.choices)
+        ? raw.choices
+              .map((c, i) => ({
+                  id: String(c?.id ?? (i === 0 ? "a" : "b")),
+                  imageUrl: String(c?.imageUrl ?? "").trim(),
+                  label: c?.label ? String(c.label) : undefined,
+              }))
+              .filter((c) => c.imageUrl)
+        : [];
+    if (choices.length < 2) return null;
+    const correctChoiceId = String(raw.correctChoiceId ?? "").trim();
+    if (!choices.some((c) => c.id === correctChoiceId)) return null;
+    return { choices: choices.slice(0, 2), correctChoiceId };
+}
+
+function asMcqOptions(options: unknown): {
+    choices: Array<{ id: string; text: string }>;
+    correctChoiceId: string;
+} | null {
+    if (!options || typeof options !== "object") return null;
+    const raw = options as {
+        choices?: Array<{ id?: string; text?: string }>;
+        correctChoiceId?: string;
+    };
+    const choices = Array.isArray(raw.choices)
+        ? raw.choices
+              .map((c, i) => ({
+                  id: String(c?.id ?? `c${i}`),
+                  text: String(c?.text ?? "").trim(),
+              }))
+              .filter((c) => c.text)
+        : [];
+    if (choices.length < 2) return null;
+    const correctChoiceId = String(raw.correctChoiceId ?? "").trim();
+    if (!choices.some((c) => c.id === correctChoiceId)) return null;
+    return { choices, correctChoiceId };
+}
+
+export function generateQuizQuestions(
+    wasteTypes: Array<{ id: string; name?: string }>,
+    serie?: {
+        id: string;
+        quizQuestions?: QuizQuestionSource[];
+    } | null
+): GeneratedQuizQuestion[] {
+    const questionsToUse = [...(serie?.quizQuestions ?? [])].sort(
+        (a, b) => (a.order ?? 0) - (b.order ?? 0)
+    );
+
+    if (questionsToUse.length === 0) {
+        return [];
+    }
+
+    return questionsToUse
+        .map((quizItem): GeneratedQuizQuestion | null => {
+            const kind = (quizItem.kind as QuizQuestionKind) || "waste_bin";
+
+            if (kind === "ab_image") {
+                const opts = asAbImageOptions(quizItem.options);
+                if (!opts) return null;
+                const correct = opts.choices.find((c) => c.id === opts.correctChoiceId);
+                return {
+                    kind: "ab_image",
+                    id: quizItem.id,
+                    question: quizItem.question || "Quelle image est la bonne ?",
+                    correctAnswer: correct?.label || "Image correcte",
+                    correctOptionId: opts.correctChoiceId,
+                    correctWasteTypeId: opts.correctChoiceId,
+                    answers: opts.choices.map((choice) => ({
+                        id: choice.id,
+                        text: choice.label || (choice.id === "a" ? "A" : "B"),
+                        imageUrl: choice.imageUrl,
+                        type: choice.id === opts.correctChoiceId ? "correct" : "wrong",
+                    })),
+                    material: quizItem.material,
+                    explanation: resolveQuizExplanation(quizItem),
+                };
+            }
+
+            if (kind === "mcq") {
+                const opts = asMcqOptions(quizItem.options);
+                if (!opts) return null;
+                const correct = opts.choices.find((c) => c.id === opts.correctChoiceId);
+                const shuffled = [...opts.choices].sort(() => Math.random() - 0.5);
+                return {
+                    kind: "mcq",
+                    id: quizItem.id,
+                    question: quizItem.question || "Choisis la bonne réponse",
+                    correctAnswer: correct?.text || "Réponse correcte",
+                    correctOptionId: opts.correctChoiceId,
+                    correctWasteTypeId: opts.correctChoiceId,
+                    answers: shuffled.map((choice) => ({
+                        id: choice.id,
+                        text: choice.text,
+                        type: choice.id === opts.correctChoiceId ? "correct" : "wrong",
+                    })),
+                    material: quizItem.material,
+                    imageUrl:
+                        typeof quizItem.imageUrl === "string" && quizItem.imageUrl.trim()
+                            ? quizItem.imageUrl.trim()
+                            : undefined,
+                    explanation: resolveQuizExplanation(quizItem),
+                };
+            }
+
+            // waste_bin (legacy default)
+            if (wasteTypes.length === 0) return null;
+            const correctWasteType = wasteTypes.find(
+                (wt) => wt.id === quizItem.correctWasteTypeId
+            );
+            const otherWasteTypes = wasteTypes.filter(
+                (wt) => wt.id !== quizItem.correctWasteTypeId
+            );
+            const correctId = quizItem.correctWasteTypeId || "";
+
+            const answers: QuizAnswerOption[] = [
+                {
+                    id: correctId,
+                    text: correctWasteType?.name || "Poubelle incorrecte",
+                    wasteTypeId: correctId,
+                    type: "correct",
+                },
+                {
+                    id: otherWasteTypes[0]?.id || "wrong-0",
+                    text: otherWasteTypes[0]?.name || "Poubelle incorrecte",
+                    wasteTypeId: otherWasteTypes[0]?.id || "",
+                    type: "wrong",
+                },
+                {
+                    id: otherWasteTypes[1]?.id || "wrong-1",
+                    text: otherWasteTypes[1]?.name || "Poubelle incorrecte",
+                    wasteTypeId: otherWasteTypes[1]?.id || "",
+                    type: "wrong",
+                },
+            ];
+
+            const shuffledAnswers = [...answers].sort(() => Math.random() - 0.5);
+
+            return {
+                kind: "waste_bin",
+                id: quizItem.id,
+                question: quizItem.question || "Où jeter cet objet ?",
+                correctAnswer: correctWasteType?.name || "Poubelle",
+                correctOptionId: correctId,
+                correctWasteTypeId: correctId,
+                answers: shuffledAnswers,
+                material: quizItem.material,
+                imageUrl:
+                    typeof quizItem.imageUrl === "string" && quizItem.imageUrl.trim()
+                        ? quizItem.imageUrl.trim()
+                        : undefined,
+                explanation: resolveQuizExplanation(quizItem),
+            };
+        })
+        .filter((q): q is GeneratedQuizQuestion => q !== null);
+}
+
+export function quizStarCount(correct: number, total: number): number {
+    if (total === 0) return 0;
+    const percentage = (correct / total) * 100;
+    if (percentage === 100) return 5;
+    if (percentage >= 80) return 4;
+    if (percentage >= 60) return 3;
+    if (percentage >= 40) return 2;
+    return 1;
+}
+
+export function quizResultMessage(correct: number, total: number): string {
+    if (total === 0) return "Aucune question pour cette série.";
+    const percentage = (correct / total) * 100;
+    if (percentage >= 80) return "Excellent ! Tu es un vrai champion du tri !";
+    if (percentage >= 50) return "Super, encore un petit effort !";
+    return "Continue d'apprendre, tu vas y arriver !";
+}

package/src/helpers/getContrastColor.ts

@@ -1,19 +1,19 @@
-/**
- * Détermine si le texte doit être noir ou blanc en fonction de la couleur de fond
- * @param hex Color au format #RRGGBB ou #RGB
- * @returns '#000000' ou '#FFFFFF'
- */
-export function getContrastColor(hex: string): '#000000' | '#FFFFFF' {
-    let cleanHex = hex.replace('#', '');
-    if (cleanHex.length === 3) {
-        cleanHex = cleanHex.split('').map(char => char + char).join('');
-    }
-
-    const r = parseInt(cleanHex.substring(0, 2), 16);
-    const g = parseInt(cleanHex.substring(2, 4), 16);
-    const b = parseInt(cleanHex.substring(4, 6), 16);
-
-    const yiq = (r * 299 + g * 587 + b * 114) / 1000;
-
-    return yiq >= 128 ? '#000000' : '#FFFFFF';
+/**
+ * Détermine si le texte doit être noir ou blanc en fonction de la couleur de fond
+ * @param hex Color au format #RRGGBB ou #RGB
+ * @returns '#000000' ou '#FFFFFF'
+ */
+export function getContrastColor(hex: string): '#000000' | '#FFFFFF' {
+    let cleanHex = hex.replace('#', '');
+    if (cleanHex.length === 3) {
+        cleanHex = cleanHex.split('').map(char => char + char).join('');
+    }
+
+    const r = parseInt(cleanHex.substring(0, 2), 16);
+    const g = parseInt(cleanHex.substring(2, 4), 16);
+    const b = parseInt(cleanHex.substring(4, 6), 16);
+
+    const yiq = (r * 299 + g * 587 + b * 114) / 1000;
+
+    return yiq >= 128 ? '#000000' : '#FFFFFF';
 }

package/src/helpers/haptics.ts

@@ -1,20 +1,20 @@
-import * as Haptics from "expo-haptics";
-import { Platform } from "react-native";
-
-export async function hapticSelection() {
-    if (Platform.OS === "web") return;
-    try {
-        await Haptics.selectionAsync();
-    } catch {
-        // Haptics unavailable on simulator / unsupported devices
-    }
-}
-
-export async function hapticLight() {
-    if (Platform.OS === "web") return;
-    try {
-        await Haptics.impactAsync(Haptics.ImpactFeedbackStyle.Light);
-    } catch {
-        // ignore
-    }
-}
+import * as Haptics from "expo-haptics";
+import { Platform } from "react-native";
+
+export async function hapticSelection() {
+    if (Platform.OS === "web") return;
+    try {
+        await Haptics.selectionAsync();
+    } catch {
+        // Haptics unavailable on simulator / unsupported devices
+    }
+}
+
+export async function hapticLight() {
+    if (Platform.OS === "web") return;
+    try {
+        await Haptics.impactAsync(Haptics.ImpactFeedbackStyle.Light);
+    } catch {
+        // ignore
+    }
+}