fix: KWIC download when row.structs missing

Fixes #492

Author: arildm

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+## Fixed
+
+- KWIC download sometimes fails because row.structs is optional [#492](https://github.com/spraakbanken/korp-frontend/issues/492)
+
 ## [9.12.0] – 2025-10-29
 
 ### Added

app/scripts/backend/types/common.ts

@@ -54,7 +54,7 @@ export type ApiKwic = {
     /** An object for each token in the context, with attribute values for that token */
     tokens: Token[]
     /** Attribute values for the context (e.g. sentence) */
-    structs: Record<string, any>
+    structs?: Record<string, any>
     /** Specifies the position of the match in the context. If `in_order` is false, `match` will consist of a list of match objects, one per highlighted word */
     match: KwicMatch | KwicMatch[]
     /** Hits from aligned corpora if available, otherwise omitted */

app/scripts/components/kwic/kwic.ts

@@ -454,7 +454,7 @@ angular.module("korpApp").component("kwic", {
 
                 if ($ctrl.active) {
                     statemachine.send("SELECT_WORD", {
-                        sentenceData: scope.sentence.structs,
+                        sentenceData: scope.sentence.structs || {},
                         wordData: scope.word,
                         corpus: scope.sentence.corpus.toLowerCase(),
                         tokens: scope.sentence.tokens,

app/scripts/components/text/results-text.ts

@@ -5,6 +5,7 @@ import { CorpusTransformed } from "@/settings/config-transformed.types"
 import { html } from "@/util"
 import { ReaderToken, TextReaderData, TextReaderDataContainer, TextTask } from "@/task/text-task"
 import { kebabCase } from "lodash"
+import { SelectWordEvent } from "@/statemachine/types"
 
 type ResultsTextController = IController & {
     active: boolean
@@ -74,12 +75,12 @@ angular.module("korpApp").component("resultsText", {
 
             $scope.wordClick = (token) => {
                 statemachine.send("SELECT_WORD", {
-                    sentenceData: $scope.data.document.structs,
+                    sentenceData: $scope.data.document.structs || {},
                     wordData: token.attrs,
                     corpus: $scope.data.corpus,
                     tokens: "currentSentence" in token ? token.currentSentence : undefined,
                     inReadingMode: true,
-                })
+                } as SelectWordEvent)
                 $scope.selectedToken = token
             }
         },

app/scripts/kwic/kwic_download.ts

@@ -58,7 +58,7 @@ function transformDataToAnnotations(data: AnnotationsRow[], searchInfo: string[]
     for (const row of data) {
         if (isKwic(row)) {
             const textAttributes: string[] = []
-            for (let attrName in row.structs) {
+            for (const attrName in row.structs) {
                 const attrValue = row.structs[attrName]
                 textAttributes.push(attrName + ': "' + attrValue + '"')
             }
@@ -125,7 +125,7 @@ function transformDataToKWIC(data: Row[], searchInfo: string[]) {
                 }
             }
             for (const attrName of structHeaders) {
-                if (attrName in row.structs) {
+                if (row.structs && attrName in row.structs) {
                     structs.push(row.structs[attrName])
                 } else {
                     structs.push("")