Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
/*
* three.ws Tour Builder
* =====================
* A no-code playground for @three-ws/tour. Point and click on a live demo
* storefront to build a guided tour, preview it exactly as visitors will see
* it, then export the curriculum + the two theme.liquid snippets.
*
* The tour engine is the real published build (vendored at
* /tour-builder/tour.global.js), so the preview is the product, not a mockup.
*
* Templates: a template is a ready-made tour (title, mode, avatar, sections,
* stops) a merchant can load into the editor as a starting point instead of
* hand-picking every stop. The demo storefront doubles as the built-in
* "Blank canvas" template; partner templates (e.g. Sperax) live in
* ./presets/*.js and target the partner's real site DOM, not the demo store —
* see the previewNote surfaced in the UI when one is active.
*/
import { SPERAX_TEMPLATE } from './presets/sperax.js';
const VERSION_TOUR = '0.5.2';
const VERSION_PAGE_AGENT = '0.2.0';
const STORAGE_KEY = 'tws:tour-builder:v1';
// Curated guide roster — ids match the @three-ws/walk roster. Only avatars
// whose skeleton rests in a natural pose are offered here, so the guide always
// stands and walks correctly. (Some GLBs, e.g. the Mixamo X-Bot, bind in a
// T-pose the delta-preserving retarget faithfully preserves — they'd idle with
// arms out, so they're intentionally excluded from the store-guide picker.)
const AVATARS = [
{ id: 'realistic-female', name: 'Ava', emoji: '💁♀️' },
{ id: 'realistic-male', name: 'Leo', emoji: '🙋♂️' },
{ id: 'selfie-girl', name: 'Mira', emoji: '👩' },
{ id: 'michelle', name: 'Michelle', emoji: '🧑🦱' },
{ id: 'guide', name: 'Guide', emoji: '🧍' },
{ id: 'robot', name: 'Robo', emoji: '🤖' },
];
// When a demo section is picked, also emit the common Shopify/Dawn selectors
// for the equivalent section, so exported tours land on real themes without
// hand-editing. Keyed by the demo element id under the cursor's section.
const SHOPIFY_EQUIVALENTS = {
hero: ['.banner', '.hero', '#Banner', '[id^="Banner"]', '.slideshow'],
'hero-cta': ['.banner a.button', '.hero a', '.button--primary', 'a.button'],
featured: ['#featured-collection', '.featured-collection', '.collection', '[id^="FeaturedCollection"]'],
story: ['.rich-text', '[id^="RichText"]', '.about', '.our-story'],
reviews: ['.testimonials', '.reviews', '[id*="review" i]', '.product-reviews'],
policies: ['.footer-block', '.shipping', '.policies', '.multicolumn'],
};
const $ = (s, r = document) => r.querySelector(s);
const $$ = (s, r = document) => [...r.querySelectorAll(s)];
const uid = () => 's' + Math.random().toString(36).slice(2, 8);
// ── State ────────────────────────────────────────────────────────────────
const seed = () => ({
title: 'Store tour',
mode: 'guided',
avatarId: 'realistic-female',
stops: [
{ id: uid(), title: 'Welcome', narration: 'Welcome to the store. This button takes you to the full collection.', target: '#hero-cta', targetLabel: '“Shop the collection” button', highlight: true, section: 'hero-cta' },
{ id: uid(), title: 'Featured products', narration: 'These are the pieces everyone is loving right now.', target: '#featured', targetLabel: 'Featured products', highlight: true, section: 'featured' },
{ id: uid(), title: 'Reviews', narration: 'Real reviews from real customers — 4.9 stars across thousands.', target: '#reviews', targetLabel: 'What customers say', highlight: false, section: 'reviews' },
],
});
let state;
try {
const saved = JSON.parse(localStorage.getItem(STORAGE_KEY));
state = saved && Array.isArray(saved.stops) ? saved : seed();
} catch { state = seed(); }
const save = () => { try { localStorage.setItem(STORAGE_KEY, JSON.stringify(state)); } catch {} };
// ── Templates ────────────────────────────────────────────────────────────
// "Start from a template" swaps the whole working tour for a ready-made one.
// The demo storefront (seed()) is registered as the built-in blank template so
// it shows up in the same picker as partner templates.
const TEMPLATES = [
{
id: 'blank',
name: 'Blank canvas',
blurb: 'Start over on the demo storefront — pick your own sections and write your own lines.',
build: seed,
},
{
id: SPERAX_TEMPLATE.id,
name: SPERAX_TEMPLATE.name,
blurb: SPERAX_TEMPLATE.blurb,
previewNote: SPERAX_TEMPLATE.previewNote,
build: () => ({
title: SPERAX_TEMPLATE.title,
mode: SPERAX_TEMPLATE.mode,
avatarId: SPERAX_TEMPLATE.avatarId,
templateId: SPERAX_TEMPLATE.id,
sections: SPERAX_TEMPLATE.sections,
stops: SPERAX_TEMPLATE.stops.map((s) => ({
id: uid(),
title: s.title,
narration: s.narration,
highlight: !!s.highlight,
section: s.section,
sectionIntro: s.sectionIntro,
// `target` powers the existing single-selector chip/pick UI;
// `targets` is the full primary→secondary chain exported verbatim.
target: s.targets[0],
targetLabel: s.targetLabel,
targets: s.targets,
})),
}),
},
];
function loadTemplate(id) {
const tpl = TEMPLATES.find((t) => t.id === id);
if (!tpl) return;
state = tpl.build();
save();
$('#tour-title').value = state.title;
renderMode();
renderAvatars();
renderStops();
renderTemplateNote();
toast(id === 'blank' ? 'Started a blank tour' : `Loaded the ${tpl.name} template`);
}
function renderTemplateNote() {
const tpl = TEMPLATES.find((t) => t.id === state.templateId);
const note = $('#template-note');
if (!note) return;
if (tpl && tpl.previewNote) {
note.textContent = tpl.previewNote;
note.hidden = false;
} else {
note.hidden = true;
}
}
// ── Toast ────────────────────────────────────────────────────────────────
let toastTimer;
function toast(msg) {
const t = $('#toast');
t.textContent = msg; t.classList.add('show');
clearTimeout(toastTimer);
toastTimer = setTimeout(() => t.classList.remove('show'), 2200);
}
// ── Render: mode toggle ───────────────────────────────────────────────────
const MODE_TOASTS = {
guided: 'Guided mode — the guide walks itself',
explore: 'Explore mode — visitors drive the guide',
platformer: 'Platformer mode — gravity on, visitors run and jump the store',
};
const isInteractive = (mode) => mode === 'explore' || mode === 'platformer';
function renderMode() {
for (const btn of $$('#mode-toggle .mode-opt')) {
btn.classList.toggle('sel', btn.dataset.mode === (state.mode || 'guided'));
btn.onclick = () => {
state.mode = btn.dataset.mode;
save();
renderMode();
toast(MODE_TOASTS[state.mode] || MODE_TOASTS.guided);
};
}
// The preview button label hints at what pressing it does.
const pv = $('#preview');
if (pv) pv.innerHTML = state.mode === 'platformer' ? '🎮 Play' : state.mode === 'explore' ? '🕹 Play' : '▶ Preview';
}
// ── Render: avatars ──────────────────────────────────────────────────────
function renderAvatars() {
const wrap = $('#avatars');
wrap.innerHTML = '';
for (const a of AVATARS) {
const el = document.createElement('button');
el.className = 'av' + (a.id === state.avatarId ? ' sel' : '');
el.innerHTML = `<div class="dot">${a.emoji}</div><div class="nm">${a.name}</div>`;
el.addEventListener('click', () => { state.avatarId = a.id; save(); renderAvatars(); toast(`Guide set to ${a.name}`); });
wrap.appendChild(el);
}
}
// ── Render: stops ────────────────────────────────────────────────────────
function renderStops() {
const wrap = $('#stops');
wrap.innerHTML = '';
if (!state.stops.length) {
wrap.innerHTML = `<div class="empty-stops">No stops yet.<br>Hit <b>+ Add a stop</b>, then click a section of the store to point the guide at it.</div>`;
return;
}
state.stops.forEach((stop, i) => {
const el = document.createElement('div');
el.className = 'stop';
el.innerHTML = `
<div class="stop-top">
<span class="stop-num">${i + 1}</span>
<input type="text" class="stop-title" value="${esc(stop.title)}" placeholder="Stop title" data-f="title" />
<button class="mini star ${stop.highlight ? 'on' : ''}" title="Include in the short Quick tour" data-a="star">★</button>
<button class="mini up" title="Move up" data-a="up" ${i === 0 ? 'disabled style="opacity:.3"' : ''}>↑</button>
<button class="mini down" title="Move down" data-a="down" ${i === state.stops.length - 1 ? 'disabled style="opacity:.3"' : ''}>↓</button>
<button class="mini del" title="Delete stop" data-a="del">✕</button>
</div>
<div class="stop-body">
<div class="target-row">
<span class="target-chip ${stop.target ? '' : 'empty'}" title="${esc(stop.target || '')}">${stop.target ? esc(stop.targetLabel || stop.target) : 'No section picked'}</span>
<button class="pick-btn" data-a="pick">📍 ${stop.target ? 'Re-pick' : 'Pick'}</button>
</div>
<textarea data-f="narration" placeholder="What should the guide say here?">${esc(stop.narration)}</textarea>
</div>`;
el.querySelector('[data-f="title"]').addEventListener('input', (e) => { stop.title = e.target.value; save(); });
el.querySelector('[data-f="narration"]').addEventListener('input', (e) => { stop.narration = e.target.value; save(); });
el.querySelector('[data-a="star"]').addEventListener('click', (e) => { stop.highlight = !stop.highlight; save(); e.currentTarget.classList.toggle('on'); });
el.querySelector('[data-a="del"]').addEventListener('click', () => { state.stops.splice(i, 1); save(); renderStops(); });
el.querySelector('[data-a="up"]').addEventListener('click', () => { if (i > 0) { [state.stops[i - 1], state.stops[i]] = [state.stops[i], state.stops[i - 1]]; save(); renderStops(); } });
el.querySelector('[data-a="down"]').addEventListener('click', () => { if (i < state.stops.length - 1) { [state.stops[i + 1], state.stops[i]] = [state.stops[i], state.stops[i + 1]]; save(); renderStops(); } });
el.querySelector('[data-a="pick"]').addEventListener('click', () => startPick(stop.id));
wrap.appendChild(el);
});
}
function esc(s = '') { return String(s).replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>').replace(/"/g, '"'); }
// ── Add stop ─────────────────────────────────────────────────────────────
$('#add-stop').addEventListener('click', () => {
const stop = { id: uid(), title: `Stop ${state.stops.length + 1}`, narration: '', target: '', targetLabel: '', highlight: false, section: '' };
state.stops.push(stop); save(); renderStops();
startPick(stop.id);
});
// ── Pick mode ────────────────────────────────────────────────────────────
let pickingId = null;
const outline = $('#pick-outline');
function startPick(stopId) {
pickingId = stopId;
document.body.classList.add('picking');
// make sure the store is visible while picking on narrow screens
}
function endPick() {
pickingId = null;
document.body.classList.remove('picking');
outline.classList.remove('show');
}
// The section an element belongs to (nearest ancestor with an id we know).
function sectionOf(el) {
let n = el;
while (n && n !== document.body) {
if (n.id && (n.id in SHOPIFY_EQUIVALENTS || $$('#' + CSS.escape(n.id)).length === 1)) return n.id;
n = n.parentElement;
}
return '';
}
// Build a robust, readable selector anchored on the nearest id.
function buildSelector(el) {
if (el.id) return '#' + CSS.escape(el.id);
const parts = [];
let node = el;
while (node && node.nodeType === 1 && node !== document.body) {
if (node.id) { parts.unshift('#' + CSS.escape(node.id)); break; }
let sel = node.tagName.toLowerCase();
const cls = [...node.classList].find(
(c) => /^[a-z][a-z0-9-]{2,}$/i.test(c) && document.querySelectorAll('.' + CSS.escape(c)).length <= 10,
);
if (cls) sel += '.' + CSS.escape(cls);
else if (node.parentElement) {
const sibs = [...node.parentElement.children].filter((n) => n.tagName === node.tagName);
if (sibs.length > 1) sel += `:nth-of-type(${sibs.indexOf(node) + 1})`;
}
parts.unshift(sel);
node = node.parentElement;
}
return parts.join(' ');
}
function labelFor(el) {
const h = el.matches('h1,h2,h3') ? el : el.querySelector('h1,h2,h3');
if (h && h.textContent.trim()) return `“${h.textContent.trim().slice(0, 40)}”`;
const txt = (el.textContent || '').trim();
if (el.matches('a,button') && txt) return `“${txt.slice(0, 30)}” button`;
return el.id ? `#${el.id}` : el.tagName.toLowerCase();
}
const stage = $('#stage');
stage.addEventListener('mousemove', (e) => {
if (!pickingId) return;
const el = pickTarget(e.target);
if (!el) { outline.classList.remove('show'); return; }
const r = el.getBoundingClientRect();
outline.style.left = r.left + 'px'; outline.style.top = r.top + 'px';
outline.style.width = r.width + 'px'; outline.style.height = r.height + 'px';
outline.classList.add('show');
});
// Prefer a meaningful block (a section, product, card, cta) over raw leaf text.
function pickTarget(el) {
if (!el || el === stage || el.closest('.store') == null) return null;
// climb to a "nice" pickable block
const nice = el.closest('#hero, #featured, #story, #reviews, #policies, .product, .review, .policy, .cta, .hero-art, a, button, h1, h2, h3');
return nice || el;
}
// The demo storefront's links are scenery, not navigation: they exist so the
// stage looks like a real shop you can point at. They carry no href (an
// href-less anchor is inert and stays out of the tab order, so the stage never
// hands a keyboard user a row of dead stops); this swallows any click that a
// styled child element still bubbles up.
stage.addEventListener('click', (e) => {
if (e.target.closest('[data-demo-link]')) e.preventDefault();
});
stage.addEventListener('click', (e) => {
if (!pickingId) return;
e.preventDefault(); e.stopPropagation();
const el = pickTarget(e.target);
if (!el) return;
const stop = state.stops.find((s) => s.id === pickingId);
if (stop) {
stop.target = buildSelector(el);
stop.targetLabel = labelFor(el);
stop.section = sectionOf(el) || (el.id || '');
// A manual re-pick on the demo store supersedes any template-authored
// selector chain (e.g. from the Sperax preset) — export the freshly
// picked target instead of the stale multi-site chain.
delete stop.targets;
if (!stop.title || /^Stop \d+$/.test(stop.title)) stop.title = stop.targetLabel.replace(/[“”]/g, '').replace(/ button$/, '');
save(); renderStops();
toast(`Stop points at ${stop.targetLabel}`);
}
endPick();
}, true);
document.addEventListener('keydown', (e) => {
if (e.key === 'Escape') { if (pickingId) endPick(); else if (document.body.classList.contains('previewing')) exitPreview(); }
});
// ── Drawer collapse ──────────────────────────────────────────────────────
document.body.classList.remove('drawer-collapsed-none');
$('#collapse').addEventListener('click', () => document.body.classList.add('drawer-collapsed'));
$('#reopen').addEventListener('click', () => document.body.classList.remove('drawer-collapsed'));
// ── Build a curriculum from state ────────────────────────────────────────
function curriculum({ forExport } = {}) {
const path = forExport ? '/' : location.pathname;
// A loaded template ships its own chapters (e.g. the Sperax preset's
// overview/usds/spa sections); the demo storefront falls back to the single
// "store" section it always used.
const sections = Array.isArray(state.sections) && state.sections.length
? state.sections
: [{ id: 'store', title: 'The store', intro: `Welcome — let me show you around.` }];
const defaultSection = sections[0]?.id || 'store';
return {
title: state.title || 'Store tour',
tracks: [{ id: 'full', title: 'Full tour' }, { id: 'quick', title: 'Quick tour' }],
sections,
stops: state.stops
.filter((s) => s.target || (s.targets && s.targets.length) || s.narration)
.map((s) => {
// A stop with a pre-authored selector chain (a template stop that
// hasn't been manually re-picked) exports that chain verbatim;
// otherwise fall back to the single picked target plus the
// Shopify/Dawn equivalents for that section, as before.
const targets = s.targets && s.targets.length
? s.targets
: [s.target, ...(SHOPIFY_EQUIVALENTS[s.section] || [])].filter(Boolean);
return {
path, section: s.section || defaultSection, title: s.title || 'Stop',
narration: s.narration || '', highlight: !!s.highlight,
...(s.sectionIntro ? { sectionIntro: s.sectionIntro } : {}),
...(targets.length ? { targets: [...new Set(targets)] } : {}),
};
}),
};
}
// ── Preview ──────────────────────────────────────────────────────────────
let tour = null;
let exploreWatch = null;
function preview() {
if (!state.stops.length) { toast('Add a stop first'); return; }
document.body.classList.add('previewing');
// tear down any prior instance so avatar/curriculum changes take effect
try { tour?.exit?.(); } catch {}
const make = window.createFeatureTour || window.ThreeWsTour?.createFeatureTour;
if (!make) { toast('Tour engine still loading — try again in a second'); document.body.classList.remove('previewing'); return; }
tour = make({
curriculum: curriculum(),
guideAvatarId: state.avatarId,
mode: state.mode || 'guided',
assetBase: '', // same-origin: three.ws serves /avatars + /animations
manifestUrl: '/animations/manifest.json',
deepLinkParam: '__nolink_builder', // never auto-bootstrap here
storagePrefix: 'tws:tourbuilder', // isolate from the site's own tour state
companion: false, // no walk-companion de-dupe on this page
});
// scroll store to top so the first stop is on-screen
stage.scrollTo({ top: 0, behavior: 'instant' in stage.scrollTo ? 'instant' : 'auto' });
requestAnimationFrame(() => tour.start('full'));
// Explore/platformer have their own in-experience ✕ (the one merchants
// ship). When the visitor uses it, restore the builder chrome so we're not
// stuck previewing.
clearInterval(exploreWatch);
if (isInteractive(state.mode)) {
exploreWatch = setInterval(() => {
if (tour && tour.explore && !tour.explore.isActive()) exitPreview();
}, 400);
}
}
function exitPreview() {
clearInterval(exploreWatch);
exploreWatch = null;
try { tour?.exit?.(); } catch {}
tour = null;
document.body.classList.remove('previewing');
}
$('#preview').addEventListener('click', preview);
$('#exit-preview').addEventListener('click', exitPreview);
// ── Templates modal ─────────────────────────────────────────────────────
function renderTemplatesModal() {
const list = $('#templates-list');
list.innerHTML = '';
for (const tpl of TEMPLATES) {
const card = document.createElement('div');
card.className = 'tpl-card' + (state.templateId === tpl.id || (!state.templateId && tpl.id === 'blank') ? ' sel' : '');
card.innerHTML = `<h3>${esc(tpl.name)}</h3><p>${esc(tpl.blurb)}</p><button data-tpl="${esc(tpl.id)}">${tpl.id === 'blank' ? 'Reset to blank' : 'Use this template'}</button>`;
list.appendChild(card);
}
}
function openTemplates() {
renderTemplatesModal();
$('#templates-scrim').classList.add('open');
}
function closeTemplates() { $('#templates-scrim').classList.remove('open'); }
$('#templates-open').addEventListener('click', openTemplates);
$('#templates-close').addEventListener('click', closeTemplates);
$('#templates-scrim').addEventListener('click', (e) => { if (e.target === $('#templates-scrim')) closeTemplates(); });
$('#templates-list').addEventListener('click', (e) => {
const id = e.target.closest('[data-tpl]')?.dataset.tpl;
if (!id) return;
loadTemplate(id);
closeTemplates();
});
// ── Export ───────────────────────────────────────────────────────────────
// The exported curriculum/snippet is always the real tour-sdk output — only
// the *instructions* around it adapt: the demo storefront ships as a Shopify
// theme, so its walkthrough talks about theme.liquid; a partner template like
// Sperax ships as a one-tag drop-in for any site, so the walkthrough says so.
const EXPORT_COPY = {
blank: {
title: 'Ship it to Shopify',
sub: 'Three copy-pastes and your store has a walking 3D guide. Everything below is generated from the tour you just built.',
step1: 'Upload your tour script',
step1Desc: 'In Shopify admin → <b>Content → Files</b>, upload this file, then copy the URL Shopify gives it.',
step2: 'Add the guide to your theme',
step2Desc: 'Online Store → Themes → <b>⋯ → Edit code</b> → <b>layout/theme.liquid</b>. Paste this right before <code></body></code>, and swap the URL for the one from step 1.',
guideHref: '/tutorials/shopify-store-guide',
},
sperax: {
title: 'Ship it to usds.sperax.io',
sub: 'Two copy-pastes and usds.sperax.io has a walking 3D guide. Everything below is generated from the tour you just built.',
step1: 'Host the curriculum',
step1Desc: 'Download this file and host it anywhere on your domain (a CDN bucket, <code>/public</code>, your CMS\'s file storage) — then copy its URL.',
step2: 'Drop the tag on the page',
step2Desc: 'Paste this right before <code></body></code> on usds.sperax.io, and swap the URL for the one from step 1.',
guideHref: '/tutorials/sperax-tour',
},
};
function exportCopy() {
return EXPORT_COPY[state.templateId] || EXPORT_COPY.blank;
}
function snippetEmbed() {
const avatar = state.avatarId !== 'realistic-female' ? `\n data-avatar="${state.avatarId}"` : '';
const mode = isInteractive(state.mode) ? `\n data-mode="${state.mode}"` : '';
const curriculumUrl = state.templateId === 'sperax'
? 'https://cdn.sperax.io/tour/curriculum.json'
: 'https://cdn.shopify.com/s/files/YOUR/PATH/curriculum.json';
return `<script src="https://unpkg.com/@three-ws/tour@${VERSION_TOUR}/dist/tour.global.js"
data-tour${avatar}${mode}
data-curriculum="${curriculumUrl}"
defer><\/script>`;
}
function snippetButton() {
return `<button data-tour-start class="button">✨ ${esc(state.title || 'Take the store tour')}<\/button>`;
}
function highlight(code) {
return esc(code)
.replace(/(<\/?[a-z][\w-]*)/g, '<span class="tok-tag">$1</span>')
.replace(/([a-z-]+)=(".*?")/g, '<span class="tok-attr">$1</span>=<span class="tok-str">$2</span>')
.replace(/\b(data-tour|data-tour-start|defer)\b/g, '<span class="tok-attr">$1</span>');
}
function openExport() {
const embed = snippetEmbed(), button = snippetButton();
const eEl = $('#snippet-embed'), bEl = $('#snippet-button');
eEl.innerHTML = `<button class="copybtn" data-copy="snippet-embed">Copy</button>` + highlight(embed);
bEl.innerHTML = `<button class="copybtn" data-copy="snippet-button">Copy</button>` + highlight(button);
eEl._raw = embed; bEl._raw = button;
const copy = exportCopy();
$('#modal-title').textContent = copy.title;
$('#modal-sub').textContent = copy.sub;
$('#modal-step1-title').textContent = copy.step1;
$('#modal-step1-desc').innerHTML = copy.step1Desc;
$('#modal-step2-title').textContent = copy.step2;
$('#modal-step2-desc').innerHTML = copy.step2Desc;
$('#modal-guide-link').href = copy.guideHref;
$('#modal-scrim').classList.add('open');
save();
}
$('#export').addEventListener('click', openExport);
$('#modal-close').addEventListener('click', () => $('#modal-scrim').classList.remove('open'));
$('#modal-done').addEventListener('click', () => $('#modal-scrim').classList.remove('open'));
$('#modal-scrim').addEventListener('click', (e) => { if (e.target === $('#modal-scrim')) $('#modal-scrim').classList.remove('open'); });
document.addEventListener('click', async (e) => {
const btn = e.target.closest('.copybtn');
if (!btn) return;
const raw = $('#' + btn.dataset.copy)._raw || '';
try { await navigator.clipboard.writeText(raw); btn.textContent = 'Copied!'; btn.classList.add('done'); setTimeout(() => { btn.textContent = 'Copy'; btn.classList.remove('done'); }, 1600); }
catch { toast('Copy failed — select and copy manually'); }
});
$('#dl-json').addEventListener('click', () => {
const blob = new Blob([JSON.stringify(curriculum({ forExport: true }), null, 2)], { type: 'application/json' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url; a.download = 'curriculum.json'; a.click();
URL.revokeObjectURL(url);
toast('curriculum.json downloaded');
});
// ── Boot ─────────────────────────────────────────────────────────────────
$('#tour-title').value = state.title;
$('#tour-title').addEventListener('input', (e) => { state.title = e.target.value; save(); });
renderMode();
renderAvatars();
renderStops();
renderTemplateNote();