Edge-Drop is a clipboard shelf on the edge of your screen. Hover to open it. Drag files and images into any app, click to copy text and links. Free and open-source for Windows.
TypeScript clipboardclipboard-managerdesktop-appdrag-and-dropelectronopen-sourceproductivityproductivity-toolwindows
feat(onboarding): continuous flow, live welcome and idle-aware replays
Deepender25d35c91a7fc78
diff --git a/src/Onboarding.tsx b/src/Onboarding.tsxindex 60a03d9..36a60be 100644--- a/src/Onboarding.tsx+++ b/src/Onboarding.tsx@@ -21,8 +21,8 @@ import { applyReduceMotion } from './lib/theme'import { useTranslation } from './i18n'import { DEFAULT_SETTINGS, type Settings, type StickPosition } from '../shared/types'import { PEN_PATH, PEN_TRANSFORM, PEN_WIDTH, GLASS_BOX, SHADOW_BOX, BLUR_BOX, penProgress } from './onboarding/lettering'-import { DEMOS, Run, STOP, itemsFor, resetDemoState, type Stage } from './onboarding/tour'-import { laptopBar, tourBar, SHELF_SCALE, TOUR_SCREEN_TOP } from './onboarding/edgeBar'+import { DEMOS, Run, STOP, itemsFor, playLooped, resetDemoState, watchActivity, type Stage } from './onboarding/tour'+import { laptopBar, tourBar, shelfTransform, SHELF_SCALE, TOUR_SCREEN_TOP } from './onboarding/edgeBar'import skyUrl from './assets/onboarding/sky.png'import glassUrl from './assets/onboarding/glass.png'import glassShadowUrl from './assets/onboarding/glass-shadow.png'@@ -43,7 +43,7 @@ interface Step {// The intro's timing: the pen touches down, writes, the word holds, then the focus pull.const TOUCH_MS = 450const WRITE_MS = 3200-const HOLD_MS = 1200+const HOLD_MS = 600export function Onboarding() {const { t } = useTranslation()@@ -94,15 +94,28 @@ export function Onboarding() {keys: keysRef.current!,keysLabel: keysLabelRef.current!,notes: notesRef.current!,- notesImage: notesImageRef.current!+ notesImage: notesImageRef.current!,+ showShelf: (on) => {+ setShelf(on)+ setBarShown(!on)+ }})+ /** Plays step i's demo after `delay` ms, again and again while the step is up. */+ const play = (run: Run, i: number, delay: number) => {+ const s = steps[i]+ const demo = DEMOS[s.key]+ if (!demo) return+ run.sleep(delay).then(() => playLooped(run, stage(), s.key, s.open, demo)).catch((e) => { if (e !== STOP) console.error(e) })+ }+// The tour's own store: the user's settings (language, motion, accent), the// shelf docked at the top for the demo, and no items of the user's.useEffect(() => {let cancelled = false// Marks the page for shelf parts portaled outside the tour's scaled layer (see .ob-tour).document.body.classList.add('ob-tour')+ const unwatch = watchActivity()document.body.style.setProperty('--ob-shelf-scale', String(SHELF_SCALE))document.body.style.setProperty('--ob-shelf-top', `${TOUR_SCREEN_TOP}px`)void edge.loadState().then(async ({ settings }) => {@@ -130,6 +143,7 @@ export function Onboarding() {})return () => {cancelled = true+ unwatch()document.body.classList.remove('ob-tour')document.body.style.removeProperty('--ob-shelf-scale')document.body.style.removeProperty('--ob-shelf-top')@@ -151,6 +165,10 @@ export function Onboarding() {const focus = () => {setIntro('focus')later(900, () => setIntro('done'))+ // The welcome's demo follows the focus pull without a pause.+ const run = new Run()+ runRef.current = run+ play(run, 0, 1200)}if (useStore.getState().settings.reduceMotion) {draw(1)@@ -208,10 +226,8 @@ export function Onboarding() {} else if (s.view === 'full') {useStore.setState({ items: itemsFor(s.key), open: s.open })}- const demo = DEMOS[s.key]- if (demo) {- run.sleep(flying ? 1200 : 650).then(() => demo(run, stage())).catch((e) => { if (e !== STOP) console.error(e) })- }+ // The next demo starts as the camera lands, or straight away: each step's cards are where the last one left them.+ play(run, i, flying ? 700 : 250)// eslint-disable-next-line react-hooks/exhaustive-deps}, [at, steps.length])@@ -274,7 +290,7 @@ export function Onboarding() {{ready && (<divclassName={`ob-shelf${shelf ? '' : ' is-hidden'}`}- style={{ transform: `translateY(${TOUR_SCREEN_TOP}px) scale(${SHELF_SCALE})` }}+ style={{ transform: shelfTransform(cam) }}aria-hidden><Panel />diff --git a/src/onboarding/edgeBar.ts b/src/onboarding/edgeBar.tsindex 851ba59..ba4ac6f 100644--- a/src/onboarding/edgeBar.ts+++ b/src/onboarding/edgeBar.ts@@ -34,6 +34,16 @@ const TOUR = { scale: 1.125, ox: 400, oy: 10, ty: 0 }/** Where the screen's top edge lands in the window in the tour (the shelf hangs from it). */export const TOUR_SCREEN_TOP = TOUR.oy + (LAPTOP_SCREEN.top - TOUR.oy) * TOUR.scale + TOUR.ty+/**+ * The shelf layer's transform: hung from the screen's top edge in the tour, or (welcome) on the whole+ * laptop, smaller by the camera's push-in. Both are linear in the camera's progress, so with the same+ * transition as .ob-cam the shelf rides the push-in fixed to the screen edge.+ */+export const shelfTransform = (cam: 'frame' | 'tour') =>+ cam === 'tour'+ ? `translateY(${TOUR_SCREEN_TOP}px) scale(${SHELF_SCALE})`+ : `translateY(${LAPTOP_SCREEN.top}px) scale(${SHELF_SCALE / TOUR.scale})`+/** Length of the top dock's bar (Panel: triggerWidthPx). */function topBarLength(hotZoneHeight: number): number {return hotZoneHeight >= 0.55 ? 575 : hotZoneHeight >= 0.35 ? 400 : 275diff --git a/src/onboarding/tour.ts b/src/onboarding/tour.tsindex ba4fe96..61971c6 100644--- a/src/onboarding/tour.ts+++ b/src/onboarding/tour.ts@@ -13,7 +13,7 @@ import { useStore } from '../store/appStore'import type { ClipboardItemDto } from '../../shared/types'import { dragGhostSvg } from '../../shared/dragGhost'import { fileIconUrl, fileKindOf, type FileKind } from '../lib/fileKind'-import { SHELF_SCALE, TOUR_SCREEN_TOP, toShelfLayer } from './edgeBar'+import { LAPTOP_SCREEN, SHELF_SCALE, TOUR_SCREEN_TOP, toShelfLayer } from './edgeBar'import {demoText, demoLink, demoImage, demoPdf, demoStack, demoSingle, demoMerged, STACK_FILES, DEMO_DIR} from './demoItems'@@ -56,6 +56,8 @@ export interface Stage {keysLabel: HTMLElementnotes: HTMLElementnotesImage: HTMLElement+ /** Welcome: the real shelf in place of the drawn bar on the laptop (the closed bars match exactly). */+ showShelf: (on: boolean) => void}const MOVE = 'cubic-bezier(.45,0,.25,1)'@@ -66,6 +68,7 @@ export function itemsFor(step: string, now = Date.now()): ClipboardItemDto[] {const four = [demoText(now - 4000), demoImage(now - 9000), demoLink(now - 14000), demoPdf(now - 19000)]const split = [demoSingle(now - 2000, STACK_FILES[0]), demoStack(now - 3000, STACK_FILES.slice(1))]switch (step) {+ case 'welcome': return fourcase 'collect': return []case 'drag': return fourcase 'stacks': return four@@ -87,6 +90,7 @@ export function resetDemoState(stage: Stage): void {stage.keys.getAnimations().forEach((a) => a.cancel())stage.notes.getAnimations().forEach((a) => a.cancel())stage.notesImage.getAnimations().forEach((a) => a.cancel())+ stage.root.querySelector('.ob-shelf')?.getAnimations().forEach((a) => a.cancel())}// ---------- helpers ----------@@ -185,10 +189,24 @@ function capture(item: ClipboardItemDto) {// ---------- the demos ----------+/** Welcome: the pointer goes to the bar on the edge and the shelf opens; it moves away and the shelf hides. */+export async function demoWelcome(run: Run, stage: Stage) {+ const p = new Pointer(run, stage.cursor)+ set({ items: itemsFor('welcome'), open: false })+ stage.showShelf(true)+ await p.show(540, 250)+ await p.move(400, LAPTOP_SCREEN.top + 3, 800)+ set({ open: true })+ await run.sleep(1200)+ await p.move(520, 330, 650)+ set({ open: false })+ await run.sleep(400)+ await p.hide()+}+/** Copy four things while the shelf is closed, then open it: everything is there. */export async function demoCollect(run: Run, stage: Stage) {const p = new Pointer(run, stage.cursor)- await run.sleep(250)const now = Date.now()for (const [item, label] of [[demoPdf(now), 'Itinerary.pdf'],@@ -199,9 +217,8 @@ export async function demoCollect(run: Run, stage: Stage) {await keys(run, stage, label)capture(item)copyFlare(run)- await run.sleep(650)+ await run.sleep(500)}- await run.sleep(300)await p.show(560, 300)await p.move(400, TOUR_SCREEN_TOP + 5, 700)set({ open: true })@@ -213,8 +230,10 @@ export async function demoCollect(run: Run, stage: Stage) {/** Drag the image card out of the shelf into another app. */export async function demoDrag(run: Run, stage: Stage) {const p = new Pointer(run, stage.cursor)- run.animate(stage.notes, [{ opacity: 0, transform: 'translateY(14px) scale(.97)' }, { opacity: 1, transform: 'none' }], { duration: 420 }).catch(() => {})- await run.sleep(300)+ // the other app opens once; a replay finds it already there+ if (!stage.notes.getAnimations().length) {+ run.animate(stage.notes, [{ opacity: 0, transform: 'translateY(14px) scale(.97)' }, { opacity: 1, transform: 'none' }], { duration: 420 }).catch(() => {})+ }await p.show(600, 400)const src = card(stage, 'demo-image')const c = centre(src)@@ -235,7 +254,6 @@ export async function demoDrag(run: Run, stage: Stage) {/** Copy three files at once: they arrive as one stack. */export async function demoStacks(run: Run, stage: Stage) {- await run.sleep(300)await keys(run, stage, '3 files')capture(demoStack(Date.now()))copyFlare(run)@@ -250,7 +268,7 @@ export async function demoUngroup(run: Run, stage: Stage) {await p.move(c.x, c.y, 650)await p.press()set({ expandedStackId: 'demo-stack' })- await run.sleep(700)+ await run.sleep(550)// The expanded stack's first file row (StackItems).const tile = stage.root.querySelector<HTMLElement>('.item-main[data-id="demo-stack"] .stack-row')if (!tile) throw STOP@@ -322,6 +340,7 @@ export async function demoPreview(run: Run, stage: Stage) {}export const DEMOS: Record<string, ((run: Run, stage: Stage) => Promise<void>) | undefined> = {+ welcome: demoWelcome,collect: demoCollect,drag: demoDrag,stacks: demoStacks,@@ -329,3 +348,70 @@ export const DEMOS: Record<string, ((run: Run, stage: Stage) => Promise<void>) |merge: demoMerge,preview: demoPreview}++// ---------- replays ----------++/** How long the viewer has to be idle on a finished demo before it plays again. */+const REPLAY_IDLE = 4000++let lastActive = 0++/** Tracks the viewer's activity (pointer, wheel, keys), so a replay waits while they are busy. */+export function watchActivity(): () => void {+ const mark = () => { lastActive = performance.now() }+ const events = ['pointermove', 'pointerdown', 'wheel', 'keydown'] as const+ events.forEach((e) => window.addEventListener(e, mark, { passive: true }))+ return () => events.forEach((e) => window.removeEventListener(e, mark))+}++/** Resolves once the viewer has been idle for `ms` since `from` (activity restarts the count). */+async function idleFor(run: Run, ms: number) {+ const from = performance.now()+ while (performance.now() - Math.max(from, lastActive) < ms) await run.sleep(200)+}++const shelfLayer = (stage: Stage) => stage.root.querySelector<HTMLElement>('.ob-shelf')++/**+ * Back to the step's start for a replay, gently: the preview closes, the dropped picture fades from the+ * other app, and when the cards differ the shelf fades out, takes the step's cards back and fades in+ * (a step that starts closed folds its shelf into the bar instead, its own start).+ */+async function rewind(run: Run, stage: Stage, step: string, open: boolean) {+ const st = useStore.getState()+ set({ previewItemId: null, previewItemRect: null, expandedStackId: null })+ if (stage.notesImage.getAnimations().length) {+ stage.notesImage.getAnimations().forEach((a) => a.cancel())+ await run.animate(stage.notesImage, [{ opacity: 1 }, { opacity: 0 }], { duration: 400, easing: 'ease' })+ }+ const start = itemsFor(step)+ const same = start.length === st.items.length && start.every((it, i) => it.id === st.items[i].id)+ if (same) {+ await run.sleep(400)+ } else if (!open) {+ set({ open: false })+ await run.sleep(600)+ set({ items: start })+ } else {+ const layer = shelfLayer(stage)+ if (layer) await run.animate(layer, [{ opacity: 1 }, { opacity: 0 }], { duration: 380, easing: 'ease-in' })+ set({ items: start, open: true })+ await run.sleep(120)+ // fill 'none': once faded in, the layer's own class (is-hidden) decides again+ layer?.getAnimations().forEach((a) => a.cancel())+ if (layer) await run.animate(layer, [{ opacity: 0 }, { opacity: 1 }], { duration: 480, easing: 'ease-out', fill: 'none' })+ }+ await run.sleep(700)+}++/**+ * A step's demo plays once and rests on its result; after the viewer has been idle a while it rewinds+ * gently and plays again, for as long as the step is up. Next moves on at any moment.+ */+export async function playLooped(run: Run, stage: Stage, step: string, open: boolean, demo: (run: Run, stage: Stage) => Promise<void>) {+ for (;;) {+ await demo(run, stage)+ await idleFor(run, REPLAY_IDLE)+ await rewind(run, stage, step, open)+ }+}diff --git a/src/styles/onboarding.css b/src/styles/onboarding.cssindex 06853f3..ebc8187 100644--- a/src/styles/onboarding.css+++ b/src/styles/onboarding.css@@ -45,8 +45,9 @@.ob-shelf {position: absolute;inset: 0;- /* scaled from the middle of the top edge (scale set inline: SHELF_SCALE) */+ /* scaled from the middle of the top edge (set inline: shelfTransform), moving with the camera */transform-origin: 50% 0;+ transition: transform 0.9s cubic-bezier(0.3, 0.7, 0.2, 1);/* The layer stands for the screen: what Panel draws past its edges (the copy tab's part behind theedge) is off-screen in the app, so it must not show above the laptop's screen here. */overflow: clip;