# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
While the version is in the `0.x` range, any release MAY contain breaking
changes; the minor version is bumped for each one. See
[CONTRIBUTING.md](CONTRIBUTING.md) for the full policy.
## [Unreleased]
## [0.1.0-beta.6] - 2026-06-16
### Changed
- `Columns` zone wrapper now declares a `@container` query context (both
storefront and editor-canvas variants). Consumer components that use
Tailwind container-query utilities (`@sm:*`, `@lg:*`, etc.) inside a
Columns zone are now sized against the column's width rather than the
nearest outer `@container` ancestor (typically `<body>`). Non-breaking:
components rendered outside Columns are unaffected; components that
don't use container queries are unaffected.
## [0.1.0-beta.5] - 2026-06-14
### Added
- Drag-and-drop insertion-line indicator inside `AthanorDropZone`. On
`dragover` the zone gets a dashed primary outline + tinted background,
and a horizontal primary line (with dot endcaps) is positioned at the
cursor's computed insertion point between sibling drop-items. Empty
zones show only the outline/tint. Hook self-injects the required
styles into `document.head` so consumers need no additional CSS.
## [0.1.0-beta.3] - 2026-06-05
### Added
- Built-in `:asset` field type — a host-agnostic picker for uploaded
assets (image / pdf / video / anything). Ships a paste-a-URL default
and emits a fixed `"athanor_asset_request"` event the host fulfils;
Athanor never performs or names an upload. Field opts: `accept:`
(opaque hint, forwarded), `multiple:` (gallery / multi-file),
`min:` / `max:` (forwarded, host-enforced). Value is an asset
descriptor map `%{"url" => ..., "name" => ..., "content_type" => ...}`
(single) or a list of them (`multiple: true`); opaque extra keys are
preserved. Single-value paste-URL participates in the existing
`update_props` form; gallery items get add / remove chrome and an
`athanor_asset_remove` handler.
- `Athanor.Editor.AssetRequest` struct describing a pending request
(`node_id`, `key`, `accept`, `multiple`, `min`, `max`, `current`).
- `c:Athanor.Editor.handle_asset_request/2` — optional host callback,
invoked when an `:asset` field is activated. Default is a no-op (the
field degrades to paste-a-URL).
- `c:Athanor.Editor.render_outlet/1` — optional, general consumer render
outlet fed into the shell's `:modals` layer. Host mounts arbitrary
fixed/offscreen chrome (asset picker, drawer, toast) here. Overridable
alongside `render_header/1` and `render_top_bar_actions/1`.
- Editor pending-request lifecycle: `Athanor.Editor.State.asset_request`
tracks the open picker; cleared on the matching write-back (only when
the pending key's value changes), on `"athanor_asset_cancel"` (event
or `:athanor_asset_cancel` message), and on
select / close-config / remove navigation.
## [0.1.0-beta.2] - 2026-06-03
### Added
- Drag-and-drop in the page-builder editor. Drag from the components
palette onto the canvas, reorder canvas items, drag children in and
out of `Columns` zones. Server side: new `Athanor.Tree.move_to/4`
helper and `athanor:dnd_drop` event handled by `Athanor.Editor.Live`.
Client side: `AthanorHooks` exported from `assets/js/athanor.js`
with two hooks (`AthanorDragSource`, `AthanorDropZone`) — wire into
your `LiveSocket` `hooks:`. Native HTML5 DnD, no JS deps.
- `package.json` + `assets/js/` shipped in the Hex tarball so consumers
can `import "athanor"` directly through esbuild module resolution.
## [0.1.0-beta.1] - 2026-06-02
First public beta. API may shift before `0.1.0` based on early
feedback. Pin tightly (`{:athanor, "== 0.1.0-beta.1"}`) if integrating
during the beta window.
### Added
- `Athanor.Tree` — pure-data manipulation of the editor content tree
(insert, remove, move, find, with `String.t()`-keyed node ids and
child-zone slots).
- `Athanor.Component` — behaviour + `use Athanor.Component` macro for
declaring page-builder components. Optional callbacks: `metadata/0`,
`default_props/0`, `required_props/0`, `validate/1`, `fields/0`,
`resolve_fields/2`, `resolve_data/2`, `render/3`, `editor_form/0`,
`child_zones/1`. Inspired by Puck.js's dynamic fields + data hooks.
- `Athanor.Registry` — runtime lookup of component modules by `type`
string, sourced from `config :athanor, :components`.
- `Athanor.Ctx` — render/edit context struct carrying `account_id`,
`brand_id`, `edit_mode?`, callbacks, and a freeform `:extra` map.
- `Athanor.Renderer` — dispatches each node in the tree to its
component's `render/3` and wraps the result in edit chrome when
`ctx.edit_mode?`.
- `Athanor.Fields` — auto-renders a component's field schema (text,
textarea, number, select, color, checkbox, custom) into HTML form
inputs. Custom fields delegate to consumer-provided LiveComponents.
- `Athanor.Field` — behaviour-style contract for custom field
LiveComponents (value/on_change/ctx/label/opts assigns).
- `Athanor.AutoEditorForm` — LiveComponent wrapping `Athanor.Fields`
with the form/state plumbing (phx-change, custom field callbacks).
- `Athanor.Editor` — function components (`canvas`, `components_panel`,
`config_panel`, `zone_picker_modal`, `shell`) for composing custom
editor layouts, plus a `@behaviour` for the consumer LiveView.
- `Athanor.Editor.Live` — turn-key `use` macro injecting `mount/3`,
`render/1`, `handle_event/3`, `handle_info/2`. Consumer implements
`load/3` and `save/2`; optional overrides for `render_header/1` and
`render_top_bar_actions/1`.
- `Athanor.Editor.State` — typed struct for editor state (content,
metadata, ctx, selected_component_id, preview_viewport,
show_components_panel, column_picker, open_sections).
- Built-in primitive components: `Athanor.Components.Button`,
`Athanor.Components.Columns`, `Athanor.Components.Divider`,
`Athanor.Components.Heading`, `Athanor.Components.Text`.
- `Athanor.Components.Formatting` + `Athanor.Components.Formatting.EditorForm`
— shared formatting tab (alignment / colors / padding / margin /
borders) reused across every component's config panel. Color swatches
ship with a Clear button (pure client-side, no JS hooks).
- Page settings as a regular `Athanor.Component`: consumers pass any
Athanor.Component module as the `:page_settings_component` opt and
the library auto-renders its `fields/0` at the top of the sidebar.
[Unreleased]: https://github.com/Arsenalist/athanor/compare/v0.1.0-beta.3...HEAD
[0.1.0-beta.3]: https://github.com/Arsenalist/athanor/releases/tag/v0.1.0-beta.3
[0.1.0-beta.2]: https://github.com/Arsenalist/athanor/releases/tag/v0.1.0-beta.2
[0.1.0-beta.1]: https://github.com/Arsenalist/athanor/releases/tag/v0.1.0-beta.1