path: root/src/App.vue

<script lang="ts">
import {defineComponent, PropType} from 'vue';
// Components
import Tile from './components/Tile.vue';
import AncestryBar from './components/AncestryBar.vue';
import TileInfoModal from './components/TileInfoModal.vue';
import HelpModal from './components/HelpModal.vue';
import SearchModal from './components/SearchModal.vue';
import SettingsPane from './components/SettingsPane.vue';
// Icons
import HelpIcon from './components/icon/HelpIcon.vue';
import SearchIcon from './components/icon/SearchIcon.vue';
import PlayIcon from './components/icon/PlayIcon.vue';
import SettingsIcon from './components/icon/SettingsIcon.vue';
// Other
import {TolNode, TolNodeRaw, tolFromRaw, getTolMap} from './tol';
import {LayoutNode, initLayoutTree, initLayoutMap, tryLayout} from './layout';
import type {LayoutOptions} from './layout';
import {arraySum, randWeightedChoice} from './util';
// Note: Import paths lack a .ts or .js extension because .ts makes vue-tsc complain, and .js makes vite complain

// Type representing auto-mode actions
type Action = 'move across' | 'move down' | 'move up' |
	'expand' | 'collapse' | 'expand to view' | 'expand ancestry bar';
// Used in auto-mode to help avoid action cycles
function getReverseAction(action: Action): Action | null {
	let reversePairs: Action[][] = [
		['move down', 'move up'],
		['expand', 'collapse'],
		['expand to view', 'expand ancestry bar'],
	];
	let pair = reversePairs.find(pair => pair.includes(action));
	if (pair != null){
		return pair[0] == action ? pair[1] : pair[0];
	} else {
		return null;
	}
}

// Get tree-of-life data
import tolRaw from './tolData.json';
const tol = tolFromRaw(tolRaw);
const tolMap = getTolMap(tol);

// Configurable options
const defaultLytOpts: LayoutOptions = {
	tileSpacing: 8, //px
	headerSz: 22, //px
	minTileSz: 50, //px
	maxTileSz: 200, //px
	// Layout-algorithm related
	layoutType: 'sweep', //'sqr' | 'rect' | 'sweep'
	rectMode: 'auto first-row', //'horz' | 'vert' | 'linear' | 'auto' | 'auto first-row'
	sweepMode: 'left', //'left' | 'top' | 'shorter' | 'auto'
	sweptNodesPrio: 'pow-2/3', //'linear' | 'sqrt' | 'pow-2/3'
	sweepToParent: true,
};
const defaultUiOpts = {
	// For tiles
	borderRadius: 5, //px
	shadowNormal: '0 0 2px black',
	shadowHighlight: '0 0 1px 2px greenyellow',
	shadowFocused: '0 0 1px 2px orange',
	infoIconSz: 18, //px
	infoIconMargin: 2, //px
	// For leaf tiles
	leafTilePadding: 4, //px
	leafHeaderFontSz: 15, //px
	leafHeaderColor: '#fafaf9',
	leafHeaderExColor: 'greenyellow', //yellow, greenyellow, turquoise,
	// For non-leaf tiles
	nonleafBgColors: ['#44403c', '#57534e'], //tiles at depth N use the Nth color, repeating from the start as needed
	nonleafHeaderFontSz: 15, //px
	nonleafHeaderColor: '#fafaf9',
	nonleafHeaderBgColor: '#1c1917',
	// For other components
	appBgColor: '#292524',
	tileAreaOffset: 5, //px (space between root tile and display boundary)
	ancestryBarSz: defaultLytOpts.minTileSz * 2, //px (breadth of ancestry-bar area)
	ancestryBarBgColor: '#44403c',
	ancestryTileMargin: 5, //px (gap between detached-ancestor tiles)
	ancestryBarScrollGap: 10, //px (gap for ancestry-bar scrollbar, used to prevent overlap with tiles)
	infoModalImgSz: 200,
	autoWaitTime: 500, //ms (time to wait between actions (with their transitions))
	// Timing related
	tileChgDuration: 300, //ms (for tile move/expand/collapse)
	clickHoldDuration: 400, //ms (duration after mousedown when a click-and-hold is recognised)
};

export default defineComponent({
	data(){
		let layoutTree = initLayoutTree(tol, 0);
		return {
			layoutTree: layoutTree,
			activeRoot: layoutTree, // Differs from layoutTree root when expand-to-view is used
			layoutMap: initLayoutMap(layoutTree), // Maps names to LayoutNode objects
			tolMap: tolMap, // Maps names to TolNode objects
			// Modals and settings related
			infoModalNode: null as TolNode | null, // Node to display info for, or null
			helpOpen: false,
			searchOpen: false,
			settingsOpen: false,
			// For search and auto-mode
			modeRunning: false,
			lastFocused: null as LayoutNode | null,
			// For auto-mode
			autoPrevAction: null as Action | null, // Used to help prevent action cycles
			autoPrevActionFail: false, // Used to avoid re-trying a failed expand/collapse
			// Options
			lytOpts: {...defaultLytOpts},
			uiOpts: {...defaultUiOpts},
			// For window-resize handling
			width: document.documentElement.clientWidth,
			height: document.documentElement.clientHeight,
			resizeThrottled: false,
			resizeDelay: 50, //ms (increasing to 100 seems to cause resize-skipping when opening browser mobile-view)
		};
	},
	computed: {
		wideArea(): boolean {
			return this.width >= this.height;
		},
		// Nodes to show in ancestry-bar, with tol root first
		detachedAncestors(): LayoutNode[] | null {
			if (this.activeRoot == this.layoutTree){
				return null;
			}
			let ancestors = [];
			let node = this.activeRoot.parent;
			while (node != null){
				ancestors.push(node);
				node = node.parent;
			}
			return ancestors.reverse();
		},
		// Placement info for Tile and AncestryBar
		tileAreaPos(){
			let pos = [this.uiOpts.tileAreaOffset, this.uiOpts.tileAreaOffset] as [number, number];
			if (this.detachedAncestors != null){
				if (this.wideArea){
					pos[0] += this.uiOpts.ancestryBarSz;
				} else {
					pos[1] += this.uiOpts.ancestryBarSz;
				}
			}
			return pos;
		},
		tileAreaDims(){
			let dims = [
				this.width - this.uiOpts.tileAreaOffset*2,
				this.height - this.uiOpts.tileAreaOffset*2
			] as [number, number];
			if (this.detachedAncestors != null){
				if (this.wideArea){
					dims[0] -= this.uiOpts.ancestryBarSz;
				} else {
					dims[1] -= this.uiOpts.ancestryBarSz;
				}
			}
			return dims;
		},
		ancestryBarDims(): [number, number] {
			if (this.wideArea){
				return [this.uiOpts.ancestryBarSz, this.height];
			} else {
				return [this.width, this.uiOpts.ancestryBarSz];
			}
		},
	},
	methods: {
		// For tile expand/collapse events
		onLeafClick(layoutNode: LayoutNode){
			let success = tryLayout(this.activeRoot, this.tileAreaPos, this.tileAreaDims, this.lytOpts,
				{allowCollapse: false, chg: {type: 'expand', node: layoutNode}, layoutMap: this.layoutMap});
			if (!success){
				layoutNode.failFlag = !layoutNode.failFlag; // Triggers failure animation
			}
			return success;
		},
		onNonleafClick(layoutNode: LayoutNode){
			let success = tryLayout(this.activeRoot, this.tileAreaPos, this.tileAreaDims, this.lytOpts,
				{allowCollapse: false, chg: {type: 'collapse', node: layoutNode}, layoutMap: this.layoutMap});
			if (!success){
				layoutNode.failFlag = !layoutNode.failFlag; // Triggers failure animation
			}
			return success;
		},
		// For expand-to-view and ancestry-bar events
		onLeafClickHeld(layoutNode: LayoutNode){
			if (layoutNode == this.activeRoot){
				console.log('Ignored expand-to-view on active-root node');
				return;
			}
			LayoutNode.hideUpward(layoutNode);
			this.activeRoot = layoutNode;
			tryLayout(this.activeRoot, this.tileAreaPos, this.tileAreaDims, this.lytOpts,
				{allowCollapse: true, chg: {type: 'expand', node: layoutNode}, layoutMap: this.layoutMap});
		},
		onNonleafClickHeld(layoutNode: LayoutNode){
			if (layoutNode == this.activeRoot){
				console.log('Ignored expand-to-view on active-root node');
				return;
			}
			LayoutNode.hideUpward(layoutNode);
			this.activeRoot = layoutNode;
			tryLayout(this.activeRoot, this.tileAreaPos, this.tileAreaDims, this.lytOpts,
				{allowCollapse: true, layoutMap: this.layoutMap, });
		},
		onDetachedAncestorClick(layoutNode: LayoutNode){
			LayoutNode.showDownward(layoutNode);
			this.activeRoot = layoutNode;
			tryLayout(this.activeRoot, this.tileAreaPos, this.tileAreaDims, this.lytOpts,
				{allowCollapse: true, layoutMap: this.layoutMap});
		},
		// For tile-info events
		onInfoIconClick(node: LayoutNode){
			this.resetMode();
			this.infoModalNode = node.tolNode;
		},
		// For help events
		onHelpIconClick(){
			this.resetMode();
			this.helpOpen = true;
		},
		// For search events
		onSearchIconClick(){
			this.resetMode();
			this.searchOpen = true;
		},
		onSearchNode(tolNode: TolNode){
			this.searchOpen = false;
			this.modeRunning = true;
			this.expandToTolNode(tolNode);
		},
		expandToTolNode(tolNode: TolNode){
			if (!this.modeRunning){
				return;
			}
			// Check if searched node is displayed
			let layoutNode = this.layoutMap.get(tolNode.name);
			if (layoutNode != null && !layoutNode.hidden){
				this.setLastFocused(layoutNode);
				this.modeRunning = false;
				return;
			}
			// Get nearest in-layout-tree ancestor
			let ancestor = tolNode;
			while (this.layoutMap.get(ancestor.name) == null){
				ancestor = ancestor.parent!;
			}
			layoutNode = this.layoutMap.get(ancestor.name)!;
			// If hidden, expand self/ancestor in ancestry-bar
			if (layoutNode.hidden){
				while (!this.detachedAncestors!.includes(layoutNode)){
					ancestor = ancestor.parent!;
					layoutNode = this.layoutMap.get(ancestor.name)!;
				}
				this.onDetachedAncestorClick(layoutNode!);
				setTimeout(() => this.expandToTolNode(tolNode), this.uiOpts.tileChgDuration);
				return;
			}
			// Attempt tile-expand
			let success = this.onLeafClick(layoutNode);
			if (success){
				setTimeout(() => this.expandToTolNode(tolNode), this.uiOpts.tileChgDuration);
				return;
			}
			// Attempt expand-to-view on ancestor just below activeRoot
			if (ancestor.name == this.activeRoot.tolNode.name){
				console.log('Unable to complete search (not enough room to expand active root)');
					// Note: Only happens if screen is significantly small or node has significantly many children
				this.modeRunning = false;
				return;
			}
			while (true){
				if (ancestor.parent!.name == this.activeRoot.tolNode.name){
					break;
				}
				ancestor = ancestor.parent!;
			}
			layoutNode = this.layoutMap.get(ancestor.name)!;
			this.onNonleafClickHeld(layoutNode);
			setTimeout(() => this.expandToTolNode(tolNode), this.uiOpts.tileChgDuration);
		},
		// For auto-mode events
		onPlayIconClick(){
			this.resetMode();
			this.modeRunning = true;
			this.autoAction();
		},
		autoAction(){
			if (!this.modeRunning){
				this.setLastFocused(null);
				return;
			}
			if (this.lastFocused == null){
				// Pick random leaf LayoutNode
				let layoutNode = this.activeRoot;
				while (layoutNode.children.length > 0){
					let childWeights = layoutNode.children.map(n => n.dCount);
					let idx = randWeightedChoice(childWeights);
					layoutNode = layoutNode.children[idx!];
				}
				this.setLastFocused(layoutNode);
				setTimeout(this.autoAction, this.uiOpts.autoWaitTime);
			} else {
				// Determine available actions
				let action: Action | null;
				let actionWeights: {[key: string]: number}; // Maps actions to choice weights
				let node = this.lastFocused;
				if (node.children.length == 0){
					actionWeights = {'move across': 1, 'move up': 2, 'expand': 3};
					// Zero weights for disallowed actions
					if (node == this.activeRoot || node.parent!.children.length == 1){
						actionWeights['move across'] = 0;
					}
					if (node == this.activeRoot){
						actionWeights['move up'] = 0;
					}
					if (node.tolNode.children.length == 0){
						actionWeights['expand'] = 0;
					}
				} else {
					actionWeights = {
						'move across': 1, 'move down': 2, 'move up': 1,
						'collapse': 1, 'expand to view': 1, 'expand ancestry bar': 1
					};
					// Zero weights for disallowed actions
					if (node == this.activeRoot || node.parent!.children.length == 1){
						actionWeights['move across'] = 0;
					}
					if (node == this.activeRoot){
						actionWeights['move up'] = 0;
					}
					if (!node.children.every(n => n.children.length == 0)){
						actionWeights['collapse'] = 0; // Only collapse if all children are leaves
					}
					if (node.parent != this.activeRoot){
						actionWeights['expand to view'] = 0; // Only expand-to-view if direct child of activeRoot
					}
					if (this.activeRoot.parent == null || node != this.activeRoot){
						actionWeights['expand ancestry bar'] = 0; // Only expand ancestry-bar if able and activeRoot
					}
				}
				if (this.autoPrevAction != null){ // Avoid undoing previous action
					let revAction = getReverseAction(this.autoPrevAction);
					if (revAction != null && revAction in actionWeights){
						actionWeights[revAction as keyof typeof actionWeights] = 0;
					}
					if (this.autoPrevActionFail){
						actionWeights[this.autoPrevAction as keyof typeof actionWeights] = 0;
					}
				}
				// Choose action
				let actionList = Object.getOwnPropertyNames(actionWeights);
				let weightList = actionList.map(action => actionWeights[action]);
				if (arraySum(weightList) == 0){
					action = null;
				} else {
					action = actionList[randWeightedChoice(weightList)!] as Action;
				}
				// Perform action
				this.autoPrevActionFail = false;
				switch (action){
					case 'move across': // Bias towards siblings with higher dCount
						let siblings = node.parent!.children.filter(n => n != node);
						let siblingWeights = siblings.map(n => n.dCount + 1);
						this.setLastFocused(siblings[randWeightedChoice(siblingWeights)!]);
						break;
					case 'move down': // Bias towards children with higher dCount
						let childWeights = node.children.map(n => n.dCount + 1);
						this.setLastFocused(node.children[randWeightedChoice(childWeights)!]);
						break;
					case 'move up':
						this.setLastFocused(node.parent!);
						break;
					case 'expand':
						this.autoPrevActionFail = !this.onLeafClick(node);
						break;
					case 'collapse':
						this.autoPrevActionFail = !this.onNonleafClick(node);
						break;
					case 'expand to view':
						this.onNonleafClickHeld(node);
						break;
					case 'expand ancestry bar':
						this.onDetachedAncestorClick(node.parent!);
						break;
				}
				setTimeout(this.autoAction, this.uiOpts.tileChgDuration + this.uiOpts.autoWaitTime);
				this.autoPrevAction = action;
			}
		},
		// For settings events
		onSettingsIconClick(){
			this.resetMode();
			this.settingsOpen = true;
		},
		onLayoutOptionChange(){
			tryLayout(this.activeRoot, this.tileAreaPos, this.tileAreaDims, this.lytOpts,
				{allowCollapse: true, layoutMap: this.layoutMap});
		},
		// For other events
		onResize(){
			if (!this.resizeThrottled){
				this.width = document.documentElement.clientWidth;
				this.height = document.documentElement.clientHeight;
				tryLayout(this.activeRoot, this.tileAreaPos, this.tileAreaDims, this.lytOpts, 
					{allowCollapse: true, layoutMap: this.layoutMap});
				// Prevent re-triggering until after a delay
				this.resizeThrottled = true;
				setTimeout(() => {this.resizeThrottled = false;}, this.resizeDelay);
			}
		},
		onKeyUp(evt: KeyboardEvent){
			if (evt.key == 'Escape'){
				this.resetMode();
			} else if (evt.key == 'F' && evt.ctrlKey){ // On ctrl-shift-f
				if (!this.searchOpen){
					this.onSearchIconClick();
				} else {
					(this.$refs.searchModal as InstanceType<typeof SearchModal>).focusInput();
				}
			}
		},
		// Helper methods
		resetMode(){
			this.infoModalNode = null;
			this.searchOpen = false;
			this.helpOpen = false;
			this.settingsOpen = false;
			this.modeRunning = false;
			this.setLastFocused(null);
		},
		setLastFocused(node: LayoutNode | null){
			if (this.lastFocused != null){
				this.lastFocused.hasFocus = false;
			}
			this.lastFocused = node;
			if (node != null){
				node.hasFocus = true;
			}
		},
	},
	created(){
		window.addEventListener('resize', this.onResize);
		window.addEventListener('keyup', this.onKeyUp);
		tryLayout(this.activeRoot, this.tileAreaPos, this.tileAreaDims, this.lytOpts,
			{allowCollapse: true, layoutMap: this.layoutMap});
	},
	unmounted(){
		window.removeEventListener('resize', this.onResize);
		window.removeEventListener('keyup', this.onKeyUp);
	},
	components: {
		Tile, AncestryBar,
		HelpIcon, SearchIcon, PlayIcon, SettingsIcon,
		TileInfoModal, HelpModal, SearchModal, SettingsPane,
	},
});
</script>

<template>
<div class="absolute left-0 top-0 w-screen h-screen overflow-hidden" :style="{backgroundColor: uiOpts.appBgColor}">
	<!-- Note: Making the above enclosing div's width/height dynamic seems to cause white flashes when resizing -->
	<tile :layoutNode="layoutTree" :lytOpts="lytOpts" :uiOpts="uiOpts"
		@leaf-click="onLeafClick" @nonleaf-click="onNonleafClick"
		@leaf-click-held="onLeafClickHeld" @nonleaf-click-held="onNonleafClickHeld"
		@info-icon-click="onInfoIconClick"/>
	<ancestry-bar v-if="detachedAncestors != null"
		:pos="[0,0]" :dims="ancestryBarDims" :nodes="detachedAncestors"
		:lytOpts="lytOpts" :uiOpts="uiOpts"
		@detached-ancestor-click="onDetachedAncestorClick" @info-icon-click="onInfoIconClick"/>
	<!-- Icons -->
	<help-icon @click="onHelpIconClick"
		class="absolute bottom-[6px] left-[6px] w-[18px] h-[18px]
			text-white/40 hover:text-white hover:cursor-pointer"/>
	<search-icon @click="onSearchIconClick"
		class="absolute bottom-[6px] left-[30px] w-[18px] h-[18px]
			text-white/40 hover:text-white hover:cursor-pointer"/>
	<play-icon @click="onPlayIconClick"
		class="absolute bottom-[6px] left-[54px] w-[18px] h-[18px]
			text-white/40 hover:text-white hover:cursor-pointer"/>
	<!-- Modals -->
	<transition name="fade">
		<tile-info-modal v-if="infoModalNode != null" :tolNode="infoModalNode" :uiOpts="uiOpts"
			@info-modal-close="infoModalNode = null"/>
	</transition>
	<transition name="fade">
		<search-modal v-if="searchOpen" :tolMap="tolMap" :uiOpts="uiOpts"
			@search-close="searchOpen = false" @search-node="onSearchNode" ref="searchModal"/>
	</transition>
	<transition name="fade">
		<help-modal v-if="helpOpen" :uiOpts="uiOpts" @help-modal-close="helpOpen = false"/>
	</transition>
	<!-- Settings -->
	<transition name="slide-bottom-right">
		<settings-pane v-if="settingsOpen" :lytOpts="lytOpts" :uiOpts="uiOpts"
			@settings-close="settingsOpen = false" @layout-option-change="onLayoutOptionChange"/>
		<div v-else class="absolute bottom-0 right-0 w-[100px] h-[100px] invisible">
			<!-- Note: Above enclosing div prevents transition interference with inner rotate -->
			<div class="absolute bottom-[-50px] right-[-50px] w-[100px] h-[100px] visible -rotate-45
				bg-black text-white hover:cursor-pointer" @click="onSettingsIconClick">
				<settings-icon class="w-6 h-6 mx-auto mt-2"/>
			</div>
		</div>
	</transition>
	<!-- Overlay used to prevent interaction and capture clicks -->
	<div :style="{visibility: modeRunning ? 'visible' : 'hidden'}"
		class="absolute left-0 top-0 w-full h-full" @click="modeRunning = false"></div>
</div>
</template>

<style>
.fade-enter-from, .fade-leave-to {
	opacity: 0;
}
.fade-enter-active, .fade-leave-active {
	transition-property: opacity;
	transition-duration: 300ms;
	transition-timing-function: ease-out;
}
.slide-bottom-right-enter-from, .slide-bottom-right-leave-to {
	transform: translate(100%, 100%);
	opacity: 0;
}
.slide-bottom-right-enter-active, .slide-bottom-right-leave-active {
	transition-property: transform, opacity;
	transition-duration: 300ms;
	transition-timing-function: ease-in-out;
}
</style>