@lincyaw/workbench 0.2.0-rc.6 → 0.2.0-rc.60

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (90) hide show
  1. package/package.json +5 -4
  2. package/src/MediaClipEditor.tsx +4 -3
  3. package/src/StepProductionEditor.tsx +13 -4
  4. package/src/approvals.tsx +6 -1
  5. package/src/audio-recording.ts +27 -5
  6. package/src/authoring-client.ts +10 -10
  7. package/src/authoring-draft-fragment.ts +3 -1
  8. package/src/authoring-window.ts +100 -0
  9. package/src/body-draft-actions.ts +60 -0
  10. package/src/caption-timing-drafts.ts +18 -1
  11. package/src/component-property-drafts.ts +5 -5
  12. package/src/components.tsx +22 -31
  13. package/src/context.tsx +5 -3
  14. package/src/diagnostics.ts +1 -1
  15. package/src/document-draft-store.ts +45 -18
  16. package/src/document-drafts.ts +28 -19
  17. package/src/document-editing.ts +484 -0
  18. package/src/document-editor/BlockNoteSurface.tsx +25 -9
  19. package/src/document-editor/ComponentMaterials.tsx +3 -9
  20. package/src/document-editor/ComponentPropertiesDialog.tsx +4 -4
  21. package/src/document-editor/DocumentBlockPreview.tsx +4 -2
  22. package/src/document-editor/DocumentComments.tsx +85 -14
  23. package/src/document-editor/DocumentEditor.tsx +44 -7
  24. package/src/document-editor/DocumentStepNarration.tsx +33 -25
  25. package/src/document-editor/NarrationEditor.tsx +54 -20
  26. package/src/document-editor/NewCommentDrafts.tsx +114 -31
  27. package/src/document-editor/PlaceComment.tsx +228 -0
  28. package/src/document-editor/comment-draft-actions.ts +40 -20
  29. package/src/document-editor/comment-draft-inspection.ts +2 -2
  30. package/src/document-editor/comment-drafts.ts +73 -25
  31. package/src/document-editor/comments.ts +30 -10
  32. package/src/document-editor/component-label.ts +11 -0
  33. package/src/document-editor/file-input.ts +2 -2
  34. package/src/document-editor/focus.ts +0 -2
  35. package/src/document-editor/insertion-place.ts +60 -0
  36. package/src/document-editor/messages.ts +3 -3
  37. package/src/document-editor/narration-schema.tsx +12 -6
  38. package/src/document-editor/narration.ts +19 -3
  39. package/src/document-editor/page-body.ts +60 -0
  40. package/src/document-editor/projection.ts +2 -2
  41. package/src/document-editor/rich-text.ts +3 -2
  42. package/src/document-editor/selection.ts +13 -0
  43. package/src/document-editor/style.css +12 -1
  44. package/src/document-editor/table-identities.ts +2 -1
  45. package/src/document-production.ts +491 -0
  46. package/src/document-session.ts +193 -53
  47. package/src/document-timing-drafts.ts +22 -2
  48. package/src/history.ts +5 -5
  49. package/src/index.ts +6 -5
  50. package/src/jobs.ts +1 -1
  51. package/src/media-drafts.ts +43 -1
  52. package/src/messages.ts +19 -4
  53. package/src/panels/DocumentView.tsx +66 -26
  54. package/src/panels/DocumentVoiceDialog.tsx +25 -9
  55. package/src/panels/DocumentVoiceField.tsx +1 -1
  56. package/src/panels/ExportPanel.tsx +1 -6
  57. package/src/panels/HistoryPanel.tsx +1 -1
  58. package/src/panels/PageDeleteDialog.tsx +4 -4
  59. package/src/panels/PageRenameDialog.tsx +1 -1
  60. package/src/panels/PreviewPanel.tsx +1 -4
  61. package/src/panels/ProductionCaptionSize.tsx +20 -0
  62. package/src/panels/ProductionCaptionTiming.tsx +12 -9
  63. package/src/panels/ProductionMediaClips.tsx +23 -7
  64. package/src/panels/ProductionPanel.tsx +8 -4
  65. package/src/panels/ProductionRecording.tsx +86 -9
  66. package/src/panels/ProductionRecordingRange.tsx +21 -19
  67. package/src/panels/ProductionTimeline.tsx +6 -1
  68. package/src/panels/ProductionTranscription.tsx +5 -4
  69. package/src/panels/SourceDocumentPanel.tsx +12 -15
  70. package/src/panels/TranscriptionAdoption.tsx +40 -34
  71. package/src/panels/VoiceCloneDialog.tsx +2 -1
  72. package/src/panels/VoiceoverDialog.tsx +1 -1
  73. package/src/places.ts +1 -36
  74. package/src/preview-playback.ts +1 -1
  75. package/src/production-draft-actions.ts +37 -0
  76. package/src/production-messages.ts +6 -0
  77. package/src/production-playback.ts +1 -1
  78. package/src/production-voice-playback.ts +3 -2
  79. package/src/sha256.ts +9 -0
  80. package/src/styles.css +16 -41
  81. package/src/transcription-drafts.ts +124 -0
  82. package/src/use-recording-adoption.ts +2 -2
  83. package/src/voice-drafts.ts +32 -8
  84. package/src/voiceover-jobs.ts +1 -1
  85. package/src/workbench-state.ts +157 -0
  86. package/src/workbench.ts +254 -950
  87. package/src/workspace-client.ts +21 -11
  88. package/src/assistant-mascot.ts +0 -62
  89. package/src/mascot-preference.ts +0 -37
  90. package/src/panels/ChangeTrail.tsx +0 -79
@@ -9,11 +9,10 @@ import { DocumentBlockPreview } from '../document-editor/DocumentBlockPreview.ts
9
9
  import { nativeEditingCursor } from '../document-editor/selection.ts'
10
10
  import { hasBlockPreview } from '../document-editor/projection.ts'
11
11
  import type { NativeDocumentEditor } from '../document-editor/schema.tsx'
12
- import { isAgentChanging } from '../workbench.ts'
13
- import { EditorChangeTrail } from './ChangeTrail.tsx'
12
+ import { isAgentChanging } from '../workbench-state.ts'
14
13
 
15
14
  /** Source editing is available before the first successful runtime compilation. */
16
- export function SourceDocumentPanel({ commentsPortal, onCommentDraftRestore }: { commentsPortal?: HTMLElement | null, onCommentDraftRestore?(): void }) {
15
+ export function SourceDocumentPanel({ commentsPortal, onCommentDraftRestore, onOpenComments }: { commentsPortal?: HTMLElement | null, onCommentDraftRestore?(): void, onOpenComments?(): void }) {
17
16
  const workbench = useWorkbench(), t = useMessages()
18
17
  const source = useWorkbenchState(state => state.authoring)
19
18
  const sourceAcknowledged = () => {
@@ -26,7 +25,6 @@ export function SourceDocumentPanel({ commentsPortal, onCommentDraftRestore }: {
26
25
  const navigation = useWorkbenchState(state => state.documentNavigation)
27
26
  const readOnly = useWorkbenchState(state => state.mode !== 'editing' || workbench.client.capabilities?.readOnly === true || Boolean(state.authoring?.member && !hasRole(state.authoring.member, 'editor')) || Boolean(state.authoring?.loading) || isAgentChanging(state))
28
27
  const container = useRef<HTMLElement>(null)
29
- const sheet = useRef<HTMLDivElement>(null)
30
28
  const consumedNavigation = useRef<string>()
31
29
  const bodyEditor = useRef<NativeDocumentEditor>()
32
30
  const editingPosition = useRef<{ nativeBlockId: string, sectionId: string, position: number, editor: NativeDocumentEditor, identity: string, reset: number | undefined }>()
@@ -39,10 +37,10 @@ export function SourceDocumentPanel({ commentsPortal, onCommentDraftRestore }: {
39
37
  const recoveryDisabled = readOnly || source?.saving || source?.composing || source?.recovering
40
38
  useEffect(() => {
41
39
  const element = container.current
42
- if (element && source?.identity && source.content) return workbench.attachDocumentViewport(element, source.identity)
40
+ if (element && source?.identity && source.content) return workbench.editing.attachViewport(element, source.identity)
43
41
  }, [workbench, source?.identity, Boolean(source?.content)])
44
42
  // The editor applies `readOnly` while committing, so it is editable by the time this runs.
45
- useEffect(() => { if (!readOnly) workbench.documentEditorEditable() }, [workbench, readOnly])
43
+ useEffect(() => { if (!readOnly) workbench.editing.editorEditable() }, [workbench, readOnly])
46
44
  useEffect(() => {
47
45
  if (!navigation) return
48
46
  const request = JSON.stringify([source?.identity, navigation.request])
@@ -71,7 +69,7 @@ export function SourceDocumentPanel({ commentsPortal, onCommentDraftRestore }: {
71
69
  const viewport = measure(), state = workbench.getState()
72
70
  if (gesture.generation !== state.documentPositionToken || !sameGeometry(gesture.viewport, viewport) || gesture.viewport.top !== viewport.top) return
73
71
  if (!state.authoring?.loading && !isAgentChanging(state)) {
74
- const field = workbench.focusedDocumentField(), root = field?.editor.prosemirrorView.dom.getRootNode()
72
+ const field = workbench.editing.focusedField(), root = field?.editor.prosemirrorView.dom.getRootNode()
75
73
  if (field && root instanceof ShadowRoot && element.contains(root.host)) {
76
74
  try {
77
75
  const point = field.editor.prosemirrorView.coordsAtPos(field.editor.prosemirrorState.selection.head), bounds = element.getBoundingClientRect()
@@ -115,17 +113,17 @@ export function SourceDocumentPanel({ commentsPortal, onCommentDraftRestore }: {
115
113
  const scroll = (event: Event) => {
116
114
  const viewport = measure(), previous = baseline
117
115
  baseline = viewport
118
- if (workbench.consumeDocumentReturnScroll(element)) { cancel(); return }
116
+ if (workbench.editing.consumeReturnScroll(element)) { cancel(); return }
119
117
  // Native scroll chaining from an iframe has no parent wheel event.
120
118
  if (!event.isTrusted) return
121
119
  if (!sameGeometry(previous, viewport)) { cancel(); return }
122
120
  if (viewport.top === previous.top) return
123
- workbench.documentInteraction()
121
+ workbench.editing.interact()
124
122
  queue(viewport)
125
123
  }
126
124
  const interact = (event: Event) => {
127
125
  if (!event.isTrusted) return
128
- workbench.documentInteraction()
126
+ workbench.editing.interact()
129
127
  baseline = measure()
130
128
  queue(baseline)
131
129
  }
@@ -136,7 +134,7 @@ export function SourceDocumentPanel({ commentsPortal, onCommentDraftRestore }: {
136
134
  if (['Home', 'End'].includes(event.key) && target instanceof HTMLElement && target.isContentEditable && !event.ctrlKey && !event.metaKey) return
137
135
  interact(event)
138
136
  }
139
- const pointer = () => { cancel(); workbench.documentInteraction() }
137
+ const pointer = () => { cancel(); workbench.editing.interact() }
140
138
  element.addEventListener('scroll', scroll, { passive: true })
141
139
  element.addEventListener('wheel', interact, { passive: true })
142
140
  element.addEventListener('touchmove', interact, { passive: true })
@@ -176,9 +174,8 @@ export function SourceDocumentPanel({ commentsPortal, onCommentDraftRestore }: {
176
174
  {source?.issues.length ? <div className="pmw-source-document__diagnostics"><PmNotice tone="warn"><details><summary>{messages.diagnostics(source.issues.length)}</summary><ul>{source.issues.map((issue, index) => <li key={`${issue.path}:${index}`}><code>{issue.path}</code> {issue.message}</li>)}</ul></details></PmNotice></div> : null}
177
175
  {!source?.content || !source.identity ? source?.loading
178
176
  ? <div className="pmw-source-document__sheet pmw-source-document__sheet--loading"><PmSkeleton label={messages.loading} /></div>
179
- : <PmNotice tone="warn"><span>{messages.unavailable}</span><span className="pmw-notice__actions"><PmButton small onClick={() => void workbench.retryDocument()}>{t.retry}</PmButton></span></PmNotice> : <div ref={sheet} className="pmw-source-document__sheet">
180
- <EditorChangeTrail sheet={sheet} />
181
- <DocumentEditor acknowledged={sourceAcknowledged()} getDocumentAcknowledged={sourceAcknowledged} onCommentDraftRestore={onCommentDraftRestore} commentDrafts={workbench.documentCommentDrafts(source.identity)} identity={source.identity} document={source.content} version={source.version} member={source.member} getDocument={() => workbench.getDocument(source.identity)}
177
+ : <PmNotice tone="warn"><span>{messages.unavailable}</span><span className="pmw-notice__actions"><PmButton small onClick={() => void workbench.retryDocument()}>{t.retry}</PmButton></span></PmNotice> : <div className="pmw-source-document__sheet">
178
+ <DocumentEditor acknowledged={sourceAcknowledged()} getDocumentAcknowledged={sourceAcknowledged} onCommentDraftRestore={onCommentDraftRestore} onOpenComments={onOpenComments} commentDrafts={workbench.documentCommentDrafts(source.identity)} identity={source.identity} document={source.content} version={source.version} member={source.member} getDocument={() => workbench.getDocument(source.identity)}
182
179
  getDocumentVersion={() => { const current = workbench.getState().authoring; return current && current.identity === source.identity && current.reset === source.reset ? current.version : undefined }} reset={source.reset} locale={locale} readOnly={readOnly}
183
180
  uploadImage={(file, signal) => workbench.importDocumentImage(file, source.identity!, signal)}
184
181
  getPositionToken={() => workbench.getState().documentPositionToken}
@@ -200,7 +197,7 @@ export function SourceDocumentPanel({ commentsPortal, onCommentDraftRestore }: {
200
197
  commentsPortal={commentsPortal} onChange={document => workbench.recordDocument(document)} onReady={(editor, commands) => {
201
198
  bodyEditor.current = editor
202
199
  editingPosition.current = undefined
203
- workbench.attachDocumentEditor(editor, commands, { identity: source.identity!, reset: source.reset })
200
+ workbench.editing.attachEditor(editor, commands, { identity: source.identity!, reset: source.reset })
204
201
  }}
205
202
  onEditingPosition={(position, editor) => {
206
203
  const state = workbench.getState(), current = state.authoring
@@ -1,30 +1,19 @@
1
1
  import { useEffect, useMemo, useRef, useState } from 'react'
2
- import { prepareTranscriptionAdoption } from '@lincyaw/kernel'
2
+ import { prepareTranscriptionAdoption, randomUUID } from '@lincyaw/kernel'
3
3
  import type { CanonicalSource, NarrationNode, TeachingDocument, TranscriptionRevision, TranscriptionAdoptionDraft, TranscriptionAdoptionPart, TranscriptionAdoptionPlan } from '@lincyaw/kernel'
4
4
  import { PmBadge, PmButton, PmDialog, PmField, PmNotice, PmSelect, PmTextarea } from '../components.tsx'
5
5
  import { useWorkbench, useWorkbenchState } from '../context.tsx'
6
6
  import { NarrationEditor } from '../document-editor/NarrationEditor.tsx'
7
- import { narrationToNative } from '../document-editor/narration.ts'
7
+ import { narrationToNative, nativeToNarration } from '../document-editor/narration.ts'
8
8
  import type { NativeNarrationEditor } from '../document-editor/narration-schema.tsx'
9
9
  import { TRANSCRIPTION_MESSAGES } from '../transcription-messages.ts'
10
+ import { transcriptionCorrectionKey } from '../transcription-drafts.ts'
11
+ import type { TranscriptionCorrection as Draft } from '../transcription-drafts.ts'
10
12
 
11
13
  interface Props { identity: string, candidate: TranscriptionRevision, document: TeachingDocument, sectionId: string, stepId: string, disabled: boolean }
12
- interface Draft { id: string, revision: number, nodes?: NarrationNode[], discarded: string[], shared: 'fork' | 'edit-shared', baseVersion?: string, applied?: boolean }
13
14
  const ordered = (value: unknown): unknown => Array.isArray(value) ? value.map(ordered) : value && typeof value === 'object' ? Object.fromEntries(Object.keys(value).sort().map(key => [key, ordered((value as Record<string, unknown>)[key])])) : value
14
15
  const same = (a: unknown, b: unknown) => JSON.stringify(ordered(a)) === JSON.stringify(ordered(b))
15
16
  const displayed = (nodes: readonly NarrationNode[]) => nodes.map(node => node.type === 'text' ? node.text : node.type === 'pronunciation' ? node.display : '').join('')
16
- function restore(key: string): { draft: Draft, failed: boolean } {
17
- const fallback = () => ({ draft: { id: crypto.randomUUID(), revision: 0, discarded: [], shared: 'fork' as const }, failed: false })
18
- try {
19
- const raw = localStorage.getItem(key)
20
- if (!raw) return fallback()
21
- const value = JSON.parse(raw)
22
- if (!value || typeof value.id !== 'string' || !Number.isSafeInteger(value.revision) || value.revision < 0 || !Array.isArray(value.discarded) || !value.discarded.every((key: unknown) => typeof key === 'string') || !['fork', 'edit-shared'].includes(value.shared)
23
- || value.baseVersion !== undefined && typeof value.baseVersion !== 'string' || value.applied !== undefined && typeof value.applied !== 'boolean'
24
- || value.nodes !== undefined && (!Array.isArray(value.nodes) || !value.nodes.every((node: NarrationNode) => node && (node.type === 'text' && typeof node.text === 'string' || node.type === 'pronunciation' && typeof node.display === 'string' && typeof node.spoken === 'string' || node.type === 'cue' && typeof node.id === 'string' && typeof node.action === 'string')))) throw new Error('invalid-draft')
25
- return { draft: value, failed: false }
26
- } catch { return { ...fallback(), failed: true } }
27
- }
28
17
 
29
18
  export function TranscriptionAdoption(props: Props) {
30
19
  const locale = useWorkbenchState(state => state.locale), t = TRANSCRIPTION_MESSAGES[locale]
@@ -41,11 +30,27 @@ export function TranscriptionAdoption(props: Props) {
41
30
 
42
31
  function AdoptionTarget({ identity, candidate, document, sectionId, stepId, disabled, narrationId, segments }: Props & { narrationId?: string, segments: string[] }) {
43
32
  const workbench = useWorkbench(), locale = useWorkbenchState(state => state.locale), t = TRANSCRIPTION_MESSAGES[locale], source = useWorkbenchState(state => state.authoring)
44
- const key = `presmium.transcription-draft.v1:${JSON.stringify([identity, candidate.transcriptionId, candidate.revision, stepId, narrationId, segments])}`
45
- const [restored] = useState(() => restore(key)), [draft, setDraft] = useState(restored.draft), latest = useRef(draft)
33
+ const correctionTarget = useMemo(() => ({ identity, candidate: { id: candidate.transcriptionId, revision: candidate.revision }, stepId, narrationId, segmentIds: segments }), [identity, candidate.transcriptionId, candidate.revision, stepId, narrationId, JSON.stringify(segments)])
34
+ const correctionKey = transcriptionCorrectionKey(correctionTarget), key = `presmium.transcription-draft.v1:${correctionKey}`
35
+ const [restored] = useState(() => workbench.production.transcriptionCorrection(correctionTarget)), [draft, setDraft] = useState(restored.draft), latest = useRef(draft)
46
36
  const [storageFailed, setStorageFailed] = useState(restored.failed), [composing, setComposing] = useState(false)
47
37
  const [plan, setPlan] = useState<TranscriptionAdoptionPlan>(), [reviewing, setReviewing] = useState(false), [applying, setApplying] = useState(false), [open, setOpen] = useState(false), [failure, setFailure] = useState<string>(), [status, setStatus] = useState<string>()
48
- const editor = useRef<NativeNarrationEditor>(), generation = useRef(0)
38
+ const editor = useRef<NativeNarrationEditor>(), generation = useRef(0), interaction = useRef({ composing: false, pending: false }), unavailable = useRef(false)
39
+ unavailable.current = disabled || reviewing || applying || open
40
+ useEffect(() => workbench.production.registerDraftView({ identity, kind: 'transcription', has: target => target === correctionKey,
41
+ blocked: () => interaction.current.composing || interaction.current.pending || unavailable.current,
42
+ clear: () => {
43
+ generation.current++
44
+ const value = workbench.production.transcriptionCorrection(correctionTarget)
45
+ latest.current = value.draft; setDraft(value.draft); setStorageFailed(value.failed)
46
+ setPlan(undefined); setOpen(false); setFailure(undefined); setStatus(undefined)
47
+ } }), [workbench, identity, correctionKey])
48
+ useEffect(() => { workbench.refreshAuthoringClientControls() }, [workbench, disabled, reviewing, applying, open])
49
+ const busy = (value: boolean) => { interaction.current.pending = value; workbench.refreshAuthoringClientControls() }
50
+ const composition = (value: boolean) => {
51
+ if (interaction.current.composing === value) return
52
+ interaction.current.composing = value; setComposing(value); workbench.refreshAuthoringClientControls()
53
+ }
49
54
  useEffect(() => () => { generation.current++ }, [])
50
55
  const binding: CanonicalSource = { documentId: document.id, version: source?.version ?? '', fingerprint: source?.fingerprint ?? '' }
51
56
  const references = narrationId ? Object.values(document.steps).filter(step => step.narrationIds.includes(narrationId)).map(step => step.id) : []
@@ -76,46 +81,47 @@ function AdoptionTarget({ identity, candidate, document, sectionId, stepId, disa
76
81
  generation.current++
77
82
  const next = { ...latest.current, ...patch, revision: latest.current.revision + 1, applied: false }
78
83
  latest.current = next; setDraft(next); setPlan(undefined); setFailure(undefined); setStatus(undefined)
79
- try { localStorage.setItem(key, JSON.stringify(next)); setStorageFailed(false) } catch { setStorageFailed(true) }
84
+ setStorageFailed(!workbench.production.keepTranscriptionCorrection(correctionTarget, next))
80
85
  }
81
86
  const pause = () => { workbench.stopAuditions(); void workbench.pausePlayback().catch(() => {}) }
82
87
  const preview = async () => {
83
88
  const now = workbench.getState().authoring
84
89
  if (disabled || reviewing || applying || composing || !sourceReady || !now?.version || !now.fingerprint || parsed.invalid) return
85
90
  pause()
86
- if (latest.current.baseVersion && latest.current.baseVersion !== now.version) change({ id: crypto.randomUUID(), baseVersion: now.version })
91
+ if (latest.current.baseVersion && latest.current.baseVersion !== now.version) change({ id: randomUUID(), baseVersion: now.version })
87
92
  else if (!latest.current.baseVersion) change({ baseVersion: now.version })
88
93
  const value = latest.current, request = ++generation.current, normalized = content()
89
94
  const retainsOriginal = references.length > 1 && value.shared === 'fork'
90
95
  const removeCueTimings = atoms.filter(atom => value.discarded.includes(atom.key) && atom.node.type === 'cue' && !retainsOriginal && Object.hasOwn(document.production.cueTimings ?? {}, atom.node.id)).map(atom => (atom.node as Extract<NarrationNode, { type: 'cue' }>).id)
91
96
  const sent: TranscriptionAdoptionDraft = { id: value.id, source: { documentId: document.id, version: now.version, fingerprint: now.fingerprint }, candidate: { id: candidate.transcriptionId, revision: candidate.revision }, draftRevision: value.revision, targets: [{ ...target, content: normalized.parts, discardAtoms: value.discarded.filter(key => atoms.some(atom => atom.key === key)) }], ...removeCueTimings.length ? { removeCueTimings } : {} }
92
- setReviewing(true); setFailure(undefined)
97
+ busy(true); setReviewing(true); setFailure(undefined)
93
98
  try {
94
- const answer = await workbench.planDocumentTranscription(sent, { identity, version: now.version })
99
+ const answer = await workbench.production.planTranscription(sent, { identity, version: now.version })
95
100
  if (request !== generation.current || latest.current.revision !== sent.draftRevision) return
96
101
  setPlan(answer); setOpen(true)
97
102
  } catch { if (request === generation.current) setFailure(t.previewFailed) }
98
- finally { setReviewing(false) }
103
+ finally { busy(false); setReviewing(false) }
99
104
  }
100
105
  const apply = async () => {
101
106
  if (!plan?.planId || !planCurrent || plan.conflicts.length || plan.draftRevision !== latest.current.revision || composing || applying || !sourceReady) return
102
- const sent = plan, planId = plan.planId
103
- setApplying(true); setFailure(undefined)
107
+ const sent = plan, planId = plan.planId, expected = latest.current, request = ++generation.current
108
+ busy(true); setApplying(true); setFailure(undefined)
104
109
  try {
105
- const answer = await workbench.adoptDocumentTranscription({ planId, source: sent.source, candidate: sent.candidate, draftRevision: sent.draftRevision }, { identity, version: sent.source.version })
106
- if (latest.current.id === sent.changeId && latest.current.revision === sent.draftRevision) {
107
- const next: Draft = { ...latest.current, id: crypto.randomUUID(), revision: 0, discarded: [], baseVersion: answer.version, applied: true }
108
- latest.current = next; setDraft(next)
109
- try { localStorage.setItem(key, JSON.stringify(next)); setStorageFailed(false) } catch { setStorageFailed(true) }
110
- }
110
+ const answer = await workbench.production.adoptTranscription({ planId, source: sent.source, candidate: sent.candidate, draftRevision: sent.draftRevision }, { identity, version: sent.source.version })
111
+ const next: Draft = { ...expected, id: randomUUID(), revision: 0, discarded: [], baseVersion: answer.version, applied: true }
112
+ const completed = workbench.production.completeTranscriptionCorrection(correctionTarget, expected, next)
113
+ if (request !== generation.current) return
114
+ if (completed) { latest.current = next; setDraft(next) }
115
+ setStorageFailed(!completed)
111
116
  setPlan(undefined); setOpen(false); setStatus(t.adopted)
112
117
  } catch { setFailure(t.applyFailed) }
113
- finally { setApplying(false) }
118
+ finally { busy(false); setApplying(false) }
114
119
  }
115
120
  if (!displayed(nodes).trim() && !atoms.length) return <span>{t.empty}</span>
116
121
  return <>
117
- <PmField label={t.text} group><NarrationEditor identity={key} narrationId={original?.outputNarrationId ?? draft.id} content={nodes} getContent={() => latest.current.nodes ?? nodes} locale={locale} advanced={false} readOnly={disabled || applying}
118
- onReady={value => { editor.current = value }} onComposition={setComposing} onFocus={pause} onChange={value => {
122
+ <PmField label={t.text} group><NarrationEditor identity={key} fieldId={original?.outputNarrationId ?? draft.id} content={nodes} getContent={() => latest.current.nodes ?? nodes} locale={locale} advanced={false} readOnly={disabled || applying}
123
+ toNative={value => narrationToNative(original?.outputNarrationId ?? draft.id, value)} fromNative={nativeToNarration}
124
+ onReady={value => { editor.current = value }} onComposition={composition} onFocus={pause} onChange={value => {
119
125
  const used = new Set<string>()
120
126
  for (const node of value) { const atom = atoms.find(atom => !used.has(atom.key) && same(atom.node, node)); if (atom) used.add(atom.key) }
121
127
  change({ nodes: value, discarded: latest.current.discarded.filter(key => !used.has(key)) })
@@ -40,9 +40,10 @@ function RecordingSlot({ label, hint, value, disabled, onChange }: { label: stri
40
40
  const capturing = ['requesting', 'recording', 'stopping'].includes(state.phase)
41
41
  const start = () => {
42
42
  setFailure(undefined)
43
- void recording.start(async () => {
43
+ void recording.start(async signal => {
44
44
  workbench.stopAuditions()
45
45
  await workbench.pausePlayback()
46
+ signal.throwIfAborted()
46
47
  return workbench.registerAudioCapture(() => recording.stop())
47
48
  })
48
49
  }
@@ -8,7 +8,7 @@ import type { DocumentVoiceScope } from '../document-voices.ts'
8
8
  import { VOICE_MESSAGES, voiceFailure } from '../voice-messages.ts'
9
9
  import { prepareVoiceSnapshot, runtimeVoiceScope, voiceSnapshotCurrent } from '../voice-snapshot.ts'
10
10
  import type { VoiceSnapshot } from '../voice-snapshot.ts'
11
- import { isAgentChanging } from '../workbench.ts'
11
+ import { isAgentChanging } from '../workbench-state.ts'
12
12
  import { VoiceScopeField } from './VoiceScopeField.tsx'
13
13
 
14
14
  interface CheckedVoice { snapshot: VoiceSnapshot, document: TeachingDocument }
package/src/places.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { irBlocks } from '@lincyaw/kernel'
2
- import type { IRDocument, PreviewAnchor, ReviewChange, SourcePos, TeachingDocument } from '@lincyaw/kernel'
2
+ import type { IRDocument, PreviewAnchor, ReviewChange, SourcePos } from '@lincyaw/kernel'
3
3
 
4
4
  const CHANGED_PLACES = 100
5
5
 
@@ -65,38 +65,3 @@ export function changedPlaces(doc: IRDocument, changes: readonly ReviewChange[])
65
65
  }
66
66
  return [...places.values()].slice(0, CHANGED_PLACES)
67
67
  }
68
-
69
- /**
70
- * The places that differ between two versions of a document: each block whose content changed or that is new (with
71
- * its page), each page whose title changed or that is new, and the block of each step whose narration or settings
72
- * changed, at most CHANGED_PLACES.
73
- */
74
- export function changedBlocks(before: TeachingDocument, after: TeachingDocument): PreviewAnchor[] {
75
- const places: PreviewAnchor[] = []
76
- const visit = (section: string, ids: readonly string[]) => {
77
- for (const id of ids) {
78
- const block = after.blocks[id]
79
- if (!block) continue
80
- if (JSON.stringify(block) !== JSON.stringify(before.blocks[id])) places.push({ section, block: id })
81
- if ('children' in block && Array.isArray(block.children)) visit(section, block.children as string[])
82
- }
83
- }
84
- for (const id of after.sectionOrder) {
85
- const section = after.sections[id]
86
- if (!section) continue
87
- if (before.sections[id]?.title !== section.title) places.push({ section: id })
88
- visit(id, section.children)
89
- }
90
- // A changed step, or a changed narration of it, shows at the block the step plays (else at its page).
91
- const seen = new Set(places.map(place => `${place.section}\0${place.block ?? ''}`))
92
- for (const step of Object.values(after.steps)) {
93
- const narrated = step.narrationIds.some(id => JSON.stringify(after.narrations[id]) !== JSON.stringify(before.narrations[id]))
94
- if (!narrated && JSON.stringify(step) === JSON.stringify(before.steps[step.id])) continue
95
- // the component the step plays, where its narration shows, else any block it shows
96
- const block = step.visuals.find(visual => after.blocks[visual.blockId]?.type === 'component')?.blockId ?? step.visuals.find(visual => visual.visible)?.blockId ?? step.visuals[0]?.blockId
97
- const place = { section: step.sectionId, ...block ? { block } : {} }
98
- const key = `${place.section}\0${place.block ?? ''}`
99
- if (!seen.has(key)) { seen.add(key); places.push(place) }
100
- }
101
- return places.slice(0, CHANGED_PLACES)
102
- }
@@ -1,5 +1,5 @@
1
1
  import type { PreviewReport } from '@lincyaw/kernel'
2
- import type { PreviewSink } from './workbench.ts'
2
+ import type { PreviewSink } from './workbench-state.ts'
3
3
 
4
4
  interface PlaybackContext { document?: string, scope: number, sinks: ReadonlySet<PreviewSink> }
5
5
  interface PendingPause {
@@ -0,0 +1,37 @@
1
+ import type { AuthoringClientAction, AuthoringClientActionResult } from '@lincyaw/kernel'
2
+ import { authoringDraftFragment, draftContentHash } from './authoring-draft-fragment.ts'
3
+ import type { DocumentProduction } from './document-production.ts'
4
+
5
+ /** Explicit reads use the native pending values; discard never submits production changes. */
6
+ export async function executeProductionDraftAction(owner: DocumentProduction, action: Extract<AuthoringClientAction, { type: `production-drafts.${string}` }>, signal: AbortSignal, owned: () => void, fits: (value: AuthoringClientActionResult) => boolean): Promise<AuthoringClientActionResult> {
7
+ const snapshot = owner.productionDraftSnapshot()
8
+ const guard = () => { signal.throwIfAborted(); owned(); snapshot.guard() }
9
+ const values = await Promise.all(snapshot.candidates.map(async candidate => ({ candidate, metadata: { ...candidate.metadata, draft: await draftContentHash(JSON.stringify([snapshot.stamp, candidate.key])) } })))
10
+ guard()
11
+ if (action.type === 'production-drafts.inspect') {
12
+ const token = await draftContentHash(JSON.stringify([snapshot.coverage, values.map(value => value.metadata)]))
13
+ guard()
14
+ if (action.cursor && action.cursor.token !== token) throw new Error('client-production-drafts-changed')
15
+ const start = action.cursor ? values.findIndex(value => value.metadata.draft === action.cursor!.after) + 1 : 0
16
+ if (action.cursor && !start) throw new Error('client-production-drafts-changed')
17
+ const result: Extract<AuthoringClientActionResult, { type: 'production-drafts.inspect' }> = { type: action.type, family: 'production', coverage: snapshot.coverage, token, drafts: [] }
18
+ for (const value of values.slice(start, start + (action.limit ?? 10))) {
19
+ const next = { ...result, drafts: [...result.drafts, value.metadata], ...start + result.drafts.length + 1 < values.length ? { next: { after: value.metadata.draft, token } } : {} }
20
+ if (!fits(next)) break
21
+ result.drafts.push(value.metadata)
22
+ }
23
+ if (start < values.length && !result.drafts.length) throw new Error('client-production-metadata-too-large')
24
+ if (start + result.drafts.length < values.length) result.next = { after: result.drafts.at(-1)!.draft, token }
25
+ if (!fits(result)) throw new Error('client-production-metadata-too-large')
26
+ guard(); return result
27
+ }
28
+ const selected = values.filter(value => value.metadata.draft === action.draft)
29
+ if (selected.length !== 1) throw new Error('client-production-drafts-changed')
30
+ const candidate = selected[0]!.candidate
31
+ if (action.type === 'production-drafts.read') return authoringDraftFragment({ text: JSON.stringify({ kind: candidate.metadata.kind, stepId: candidate.metadata.stepId, ...candidate.metadata.field ? { field: candidate.metadata.field } : {}, value: candidate.value }),
32
+ base: { type: action.type, family: 'production', draft: action.draft, format: 'presmium-production-draft-json-v1' }, offset: action.offset, maxChars: action.maxChars }, guard, fits)
33
+ const result: AuthoringClientActionResult = { type: action.type, family: 'production', draft: action.draft, discarded: true }
34
+ if (!fits(result)) throw new Error('client-production-result-too-large')
35
+ guard(); candidate.discard(); signal.throwIfAborted(); owned()
36
+ return result
37
+ }
@@ -57,6 +57,9 @@ const zh = {
57
57
  alignmentStatus: { manual: '手动时间', words: '词时码', proportional: '比例估时', none: '未对齐' },
58
58
  segmentStatus: { recorded: '原音频', cached: '已有配音', silent: '静音', missing: '配音待生成', blocked: '暂不可用' },
59
59
  waveformLoading: '正在加载波形…', waveformUnavailable: '波形不可用', stepNumber: (index: number) => `步骤 ${index + 1}`,
60
+ notInLecture: '不在讲授中', notInLectureHint: '这一页的内容都限定在其他形态,又没有讲稿与音频,讲授视频中没有这一页。',
61
+ notInLectureStep: '这一步不在讲授中:它的内容都限定在其他形态,又没有讲稿与音频。',
62
+ captionSize: '字幕大小', captionSizeHint: '整个文稿的字幕:放映中显示的与导出视频中烧录的都按这个大小。',
60
63
  timelineLabels: { position: '位置', seconds: '秒', seek: '播放头位置', zoomIn: '放大时间线', zoomOut: '缩小时间线', fit: '适配本页', estimated: '估计时长', unknown: '时长未知', loading: '正在加载时间线…', empty: '当前页暂无时间线片段', seekHint: '选择步骤,或用时间尺、方向键和精确时间定位;定位会先暂停播放。', invalidPosition: '请输入本页时长范围内的秒数。' },
61
64
  failures: {
62
65
  'production-source-changed': '文稿已更新,旧播放请求已停止。请重新准备当前版本。',
@@ -129,6 +132,9 @@ export const PRODUCTION_MESSAGES: Record<Locale, typeof zh> = {
129
132
  alignmentStatus: { manual: 'Manual timing', words: 'Word timing', proportional: 'Proportional timing', none: 'Unaligned' },
130
133
  segmentStatus: { recorded: 'Original audio', cached: 'Voiceover cached', silent: 'Silent', missing: 'Voiceover needed', blocked: 'Unavailable' },
131
134
  waveformLoading: 'Loading waveform…', waveformUnavailable: 'Waveform unavailable', stepNumber: index => `Step ${index + 1}`,
135
+ notInLecture: 'Not in the lecture', notInLectureHint: 'Everything on this page is limited to other forms and it has no script or audio, so the lecture video leaves it out.',
136
+ notInLectureStep: 'This step is not in the lecture: everything on it is limited to other forms and it has no script or audio.',
137
+ captionSize: 'Caption size', captionSizeHint: 'For the whole document: captions shown in the presentation and burned into an exported video use this size.',
132
138
  timelineLabels: { position: 'Position', seconds: 'seconds', seek: 'Playhead position', zoomIn: 'Zoom In Timeline', zoomOut: 'Zoom Out Timeline', fit: 'Fit Page', estimated: 'Estimated duration', unknown: 'Unknown duration', loading: 'Loading the timeline…', empty: 'This page has no timeline segments', seekHint: 'Select a step, or use the ruler, arrow keys, or an exact time to seek. Seeking pauses playback first.', invalidPosition: 'Enter a time in seconds within this page’s duration.' },
133
139
  failures: {
134
140
  'production-source-changed': 'The document changed and the old playback request stopped. Prepare the current version.',
@@ -1,6 +1,6 @@
1
1
  import type { PreviewReport, ProductionBinding, ProductionPlaybackCommand, ProductionPlaybackState } from '@lincyaw/kernel'
2
2
  import { sameProductionBinding } from '@lincyaw/kernel'
3
- import type { PreviewSink } from './workbench.ts'
3
+ import type { PreviewSink } from './workbench-state.ts'
4
4
 
5
5
  interface Context {
6
6
  document?: string
@@ -4,8 +4,9 @@ import type { ProductionPlan, ProductionPlaybackPosition, VoiceoverJob } from '@
4
4
  import { useWorkbench, useWorkbenchState } from './context.tsx'
5
5
  import { prepareVoiceSnapshot, voiceSnapshotCurrent } from './voice-snapshot.ts'
6
6
  import { voiceFailure } from './voice-messages.ts'
7
- import type { Workbench, WorkbenchState } from './workbench.ts'
8
- import { isAgentChanging } from './workbench.ts'
7
+ import type { Workbench } from './workbench.ts'
8
+ import type { WorkbenchState } from './workbench-state.ts'
9
+ import { isAgentChanging } from './workbench-state.ts'
9
10
 
10
11
  const running = (job: VoiceoverJob) => ['queued', 'running', 'cancelling'].includes(job.state)
11
12
 
package/src/sha256.ts ADDED
@@ -0,0 +1,9 @@
1
+ import { sha256 as hash } from '@noble/hashes/sha2.js'
2
+ import { bytesToHex } from '@noble/hashes/utils.js'
3
+
4
+ /** The same SHA-256 fingerprint on HTTPS, localhost and LAN HTTP. */
5
+ export async function sha256(value: string | ArrayBuffer): Promise<string> {
6
+ const bytes = typeof value === 'string' ? new TextEncoder().encode(value) : new Uint8Array(value)
7
+ const subtle = globalThis.crypto?.subtle
8
+ return bytesToHex(subtle ? new Uint8Array(await subtle.digest('SHA-256', bytes)) : hash(bytes))
9
+ }
package/src/styles.css CHANGED
@@ -265,20 +265,24 @@
265
265
  color: var(--pm-color-danger);
266
266
  }
267
267
 
268
- .pmw-problems__details summary {
269
- color: var(--pm-color-muted);
270
- font-size: var(--pm-text-xs);
271
- cursor: pointer;
272
- }
273
-
274
- .pmw-problems__details ul {
275
- margin: var(--pm-space-1) 0 0;
268
+ .pmw-problems__list {
269
+ display: flex;
270
+ flex-direction: column;
271
+ gap: var(--pm-space-3);
272
+ margin: 0;
276
273
  padding-left: var(--pm-space-4);
277
- font-family: var(--pm-font-mono);
278
- font-size: var(--pm-text-xs);
279
274
  overflow-wrap: anywhere;
280
275
  }
281
276
 
277
+ .pmw-problems__list p {
278
+ margin: 0;
279
+ }
280
+
281
+ .pmw-problems__hint {
282
+ color: var(--pm-color-muted);
283
+ font-size: var(--pm-text-sm);
284
+ }
285
+
282
286
  .pmw-document__body {
283
287
  display: flex;
284
288
  flex: 1;
@@ -820,17 +824,6 @@
820
824
  accent-color: var(--pm-color-accent);
821
825
  }
822
826
 
823
- /* The kitten above the bar, as far along it as the job has come (`--pmw-job-done`, 0 to 1), never past its ends. */
824
- .pmw-job__runner {
825
- display: block;
826
- margin-left: calc((100% - var(--pm-size-mascot-sm)) * var(--pmw-job-done));
827
- line-height: 0;
828
- }
829
-
830
- .pmw-job__runner:empty {
831
- display: none;
832
- }
833
-
834
827
  .pmw-job__error {
835
828
  margin: 0;
836
829
  color: var(--pm-color-danger);
@@ -931,7 +924,8 @@
931
924
  .pmw-source-document__recovery { display: grid; gap: var(--pm-space-2); min-width: 0; }
932
925
  .pmw-source-document__recovery-actions { display: flex; flex-wrap: wrap; gap: var(--pm-space-2); }
933
926
  .pmw-source-document__diagnostics { margin-block-end: var(--pm-space-3); }
934
- .pmw-source-document__sheet { position: relative; max-width: var(--pm-sheet-width); min-height: 100%; margin-inline: auto; padding-block: var(--pm-space-4); background: var(--pm-color-surface); box-shadow: var(--pm-shadow-page); }
927
+ /* Its end margin is the editor's own end area, which fills the rest of the sheet and takes the presses below the last block. */
928
+ .pmw-source-document__sheet { display: flex; flex-direction: column; max-width: var(--pm-sheet-width); min-height: 100%; margin-inline: auto; padding-block-start: var(--pm-space-4); background: var(--pm-color-surface); box-shadow: var(--pm-shadow-page); }
935
929
  /* Opening: the page's own margins, so that the placeholder lines sit where the text will. */
936
930
  .pmw-source-document__sheet--loading { box-sizing: border-box; padding: var(--pm-space-10) var(--pm-space-12); }
937
931
  .pmw-voice__filters { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: var(--pm-space-3); }
@@ -1004,22 +998,3 @@
1004
998
  .pmw-approvals .pmw-muted { margin: 0; }
1005
999
  .pmw-approvals__detail { max-height: 30vh; margin: 0; overflow: auto; white-space: pre-wrap; overflow-wrap: anywhere; }
1006
1000
  .pmw-approvals__actions { display: flex; flex-wrap: wrap; justify-content: flex-end; gap: var(--pm-space-2); }
1007
-
1008
- /* The kitten walking over the preview to the blocks the AI changed: its ground line meets the block's lower left. */
1009
- .pmw-change-trail {
1010
- position: absolute;
1011
- top: 0;
1012
- left: 0;
1013
- z-index: 1;
1014
- pointer-events: none;
1015
- transform: translate(calc(var(--pmw-trail-x) - 45%), calc(var(--pmw-trail-y) - 89%));
1016
- transition: transform var(--pm-duration-walk) linear, opacity var(--pm-duration-slow);
1017
- }
1018
-
1019
- .pmw-change-trail[data-phase='done'] {
1020
- opacity: 0.9;
1021
- }
1022
-
1023
- .pmw-change-trail__facing[data-facing='left'] {
1024
- transform: scaleX(-1);
1025
- }
@@ -0,0 +1,124 @@
1
+ import { isRecord, randomUUID } from '@lincyaw/kernel'
2
+ import type { NarrationNode, TranscriptionAdoptionDraft } from '@lincyaw/kernel'
3
+
4
+ export interface TranscriptionCorrection { id: string, revision: number, nodes?: NarrationNode[], discarded: string[], shared: 'fork' | 'edit-shared', baseVersion?: string, applied?: boolean }
5
+ export interface TranscriptionCorrectionTarget { identity: string, candidate: TranscriptionAdoptionDraft['candidate'], stepId: string, narrationId?: string, segmentIds: string[] }
6
+ interface Entry { target: TranscriptionCorrectionTarget, draft?: TranscriptionCorrection, raw?: string | null, failed: boolean, corrupt: boolean }
7
+ const prefix = 'presmium.transcription-draft.v1:'
8
+ export const transcriptionCorrectionKey = (target: TranscriptionCorrectionTarget): string => JSON.stringify([target.identity, target.candidate.id, target.candidate.revision, target.stepId, target.narrationId ?? null, target.segmentIds])
9
+ const fresh = (): TranscriptionCorrection => ({ id: randomUUID(), revision: 0, discarded: [], shared: 'fork' })
10
+ function valid(value: unknown): value is TranscriptionCorrection {
11
+ return isRecord(value) && typeof value.id === 'string' && Number.isSafeInteger(value.revision) && Number(value.revision) >= 0 && Array.isArray(value.discarded) && value.discarded.every(key => typeof key === 'string') && ['fork', 'edit-shared'].includes(String(value.shared))
12
+ && (value.baseVersion === undefined || typeof value.baseVersion === 'string') && (value.applied === undefined || typeof value.applied === 'boolean')
13
+ && (value.nodes === undefined || Array.isArray(value.nodes) && value.nodes.every(node => isRecord(node) && (node.type === 'text' && typeof node.text === 'string' || node.type === 'pronunciation' && typeof node.display === 'string' && typeof node.spoken === 'string' || node.type === 'cue' && typeof node.id === 'string' && typeof node.action === 'string')))
14
+ }
15
+ function parseTarget(key: string): TranscriptionCorrectionTarget | undefined {
16
+ try {
17
+ const value: unknown = JSON.parse(key)
18
+ if (!Array.isArray(value) || value.length !== 6) return
19
+ const [identity, id, revision, stepId, narrationId, segmentIds] = value
20
+ if (typeof identity !== 'string' || typeof id !== 'string' || typeof revision !== 'string' || typeof stepId !== 'string' || narrationId !== null && typeof narrationId !== 'string' || !Array.isArray(segmentIds) || !segmentIds.every(id => typeof id === 'string')) return
21
+ return { identity, candidate: { id, revision }, stepId, ...narrationId !== null ? { narrationId } : {}, segmentIds }
22
+ } catch { return }
23
+ }
24
+
25
+ /** The native correction bank uses its existing localStorage keys; no MCP copy or provider result is changed. */
26
+ export class TranscriptionCorrections {
27
+ readonly #entries = new Map<string, Entry>()
28
+ #load(target: TranscriptionCorrectionTarget): Entry {
29
+ const key = transcriptionCorrectionKey(target), known = this.#entries.get(key)
30
+ if (known) return known
31
+ const entry: Entry = { target: structuredClone(target), failed: false, corrupt: false }
32
+ this.#entries.set(key, entry)
33
+ try {
34
+ entry.raw = localStorage.getItem(prefix + key)
35
+ if (entry.raw !== null) {
36
+ const value: unknown = JSON.parse(entry.raw)
37
+ if (!valid(value)) throw new Error('invalid-draft')
38
+ entry.draft = value
39
+ }
40
+ } catch { entry.failed = true; entry.corrupt = entry.raw != null }
41
+ return entry
42
+ }
43
+ read(target: TranscriptionCorrectionTarget): { draft: TranscriptionCorrection, failed: boolean } {
44
+ const entry = this.#load(target)
45
+ // A reopened native form adopts another window's saved value, retaining failed local input.
46
+ try {
47
+ const raw = localStorage.getItem(prefix + transcriptionCorrectionKey(target))
48
+ if (raw !== entry.raw && !(entry.failed && entry.draft)) {
49
+ const value: unknown = raw === null ? undefined : JSON.parse(raw)
50
+ if (value !== undefined && !valid(value)) throw new Error('invalid-draft')
51
+ entry.raw = raw; entry.draft = value as TranscriptionCorrection | undefined; entry.failed = false; entry.corrupt = false
52
+ } else if (raw !== entry.raw) entry.failed = true
53
+ } catch { entry.failed = true }
54
+ return { draft: entry.draft ? structuredClone(entry.draft) : fresh(), failed: entry.failed }
55
+ }
56
+ keep(target: TranscriptionCorrectionTarget, draft: TranscriptionCorrection): boolean {
57
+ if (!valid(draft)) throw new Error('invalid-draft')
58
+ const entry = this.#load(target), key = prefix + transcriptionCorrectionKey(target)
59
+ entry.draft = structuredClone(draft)
60
+ try {
61
+ if (entry.raw === undefined || localStorage.getItem(key) !== entry.raw) throw new Error('changed-draft')
62
+ if (entry.corrupt && entry.raw != null) localStorage.setItem(key + ':unreadable', entry.raw)
63
+ const raw = JSON.stringify(draft)
64
+ localStorage.setItem(key, raw)
65
+ entry.raw = raw; entry.failed = false; entry.corrupt = false
66
+ return true
67
+ } catch { entry.failed = true; return false }
68
+ }
69
+ /** A completed native adoption cannot retire input changed in another form/window while it ran. */
70
+ complete(target: TranscriptionCorrectionTarget, expected: TranscriptionCorrection, next: TranscriptionCorrection): boolean {
71
+ const key = transcriptionCorrectionKey(target), entry = this.#entries.get(key)
72
+ if (!entry || entry.corrupt || JSON.stringify(entry.draft) !== JSON.stringify(expected)) return false
73
+ try {
74
+ if (entry.raw === undefined || localStorage.getItem(prefix + key) !== entry.raw) return false
75
+ const raw = JSON.stringify(next)
76
+ localStorage.setItem(prefix + key, raw)
77
+ entry.raw = raw; entry.draft = structuredClone(next); entry.failed = false
78
+ return true
79
+ } catch { entry.failed = true; return false }
80
+ }
81
+ discard(key: string, expected: TranscriptionCorrection): boolean {
82
+ const entry = this.#entries.get(key)
83
+ if (!entry || entry.corrupt || JSON.stringify(entry.draft) !== JSON.stringify(expected)) return false
84
+ try {
85
+ if (entry.raw === undefined || localStorage.getItem(prefix + key) !== entry.raw) return false
86
+ localStorage.removeItem(prefix + key)
87
+ this.#entries.delete(key)
88
+ return true
89
+ } catch { entry.failed = true; return false }
90
+ }
91
+ snapshot(identity: string) {
92
+ const keys = new Set([...this.#entries].filter(([, entry]) => entry.target.identity === identity).map(([key]) => key))
93
+ let partial = false
94
+ const head = prefix + JSON.stringify([identity]).slice(0, -1) + ','
95
+ try {
96
+ for (let i = 0; i < localStorage.length; i++) {
97
+ const key = localStorage.key(i)
98
+ if (key?.startsWith(head) && !key.endsWith(':unreadable')) keys.add(key.slice(prefix.length))
99
+ }
100
+ } catch { partial = true }
101
+ const entries: { key: string, target: TranscriptionCorrectionTarget, draft: TranscriptionCorrection, persisted: boolean }[] = [], observed: [string, string | null][] = []
102
+ for (const key of keys) {
103
+ const target = parseTarget(key)
104
+ if (!target || target.identity !== identity) { partial = true; continue }
105
+ const entry = this.#load(target)
106
+ let persisted = false
107
+ try {
108
+ const raw = localStorage.getItem(prefix + key)
109
+ observed.push([key, raw])
110
+ persisted = !entry.failed && !entry.corrupt && raw === entry.raw
111
+ if (raw !== entry.raw) partial = true
112
+ } catch { partial = true }
113
+ if (entry.corrupt || entry.raw === undefined) partial = true
114
+ if (entry.draft && !entry.draft.applied) entries.push({ key, target: structuredClone(target), draft: structuredClone(entry.draft), persisted })
115
+ }
116
+ return { entries, partial, guard: () => {
117
+ for (const [key, raw] of observed) {
118
+ try { if (localStorage.getItem(prefix + key) === raw) continue } catch { /* Cannot verify the same persisted input. */ }
119
+ throw new Error('client-production-drafts-changed')
120
+ }
121
+ } }
122
+ }
123
+ close(): void { this.#entries.clear() }
124
+ }