Bento, the office suite that fits in a file
TypeScript mit-licenseofficeoffice-365office-suiteoffice-toolsoffice365open-sourcepowerpointself-hostedsingle-page-appslidesslideshareslideshowslideshow-galleryslideshow-makerslideshows
Visual motion-path editor: on-canvas anchors, smoothing, live preview
nyblnet5275e5bbd893
diff --git a/CLAUDE.md b/CLAUDE.mdindex 716cbf24..86db0421 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -17,7 +17,10 @@ One HTML file = the document + viewer + editor. See `README.md` for the vision.`order` = simultaneous, countUp, ken-burns, `loop` dash-march/motion-path), `link`(click → slide id) and `group`; slides can set `hover:'focus-group'` (dim othergroups). Present arrows are handled capture-phase (focus-proof). Editing UI for- fx/link lives in the panel's "Presenting" section.+ fx/link lives in the panel's "Presenting" section. Motion-path loops are edited+ visually on canvas (`editor/patheditor.ts`): draggable anchors auto-smoothed+ Catmull-Rom→cubic bezier; the stored path is RELATIVE to the element's rest+ position (first anchor = rest position; committing moves the element there).- **Diagram philosophy**: complex diagrams are ordinary Bento elements (rects, texts,`path` shapes) with groups — interactivity = linked state slides + morph (filters,era sequences), hover = focus-group, motion = fx.loop. Opaque `svg` elements arediff --git a/slides/src/editor/canvas.ts b/slides/src/editor/canvas.tsindex 1641f741..949ca1b1 100644--- a/slides/src/editor/canvas.ts+++ b/slides/src/editor/canvas.ts@@ -7,6 +7,7 @@ import Selecto from 'selecto'import type { Store } from '../store'import type { SlideElement } from '../model'import { renderSlide, sanitizeHtml } from '../render'+import { PathEditor } from './patheditor'export class SlideCanvas {private stage: HTMLElement@@ -21,6 +22,7 @@ export class SlideCanvas {private zoom = 1private zoomLabel: HTMLElement | null = nullprivate editing: HTMLElement | null = null+ private pathEditor!: PathEditorconstructor(private wrap: HTMLElement,@@ -75,6 +77,12 @@ export class SlideCanvas {this.wireMoveable()this.wireSelecto()+ this.pathEditor = new PathEditor(this.scaleHost, store, () => this.syncTargets())+ this.pathEditor.setScaleGetter(() => this.scale)+ document.addEventListener('bento:edit-path', ((ev: CustomEvent) => {+ this.startPathEdit(ev.detail.id)+ }) as EventListener)+this.stage.addEventListener('dblclick', (ev) => {const el = (ev.target as HTMLElement).closest<HTMLElement>('.bento-el-text')if (el) this.startTextEdit(el)@@ -142,8 +150,30 @@ export class SlideCanvas {this.wrap.appendChild(bar)}+ // --- motion-path editing ----------------------------------------------------++ get isPathEditing() {+ return this.pathEditor.active+ }++ startPathEdit(elId: string) {+ this.commitTextEdit()+ this.pathEditor.start(elId)+ this.syncTargets()+ }++ /** finish path editing; commit=false discards the changes */+ stopPathEdit(commit = true) {+ if (commit) this.pathEditor.commit()+ else {+ this.pathEditor.cancel()+ this.syncTargets()+ }+ }+render() {this.commitTextEdit()+ if (this.pathEditor?.active) this.pathEditor.cancel() // doc changed under usconst slide = this.store.slideconst next = renderSlide(slide, this.store.doc)// hover-reveal slides: preview one set at a time; hidden sets are@@ -204,7 +234,7 @@ export class SlideCanvas {}private syncTargets() {- const targets = this.editing ? [] : this.selectedNodes()+ const targets = this.editing || this.pathEditor?.active ? [] : this.selectedNodes()// snap against slide bounds/center and every non-selected elementconst others = this.surface? [this.surface, ...Array.from(this.surface.querySelectorAll<HTMLElement>('.bento-el'))].filter(@@ -294,6 +324,10 @@ export class SlideCanvas {private wireSelecto() {this.selecto.on('dragStart', (e) => {const target = e.inputEvent.target as HTMLElement+ if (this.pathEditor?.active) {+ e.stop() // the path overlay owns the pointer while editing+ return+ }if (this.editing) {// clicking outside the text being edited commits it; inside, do nothingif (!this.editing.contains(target)) this.commitTextEdit()diff --git a/slides/src/editor/editor.ts b/slides/src/editor/editor.tsindex c8e5c8ed..c6c5250d 100644--- a/slides/src/editor/editor.ts+++ b/slides/src/editor/editor.ts@@ -461,7 +461,8 @@ export class Editor {return}if (ev.key === 'Escape') {- this.store.select([])+ if (this.canvas.isPathEditing) this.canvas.stopPathEdit(true)+ else this.store.select([])return}if (ev.key === 'PageDown') {diff --git a/slides/src/editor/panels.ts b/slides/src/editor/panels.tsindex e0e5c5f6..da481e3b 100644--- a/slides/src/editor/panels.ts+++ b/slides/src/editor/panels.ts@@ -221,6 +221,14 @@ export class PropsPanel {path.addEventListener('change', () =>this.mutate(el.id, (e) => { if (e.fx?.loop?.type === 'motion-path') e.fx.loop.path = path.value }, true))this.row('Path', path)++ const editPath = document.createElement('button')+ editPath.className = 'ed-btn ed-btn-block'+ editPath.textContent = '✎ Edit path on canvas'+ editPath.title = 'Drag anchor points on the slide; double-click adds and removes points'+ editPath.addEventListener('click', () =>+ document.dispatchEvent(new CustomEvent('bento:edit-path', { detail: { id: el.id } })))+ this.host.appendChild(editPath)}}diff --git a/slides/src/editor/patheditor.ts b/slides/src/editor/patheditor.tsnew file mode 100644index 00000000..88c250dd--- /dev/null+++ b/slides/src/editor/patheditor.ts@@ -0,0 +1,276 @@+// Visual motion-path editing. The path of an fx.loop 'motion-path' is edited+// as draggable anchor points on the canvas; segments are auto-smoothed+// (Catmull-Rom → cubic bezier) so authors never manage control handles.+// A preview dot runs the loop live while editing.+//+// Model contract: the stored path is RELATIVE to the element's rest position+// (first point 0,0 — the element translates along it). The editor shows it+// anchored at the element's centre; dragging the first anchor moves the+// element itself.++import { gsap } from 'gsap'+import { MotionPathPlugin } from 'gsap/MotionPathPlugin'+import type { Store } from '../store'++gsap.registerPlugin(MotionPathPlugin)++const SVG_NS = 'http://www.w3.org/2000/svg'++type Pt = { x: number; y: number }++/** Anchor points out of a path string: the M point plus each segment end. */+export function parseAnchors(d: string): Pt[] {+ const tokens = d.match(/[A-Za-z]|-?\d*\.?\d+(?:e-?\d+)?/g) ?? []+ const pts: Pt[] = []+ let i = 0+ let cmd = ''+ const arity: Record<string, number> = { M: 2, L: 2, T: 2, Q: 4, S: 4, C: 6 }+ while (i < tokens.length) {+ const t = tokens[i]+ if (/^[A-Za-z]$/.test(t)) {+ cmd = t.toUpperCase()+ i+++ continue+ }+ const n = arity[cmd] ?? 2+ const nums = tokens.slice(i, i + n).map(Number)+ if (nums.length === n && nums.every((v) => !Number.isNaN(v))) {+ pts.push({ x: nums[n - 2], y: nums[n - 1] })+ }+ i += n+ }+ return pts+}++/** Smooth path through anchors (Catmull-Rom converted to cubic beziers). */+export function anchorsToPath(pts: Pt[]): string {+ if (!pts.length) return ''+ if (pts.length === 1) return `M ${r(pts[0].x)} ${r(pts[0].y)}`+ const P = (i: number) => pts[Math.max(0, Math.min(pts.length - 1, i))]+ let d = `M ${r(pts[0].x)} ${r(pts[0].y)}`+ for (let i = 0; i < pts.length - 1; i++) {+ const c1x = P(i).x + (P(i + 1).x - P(i - 1).x) / 6+ const c1y = P(i).y + (P(i + 1).y - P(i - 1).y) / 6+ const c2x = P(i + 1).x - (P(i + 2).x - P(i).x) / 6+ const c2y = P(i + 1).y - (P(i + 2).y - P(i).y) / 6+ d += ` C ${r(c1x)} ${r(c1y)} ${r(c2x)} ${r(c2y)} ${r(P(i + 1).x)} ${r(P(i + 1).y)}`+ }+ return d+}++const r = (v: number) => Math.round(v * 100) / 100++export class PathEditor {+ private overlay: SVGSVGElement | null = null+ private hint: HTMLElement | null = null+ private pts: Pt[] = []+ private elId = ''+ private scale = () => 1++ constructor(+ private scaleHost: HTMLElement,+ private store: Store,+ private onExit: () => void,+ ) {}++ get active() {+ return !!this.overlay+ }++ setScaleGetter(fn: () => number) {+ this.scale = fn+ }++ start(elId: string) {+ this.cancel()+ const el = this.store.element(elId)+ if (!el || el.fx?.loop?.type !== 'motion-path') return+ this.elId = elId+ const cx = el.x + el.w / 2+ const cy = el.y + el.h / 2+ const rel = parseAnchors(el.fx.loop.path)+ this.pts = rel.length+ ? rel.map((p) => ({ x: p.x + cx, y: p.y + cy }))+ : [{ x: cx, y: cy }, { x: cx + 160, y: cy }]+ if (this.pts.length === 1) this.pts.push({ x: cx + 160, y: cy })++ const svg = document.createElementNS(SVG_NS, 'svg')+ svg.classList.add('ed-pathedit')+ const { width, height } = this.store.doc.size+ svg.setAttribute('viewBox', `0 0 ${width} ${height}`)+ svg.style.cssText = `position:absolute;left:0;top:0;width:${width}px;height:${height}px;overflow:visible;z-index:50`+ svg.addEventListener('dblclick', (ev) => this.onDblClick(ev))+ this.scaleHost.appendChild(svg)+ this.overlay = svg++ this.hint = document.createElement('div')+ this.hint.className = 'ed-setbar ed-pathbar'+ this.hint.innerHTML =+ '<span class="ed-setbar-label">Motion path — drag points · double-click path to insert · double-click point to remove · double-click canvas to append</span>'+ const done = document.createElement('button')+ done.className = 'ed-setchip active'+ done.textContent = 'Done'+ done.addEventListener('click', () => this.commit())+ this.hint.appendChild(done)+ this.scaleHost.closest('.ed-canvas-wrap')?.appendChild(this.hint)++ this.draw()+ }++ /** Persist: element rest position ← first anchor; path stored relative. */+ commit() {+ if (!this.overlay) return+ const el = this.store.element(this.elId)+ const pts = this.pts+ this.cancel()+ if (!el || el.fx?.loop?.type !== 'motion-path' || pts.length < 2) return+ const p0 = pts[0]+ const relPath = anchorsToPath(pts.map((p) => ({ x: p.x - p0.x, y: p.y - p0.y })))+ this.store.commit(() => {+ const live = this.store.element(el.id)+ if (!live || live.fx?.loop?.type !== 'motion-path') return+ live.fx.loop.path = relPath+ live.x = r(p0.x - live.w / 2)+ live.y = r(p0.y - live.h / 2)+ })+ this.onExit()+ }++ cancel() {+ if (!this.overlay) return+ gsap.killTweensOf(this.overlay.querySelectorAll('*'))+ this.overlay.remove()+ this.overlay = null+ this.hint?.remove()+ this.hint = null+ }++ // --- rendering -------------------------------------------------------------++ private draw() {+ const svg = this.overlay+ if (!svg) return+ gsap.killTweensOf(svg.querySelectorAll('.ed-pe-dot'))+ svg.innerHTML = ''+ const k = 1 / this.scale()+ const d = anchorsToPath(this.pts)++ const mk = (tag: string) => document.createElementNS(SVG_NS, tag)+ // wide invisible hit area for inserting on the curve+ const hit = mk('path')+ hit.setAttribute('d', d)+ hit.setAttribute('fill', 'none')+ hit.setAttribute('stroke', 'transparent')+ hit.setAttribute('stroke-width', String(16 * k))+ hit.classList.add('ed-pe-hit')+ svg.appendChild(hit)++ const line = mk('path')+ line.setAttribute('d', d)+ line.setAttribute('fill', 'none')+ line.setAttribute('stroke', '#5b8def')+ line.setAttribute('stroke-width', String(2 * k))+ line.setAttribute('stroke-dasharray', `${6 * k} ${5 * k}`)+ line.style.pointerEvents = 'none'+ svg.appendChild(line)++ this.pts.forEach((p, i) => {+ const dot = mk('circle')+ dot.setAttribute('cx', String(p.x))+ dot.setAttribute('cy', String(p.y))+ dot.setAttribute('r', String((i === 0 ? 8 : 6.5) * k))+ dot.setAttribute('fill', i === 0 ? '#f7a600' : '#fff')+ dot.setAttribute('stroke', '#31445c')+ dot.setAttribute('stroke-width', String(1.6 * k))+ dot.classList.add('ed-pe-anchor')+ dot.dataset.idx = String(i)+ if (i === 0)++ dot.append(Object.assign(mk('title'), { textContent: 'Start — also the element’s rest position' }))+ dot.addEventListener('mousedown', (ev) => this.dragAnchor(ev, i))+ svg.appendChild(dot)+ })++ // live preview: a dot loops the path at the element's configured speed+ const el = this.store.element(this.elId)+ const dur = (el?.fx?.loop as any)?.duration ?? 3+ const preview = mk('circle')+ preview.setAttribute('r', String(4.5 * k))+ preview.setAttribute('fill', '#f7a600')+ preview.style.pointerEvents = 'none'+ preview.classList.add('ed-pe-dot')+ svg.appendChild(preview)+ gsap.to(preview, { motionPath: { path: d }, duration: Math.max(dur, 0.5), ease: 'none', repeat: -1 })+ }++ // --- interaction ------------------------------------------------------------++ private toSlide(ev: MouseEvent): Pt {+ const rect = this.scaleHost.getBoundingClientRect()+ const s = this.scale()+ return { x: (ev.clientX - rect.left) / s, y: (ev.clientY - rect.top) / s }+ }++ private dragAnchor(down: MouseEvent, idx: number) {+ down.stopPropagation()+ down.preventDefault()+ const startPt = this.toSlide(down)+ const orig = { ...this.pts[idx] }+ let lastTs = 0+ const move = (ev: MouseEvent) => {+ const p = this.toSlide(ev)+ this.pts[idx] = { x: orig.x + p.x - startPt.x, y: orig.y + p.y - startPt.y }+ // first anchor = element rest position: give live feedback on the node+ if (idx === 0) {+ const el = this.store.element(this.elId)+ const node = this.scaleHost.querySelector<HTMLElement>(`[data-el-id="${CSS.escape(this.elId)}"]`)+ if (el && node) {+ node.style.left = `${this.pts[0].x - el.w / 2}px`+ node.style.top = `${this.pts[0].y - el.h / 2}px`+ }+ }+ if (ev.timeStamp - lastTs > 30) {+ lastTs = ev.timeStamp+ this.draw()+ }+ }+ const up = () => {+ window.removeEventListener('mousemove', move)+ window.removeEventListener('mouseup', up)+ this.draw()+ }+ window.addEventListener('mousemove', move)+ window.addEventListener('mouseup', up)+ }++ private onDblClick(ev: MouseEvent) {+ ev.preventDefault()+ ev.stopPropagation()+ const target = ev.target as Element+ const p = this.toSlide(ev)+ if (target.classList.contains('ed-pe-anchor')) {+ // remove (keep at least two)+ const idx = Number((target as SVGElement).dataset.idx)+ if (this.pts.length > 2) this.pts.splice(idx, 1)+ this.draw()+ return+ }+ if (target.classList.contains('ed-pe-hit')) {+ // insert into the nearest segment+ let best = 0+ let bestDist = Infinity+ for (let i = 0; i < this.pts.length - 1; i++) {+ const mx = (this.pts[i].x + this.pts[i + 1].x) / 2+ const my = (this.pts[i].y + this.pts[i + 1].y) / 2+ const dist = Math.hypot(p.x - mx, p.y - my)+ if (dist < bestDist) { bestDist = dist; best = i }+ }+ this.pts.splice(best + 1, 0, p)+ this.draw()+ return+ }+ // empty canvas: append to the end+ this.pts.push(p)+ this.draw()+ }+}