OpenSenseNova/SenseNova-Skills / skills/sn-motion-html
sn-motion-html
VerifiedBuild continuous-shot motion-driven HTML stories from a subject or narrative, including research, story structure, consistent AI stills, Seedance scene and connector clips, interface styling, media normalization, and browser QA. Use for immersive journeys, timelines, product stories, fictional worlds, or other scene-based visual narratives whose camera should flow from beginning to end; not for ordinary autoplay video pages or general web apps.
assets/template/src/motion-runtime.js
View on GitHub(function expose(global) {
global.mountMotionHTML = function mountMotionHTML(container, config) {
const chapters = config.chapters || [];
const connectorUrls = config.connectors || [];
const reduced = matchMedia('(prefers-reduced-motion: reduce)').matches;
const clamp = (value, min = 0, max = 1) => Math.min(max, Math.max(min, value));
const smooth = (value) => {
const x = clamp(value);
return x * x * (3 - 2 * x);
};
const node = (tag, className) => {
const element = document.createElement(tag);
element.className = className || '';
return element;
};
const escapeHtml = (value) => String(value).replace(
/[&<>\"]/g,
(character) => ({ '&': '&', '<': '<', '>': '>', '"': '"' }[character]),
);
container.className = 'mh-root';
container.replaceChildren();
document.documentElement.dataset.ui = config.ui || 'folio';
const stage = node('div', 'mh-stage');
const copyLayer = node('div', 'mh-copy-layer');
const header = node('header', 'mh-header');
const brand = node('a', 'mh-brand');
brand.href = '#top';
brand.innerHTML = `
${config.kicker ? `<span>${escapeHtml(config.kicker)}</span>` : ''}
<strong>${escapeHtml(config.title || '')}</strong>
${config.subtitle ? `<i>${escapeHtml(config.subtitle)}</i>` : ''}`;
const chapterStatus = node('p', 'mh-header__status');
const sourceLink = node('a', 'mh-header__source');
sourceLink.href = '#sources';
sourceLink.textContent = 'Sources';
header.append(brand, chapterStatus, sourceLink);
const progress = node('div', 'mh-progress');
const progressFill = node('i');
progress.appendChild(progressFill);
const navigation = node('nav', 'mh-route');
navigation.setAttribute('aria-label', 'Story chapters');
const hint = node('div', 'mh-hint');
hint.innerHTML = '<span>Move through the story</span><i aria-hidden="true"></i>';
const track = node('div', 'mh-track');
container.append(stage, copyLayer, header, progress, navigation, hint, track);
const segments = [];
const sceneSegments = [];
chapters.forEach((chapter, chapterIndex) => {
const scene = {
kind: 'scene',
chapterIndex,
still: chapter.still,
clip: chapter.clip,
units: chapter.span || 4.6,
linger: chapter.linger || 0,
};
segments.push(scene);
sceneSegments.push(scene);
if (chapterIndex < chapters.length - 1 && connectorUrls[chapterIndex]) {
segments.push({
kind: 'connector',
chapterIndex,
still: chapter.still,
clip: connectorUrls[chapterIndex],
units: config.connectorSpan || 1.2,
linger: 0,
});
}
});
segments.forEach((segment, index) => {
const shot = node('div', 'mh-shot');
shot.dataset.kind = segment.kind;
const chapter = chapters[segment.chapterIndex] || {};
const fallback = node('div', 'mh-shot__fallback');
fallback.innerHTML = `<span>${String(index + 1).padStart(2, '0')}</span><strong>${escapeHtml(chapter.label || chapter.title || '')}</strong>`;
const poster = node('img', 'mh-shot__poster');
poster.alt = segment.kind === 'scene' ? (chapter.label || chapter.title || '') : '';
poster.decoding = 'async';
poster.loading = index < 2 ? 'eager' : 'lazy';
if (segment.still) poster.src = segment.still;
poster.addEventListener('error', () => shot.classList.add('is-missing'));
shot.append(fallback, poster);
stage.appendChild(shot);
Object.assign(segment, {
shot,
poster,
video: null,
loading: false,
failed: false,
ready: false,
visible: false,
current: 0,
target: 0,
});
});
const copies = [];
const navButtons = [];
chapters.forEach((chapter, index) => {
const article = node('article', 'mh-copy');
article.dataset.position = chapter.copyPosition || (index % 2 ? 'right' : 'left');
if (chapter.accent) article.style.setProperty('--mh-scene-accent', chapter.accent);
const paragraphs = (chapter.paragraphs || []).map((text) => `<p>${escapeHtml(text)}</p>`).join('');
const tags = (chapter.tags || []).map((text) => `<li>${escapeHtml(text)}</li>`).join('');
article.innerHTML = `
<p class="mh-copy__index">${String(index + 1).padStart(2, '0')} <span>/</span> ${String(chapters.length).padStart(2, '0')}</p>
${chapter.eyebrow ? `<p class="mh-copy__eyebrow">${escapeHtml(chapter.eyebrow)}</p>` : ''}
<h2>${escapeHtml(chapter.title || '')}</h2>
${chapter.subtitle ? `<p class="mh-copy__subtitle">${escapeHtml(chapter.subtitle)}</p>` : ''}
<div class="mh-copy__body">${paragraphs}</div>
${tags ? `<ul class="mh-copy__tags">${tags}</ul>` : ''}`;
copyLayer.appendChild(article);
copies.push(article);
const button = node('button', 'mh-route__item');
button.type = 'button';
button.innerHTML = `<span>${String(index + 1).padStart(2, '0')}</span><i>${escapeHtml(chapter.label || chapter.title || '')}</i>`;
button.setAttribute('aria-label', `Go to ${chapter.label || chapter.title || `chapter ${index + 1}`}`);
button.addEventListener('click', () => {
const target = sceneSegments[index]?.start || 0;
cancelTransition();
restingScene = index;
setPosition(target);
});
navigation.appendChild(button);
navButtons.push(button);
});
let viewportHeight = innerHeight;
let viewportWidth = innerWidth;
let totalUnits = 0;
let readQueued = false;
let activeChapter = -1;
// Wheel input scrubs scenes, but a connector has its own media clock.
const snapThreshold = Math.max(40, Number(config.snapThreshold) || 160);
const connectorRate = clamp(Number(config.connectorPlaybackRate) || 0.8, 0.25, 1);
let transition = null;
let wheelIntent = 0;
let intentConnector = null;
let lastWheel = -Infinity;
let cooldownUntil = 0;
let restingScene = null;
let destroyed = false;
let animationFrame = 0;
let lastFrame = 0;
let expectedScroll = scrollY;
function setPosition(y) {
expectedScroll = y;
scrollTo({ top: y, behavior: 'instant' });
read();
}
function cancelTransition() {
transition = null;
wheelIntent = 0;
intentConnector = null;
delete container.dataset.transition;
}
function startTransition(segment, direction) {
wheelIntent = 0;
intentConnector = null;
restingScene = null;
loadClip(segment);
transition = { segment, direction, progress: clamp((scrollY - segment.start) / (segment.end - segment.start)), waited: 0 };
container.dataset.transition = 'playing';
}
function moveBy(delta, now) {
if (transition || now < cooldownUntil) return;
const direction = Math.sign(delta);
if (!direction) return;
const y = scrollY;
const proposed = clamp(y + delta, 0, totalUnits * viewportHeight);
// Search in travel order so a large reverse gesture stops at the nearest connector.
const travelOrder = direction > 0 ? segments : [...segments].reverse();
const connector = travelOrder.find((s) => s.kind === 'connector' && (
direction > 0 ? y < s.end - 1 && proposed >= s.start - 1
: y > s.start + 1 && proposed <= s.end + 1
));
if (!connector) {
wheelIntent = 0;
intentConnector = null;
restingScene = null;
setPosition(proposed);
return;
}
const boundary = direction > 0 ? connector.start : connector.end;
const inside = y > connector.start + 1 && y < connector.end - 1;
const push = inside ? Math.abs(delta) : Math.max(0, Math.abs(delta) - Math.abs(boundary - y));
if (intentConnector !== connector || Math.sign(wheelIntent) !== direction) wheelIntent = 0;
intentConnector = connector;
wheelIntent += direction * push;
// Hold on the departure boundary until the gesture has enough intent.
if (!inside) {
restingScene = direction > 0 ? connector.chapterIndex : connector.chapterIndex + 1;
setPosition(boundary + (direction > 0 ? -1 : 1));
}
if (Math.abs(wheelIntent) >= snapThreshold) startTransition(connector, direction);
}
function handlesInput(event) {
if (reduced || config.scrollSnap === false || event.ctrlKey || event.metaKey) return false;
if (document.querySelector('dialog[open]')) return false;
if (event.target?.closest?.('input, textarea, select, [contenteditable="true"]')) return false;
// Let long mobile copy and other nested scrolling surfaces scroll normally.
for (let el = event.target; el && el !== container && el !== document.body; el = el.parentElement) {
const delta = event.deltaY || 0;
const canScroll = !delta || (delta > 0 ? el.scrollTop + el.clientHeight < el.scrollHeight - 1 : el.scrollTop > 0);
if (canScroll && el.scrollHeight > el.clientHeight + 1 && /auto|scroll/.test(getComputedStyle(el).overflowY)) return false;
}
return true;
}
function onWheel(event) {
if (!handlesInput(event) || Math.abs(event.deltaX) > Math.abs(event.deltaY) || !event.deltaY) return;
event.preventDefault();
const now = performance.now();
const gap = now - lastWheel;
lastWheel = now;
if (transition || now < cooldownUntil) {
cooldownUntil = now + 260; // Drain momentum; never queue the next connector.
return;
}
if (gap > 240) wheelIntent = 0;
const multiplier = event.deltaMode === 1 ? 16 : event.deltaMode === 2 ? viewportHeight : 1;
moveBy(event.deltaY * multiplier, now);
}
function onKey(event) {
if (event.key === 'Escape') { cancelTransition(); return; }
if (!handlesInput(event) || event.target?.closest?.('button, a')) return;
const delta = { ArrowDown: 80, ArrowUp: -80, PageDown: viewportHeight * 0.8,
PageUp: -viewportHeight * 0.8, ' ': viewportHeight * (event.shiftKey ? -0.8 : 0.8) }[event.key];
if (delta === undefined) return;
event.preventDefault();
moveBy(delta, performance.now());
}
function tickTransition(dt, now) {
if (!transition || document.hidden) return;
const t = transition;
const segment = t.segment;
t.waited += dt;
// Start only after the media is decoded; missing media uses the poster after a bounded wait.
if (!segment.ready && !segment.failed && segment.clip && t.waited < 8000) return;
const seconds = Number.isFinite(segment.video?.duration) ? segment.video.duration : 4;
t.progress = clamp(t.progress + t.direction * dt * connectorRate / (Math.max(0.1, seconds) * 1000));
setPosition(segment.start + t.progress * (segment.end - segment.start));
if ((t.direction > 0 && t.progress >= 1) || (t.direction < 0 && t.progress <= 0)) {
restingScene = segment.chapterIndex + (t.direction > 0 ? 1 : 0);
const destination = t.direction > 0 ? segment.end + 1 : segment.start - 1;
cancelTransition();
cooldownUntil = now + 350;
setPosition(destination);
}
}
function layout() {
cancelTransition();
viewportHeight = innerHeight;
viewportWidth = innerWidth;
let offset = 0;
segments.forEach((segment) => {
segment.start = offset * viewportHeight;
offset += segment.units;
segment.end = offset * viewportHeight;
});
totalUnits = offset;
track.style.height = `${(totalUnits + 1) * viewportHeight}px`;
read();
}
function loadClip(segment) {
if (reduced || segment.loading || segment.failed || !segment.clip) return;
segment.loading = true;
fetch(segment.clip)
.then((response) => response.ok ? response.blob() : Promise.reject(new Error(String(response.status))))
.then((blob) => {
if (destroyed) return;
const video = node('video', 'mh-shot__video');
video.muted = true;
video.playsInline = true;
video.preload = 'auto';
video.src = URL.createObjectURL(blob);
video.addEventListener('loadeddata', () => {
if (destroyed) return;
segment.ready = true;
shotReady(segment);
scheduleRead();
});
video.addEventListener('error', () => { segment.failed = true; segment.ready = false; });
video.addEventListener('seeked', () => shotReady(segment), { once: true });
segment.shot.appendChild(video);
segment.video = video;
})
.catch(() => {
segment.failed = true;
segment.loading = false;
segment.shot.classList.add('is-missing');
});
}
function shotReady(segment) {
segment.shot.classList.add('has-video');
}
function remapWithLinger(progress, amount) {
// A strictly increasing easing curve: reading slows the shot, never freezes it.
const p = clamp(progress);
const strength = clamp(Number(amount) || 0, 0, 0.6);
return p + strength * Math.sin(2 * Math.PI * p) / (2 * Math.PI);
}
function read() {
if (destroyed) return;
const y = scrollY;
const fadeDistance = Math.max(1, viewportHeight * 0.14);
let currentSegment = segments[0];
segments.forEach((segment) => {
const local = clamp((y - segment.start) / Math.max(1, segment.end - segment.start));
const distance = y < segment.start ? segment.start - y : y > segment.end ? y - segment.end : 0;
const opacity = distance === 0 ? 1 : smooth(1 - distance / fadeDistance);
segment.shot.style.opacity = opacity;
segment.visible = opacity > 0.01;
segment.target = remapWithLinger(local, segment.linger);
if (y >= segment.start) currentSegment = segment;
if (distance < viewportHeight * 2.2) loadClip(segment);
if (!segment.ready) segment.poster.style.transform = `scale(${(1.02 + local * 0.06).toFixed(3)})`;
});
chapters.forEach((chapter, index) => {
const scene = sceneSegments[index];
const local = clamp((y - scene.start) / Math.max(1, scene.end - scene.start));
const inside = y >= scene.start && y <= scene.end;
const enter = 1; // A landed chapter stays readable when scrolling resumes.
const leave = index === chapters.length - 1 ? 1 : smooth((1 - local) / 0.09);
const opacity = inside ? Math.min(enter, leave) : (index === chapters.length - 1 && y > scene.end ? 1 : 0);
copies[index].style.opacity = restingScene === index ? 1 : opacity;
copies[index].style.pointerEvents = (restingScene === index || opacity > 0.7) ? 'auto' : 'none';
});
const localChapter = currentSegment.kind === 'scene'
? currentSegment.chapterIndex
: currentSegment.chapterIndex + (currentSegment.target >= 0.5 ? 1 : 0);
if (localChapter !== activeChapter) {
activeChapter = localChapter;
const chapter = chapters[activeChapter] || {};
chapterStatus.textContent = `${String(activeChapter + 1).padStart(2, '0')} — ${chapter.label || chapter.title || ''}`;
navButtons.forEach((button, index) => {
button.classList.toggle('is-active', index === activeChapter);
if (index === activeChapter) button.setAttribute('aria-current', 'step');
else button.removeAttribute('aria-current');
});
}
const maximum = Math.max(1, totalUnits * viewportHeight);
progressFill.style.transform = `scaleX(${clamp(y / maximum)})`;
hint.classList.toggle('is-hidden', y > viewportHeight * 0.2);
readQueued = false;
}
function onScroll() {
if (Math.abs(scrollY - expectedScroll) > 2) {
cancelTransition();
restingScene = null;
}
expectedScroll = scrollY;
scheduleRead();
}
function scheduleRead() {
if (readQueued) return;
readQueued = true;
requestAnimationFrame(read);
}
function animate(now) {
if (destroyed) return;
const dt = lastFrame ? Math.min(50, now - lastFrame) : 0;
lastFrame = now;
tickTransition(dt, now);
segments.forEach((segment) => {
if (!segment.visible || !segment.ready || !segment.video) return;
if (segment.kind === 'connector') segment.current = segment.target;
else segment.current += (segment.target - segment.current) * (1 - Math.exp(-dt / 80));
const targetTime = clamp(segment.current, 0, 0.999) * (segment.video.duration || 1);
if (!segment.video.seeking && Math.abs(segment.video.currentTime - targetTime) > 0.01) segment.video.currentTime = targetTime;
});
animationFrame = requestAnimationFrame(animate);
}
function primeVideos() {
segments.forEach((segment) => {
if (!segment.video) return;
const promise = segment.video.play();
if (promise?.then) promise.then(() => segment.video.pause()).catch(() => {});
});
}
function onResize() {
if (innerWidth === viewportWidth && Math.abs(innerHeight - viewportHeight) < 80) return;
layout();
}
addEventListener('wheel', onWheel, { passive: false });
addEventListener('keydown', onKey);
addEventListener('scroll', onScroll, { passive: true });
addEventListener('resize', onResize);
addEventListener('touchstart', primeVideos, { once: true, passive: true });
addEventListener('pointerdown', primeVideos, { once: true, passive: true });
layout();
animationFrame = requestAnimationFrame(animate);
return function destroy() {
destroyed = true;
cancelAnimationFrame(animationFrame);
cancelTransition();
removeEventListener('wheel', onWheel);
removeEventListener('keydown', onKey);
removeEventListener('touchstart', primeVideos);
removeEventListener('pointerdown', primeVideos);
removeEventListener('scroll', onScroll);
removeEventListener('resize', onResize);
segments.forEach((segment) => {
if (segment.video?.src.startsWith('blob:')) URL.revokeObjectURL(segment.video.src);
});
};
};
})(window);
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |