presently 0.22.0 → 0.24.0

data/readme.md

@@ -32,7 +32,7 @@ Please see the [project documentation](https://socketry.github.io/presently/) fo
 
 ### Recording Narration
 
-Open `http://localhost:9292/record` to record narration separately from the live presenter interface. Presently stores one WebM/Opus recording per slide under `audio/`, mirroring the slide's relative path:
+Open `http://localhost:9292/recorder` to record narration separately from the live presenter interface. Presently stores one WebM/Opus recording per slide under `audio/`, mirroring the slide's relative path:
 
 ``` text
 slides/020-problem/010-overview.md
@@ -67,6 +67,19 @@ The task records the presentation at 1920×1080 and 30 frames per second by defa
 
 Please see the [project releases](https://socketry.github.io/presently/releases/index) for all releases.
 
+### v0.24.0
+
+  - Match slide duration to saved narration by default in the recorder.
+  - Keep scripted slides hidden until their initial script state has been applied.
+
+### v0.23.0
+
+  - Keep narrated playback visuals synchronized when the document or inactive slide frames are hidden.
+  - Keep recorded audio duration visible after saving a reviewed take.
+  - Prevent stopping a pointer-initiated recording from immediately starting a retake.
+  - Update slide timing from new or existing narration recordings.
+  - Render audience and narrated playback slides through the same client-side lifecycle so incremental builds behave consistently.
+
 ### v0.22.0
 
   - Split built-in slide and interface styles into focused stylesheets while retaining `index.css` for shared defaults.
@@ -109,19 +122,6 @@ Please see the [project releases](https://socketry.github.io/presently/releases/
 
   - Add support for organizing slides in nested directories. Every directory and slide filename must begin with a numeric prefix, and slides are ordered by relative path.
 
-### v0.15.0
-
-q
-
-  - Export works from current working directory.
-      - Remove explicit support for `morph` transition.
-
-### v0.14.0
-
-  - Increase code font size by 50%.
-  - Add support for includes using `![[path]]` syntax.
-  - Add `bake presently:rehearse` tasks for updating timing information.
-
 ## See Also
 
   - [lively](https://github.com/socketry/lively) — The real-time application framework that powers Presently.

data/releases.md

@@ -1,5 +1,18 @@
 # Releases
 
+## v0.24.0
+
+  - Match slide duration to saved narration by default in the recorder.
+  - Keep scripted slides hidden until their initial script state has been applied.
+
+## v0.23.0
+
+  - Keep narrated playback visuals synchronized when the document or inactive slide frames are hidden.
+  - Keep recorded audio duration visible after saving a reviewed take.
+  - Prevent stopping a pointer-initiated recording from immediately starting a retake.
+  - Update slide timing from new or existing narration recordings.
+  - Render audience and narrated playback slides through the same client-side lifecycle so incremental builds behave consistently.
+
 ## v0.22.0
 
   - Split built-in slide and interface styles into focused stylesheets while retaining `index.css` for shared defaults.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: presently
 version: !ruby/object:Gem::Version
-  version: 0.22.0
+  version: 0.24.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -137,7 +137,8 @@ files:
 - lib/presently/presentation.rb
 - lib/presently/presentation_controller.rb
 - lib/presently/presenter_view.rb
-- lib/presently/recording_view.rb
+- lib/presently/recorder_view.rb
+- lib/presently/recording_controls_view.rb
 - lib/presently/recordings.rb
 - lib/presently/recordings/normalizer.rb
 - lib/presently/slide.rb
@@ -261,7 +262,7 @@ files:
 - public/application.js
 - public/export.js
 - public/playback.js
-- public/recorder.js
+- public/recording_controls.js
 - readme.md
 - releases.md
 - templates/code.xrb

metadata.gz.sig

@@ -1,2 +1,2 @@
-��פ���[+6���-�I�6ô�Q7L�]��`�as_����ux̓Qdp.��LD�$��*�cs���R�otvC�W�][�zx!�.ȱ��/�8����B��lr�y�4�cf1e:G����@��9�J��#�	UȔ�#��Q҃b}yB���U�1&�壁����e,7<���P��{s��.�xnyipr
-��
+j�2g�s�[.��2~w�}uI���
K;	C�z��:;]��v�@�:��k4M�$+�Y�+p5���7A�n;<���,��%G��QF�e�X�P�aZS�'��HxVl��+���dn���.��jEҘ_�"��X05��A�!T���w�f�L�F�~c�����d.�~�k�F���)I�N��_����Dh�jLr��~�&�=	{�Â�߲������I�����0�oq��]v[�_?Y �{2���h��m��5���ˑBK��	b,)�M	�z#B�����dI�^~#J(ʋ~�E^Y�.�
+�4\����Z`����l����X��`�8�Y��H]Wd�g�����#W��0�K�B�*����)Y��

data/public/recorder.js

@@ -1,282 +0,0 @@
-const RECORDING_EDGE_DELAY = 100;
-
-// Records and reviews the narration for one slide. The element is recreated
-// when the selected slide changes, which gives each recording session a clear
-// lifetime and releases the microphone during navigation.
-class PresentlyRecorder extends HTMLElement {
-	#mediaRecorder = null;
-	#mediaStream = null;
-	#audioContext = null;
-	#audioSource = null;
-	#audioDelay = null;
-	#audioDestination = null;
-	#chunks = [];
-	#recording = null;
-	#recordingURL = null;
-	#startedAt = null;
-	#timer = null;
-	#startToken = null;
-	
-	connectedCallback() {
-		this.recordButton = this.querySelector('.recording-toggle');
-		this.saveButton = this.querySelector('.recording-save');
-		this.playback = this.querySelector('.recording-playback');
-		this.status = this.querySelector('.recording-status');
-		this.time = this.querySelector('.recording-time');
-		
-		// Stop as soon as the pointer is pressed so the delayed audio excludes the
-		// click. The click handler provides both starting and keyboard activation.
-		this.recordButton.addEventListener('pointerdown', () => {
-			if (this.#mediaRecorder?.state === 'recording') this.stop();
-		});
-		this.recordButton.addEventListener('click', () => {
-			if (this.recordButton.disabled) return;
-			
-			if (this.#mediaRecorder?.state === 'recording') {
-				this.stop();
-			} else {
-				this.start(performance.now());
-			}
-		});
-		this.saveButton.addEventListener('click', () => this.save());
-		
-		this.loadExisting();
-	}
-	
-	disconnectedCallback() {
-		this.#startToken = null;
-
-		if (this.#mediaRecorder?.state === 'recording') {
-			this.#mediaRecorder.onstop = null;
-			this.#mediaRecorder.stop();
-		}
-		
-		this.releaseMicrophone();
-		this.stopTimer();
-		this.releaseRecordingURL();
-	}
-	
-	get url() {
-		return this.dataset.recordingUrl;
-	}
-	
-	async loadExisting() {
-		try {
-			const response = await fetch(this.url, {method: 'HEAD', cache: 'no-store'});
-			
-			if (response.ok) {
-				this.playback.src = this.cacheBustedURL();
-				this.playback.hidden = false;
-				this.recordButton.textContent = '● Retake';
-				this.setStatus('Existing recording loaded.');
-			} else if (response.status === 404) {
-				this.setStatus('No recording yet.');
-			} else {
-				throw new Error(`Could not check recording (${response.status}).`);
-			}
-		} catch (error) {
-			this.setStatus(error.message, true);
-		}
-	}
-	
-	async start(clickedAt) {
-		const AudioContext = window.AudioContext || window.webkitAudioContext;
-		if (!window.MediaRecorder || !navigator.mediaDevices?.getUserMedia || !AudioContext) {
-			this.setStatus('Audio recording is not supported by this browser.', true);
-			return;
-		}
-		
-		const mimeType = 'audio/webm;codecs=opus';
-		if (!MediaRecorder.isTypeSupported(mimeType)) {
-			this.setStatus(`${mimeType} recording is not supported by this browser.`, true);
-			return;
-		}
-		
-		const startToken = this.#startToken = {};
-		this.recordButton.disabled = true;
-		this.saveButton.disabled = true;
-		this.dataset.state = 'preparing';
-		this.setStatus('Preparing microphone…');
-
-		try {
-			this.playback.pause();
-			this.#audioContext = new AudioContext();
-			await this.#audioContext.resume();
-
-			if (this.#startToken !== startToken || !this.isConnected) {
-				this.releaseMicrophone();
-				return;
-			}
-
-			const audio = {};
-			if (navigator.mediaDevices.getSupportedConstraints().autoGainControl) {
-				// Preserve the microphone's dynamics for consistent offline normalization.
-				audio.autoGainControl = false;
-			}
-
-			const mediaStream = await navigator.mediaDevices.getUserMedia({audio});
-
-			if (this.#startToken !== startToken || !this.isConnected) {
-				mediaStream.getTracks().forEach(track => track.stop());
-				this.releaseMicrophone();
-				return;
-			}
-
-			this.#mediaStream = mediaStream;
-			this.#audioSource = this.#audioContext.createMediaStreamSource(mediaStream);
-
-			this.#audioDelay = this.#audioContext.createDelay(RECORDING_EDGE_DELAY / 1000);
-			this.#audioDelay.delayTime.value = RECORDING_EDGE_DELAY / 1000;
-			this.#audioDestination = this.#audioContext.createMediaStreamDestination();
-			this.#audioSource
-				.connect(this.#audioDelay)
-				.connect(this.#audioDestination);
-
-			this.#chunks = [];
-			this.#mediaRecorder = new MediaRecorder(this.#audioDestination.stream, {mimeType});
-			
-			this.#mediaRecorder.addEventListener('dataavailable', (event) => {
-				if (event.data.size > 0) this.#chunks.push(event.data);
-			});
-			
-			this.#mediaRecorder.onstop = () => this.finish();
-
-			this.dataset.state = 'starting';
-			this.setStatus('Starting…');
-
-			// Audio reaches MediaRecorder 100 ms after it reaches the microphone. Starting
-			// the encoder 200 ms after the click therefore retains audio beginning 100 ms
-			// after pointer-up. If microphone setup took longer, wait only long enough for
-			// the newly-created delay line to contain live audio.
-			const startAt = Math.max(
-				clickedAt + RECORDING_EDGE_DELAY * 2,
-				performance.now() + RECORDING_EDGE_DELAY,
-			);
-			await new Promise(resolve => window.setTimeout(resolve, Math.max(0, startAt - performance.now())));
-
-			if (this.#startToken !== startToken || !this.isConnected) return;
-
-			this.#mediaRecorder.start();
-			this.#startToken = null;
-			this.startTimer();
-			
-			this.recordButton.disabled = false;
-			this.recordButton.textContent = '■ Stop';
-			this.dataset.state = 'recording';
-			this.setStatus('Recording…');
-		} catch (error) {
-			if (this.#startToken !== startToken) return;
-
-			this.#startToken = null;
-			this.releaseMicrophone();
-			this.recordButton.disabled = false;
-			this.dataset.state = 'idle';
-			this.setStatus(`Could not start recording: ${error.message}`, true);
-		}
-	}
-	
-	stop() {
-		if (this.#mediaRecorder?.state === 'recording') {
-			// The encoder receives audio through a 100 ms delay. Stopping immediately
-			// excludes approximately the final 100 ms before this pointer-down event.
-			this.#mediaRecorder.stop();
-			this.recordButton.disabled = true;
-			this.dataset.state = 'finishing';
-			this.setStatus('Preparing recording…');
-		}
-	}
-	
-	finish() {
-		this.stopTimer();
-		this.releaseMicrophone();
-		this.releaseRecordingURL();
-		
-		this.#recording = new Blob(this.#chunks, {type: 'audio/webm'});
-		this.#recordingURL = URL.createObjectURL(this.#recording);
-		this.playback.src = this.#recordingURL;
-		this.playback.hidden = false;
-		
-		this.recordButton.disabled = false;
-		this.recordButton.textContent = '● Retake';
-		this.saveButton.disabled = this.#recording.size === 0;
-		this.dataset.state = 'review';
-		this.setStatus(this.#recording.size > 0 ? 'Review the recording, then save it.' : 'The recording was empty.', this.#recording.size === 0);
-	}
-	
-	async save() {
-		if (!this.#recording) return;
-		
-		this.saveButton.disabled = true;
-		this.setStatus('Saving…');
-		
-		try {
-			const response = await fetch(this.url, {
-				method: 'PUT',
-				headers: {'content-type': this.#recording.type},
-				body: this.#recording,
-			});
-			
-			if (!response.ok) {
-				throw new Error((await response.text()) || `Could not save recording (${response.status}).`);
-			}
-			
-			this.playback.src = this.cacheBustedURL();
-			this.releaseRecordingURL();
-			this.#recording = null;
-			this.setStatus('Recording saved.');
-		} catch (error) {
-			this.saveButton.disabled = false;
-			this.setStatus(`Could not save recording: ${error.message}`, true);
-		}
-	}
-	
-	startTimer() {
-		this.#startedAt = performance.now();
-		this.updateTimer();
-		this.#timer = window.setInterval(() => this.updateTimer(), 250);
-	}
-	
-	stopTimer() {
-		if (this.#timer) window.clearInterval(this.#timer);
-		this.#timer = null;
-	}
-	
-	updateTimer() {
-		const elapsed = Math.floor((performance.now() - this.#startedAt) / 1000);
-		const minutes = Math.floor(elapsed / 60);
-		const seconds = String(elapsed % 60).padStart(2, '0');
-		this.time.textContent = `${minutes}:${seconds}`;
-	}
-	
-	releaseMicrophone() {
-		this.#mediaStream?.getTracks().forEach(track => track.stop());
-		this.#mediaStream = null;
-
-		this.#audioDestination?.stream.getTracks().forEach(track => track.stop());
-		this.#audioSource?.disconnect();
-		this.#audioDelay?.disconnect();
-		this.#audioDestination?.disconnect();
-		this.#audioContext?.close().catch(() => {});
-
-		this.#audioContext = null;
-		this.#audioSource = null;
-		this.#audioDelay = null;
-		this.#audioDestination = null;
-	}
-	
-	releaseRecordingURL() {
-		if (this.#recordingURL) URL.revokeObjectURL(this.#recordingURL);
-		this.#recordingURL = null;
-	}
-	
-	cacheBustedURL() {
-		return `${this.url}&version=${Date.now()}`;
-	}
-	
-	setStatus(message, error = false) {
-		this.status.textContent = message;
-		this.status.classList.toggle('error', error);
-	}
-}
-
-customElements.define('presently-recorder', PresentlyRecorder);