@tinyweb_dev/oe-exam-sdk 0.1.0

package/dist/components/questions/_shared/hooks/useBasicQuestionGroup.js

@@ -0,0 +1,223 @@
+'use client';
+import { useState, useEffect, useRef } from 'react';
+import { useExamQuestionStore } from '../../../../shared/lib/stores/examQuestionStore';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Derives which group number a question at `questionIndexInPart` belongs to,
+ * given the part's group configuration array.
+ *
+ * Example: groups = [{ number:1, questionCount:3 }, { number:2, questionCount:3 }]
+ *   index 0,1,2 → group 1
+ *   index 3,4,5 → group 2
+ */
+export function getGroupNumberForIndex(questionIndexInPart, groups) {
+    if (!groups || groups.length === 0 || questionIndexInPart === undefined)
+        return 1;
+    let cumulative = 0;
+    for (const group of groups) {
+        cumulative += group.questionCount;
+        if (questionIndexInPart < cumulative) {
+            return group.number;
+        }
+    }
+    return groups[groups.length - 1]?.number ?? 1;
+}
+/**
+ * Checks if the current question is the first question in its group array
+ */
+export function getIsFirstInGroup(questionIndexInPart, groups) {
+    if (!groups || groups.length === 0 || questionIndexInPart === undefined)
+        return true;
+    let cumulative = 0;
+    for (const group of groups) {
+        if (questionIndexInPart === cumulative)
+            return true;
+        cumulative += group.questionCount;
+        if (questionIndexInPart < cumulative)
+            return false;
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Hook implementation
+// ---------------------------------------------------------------------------
+/**
+ * `useBasicQuestionGroup`
+ *
+ * Manages the three shared group fields (title, content, imageUrl) for the
+ * "basic" question group used by ANSWER_THE_QUESTION, CHOOSE_THE_CORRECT_ANSWER,
+ * and FILL_IN_BLANK.
+ *
+ * Reads initial values from `examQuestionStore` (shared across all questions in
+ * the same group), falls back to `initialData`, and writes every change back to
+ * the store so sibling questions instantly see the updated values.
+ */
+export function useBasicQuestionGroup({ partId, groups, questionIndexInPart, initialData, articleCount = 0, }) {
+    const setSharedPassageData = useExamQuestionStore((s) => s.setSharedPassageData);
+    const getSharedPassageData = useExamQuestionStore((s) => s.getSharedPassageData);
+    const isGrouped = Boolean(groups && groups.length > 0);
+    const currentGroupNumber = getGroupNumberForIndex(questionIndexInPart, groups);
+    const isFirstInGroup = getIsFirstInGroup(questionIndexInPart, groups);
+    // ------------------------------------------------------------------
+    // Initialise state: store > initialData > empty string
+    // ------------------------------------------------------------------
+    // Create default empty articles array when articleCount > 0
+    const defaultArticles = articleCount > 0
+        ? Array.from({ length: articleCount }, () => ({ name: '', content: '', imageUrl: '' }))
+        : [];
+    const resolveInitial = () => {
+        if (isGrouped && partId) {
+            const stored = getSharedPassageData(partId, currentGroupNumber);
+            if (stored) {
+                return {
+                    title: stored.passageTitle ?? initialData?.title ?? '',
+                    subtitle: stored.passageSubtitle ?? initialData?.subtitle ?? '',
+                    content: stored.groupContent ?? stored.passage ?? initialData?.content ?? '',
+                    imageUrl: stored.imageUrl ?? initialData?.imageUrl ?? '',
+                    articles: stored.articles ?? initialData?.articles ?? defaultArticles,
+                };
+            }
+        }
+        return {
+            title: initialData?.title ?? '',
+            subtitle: initialData?.subtitle ?? '',
+            content: initialData?.content ?? '',
+            imageUrl: initialData?.imageUrl ?? '',
+            articles: initialData?.articles ?? defaultArticles,
+        };
+    };
+    const initial = resolveInitial();
+    const [groupTitle, setGroupTitleState] = useState(initial.title ?? '');
+    const [groupSubtitle, setGroupSubtitleState] = useState(initial.subtitle ?? '');
+    const [groupContent, setGroupContentState] = useState(initial.content ?? '');
+    const [imageUrl, setImageUrlState] = useState(initial.imageUrl ?? '');
+    const [articles, setArticlesState] = useState(initial.articles ?? defaultArticles);
+    // Track the last rendered group number so we can re-sync when navigating
+    const prevGroupNumberRef = useRef(currentGroupNumber);
+    // Track whether we have already seeded from initialData for the current group
+    // ------------------------------------------------------------------
+    // Seed from initialData when it becomes available (e.g. after async fetch).
+    // Only fills fields that are missing from the store — never overwrites
+    // values the user has already typed.
+    // ------------------------------------------------------------------
+    useEffect(() => {
+        if (!isGrouped || !partId)
+            return;
+        if (!initialData)
+            return;
+        const stored = getSharedPassageData(partId, currentGroupNumber);
+        // If a stored record already exists for this group, it means the data has
+        // been actively managed (written by persistToStore). Do NOT re-seed from
+        // initialData — the user may have intentionally cleared a field (e.g.
+        // deleted the group image). Falsy-checking individual stored fields like
+        // `!stored?.imageUrl` would treat '' the same as "never set", causing
+        // cleared values to be restored from initialData.
+        if (stored)
+            return;
+        const newTitle = initialData.title || null;
+        const newSubtitle = initialData.subtitle || null;
+        const newContent = initialData.content || null;
+        const newImage = initialData.imageUrl || null;
+        const newArticles = initialData.articles || null;
+        if (newTitle === null && newSubtitle === null && newContent === null && newImage === null && newArticles === null)
+            return;
+        if (newTitle !== null)
+            setGroupTitleState(newTitle);
+        if (newSubtitle !== null)
+            setGroupSubtitleState(newSubtitle);
+        if (newContent !== null)
+            setGroupContentState(newContent);
+        if (newImage !== null)
+            setImageUrlState(newImage);
+        if (newArticles !== null)
+            setArticlesState(newArticles);
+        setSharedPassageData(partId, currentGroupNumber, {
+            passageTitle: newTitle ?? '',
+            passageSubtitle: newSubtitle ?? '',
+            groupContent: newContent ?? '',
+            passage: newContent ?? '',
+            imageUrl: newImage ?? '',
+            articles: newArticles ?? defaultArticles,
+        });
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [initialData, partId, currentGroupNumber, isGrouped]);
+    // ------------------------------------------------------------------
+    // Re-sync when the user navigates to a different question (group may change)
+    // ------------------------------------------------------------------
+    useEffect(() => {
+        if (prevGroupNumberRef.current === currentGroupNumber)
+            return;
+        prevGroupNumberRef.current = currentGroupNumber;
+        if (!isGrouped || !partId)
+            return;
+        const stored = getSharedPassageData(partId, currentGroupNumber);
+        if (stored && (stored.passageTitle || stored.passageSubtitle || stored.groupContent || stored.passage || stored.imageUrl || stored.articles)) {
+            setGroupTitleState(stored.passageTitle ?? '');
+            setGroupSubtitleState(stored.passageSubtitle ?? '');
+            setGroupContentState(stored.groupContent ?? stored.passage ?? '');
+            setImageUrlState(stored.imageUrl ?? '');
+            setArticlesState(stored.articles ?? defaultArticles);
+        }
+        else {
+            setGroupTitleState(initialData?.title ?? '');
+            setGroupSubtitleState(initialData?.subtitle ?? '');
+            setGroupContentState(initialData?.content ?? '');
+            setImageUrlState(initialData?.imageUrl ?? '');
+            setArticlesState(initialData?.articles ?? defaultArticles);
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [currentGroupNumber, partId, isGrouped]);
+    // ------------------------------------------------------------------
+    // Helpers: write state + persist to store
+    // ------------------------------------------------------------------
+    const persistToStore = (title, subtitle, content, image, arts) => {
+        if (!isGrouped || !partId)
+            return;
+        setSharedPassageData(partId, currentGroupNumber, {
+            passageTitle: title,
+            passageSubtitle: subtitle,
+            groupContent: content,
+            passage: content,
+            imageUrl: image,
+            articles: arts ?? articles,
+        });
+    };
+    const setGroupTitle = (value) => {
+        setGroupTitleState(value);
+        persistToStore(value, groupSubtitle, groupContent, imageUrl);
+    };
+    const setGroupSubtitle = (value) => {
+        setGroupSubtitleState(value);
+        persistToStore(groupTitle, value, groupContent, imageUrl);
+    };
+    const setGroupContent = (value) => {
+        setGroupContentState(value);
+        persistToStore(groupTitle, groupSubtitle, value, imageUrl);
+    };
+    const setImageUrl = (value) => {
+        setImageUrlState(value);
+        persistToStore(groupTitle, groupSubtitle, groupContent, value);
+    };
+    const setArticles = (value) => {
+        setArticlesState(value);
+        persistToStore(groupTitle, groupSubtitle, groupContent, imageUrl, value);
+    };
+    return {
+        isGrouped,
+        currentGroupNumber,
+        isFirstInGroup,
+        groupTitle,
+        groupSubtitle,
+        groupContent,
+        imageUrl,
+        articles,
+        setGroupTitle,
+        setGroupSubtitle,
+        setGroupContent,
+        setImageUrl,
+        setArticles,
+    };
+}
+//# sourceMappingURL=useBasicQuestionGroup.js.map

package/dist/components/questions/_shared/hooks/useBasicQuestionGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBasicQuestionGroup.js","sourceRoot":"","sources":["../../../../../src/components/questions/_shared/hooks/useBasicQuestionGroup.ts"],"names":[],"mappings":"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"}

package/dist/components/questions/_shared/hooks/useCompareImagesGroup.d.ts

@@ -0,0 +1,12 @@
+export interface CompareImagesGroupData {
+    candidateImageUrl?: string;
+    examinerImageUrl?: string;
+}
+export declare function useCompareImagesGroup(partId?: string, groupNumber?: number, initialData?: CompareImagesGroupData): {
+    candidateImageUrl: string;
+    examinerImageUrl: string;
+    updateCandidateImage: (url: string) => void;
+    updateExaminerImage: (url: string) => void;
+    isValid: boolean;
+};
+//# sourceMappingURL=useCompareImagesGroup.d.ts.map

package/dist/components/questions/_shared/hooks/useCompareImagesGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCompareImagesGroup.d.ts","sourceRoot":"","sources":["../../../../../src/components/questions/_shared/hooks/useCompareImagesGroup.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,sBAAsB;;;gCAkInG,MAAM;+BAQN,MAAM;;EAcnB"}

package/dist/components/questions/_shared/hooks/useCompareImagesGroup.js

@@ -0,0 +1,141 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { useExamQuestionStore } from '../../../../shared/lib/stores/examQuestionStore';
+export function useCompareImagesGroup(partId, groupNumber, initialData) {
+    const setSharedCompareImagesData = useExamQuestionStore((s) => s.setSharedCompareImagesData);
+    const getSharedCompareImagesData = useExamQuestionStore((s) => s.getSharedCompareImagesData);
+    const sharedCompareImagesData = useExamQuestionStore((s) => s.sharedCompareImagesData);
+    const emptyData = useMemo(() => ({ candidateImageUrl: '', examinerImageUrl: '' }), []);
+    // Valid only if we have both identifiers
+    const isValid = partId !== undefined && groupNumber !== undefined;
+    const resolveInitial = () => {
+        if (isValid) {
+            const stored = getSharedCompareImagesData(partId, groupNumber);
+            if (stored && (stored.candidateImageUrl || stored.examinerImageUrl)) {
+                return {
+                    candidateImageUrl: stored.candidateImageUrl || initialData?.candidateImageUrl || '',
+                    examinerImageUrl: stored.examinerImageUrl || initialData?.examinerImageUrl || '',
+                };
+            }
+        }
+        return {
+            candidateImageUrl: initialData?.candidateImageUrl || '',
+            examinerImageUrl: initialData?.examinerImageUrl || '',
+        };
+    };
+    const initial = resolveInitial();
+    const [candidateImageUrl, setCandidateImageUrl] = useState(initial.candidateImageUrl);
+    const [examinerImageUrl, setExaminerImageUrl] = useState(initial.examinerImageUrl);
+    const prevGroupNumberRef = useRef(groupNumber);
+    // Initialize from initialData on mount or group load
+    useEffect(() => {
+        if (!isValid)
+            return;
+        if (!initialData)
+            return;
+        const stored = getSharedCompareImagesData(partId, groupNumber);
+        if (stored && (stored.candidateImageUrl || stored.examinerImageUrl))
+            return;
+        if (initialData.candidateImageUrl || initialData.examinerImageUrl) {
+            const newCandidate = initialData.candidateImageUrl || '';
+            const newExaminer = initialData.examinerImageUrl || '';
+            setCandidateImageUrl(newCandidate);
+            setExaminerImageUrl(newExaminer);
+            setSharedCompareImagesData(partId, groupNumber, {
+                ...(stored || {}),
+                candidateImageUrl: newCandidate,
+                examinerImageUrl: newExaminer,
+            });
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [initialData, partId, groupNumber, isValid]);
+    // Handle group number changes
+    useEffect(() => {
+        if (prevGroupNumberRef.current === groupNumber)
+            return;
+        prevGroupNumberRef.current = groupNumber;
+        if (!isValid)
+            return;
+        const stored = getSharedCompareImagesData(partId, groupNumber);
+        if (stored && (stored.candidateImageUrl || stored.examinerImageUrl)) {
+            setCandidateImageUrl(stored.candidateImageUrl || '');
+            setExaminerImageUrl(stored.examinerImageUrl || '');
+        }
+        else {
+            setCandidateImageUrl(initialData?.candidateImageUrl || '');
+            setExaminerImageUrl(initialData?.examinerImageUrl || '');
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [groupNumber, partId, isValid]);
+    // Sync from local storage if component mounts and store is empty
+    useEffect(() => {
+        if (!isValid)
+            return;
+        const currentData = getSharedCompareImagesData(partId, groupNumber);
+        if (!currentData || (!currentData.candidateImageUrl && !currentData.examinerImageUrl)) {
+            try {
+                const localStorageKey = `exam_question_${partId}_${groupNumber}`;
+                const savedData = localStorage.getItem(localStorageKey);
+                if (savedData) {
+                    const parsed = JSON.parse(savedData);
+                    const candidate = parsed.questionGroup?.payload?.candidateImageUrl;
+                    const examiner = parsed.questionGroup?.payload?.examinerImageUrl;
+                    if (candidate || examiner) {
+                        setCandidateImageUrl(candidate || '');
+                        setExaminerImageUrl(examiner || '');
+                        setSharedCompareImagesData(partId, groupNumber, {
+                            candidateImageUrl: candidate || '',
+                            examinerImageUrl: examiner || '',
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                console.error('Error parsing localStorage question data:', error);
+            }
+        }
+    }, [partId, groupNumber, isValid, getSharedCompareImagesData, setSharedCompareImagesData]);
+    // Subscribe to external store changes
+    useEffect(() => {
+        if (!isValid)
+            return;
+        const stored = getSharedCompareImagesData(partId, groupNumber);
+        if (stored) {
+            setCandidateImageUrl((prev) => {
+                if (stored.candidateImageUrl !== undefined && prev !== stored.candidateImageUrl)
+                    return stored.candidateImageUrl;
+                return prev;
+            });
+            setExaminerImageUrl((prev) => {
+                if (stored.examinerImageUrl !== undefined && prev !== stored.examinerImageUrl)
+                    return stored.examinerImageUrl;
+                return prev;
+            });
+        }
+    }, [sharedCompareImagesData, isValid, partId, groupNumber, getSharedCompareImagesData]);
+    const persistToStore = (candidateUrl, examinerUrl) => {
+        if (!isValid)
+            return;
+        const currentData = getSharedCompareImagesData(partId, groupNumber) || emptyData;
+        setSharedCompareImagesData(partId, groupNumber, {
+            ...currentData,
+            ...(candidateUrl !== undefined && { candidateImageUrl: candidateUrl }),
+            ...(examinerUrl !== undefined && { examinerImageUrl: examinerUrl }),
+        });
+    };
+    const updateCandidateImage = useCallback((url) => {
+        setCandidateImageUrl(url);
+        persistToStore(url, undefined);
+    }, [isValid, partId, groupNumber, getSharedCompareImagesData, setSharedCompareImagesData, emptyData]);
+    const updateExaminerImage = useCallback((url) => {
+        setExaminerImageUrl(url);
+        persistToStore(undefined, url);
+    }, [isValid, partId, groupNumber, getSharedCompareImagesData, setSharedCompareImagesData, emptyData]);
+    return {
+        candidateImageUrl,
+        examinerImageUrl,
+        updateCandidateImage,
+        updateExaminerImage,
+        isValid,
+    };
+}
+//# sourceMappingURL=useCompareImagesGroup.js.map

package/dist/components/questions/_shared/hooks/useCompareImagesGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCompareImagesGroup.js","sourceRoot":"","sources":["../../../../../src/components/questions/_shared/hooks/useCompareImagesGroup.ts"],"names":[],"mappings":"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"}

package/dist/components/questions/_shared/hooks/useImageQuestionGroup.d.ts

@@ -0,0 +1,20 @@
+import type { QuestionGroupConfig } from '../types/question-group.type';
+import { GroupImageItem } from '../types/listen-and-speak-image-group.type';
+export declare function getGroupNumberForIndex(questionIndexInPart: number | undefined, groups: QuestionGroupConfig[] | undefined): number;
+export interface ImageGroupData {
+    images?: GroupImageItem[];
+}
+export interface UseImageQuestionGroupOptions {
+    partId?: string;
+    groups?: QuestionGroupConfig[];
+    questionIndexInPart?: number;
+    initialData?: ImageGroupData;
+}
+export interface UseImageQuestionGroupReturn {
+    isGrouped: boolean;
+    currentGroupNumber: number;
+    images: GroupImageItem[];
+    setImages: (value: GroupImageItem[] | ((prev: GroupImageItem[]) => GroupImageItem[])) => void;
+}
+export declare function useImageQuestionGroup({ partId, groups, questionIndexInPart, initialData, }: UseImageQuestionGroupOptions): UseImageQuestionGroupReturn;
+//# sourceMappingURL=useImageQuestionGroup.d.ts.map

package/dist/components/questions/_shared/hooks/useImageQuestionGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImageQuestionGroup.d.ts","sourceRoot":"","sources":["../../../../../src/components/questions/_shared/hooks/useImageQuestionGroup.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAG5E,wBAAgB,sBAAsB,CAClC,mBAAmB,EAAE,MAAM,GAAG,SAAS,EACvC,MAAM,EAAE,mBAAmB,EAAE,GAAG,SAAS,GAC1C,MAAM,CAUR;AAED,MAAM,WAAW,cAAc;IAC3B,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,CAAC,KAAK,IAAI,CAAC;CACjG;AAED,wBAAgB,qBAAqB,CAAC,EAClC,MAAM,EACN,MAAM,EACN,mBAAmB,EACnB,WAAW,GACd,EAAE,4BAA4B,GAAG,2BAA2B,CAiH5D"}

package/dist/components/questions/_shared/hooks/useImageQuestionGroup.js

@@ -0,0 +1,124 @@
+'use client';
+import { useState, useEffect, useRef } from 'react';
+import { useExamQuestionStore } from '../../../../shared/lib/stores/examQuestionStore';
+// Reusing helper from useSceneQuestionGroup
+export function getGroupNumberForIndex(questionIndexInPart, groups) {
+    if (!groups || groups.length === 0 || questionIndexInPart === undefined)
+        return 1;
+    let cumulative = 0;
+    for (const group of groups) {
+        cumulative += group.questionCount;
+        if (questionIndexInPart < cumulative) {
+            return group.number;
+        }
+    }
+    return groups[groups.length - 1]?.number ?? 1;
+}
+export function useImageQuestionGroup({ partId, groups, questionIndexInPart, initialData, }) {
+    const setSharedSceneData = useExamQuestionStore((s) => s.setSharedSceneData);
+    const getSharedSceneData = useExamQuestionStore((s) => s.getSharedSceneData);
+    const sharedSceneData = useExamQuestionStore((s) => s.sharedSceneData);
+    const isGrouped = Boolean(groups && groups.length > 0);
+    const currentGroupNumber = getGroupNumberForIndex(questionIndexInPart, groups);
+    const resolveInitial = () => {
+        if (isGrouped && partId) {
+            const stored = getSharedSceneData(partId, currentGroupNumber);
+            if (stored && stored.images !== undefined) {
+                return {
+                    images: stored.images && stored.images.length > 0
+                        ? stored.images
+                        : initialData?.images ?? [],
+                };
+            }
+        }
+        return {
+            images: initialData?.images ?? [],
+        };
+    };
+    const initial = resolveInitial();
+    const [imagesState, setImagesState] = useState(initial.images ?? []);
+    const prevGroupNumberRef = useRef(currentGroupNumber);
+    useEffect(() => {
+        if (!isGrouped || !partId)
+            return;
+        if (!initialData)
+            return;
+        const stored = getSharedSceneData(partId, currentGroupNumber);
+        if (stored && stored.images !== undefined)
+            return;
+        const newImages = initialData.images && initialData.images.length > 0
+            ? initialData.images
+            : null;
+        if (newImages === null)
+            return;
+        setImagesState(newImages);
+        // Keep existing stored data if any, just augment the `images`
+        setSharedSceneData(partId, currentGroupNumber, {
+            ...(stored || {}),
+            images: newImages,
+        });
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [initialData, partId, currentGroupNumber, isGrouped]);
+    useEffect(() => {
+        if (prevGroupNumberRef.current === currentGroupNumber)
+            return;
+        prevGroupNumberRef.current = currentGroupNumber;
+        if (!isGrouped || !partId)
+            return;
+        const stored = getSharedSceneData(partId, currentGroupNumber);
+        if (stored && stored.images && stored.images.length > 0) {
+            setImagesState(stored.images);
+        }
+        else {
+            setImagesState(initialData?.images ?? []);
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [currentGroupNumber, partId, isGrouped]);
+    // ------------------------------------------------------------------
+    // Subscribe to external store changes (from other questions in group)
+    // ------------------------------------------------------------------
+    useEffect(() => {
+        if (!isGrouped || !partId)
+            return;
+        const stored = getSharedSceneData(partId, currentGroupNumber);
+        if (stored && stored.images) {
+            // Only update if references/lengths differ to avoid infinite loops,
+            // or perform a deep comparison if needed. For now, basic length/ref check:
+            setImagesState((prev) => {
+                if (JSON.stringify(prev) !== JSON.stringify(stored.images)) {
+                    return stored.images || [];
+                }
+                return prev;
+            });
+        }
+    }, [sharedSceneData, isGrouped, partId, currentGroupNumber, getSharedSceneData]);
+    const persistToStore = (nodes) => {
+        if (!isGrouped || !partId)
+            return;
+        const stored = getSharedSceneData(partId, currentGroupNumber);
+        setSharedSceneData(partId, currentGroupNumber, {
+            ...(stored || {}),
+            images: nodes,
+        });
+    };
+    const setImages = (value) => {
+        if (typeof value === 'function') {
+            setImagesState((prev) => {
+                const next = value(prev);
+                persistToStore(next);
+                return next;
+            });
+        }
+        else {
+            setImagesState(value);
+            persistToStore(value);
+        }
+    };
+    return {
+        isGrouped,
+        currentGroupNumber,
+        images: imagesState,
+        setImages,
+    };
+}
+//# sourceMappingURL=useImageQuestionGroup.js.map

package/dist/components/questions/_shared/hooks/useImageQuestionGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImageQuestionGroup.js","sourceRoot":"","sources":["../../../../../src/components/questions/_shared/hooks/useImageQuestionGroup.ts"],"names":[],"mappings":"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"}

package/dist/components/questions/_shared/hooks/useInfoExchangeGroup.d.ts

@@ -0,0 +1,35 @@
+export interface InfoExchangeGroupData {
+    title: string;
+    imageUrl: string;
+    fields: Array<{
+        key: string;
+        answer: string;
+    }>;
+    candidateFields: Array<{
+        key: string;
+        answer: string;
+    }>;
+    examinerFields: Array<{
+        key: string;
+        answer: string;
+    }>;
+}
+export declare function useInfoExchangeGroup(partId?: string, groupNumber?: number): {
+    updateGroupData: (data: Partial<InfoExchangeGroupData>) => void;
+    isValid: boolean;
+    title: string;
+    imageUrl: string;
+    fields: Array<{
+        key: string;
+        answer: string;
+    }>;
+    candidateFields: Array<{
+        key: string;
+        answer: string;
+    }>;
+    examinerFields: Array<{
+        key: string;
+        answer: string;
+    }>;
+};
+//# sourceMappingURL=useInfoExchangeGroup.d.ts.map

package/dist/components/questions/_shared/hooks/useInfoExchangeGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfoExchangeGroup.d.ts","sourceRoot":"","sources":["../../../../../src/components/questions/_shared/hooks/useInfoExchangeGroup.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,eAAe,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,cAAc,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D;AAOD,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;4BAoC3D,OAAO,CAAC,qBAAqB,CAAC;;WAhDlC,MAAM;cACH,MAAM;YACR,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;qBAC7B,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;oBACvC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;EAyDzD"}