@khorsheed/dsh-reader 0.2.1 → 0.3.1

package/lib/types/client/locales.js

@@ -25,6 +25,12 @@ export const en = {
     'action.filter': 'Filter',
     'action.fetchBody': 'Fetch the text',
     'action.more': 'More actions',
+    'translate.wallOff': 'Turn translation off',
+    'chip.unread': 'Unread',
+    'chip.more': 'Filter…',
+    'state.incompleteCount': '{count} sources incomplete',
+    'action.showList': 'Show',
+    'action.foldList': 'Hide',
     'action.addTag': 'Tags…',
     'action.translate': 'Translate',
     'translate.view': 'Translation view',
@@ -36,6 +42,7 @@ export const en = {
     'translate.preparing': 'Preparing the Chinese language pack',
     'translate.working': 'Translating',
     'translate.local': 'On-device · Chinese (Simplified)',
+    'translate.stored': 'Saved translation · Chinese (Simplified)',
     'translate.failed': 'Translation stopped: {reason}',
     'translate.failedAll': 'No batch came back — try again from the globe menu',
     'translate.nothing': 'Nothing in this body to translate',
@@ -66,7 +73,6 @@ export const en = {
     'action.back': 'Back',
     'action.copyLink': 'Copy link',
     'action.openExternal': 'Open in browser',
-    'action.quote': 'Quote',
     'action.manage': 'Manage subscriptions',
     'action.recent': 'Recently read',
     'recent.title': 'Recently read',
@@ -92,6 +98,7 @@ export const en = {
     'verdict.unsupportedContent': 'That address did not return a feed or an article.',
     'verdict.fetchFailed': 'Could not fetch that address.',
     'preview.blocked': 'this site refuses automatic fetches (it answers with a bot challenge)',
+    'verdict.willRender': 'Opening it retries through the rendered fetch (a headless browser).',
     'preview.login': 'this address is behind a login (an institutional proxy or single sign-on)',
     'preview.unsupportedType': 'this address is not a web page (a PDF or another file)',
     'preview.redirected': 'this address moves to another site, and the redirect cannot be followed here',
@@ -101,6 +108,11 @@ export const en = {
     'preview.unreadable': 'this page is a script-rendered app behind an anti-bot wall, so there is nothing to read server-side — if it has an arXiv version, paste that link instead',
     'detail.linkOnlyBadge': 'Link only',
     'detail.fetchingBody': 'Fetching the full text…',
+    'detail.phase.downloading': 'Downloading the page…',
+    'detail.phase.extracting': 'Extracting the article…',
+    'detail.phase.storing': 'Saving the body…',
+    'detail.fetchElapsed': '{seconds}s',
+    'add.busy': 'Identifying and fetching the link…',
     'detail.refetch': 'Fetch again',
     'detail.refetching': 'Fetching…',
     'detail.refetchTitle': 'Fetch this article again — what is on screen is the copy fetched earlier',
@@ -161,8 +173,6 @@ export const en = {
     'detail.summaryOnly': 'This feed publishes only a summary for this entry — the full text lives on the original page.',
     'detail.resolvedFrom': 'Resolved from the link you pasted ({url}) — click to open it',
     'detail.alsoFrom': 'Also from this source',
-    'detail.composerLabel': 'Current conversation draft',
-    'detail.composerEmpty': '(empty)',
     'foot.refreshedAt': 'Refreshed {when}',
     'foot.scheduled': 'daily {time}',
     'foot.never': 'Not refreshed yet',
@@ -184,17 +194,141 @@ export const en = {
     'fetch.failedOpenTitle': 'Fetch failed: {reason} — click for details',
     'fetch.failedFinalTitle': 'Fetch failed: {reason}',
     'detail.renderFetch': 'Fetch rendered',
+    'detail.renderingWall': 'This site turned away the plain fetch — rendering it in a headless browser instead (about 15–30 s)…',
+    'detail.renderFailed': 'The rendered fetch did not get the article either ({reason}).',
     'detail.rendering': 'Rendering this page in the browser — script-drawn figures appear when it lands (the first render is slower)…',
     'quote.copied': 'Copied',
     'quote.copyFailed': 'Could not reach the clipboard',
     'quote.quoted': 'Quoted {count} characters',
-    'quote.toSideChat': 'Sent to side chat',
-    'quote.sideChatUnavailable': 'No side chat in this composition',
+    'add.fetching': 'Fetching…',
+    'notes.checkShort': 'Quiz me',
+    'polish.action': '✦ Let the agent polish the translation',
+    'polish.draft': 'Polish the Chinese translation of “{title}” (article id {id}, {count} paragraphs). Load the reader skill, read the original with reader_read batch by batch, translate whole paragraphs from the original and write each batch back with reader_translate, until every paragraph is done. Faithful, natural Chinese; names, terms and speakers consistent.\nMy wishes: ',
+    'polish.continueDraft': 'Continue polishing the Chinese translation of “{title}” (article id {id}, {count} paragraphs) from ¶{from}: read with reader_read from={from}, write back with reader_translate, until every paragraph is done.',
+    'polish.tag': 'polished',
+    'polish.tagTitle': 'Show the machine translation for this paragraph',
+    'polish.running': 'The agent is polishing · {done} / {total} paragraphs',
+    'polish.stalled': 'Polished {done} / {total}',
+    'polish.continue': 'Polish the remaining {count}',
+    'polish.done': '✦ Polished by the agent · {done} paragraphs',
+    'polish.showMachine': 'Show the machine translation',
+    'polish.showPolish': 'Show the polished one',
+    'polish.awaiting': 'The polish request is in the input box — send it and progress shows here',
     'when.justNow': 'just now',
     'when.minutes': '{count} min ago',
     'when.hours': '{count} h ago',
     'when.yesterday': 'yesterday',
     'when.days': '{count} d ago',
+    'notes.tabArticle': 'Article',
+    'notes.tabNotes': 'Notes',
+    'notes.tabsLabel': 'Article and notes',
+    'notes.take': 'Take a note',
+    'notes.sheetTitle': 'Take a note',
+    'notes.excerpt': 'Excerpt',
+    'notes.commentPlaceholder': 'What do you make of it? (optional)',
+    'notes.commentOptional': 'The comment is optional — the excerpt alone is kept too',
+    'notes.save': 'Save',
+    'notes.saveFailed': 'Could not save the note',
+    'notes.empty': 'No notes yet. Select a passage and choose “Take a note”.',
+    'notes.excerpts': 'Excerpts · in article order',
+    'notes.discussions': 'Discussed in',
+    'notes.noDiscussions': 'Not discussed yet. Bring your notes to the conversation.',
+    'notes.select': 'Select',
+    'notes.selectDone': 'Done',
+    'notes.selected': '{count} selected',
+    'notes.discuss': 'Discuss',
+    'notes.discussAll': 'Discuss with these notes',
+    'notes.edit': 'Edit comment',
+    'notes.delete': 'Delete',
+    'notes.deleteConfirm': 'Delete this note?',
+    'notes.notFound': 'The article changed — this passage is no longer in it',
+    'notes.inTranslation': 'Translation',
+    'notes.discussedIn': 'Back to the conversation',
+    'notes.draftHeading': 'My notes on this article ({count}):',
+    'notes.draftComment': 'My comment: ',
+    'notes.draftHint': '(article id {id} — reader_read reads the full text)',
+    'notes.untitledSession': 'Conversation',
+    'notes.badge': '{count} notes',
+    'notes.filter': 'Has notes',
+    'notes.replyAdd': '+ Add a line',
+    'notes.replyAgent': 'Conclusion',
+    'notes.replyUser': 'Me',
+    'notes.replyEdited': 'Me (rewritten from a conclusion)',
+    'notes.replyPlaceholder': 'Add to it, or say it your way',
+    'notes.replyEdit': 'Edit',
+    'notes.replyRemove': 'Remove',
+    'notes.discussionNotes': 'Discussion notes · newest first',
+    'notes.kindDiscussion': 'Discussion',
+    'notes.kindCheck': 'Quiz me',
+    'notes.noDiscussionNotes': 'None yet. Ask the agent to “keep the conclusions”, or let it quiz you.',
+    'notes.pointsCheck': 'Not quite there yet',
+    'notes.pointsDiscussion': 'Points',
+    'notes.check': 'Let the agent quiz me',
+    'notes.checkLead': 'Finished? Explaining it in your own words shows best what you have not got yet.',
+    'notes.checkDraft': 'Quiz me on “{title}” (article id {id}). I have finished it. Load the reader skill and run a quiz-me round: read the article and my notes with reader_read, play a student who has not read it, ask 3–5 explain-it-to-me questions in one message, and once I answer them all, explain against the article only what I have not got right (with ¶), then keep it with reader_note as a quiz-me note. No score.',
+    'notes.checkDraftNotes': 'My notes so far: {count}.',
+    'notes.backToSession': 'Back to the conversation',
+    'media.collapse': 'Collapse video',
+    'media.noFollow': 'Bilibili\'s player reports no playback time: a time plays from there by reloading the player, and the transcript does not follow playback',
+    'media.expand': 'Show video',
+    'media.captions': 'Captions',
+    'media.sourcePlatform': 'Source: platform captions',
+    'media.loading': 'Fetching captions…',
+    'media.noCaptions': 'This video has no captions — install the Local Transcription plugin to transcribe it on this machine',
+    'media.noCaptionsAudio': 'This audio has no captions — install the Local Transcription plugin to transcribe it on this machine',
+    'media.sourceLocal': 'Source: transcribed on this machine',
+    'media.play': 'Play',
+    'media.pause': 'Pause',
+    'media.startedAt': 'Played from {time}',
+    'media.tabTranscript': 'Transcript',
+    'media.autoTranslate': 'Translate when transcribed',
+    'media.translateAfter': 'Translation opens once the transcript is complete',
+    'media.chipTitle': 'Play from {time}',
+    'media.chipTitleReload': 'Play from {time} (the player reloads)',
+    'media.timeHint': 'Click the time before a paragraph to play the video from there',
+    'media.timeHintAudio': 'Click the time before a paragraph to play from there',
+    'media.timeHintOk': 'Got it',
+    'media.backToNow': 'Back to what is playing',
+    'media.speakerDefault': 'Speaker {letter}',
+    'media.speakerHint': 'Click a name to rename it',
+    'media.speakerRename': 'Rename this speaker (the whole transcript)',
+    'media.speakersRunning': 'telling the speakers apart…',
+    'media.cardPlatform': 'Captions',
+    'media.cardLocal': 'Transcribed',
+    'media.cardQueued': 'Queued',
+    'media.cardQueuedAhead': 'Queued #{count}',
+    'media.cardRunning': 'Transcribing {percent}%',
+    'media.cardFailed': 'Transcription failed',
+    'media.cardNone': 'No captions',
+    'media.cardNoneAuto': 'No captions · transcribes on open',
+    'media.localFetching': 'Getting the audio…',
+    'media.localQueued': 'Waiting to transcribe…',
+    'media.localQueuedAhead': 'Queued — {count} ahead',
+    'media.localRunning': 'Transcribing on this machine · {percent}% — what is done can be read now',
+    'media.localEta': 'about {minutes} min left',
+    'media.localStop': 'Cancel',
+    'media.localStopped': 'Transcription stopped',
+    'media.localFailed': 'Transcription failed: {error}',
+    'media.localRetry': 'Transcribe again',
+    'media.localModels': 'The first local transcription downloads the speech models (about {size} MB, once). After that it runs by itself.',
+    'media.localModelsGo': 'Download and transcribe',
+    'media.failed': 'Captions could not be fetched',
+    'media.kindVideo': 'Video',
+    'media.kindAudio': 'Audio',
+    'notes.sync': 'Sync to canvas',
+    'notes.syncTitle': 'Sync to canvas · {count}',
+    'notes.syncLast': 'used last',
+    'notes.syncCards': '{count} cards',
+    'notes.syncReplies': 'Bring the conclusions under them along',
+    'notes.syncKind': 'This canvas has no Fragment category — pick one:',
+    'notes.syncDone': 'Synced to “{canvas}”',
+    'notes.syncOpen': 'Open',
+    'notes.syncFailed': 'The sync did not go through: {reason}',
+    'notes.syncedIn': 'On “{canvas}”',
+    'notes.syncNoCanvas': 'No canvas yet — create one on the canvas tab first.',
+    'notes.syncConclusion': 'Conclusion: ',
+    'notes.syncOriginal': 'original',
+    'notes.syncRun': 'Sync',
 };
 export const zh = {
     'tab.label': '灵感空间',
@@ -209,6 +343,12 @@ export const zh = {
     'action.filter': '筛选',
     'action.fetchBody': '抓取正文',
     'action.more': '更多操作',
+    'translate.wallOff': '关闭翻译',
+    'chip.unread': '未读',
+    'chip.more': '筛选…',
+    'state.incompleteCount': '{count} 个来源未完整',
+    'action.showList': '查看',
+    'action.foldList': '收起',
     'action.addTag': '打标签…',
     'action.translate': '翻译',
     'translate.view': '翻译视图',
@@ -220,6 +360,7 @@ export const zh = {
     'translate.preparing': '正在准备中文语言包',
     'translate.working': '翻译中',
     'translate.local': '浏览器本地 · 中文（简体）',
+    'translate.stored': '已保存的译文 · 中文（简体）',
     'translate.failed': '翻译中断：{reason}',
     'translate.failedAll': '各批次都没翻出来 —— 可从地球菜单里重试',
     'translate.nothing': '这段正文里没有可翻译的散文',
@@ -250,7 +391,6 @@ export const zh = {
     'action.back': '返回',
     'action.copyLink': '复制链接',
     'action.openExternal': '在浏览器打开原文',
-    'action.quote': '引用',
     'action.manage': '订阅管理',
     'action.recent': '最近阅读',
     'recent.title': '最近阅读',
@@ -276,6 +416,7 @@ export const zh = {
     'verdict.unsupportedContent': '这个地址返回的既不是订阅源也不是网页。',
     'verdict.fetchFailed': '抓取失败。',
     'preview.blocked': '这个站点拒绝自动抓取（返回的是验证页）',
+    'verdict.willRender': '打开这条时会改用渲染抓取（无头浏览器）再试。',
     'preview.login': '这个地址需要登录（机构代理或单点登录），本插件取不到正文',
     'preview.unsupportedType': '这个地址不是网页（是 PDF 或其它文件）',
     'preview.redirected': '这个地址会跳到另一个站点，跨站跳转在本地无法跟随',
@@ -285,6 +426,11 @@ export const zh = {
     'preview.unreadable': '这个页面是 JS 应用且有反爬，服务器端读不到内容 —— 如果它有 arxiv 版，直接粘贴 arxiv 链接',
     'detail.linkOnlyBadge': '仅链接',
     'detail.fetchingBody': '正在抓取正文…',
+    'detail.phase.downloading': '正在下载页面…',
+    'detail.phase.extracting': '正在解析正文…',
+    'detail.phase.storing': '正在保存正文…',
+    'detail.fetchElapsed': '{seconds} 秒',
+    'add.busy': '正在识别并抓取链接…',
     'detail.refetch': '重新抓取',
     'detail.refetching': '抓取中',
     'detail.refetchTitle': '重新抓取这篇正文 —— 现在看到的是之前抓下来的版本',
@@ -345,8 +491,6 @@ export const zh = {
     'detail.summaryOnly': '这条订阅源只发布了摘要 —— 全文在原文页面上。',
     'detail.resolvedFrom': '这条由粘贴的链接（{url}）解析而来 —— 点击打开原链接',
     'detail.alsoFrom': '同一来源',
-    'detail.composerLabel': '当前会话草稿',
-    'detail.composerEmpty': '（空）',
     'foot.refreshedAt': '刷出于 {when}',
     'foot.scheduled': '每日 {time}',
     'foot.never': '尚未刷新',
@@ -368,15 +512,139 @@ export const zh = {
     'fetch.failedOpenTitle': '抓取失败：{reason} —— 点一下看详情',
     'fetch.failedFinalTitle': '抓取失败：{reason}',
     'detail.renderFetch': '渲染抓取',
+    'detail.renderingWall': '这个站点拦截了普通抓取，正在改用无头浏览器渲染（约 15–30 秒）…',
+    'detail.renderFailed': '渲染抓取也没拿到正文（{reason}）。',
     'detail.rendering': '正在用浏览器渲染这一页——脚本绘制的插图会在渲染后出现（首次较慢）…',
     'quote.copied': '已复制',
     'quote.copyFailed': '剪贴板不可用',
     'quote.quoted': '已引用 {count} 字',
-    'quote.toSideChat': '已发送到侧边对话',
-    'quote.sideChatUnavailable': '当前组合里没有侧边对话',
+    'add.fetching': '抓取中…',
+    'notes.checkShort': '考考我',
+    'polish.action': '✦ 让 Agent 润色译文',
+    'polish.draft': '请润色《{title}》（文章 id {id}，共 {count} 段）的中文译文：加载 reader 技能，用 reader_read 分批读原文，从原文整段翻译，每批用 reader_translate 写回，直到全部写完。忠实原意、读起来像中文；专名、术语和说话人前后一致。\n我的要求：',
+    'polish.continueDraft': '请从 ¶{from} 接着润色《{title}》（文章 id {id}，共 {count} 段）的中文译文：用 reader_read from={from} 读，用 reader_translate 写回，直到全部写完。',
+    'polish.tag': '润色',
+    'polish.tagTitle': '这一段改回机翻',
+    'polish.running': 'Agent 润色中 · 已润色 {done} / {total} 段',
+    'polish.stalled': '已润色 {done} / {total} 段',
+    'polish.continue': '继续润色剩下的 {count} 段',
+    'polish.done': '✦ 已由 Agent 润色 {done} 段',
+    'polish.showMachine': '看机翻',
+    'polish.showPolish': '看润色版',
+    'polish.awaiting': '润色请求已放进输入框，发送后这里会显示进度',
     'when.justNow': '刚刚',
     'when.minutes': '{count} 分钟前',
     'when.hours': '{count} 小时前',
     'when.yesterday': '昨天',
     'when.days': '{count} 天前',
+    'notes.tabArticle': '正文',
+    'notes.tabNotes': '笔记',
+    'notes.tabsLabel': '正文与笔记',
+    'notes.take': '记笔记',
+    'notes.sheetTitle': '记笔记',
+    'notes.excerpt': '摘抄',
+    'notes.commentPlaceholder': '写点你的想法（可空）',
+    'notes.commentOptional': '评论可空，只存摘抄也行',
+    'notes.save': '保存',
+    'notes.saveFailed': '笔记没有存上',
+    'notes.empty': '还没有笔记。在正文里选中一段，点「记笔记」。',
+    'notes.excerpts': '摘抄笔记 · 按原文顺序',
+    'notes.discussions': '讨论过这篇的会话',
+    'notes.noDiscussions': '还没有讨论过。带着笔记去会话里聊聊。',
+    'notes.select': '选择',
+    'notes.selectDone': '完成',
+    'notes.selected': '已选 {count} 条',
+    'notes.discuss': '带着讨论',
+    'notes.discussAll': '带着笔记讨论',
+    'notes.edit': '编辑评论',
+    'notes.delete': '删除',
+    'notes.deleteConfirm': '删除这条笔记？',
+    'notes.notFound': '原文已变，找不到这一句',
+    'notes.inTranslation': '译文',
+    'notes.discussedIn': '回到会话',
+    'notes.draftHeading': '我在这篇里的笔记（{count} 条）：',
+    'notes.draftComment': '我的评论：',
+    'notes.draftHint': '（文章 id：{id}，可用 reader_read 读全文）',
+    'notes.untitledSession': '会话',
+    'notes.badge': '笔记 {count}',
+    'notes.filter': '有笔记',
+    'notes.replyAdd': '＋ 追加一句',
+    'notes.replyAgent': '讨论结论',
+    'notes.replyUser': '我',
+    'notes.replyEdited': '我（改自讨论结论）',
+    'notes.replyPlaceholder': '补充一句，或换成你自己的说法',
+    'notes.replyEdit': '改',
+    'notes.replyRemove': '删',
+    'notes.discussionNotes': '讨论笔记 · 最近的在前',
+    'notes.kindDiscussion': '讨论',
+    'notes.kindCheck': '考考我',
+    'notes.noDiscussionNotes': '还没有。讨论时说一句「把结论记到笔记」，或者让 Agent 考考你。',
+    'notes.pointsCheck': '没理解到位的',
+    'notes.pointsDiscussion': '要点',
+    'notes.check': '让Agent考考我',
+    'notes.checkLead': '读完了？用自己的话讲一遍，最能看出哪里没懂。',
+    'notes.checkDraft': '考考我：《{title}》（文章 id：{id}）。我读完了，请加载 reader 技能，按「考考我」来：用 reader_read 读这篇和我的笔记，当一个没读过的学生，一次问我 3–5 个「讲给我听」的问题；我一条消息答完后，对照原文只讲我没讲到位的地方（带 ¶），再用 reader_note 记一条考考我笔记。不打分。',
+    'notes.checkDraftNotes': '我目前记了 {count} 条笔记。',
+    'notes.backToSession': '回到会话',
+    'media.collapse': '收起视频',
+    'media.noFollow': 'B 站播放器不报告播放时间：点时间会重新加载播放器、从那里播放，播放时转写稿不会自动跟随',
+    'media.expand': '展开视频',
+    'media.captions': '字幕',
+    'media.sourcePlatform': '来源：平台字幕',
+    'media.loading': '正在获取字幕…',
+    'media.noCaptions': '该视频无字幕；装上「本机转写」插件后可在本机转写',
+    'media.noCaptionsAudio': '该音频无字幕；装上「本机转写」插件后可在本机转写',
+    'media.sourceLocal': '来源：本机转写',
+    'media.play': '播放',
+    'media.pause': '暂停',
+    'media.startedAt': '从 {time} 播放',
+    'media.tabTranscript': '转写稿',
+    'media.autoTranslate': '转完自动翻译',
+    'media.translateAfter': '转写完成后可以翻译',
+    'media.chipTitle': '从 {time} 开始播放',
+    'media.chipTitleReload': '从 {time} 开始播放（会重新加载播放器）',
+    'media.timeHint': '点段落前的时间，视频就从那里播放',
+    'media.timeHintAudio': '点段落前的时间，就从那里播放',
+    'media.timeHintOk': '知道了',
+    'media.backToNow': '回到正在播放',
+    'media.speakerDefault': '说话人 {letter}',
+    'media.speakerHint': '点名字可以改名',
+    'media.speakerRename': '给这位说话人改名（整期替换）',
+    'media.speakersRunning': '正在区分说话人…',
+    'media.cardPlatform': '有字幕',
+    'media.cardLocal': '本机转写',
+    'media.cardQueued': '排队中',
+    'media.cardQueuedAhead': '排队第 {count}',
+    'media.cardRunning': '转写中 {percent}%',
+    'media.cardFailed': '转写失败',
+    'media.cardNone': '无字幕',
+    'media.cardNoneAuto': '无字幕 · 打开时转写',
+    'media.localFetching': '正在获取音频…',
+    'media.localQueued': '等待转写…',
+    'media.localQueuedAhead': '排队中 · 前面还有 {count} 个',
+    'media.localRunning': '本机转写中 · {percent}% · 已转写的部分可以先读',
+    'media.localEta': '约还需 {minutes} 分钟',
+    'media.localStop': '取消',
+    'media.localStopped': '已停止转写',
+    'media.localFailed': '转写失败：{error}',
+    'media.localRetry': '重新转写',
+    'media.localModels': '第一次本机转写需要下载语音模型（约 {size} MB，只需一次），之后都自动进行。',
+    'media.localModelsGo': '下载并转写',
+    'media.failed': '字幕获取失败',
+    'media.kindVideo': '视频',
+    'media.kindAudio': '音频',
+    'notes.sync': '同步到画布',
+    'notes.syncTitle': '同步到画布 · {count} 条',
+    'notes.syncLast': '上次用的',
+    'notes.syncCards': '{count} 张卡',
+    'notes.syncReplies': '把下面挂的讨论结论一起带上',
+    'notes.syncKind': '这块画布没有「灵感」分类，选一个：',
+    'notes.syncDone': '已同步到《{canvas}》',
+    'notes.syncOpen': '打开',
+    'notes.syncFailed': '同步没有成功：{reason}',
+    'notes.syncedIn': '已在《{canvas}》',
+    'notes.syncNoCanvas': '还没有画布——先在画布页建一块。',
+    'notes.syncConclusion': '讨论结论：',
+    'notes.syncOriginal': '原文',
+    'notes.syncRun': '同步',
 };

package/lib/types/client/notes.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Notes in the browser: turning a selection into an excerpt, finding excerpts
+ * again for the highlight, the article snapshot the model reads, and the draft
+ * a discussion starts from.
+ *
+ * Everything here reads the DOM and never writes it. The article body is
+ * `translate.ts`'s to decorate (it splits text nodes into sentence spans), so
+ * a note highlight that wrapped text in `<mark>` would fight it on every view
+ * switch. Highlights go through the CSS Custom Highlight API instead: ranges
+ * over whatever text nodes are on screen, recomputed after each rebuild. A
+ * browser without the API shows no highlight — the notes themselves still work.
+ *
+ * Blocks are the article's top-level children minus `translate.ts`'s reveals —
+ * the reading position's unit (`articleBlocks` in the pane), so ¶n here, in the
+ * snapshot, and in a note's anchor all mean the same paragraph.
+ *
+ * @module @khorsheed/dsh-reader/client/notes
+ */
+import type { ReaderNote } from '../notes-types.ts';
+import type { BuiltArticle } from './translate.ts';
+/** The highlight registry names (the pane's stylesheet paints them). */
+export declare const NOTE_HIGHLIGHT = "reader-note";
+export declare const NOTE_FLASH_HIGHLIGHT = "reader-note-flash";
+/** Collapse whitespace the way stored excerpts are collapsed. */
+export declare function normalizeText(value: string): string;
+/** The article's blocks: top-level children, reveals excluded. */
+export declare function blockElements(article: Element): HTMLElement[];
+/**
+ * The block a node sits in, as an index into {@link blockElements}.
+ *
+ * A node inside a sibling-placed reveal belongs to the block the reveal
+ * follows; one inside an inside-placed reveal is already inside its block.
+ */
+export declare function blockIndexOf(article: Element, node: Node): number;
+/** What a selection becomes before the reader adds a comment. */
+export interface NoteSelection {
+    readonly block: number;
+    readonly start?: number;
+    readonly quote: string;
+    readonly translated?: string;
+    /** A transcript paragraph's start (seconds), when the article is a transcript. */
+    readonly time?: number;
+}
+/**
+ * Read the current selection as an excerpt of this article.
+ *
+ * Selected in the translated view, the excerpt is the ORIGINAL of every
+ * sentence the selection touched, and the selected translation rides along —
+ * the stored quote is always original text (decision D8). Selected in the
+ * original (or in a reveal's original lines), the selection is the quote.
+ *
+ * @param article - the rendered article root.
+ * @param built - the translation segmentation, when there is one.
+ * @param selection - the selection to read (defaults to the window's).
+ * @returns the excerpt, or `null` when nothing in this article is selected.
+ */
+export declare function captureSelection(article: Element, built: BuiltArticle | null, selection?: Selection | null): NoteSelection | null;
+/**
+ * The article's original prose, one string per block, for the host snapshot.
+ *
+ * Parsed from the stored markup rather than read off the screen: the screen may
+ * be showing a translation, and the model must read what the author wrote.
+ *
+ * @param html - the article markup the pane renders.
+ * @returns the blocks' text (a bare-text body is one block).
+ */
+export declare function paragraphsOf(html: string, speakerLabel?: (speaker: number) => string): string[];
+/**
+ * Find a normalized string inside an element's text, as a DOM Range.
+ *
+ * The text is flattened with whitespace collapsed (the stored quote's form),
+ * keeping a map from each flattened character back to its node and offset.
+ *
+ * @param root - where to search.
+ * @param needle - the normalized text to find.
+ * @param skip - elements whose text does not count.
+ * @returns the range, or `null`.
+ */
+export declare function findText(root: Element, needle: string, skip?: (element: Element) => boolean): Range | null;
+/** True when two texts share content: one holds the other, or one runs into the other. */
+export declare function overlaps(left: string, right: string, edge?: number): boolean;
+/**
+ * Where each note is on screen right now.
+ *
+ * The anchored block is tried first; when the excerpt is not there (the
+ * article was refetched and moved), every block is searched. A note found
+ * nowhere maps to an empty list — the notes view says so.
+ *
+ * @param article - the rendered article root.
+ * @param built - the translation segmentation, when there is one.
+ * @param notes - the article's notes.
+ */
+export declare function noteRanges(article: Element, built: BuiltArticle | null, notes: readonly ReaderNote[]): Map<string, Range[]>;
+/**
+ * Paint (or clear) one named highlight.
+ *
+ * @param name - the registry name.
+ * @param ranges - the ranges to paint; empty clears it.
+ */
+export declare function paintHighlight(name: string, ranges: readonly Range[]): void;
+/** The article identity a discussion draft names. */
+export interface NotesDraftSource {
+    readonly entryId: string;
+    readonly title: string;
+    readonly source: string;
+    readonly link?: string;
+}
+/** The localized words a draft needs. */
+export interface NotesDraftWords {
+    readonly heading: (count: number) => string;
+    readonly comment: string;
+    readonly hint: (entryId: string) => string;
+}
+/**
+ * The discussion draft: the article, then each note as a quote with its comment.
+ *
+ * Notes carry their ¶ and id so the model can match them to `reader_read`'s
+ * output; the closing hint names the article id for the same reason.
+ *
+ * @param source - the article.
+ * @param notes - the notes to bring, in article order.
+ * @param words - the localized fragments.
+ */
+export declare function formatNotesDraft(source: NotesDraftSource, notes: readonly ReaderNote[], words: NotesDraftWords): string;
+/**
+ * Where a quote-menu「记笔记」lands.
+ *
+ * The quote menu lives in another package and hands its actions only the
+ * selected text; the pane that owns the selected article is found here, by
+ * asking each mounted pane whether the selection is inside its article.
+ */
+export interface NoteTarget {
+    /** True when this pane's article holds the node. */
+    readonly owns: (node: Node) => boolean;
+    /** Open the note sheet for the current selection. */
+    readonly start: () => void;
+}
+/** Register a pane as a note target; returns the disposer. */
+export declare function registerNoteTarget(target: NoteTarget): () => void;
+/** The pane whose article holds the current selection, when one does. */
+export declare function noteTargetForSelection(selection?: Selection | null): NoteTarget | undefined;
+//# sourceMappingURL=notes.d.ts.map