Method displayDialog

src/actions/Dialog.ts:361–399

(dialog: string, clearDialog: string, character: string, animation: boolean)

	}

	async displayDialog(dialog: string, clearDialog: string, character: string, animation: boolean): Promise<void> {
		if (this.nvl === false) {
			const textBox = this.engine.element().find('[data-component="text-box"]').get(0) as any;

			if (!textBox) {
				this.engine.debug.error('Text box component not found');
				return;
			}

			if (textBox.props?.mode === 'nvl' && this._cycle === 'Application' && this.engine.global('_restoring_state') === false) {
				this.engine.history('nvl').push(textBox.content('dialog').html());
			}

			// NOTE: setProps does NOT trigger a re-render — it only updates the
			// mode attribute on the element so CSS (text-box[mode="adv"]) applies.
			// The type-writer child persists across mode changes by design.
			textBox.setProps({ mode: 'adv' });

			// Destroy any active NVL entry type-writers before clearing to prevent
			// leaked animation frames from detached elements.
			this.engine.element().find('[data-ui="say"] [data-spoke] type-writer').each((tw: any) => {
				if (typeof tw.destroy === 'function') {
					tw.destroy();
				}
			});

			// Remove contents from the dialog area.
			this.engine.element().find('[data-ui="say"]').html('');
			this.engine.element().find('[data-component="text-box"]').data('speaking', character);

			// Find the type-writer component inside the text-box (ADV mode has it)
			const typeWriter = this.engine.element().find('[data-component="text-box"] type-writer').get(0) as TypeWriter | undefined;
			if (typeWriter) {
				typeWriter.setContent(dialog, animation);
			}
		} else {
			this.displayNvlDialog(dialog, clearDialog, character, animation);
		}
	}


	characterDialog(): Promise<void> {