feat(data-grid): support manual reference display values

apps/desktop/src/i18n/locales/en.ts

@@ -1717,9 +1717,25 @@ export default {
     formatterMask: "Mask text",
     formatterForeignKeyDisplay: "Foreign key label",
     formatterForeignKeyTarget: "Referenced key",
+    formatterForeignKeyManualHint: "This column has no single-column foreign key. Select the referenced table and matching column manually.",
+    formatterForeignKeySchema: "Schema",
+    formatterForeignKeySchemaPlaceholder: "Select a schema",
+    formatterForeignKeySearchSchema: "Search schemas...",
+    formatterForeignKeyNoSchemas: "No schemas available",
+    formatterForeignKeyTable: "Referenced table",
+    formatterForeignKeyTablePlaceholder: "Select a referenced table",
+    formatterForeignKeySearchTable: "Search referenced tables...",
+    formatterForeignKeyNoTables: "No referenced tables available",
+    formatterForeignKeyReferenceColumn: "Matching column",
+    formatterForeignKeyReferenceColumnPlaceholder: "Select the column matching this value",
+    formatterForeignKeyReferenceMetadataUnavailable: "Could not verify matching-column uniqueness: {error}",
+    formatterForeignKeyReferenceInvalid: "This column is missing or is not a valid single-column unique key. Select another column.",
+    formatterForeignKeyReferenceUnavailable: "The target table has no usable single-column unique key.",
     formatterForeignKeyDisplayColumn: "Display column",
     formatterForeignKeyDisplayColumnPlaceholder: "Select a display column",
-    formatterForeignKeyHint: "Loads labels for keys on the current page. Editing, filtering, sorting, copying, and export continue to use raw values.",
+    formatterForeignKeyFilter: "Limit referenced rows",
+    formatterForeignKeyFilterColumnPlaceholder: "Select a filter column",
+    formatterForeignKeyHint: "Loads labels for matching keys on the current page. Editing, filtering, sorting, copying, and export continue to use raw values.",
     formatterCustomTemplate: "Custom template",
     formatterTimestampUnit: "Timestamp unit",
     formatterUnitAuto: "Auto",

apps/desktop/src/i18n/locales/es.ts

@@ -1601,9 +1601,25 @@ export default withEnglishFallback({
     formatterMask: "Enmascarar texto",
     formatterForeignKeyDisplay: "Etiqueta de clave externa",
     formatterForeignKeyTarget: "Clave referenciada",
+    formatterForeignKeyManualHint: "Esta columna no tiene una clave externa de una sola columna. Seleccione manualmente la tabla y la columna relacionadas.",
+    formatterForeignKeySchema: "Esquema",
+    formatterForeignKeySchemaPlaceholder: "Seleccionar un esquema",
+    formatterForeignKeySearchSchema: "Buscar esquemas...",
+    formatterForeignKeyNoSchemas: "No hay esquemas disponibles",
+    formatterForeignKeyTable: "Tabla referenciada",
+    formatterForeignKeyTablePlaceholder: "Seleccionar una tabla referenciada",
+    formatterForeignKeySearchTable: "Buscar tablas referenciadas...",
+    formatterForeignKeyNoTables: "No hay tablas referenciadas disponibles",
+    formatterForeignKeyReferenceColumn: "Columna relacionada",
+    formatterForeignKeyReferenceColumnPlaceholder: "Seleccionar la columna que coincide con este valor",
+    formatterForeignKeyReferenceMetadataUnavailable: "No se pudo verificar la unicidad de la columna relacionada: {error}",
+    formatterForeignKeyReferenceInvalid: "La columna no existe o no es una clave única válida de una sola columna. Seleccione otra columna.",
+    formatterForeignKeyReferenceUnavailable: "La tabla de destino no tiene ninguna clave única utilizable de una sola columna.",
     formatterForeignKeyDisplayColumn: "Columna de visualización",
     formatterForeignKeyDisplayColumnPlaceholder: "Seleccionar una columna",
-    formatterForeignKeyHint: "Carga etiquetas para las claves de la página actual. La edición, el filtrado, la ordenación, la copia y la exportación usan los valores originales.",
+    formatterForeignKeyFilter: "Limitar filas referenciadas",
+    formatterForeignKeyFilterColumnPlaceholder: "Seleccionar una columna de filtro",
+    formatterForeignKeyHint: "Carga etiquetas para las claves coincidentes de la página actual. La edición, el filtrado, la ordenación, la copia y la exportación usan los valores originales.",
     formatterCustomTemplate: "Plantilla personalizada",
     formatterTimestampUnit: "Unidad de marca de tiempo",
     formatterUnitAuto: "Automático",

apps/desktop/src/i18n/locales/it.ts

@@ -1599,9 +1599,25 @@ export default withEnglishFallback({
     formatterMask: "Maschera testo",
     formatterForeignKeyDisplay: "Etichetta chiave esterna",
     formatterForeignKeyTarget: "Chiave referenziata",
+    formatterForeignKeyManualHint: "Questa colonna non ha una chiave esterna su una sola colonna. Seleziona manualmente la tabella e la colonna correlate.",
+    formatterForeignKeySchema: "Schema",
+    formatterForeignKeySchemaPlaceholder: "Seleziona uno schema",
+    formatterForeignKeySearchSchema: "Cerca schemi...",
+    formatterForeignKeyNoSchemas: "Nessuno schema disponibile",
+    formatterForeignKeyTable: "Tabella referenziata",
+    formatterForeignKeyTablePlaceholder: "Seleziona una tabella referenziata",
+    formatterForeignKeySearchTable: "Cerca tabelle referenziate...",
+    formatterForeignKeyNoTables: "Nessuna tabella referenziata disponibile",
+    formatterForeignKeyReferenceColumn: "Colonna correlata",
+    formatterForeignKeyReferenceColumnPlaceholder: "Seleziona la colonna corrispondente a questo valore",
+    formatterForeignKeyReferenceMetadataUnavailable: "Impossibile verificare l'unicità della colonna correlata: {error}",
+    formatterForeignKeyReferenceInvalid: "La colonna non esiste o non è una chiave univoca valida a colonna singola. Seleziona un'altra colonna.",
+    formatterForeignKeyReferenceUnavailable: "La tabella di destinazione non ha chiavi univoche utilizzabili a colonna singola.",
     formatterForeignKeyDisplayColumn: "Colonna visualizzata",
     formatterForeignKeyDisplayColumnPlaceholder: "Seleziona una colonna",
-    formatterForeignKeyHint: "Carica le etichette per le chiavi della pagina corrente. Modifica, filtro, ordinamento, copia ed esportazione usano i valori originali.",
+    formatterForeignKeyFilter: "Limita le righe referenziate",
+    formatterForeignKeyFilterColumnPlaceholder: "Seleziona una colonna filtro",
+    formatterForeignKeyHint: "Carica le etichette per le chiavi corrispondenti della pagina corrente. Modifica, filtro, ordinamento, copia ed esportazione usano i valori originali.",
     formatterCustomTemplate: "Modello personalizzato",
     formatterTimestampUnit: "Unità timestamp",
     formatterUnitAuto: "Auto",

apps/desktop/src/i18n/locales/ja.ts

@@ -1617,9 +1617,25 @@ export default withEnglishFallback({
     formatterMask: "テキストをマスク",
     formatterForeignKeyDisplay: "外部キーラベル",
     formatterForeignKeyTarget: "参照キー",
+    formatterForeignKeyManualHint: "この列には単一列の外部キーがありません。参照テーブルと対応列を手動で指定してください。",
+    formatterForeignKeySchema: "スキーマ",
+    formatterForeignKeySchemaPlaceholder: "スキーマを選択",
+    formatterForeignKeySearchSchema: "スキーマを検索...",
+    formatterForeignKeyNoSchemas: "利用可能なスキーマがありません",
+    formatterForeignKeyTable: "参照テーブル",
+    formatterForeignKeyTablePlaceholder: "参照テーブルを選択",
+    formatterForeignKeySearchTable: "参照テーブルを検索...",
+    formatterForeignKeyNoTables: "利用可能な参照テーブルがありません",
+    formatterForeignKeyReferenceColumn: "対応列",
+    formatterForeignKeyReferenceColumnPlaceholder: "現在の値に対応する列を選択",
+    formatterForeignKeyReferenceMetadataUnavailable: "対応列の一意性を確認できませんでした：{error}",
+    formatterForeignKeyReferenceInvalid: "この列は存在しないか、有効な単一列の一意キーではありません。別の列を選択してください。",
+    formatterForeignKeyReferenceUnavailable: "対象テーブルに利用可能な単一列の一意キーがありません。",
     formatterForeignKeyDisplayColumn: "表示列",
     formatterForeignKeyDisplayColumnPlaceholder: "表示列を選択",
-    formatterForeignKeyHint: "現在のページのキーに対応するラベルのみ読み込みます。編集、フィルター、並べ替え、コピー、エクスポートでは元の値を使用します。",
+    formatterForeignKeyFilter: "参照行を絞り込む",
+    formatterForeignKeyFilterColumnPlaceholder: "フィルター列を選択",
+    formatterForeignKeyHint: "現在のページの対応キーに対するラベルのみ読み込みます。編集、フィルター、並べ替え、コピー、エクスポートでは元の値を使用します。",
     formatterCustomTemplate: "カスタムテンプレート",
     formatterTimestampUnit: "タイムスタンプ単位",
     formatterUnitAuto: "自動",

apps/desktop/src/i18n/locales/pt-BR.ts

@@ -1601,9 +1601,25 @@ export default withEnglishFallback({
     formatterMask: "Mascarar texto",
     formatterForeignKeyDisplay: "Rótulo de chave estrangeira",
     formatterForeignKeyTarget: "Chave referenciada",
+    formatterForeignKeyManualHint: "Esta coluna não possui uma chave estrangeira de coluna única. Selecione manualmente a tabela e a coluna relacionadas.",
+    formatterForeignKeySchema: "Schema",
+    formatterForeignKeySchemaPlaceholder: "Selecione um schema",
+    formatterForeignKeySearchSchema: "Pesquisar schemas...",
+    formatterForeignKeyNoSchemas: "Nenhum schema disponível",
+    formatterForeignKeyTable: "Tabela referenciada",
+    formatterForeignKeyTablePlaceholder: "Selecione uma tabela referenciada",
+    formatterForeignKeySearchTable: "Pesquisar tabelas referenciadas...",
+    formatterForeignKeyNoTables: "Nenhuma tabela referenciada disponível",
+    formatterForeignKeyReferenceColumn: "Coluna relacionada",
+    formatterForeignKeyReferenceColumnPlaceholder: "Selecione a coluna correspondente a este valor",
+    formatterForeignKeyReferenceMetadataUnavailable: "Não foi possível verificar a exclusividade da coluna relacionada: {error}",
+    formatterForeignKeyReferenceInvalid: "A coluna não existe ou não é uma chave exclusiva válida de uma única coluna. Selecione outra coluna.",
+    formatterForeignKeyReferenceUnavailable: "A tabela de destino não tem uma chave exclusiva utilizável de uma única coluna.",
     formatterForeignKeyDisplayColumn: "Coluna de exibição",
     formatterForeignKeyDisplayColumnPlaceholder: "Selecione uma coluna",
-    formatterForeignKeyHint: "Carrega rótulos para as chaves da página atual. Edição, filtro, ordenação, cópia e exportação continuam usando os valores originais.",
+    formatterForeignKeyFilter: "Limitar linhas referenciadas",
+    formatterForeignKeyFilterColumnPlaceholder: "Selecione uma coluna de filtro",
+    formatterForeignKeyHint: "Carrega rótulos para as chaves correspondentes da página atual. Edição, filtro, ordenação, cópia e exportação continuam usando os valores originais.",
     formatterCustomTemplate: "Template personalizado",
     formatterTimestampUnit: "Unidade do timestamp",
     formatterUnitAuto: "Automático",

apps/desktop/src/i18n/locales/zh-CN.ts

@@ -1642,9 +1642,25 @@ export default withEnglishFallback({
     formatterMask: "文本脱敏",
     formatterForeignKeyDisplay: "外键显示值",
     formatterForeignKeyTarget: "引用键",
+    formatterForeignKeyManualHint: "当前字段没有单列外键。请手动指定引用表和关联字段。",
+    formatterForeignKeySchema: "Schema",
+    formatterForeignKeySchemaPlaceholder: "选择 Schema",
+    formatterForeignKeySearchSchema: "搜索 Schema...",
+    formatterForeignKeyNoSchemas: "没有可用的 Schema",
+    formatterForeignKeyTable: "引用表",
+    formatterForeignKeyTablePlaceholder: "选择引用表",
+    formatterForeignKeySearchTable: "搜索引用表...",
+    formatterForeignKeyNoTables: "没有可用的引用表",
+    formatterForeignKeyReferenceColumn: "关联字段",
+    formatterForeignKeyReferenceColumnPlaceholder: "选择与当前字段匹配的字段",
+    formatterForeignKeyReferenceMetadataUnavailable: "无法验证关联字段唯一性：{error}",
+    formatterForeignKeyReferenceInvalid: "该字段不存在，或不是有效的单列唯一键。请重新选择。",
+    formatterForeignKeyReferenceUnavailable: "目标表没有可用的单列唯一键。",
     formatterForeignKeyDisplayColumn: "显示字段",
     formatterForeignKeyDisplayColumnPlaceholder: "选择用于显示的字段",
-    formatterForeignKeyHint: "仅加载当前页外键对应的显示值；编辑、筛选、排序、复制和导出仍使用原始值。",
+    formatterForeignKeyFilter: "限定引用数据",
+    formatterForeignKeyFilterColumnPlaceholder: "选择筛选字段",
+    formatterForeignKeyHint: "仅加载当前页关联键对应的显示值；编辑、筛选、排序、复制和导出仍使用原始值。",
     formatterCustomTemplate: "自定义模板",
     formatterTimestampUnit: "时间戳单位",
     formatterUnitAuto: "自动",

apps/desktop/src/i18n/locales/zh-TW.ts

@@ -1600,9 +1600,25 @@ export default withEnglishFallback({
     formatterMask: "文字遮罩",
     formatterForeignKeyDisplay: "外鍵顯示值",
     formatterForeignKeyTarget: "引用鍵",
+    formatterForeignKeyManualHint: "目前欄位沒有單欄外鍵。請手動指定引用資料表和關聯欄位。",
+    formatterForeignKeySchema: "Schema",
+    formatterForeignKeySchemaPlaceholder: "選擇 Schema",
+    formatterForeignKeySearchSchema: "搜尋 Schema...",
+    formatterForeignKeyNoSchemas: "沒有可用的 Schema",
+    formatterForeignKeyTable: "引用資料表",
+    formatterForeignKeyTablePlaceholder: "選擇引用資料表",
+    formatterForeignKeySearchTable: "搜尋引用資料表...",
+    formatterForeignKeyNoTables: "沒有可用的引用資料表",
+    formatterForeignKeyReferenceColumn: "關聯欄位",
+    formatterForeignKeyReferenceColumnPlaceholder: "選擇與目前欄位匹配的欄位",
+    formatterForeignKeyReferenceMetadataUnavailable: "無法驗證關聯欄位的唯一性：{error}",
+    formatterForeignKeyReferenceInvalid: "此欄位不存在，或不是有效的單欄唯一鍵。請重新選擇。",
+    formatterForeignKeyReferenceUnavailable: "目標資料表沒有可用的單欄唯一鍵。",
     formatterForeignKeyDisplayColumn: "顯示欄位",
     formatterForeignKeyDisplayColumnPlaceholder: "選擇用於顯示的欄位",
-    formatterForeignKeyHint: "僅載入目前頁面外鍵對應的顯示值；編輯、篩選、排序、複製與匯出仍使用原始值。",
+    formatterForeignKeyFilter: "限定引用資料",
+    formatterForeignKeyFilterColumnPlaceholder: "選擇篩選欄位",
+    formatterForeignKeyHint: "僅載入目前頁面關聯鍵對應的顯示值；編輯、篩選、排序、複製與匯出仍使用原始值。",
     formatterCustomTemplate: "自訂範本",
     formatterTimestampUnit: "時間戳單位",
     formatterUnitAuto: "自動",