@windward/games 0.23.0 → 0.25.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## Release [0.25.0] - 2025-12-02
+
+* Merged in feature/LE-2156-block-settings-label (pull request #264)
+* Merged in LE-2184-feedback-text-placeholder (pull request #267)
+
+
+## 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/dragDrop/BucketGame.vue

@@ -30,16 +30,10 @@
                     )
                 }}
             </h4>
-            <v-alert fluid :class="status">
+            <v-alert v-if="feedback" fluid :class="status">
                 <v-row class="pa-4 d-flex justify-center">
                     <p class="mb-0 p-text-override">
-                        {{
-                            feedback
-                                ? feedback
-                                : $t(
-                                      'windward.games.components.content.blocks.bucket_game.form.feedback.feedback_here'
-                                  )
-                        }}
+                        {{ feedback }}
                     </p>
                 </v-row>
                 <v-row class="d-flex justify-center mt-0 mb-1">

package/components/content/blocks/dragDrop/SortingGame.vue

@@ -176,7 +176,7 @@ export default {
             isDisabled: false,
             reload: false,
             input: [],
-            feedback: 'feedback here',
+            feedback: '',
             success: [],
             fail: [],
             seed: 123,

package/components/content/blocks/matchingGame/MatchingGame.vue

@@ -26,10 +26,6 @@
             <v-container :class="status">
                 <v-row class="d-flex justify-center pa-2">{{
                     feedback
-                        ? feedback
-                        : $t(
-                              'windward.games.components.content.blocks.bucket_game.form.feedback.feedback_here'
-                          )
                 }}</v-row>
                 <v-row class="d-flex justify-center pa-2" v-if="!gameCompleted">
                     <v-btn
@@ -392,9 +388,7 @@ export default {
     },
     data() {
         return {
-            feedback: this.$t(
-                'windward.games.components.content.blocks.matching_game.default_feedback'
-            ),
+            feedback: '',
             gameCompleted: false,
             shufflePrompts: [],
             solvedQuestions: [],
@@ -528,9 +522,7 @@ export default {
             this.status = 'default'
             this.allowDrag = true
             this.droppedElement = null
-            this.feedback = this.$t(
-                'windward.games.components.content.blocks.matching_game.default_feedback'
-            )
+            this.feedback = ''
         },
         onContinueGame() {
             if (!this.render) {
@@ -541,9 +533,7 @@ export default {
             this.mainPrompt = this.shufflePrompts.shift()
             this.allowDrag = true
             this.droppedElement = null
-            this.feedback = this.$t(
-                'windward.games.components.content.blocks.matching_game.default_feedback'
-            )
+            this.feedback = ''
         },
         onReset() {
             this.shufflePrompts = []
@@ -552,9 +542,7 @@ export default {
             this.solvedQuestions = []
             this.gameCompleted = false
             this.allowDrag = true
-            this.feedback = this.$t(
-                'windward.games.components.content.blocks.matching_game.default_feedback'
-            )
+            this.feedback = ''
             this.setMainPrompt()
         },
     },

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/en-US/shared/settings.ts

@@ -1,15 +1,6 @@
 export default {
     title: {
-        card_manager: ' Flashcard Slides Manager',
-        bucket_manager: ' Bucket Game Manager',
-        sorting_manager: 'Sorting Game Manager',
-        matching_game_manager: ' Matching Game Manager',
-        slideshow_manager: 'Slideshow Manager',
-        quizshow_manager: 'Quizshow Manager',
-        multiple_choice_manager: 'Multiple Choice Manager',
-        wordjumble_manager: 'Word Jumble Manager',
-        seven_strikes_manager: 'Seven Strikes Manager',
-        crossword_puzzle_manager: 'Crossword Puzzle Manager',
+        block_builder: 'Block Builder',
     },
     errors: {
         input_limitations: 'Must be less than {0} characters.'

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/es-ES/shared/settings.ts

@@ -1,15 +1,6 @@
 export default {
     title: {
-        card_manager: ' Administrador de diapositivas de tarjetas flash ',
-        bucket_manager: 'Administrador del juego de cubos',
-        sorting_manager: 'Gestor de juegos de clasificación',
-        matching_game_manager: 'Administrador de juegos de combinación',
-        slideshow_manager: 'Administrador de presentaciones',
-        quizshow_manager: 'Administrador de concursos',
-        multiple_choice_manager: 'Administrador de opciones múltiples',
-        wordjumble_manager: 'Administrador de revoltijos de palabras',
-        seven_strikes_manager: 'Gerente de los Siete Golpes',
-        crossword_puzzle_manager: 'Administrador de crucigramas',
+        block_builder: 'Constructor de bloques',
     },
     errors: {
         input_limitations: 'Måste vara mindre än {0} tecken.',

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/i18n/sv-SE/shared/settings.ts

@@ -1,15 +1,6 @@
 export default {
     title: {
-        card_manager: ' Flashcard Slides Manager ',
-        bucket_manager: ' Bucket Game Manager',
-        sorting_manager: 'Sorteringsspelhanteraren',
-        matching_game_manager: ' Matchande spelhanterare',
-        slideshow_manager: 'Bildspelshanteraren',
-        quizshow_manager: 'Quizshow Manager',
-        multiple_choice_manager: 'Flervalschef',
-        wordjumble_manager: 'Ord virrvarr manager',
-        seven_strikes_manager: 'Sju strejker manager',
-        crossword_puzzle_manager: 'Korsordshanterare',
+        block_builder: 'Blockbyggare',
     },
     errors: {
         input_limitations: 'Måste vara mindre än {0} tecken.',

package/package.json

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

package/plugin.js

@@ -135,7 +135,7 @@ export default {
                 context: ['block.games-flash-card'],
                 metadata: {
                     icon: 'mdi-cog',
-                    name: 'windward.games.shared.settings.title.card_manager',
+                    name: 'windward.games.shared.settings.title.block_builder',
                 },
             },
             {
@@ -144,7 +144,7 @@ export default {
                 context: ['block.games-bucket'],
                 metadata: {
                     icon: 'mdi-cog',
-                    name: 'windward.games.shared.settings.title.bucket_manager',
+                    name: 'windward.games.shared.settings.title.block_builder',
                 },
             },
             {
@@ -153,7 +153,7 @@ export default {
                 context: ['block.games-sorting'],
                 metadata: {
                     icon: 'mdi-cog',
-                    name: 'windward.games.shared.settings.title.sorting_manager',
+                    name: 'windward.games.shared.settings.title.block_builder',
                 },
             },
             {
@@ -162,7 +162,7 @@ export default {
                 context: ['block.games-slideshow'],
                 metadata: {
                     icon: 'mdi-cog',
-                    name: 'windward.games.shared.settings.title.slideshow_manager',
+                    name: 'windward.games.shared.settings.title.block_builder',
                 },
             },
             {
@@ -171,7 +171,7 @@ export default {
                 context: ['block.games-matching-game'],
                 metadata: {
                     icon: 'mdi-cog',
-                    name: 'windward.games.shared.settings.title.matching_game_manager',
+                    name: 'windward.games.shared.settings.title.block_builder',
                 },
             },
             {
@@ -180,7 +180,7 @@ export default {
                 context: ['block.games-quizshow-game'],
                 metadata: {
                     icon: 'mdi-cog',
-                    name: 'windward.games.shared.settings.title.quizshow_manager',
+                    name: 'windward.games.shared.settings.title.block_builder',
                 },
             },
             {
@@ -189,7 +189,7 @@ export default {
                 context: ['block.games-multiple-choice'],
                 metadata: {
                     icon: 'mdi-cog',
-                    name: 'windward.games.shared.settings.title.multiple_choice_manager',
+                    name: 'windward.games.shared.settings.title.block_builder',
                 },
             },
             {
@@ -198,7 +198,7 @@ export default {
                 context: ['block.games-wordjumble-game'],
                 metadata: {
                     icon: 'mdi-cog',
-                    name: 'windward.games.shared.settings.title.wordjumble_manager',
+                    name: 'windward.games.shared.settings.title.block_builder',
                 },
             },
             {
@@ -207,7 +207,7 @@ export default {
                 context: ['block.games-seven-strikes-game'],
                 metadata: {
                     icon: 'mdi-cog',
-                    name: 'windward.games.shared.settings.title.seven_strikes_manager',
+                    name: 'windward.games.shared.settings.title.block_builder',
                 },
             },
             {
@@ -216,7 +216,7 @@ export default {
                 context: ['block.games-crossword-puzzle-game'],
                 metadata: {
                     icon: 'mdi-cog',
-                    name: 'windward.games.shared.settings.title.crossword_puzzle_manager',
+                    name: 'windward.games.shared.settings.title.block_builder',
                 },
             },
         ],