10 Commits

Include renames

Author	SHA1	Message	Date
Miguel Ángel	5975dd7579	feat(studio): the desktop-app button says Install the desktop app and never dead-ends (#5854) ... * feat(studio): the header's desktop-app button says Install the desktop app and never dead-ends The button now reads "Install the desktop app" beside Framey drawn as the app draws it. Where the app is installed, a press opens this project in it; a folder preview serves from a bare index.html gets its hyperframes.json first, so the app no longer refuses it. Without the app, the button links straight to hyperframes.dev's download, and a failed open lands there too. Platforms with no build of the app show no button. Telemetry now records eligibility, one impression, the click and the press outcome, with OS, app installed and download available. * feat(studio): the desktop-app button records eligibility, impression, click and outcome * feat(studio): a desktop-app press carries its page id to the download and the app hand-off * chore(studio): describe Framey's drawing without internal names * feat(studio): the desktop-app button opens a guide that walks download, install and open Without the app, the header button opens a card where Framey walks three steps: the download opens in a new tab, the install is found by asking the preview server while the card is open, and the project opens through the existing hand-off. A failed hand-off shows the folder to copy and Try again. With the app ready the press opens the project directly. Each step change is recorded through trackStudioEvent; a download is never counted as an install. * fix(studio): the desktop-app guide counts one install per page The app removed and found again on the same page recorded install_detected twice; a page latch keeps it to one, as the telemetry contract says.	2026-10-18 17:34:56 -04:00
WaterrrForever	6a27a34f21	feat(cli,studio): hand off on macOS now, and open the app on Windows and Linux (#4999) ... * feat(studio,cli): add an Edit with Framey button and `hyperframes open` for HyperFrames Studio Point people from the CLI and the Studio preview to HyperFrames Studio, the desktop app. - Studio header: an "Edit with Framey" button with Framey, the app's cursor mascot (the eye follows the pointer, a wiggle on hover, honours reduced motion). Until the app opens handed-over projects (HANDOFF_READY), a press shows a "Meet Framey" card with the download. The button shows only where the preview server answers GET /api/open-in-desktop on macOS, so the desktop app's own embedded Studio never shows it. - `hyperframes open [dir]`: hands the project folder to the app with `open -b` (released app, then Canary) and points to the download when neither is installed. When run by Claude Code or Codex it leaves .hyperframes/agent-handoff.json (CLAUDE_CODE_SESSION_ID / CODEX_THREAD_ID) so the app's first chat can pick up that conversation. - render and preview print one line about the app: the download until HANDOFF_READY, then `hyperframes open` when the app is installed. Nothing for a draft render, a batch row, or a run inside the app (HYPERFRAMES_DESKTOP_PROJECT). * fix(studio,cli): gate `hyperframes open` too, guard the open-in-desktop POST, keep one gate Review of #4951 at 58934a34. - One gate: HANDOFF_READY lives only in the CLI. `GET /api/open-in-desktop` now says `handoff`, and Studio's button reads it, so the gate cannot be half-flipped. - While gated nothing opens and nothing is written: `openInDesktop` returns `handoff-unavailable` (so `hyperframes open` prints the download line and the POST route answers with it), and no `.hyperframes/agent-handoff.json` can sit waiting for a later release. - The POST answers only Studio's own same-origin request (loopback Host, matching Origin, Sec-Fetch-Site same-origin); a cross-site or rebound-host POST gets 403. Routes moved to server/desktopRoutes.ts with their own tests. - `hyperframes open`: exits 1 when nothing opened, answers in JSON under --json for a bad directory, and tells a missing app from one macOS could not open (`open-failed`). A project that cannot be written still opens, with nothing handed over. - Tests drive the live path through `ready`, are path-portable for Windows, and cover the draft and batch-row hint skips (`wantsDesktopHint`, `batchRowRenderOptions`). - The load smoke mocks the route. * feat(cli,studio): hand off on macos now, and open the app on windows and linux The released Mac app (b254) takes a handed-over folder and its conversation, so HANDOFF_READY turns on for macOS. Windows and Linux stay on the download until the desktop change that reads a folder from the command line ships. - `hyperframes open` finds the app off macOS: the per-user install on Windows, and on Linux the AppImage the app records in launcher.json; it starts it with the folder - download links follow the machine: the DMG on macOS, the AppImage on Linux, and nothing on Windows, which has no public download yet - the Studio button shows wherever there is a download or an installed app; the card no longer says "for macOS" - every render prints the app line except batch rows: music-to-video delivers a draft - the success line names the app that took the folder (Canary included) * fix(studio): the edit-with-framey button asks its route through studioApiFetch * fix(cli,studio): name the app the hyperframes desktop app, apart from the studio preview * fix(cli,studio): fewer comment lines, so no file's comment share rises	2026-10-04 12:54:17 +00:00
WaterrrForever	bd0dc8c3ae	feat(studio,cli): add an Edit with Framey button and hyperframes open for HyperFrames Studio (#4951) ... * feat(studio,cli): add an Edit with Framey button and `hyperframes open` for HyperFrames Studio Point people from the CLI and the Studio preview to HyperFrames Studio, the desktop app. - Studio header: an "Edit with Framey" button with Framey, the app's cursor mascot (the eye follows the pointer, a wiggle on hover, honours reduced motion). Until the app opens handed-over projects (HANDOFF_READY), a press shows a "Meet Framey" card with the download. The button shows only where the preview server answers GET /api/open-in-desktop on macOS, so the desktop app's own embedded Studio never shows it. - `hyperframes open [dir]`: hands the project folder to the app with `open -b` (released app, then Canary) and points to the download when neither is installed. When run by Claude Code or Codex it leaves .hyperframes/agent-handoff.json (CLAUDE_CODE_SESSION_ID / CODEX_THREAD_ID) so the app's first chat can pick up that conversation. - render and preview print one line about the app: the download until HANDOFF_READY, then `hyperframes open` when the app is installed. Nothing for a draft render, a batch row, or a run inside the app (HYPERFRAMES_DESKTOP_PROJECT). * fix(studio,cli): gate `hyperframes open` too, guard the open-in-desktop POST, keep one gate Review of #4951 at 58934a34. - One gate: HANDOFF_READY lives only in the CLI. `GET /api/open-in-desktop` now says `handoff`, and Studio's button reads it, so the gate cannot be half-flipped. - While gated nothing opens and nothing is written: `openInDesktop` returns `handoff-unavailable` (so `hyperframes open` prints the download line and the POST route answers with it), and no `.hyperframes/agent-handoff.json` can sit waiting for a later release. - The POST answers only Studio's own same-origin request (loopback Host, matching Origin, Sec-Fetch-Site same-origin); a cross-site or rebound-host POST gets 403. Routes moved to server/desktopRoutes.ts with their own tests. - `hyperframes open`: exits 1 when nothing opened, answers in JSON under --json for a bad directory, and tells a missing app from one macOS could not open (`open-failed`). A project that cannot be written still opens, with nothing handed over. - Tests drive the live path through `ready`, are path-portable for Windows, and cover the draft and batch-row hint skips (`wantsDesktopHint`, `batchRowRenderOptions`). - The load smoke mocks the route. * fix(studio): the edit-with-framey button asks its route through studioApiFetch	2026-10-04 10:52:23 +00:00
Miguel Ángel	36f8bd0e91	feat(studio): undo and redo step through the project history, whoever made the change (#4456) ... * feat(studio-server): an undo taken from Studio is not mistaken for an outside edit * feat(studio): undo and redo step through the project history, whoever made the change * feat(studio): the dev server keeps each project history, in the same folder as preview * fix(studio-server): an undo that deletes a file reads as Studio's, and dev histories close * fix(studio-server): a claim keeps an agent's earlier write the agent's and takes back Studio's own * chore: allow the removal of Studio's browser edit history files * test(studio): mock the project history in the runtime smoke * fix(studio): step past a jammed undo and say why a step fails * fix(studio-server): an agent turn cut by a claim commits its part before the claim * fix(studio-server): a claim's cut ends a held drag and takes only the cut files out of a turn * fix(studio-server): a held drag ends when someone else changed a file it already holds	2026-09-25 08:43:04 +00:00
Miguel Ángel	a57e095468	feat(studio): panel tabs take the decided Current design (#4266) ... Studio's panels become cards on a dark shell, and each panel's tabs take the "Current" design: the open tab is a fill in the card's colour that slides to the tab you pick, only the open tab shows its icon and close glyph, and a strip that is too narrow scrolls with a soft edge instead of hiding tabs behind a menu. This replaces the pill, underline and close treatment that was on this PR before. ## Before   ## After   Switching tabs (the fill slides in about 140 ms and the new icon fades in over 80 ms; the panel body switches at once): https://github.com/user-attachments/assets/8d359ada-c9e1-4425-9c95-61d5d4f5271b ### Every label whole, and the tabs use the whole strip (2x) An earlier head clipped the left strip's fourth tab next to empty strip space. That space was a 72 px slot (plus 4 px) held on every strip for the strip actions, even on strips whose panel is not focused and so draws no actions. Dockview sizes that slot by its content; this PR had pinned it. Now the slot takes room only where the actions are drawn, so an unfocused strip gives its tabs the whole width. Tab padding is 6 px with no gap between tabs, so the tabs also fit next to the actions. Labels, icons and close glyphs sit on the tab's centre in every strip. Left strip at 1440 x 900, tabs width against the room before the action slot: | | macOS | Linux (these captures) | |---|---|---| | Earlier head | 322 in 280, clipped | 312 in 280, clipped | | Now, panel unfocused | 278 in 358 | 268 in 358 | | Now, panel focused (actions shown) | 278 in 282 | 268 in 282 |    At 1280 x 800 the left column is narrower, and the pinned slot clipped Catalog next to the empty space. Room for the tabs there went from 241 px to 317 px:   Captured at the PR head (5fd6c7bd) from a fixture project (the `warm-grain` registry example) in headless Chrome on Linux, 2x, each state loaded fresh so Studio builds its default layout for that window. Before is `main`; the strip Befores use the earlier heads' `dock.css` (8079c635 at 1440, 8ed7ab69 at 1280) on the same build. The macOS column was measured live in Chrome on macOS. The paper theme only re-themes the timeline today, so the panels look the same in both themes. ## What changed - **Cards on the shell.** Each dock group is a card with the only 1 px border (radius 10) and a 6 px gutter to its neighbours. The preview and timeline no longer draw a second rounded border inside it; the preview stage is an inset well. Dockview's tab dividers and separators are gone. - **Tabs.** Tabs use the whole strip unless the panel shows its actions. Every label is whole at the default 1440 x 900 layout (6 px side padding, no gap between tabs), and labels and icons are centred in the tab. The open tab is a fill with rounded top corners, flush with the card body. Only the open tab shows its type icon and close glyph (the glyph appears on hover or keyboard focus, and its space is kept so the label never moves). Other tabs are labels. - **One sliding fill per strip.** One element slides (transform and width, 140 ms ease-out) under the open tab. Reduced motion turns the slide and the icon fade off. Hover is instant. - **Strip actions** (panel menu, maximise or restore, close group) sit on the active group only, at half opacity while the pointer is in the panel and full on hover or focus. They take room only on the strip that draws them, so the other strips give their tabs the whole width. The panel menu lists that side's panels as checkboxes, plus Reset layout. - **Narrow strips** scroll sideways with a 12 px fade on the clipped edge. Dockview's overflow dropdown is off. - Tokens: `--panel-shell-bg`, `--panel-card-bg`, `--panel-card-border`, `--panel-strip-bg`, `--panel-tab-bg-hover`, with contrast pairs registered. ## Timeline viewport gate The first head of this rebuild (b20ff32a4) cost the timeline gate one frame on CI: interaction p95 33 ms on every run (first attempt 100 ms on three runs), against main's 20 ms. Main-thread traces were identical; the extra cost was compositing, from a fade mask on every tab strip. Masking only a strip that is actually clipped brought it back: | Head | Interaction p95 per run (ms) | Frame p95 (ms) | Runs passing | |---|---|---|---| | main | 20, 20, 19, 20, 18 | 34 | 5/5 | | b20ff32a4 (rerun) | 33, 33, 33, 33, 33 | 33 | 5/5 | | 41302773 | 18, 20, 19, 20, 17 | 33 | 5/5 | | eefaa839 | 18, 20, 18, 18, 20 | 17 | 5/5 | | af4f2b9b (tab spacing), first attempt | 18, 79, 18, 116, 19 | 100 | 3/5 | | af4f2b9b, rerun | 18, 16, 20, 18, 18 | 33 | 5/5 | | 8ed7ab69 | 17, 16, 19, 24, 20 | 33 | 5/5 | | 6a5edd89 | 33, 33, 33, 33, 33 | 17 | 5/5 | From about 14:30Z `main` itself reads 33 ms on every run (three consecutive `main` CI runs), and CI tests this PR merged with the current `main`, so the 6a5edd89 row matches `main`'s level at that time. The af4f2b9b first attempt had three runs at main's level and two single-run spikes; the same commit's rerun passed 5/5, and the change is tab spacing only. ## Tests Each rule that could regress without anyone noticing has a test, and each test was proved by breaking the code once: | Rule | Test | Break | Result | |---|---|---|---| | Icon and close glyph on the open tab only | `DockTabs.test.tsx` (dock.css applied, computed display) | delete the hide rule | 2 red | | Actions on the active group only | `DockTabs.test.tsx` | drop the active-group check | 1 red | | One fill per strip, following the open tab | `DockTabs.test.tsx` | fill stays at 0 / a second fill | 1 red each | | One border per surface | `dockTabs.contract.test.ts` | add a strip border | 1 red | | Only the slide and icon fade animate | `dockTabs.contract.test.ts` | add a hover transition | 1 red | | Reduced motion turns them off | `dockTabs.contract.test.ts` | remove the reduced-motion rule | 1 red | | Label and icon centred in the tab | `dockTabs.contract.test.ts` | drop the full-height rule | 1 red | | Every tab label whole at 1440 x 900 on each strip while its panel is focused (the least room it gets), with 10 px for macOS's wider system font (CI renders a Linux fallback) | `scripts/studio-runtime-smoke.mjs` (CI "Studio: load smoke", real Chrome) | the "Ca" head's spacing; a spacing that fits on Linux but clips on macOS | red on both ("312px of tabs in 280px", "276px of tabs in 280px"); green on main and this head | | Unfocused strips hold no room for actions they do not draw | `scripts/studio-runtime-smoke.mjs` | pin the action slot at 72 px again | red: "3 inactive dock strips hold width for actions they do not draw" | | The shown tab stays whole when its strip narrows (its panel gains focus and the actions appear), comes back narrower than it was before it was hidden, or when a neighbouring tab closes and it moves | `DockTabs.test.tsx` | ignore each of those changes in turn | 1 red each; checked live at 1280 x 800: clicking into the left panel's body used to leave Catalog 37 px hidden, now it is whole | | A strip the user scrolled by hand stays put when something else in the dock changes, when it widens, and through another panel's maximise and restore | `DockTabs.test.tsx` | reveal on every pass; on any width change; after a hidden spell | red each; checked live: a hand scroll of 20 px is still 20 px after a maximise and restore | Run alone, each exits 0: `DockTabs.test.tsx` 5, `dockTabs.contract.test.ts` 5, `Dock.test.tsx` 14, `dockAccessibility.test.ts` 10, `PreviewPane.test.tsx` 1, `Menu.test.tsx` 10, `scripts/contrastRatchet.test.ts` passing. ## Independent review An adversarial review (separate agent, mandate to refute) at 41302773, eefaa839, 8079c635, af4f2b9b and 8ed7ab69: **no blockers; one major, fixed.** - MAJOR (af4f2b9b), fixed in 8ed7ab69: CI renders Studio's system font stack with a narrower Linux fallback, so the clip check could pass while a Mac clips. The check now keeps 10 px of room for the macOS font, and a spacing that fits on Linux but clips on macOS turns it red. The 8ed7ab69 review asked whether 10 px holds for every strip, not just the left one it was measured on. Measured macOS minus Linux tab width at 1440 x 900: left 10 px, right 6 px, Preview and Timeline 2 px each, so the left strip is the widest gap and 10 px covers all four. - MINOR, left as is: the room check has no unit test of its own; it runs only in a real browser, and the smoke is its test (red on both broken spacings above). - MINOR: a panel cannot be closed from the focused tab itself by keyboard. The keyboard path is focused tab, Tab to "Panel menu", Enter, uncheck the panel (checked live: closes that one panel; checking it again reopens it). The tab's close glyph is not focusable, the same as dockview's stock tab on main, because a tab cannot hold a focusable button. - MINOR: the open tab is 16 px wider than on the design page (the close glyph's space is kept; see For Miguel). - Resolved: a contrast pair cited stale line numbers. ## UX checklist **Job:** someone editing a video moves between panels (Compositions, Assets, Code, Catalog; Design, Layers, Renders, Variables) many times an hour and needs to see which one is open and reach the next without hunting. **One action:** click the tab of the panel you want. | # | Question | Y/N | Evidence | |---|---|---|---| | 1 | First-time user knows what to do | Y | Tabs keep their labels; the open tab is joined to the body it controls (After captures) | | 2 | Interactive things look interactive | N | Strip actions are hidden until the pointer is in the panel (Miguel's decision; see Traded off) | | 3 | User's words, no internal ids | Y | Titles unchanged; controls named "Close Design", "Panel menu", "Maximize panel", "Close group" | | 4 | Works like other tools | Y | Editor-style tabs with maximise and a panel menu | | 5 | Guidance at the control | N | The three icon buttons have accessible names but no visible tooltip | | 6 | Primary action reachable without reading | Y | The tabs are the strip | | 7 | Exactly one primary action | Y | Tabs; actions are secondary and quiet | | 8 | Counts match data | Y | Titles come from each panel through `Dock.Panel` (`Dock.tsx` setTitle) | | 9 | Excluded items announce themselves | Y | Every label is whole at the default width (the load smoke checks it); a narrowed strip scrolls with an edge fade, and the panel menu lists every panel | | 10 | Long names recoverable | Y | Tabs never truncate; the strip scrolls | | 11 | Keyboard path | Y | Arrow keys move and activate tabs (existing); strip actions are buttons and show on focus | | 12 | Nothing hover-only that must be acted on | N | Same as 2 | | 13 | Refusals say what next | n/a | No refusals here | | 14 | Refusal next to the thing | n/a | | | 15 | Error prevented | n/a | | | 16 | Can leave any state without losing work | Y | Closed panels reopen from Window or the panel menu; Reset layout restores the default | | 17 | Destructive looks different | N | "Close group" uses the same x as a tab's close; it loses no work, and the Window menu reopens the panels | | 18 | Empty state names what is empty | n/a | | | 19 | Feedback within 400 ms | Y | The tab state and icon change in the same frame as the click; the fill arrives in 140 ms | | 20 | Progress on waits | n/a | | | 21 | Hand-built state survives reload | Y | Layout, open tab and maximised group persist per project (existing dock persistence) | **Choice:** four tabs per side, one click each. **The end:** the panel body appears at once and the fill settles under the tab you picked. **Not exercised:** a screen reader pass; touch input. **Traded off:** hover-only strip actions (rows 2 and 12) and scroll-plus-fade instead of an overflow menu when a strip is narrowed are Miguel's decided design. ## For Miguel - **Paper (light) theme:** Studio's paper block only re-themes the timeline today, so the panels are dark in both the Before and After paper shots. Panel paper values are Desktop's to set (design principles, section 7); this PR adds the token names Desktop can override. - **Action slot:** the design review asked for the action slot to be reserved on every strip, so tabs never move when focus changes panel. That reservation is what clipped "Ca" next to empty space, so it now holds room only on the focused panel. The cost: when a strip that is already too narrow gains focus, its actions take 76 px. The strip then scrolls so the shown tab stays whole, and a neighbouring tab can go under the edge fade. At the default 1440 x 900 nothing clips either way. - **Tab spacing:** side padding is 6 px (10 on the design page) and tabs have no gap. The design's 10 px would need 322 px on macOS; the left strip has 282 px beside its actions at 1440. A wider default left column would allow the design padding again. A narrower window scrolls the strip with the edge fade; per the decision there is no overflow chevron. - **Close glyph space:** the open tab keeps its close glyph's space at rest, so it is 16 px wider than on the design page, where the label shifts on hover. - **Not in this PR:** inspector section headers and the focused-card border step (later build steps).	2026-09-23 14:34:10 -04:00
Miguel Ángel	a25da94b77	refactor(studio): remove the storyboard view and its Storyboard/Preview switch (#4140) ... * refactor(studio): remove the storyboard view and its Storyboard/Preview switch * refactor(studio): fold the thumbnail output branches left after the storyboard mode went * docs(studio): drop leftover storyboard references after the view was removed * ci: allow the storyboard view deletions in the no-deletions guard * docs(studio): wrap an over-long comment line in the caption overlay helper * style(studio): reindent App.tsx after the view-mode wrapper was removed	2026-09-18 23:47:12 -04:00
Miguel Ángel	5058236eda	feat(studio): prompt to install FFmpeg before Export, not after (#3314) ... Exporting without FFmpeg installed used to show "Server error (503). Check the terminal for details." The server already knew the exact cause and sent a per-platform install command in the response body; Studio discarded that body and printed the status code. The user found out only after the composition was finished. Studio now asks the dev server on load whether this machine can encode, and the Renders panel shows the cause plus a copyable install command when it cannot, with a Recheck that avoids restarting Studio. - New GET /api/environment/ffmpeg calls runEnvironmentChecks() with every optional check off, which is exactly the FFmpeg and ffprobe pair `doctor` runs, so Studio and the CLI cannot disagree. Only a passing result is cached. - The refusal lives in startRender, not in a button. Studio renders from three places (the panel's Export, the header's, and each composition card in the sidebar), so a per-button check would leave the others free to queue a render that cannot finish. The header and sidebar controls reveal the prompt rather than going dead. - A null probe result means "no answer", not "missing", so an older or unreachable dev server cannot lock a working setup. - Failed render responses now surface the server's { error, hint }. - getFFmpegInstallCommand() is the single owner of platform-to-command, with the prose hint derived from it. Windows gains a winget command and keeps the manual download route. Accessibility: the prompt's explanatory line measured 2.2:1 on the card's amber background against a 4.5:1 minimum, because the panel's usual grey for secondary text does not survive the tint. Now 6.6:1. Keyboard focus was invisible on all three controls and now matches the panel's focus ring. Also folds in cleanups the repo's gates required: the Renders tab moves out of StudioRightPanel (it was at the 600-line cap and every field it needed was already on the shell context), StudioContextInput stops keeping a second copy of the renderQueue shape, and the server tests share one temp-project helper.	2026-08-17 21:00:27 -04:00
ukimsanov	3af9a7df2d	refactor(studio): reuse player probe errors	2026-07-27 22:35:09 -07:00
ukimsanov	0faeb42f86	test(studio): mock composition thumbnails in smoke	2026-07-27 22:25:27 -07:00
James	83db364f81	test(repo): enforce workspace contracts	2026-07-11 21:57:45 -07:00