@windward/games 0.23.0 → 0.24.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## Release [0.24.0] - 2025-10-23
+
+* Merged in feature/LE-2034/generate-crossword (pull request #262)
+* Merged in bugfix/LE-2020-the-quiz-show-manager-panel-does (pull request #263)
+
+
 ## Release [0.23.0] - 2025-09-16
 
 * Merged in feature/LE-2035/seven-strikes (pull request #259)

package/components/content/blocks/quizshowGame/feedbackIcons.vue

@@ -31,10 +31,10 @@ export default {
         icons: {
             type: Object,
             required: false,
-            default: {
+            default: () => ({
                 success: 'mdi-check-circle-outline',
                 error: 'mdi-close-circle-outline',
-            },
+            }),
         },
     },
 }

package/components/settings/CrosswordPuzzleSettingsManager.vue

@@ -90,6 +90,24 @@
                 </v-row>
             </v-container>
         </v-container>
+        <v-container class="pa-4 mb-6">
+            <v-row>
+                <v-col cols="12">
+                    <PluginRef
+                        target="contentBlockSettingTool"
+                        :attrs="{
+                            value: block,
+                            course: course,
+                            content: currentContent,
+                        }"
+                        :on="{
+                            input: onPluginSetBlock,
+                            append: onPluginAppendBlock,
+                        }"
+                    ></PluginRef>
+                </v-col>
+            </v-row>
+        </v-container>
         <div v-if="loading" class="text-center">
             <v-progress-circular
                 :size="70"
@@ -103,15 +121,17 @@
 
 <script>
 import _ from 'lodash'
+import { mapGetters } from 'vuex'
 import BaseContentBlockSettings from '~/components/Content/Settings/BaseContentBlockSettings.vue'
 import BaseContentSettings from '~/components/Content/Settings/BaseContentSettings.js'
 import SortableExpansionPanel from '~/components/Core/SortableExpansionPanel.vue'
+import PluginRef from '~/components/Core/PluginRef.vue'
 import Uuid from '~/helpers/Uuid'
 
 export default {
     name: 'CrosswordPuzzleSettingsManager',
     extends: BaseContentSettings,
-    components: { SortableExpansionPanel, BaseContentBlockSettings },
+    components: { SortableExpansionPanel, BaseContentBlockSettings, PluginRef },
     beforeMount() {
         if (_.isEmpty(this.block)) {
             this.block = {}
@@ -186,6 +206,12 @@ export default {
             },
         }
     },
+    computed: {
+        ...mapGetters({
+            course: 'course/get',
+            currentContent: 'content/get',
+        }),
+    },
     methods: {
         onAddElement() {
             // pushes in new crossword object
@@ -207,6 +233,227 @@ export default {
                 this.onAddElement()
             }
         },
+        onPluginSetBlock(activityData) {
+            this.loading = true
+            try {
+                const result = this.processGeneratedCrossword(activityData)
+                if (!result) {
+                    this.showInvalidResponseToast()
+                    return
+                }
+
+                this.$set(
+                    this.block.metadata,
+                    'config',
+                    this.block.metadata.config || {}
+                )
+
+                this.$set(
+                    this.block.metadata.config,
+                    'words',
+                    result.words.map((item, index) => ({
+                        id: index,
+                        word: item.word,
+                        clue: item.clue,
+                        expand: false,
+                    }))
+                )
+
+                if (result.title) {
+                    this.block.metadata.config.title = result.title
+                }
+
+                this.$toast.success(
+                    this.$t(
+                        'windward.games.components.settings.crossword.replaced_successfully'
+                    ),
+                    { duration: 3000 }
+                )
+            } catch (error) {
+                console.error('Failed to process generated crossword items', error)
+                this.$toast.error(
+                    this.$t(
+                        'windward.games.components.settings.crossword.failed_to_process'
+                    ),
+                    { duration: 5000 }
+                )
+            } finally {
+                this.loading = false
+            }
+        },
+        onPluginAppendBlock(activityData) {
+            this.loading = true
+            try {
+                const result = this.processGeneratedCrossword(activityData)
+                if (!result) {
+                    this.showInvalidResponseToast()
+                    return
+                }
+
+                if (!Array.isArray(this.block.metadata.config.words)) {
+                    this.$set(this.block.metadata.config, 'words', [])
+                }
+
+                const startingIndex = this.block.metadata.config.words.length
+
+                result.words.forEach((item, index) => {
+                    this.block.metadata.config.words.push({
+                        id: startingIndex + index,
+                        word: item.word,
+                        clue: item.clue,
+                        expand: false,
+                    })
+                })
+
+                this.renumberWordIds()
+
+                if (result.title) {
+                    const defaultTitle = this.$t(
+                        'windward.games.components.content.blocks.crossword.crossword'
+                    )
+                    if (
+                        !this.block.metadata.config.title ||
+                        this.block.metadata.config.title === defaultTitle
+                    ) {
+                        this.block.metadata.config.title = result.title
+                    }
+                }
+
+                this.$toast.success(
+                    this.$t(
+                        'windward.games.components.settings.crossword.added_successfully'
+                    ),
+                    { duration: 3000 }
+                )
+            } catch (error) {
+                console.error('Failed to append generated crossword items', error)
+                this.$toast.error(
+                    this.$t(
+                        'windward.games.components.settings.crossword.failed_to_process'
+                    ),
+                    { duration: 5000 }
+                )
+            } finally {
+                this.loading = false
+            }
+        },
+        processGeneratedCrossword(activityData) {
+            const config = _.get(activityData, 'metadata.config', null)
+            const words = _.get(config, 'words', [])
+
+            if (!Array.isArray(words) || words.length === 0) {
+                return null
+            }
+
+            const sanitizedWords = words
+                .map((item) => {
+                    const sanitizedWord = this.normalizeWord(item?.word)
+                    const sanitizedClue = this.normalizeClue(item?.clue)
+
+                    if (!sanitizedWord || !sanitizedClue) {
+                        return null
+                    }
+
+                    return {
+                        word: sanitizedWord,
+                        clue: sanitizedClue,
+                        expand: false,
+                    }
+                })
+                .filter((item) => item !== null)
+
+            if (sanitizedWords.length < 2) {
+                return null
+            }
+
+            const limitedWords = sanitizedWords.slice(0, 10)
+
+            const normalizedTitle = this.normalizeTitle(_.get(config, 'title', ''))
+
+            return {
+                title: normalizedTitle,
+                words: limitedWords,
+            }
+        },
+        normalizeWord(word) {
+            if (!word) {
+                return ''
+            }
+
+            const formatted = word
+                .toString()
+                .normalize('NFKD')
+                .replace(/[^A-Za-z]/g, '')
+                .toUpperCase()
+                .slice(0, 20)
+
+            return formatted
+        },
+        normalizeClue(clue) {
+            if (!clue) {
+                return ''
+            }
+
+            let normalized = clue
+                .toString()
+                .replace(/\s+/g, ' ')
+                .trim()
+
+            if (!normalized) {
+                return ''
+            }
+
+            if (normalized.endsWith('?')) {
+                normalized = normalized.slice(0, -1).trim()
+            }
+
+            const maxLength = 155
+            if (normalized.length > maxLength) {
+                normalized = normalized.slice(0, maxLength).trim()
+            }
+
+            if (normalized && !/[.!]$/.test(normalized)) {
+                if (normalized.length >= maxLength) {
+                    normalized = normalized.slice(0, maxLength - 1).trim()
+                }
+                normalized += '.'
+            }
+
+            return normalized
+        },
+        normalizeTitle(title) {
+            if (!title) {
+                return ''
+            }
+
+            let normalized = title
+                .toString()
+                .replace(/\s+/g, ' ')
+                .trim()
+
+            if (!normalized) {
+                return ''
+            }
+
+            if (normalized.length > 100) {
+                normalized = normalized.slice(0, 100).trim()
+            }
+
+            return normalized
+        },
+        renumberWordIds() {
+            this.block.metadata.config.words.forEach((item, index) => {
+                item.id = index
+            })
+        },
+        showInvalidResponseToast() {
+            this.$toast.error(
+                this.$t(
+                    'windward.games.components.settings.crossword.invalid_response'
+                ),
+                { duration: 5000 }
+            )
+        },
     },
 }
 </script>

package/components/settings/QuizShowSettingsManager.vue

@@ -267,7 +267,8 @@ export default {
     },
     computed: {},
     beforeMount() {
-        if (_.isEmpty(this.block.metadata.config)) {
+        // since display_title is already set so we'll look at a quiz show property to set settings for first mount
+        if (_.isEmpty(this.block.metadata.config.title)) {
             this.block.metadata.config = _.cloneDeep(this.quizShowSettings)
         }
         if (!_.isBoolean(this.block.metadata.config.display_title)) {

package/i18n/en-US/components/settings/crossword.ts

@@ -5,4 +5,8 @@ export default {
     min_length: 'Cannot have less than two words',
     alert: 'Alert',
     instructions: 'Complete the crossword by clicking on each square to type the appropriate letter. Use the tab key to move left to right across the grid. Click on the clue to highlight the corresponding word in the puzzle.',
+    replaced_successfully: 'Crossword items replaced successfully',
+    added_successfully: 'Crossword items added successfully',
+    failed_to_process: 'Failed to process generated crossword items',
+    invalid_response: 'Unable to process generated crossword items',
 }

package/i18n/es-ES/components/settings/crossword.ts

@@ -6,4 +6,8 @@ export default {
     alert: 'Alerta',
     instructions:
         'Complete el crucigrama haciendo clic en cada cuadrado para escribir la letra correspondiente. Utilice la tecla de tabulación para moverse de izquierda a derecha a través de la cuadrícula. Haga clic en la pista para resaltar la palabra correspondiente en el rompecabezas.',
+    replaced_successfully: 'Elementos del crucigrama reemplazados correctamente',
+    added_successfully: 'Elementos del crucigrama agregados correctamente',
+    failed_to_process: 'Error al procesar los elementos generados del crucigrama',
+    invalid_response: 'No se pudieron procesar los elementos generados del crucigrama',
 }

package/i18n/sv-SE/components/settings/crossword.ts

@@ -5,4 +5,8 @@ export default {
     min_length: 'Kan inte ha mindre än två ord',
     alert: 'Alert',
     instructions: 'Fyll i korsordet genom att klicka på varje ruta för att skriva rätt bokstav. Använd tabbtangenten för att flytta från vänster till höger över rutnätet. Klicka på ledtråden för att markera motsvarande ord i pusslet.',
+    replaced_successfully: 'Korsordsobjekt ersattes',
+    added_successfully: 'Korsordsobjekt lades till',
+    failed_to_process: 'Det gick inte att bearbeta genererade korsordsobjekt',
+    invalid_response: 'Det gick inte att behandla genererade korsordsobjekt',
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@windward/games",
-    "version": "0.23.0",
+    "version": "0.24.0",
     "description": "Windward UI Plugin Games",
     "main": "plugin.js",
     "scripts": {