Skip to content

Releases

Chorono v0.4.0 — Spline modeling and editor precision

Choose a tag to compare

@codie1982 codie1982 released this 17 Nov 06:45
1e434ca

Chorono v0.4.0 — Spline modeling and editor precision

Released 17 November 2026. Türkçe · Validation and limits · Changelog

Spline modeling

  • Offset creates a separate editable parallel contour. Closed contours use outward/inward; open contours use left/right.
  • Outline creates an equal-distance band. Closed bands use even-odd fill; open bands join both sides with caps.
  • Chamfer trims selected corners and joins them with straight edges.
  • Fillet rounds selected corners with tangent cubic segments and a radius. Two straight edges use the requested circular radius.
  • The Spline Modeling dock panel offers contour and corner selection, distance/direction controls, Preview, Apply and Cancel. Preview stays outside the scene and Undo history. Apply is one Undo step.
  • Offset/Outline add a sibling spline layer without changing the source. Chamfer/Fillet replace the chosen contour and reject animation tracks that address its geometry. Revision and document checks reject stale previews.

Curves are sampled to a 0.25 layer-local pixel tolerance, subject to a subdivision limit. Curved-edge fillets are tangent G1 cubic approximations. Zero-length, collapsed, self-intersecting and overlapping results are rejected. The preview is in the modeling panel.

Scripting and MCP

layer.spline.offsetContour(contourId, distance, direction) and outlineContour(...) return the new layer ID. chamferCorners(contourId, pointIds, distance) and filletCorners(contourId, pointIds, radius) edit the source in one native command. These calls use the same geometry as the panel and are available through the isolated MCP scripting bridge. See the modeling API guide.

The editor also adds Send to Agent on selected layers. It copies a short-lived MCP handoff prompt; the agent reads the current scene and focus through get_handoff_context. Copying does not start a conversation or grant edit authorization. Source mutations still require a fresh get_scene read token and revision.

Editor workflow

  • Snap/Grid controls share one menu, with separate Move, Rotate and Scale settings, parent alignment, a visible grid preference and zoom-adjusted screen hit radius. A follow-up restores 2D move/resize adapters and rotate feedback.
  • Shortcuts opens in a separate window. Motion Keys has a dedicated dock panel, while the existing motion-key data and transport remain in the editor.
  • Project/export access and interactive preview visibility were refined alongside these controls.

Validation and scope

The validation report records unit, CLI, MCP and production build results, browser Offset preview/Apply/Undo, and known limits. Existing editable spline serialization and render/export paths are reused. Portable save/load and cross-format output for the new modeling results did not receive separate visual acceptance in this release.

The earlier reported Point/Edge/Object modes, complete Boolean workflow, topology tool suite, Auto Close and drawing-to-connect behavior are not claimed by this release. Some basic contour/Continue behavior predates it; see the comparison report for the commit-level distinction.

Install this version

Requires Node.js 20+, npm, Git and a modern browser:

git clone --branch v0.4.0 --depth 1 https://github.com/codie1982/chorono-editor.git
cd chorono-editor
npm ci
npm run cli:build
npm run chorono -- setup
npm run chorono -- start --background --open

Connect the browser through MCP → Connect this editor, reload the agent's MCP connection, then run npm run chorono -- doctor. The GitHub release includes a checked CLI tarball; the editor root remains private. This GitHub release does not publish either package to the npm registry.

Chorono v0.3.0 — Animation authoring and safe MCP collaboration

Choose a tag to compare

@codie1982 codie1982 released this 12 Nov 09:04
7305ba8

Chorono v0.3.0 — Editable animation workflows and safer agent collaboration

Released 12 November 2026. Türkçe ·
Validation and limits · Changelog

This release brings the completed pre-3D work into main: refine agent-created
scenes by hand, preserve those edits on subsequent MCP changes, and continue
editing after a page reload. The existing 2D editor remains the active workspace.

Viewport authoring

  • Corrected pivot/anchor transforms, selection feedback and first-drag/pointer
    release handling, including guide dragging and continuously placed shapes.
  • Edit animation paths and position key points in the viewport with Timeline
    synchronization. Existing key identity, easing and unrelated tracks are retained.
  • Alt-drag copies complete selected subtrees and their animation/references.
    Mouse release commits while Alt remains held. Parent/child selections are
    deduplicated and the operation is one undo step.
  • Multi-selection Array supports linear, radial and path placement, preview,
    Apply/Cancel and one-step undo while preserving descendant animation.
  • Editable horizontal/vertical nearest-neighbor gaps, persistent ruler guides,
    guide locking/hiding and off-artboard editing with dashed outlines.
  • Pan controls share a previous-tool toggle (M or H). Viewport buttons retain
    their own pointer events; cursor guides stay out of controls and other panels.
  • Grouped Project/Export actions and contextual spline continuation reduce toolbar
    duplication. Motion Keys appears when a suitable object is selected.

Timeline, hierarchy and procedural motion

  • Shared Scene Explorer/Timeline hierarchy, subtree operations, explicit
    Find in Timeline, and temporary branch isolation without changing source
    visibility or exported scene data.
  • Prominent Set Key with hold/menu channel selection; batch key operations,
    collision-aware editing and expanded frame/key/start/end navigation.
  • Track context actions clear animation with undo. Procedural numeric curves
    can be previewed and baked to editable native keys with sampling/error limits.
  • Fixed topology path/spline point animation remains distinct from topology
    morphing; a registry entry alone is not treated as a new finished object type.

Expressions and input calculations

  • Saved numeric formulas, live expressions for supported typed visual properties
    (number, boolean, string, color and Vec2), named sources and explicit errors.
  • Expression evaluation shares the scene's time/parameter context in the editor
    and supported full-scene Web SDK/render paths.
  • Preview, convert to an authored value, retain the authored fallback, or bake
    supported property expressions into native keys. Discrete values use hold keys.
  • Calculate once evaluates an operation setting without retaining a formula
    or starting a live configuration job. Lifecycle/import settings are not made
    reactive merely because an input supports calculations.

Recovery, collaboration and diagnostics

  • Autosave committed scenes and restore the last local session on reload.
    Session IDs identify local storage, save outputs and session history.
  • Persist bounded Undo/Redo history: up to 50 combined steps and approximately
    64 MiB of estimated source data. Browser recovery is not a substitute for an
    external portable project; storage failures remain visible.
  • MCP 2.1 requires a current get_scene revision and one-use readToken before
    source mutations. A native batch uses one outer authorization; a script dry run
    returns a new plan-bound token. Stale edits fail rather than replacing manual work.
  • Source provenance records creation and latest human/agent field writers,
    including copy inheritance, without embedding actor flags in animation values.
    Missing provenance means unknown and never grants overwrite permission.
  • Improved typed MCP schemas, parameter/result documentation and focused tool
    discovery. Preferred aliases coexist with historical tool names; current
    read/revision guards apply to both.
  • Bounded interaction diagnostics and consent-controlled anonymous summary
    queue, receiver/storage API, version checks and a grouped issue panel with
    New / Investigating / Fixed states and repeat counts. Consent persists;
    delivery is disabled without consent. A public receiver deployment is separate.
  • Refreshed startup demo and contextual Help links to 58 canonical documentation
    targets, reusing the shared control. Production panel/dialog fixtures support
    repeatable documentation captures; the website is maintained separately.

Validation and boundaries

The validation report records fresh merge checks and the
prior native/browser acceptance. The Four Seasons ten-play acceptance remained
within the same 512 MiB managed-resource policy (46.25 MiB observed peak).
Measured CPU times differ from historical v0.2.0 runs; this release does not
claim a general CPU speed improvement or a total browser/OS memory cap.

Final raster output renders source layers, not viewport LOD proxies. Existing
exporters retain their documented limits: resolution scaling is not yet a new
resolution-independent renderer; basic SVG/native runtimes do not support every
live expression/effect. Review exporter warnings or explicitly bake/convert.

Boxed 3D, Poly/UV/Blob, new cloth/fluid/fracture solvers, CFX compositing/tracking
and full Export E0 remain planned. This release does not enable a 3D workspace.

Install this version

Requires Node.js 20+, npm, Git and a modern browser:

git clone --branch v0.3.0 --depth 1 https://github.com/codie1982/chorono-editor.git
cd chorono-editor
npm ci
npm run cli:build
npm run chorono -- setup
npm run chorono -- start --background --open

Connect the browser using MCP → Connect this editor, reload the agent's MCP
connection, then run npm run chorono -- doctor.

The GitHub release includes the checked @codie1982/chorono@0.3.0 CLI tarball,
a validation receipt and SHA-256 checksums. The root editor stays private; this
GitHub publication does not publish either package to the npm registry.

Release verification

  • Main/tag commit: 7305ba8135804f4e6c3d33dc5b60a3356e641b14.
  • Merged PR #10.
  • PR CI passed and main CI passed.
  • Local: 2,995 unit tests, 16 CLI tests, TypeScript, MCP/Next builds and real STDIO discovery passed.
  • Download checksums and detailed scope are included in the attached validation receipt.

Chorono v0.2.0 — Performance and resource management

Choose a tag to compare

@codie1982 codie1982 released this 08 Nov 13:03
53a5691

Chorono v0.2.0 — Large-scene performance and resource management

Released 8 November 2026. Türkçe ·
Validation and limitations · Changelog

Chorono v0.2.0 makes large 2D animation projects use a bounded working set of
rendering surfaces and media resources, improves editing responsiveness, and fixes
missing descendants under Solo parents. It also brings the accumulated scripting,
audio, spline, timeline and onboarding work into main.

Large-scene rendering and editing

  • Scene and track indexes replace repeated full-scene lookups in rendering,
    transform resolution and timeline access.
  • Dependency-safe viewport culling skips offscreen paint while preserving
    masks, effect padding and helper sources required by visible content.
  • Static-group LOD caches bounded viewport proxies for suitable groups. Source
    layers remain editable. Final PNG and image-sequence output renders the original
    full composition rather than the viewport's LOD proxy or visible-area crop.
  • Shared scratch-surface pools reuse mask/effect canvases. Region-of-interest
    rendering reduces temporary backing pixels; unsupported or uncertain bounds use
    conservative rendering instead of silently losing content.
  • Virtualized UI bounds mounted layer, timeline, dope-sheet and asset rows.
    Dense keyframe tracks use compact glyphs while preserving selection, keyboard
    navigation and access to individual source keys.
  • Frame scheduling coalesces obsolete viewport/runtime work and avoids
    accumulating evaluations behind the latest requested frame.

Resources and diagnostics

  • A shared 512 MiB managed-resource policy coordinates participating owners,
    including rendering surfaces, LOD, media preparation, decoded audio, fonts and
    output jobs. Per-owner policies and pin/release lifetimes remain explicit.
  • Bounded queues, cancellation, deadlines and stale-result checks apply across
    preparation, import, encode, save and document replacement flows.
  • Image/video residency follows the current frame's visible dependencies; audio
    uses timeline demand, and fonts/source URLs have dedicated ownership adapters.
    Undo retains serializable source data rather than native DOM/GPU handles.
  • The English Resources & Performance dock reports tracked resources,
    media, CPU/GPU workload, paint/culling/LOD counts, budgets, pending jobs and
    browser-memory estimates with their measurement scope.
  • The viewport shows Last draw … ms · Heap …. It updates after drawing,
    has no idle polling loop, and stays outside exported pixels. FPS would be
    misleading for an on-demand canvas.
  • Paused resource monitors immediately drop cached identities of replaced
    projects, rather than retaining an old scene graph until polling resumes.

Managed bytes and browser heap are different scopes. This policy is not a hard
limit on all browser, decoder, GPU-driver or OS RAM.

Safer import, export and persistence lifetimes

  • Bounded binary/text readers and container validation cover ZIP/dotLottie, GIF,
    SVG/Lottie/scene documents, font input and supported native-media admission.
  • Supported image dimensions and WAV PCM sizes are checked before expensive
    native work. Opaque codecs retain explicitly documented policy estimates.
  • Output ownership covers raster/image sequence ZIP, offline WAV, portable
    projects, JSON/HTML/runtime/SVG, clipboard, MCP replies and file persistence.
  • Buffers and pins live until the actual asynchronous consumer settles. Cancelled
    or stale work does not publish a late result; failed cleanup remains visible.
  • Autosave and version-file writes coalesce pending snapshots with finite queues
    instead of retaining a new dense serialization for every edit.

This release improves the resource safety of existing exporters. The separate
Export E0 project will establish viewport/render-preview/export consistency
fixtures and drive later resolution, color and quality improvements.

Scene Explorer and Timeline fixes

  • Soloing a parent now includes its descendants in both panels, even when that
    parent is not a member of the selected timeline. Hidden/inactive child tracks
    remain editable; explicit panel filters and timeline membership still apply.
  • Expand subtree / Collapse subtree open or close the selected branches,
    including nested groups, without changing scene data.
  • Show subtree / Hide subtree affect selected roots and every descendant in
    one undoable command. Undo restores each child's previous mixed visibility.
  • The four actions are available for a single selected parent, multi-selection
    and the context menu. Overlapping selections are deduplicated.

Animation authoring and usability

  • Expanded scene/layer snapshots and safe patches, spline and particle handles,
    interaction definitions and native audio clip operations in the scripting API.
  • Audio inspector and timeline editing for trim/split, gain/envelopes and clip
    selection, with shared PCM ownership for playback, waveforms and offline output.
  • Spline placement, point editing, transformed bounds, picking and path-trimming
    fixes; timeline cloning, keyframe operations and independent-animation fixes.
  • Refreshed welcome/startup UI, English interface copy and local setup/examples.
  • Maintainer documentation records SOLID responsibilities, module ownership,
    source/cache separation, lifecycle contracts and the current 2D/2.5D roadmap.
  • The current main CI, security reporting and community contribution templates
    are preserved in the release integration.

Validation

The implementation acceptance ran 262 test files / 2,093 tests, typechecking,
MCP/Next builds and a 31-check evidence audit. The original Four Seasons fixture
(4,079 layers, 42,512 keys, 48 seconds) completed ten full plays in 490 seconds:

Measurement Observed result
Managed-resource peak / policy 46.15 / 512 MiB
JavaScript heap peak / guard 107.61 / 768 MiB
Final JavaScript heap 40.33 MiB
Synchronous viewport draw p50 / p95 30.7 / 47.5 ms
Whole-page RAF interval p50 / p95 33.4 / 66.7 ms
Extra canvas registrations per cycle 0

Fifty independently committed UI edits, undo/redo, seeking, panning/zooming and
project close/reopen were checked. Actual scene downloads matched the original
bytes. Final unmount returned managed charges and source references to zero.
Native A/V and LOD PNG/ZIP checks passed within their documented capabilities.

These are measurements of one fixture and environment, not universal FPS or RAM
guarantees. The validation report retains CPU variability,
native-memory limits, bundle scope and the final release checks.

Install this release

Requires Node.js 20+, npm, Git and a modern browser:

git clone --branch v0.2.0 --depth 1 https://github.com/codie1982/chorono-editor.git
cd chorono-editor
npm ci
npm run cli:build
npm run chorono -- setup
npm run chorono -- start --background --open

Choose MCP → Connect this editor in the browser, reload your agent's MCP
connection, then run npm run chorono -- doctor.

The editor package version is 0.2.0; the CLI source remains independently
versioned at @codie1982/chorono@0.2.0. This is a GitHub release. The root editor
stays private, and no npm registry publication is implied.

Planned next

Export E0 is next. Poly/Blob geometry, Voronoi fracture, rigid/cloth/fluid
simulation and bake workflows, character rigging and boxed 3D/2.5D content remain
roadmap items. This release does not introduce a full 3D workspace, game engine,
new simulation solver, complete SDK audio support or a new final-quality renderer.

See the current roadmap and the
documentation index for public contracts and follow-up work.

Published revision and checks

  • Merged through PR #9.
  • Exact main commit: 53a56911ed18f01df3c52d529e17e4893f66c6ea.
  • Main CI passed for this commit; PR CI also passed.
  • Download the tested CLI tarball and verify it using SHA256SUMS.txt; release-validation.json records versions, checks and hashes.

Chorono v0.1.0 — Initial Release

Pre-release

Choose a tag to compare

@codie1982 codie1982 released this 08 Nov 12:21
731c972

Chorono's first GitHub release: an open-source, local-first 2D animation and motion graphics editor. Create editable scenes with Claude Code or Codex through MCP, then refine layers, keyframes, easing and timing in the browser.

Highlights

  • Visual editing for shapes, text, paths and particles, with keyframe animation and multiple timelines.
  • MCP authoring workflow for inspecting scenes, creating animations, previewing frames and saving portable editable projects.
  • Bundled chorono and chorono-setup agent skills.
  • CLI lifecycle commands: setup, start, doctor and stop.
  • Editable example project and English/Turkish installation documentation.

Install this release

Requires Node.js 20+, npm, Git and a modern browser.

git clone --branch v0.1.0 --depth 1 https://github.com/codie1982/chorono-editor.git
cd chorono-editor
npm ci
npm run cli:build
npm run chorono -- setup
npm run chorono -- start --background --open

In the browser, choose MCP → Connect this editor, reload your agent's MCP connection, then run npm run chorono -- doctor.

Release scope and validation

This initial pre-release pins the existing main snapshot at 731c972fcf8d84f3c183a9b127b406fb063b32ee. Ongoing v2 development is not included.

The editor package version is 0.1.0; the bundled CLI source has its own version, 0.2.0. This is a GitHub source release, not an npm publication or a packaged desktop installer.

CI passed for this exact commit: dependency installation, bundled CLI skills build, unit tests, CLI tests, MCP server build and editor production build.