@linto-ai/transcript-ui-core 0.9.11 → 0.9.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linto-ai/transcript-ui-core",
-  "version": "0.9.11",
+  "version": "0.9.13",
   "description": "State layer and UI shell for @linto-ai/transcript-ui — core, stores, format adapters, and the TranscriptUI component",
   "keywords": [
     "vue",
@@ -39,8 +39,8 @@
     "vue": "^3.5.0"
   },
   "dependencies": {
-    "@linto-ai/transcript-ui-i18n": "0.9.11",
-    "@linto-ai/transcript-ui-ui": "0.9.11",
+    "@linto-ai/transcript-ui-i18n": "0.9.13",
+    "@linto-ai/transcript-ui-ui": "0.9.13",
     "vue-stick-to-bottom": "^1.0.0"
   }
 }

package/src/components/Header.vue

@@ -11,11 +11,15 @@ const props = defineProps<{
   speakerCount: number
   isMobile: boolean
   canAsk?: boolean
+  canUndo?: boolean
+  canRedo?: boolean
 }>()
 
 defineEmits<{
   toggleSidebar: []
   openChat: []
+  undo: []
+  redo: []
 }>()
 
 const { t, locale } = useI18n()
@@ -45,7 +49,10 @@ const metaParts = computed(() =>
     <div class="header-main">
       <h1 class="document-title">{{ formattedTitle }}</h1>
       <div v-if="metaParts.length" class="document-meta">
-        <span v-for="(part, i) in metaParts" :key="i" class="document-meta__part">
+        <span
+          v-for="(part, i) in metaParts"
+          :key="i"
+          class="document-meta__part">
           {{ part }}
         </span>
       </div>
@@ -58,6 +65,20 @@ const metaParts = computed(() =>
         @click="$emit('toggleSidebar')">
         <template #icon><EditorIcon name="users" :size="16" /></template>
       </Button>
+      <Button
+        variant="secondary"
+        :aria-label="t('header.undo')"
+        :disabled="!props.canUndo"
+        @click="$emit('undo')">
+        <template #icon><EditorIcon name="undo" :size="16" /></template>
+      </Button>
+      <Button
+        variant="secondary"
+        :aria-label="t('header.redo')"
+        :disabled="!props.canRedo"
+        @click="$emit('redo')">
+        <template #icon><EditorIcon name="redo" :size="16" /></template>
+      </Button>
       <Button
         variant="primary"
         :aria-label="t('header.ask')"

package/src/components/Layout.vue

@@ -109,8 +109,12 @@ function onTranslationChange(translationId: string) {
       :speaker-count="speakers.size"
       :is-mobile="isMobile"
       :can-ask="!!core.chat"
+      :can-undo="core.transcriptionEditor?.canUndo.value ?? false"
+      :can-redo="core.transcriptionEditor?.canRedo.value ?? false"
       @toggle-sidebar="isSidebarOpen = !isSidebarOpen"
-      @open-chat="core.chat?.setDrawerOpen(true)" />
+      @open-chat="core.chat?.setDrawerOpen(true)"
+      @undo="core.transcriptionEditor?.undo()"
+      @redo="core.transcriptionEditor?.redo()" />
     <TabBar v-model="activeTab" />
     <SelectionActionBar v-if="showTranscription" />
     <main class="editor-body">

package/src/components/VerbatimPanel.vue

@@ -56,7 +56,7 @@ function exportAsText(): void {
 
 function onExport(format?: string): void {
   if (!format) return
-  if (format === "txt" && core.verbatimFormatsAreDefault) {
+  if (format === "txt" && core.verbatimFormatsAreDefault.value) {
     exportAsText()
     return
   }
@@ -68,7 +68,7 @@ function onExport(format?: string): void {
   <section class="verbatim-panel">
     <DocumentArticle>
       <template #toolbar-right>
-        <DownloadMenu :formats="core.verbatimFormats" @select="onExport" />
+        <DownloadMenu :formats="core.verbatimFormats.value" @select="onExport" />
       </template>
 
       <article class="verbatim-panel__content">

package/src/core/createCore.ts

@@ -33,9 +33,17 @@ export function createCore(options: CoreOptions = {}): Core {
   const capabilities = ref<CoreCapabilities>(
     options.capabilities ?? { text: "edit", speakers: "edit" },
   )
-  const verbatimFormatsAreDefault = options.verbatimFormats == null
-  const verbatimFormats =
-    options.verbatimFormats ?? DEFAULT_VERBATIM_FORMATS
+  // Ref, not a plain array: unlike `document` (setDocument) or `capabilities`
+  // (already a Ref), there is no dedicated setter, and no web component prop
+  // either (an array can't cross an HTML attribute cleanly) — a host sets
+  // this the same way it sets capabilities, core.verbatimFormats.value = […],
+  // once it holds `core` (see TranscriptUI's defineExpose).
+  const verbatimFormats = ref<DownloadFormat[]>(
+    options.verbatimFormats ?? DEFAULT_VERBATIM_FORMATS,
+  )
+  const verbatimFormatsAreDefault = computed(
+    () => verbatimFormats.value === DEFAULT_VERBATIM_FORMATS,
+  )
 
   // ── Event bus ──────────────────────────────────────────────────────
 

package/src/core/index.ts

@@ -26,6 +26,7 @@ export type {
   TurnSpeakerUpdated,
   SpeakerRenamed,
   SpeakerReplaced,
+  SpeakerRestored,
   LivePluginApi,
   LivePartialEventData,
   LiveFinalEventData,

package/src/core/types.ts

@@ -263,6 +263,10 @@ export interface TurnSpeakerUpdated {
   speaker: { id: string; name: string }
   removedSpeakerId?: string
   version?: number
+  /** @see SpeakerRenamed.revisionId */
+  revisionId?: string | null
+  /** @see SpeakerRenamed.redoRevisionId */
+  redoRevisionId?: string | null
 }
 
 export interface SpeakerRenamed {
@@ -270,6 +274,18 @@ export interface SpeakerRenamed {
   speakerId: string
   name: string
   version?: number
+  /** The undo cursor AFTER this broadcast (see onUndo/onRedo server-side) —
+   *  a plain rename and an undo/redo replaying one are indistinguishable on
+   *  the wire, and don't need to be: both just mean "the cursor is here
+   *  now". Absent from broadcasts predating the undo/redo feature. */
+  revisionId?: string | null
+  /** The revision a redo would target FROM this new cursor, server-computed
+   *  — null when there's nothing to redo to. This is server truth, not a
+   *  client guess: right after a fresh mutation it's always null (nothing
+   *  could already be chained onto a revision that didn't exist a moment
+   *  ago), right after an undo it's the revision just undone, right after a
+   *  redo it's whatever (if anything) comes next in the chain. */
+  redoRevisionId?: string | null
 }
 
 /** From-speaker replaced by to-speaker on every turn — its removal is
@@ -279,6 +295,27 @@ export interface SpeakerReplaced {
   fromSpeakerId: string
   toSpeakerId: string
   version?: number
+  /** @see SpeakerRenamed.revisionId */
+  revisionId?: string | null
+  /** @see SpeakerRenamed.redoRevisionId */
+  redoRevisionId?: string | null
+}
+
+/** Undo of a replace_speaker: fromSpeaker resurrected and turnIds moved back
+ *  onto it — the mirror of SpeakerReplaced, not its opposite payload shape
+ *  (fromSpeaker rides the raw stored speaker record, not just its id, since
+ *  restoring it is literally re-inserting that record). Redo of the same
+ *  replace_speaker re-broadcasts SpeakerReplaced, not this. */
+export interface SpeakerRestored {
+  translationId: string
+  fromSpeaker: { speaker_id: string; speaker_name: string }
+  toSpeakerId: string
+  turnIds: string[]
+  version?: number
+  /** @see SpeakerRenamed.revisionId */
+  revisionId?: string | null
+  /** @see SpeakerRenamed.redoRevisionId */
+  redoRevisionId?: string | null
 }
 
 export interface TranscriptionEditorPluginApi {
@@ -310,6 +347,16 @@ export interface TranscriptionEditorPluginApi {
   /** Reassign every turn of a speaker to another (speaker merge). */
   replaceSpeaker(fromSpeakerId: string, toSpeakerId: string): void
 
+  // ── Undo/redo (speaker mutations only — see server EditorHandler) ──
+  /** True when the active translation has a speaker mutation to undo. */
+  readonly canUndo: ComputedRef<boolean>
+  /** True when the active translation has an undo to redo — server-computed
+   *  (see SpeakerRenamed.redoRevisionId), not a client guess: stays correct
+   *  across collaborators, no staleness caveat. */
+  readonly canRedo: ComputedRef<boolean>
+  undo(): void
+  redo(): void
+
   // ── Server sync (host-pushed from broadcasts) ──
   /** Apply a saved turn broadcast by the server (any track, any author). */
   applyTurnUpdate(update: TurnUpdate): void
@@ -330,6 +377,9 @@ export interface TranscriptionEditorPluginApi {
   applyTurnSpeakerUpdated(update: TurnSpeakerUpdated): void
   applySpeakerRenamed(renamed: SpeakerRenamed): void
   applySpeakerReplaced(replaced: SpeakerReplaced): void
+  /** Apply an undo of replace_speaker (server event editor:speaker_restored
+   *  — redo re-broadcasts applySpeakerReplaced instead, see SpeakerRestored). */
+  applySpeakerRestored(restored: SpeakerRestored): void
 
   // ── Locks (host-pushed from server broadcasts; UI pulls per turn) ──
   /** Lock held on a turn of the ACTIVE translation, if any. */
@@ -570,11 +620,15 @@ export interface Core {
   readonly date: Ref<string | number | null>
   readonly activeChannelId: Ref<string>
   readonly capabilities: Ref<CoreCapabilities>
-  /** Formats shown in the verbatim panel's download menu (see CoreOptions.verbatimFormats). */
-  readonly verbatimFormats: DownloadFormat[]
-  /** True when verbatimFormats is the built-in default — the verbatim panel
-   *  then fulfills "txt" itself instead of emitting "verbatim:export". */
-  readonly verbatimFormatsAreDefault: boolean
+  /** Formats shown in the verbatim panel's download menu (see
+   *  CoreOptions.verbatimFormats for the initial value). A Ref, not a plain
+   *  array: there's no dedicated setter and no web component prop (a web
+   *  component attribute can't carry an array) — set verbatimFormats.value
+   *  directly once you hold `core`, the same way you set capabilities. */
+  readonly verbatimFormats: Ref<DownloadFormat[]>
+  /** True when verbatimFormats is still the built-in default — the verbatim
+   *  panel then fulfills "txt" itself instead of emitting "verbatim:export". */
+  readonly verbatimFormatsAreDefault: ComputedRef<boolean>
 
   // ── Stores ───────────────────────────────────────────────────────────
   readonly speakers: SpeakersStore

package/src/index.ts

@@ -30,6 +30,7 @@ export type {
   TurnSpeakerUpdated,
   SpeakerRenamed,
   SpeakerReplaced,
+  SpeakerRestored,
   LivePluginApi,
   LivePartialEventData,
   LiveFinalEventData,