בקשה | הוספת 2 פונקציות חדשות ל API של התוספים

[מיכאלוש]

@י.-פל. כתב
ניתן לבקש פתיחה של api נוספים - ואשתדל להיענות, אם כי זה מבחינתי פרוייקט צד - שלא אשקיע בו הרבה ככה״נ.

הרב @י.-פל. אשמח בהזדמנות להוספת 2 API חדשים:
בקצרה:

• אפשרות הוספה למקש ימני של שורה חדשה עם תת תפריט
• אפשרות הדגשת טקסט ספציפי של מילה אחת לא רק מקטע שלם (האמת גם מקטע שלם לא עובד לי)

ובארוכה בספויילר:

Spoiler

הנה פירוט מדויק של מה לבקש — מנוסח בצורה שתהיה ברורה למפתחי אוצריא:

---

בקשה 1 — הדגשת טקסט מדויק (לא שורה שלמה)

הבעיה הנוכחית

reader.setHighlight מדגיש שורה שלמה לפי index. אין דרך להגיד "הדגש רק את המילים 120–131 בתוך השורה הזו".

מה לבקש

הרחבת reader.setHighlight לקבל שדות start ו-end אופציונליים:

await Otzaria.call('reader.setHighlight', {
  bookId: 'בראשית',
  index: 42,
  color: '#FFF176',
  label: 'מרקר',
  start: 120,   // ← חדש: תו התחלה בתוך השורה (מ-reader.selection_changed)
  end: 131      // ← חדש: תו סיום
});

כשאין start/end — ההתנהגות הנוכחית (הדגשת שורה שלמה) נשמרת לתאימות לאחור.

כשיש start/end — הטקסט בין start ל-end מוצג עם שכבה צבעונית מעליו (בדיוק כמו הסימון הכחול שמוצג בזמן בחירת הטקסט).

---

גם reader.getHighlights צריך להחזיר את השדות האלה:

// תגובה מורחבת:
{
  bookId: 'בראשית',
  index: 42,
  color: '#FFF176',
  label: 'מרקר',
  start: 120,   // ← חדש
  end: 131      // ← חדש
}

---

גם reader.clearHighlight צריך לתמוך ב-start/end כדי שיהיה אפשר למחוק הדגשה מדויקת בלי לנגוע לשאר ההדגשות באותה שורה:

await Otzaria.call('reader.clearHighlight', {
  bookId: 'בראשית',
  index: 42,
  start: 120,
  end: 131
});

---

למה זה חשוב

reader.selection_changed כבר מחזיר start ו-end — כלומר אוצריא כבר מחשבת את הטווח. הבעיה היא רק שאי אפשר להעביר אותו חזרה ל-setHighlight. זה תיקון ממוקד שלא שובר כלום.

---

בקשה 2 — תת-תפריט (submenu) בתפריט קליק ימני

הבעיה הנוכחית

reader.addContextMenuItem מוסיף רק פריטים שטוחים. תוסף עם 6 צבעים מוסיף 6 שורות עצמאיות לתפריט — מה שמנפח אותו ולא ברור שהם שייכים לאותו תוסף.

מה לבקש

הוספת שדה parentId ל-reader.addContextMenuItem:

// שלב א: רשום "ראש" התת-תפריט
await Otzaria.call('reader.addContextMenuItem', {
  id: 'marker-root',
  label: 'מרקר',
  icon: 'highlight_24_regular'
  // אין parentId → פריט ברמה עליונה עם חץ
});

// שלב ב: רשום פריטי בנים
await Otzaria.call('reader.addContextMenuItem', {
  id: 'mark-yellow',
  label: '● צהוב',
  icon: 'highlight_24_regular',
  parentId: 'marker-root'   // ← חדש
});

await Otzaria.call('reader.addContextMenuItem', {
  id: 'mark-green',
  label: '● ירוק',
  icon: 'highlight_24_regular',
  parentId: 'marker-root'   // ← חדש
});

כשלוחצים על "מרקר" בתפריט — נפתח תת-תפריט עם הילדים.

---

גם reader.removeContextMenuItem לא צריך שינוי — מחיקת הורה מוחקת את כל הבנים אוטומטית, מחיקת בן מוחקת רק אותו.

---

ה-event reader.context_menu_item_clicked לא צריך שינוי — יגיע itemId: 'mark-yellow' כרגיל.

---

שאלה שכדאי לשאול אותם במפורש

האם הארכיטקטורה של תפריט ה-context ב-Flutter (שבו בנוי אוצריא) תומכת בתת-תפריטים מקוננים? אם לא — האלטרנטיבה היא קבוצה (group) עם כותרת (separator עם טקסט) במקום subemenu אמיתי:

await Otzaria.call('reader.addContextMenuItem', {
  id: 'marker-separator',
  type: 'group',          // ← אלטרנטיבה: separator עם כותרת
  label: 'מרקר'
});

---

סיכום — 2 שורות לפיצ'ר request

Feature 1: reader.setHighlight / clearHighlight / getHighlights — הוספת שדות start ו-end (תווים בתוך שורה) להדגשת טקסט מדויק. ה-SDK כבר מחזיר ערכים אלו ב-reader.selection_changed, אז מדובר בחיבור קצה-לקצה בלבד.

Feature 2: reader.addContextMenuItem — הוספת שדה parentId (אופציונלי) ליצירת תת-תפריטים, או לחלופין שדה type: 'group' לכותרת מפרידה.

[Otzaria-Bot]

No response from OpenClaw.

[מיכאלוש]

@Otzaria-Bot כזה מהר נגמרו לך הטוקנים, סליחה הרוח הקודש ???

[פלמנמוני]

@מיכאלוש למה שלא תפתח PR?

[י. פל.]

@פלמנמוני
אם אתה מממש את הapi הזה (ואולי גם אם לא), צריך להגדיר שתוסף לא יכול להוסיף יותר משורה אחת בלבד.

[פלמנמוני]

@י.-פל. כתב:

צריך להגדיר שתוסף לא יכול להוסיף יותר משורה אחת בלבד.

ותת תפריט?

[י. פל.]

@פלמנמוני כתב:

ותת תפריט?

למה לא?

[יאיר דניאל]

@מיכאלוש סקרנת...
באיזה תוסף מדובר?
מה שכתבת על צ'אט AI?

[מיכאלוש]

@פלמנמוני כתב:

@מיכאלוש למה שלא תפתח PR?

בשמחה, לא ידעתי ש @י.-פל. מסכים לגעת בבייבי שלו ?

@י.-פל. כתב:

@פלמנמוני
אם אתה מממש את הapi הזה (ואולי גם אם לא), צריך להגדיר שתוסף לא יכול להוסיף יותר משורה אחת בלבד.

בהחלט נצרך אחרת זה נורא בדיוק בשביל זה ביקשתי...

האמת אם זה לא היה נושא שנוי בדיון שעוד לא הוכרע הייתי מבקש גם הוספת תצוגה של פריטים כמו בויינדוס 11

@יאיר-דניאל כתב:

@מיכאלוש סקרנת...
באיזה תוסף מדובר?
מה שכתבת על צ'אט AI?

שיחקתי קצת היום לא משהוא רציני...

[י. פל.]

@מיכאלוש כתב:

בהחלט נצרך אחרת זה נורא בדיוק בשביל זה ביקשתי...

אני לא יעלה שום תוסף שיעשה את התפריט כמו ווינדוס

[מיכאלוש]

@י.-פל. כתב:

@מיכאלוש כתב:

בהחלט נצרך אחרת זה נורא בדיוק בשביל זה ביקשתי...

אני לא יעלה שום תוסף שיעשה את התפריט כמו ווינדוס

אני יודע שאתה נגד מייקרוסופט, זה בסדר גם אני...

רק לא הבנתי אתה מדבר על אורך השורות כמו בווינדוס, או על תצוגת פריטים בתפריט ?

כי בתוסף המדובר זה יהיה הרבה יותר לעניין תצוגת פריטים מאשר תת תפריט

דוגמא מזית

[י. פל.]

@מיכאלוש כתב:

אני יודע שאתה נגד מייקרוסופט, זה בסדר גם אני...

אתה טועה: אני נגד אפל...
רק שהאורך של תפריט ההקשר (וזמן הטעינה שלו) לא הגיוניים.

[מיכאלוש]

@י.-פל. כתב:

@מיכאלוש כתב:

אני יודע שאתה נגד מייקרוסופט, זה בסדר גם אני...

אתה טועה: אני נגד אפל...
רק שהאורך של תפריט ההקשר (וזמן הטעינה שלו) לא הגיוניים.

טוב, עוד מעט אני ישפוך בחדר קפה את התסכול מהם בנושא האייקונים לפחות

@פלמנמוני כתב:

@מיכאלוש למה שלא תפתח PR?

אגב @י.-פל. משהוא בנושא הPRים לא ברור לי
על מה אתה מעוניין לקבל ועל מה לא ?

האמת זה נראה שעל הרוב לא...

מה שקשור לעיצוב כבר קשור ל@asz
מה שקשור לחיפוש כבר קשור ל@הבל-הבלים
מה שקשור לתיקון באגים ומילוי בקשות משתמשים כבר קשור ל@פלמנמוני
מה שקשור לפונקציות חדשות צריך להעלות קודם לדיון כל פעם מחדש

אז על מה כן ?

[י. פל.]

@מיכאלוש כתב:

מה שקשור לפונקציות חדשות צריך להעלות קודם לדיון כל פעם מחדש

בדר״כ פונקציות חדשות מאושרות ליישום.
רק צריך להתייעץ, כדי לוודא שהן לא טומנות בחובן סיכון.
אני רוצה כמה שפחות באגים!
אני בהחלט מתכונן לגרסה 1...

[צדיק וטוב לו]

@י.-פל. כתב:

אני בהחלט מתכונן לגרסה 1...

בעז"ה.