fix(api): broken text reading, notes were not displaying and romanization was displaying.

Author: HugoFara

src/backend/Core/Repository/LanguageRepository.php

@@ -81,7 +81,7 @@ protected function mapToEntity(array $row): Language
             (bool) ($row['LgSplitEachChar'] ?? false),
             (bool) ($row['LgRightToLeft'] ?? false),
             (string) ($row['LgTTSVoiceAPI'] ?? ''),
-            (bool) ($row['LgShowRomanization'] ?? true)
+            (bool) ($row['LgShowRomanization'] ?? false)
         );
     }
 

src/backend/Services/LanguageService.php

@@ -943,7 +943,7 @@ private function normalizeLanguageData(array $data): array
             'LgSplitEachChar' => !empty($data['splitEachChar']),
             'LgRightToLeft' => !empty($data['rightToLeft']),
             'LgTTSVoiceAPI' => $data['ttsVoiceApi'] ?? '',
-            'LgShowRomanization' => $data['showRomanization'] ?? true,
+            'LgShowRomanization' => $data['showRomanization'] ?? false,
         ];
     }
 

src/backend/Views/Text/word_modal.php

@@ -232,6 +232,24 @@ class="textarea"
               <p class="help">Use {curly braces} around the term</p>
             </div>
 
+            <!-- Notes -->
+            <div class="field">
+              <label class="label is-small">Notes</label>
+              <div class="control">
+                <textarea
+                  class="textarea"
+                  :class="{ 'is-danger': formStore.errors.notes }"
+                  x-model="formStore.formData.notes"
+                  @blur="validateField('notes')"
+                  rows="2"
+                  placeholder="Personal notes about this term..."
+                ></textarea>
+              </div>
+              <template x-if="formStore.errors.notes">
+                <p class="help is-danger" x-text="formStore.errors.notes"></p>
+              </template>
+            </div>
+
             <!-- Status -->
             <div class="field">
               <label class="label is-small">Status</label>

src/frontend/js/api/terms.ts

@@ -150,6 +150,7 @@ export interface TermCreateFullRequest {
   translation: string;
   romanization?: string;
   sentence?: string;
+  notes?: string;
   status: number;
   tags?: string[];
 }
@@ -161,6 +162,7 @@ export interface TermUpdateFullRequest {
   translation: string;
   romanization?: string;
   sentence?: string;
+  notes?: string;
   status: number;
   tags?: string[];
 }
@@ -215,6 +217,7 @@ export interface TermForEdit {
   translation: string;
   romanization: string;
   sentence: string;
+  notes: string;
   status: number;
   tags: string[];
 }

src/frontend/js/core/api_client.ts

@@ -25,7 +25,7 @@ export interface ApiClientConfig {
 }
 
 const defaultConfig: ApiClientConfig = {
-  baseUrl: '/api.php/v1',
+  baseUrl: '/api/v1',
   defaultHeaders: {
     'Content-Type': 'application/json',
     Accept: 'application/json'

src/frontend/js/reading/stores/word_form_store.ts

@@ -25,6 +25,7 @@ export interface WordFormData {
   translation: string;
   romanization: string;
   sentence: string;
+  notes: string;
   status: number;
   tags: string[];
 }
@@ -36,6 +37,7 @@ export interface ValidationErrors {
   translation: string | null;
   romanization: string | null;
   sentence: string | null;
+  notes: string | null;
   general: string | null;
 }
 
@@ -103,6 +105,7 @@ function createEmptyFormData(): WordFormData {
     translation: '',
     romanization: '',
     sentence: '',
+    notes: '',
     status: 1,
     tags: []
   };
@@ -116,6 +119,7 @@ function createEmptyErrors(): ValidationErrors {
     translation: null,
     romanization: null,
     sentence: null,
+    notes: null,
     general: null
   };
 }
@@ -180,6 +184,7 @@ function createWordFormStore(): WordFormStoreState {
         this.formData.translation !== this.originalData.translation ||
         this.formData.romanization !== this.originalData.romanization ||
         this.formData.sentence !== this.originalData.sentence ||
+        this.formData.notes !== this.originalData.notes ||
         this.formData.status !== this.originalData.status ||
         !arraysEqual(this.formData.tags, this.originalData.tags)
       );
@@ -193,6 +198,7 @@ function createWordFormStore(): WordFormStoreState {
         this.errors.translation === null &&
         this.errors.romanization === null &&
         this.errors.sentence === null &&
+        this.errors.notes === null &&
         this.errors.general === null
       );
     },
@@ -247,6 +253,7 @@ function createWordFormStore(): WordFormStoreState {
           translation: data.term.translation === '*' ? '' : data.term.translation,
           romanization: data.term.romanization,
           sentence: data.term.sentence,
+          notes: data.term.notes || '',
           status: data.term.status,
           tags: [...data.term.tags]
         };
@@ -292,6 +299,7 @@ function createWordFormStore(): WordFormStoreState {
       this.validateField('translation');
       this.validateField('romanization');
       this.validateField('sentence');
+      this.validateField('notes');
       return this.isValid;
     },
 
@@ -323,6 +331,14 @@ function createWordFormStore(): WordFormStoreState {
             this.errors.sentence = null;
           }
           break;
+
+        case 'notes':
+          if (this.formData.notes.length > 1000) {
+            this.errors.notes = 'Notes must be 1000 characters or less';
+          } else {
+            this.errors.notes = null;
+          }
+          break;
       }
     },
 
@@ -349,6 +365,7 @@ function createWordFormStore(): WordFormStoreState {
             translation: this.formData.translation,
             romanization: this.formData.romanization,
             sentence: this.formData.sentence,
+            notes: this.formData.notes,
             status: this.formData.status,
             tags: this.formData.tags
           };
@@ -365,6 +382,7 @@ function createWordFormStore(): WordFormStoreState {
             translation: this.formData.translation,
             romanization: this.formData.romanization,
             sentence: this.formData.sentence,
+            notes: this.formData.notes,
             status: this.formData.status,
             tags: this.formData.tags
           };

src/frontend/js/reading/text_renderer.ts

@@ -79,7 +79,8 @@ function buildWordDataAttributes(word: WordData): Record<string, string> {
     'data_pos': String(word.position),
     'data_order': String(word.position),
     'data_status': String(word.status),
-    'data_wid': word.wordId ? String(word.wordId) : ''
+    'data_wid': word.wordId ? String(word.wordId) : '',
+    'data_hex': word.hex
   };
 
   if (word.translation) {