Dala.Plugin.Component (dala v0.1.1)

Represents a single component schema within a plugin.

Contains all metadata needed for code generation, validation, and runtime dispatch. This is the core of the schema-first architecture.

Summary

Types

event()

lifecycle_event()

prop()

t()

Functions

add_capability(component, capability)

Adds a capability to the component schema.

add_event(component, name, opts \\ [])

Adds an event to the component schema.

add_native(component, platform, class_name)

Adds a native platform mapping to the component schema.

add_optional_capability(component, capability)

Adds an optional capability to the component schema.

add_prop(component, name, type, opts \\ [])

Adds a property to the component schema.

Types

event()

@type event() :: %{
  name: Dala.Plugin.event_name(),
  payload: map(),
  doc: String.t() | nil
}

lifecycle_event()

@type lifecycle_event() :: :create | :update | :layout | :event | :dispose

prop()

@type prop() :: %{
  name: Dala.Plugin.prop_name(),
  type: Dala.Plugin.prop_type(),
  required: boolean(),
  default: term(),
  doc: String.t() | nil
}

t()

@type t() :: %Dala.Plugin.Component{
  capabilities: [Dala.Plugin.capability()],
  doc: String.t() | nil,
  event_structs: %{required(atom()) => module()},
  events: [event()],
  lifecycle: [lifecycle_event()],
  metadata: map(),
  name: Dala.Plugin.component_name(),
  natives: %{required(String.t()) => String.t()},
  optional_capabilities: [atom()],
  plugin: Dala.Plugin.plugin_name(),
  props: [prop()]
}

Functions

add_capability(component, capability)

Adds a capability to the component schema.

add_event(component, name, opts \\ [])

Adds an event to the component schema.

add_native(component, platform, class_name)

Adds a native platform mapping to the component schema.

add_optional_capability(component, capability)

Adds an optional capability to the component schema.

Optional capabilities enhance the component but are not required for basic functionality.

add_prop(component, name, type, opts \\ [])

Adds a property to the component schema.