Athanor.Editor.AssetRequest (Athanor v0.1.0-beta.5)

Describes a request for an asset, emitted by an :asset field and routed to the host's Athanor.Editor.handle_asset_request/2.

Athanor builds this struct and hands it to the host; it never performs the upload or browse itself. The host reads the declaration (accept, multiple, min, max) and current value to open whatever picker it wants, then writes the result back via the existing {:update_component_props, node_id, props} channel.

Passing a struct (rather than positional args) lets the contract grow new fields without changing the callback arity.

Fields

:node_id — id of the node whose prop is being set (required). The reserved id "page-settings" targets the page-settings form.
:key — the field key within that node's props (required).
:accept — opaque accept hint forwarded from the field declaration (e.g. "image/*" or [".pdf"]). Athanor does not enforce it.
:multiple — true when the field collects a list of assets.
:min / :max — cardinality bounds forwarded to the host (host-enforced).
:current — the current value of the prop, so the host can choose to add to a gallery vs replace. A descriptor map, a list of descriptors, or nil.

Summary

Types

descriptor()

t()

Types

descriptor()

@type descriptor() :: %{required(String.t()) => any()}

t()

@type t() :: %Athanor.Editor.AssetRequest{
  accept: String.t() | [String.t()] | nil,
  current: descriptor() | [descriptor()] | nil,
  key: String.t(),
  max: non_neg_integer() | nil,
  min: non_neg_integer() | nil,
  multiple: boolean() | nil,
  node_id: String.t()
}