@semiont/react-ui 0.3.0 → 0.3.2

package/src/components/modals/ReferenceWizardModal.tsx

@@ -55,6 +55,8 @@ export interface ReferenceWizardModalProps {
     connectionsLabel: string;
     citedByLabel: string;
     siblingTypesLabel: string;
+    userHintLabel: string;
+    userHintPlaceholder: string;
     loadingContext: string;
     failedContext: string;
     cancel: string;
@@ -102,12 +104,14 @@ export function ReferenceWizardModal({
 }: ReferenceWizardModalProps) {
   const [wizardStep, setWizardStep] = useState<WizardStep>({ step: 'gather' });
   const [isSearching, setIsSearching] = useState(false);
+  const [userHint, setUserHint] = useState('');
 
   // Reset to gather step when modal opens
   useEffect(() => {
     if (isOpen) {
       setWizardStep({ step: 'gather' });
       setIsSearching(false);
+      setUserHint('');
     }
   }, [isOpen]);
 
@@ -135,9 +139,10 @@ export function ReferenceWizardModal({
 
   const handleCompose = useCallback(() => {
     if (!context || !annotationId || !resourceId) return;
-    onComposeNavigate(context, annotationId, resourceId, defaultTitle, entityTypes);
+    const contextWithHint = userHint ? { ...context, userHint } : context;
+    onComposeNavigate(contextWithHint, annotationId, resourceId, defaultTitle, entityTypes);
     onClose();
-  }, [context, annotationId, resourceId, defaultTitle, entityTypes, onComposeNavigate, onClose]);
+  }, [context, annotationId, resourceId, defaultTitle, entityTypes, onComposeNavigate, onClose, userHint]);
 
   const handleBackToGather = useCallback(() => {
     setWizardStep({ step: 'gather' });
@@ -146,14 +151,15 @@ export function ReferenceWizardModal({
   const handleSearchSubmit = useCallback((config: SearchConfig) => {
     if (!annotationId || !context) return;
     setIsSearching(true);
+    const contextWithHint = userHint ? { ...context, userHint } : context;
     eventBus.get('bind:search-requested').next({
       referenceId: annotationId,
-      context,
+      context: contextWithHint,
       limit: config.limit,
       useSemanticScoring: config.useSemanticScoring,
     });
     // Stay on configure-search until results arrive (subscription above handles transition)
-  }, [annotationId, context, eventBus]);
+  }, [annotationId, context, eventBus, userHint]);
 
   const handleGenerateSubmit = useCallback((config: GenerationConfig) => {
     if (!annotationId) return;
@@ -221,6 +227,8 @@ export function ReferenceWizardModal({
                     context={context}
                     contextLoading={contextLoading}
                     contextError={contextError}
+                    userHint={userHint}
+                    onUserHintChange={setUserHint}
                     onCancel={onClose}
                     onBind={handleBind}
                     onGenerate={handleGenerate}
@@ -236,6 +244,8 @@ export function ReferenceWizardModal({
                       connectionsLabel: t.connectionsLabel,
                       citedByLabel: t.citedByLabel,
                       siblingTypesLabel: t.siblingTypesLabel,
+                      userHintLabel: t.userHintLabel,
+                      userHintPlaceholder: t.userHintPlaceholder,
                       loadingContext: t.loadingContext,
                       failedContext: t.failedContext,
                       cancel: t.cancel,
@@ -313,6 +323,8 @@ export function ReferenceWizardModal({
                       connectionsLabel: t.connectionsLabel,
                       citedByLabel: t.citedByLabel,
                       siblingTypesLabel: t.siblingTypesLabel,
+                      userHintLabel: t.userHintLabel,
+                      userHintPlaceholder: t.userHintPlaceholder,
                     }}
                   />
                 )}

package/src/components/resource/panels/ReferencesPanel.css

@@ -118,9 +118,18 @@
   animation: semiont-icon-pulse 1.5s ease-in-out infinite;
 }
 
+[data-theme="dark"] .semiont-reference-icon[data-generating="true"] {
+  animation: semiont-icon-pulse-dark 1.5s ease-in-out infinite;
+}
+
 @keyframes semiont-icon-pulse {
-  0%, 100% { transform: scale(1); }
-  50% { transform: scale(1.2); }
+  0%, 100% { transform: scale(1); box-shadow: 0 0 8px 2px rgba(59, 130, 246, 0.5); }
+  50% { transform: scale(1.2); box-shadow: 0 0 16px 4px rgba(59, 130, 246, 0.8); }
+}
+
+@keyframes semiont-icon-pulse-dark {
+  0%, 100% { transform: scale(1); box-shadow: 0 0 8px 2px rgba(96, 165, 250, 0.6); }
+  50% { transform: scale(1.2); box-shadow: 0 0 16px 4px rgba(96, 165, 250, 0.9); }
 }
 
 /* Hover-reveal unlink button */

package/src/features/resource-viewer/components/ResourceViewerPage.tsx

@@ -698,6 +698,8 @@ export function ResourceViewerPage({
           connectionsLabel: tw('connectionsLabel'),
           citedByLabel: tw('citedByLabel'),
           siblingTypesLabel: tw('siblingTypesLabel'),
+          userHintLabel: tw('userHintLabel'),
+          userHintPlaceholder: tw('userHintPlaceholder'),
           loadingContext: tw('loadingContext'),
           failedContext: tw('failedContext'),
           cancel: tw('cancel'),

package/translations/ar.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "الاتصالات",
     "citedByLabel": "مُستشهد به من قِبل",
     "siblingTypesLabel": "الأنواع الشقيقة",
+    "userHintLabel": "تلميح",
+    "userHintPlaceholder": "صف ما يشير إليه هذا التعليق التوضيحي...",
     "loadingContext": "جارٍ جمع السياق...",
     "failedContext": "فشل في جمع السياق",
     "cancel": "إلغاء",

package/translations/bn.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "সংযোগ",
     "citedByLabel": "উদ্ধৃতকারী",
     "siblingTypesLabel": "সহোদর ধরন",
+    "userHintLabel": "ইঙ্গিত",
+    "userHintPlaceholder": "এই টীকাটি কী বোঝায় তা বর্ণনা করুন...",
     "loadingContext": "প্রসঙ্গ সংগ্রহ হচ্ছে...",
     "failedContext": "প্রসঙ্গ সংগ্রহ ব্যর্থ",
     "cancel": "বাতিল করুন",

package/translations/cs.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Připojení",
     "citedByLabel": "Citováno",
     "siblingTypesLabel": "Příbuzné typy",
+    "userHintLabel": "Nápověda",
+    "userHintPlaceholder": "Popište, na co se tato anotace vztahuje...",
     "loadingContext": "Shromažďování kontextu...",
     "failedContext": "Nepodařilo se shromáždit kontext",
     "cancel": "Zrušit",

package/translations/da.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Forbindelser",
     "citedByLabel": "Citeret af",
     "siblingTypesLabel": "Søskendetyper",
+    "userHintLabel": "Hint",
+    "userHintPlaceholder": "Beskriv hvad denne annotation refererer til...",
     "loadingContext": "Indsamler kontekst...",
     "failedContext": "Kunne ikke indsamle kontekst",
     "cancel": "Annuller",

package/translations/de.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Verbindungen",
     "citedByLabel": "Zitiert von",
     "siblingTypesLabel": "Verwandte Typen",
+    "userHintLabel": "Hinweis",
+    "userHintPlaceholder": "Beschreiben Sie, worauf sich diese Annotation bezieht...",
     "loadingContext": "Kontext wird gesammelt...",
     "failedContext": "Kontext konnte nicht gesammelt werden",
     "cancel": "Abbrechen",

package/translations/el.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Συνδέσεις",
     "citedByLabel": "Αναφέρεται από",
     "siblingTypesLabel": "Αδελφοί Τύποι",
+    "userHintLabel": "Υπόδειξη",
+    "userHintPlaceholder": "Περιγράψτε σε τι αναφέρεται αυτός ο σχολιασμός...",
     "loadingContext": "Συλλογή πλαισίου...",
     "failedContext": "Αποτυχία συλλογής πλαισίου",
     "cancel": "Ακύρωση",

package/translations/en.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Connections",
     "citedByLabel": "Cited By",
     "siblingTypesLabel": "Sibling Types",
+    "userHintLabel": "Hint",
+    "userHintPlaceholder": "Describe what this annotation refers to...",
     "loadingContext": "Gathering context...",
     "failedContext": "Failed to gather context",
     "cancel": "Cancel",

package/translations/es.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Conexiones",
     "citedByLabel": "Citado por",
     "siblingTypesLabel": "Tipos Hermanos",
+    "userHintLabel": "Pista",
+    "userHintPlaceholder": "Describa a qué se refiere esta anotación...",
     "loadingContext": "Recopilando contexto...",
     "failedContext": "Error al recopilar contexto",
     "cancel": "Cancelar",

package/translations/fa.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "اتصالات",
     "citedByLabel": "ارجاع شده توسط",
     "siblingTypesLabel": "انواع هم‌سطح",
+    "userHintLabel": "راهنمایی",
+    "userHintPlaceholder": "توضیح دهید این حاشیه به چه چیزی اشاره دارد...",
     "loadingContext": "در حال جمع‌آوری زمینه...",
     "failedContext": "جمع‌آوری زمینه ناموفق بود",
     "cancel": "انصراف",

package/translations/fi.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Yhteydet",
     "citedByLabel": "Viittaajat",
     "siblingTypesLabel": "Sisartyypit",
+    "userHintLabel": "Vihje",
+    "userHintPlaceholder": "Kuvaile mihin tämä merkintä viittaa...",
     "loadingContext": "Kerätään kontekstia...",
     "failedContext": "Kontekstin kerääminen epäonnistui",
     "cancel": "Peruuta",

package/translations/fr.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Connexions",
     "citedByLabel": "Cité par",
     "siblingTypesLabel": "Types apparentés",
+    "userHintLabel": "Indice",
+    "userHintPlaceholder": "Décrivez ce à quoi cette annotation fait référence...",
     "loadingContext": "Collecte du contexte...",
     "failedContext": "Échec de la collecte du contexte",
     "cancel": "Annuler",

package/translations/he.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "חיבורים",
     "citedByLabel": "צוטט על ידי",
     "siblingTypesLabel": "סוגים אחים",
+    "userHintLabel": "רמז",
+    "userHintPlaceholder": "תאר למה ההערה הזו מתייחסת...",
     "loadingContext": "אוסף הקשר...",
     "failedContext": "איסוף ההקשר נכשל",
     "cancel": "ביטול",

package/translations/hi.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "कनेक्शन",
     "citedByLabel": "द्वारा उद्धृत",
     "siblingTypesLabel": "सहोदर प्रकार",
+    "userHintLabel": "संकेत",
+    "userHintPlaceholder": "वर्णन करें कि यह एनोटेशन किसे संदर्भित करता है...",
     "loadingContext": "संदर्भ एकत्र हो रहा है...",
     "failedContext": "संदर्भ एकत्र करने में विफल",
     "cancel": "रद्द करें",

package/translations/id.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Koneksi",
     "citedByLabel": "Dikutip Oleh",
     "siblingTypesLabel": "Tipe Saudara",
+    "userHintLabel": "Petunjuk",
+    "userHintPlaceholder": "Jelaskan apa yang dirujuk anotasi ini...",
     "loadingContext": "Mengumpulkan konteks...",
     "failedContext": "Gagal mengumpulkan konteks",
     "cancel": "Batal",

package/translations/it.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Connessioni",
     "citedByLabel": "Citato da",
     "siblingTypesLabel": "Tipi Correlati",
+    "userHintLabel": "Suggerimento",
+    "userHintPlaceholder": "Descrivi a cosa si riferisce questa annotazione...",
     "loadingContext": "Raccolta del contesto...",
     "failedContext": "Raccolta del contesto non riuscita",
     "cancel": "Annulla",

package/translations/ja.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "接続",
     "citedByLabel": "引用元",
     "siblingTypesLabel": "兄弟タイプ",
+    "userHintLabel": "ヒント",
+    "userHintPlaceholder": "このアノテーションが何を指すか説明してください...",
     "loadingContext": "コンテキストを収集中...",
     "failedContext": "コンテキストの収集に失敗しました",
     "cancel": "キャンセル",

package/translations/ko.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "연결",
     "citedByLabel": "인용처",
     "siblingTypesLabel": "형제 유형",
+    "userHintLabel": "힌트",
+    "userHintPlaceholder": "이 주석이 무엇을 가리키는지 설명하세요...",
     "loadingContext": "컨텍스트 수집 중...",
     "failedContext": "컨텍스트 수집 실패",
     "cancel": "취소",

package/translations/ms.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Sambungan",
     "citedByLabel": "Dipetik Oleh",
     "siblingTypesLabel": "Jenis Adik-Beradik",
+    "userHintLabel": "Petunjuk",
+    "userHintPlaceholder": "Terangkan apa yang dirujuk oleh anotasi ini...",
     "loadingContext": "Mengumpul konteks...",
     "failedContext": "Gagal mengumpul konteks",
     "cancel": "Batal",

package/translations/nl.json

@@ -346,6 +346,8 @@
     "connectionsLabel": "Verbindingen",
     "citedByLabel": "Geciteerd door",
     "siblingTypesLabel": "Verwante typen",
+    "userHintLabel": "Hint",
+    "userHintPlaceholder": "Beschrijf waar deze annotatie naar verwijst...",
     "loadingContext": "Context wordt verzameld...",
     "failedContext": "Context verzamelen mislukt",
     "cancel": "Annuleren",

package/translations/no.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Tilkoblinger",
     "citedByLabel": "Sitert av",
     "siblingTypesLabel": "Søskentyper",
+    "userHintLabel": "Hint",
+    "userHintPlaceholder": "Beskriv hva denne kommentaren refererer til...",
     "loadingContext": "Samler kontekst...",
     "failedContext": "Kunne ikke samle kontekst",
     "cancel": "Avbryt",

package/translations/pl.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Połączenia",
     "citedByLabel": "Cytowane przez",
     "siblingTypesLabel": "Typy pokrewne",
+    "userHintLabel": "Wskazówka",
+    "userHintPlaceholder": "Opisz, do czego odnosi się ta adnotacja...",
     "loadingContext": "Zbieranie kontekstu...",
     "failedContext": "Nie udało się zebrać kontekstu",
     "cancel": "Anuluj",

package/translations/pt.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Conexões",
     "citedByLabel": "Citado por",
     "siblingTypesLabel": "Tipos Irmãos",
+    "userHintLabel": "Dica",
+    "userHintPlaceholder": "Descreva a que esta anotação se refere...",
     "loadingContext": "Coletando contexto...",
     "failedContext": "Falha ao coletar contexto",
     "cancel": "Cancelar",

package/translations/ro.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Conexiuni",
     "citedByLabel": "Citat de",
     "siblingTypesLabel": "Tipuri Înrudite",
+    "userHintLabel": "Indiciu",
+    "userHintPlaceholder": "Descrieți la ce se referă această adnotare...",
     "loadingContext": "Se colectează contextul...",
     "failedContext": "Colectarea contextului a eșuat",
     "cancel": "Anulare",

package/translations/sv.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Anslutningar",
     "citedByLabel": "Citerad av",
     "siblingTypesLabel": "Systertyper",
+    "userHintLabel": "Ledtråd",
+    "userHintPlaceholder": "Beskriv vad denna anteckning hänvisar till...",
     "loadingContext": "Samlar kontext...",
     "failedContext": "Misslyckades med att samla kontext",
     "cancel": "Avbryt",

package/translations/th.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "การเชื่อมต่อ",
     "citedByLabel": "อ้างอิงโดย",
     "siblingTypesLabel": "ประเภทพี่น้อง",
+    "userHintLabel": "คำใบ้",
+    "userHintPlaceholder": "อธิบายว่าคำอธิบายประกอบนี้หมายถึงอะไร...",
     "loadingContext": "กำลังรวบรวมบริบท...",
     "failedContext": "ไม่สามารถรวบรวมบริบทได้",
     "cancel": "ยกเลิก",

package/translations/tr.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Bağlantılar",
     "citedByLabel": "Alıntılayan",
     "siblingTypesLabel": "Kardeş Türler",
+    "userHintLabel": "İpucu",
+    "userHintPlaceholder": "Bu açıklamanın neyi ifade ettiğini tanımlayın...",
     "loadingContext": "Bağlam toplanıyor...",
     "failedContext": "Bağlam toplanamadı",
     "cancel": "İptal",

package/translations/uk.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Зв'язки",
     "citedByLabel": "Цитується",
     "siblingTypesLabel": "Споріднені типи",
+    "userHintLabel": "Підказка",
+    "userHintPlaceholder": "Опишіть, на що посилається ця анотація...",
     "loadingContext": "Збирається контекст...",
     "failedContext": "Не вдалося зібрати контекст",
     "cancel": "Скасувати",

package/translations/vi.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "Kết nối",
     "citedByLabel": "Được trích dẫn bởi",
     "siblingTypesLabel": "Loại Anh em",
+    "userHintLabel": "Gợi ý",
+    "userHintPlaceholder": "Mô tả chú thích này đề cập đến điều gì...",
     "loadingContext": "Đang thu thập ngữ cảnh...",
     "failedContext": "Không thể thu thập ngữ cảnh",
     "cancel": "Hủy",

package/translations/zh.json

@@ -343,6 +343,8 @@
     "connectionsLabel": "连接",
     "citedByLabel": "被引用",
     "siblingTypesLabel": "同级类型",
+    "userHintLabel": "提示",
+    "userHintPlaceholder": "描述此注释所指的内容...",
     "loadingContext": "正在收集上下文...",
     "failedContext": "收集上下文失败",
     "cancel": "取消",