@lincyaw/workbench 0.2.0-rc.10 → 0.2.0-rc.101

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 (100) hide show
  1. package/package.json +5 -4
  2. package/src/AgentActivityBar.tsx +25 -0
  3. package/src/MediaClipEditor.tsx +4 -3
  4. package/src/StepProductionEditor.tsx +13 -4
  5. package/src/agent-activity-messages.ts +14 -0
  6. package/src/agent-activity.ts +38 -0
  7. package/src/approvals.tsx +6 -1
  8. package/src/audio-recording.ts +27 -5
  9. package/src/authoring-client.ts +10 -10
  10. package/src/authoring-draft-fragment.ts +3 -1
  11. package/src/authoring-window.ts +100 -0
  12. package/src/body-draft-actions.ts +60 -0
  13. package/src/caption-timing-drafts.ts +18 -1
  14. package/src/component-property-drafts.ts +5 -5
  15. package/src/components.tsx +34 -36
  16. package/src/container-layout.ts +21 -0
  17. package/src/context.tsx +5 -3
  18. package/src/diagnostics.ts +1 -1
  19. package/src/document-draft-store.ts +45 -18
  20. package/src/document-drafts.ts +28 -19
  21. package/src/document-editing.ts +484 -0
  22. package/src/document-editor/BlockNoteSurface.tsx +25 -9
  23. package/src/document-editor/CommentComposer.tsx +24 -0
  24. package/src/document-editor/ComponentMaterials.tsx +3 -9
  25. package/src/document-editor/ComponentPropertiesDialog.tsx +4 -4
  26. package/src/document-editor/DocumentBlockPreview.tsx +11 -4
  27. package/src/document-editor/DocumentComments.tsx +85 -14
  28. package/src/document-editor/DocumentEditor.tsx +56 -7
  29. package/src/document-editor/DocumentStepNarration.tsx +37 -26
  30. package/src/document-editor/NarrationEditor.tsx +54 -20
  31. package/src/document-editor/NewCommentDrafts.tsx +120 -37
  32. package/src/document-editor/PlaceComment.tsx +252 -0
  33. package/src/document-editor/agent-targets.ts +34 -0
  34. package/src/document-editor/blocknote-messages.ts +2 -0
  35. package/src/document-editor/comment-draft-actions.ts +40 -20
  36. package/src/document-editor/comment-draft-inspection.ts +2 -2
  37. package/src/document-editor/comment-drafts.ts +73 -25
  38. package/src/document-editor/comments.ts +30 -10
  39. package/src/document-editor/component-label.ts +11 -0
  40. package/src/document-editor/file-input.ts +2 -2
  41. package/src/document-editor/focus.ts +0 -2
  42. package/src/document-editor/insertion-place.ts +60 -0
  43. package/src/document-editor/messages.ts +3 -3
  44. package/src/document-editor/narration-schema.tsx +12 -6
  45. package/src/document-editor/narration.ts +19 -3
  46. package/src/document-editor/page-body.ts +60 -0
  47. package/src/document-editor/popover.tsx +4 -2
  48. package/src/document-editor/projection.ts +2 -2
  49. package/src/document-editor/rich-text.ts +3 -2
  50. package/src/document-editor/selection.ts +13 -0
  51. package/src/document-editor/style.css +7 -1
  52. package/src/document-editor/table-identities.ts +2 -1
  53. package/src/document-production.ts +491 -0
  54. package/src/document-session.ts +202 -56
  55. package/src/document-timing-drafts.ts +22 -2
  56. package/src/history.ts +5 -5
  57. package/src/index.ts +8 -5
  58. package/src/jobs.ts +1 -1
  59. package/src/media-drafts.ts +43 -1
  60. package/src/messages.ts +33 -16
  61. package/src/panels/DocumentNarrationPanel.tsx +2 -2
  62. package/src/panels/DocumentView.tsx +93 -61
  63. package/src/panels/DocumentVoiceDialog.tsx +25 -9
  64. package/src/panels/DocumentVoiceField.tsx +1 -1
  65. package/src/panels/ExportPanel.tsx +2 -10
  66. package/src/panels/HistoryPanel.tsx +34 -7
  67. package/src/panels/HomePanel.tsx +3 -1
  68. package/src/panels/PageDeleteDialog.tsx +4 -4
  69. package/src/panels/PageRenameDialog.tsx +1 -1
  70. package/src/panels/PreviewPanel.tsx +1 -4
  71. package/src/panels/ProductionCaptionSize.tsx +20 -0
  72. package/src/panels/ProductionCaptionTiming.tsx +12 -9
  73. package/src/panels/ProductionMediaClips.tsx +23 -7
  74. package/src/panels/ProductionPanel.tsx +16 -13
  75. package/src/panels/ProductionRecording.tsx +86 -9
  76. package/src/panels/ProductionRecordingRange.tsx +21 -19
  77. package/src/panels/ProductionTimeline.tsx +6 -1
  78. package/src/panels/ProductionTranscription.tsx +5 -4
  79. package/src/panels/SourceDocumentPanel.tsx +18 -36
  80. package/src/panels/TranscriptionAdoption.tsx +40 -34
  81. package/src/panels/VoiceCloneDialog.tsx +2 -1
  82. package/src/panels/VoiceoverDialog.tsx +1 -1
  83. package/src/places.ts +1 -36
  84. package/src/preview-playback.ts +1 -1
  85. package/src/production-draft-actions.ts +37 -0
  86. package/src/production-messages.ts +6 -0
  87. package/src/production-playback.ts +1 -1
  88. package/src/production-voice-playback.ts +3 -2
  89. package/src/sha256.ts +9 -0
  90. package/src/styles.css +43 -79
  91. package/src/transcription-drafts.ts +124 -0
  92. package/src/use-recording-adoption.ts +2 -2
  93. package/src/voice-drafts.ts +32 -8
  94. package/src/voiceover-jobs.ts +1 -1
  95. package/src/workbench-state.ts +159 -0
  96. package/src/workbench.ts +294 -951
  97. package/src/workspace-client.ts +23 -11
  98. package/src/assistant-mascot.ts +0 -62
  99. package/src/mascot-preference.ts +0 -37
  100. package/src/panels/ChangeTrail.tsx +0 -79
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lincyaw/workbench",
3
- "version": "0.2.0-rc.10",
3
+ "version": "0.2.0-rc.101",
4
4
  "description": "Presmium's workbench panels in React (the documents, a document edited on its rendered page with comments and version history) with the workspace service's client and the preview protocol's workbench side; @lincyaw/dsh places them in presmium studio (experimental)",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -39,6 +39,7 @@
39
39
  "@floating-ui/react": "0.27.20",
40
40
  "@mantine/core": "8.3.11",
41
41
  "@mantine/hooks": "8.3.11",
42
+ "@noble/hashes": "2.4.0",
42
43
  "@radix-ui/react-dialog": "^1.3.1",
43
44
  "@radix-ui/react-dropdown-menu": "^2.2.1",
44
45
  "@radix-ui/react-popover": "^1.1.15",
@@ -54,8 +55,8 @@
54
55
  "@tiptap/pm": "3.32.0",
55
56
  "katex": "0.18.10",
56
57
  "react-resizable-panels": "4.14.5",
57
- "@lincyaw/kernel": "1.0.0-rc.11",
58
- "@lincyaw/design": "1.0.0-rc.11"
58
+ "@lincyaw/design": "1.0.0-rc.101",
59
+ "@lincyaw/kernel": "1.0.0-rc.101"
59
60
  },
60
61
  "peerDependencies": {
61
62
  "react": "^18.3.1",
@@ -66,6 +67,6 @@
66
67
  "@types/react-dom": "18.3.7",
67
68
  "react": "^18.3.1",
68
69
  "react-dom": "^18.3.1",
69
- "@lincyaw/compiler": "1.0.0-rc.11"
70
+ "@lincyaw/compiler": "1.0.0-rc.101"
70
71
  }
71
72
  }
@@ -0,0 +1,25 @@
1
+ import { PmAgentActivity, PmIconButton, PmTooltip } from './components.tsx'
2
+ import { useWorkbench, useWorkbenchState } from './context.tsx'
3
+ import { latestAgentActivity } from './agent-activity.ts'
4
+ import { AGENT_ACTIVITY_MESSAGES } from './agent-activity-messages.ts'
5
+
6
+ /** A compact presence row, not a second activity log or an editor lock. */
7
+ export function AgentActivityBar() {
8
+ const workbench = useWorkbench(), state = useWorkbenchState(value => value)
9
+ const activity = latestAgentActivity(state.agentActivities), t = AGENT_ACTIVITY_MESSAGES[state.locale]
10
+ if (!activity) return null
11
+ const title = state.documents?.documents.find(doc => doc.dir === activity.document)?.title
12
+ const content = state.document === activity.document ? state.authoring?.content : undefined, target = activity.targets[0]
13
+ const section = target?.section ?? (target?.step ? content?.steps[target.step]?.sectionId : undefined)
14
+ const page = section ? content?.sections[section]?.title : undefined
15
+ const location = [title, page].filter(Boolean).join(' · ')
16
+ const label = `${activity.state === 'running' ? t[activity.operation] : t[activity.state]}${location ? ` · ${location}` : ''}`
17
+ const count = state.agentActivities?.filter(value => value.state === 'running').length ?? 0
18
+ const detail = `${label}${count > 1 ? ` · ${t.concurrent(count)}` : ''}${!state.agentFollowing ? ` · ${t.paused}` : ''}`
19
+ const short = activity.state === 'running' ? t.compact[activity.operation] : t.compact[activity.state]
20
+ return <span className="pmw-agent-activity" data-agent-activity-controls="">
21
+ <PmTooltip label={detail}><span className="pmw-agent-activity__label"><PmAgentActivity compact state={activity.state} label={short} detail={detail} /></span></PmTooltip>
22
+ <PmIconButton small icon={state.agentFollowing ? 'pause' : 'fit'} label={state.agentFollowing ? t.pauseLabel : t.followLabel}
23
+ aria-pressed={Boolean(state.agentFollowing)} onClick={() => workbench.setAgentFollowing(!state.agentFollowing)} />
24
+ </span>
25
+ }
@@ -45,6 +45,7 @@ export interface MediaClipEditorProps {
45
45
  onReview(): void
46
46
  onApply(clip: MediaClip): void
47
47
  onRemove(): void
48
+ onInteraction?(busy: boolean): void
48
49
  onEditStart(): void
49
50
  }
50
51
 
@@ -72,7 +73,7 @@ export function MediaClipEditor(props: MediaClipEditorProps) {
72
73
  props.onApply({ ...clip, sourceRange: { startMs: startMs!, endMs: endMs! }, attachment: { ...clip.attachment, offsetMs: offsetMs! } })
73
74
  }
74
75
  const change = (patch: Partial<MediaClipDraft>) => props.onChange({ ...draft, ...patch })
75
- const composition = (field: string) => ({ onCompositionStart: () => composing.current.add(field), onCompositionEnd: () => { composing.current.delete(field) } })
76
+ const composition = (field: string) => ({ onCompositionStart: () => { composing.current.add(field); props.onInteraction?.(true) }, onCompositionEnd: () => { composing.current.delete(field); props.onInteraction?.(composing.current.size > 0 || volumePreview !== undefined) } })
76
77
  return <section className="pm-ui-media-clip-editor" aria-label={t.title} data-density={density} onFocusCapture={props.onEditStart} onPointerDownCapture={props.onEditStart}
77
78
  onKeyDown={event => {
78
79
  event.stopPropagation()
@@ -101,8 +102,8 @@ export function MediaClipEditor(props: MediaClipEditorProps) {
101
102
  {rangeError && <span id={rangeErrorId} className="pm-ui-field__error" role="alert">{rangeError}</span>}
102
103
  <PmInput label={t.offset} density={density} width="number" inputMode="decimal" maxLength={32} value={draft.offsetText ?? (clip.attachment.offsetMs / 1000).toFixed(3)}
103
104
  readOnly={disabled || !inspected} error={offsetMs === undefined ? t.invalidOffset : undefined} onChange={event => change({ offsetText: event.target.value })} {...composition('offset')} />
104
- <PmField label={t.volume} density={density} group><div className="pm-ui-media-clip-editor__volume">
105
- <PmRange label={t.volume} density={density} value={clip.volume * 100} max={100} disabled={disabled || !inspected} valueText={value => `${Math.round(value)}%`} onPreviewChange={setVolumePreview}
105
+ <PmField label={t.volume} density={density} group><div className="pm-ui-range-row">
106
+ <PmRange label={t.volume} density={density} value={clip.volume * 100} max={100} disabled={disabled || !inspected} valueText={value => `${Math.round(value)}%`} onPreviewChange={value => { setVolumePreview(value); props.onInteraction?.(value !== undefined || composing.current.size > 0) }}
106
107
  onValueCommit={value => change({ clip: { ...clip, volume: value / 100 } })} />
107
108
  <output>{Math.round(volumePreview ?? clip.volume * 100)}%</output><PmButton density={density} aria-pressed={Boolean(clip.muted)} disabled={disabled || !inspected} onClick={() => change({ clip: { ...clip, muted: !clip.muted } })}>{clip.muted ? t.unmute : t.mute}</PmButton>
108
109
  </div></PmField>
@@ -40,16 +40,21 @@ interface DurationFieldProps {
40
40
  onDraft?(draft: StepDurationDraft | undefined): void
41
41
  onChange(value: number | null): void
42
42
  onComposition?(composing: boolean): void
43
+ controlKey?: string
44
+ registerControl?(control: StepDraftControl): () => void
43
45
  }
46
+ export interface StepDraftControl { composing(): boolean, clear(): void }
44
47
 
45
48
  /** Short author intent, never an estimated timestamp or a second playback clock. */
46
- function DurationField({ label, value, source, locale, readOnly, draft, onDraft, onChange, onComposition }: DurationFieldProps) {
47
- const t = MESSAGES[locale], current = useRef({ onComposition, onChange, onDraft, value })
48
- current.current = { onComposition, onChange, onDraft, value }
49
+ function DurationField({ label, value, source, locale, readOnly, draft, onDraft, onChange, onComposition, controlKey, registerControl }: DurationFieldProps) {
50
+ const t = MESSAGES[locale], current = useRef({ onComposition, onChange, onDraft, value, registerControl })
51
+ current.current = { onComposition, onChange, onDraft, value, registerControl }
49
52
  const [text, setText] = useState(draft?.text ?? (value === undefined ? '' : String(value))), [error, setError] = useState(draft?.error ?? false)
50
53
  const focused = useRef(false), composing = useRef(false)
51
54
  useEffect(() => { if (!focused.current) { setText(draft?.text ?? (value === undefined ? '' : String(value))); setError(draft?.error ?? false) } }, [value, source, draft?.text, draft?.error, draft?.review])
52
55
  useEffect(() => () => { if (composing.current) current.current.onComposition?.(false) }, [])
56
+ useEffect(() => current.current.registerControl?.({ composing: () => composing.current,
57
+ clear: () => { setText(current.current.value === undefined ? '' : String(current.current.value)); setError(false) } }), [controlKey])
53
58
  const commit = (input: string): boolean => {
54
59
  const normalized = input.normalize('NFKC').trim()
55
60
  if (!normalized) { setError(false); current.current.onDraft?.(undefined); current.current.onChange(null); return true }
@@ -92,10 +97,12 @@ export interface StepProductionEditorProps {
92
97
  draftStorageFailure?: boolean
93
98
  onDraft?(key: StepDurationKey, draft: StepDurationDraft | undefined): void
94
99
  onComposition?(key: StepDurationKey, composing: boolean): void
100
+ draftControlKey?: string
101
+ registerDraftControl?(key: StepDurationKey, control: StepDraftControl): () => void
95
102
  }
96
103
 
97
104
  /** A reusable view of the canonical step production, including inherited and migrated settings. */
98
- export function StepProductionEditor({ document, stepId, locale, readOnly, advanced = true, onPause, onInteraction, onChange, drafts, onDraft, draftStorageFailure, onComposition }: StepProductionEditorProps) {
105
+ export function StepProductionEditor({ document, stepId, locale, readOnly, advanced = true, onPause, onInteraction, onChange, drafts, onDraft, draftStorageFailure, onComposition, draftControlKey, registerDraftControl }: StepProductionEditorProps) {
99
106
  const t = MESSAGES[locale], [unifying, setUnifying] = useState(false)
100
107
  const start = stepTimingValue(document, stepId, 'narrationStart'), minimum = stepTimingValue(document, stepId, 'minimumHoldMs'), trailing = stepTimingValue(document, stepId, 'trailingPauseMs')
101
108
  const narrations = stepNarrationStarts(document, stepId), hasOverrides = narrations.some(value => value.overridden)
@@ -120,8 +127,10 @@ export function StepProductionEditor({ document, stepId, locale, readOnly, advan
120
127
  </PmField>
121
128
  <div className="pm-ui-step-production__durations">
122
129
  <DurationField label={t.minimum} value={minimum.value} source={minimum.source} locale={locale} readOnly={readOnly} draft={drafts?.minimumHoldMs} onDraft={draft => onDraft?.('minimumHoldMs', draft)}
130
+ controlKey={draftControlKey} registerControl={registerDraftControl && (control => registerDraftControl('minimumHoldMs', control))}
123
131
  onChange={value => apply({ minimumHoldMs: value })} onComposition={composing => onComposition?.('minimumHoldMs', composing)} />
124
132
  <DurationField label={t.trailing} value={trailing.value} source={trailing.source} locale={locale} readOnly={readOnly} draft={drafts?.trailingPauseMs} onDraft={draft => onDraft?.('trailingPauseMs', draft)}
133
+ controlKey={draftControlKey} registerControl={registerDraftControl && (control => registerDraftControl('trailingPauseMs', control))}
125
134
  onChange={value => apply({ trailingPauseMs: value })} onComposition={composing => onComposition?.('trailingPauseMs', composing)} />
126
135
  </div></>}
127
136
  {!advanced && (drafts?.minimumHoldMs || drafts?.trailingPauseMs || draftStorageFailure) ? <span className="pm-ui-field__error" role="alert">{t.advancedDraft}</span>
@@ -0,0 +1,14 @@
1
+ export const AGENT_ACTIVITY_MESSAGES = {
2
+ 'zh-CN': {
3
+ compact: { read: '查看中', edit: '编辑中', navigate: '定位中', preview: '预览中', build: '构建中', voice: '配音中', workspace: '整理中', done: '已完成', failed: '失败', cancelled: '已取消' },
4
+ read: 'AI 助手正在查看', edit: 'AI 助手正在编辑', navigate: 'AI 助手正在定位', preview: 'AI 助手正在查看预览', build: 'AI 助手正在构建', voice: 'AI 助手正在处理配音', workspace: 'AI 助手正在整理工作区',
5
+ done: 'AI 助手已完成', failed: 'AI 助手操作失败', cancelled: 'AI 助手已取消', following: '正在跟随', resume: '跟随 AI 助手', paused: '跟随已暂停',
6
+ followLabel: '跟随 AI 助手的操作位置', pauseLabel: '暂停跟随 AI 助手', concurrent: (count: number) => `${count} 项操作进行中`,
7
+ },
8
+ en: {
9
+ compact: { read: 'Reading', edit: 'Editing', navigate: 'Locating', preview: 'Previewing', build: 'Building', voice: 'Voicing', workspace: 'Organizing', done: 'Done', failed: 'Failed', cancelled: 'Canceled' },
10
+ read: 'AI Assistant is reading', edit: 'AI Assistant is editing', navigate: 'AI Assistant is navigating', preview: 'AI Assistant is inspecting the preview', build: 'AI Assistant is building', voice: 'AI Assistant is working on voiceover', workspace: 'AI Assistant is updating the workspace',
11
+ done: 'AI Assistant finished', failed: 'AI Assistant operation failed', cancelled: 'AI Assistant canceled', following: 'Following', resume: 'Follow AI Assistant', paused: 'Following paused',
12
+ followLabel: 'Follow the AI Assistant’s location', pauseLabel: 'Pause following the AI Assistant', concurrent: (count: number) => `${count} operations running`,
13
+ },
14
+ }
@@ -0,0 +1,38 @@
1
+ import type { AgentActivity } from '@lincyaw/kernel'
2
+ import type { Workbench } from './workbench.ts'
3
+
4
+ export const latestAgentActivity = (activities: readonly AgentActivity[] = []) => [...activities].sort((a, b) => Number(b.state === 'running') - Number(a.state === 'running') || b.startedAt - a.startedAt)[0]
5
+
6
+ /** One root-lifetime subscription; reconnect resets observations, and human gestures always win navigation. */
7
+ export function connectAgentActivity(workbench: Workbench): () => void {
8
+ const subscribe = workbench.client.subscribeAgentActivity
9
+ if (!subscribe) return () => {}
10
+ let closed = false, followed: string | undefined, following: AbortController | undefined
11
+ let navigating: { document?: string, controller: AbortController } | undefined
12
+ workbench.setAgentFollowing(true)
13
+ const follow = () => {
14
+ if (closed || !workbench.state.agentFollowing) { following?.abort(); followed = undefined; return }
15
+ const activity = latestAgentActivity(workbench.state.agentActivities)
16
+ if (!activity || activity.id === followed) return
17
+ if (navigating && navigating.document === activity.document && !navigating.controller.signal.aborted) return
18
+ followed = activity.id; following?.abort(); following = new AbortController()
19
+ const task = { document: activity.document, controller: following }; navigating = task
20
+ void workbench.followAgentActivity(activity, following.signal).catch(() => {}).finally(() => {
21
+ if (navigating === task) { navigating = undefined; follow() }
22
+ })
23
+ }
24
+ const stop = subscribe(snapshot => { if (!closed) { workbench.setAgentActivities(snapshot.activities); follow() } }, () => {
25
+ following?.abort(); followed = undefined; workbench.setAgentActivities([])
26
+ })
27
+ const stopState = workbench.subscribe(follow)
28
+ const interrupt = (event: Event) => {
29
+ if (!workbench.state.agentActivities?.length || event.target instanceof Element && event.target.closest('[data-agent-activity-controls]')) return
30
+ if (event instanceof KeyboardEvent && !['ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown', 'PageUp', 'PageDown', 'Home', 'End', 'Escape'].includes(event.key)) return
31
+ following?.abort(); workbench.setAgentFollowing(false)
32
+ }
33
+ document.addEventListener('pointerdown', interrupt, true); document.addEventListener('input', interrupt, true); document.addEventListener('wheel', interrupt, true); document.addEventListener('keydown', interrupt, true)
34
+ return () => {
35
+ closed = true; following?.abort(); stop(); stopState(); workbench.setAgentActivities([])
36
+ document.removeEventListener('pointerdown', interrupt, true); document.removeEventListener('input', interrupt, true); document.removeEventListener('wheel', interrupt, true); document.removeEventListener('keydown', interrupt, true)
37
+ }
38
+ }
package/src/approvals.tsx CHANGED
@@ -6,6 +6,11 @@ import { WorkspaceServerError } from './workspace-client.ts'
6
6
 
7
7
  interface Pending { id: string, request: ApprovalRequest }
8
8
 
9
+ /** Approval controls belong to the operation's editing context, including their portaled panel. */
10
+ export function isApprovalTarget(target: EventTarget | null | undefined): boolean {
11
+ return target instanceof Element && Boolean(target.closest('[data-approval-trigger], .pmw-approvals'))
12
+ }
13
+
9
14
  /**
10
15
  * The host's operations waiting for the author, such as an external MCP client's import: shown only while one is
11
16
  * pending, answered here as in the viewer's "Approvals". The host times them out; a late answer is reported, not retried.
@@ -38,7 +43,7 @@ export function WorkbenchApprovals({ density = 'compact' }: { density?: 'compact
38
43
  }
39
44
  return (
40
45
  <PmPopover open={open} onOpenChange={setOpen} label={t.approvalsTitle} name="pmw-approvals" trigger={
41
- <PmButton variant="accent" density={density}>{t.approvals(pending.length)}</PmButton>
46
+ <PmButton data-approval-trigger="" variant="accent" density={density}>{t.approvals(pending.length)}</PmButton>
42
47
  }>
43
48
  <h2 className="pmw-approvals__heading">{t.approvalsTitle}</h2>
44
49
  <ul className="pmw-approvals__list">
@@ -10,6 +10,21 @@ const MAX_BYTES = 16 << 20
10
10
  const MAX_DURATION_MS = 10 * 60_000
11
11
  const MIME_TYPES = ['audio/webm;codecs=opus', 'audio/ogg;codecs=opus', 'audio/mp4']
12
12
 
13
+ /** getUserMedia has no AbortSignal; late permission grants must release their stream. */
14
+ function recordingWait<T>(work: Promise<T>, signal: AbortSignal | undefined, releaseLate: (value: T) => void): Promise<T> {
15
+ if (!signal) return work
16
+ return new Promise((resolve, reject) => {
17
+ const abort = () => { signal.removeEventListener('abort', abort); reject(signal.reason ?? new Error('recording-cancelled')) }
18
+ signal.addEventListener('abort', abort, { once: true })
19
+ work.then(value => {
20
+ signal.removeEventListener('abort', abort)
21
+ if (signal.aborted) { releaseLate(value); return }
22
+ resolve(value)
23
+ }, error => { signal.removeEventListener('abort', abort); reject(error) })
24
+ if (signal.aborted) abort()
25
+ })
26
+ }
27
+
13
28
  export function recordingUnavailable(): string | undefined {
14
29
  if (!globalThis.isSecureContext || !navigator.mediaDevices?.getUserMedia) return 'recording-context'
15
30
  if (typeof MediaRecorder === 'undefined' || !MIME_TYPES.some(type => MediaRecorder.isTypeSupported(type))) return 'recording-unsupported'
@@ -36,6 +51,7 @@ export class AudioRecording {
36
51
  #generation = 0
37
52
  #disposed = false
38
53
  #take?: Take
54
+ #request?: AbortController
39
55
  #release?: () => void
40
56
  #warning = false
41
57
  readonly #beforeUnload = (event: BeforeUnloadEvent) => { event.preventDefault(); event.returnValue = '' }
@@ -57,19 +73,24 @@ export class AudioRecording {
57
73
  this.#set({ phase: error ? 'failed' : this.#state.candidate ? 'ready' : 'idle', candidate: this.#state.candidate, elapsedMs: this.#state.candidate?.elapsedMs ?? 0, ...error ? { error } : {} })
58
74
  }
59
75
 
60
- async start(prepare: () => Promise<() => void>): Promise<void> {
76
+ async start(prepare: (signal: AbortSignal) => Promise<() => void>, signal?: AbortSignal): Promise<void> {
77
+ if (signal?.aborted) return
61
78
  if (this.#disposed || this.#take || this.#state.phase === 'requesting') return
62
79
  const unavailable = recordingUnavailable()
63
80
  if (unavailable) { this.#settle(unavailable); return }
64
81
  const generation = ++this.#generation
82
+ const request = this.#request = new AbortController()
83
+ const pendingSignal = signal ? AbortSignal.any([signal, request.signal]) : request.signal
84
+ const abort = () => { if (generation === this.#generation) this.cancelTake() }
85
+ signal?.addEventListener('abort', abort, { once: true })
65
86
  this.#set({ ...this.#state, phase: 'requesting', error: undefined })
66
87
  let stream: MediaStream | undefined
67
88
  let release: (() => void) | undefined
68
89
  try {
69
- release = await prepare()
90
+ release = await recordingWait(prepare(pendingSignal), pendingSignal, release => release())
70
91
  if (generation !== this.#generation) { release(); return }
71
92
  this.#release = release
72
- stream = await navigator.mediaDevices.getUserMedia({ audio: { channelCount: { ideal: 1 } }, video: false })
93
+ stream = await recordingWait(navigator.mediaDevices.getUserMedia({ audio: { channelCount: { ideal: 1 } }, video: false }), pendingSignal, stream => stream.getTracks().forEach(track => track.stop()))
73
94
  if (generation !== this.#generation) { stream.getTracks().forEach(track => track.stop()); return }
74
95
  const mimeType = MIME_TYPES.find(type => MediaRecorder.isTypeSupported(type))!
75
96
  const recorder = new MediaRecorder(stream, { mimeType, audioBitsPerSecond: 128_000 })
@@ -102,13 +123,13 @@ export class AudioRecording {
102
123
  this.#take = undefined
103
124
  const name = error instanceof DOMException ? error.name : ''
104
125
  this.#settle(name === 'NotAllowedError' || name === 'SecurityError' ? 'recording-permission' : name === 'NotFoundError' ? 'recording-device' : name === 'NotReadableError' ? 'recording-device-busy' : name === 'NotSupportedError' ? 'recording-device-unsupported' : 'recording-failed')
105
- }
126
+ } finally { signal?.removeEventListener('abort', abort); if (this.#request === request) this.#request = undefined }
106
127
  }
107
128
 
108
129
  stop(error?: string): void {
109
130
  const take = this.#take
110
131
  if (!take) {
111
- if (this.#state.phase === 'requesting') { this.#generation++; this.#release?.(); this.#release = undefined; this.#settle(error) }
132
+ if (this.#state.phase === 'requesting') { this.#generation++; this.#request?.abort(new Error('recording-cancelled')); this.#request = undefined; this.#release?.(); this.#release = undefined; this.#settle(error) }
112
133
  return
113
134
  }
114
135
  if (error) take.error ??= error
@@ -159,6 +180,7 @@ export class AudioRecording {
159
180
  if (this.#disposed) return
160
181
  this.#disposed = true
161
182
  this.#generation++
183
+ this.#request?.abort(new Error('recording-cancelled')); this.#request = undefined
162
184
  const take = this.#take
163
185
  if (take) { take.discard = true; this.stop(); this.#finish(take) }
164
186
  this.#release?.(); this.#release = undefined
@@ -1,11 +1,11 @@
1
- import { authoringClientResultFits } from '@lincyaw/kernel'
1
+ import { authoringClientActionMutatesDraft, authoringClientResultFits, randomUUID } from '@lincyaw/kernel'
2
2
  import type { AuthoringClientActionResult, AuthoringClientEvent, AuthoringClientSnapshot, CanonicalSource } from '@lincyaw/kernel'
3
3
  import type { Workbench } from './workbench.ts'
4
4
  import type { AuthoringClientChannel } from './workspace-client.ts'
5
5
 
6
6
  const sameSource = (a: CanonicalSource, b: CanonicalSource) => a.documentId === b.documentId && a.version === b.version && a.fingerprint === b.fingerprint
7
7
  // Clock samples are observations, not user input revisions. Never push at animation-frame frequency.
8
- const signature = (value: AuthoringClientSnapshot) => JSON.stringify({ ...value, revision: 0, playback: value.playback && { ...value.playback,
8
+ const signature = (value: AuthoringClientSnapshot) => JSON.stringify({ ...value, revision: 0, recording: value.recording && { ...value.recording, elapsedMs: 0 }, playback: value.playback && { ...value.playback,
9
9
  position: value.playback.position && { ...value.playback.position, timeMs: 0, stepTimeMs: 0 } } })
10
10
  type Attachment = { directory: string, identity: string, epoch: string, channel: AuthoringClientChannel, connectionId?: string }
11
11
 
@@ -13,7 +13,7 @@ type Attachment = { directory: string, identity: string, epoch: string, channel:
13
13
  export function connectAuthoringClient(workbench: Workbench): () => void {
14
14
  const open = workbench.client.openAuthoringClient
15
15
  if (!open) return () => {}
16
- const clientId = crypto.randomUUID()
16
+ const clientId = randomUUID()
17
17
  let closed = false, revision = 0, sequence = 0
18
18
  let attached: Attachment | undefined
19
19
  let lastSignature: string | undefined, lastContent: object | undefined
@@ -71,7 +71,7 @@ export function connectAuthoringClient(workbench: Workbench): () => void {
71
71
  if (value) publishState(owner, event.connectionId, value)
72
72
  return
73
73
  }
74
- if (event.type === 'cancel') { if (event.connectionId === owner.connectionId && event.requestId === active?.requestId) active.controller.abort(); return }
74
+ if (event.type === 'cancel') { if (event.connectionId === owner.connectionId && event.requestId === active?.requestId) active.controller.abort(new Error('client-request-cancelled')); return }
75
75
  const request = event.request, connectionId = owner.connectionId
76
76
  if (!connectionId || request.clientId !== clientId || request.epoch !== owner.epoch || request.expectedClientState.connectionId !== connectionId || seen.has(request.requestId)) return
77
77
  seen.add(request.requestId)
@@ -83,7 +83,7 @@ export function connectAuthoringClient(workbench: Workbench): () => void {
83
83
  controller.signal.throwIfAborted()
84
84
  if (closed || attached !== owner || owner.connectionId !== connectionId || active !== task || Date.now() >= Date.parse(event.expiresAt)) throw new Error('client-request-expired')
85
85
  }
86
- if (active || value.revision !== request.expectedClientState.revision || !sameSource(value.source, request.source) || !value.actions.includes(request.action.type) || Date.now() >= Date.parse(event.expiresAt)) {
86
+ if (active || value.revision !== request.expectedClientState.revision || (request.action.type === 'body-drafts.retry' ? value.source.documentId !== request.source.documentId : !sameSource(value.source, request.source)) || !value.actions.includes(request.action.type) || Date.now() >= Date.parse(event.expiresAt)) {
87
87
  await send(owner, connectionId, value, { requestId: request.requestId, state: 'refused', error: { code: 'client-state-changed' } }).catch(() => {})
88
88
  return
89
89
  }
@@ -95,7 +95,7 @@ export function connectAuthoringClient(workbench: Workbench): () => void {
95
95
  await send(owner, connectionId, value, { requestId: request.requestId, state: 'executing' })
96
96
  owned()
97
97
  const latest = snapshot()
98
- if (!latest || latest.revision !== request.expectedClientState.revision || !sameSource(latest.source, request.source)) throw new Error('client-state-changed')
98
+ if (!latest || latest.revision !== request.expectedClientState.revision || (request.action.type === 'body-drafts.retry' ? latest.source.documentId !== request.source.documentId : !sameSource(latest.source, request.source))) throw new Error('client-state-changed')
99
99
  const fits = (result: AuthoringClientActionResult) => authoringClientResultFits({ request, connection: { clientId, epoch: owner.epoch, connectionId }, document: owner.directory, snapshot: snapshot() ?? value }, result)
100
100
  const actionResult = await workbench.executeAuthoringClientAction(request.action, request.source, controller.signal, expiresAt, fits)
101
101
  owned()
@@ -104,13 +104,13 @@ export function connectAuthoringClient(workbench: Workbench): () => void {
104
104
  await send(owner, connectionId, result, { requestId: request.requestId, state: 'done', ...actionResult ? { result: actionResult } : {} }, actionResult ? () => {
105
105
  owned()
106
106
  const latest = snapshot()
107
- if (!latest || latest.revision !== result.revision || !['component-drafts.restore', 'component-drafts.discard', 'comment-drafts.restore', 'comment-drafts.discard'].includes(actionResult.type) && latest.revision !== request.expectedClientState.revision) throw new Error(actionResult.family === 'component' ? 'client-component-drafts-changed' : 'client-comment-drafts-changed')
108
- if (!fits(actionResult)) throw new Error(actionResult.family === 'component' ? 'client-component-result-too-large' : 'client-comment-result-too-large')
107
+ if (!latest || latest.revision !== result.revision || !authoringClientActionMutatesDraft(actionResult.type) && latest.revision !== request.expectedClientState.revision) throw new Error(`client-${actionResult.family}-drafts-changed`)
108
+ if (!fits(actionResult)) throw new Error(`client-${actionResult.family}-result-too-large`)
109
109
  } : undefined)
110
110
  } catch (error) {
111
111
  const result = snapshot()
112
112
  const code = error instanceof Error && /^(client|production)-[a-z-]{1,100}$/.test(error.message) ? error.message : 'client-action-not-verified'
113
- if (!controller.signal.aborted && attached === owner && owner.connectionId === connectionId && result) await send(owner, connectionId, result, { requestId: request.requestId, state: 'failed', error: { code } }).catch(() => {})
113
+ if (attached === owner && owner.connectionId === connectionId && result) await send(owner, connectionId, result, { requestId: request.requestId, state: 'failed', error: { code } }).catch(() => {})
114
114
  } finally { clearTimeout(timeout); if (active === task) active = undefined }
115
115
  }
116
116
  const changed = () => {
@@ -120,7 +120,7 @@ export function connectAuthoringClient(workbench: Workbench): () => void {
120
120
  if (!value) { detach(); return }
121
121
  if (attached && (attached.directory !== state.document || attached.identity !== source.identity)) detach()
122
122
  if (!attached) {
123
- const epoch = crypto.randomUUID()
123
+ const epoch = randomUUID()
124
124
  // Callbacks run after the channel has been installed; the socket implementation is asynchronous.
125
125
  const owner = { directory: state.document, identity: source.identity, epoch } as Attachment
126
126
  owner.channel = open(state.document, { clientId, epoch, snapshot: value }, event => { void received(owner, event) }, () => {
@@ -1,9 +1,11 @@
1
1
  import type { AuthoringClientActionResult } from '@lincyaw/kernel'
2
+ import { sha256 as draftContentHash } from './sha256.ts'
3
+
4
+ export { draftContentHash }
2
5
 
3
6
  type Fragment = Extract<AuthoringClientActionResult, { jsonText: string }>
4
7
  type Fields = 'offset' | 'endOffset' | 'totalUtf16' | 'totalUtf8' | 'sha256' | 'jsonText'
5
8
  type FragmentBase = Fragment extends infer Value ? Value extends Fragment ? Omit<Value, Fields> : never : never
6
- export const draftContentHash = async (text: string): Promise<string> => [...new Uint8Array(await crypto.subtle.digest('SHA-256', new TextEncoder().encode(text)))].map(value => value.toString(16).padStart(2, '0')).join('')
7
9
  const boundary = (text: string, offset: number) => !(offset > 0 && offset < text.length && /[\uD800-\uDBFF]/.test(text[offset - 1]!) && /[\uDC00-\uDFFF]/.test(text[offset]!))
8
10
 
9
11
  /** Budget the complete client receipt and WS frame, preserving exact JSON text and Unicode progress. */
@@ -0,0 +1,100 @@
1
+ import { randomUUID } from '@lincyaw/kernel'
2
+ import type { AuthoringWindowAcknowledgement, AuthoringWindowEvent, AuthoringWindowSnapshot } from '@lincyaw/kernel'
3
+ import type { Workbench } from './workbench.ts'
4
+
5
+ /** One root-lifetime reader on the existing socket, independent of document attachments. */
6
+ export function connectAuthoringWindow(workbench: Workbench): () => void {
7
+ const open = workbench.client.openAuthoringWindow
8
+ if (!open) return () => {}
9
+ const clientId = randomUUID(), epoch = randomUUID(), seen = new Set<string>()
10
+ let closed = false, connectionId: string | undefined, revision = 0, sequence = 0, signature: string | undefined
11
+ const compositions = new Set<EventTarget>()
12
+ let inputRevision = 0, lastInputRevision = 0
13
+ let content: object | undefined, drafts: string | undefined, playback: number | undefined, view: string | undefined
14
+ let active: { requestId: string, controller: AbortController, navigation: boolean } | undefined
15
+ let reports: Promise<void> = Promise.resolve(), pending: AuthoringWindowSnapshot | undefined, sending = false
16
+ const snapshot = () => {
17
+ for (const target of compositions) if (target instanceof Node && !target.isConnected) compositions.delete(target)
18
+ const value = workbench.authoringWindowSnapshot(0), state = workbench.state, bank = workbench.authoringDraftRevision()
19
+ if (compositions.size) value.actions = ['window.read']
20
+ const next = JSON.stringify(value)
21
+ if (next !== signature || content !== state.authoring?.content || bank !== drafts || playback !== state.productionNavigationVersion || view !== state.webView || inputRevision !== lastInputRevision) {
22
+ revision++; signature = next; content = state.authoring?.content; drafts = bank; playback = state.productionNavigationVersion; view = state.webView; lastInputRevision = inputRevision
23
+ }
24
+ return { ...value, revision }
25
+ }
26
+ const send = (connection: string, value: AuthoringWindowSnapshot, acknowledgement?: Omit<AuthoringWindowAcknowledgement, 'sequence' | 'snapshot'>, guard?: () => void) => {
27
+ const report = { sequence: ++sequence, snapshot: value, ...acknowledgement }
28
+ const next = reports.then(() => {
29
+ if (closed || connectionId !== connection) throw new Error('window-connection-changed')
30
+ guard?.()
31
+ return acknowledgement ? channel.acknowledge(connection, report as AuthoringWindowAcknowledgement) : channel.publish(connection, report)
32
+ })
33
+ reports = next.catch(() => {}); return next
34
+ }
35
+ const publish = (value: AuthoringWindowSnapshot) => {
36
+ pending = value
37
+ if (sending) return
38
+ sending = true
39
+ void (async () => {
40
+ try {
41
+ while (pending && connectionId) { pending = undefined; const connection = connectionId; await send(connection, snapshot()).catch(() => {}) }
42
+ } finally { sending = false }
43
+ })()
44
+ }
45
+ const received = async (event: AuthoringWindowEvent) => {
46
+ if (closed) return
47
+ if (event.type === 'connected') { active?.controller.abort(); active = undefined; connectionId = event.connectionId; publish(snapshot()); return }
48
+ if (event.type === 'cancel') { if (event.connectionId === connectionId && active?.requestId === event.requestId) active.controller.abort(new Error('window-request-cancelled')); return }
49
+ const connection = connectionId, request = event.request
50
+ if (!connection || request.clientId !== clientId || request.epoch !== epoch || request.connectionId !== connection || seen.has(request.requestId)) return
51
+ seen.add(request.requestId); if (seen.size > 64) seen.delete(seen.values().next().value!)
52
+ const initial = snapshot()
53
+ if (active || initial.revision !== request.revision || !initial.actions.includes(request.action.type) || Date.now() >= Date.parse(event.expiresAt)) {
54
+ await send(connection, initial, { requestId: request.requestId, state: 'refused', error: { code: 'window-state-changed' } }).catch(() => {}); return
55
+ }
56
+ const controller = new AbortController(), task = { requestId: request.requestId, controller, navigation: request.action.type !== 'window.read' }
57
+ active = task
58
+ const owned = () => { controller.signal.throwIfAborted(); if (closed || connectionId !== connection || active !== task || Date.now() >= Date.parse(event.expiresAt)) throw new Error('window-request-expired') }
59
+ const timeout = setTimeout(() => controller.abort(new Error('window-request-expired')), Math.max(0, Date.parse(event.expiresAt) - Date.now()))
60
+ try {
61
+ await send(connection, initial, { requestId: request.requestId, state: 'executing' }, () => { owned(); if (snapshot().revision !== request.revision) throw new Error('window-state-changed') })
62
+ owned()
63
+ if (snapshot().revision !== request.revision) throw new Error('window-state-changed')
64
+ const outcome = await workbench.executeAuthoringWindowAction(request, controller.signal)
65
+ owned()
66
+ const result = snapshot()
67
+ await send(connection, result, { requestId: request.requestId, state: 'done', outcome }, () => { owned(); if (snapshot().revision !== result.revision) throw new Error('window-state-changed') })
68
+ } catch (error) {
69
+ const code = error instanceof Error && /^window-[a-z-]{1,100}$/.test(error.message) ? error.message : 'window-action-not-verified'
70
+ if (!closed && connectionId === connection) await send(connection, snapshot(), { requestId: request.requestId, state: 'failed', error: { code } }).catch(() => {})
71
+ } finally { clearTimeout(timeout); if (active === task) active = undefined }
72
+ }
73
+ const channel = open({ clientId, epoch, snapshot: snapshot() }, event => { void received(event) }, () => { connectionId = undefined; pending = undefined; active?.controller.abort(); active = undefined })
74
+ const changed = () => { if (closed) return; const before = revision, value = snapshot(); if (before !== revision && connectionId) publish(value) }
75
+ const stop = workbench.subscribe(changed), stopDrafts = workbench.subscribeAuthoringDraftChanges(changed)
76
+ const interrupt = () => { if (active?.navigation) active.controller.abort(new Error('window-input-changed')) }
77
+ const input = () => { inputRevision++; interrupt(); changed() }
78
+ const escape = (event: KeyboardEvent) => { if (event.key === 'Escape') interrupt() }
79
+ const compositionStart = (event: CompositionEvent) => { if (event.target) compositions.add(event.target); input() }
80
+ const compositionEnd = (event: CompositionEvent) => { if (event.target) compositions.delete(event.target); input() }
81
+ // Only modal semantics matter. Text mutations and iframe animation frames never trigger publications.
82
+ const modal = typeof MutationObserver === 'undefined' ? undefined : new MutationObserver(records => {
83
+ const modalChange = records.some(record => record.type === 'attributes' || [...record.addedNodes, ...record.removedNodes].some(node => {
84
+ return node instanceof Element && (node.matches('[role="dialog"]') || node.querySelector('[role="dialog"]'))
85
+ }))
86
+ if (modalChange || compositions.size > 0 && records.some(record => record.removedNodes.length > 0)) changed()
87
+ })
88
+ if (typeof document !== 'undefined') {
89
+ modal?.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['aria-modal', 'hidden', 'inert'] })
90
+ document.addEventListener('input', input, true); document.addEventListener('compositionstart', compositionStart, true); document.addEventListener('compositionend', compositionEnd, true)
91
+ document.addEventListener('pointerdown', interrupt, true); document.addEventListener('keydown', escape, true)
92
+ }
93
+ return () => {
94
+ closed = true; stop(); stopDrafts(); modal?.disconnect(); active?.controller.abort(); channel.close(); pending = undefined; compositions.clear()
95
+ if (typeof document !== 'undefined') {
96
+ document.removeEventListener('input', input, true); document.removeEventListener('compositionstart', compositionStart, true); document.removeEventListener('compositionend', compositionEnd, true)
97
+ document.removeEventListener('pointerdown', interrupt, true); document.removeEventListener('keydown', escape, true)
98
+ }
99
+ }
100
+ }
@@ -0,0 +1,60 @@
1
+ import type { AuthoringClientAction, AuthoringClientActionResult, ClientBodyDraftMetadata } from '@lincyaw/kernel'
2
+ import { authoringDraftFragment, draftContentHash } from './authoring-draft-fragment.ts'
3
+ import type { BodyDraftCandidate, DocumentDraftOperation, DocumentSession, DocumentSessionState } from './document-session.ts'
4
+
5
+ type BodyAction = Extract<AuthoringClientAction, { type: `body-drafts.${string}` }>
6
+ /** Explicit draft inspection never sends owner IDs, base hashes or body text in metadata. */
7
+ const metadata = (value: BodyDraftCandidate, version: string): ClientBodyDraftMetadata => ({
8
+ draft: value.draft.token, current: value.draft.current, storage: value.storage, updatedAt: value.updatedAt, baseVersion: value.baseVersion, baseObserved: value.baseVersion === version,
9
+ composing: value.composing, pendingSubmission: value.pendingSubmission,
10
+ })
11
+ export async function executeBodyDraftAction(session: DocumentSession, state: () => DocumentSessionState | undefined, action: BodyAction, operation: DocumentDraftOperation, fits: (result: AuthoringClientActionResult) => boolean): Promise<AuthoringClientActionResult> {
12
+ const read = await session.readBodyDrafts(operation.signal, 'draft' in action ? action.draft : undefined)
13
+ const guard = () => { operation.guard(); read.guard() }
14
+ guard()
15
+ if (action.type === 'body-drafts.inspect') {
16
+ const values = read.candidates.map(value => metadata(value, operation.source.version)), token = await draftContentHash(JSON.stringify({ values, coverage: read.coverage }))
17
+ guard()
18
+ if (action.cursor && action.cursor.token !== token) throw new Error('client-body-drafts-changed')
19
+ const start = action.cursor ? values.findIndex(value => value.draft === action.cursor!.after) + 1 : 0
20
+ if (action.cursor && start === 0) throw new Error('client-body-drafts-changed')
21
+ const result: Extract<AuthoringClientActionResult, { type: 'body-drafts.inspect' }> = { type: action.type, family: 'body', coverage: read.coverage, token, drafts: [] }
22
+ for (const value of values.slice(start, start + (action.limit ?? 10))) {
23
+ const next = { ...result, drafts: [...result.drafts, value], ...start + result.drafts.length + 1 < values.length ? { next: { after: value.draft, token } } : {} }
24
+ if (!fits(next)) break
25
+ result.drafts.push(value)
26
+ }
27
+ if (start < values.length && !result.drafts.length) throw new Error('client-body-metadata-too-large')
28
+ if (start + result.drafts.length < values.length) result.next = { after: result.drafts.at(-1)!.draft, token }
29
+ if (!fits(result)) throw new Error('client-body-metadata-too-large')
30
+ guard(); return result
31
+ }
32
+ const value = read.candidates[0]!
33
+ if (action.type === 'body-drafts.read') return authoringDraftFragment({ text: JSON.stringify(value.content), base: { type: action.type, family: 'body', draft: value.draft.token, storage: value.storage, format: 'presmium-document-json-v1' }, offset: action.offset, maxChars: action.maxChars }, guard, fits)
34
+ if (!session.bodyDraftCapabilities().mutate || value.composing || value.pendingSubmission || action.type === 'body-drafts.restore' && value.draft.current || action.type === 'body-drafts.retry' && !value.draft.current) throw new Error('client-body-draft-needs-human')
35
+ const result = (outcome: Extract<AuthoringClientActionResult, { family: 'body', outcome: string }>['outcome']): Extract<AuthoringClientActionResult, { family: 'body', outcome: string }> => {
36
+ const now = state()
37
+ return { type: action.type, family: 'body', draft: value.draft.token, outcome, dirty: Boolean(now?.dirty), conflicted: Boolean(now?.error), ...now?.backupPending ? { backupPending: true as const } : {}, ...now?.storageFailure ? { backupRetained: true as const } : {} }
38
+ }
39
+ if (!fits({ ...result(action.type === 'body-drafts.restore' ? 'restored' : action.type === 'body-drafts.retry' ? 'saved' : value.draft.current ? 'source-restored' : 'backup-discarded'), backupPending: true, backupRetained: true })) throw new Error('client-body-result-too-large')
40
+ guard()
41
+ let outcome: 'restored' | 'already-saved' | 'source-restored' | 'backup-discarded' | 'saved'
42
+ if (action.type === 'body-drafts.restore') {
43
+ const restored = await session.recoverDraft(value.draft, operation)
44
+ if (!restored) throw new Error('client-body-drafts-changed')
45
+ outcome = restored
46
+ } else if (action.type === 'body-drafts.discard') {
47
+ const done = value.draft.current ? await session.discard(operation) : await session.forgetDraft(value.draft, operation)
48
+ if (!done) throw new Error('client-body-drafts-changed')
49
+ outcome = value.draft.current ? 'source-restored' : 'backup-discarded'
50
+ } else {
51
+ await session.retry(operation)
52
+ if (state()?.error || state()?.saving || state()?.restored) throw new Error('client-body-save-unverified')
53
+ outcome = 'saved'
54
+ }
55
+ operation.signal.throwIfAborted()
56
+ // A successful retry may finish at a new canonical version. The transport checks that saved source.
57
+ const answer = result(outcome)
58
+ if (!fits(answer)) throw new Error('client-body-result-too-large')
59
+ return answer
60
+ }
@@ -3,7 +3,7 @@ import type { CaptionTimingSource, TeachingDocument } from '@lincyaw/kernel'
3
3
  export interface CaptionTimingRow { id: string, from: number, to: number, start: string, end: string }
4
4
  export interface CaptionTimingDraft { version: string, text: string, basis: CaptionTimingSource, rows: CaptionTimingRow[] }
5
5
  type Scope = { identity: string, memberId: string }
6
- interface Entry { values: Map<string, CaptionTimingDraft>, failed: boolean, unreadable: boolean }
6
+ interface Entry { raw?: string | null, values: Map<string, CaptionTimingDraft>, failed: boolean, unreadable: boolean }
7
7
  const MAX_CHARS = 1 << 20
8
8
  const MAX_TARGETS = 512
9
9
  const valid = (value: unknown): value is CaptionTimingDraft => {
@@ -32,6 +32,7 @@ export class CaptionTimingDrafts {
32
32
  const result: Entry = { values: new Map(), failed: false, unreadable: false }; this.#entries.set(key, result)
33
33
  try {
34
34
  const raw = sessionStorage.getItem(key)
35
+ result.raw = raw
35
36
  if (raw === null) return result
36
37
  if (raw.length > MAX_CHARS) throw new Error('caption-draft-limit')
37
38
  const data: unknown = JSON.parse(raw)
@@ -44,6 +45,21 @@ export class CaptionTimingDrafts {
44
45
  return result
45
46
  }
46
47
  get(scope: Scope, stepId: string): CaptionTimingDraft | undefined { return this.#entry(scope).values.get(stepId) }
48
+ entries(scope: Scope): readonly (readonly [string, CaptionTimingDraft])[] { return [...this.#entry(scope).values] }
49
+ partial(scope: Scope): boolean { const entry = this.#entry(scope); try { return entry.unreadable || sessionStorage.getItem(this.#key(scope)) !== entry.raw } catch { return true } }
50
+ discard(scope: Scope, stepId: string): boolean {
51
+ const entry = this.#entry(scope)
52
+ if (entry.unreadable || !entry.values.has(stepId)) return false
53
+ try {
54
+ const next = [...entry.values].filter(([target]) => target !== stepId), key = this.#key(scope)
55
+ if (sessionStorage.getItem(key) !== entry.raw) { entry.failed = true; return false }
56
+ if (next.length) sessionStorage.setItem(key, JSON.stringify(next))
57
+ else sessionStorage.removeItem(key)
58
+ entry.raw = next.length ? JSON.stringify(next) : null
59
+ entry.values.delete(stepId); entry.failed = false
60
+ return true
61
+ } catch { entry.failed = true; return false }
62
+ }
47
63
  steps(scope: Scope, document: TeachingDocument): string[] { return [...this.#entry(scope).values.keys()].filter(id => Object.hasOwn(document.steps, id)) }
48
64
  failed(scope: Scope): boolean { return this.#entry(scope).failed }
49
65
  set(scope: Scope, stepId: string, value: CaptionTimingDraft | undefined): void {
@@ -54,6 +70,7 @@ export class CaptionTimingDrafts {
54
70
  const key = this.#key(scope), raw = JSON.stringify([...entry.values])
55
71
  if (raw.length > MAX_CHARS || entry.values.size > MAX_TARGETS || [...entry.values.values()].some(draft => !valid(draft))) throw new Error('caption-draft-limit')
56
72
  if (entry.values.size) sessionStorage.setItem(key, raw); else sessionStorage.removeItem(key)
73
+ entry.raw = entry.values.size ? raw : null
57
74
  entry.failed = false
58
75
  } catch { entry.failed = true }
59
76
  }