Minga.Extensions.ThemePacks (Minga v0.1.0)

Copy Markdown View Source

Starts bundled theme packs and registers their palettes through extension-owned sources.

Bundled packs use the same Minga.Config.ThemeRegistry.register_themes/2 path as third-party theme packs. Each palette module provides a theme/0 function returning a complete theme struct. Stopping or reloading a pack removes all its themes from the registry without affecting other packs' themes or user-loaded themes.

Summary

Types

A module that implements the theme-pack extension callbacks.

Runtime state for the bundled pack starter.

Functions

Returns a specification to start this module under a supervisor.

Returns bundled theme pack modules in startup order.

Registers all themes owned by a pack, replacing stale entries from an earlier load.

Reloads a pack by removing its previous source-owned entries, then registering its current modules.

Returns the contribution source used for a pack.

Starts the bundled theme pack loader.

Unregisters all themes owned by a pack.

Types

pack_module()

@type pack_module() :: module()

A module that implements the theme-pack extension callbacks.

state()

@type state() :: %{loaded: [atom()], failed: [{atom(), term()}]}

Runtime state for the bundled pack starter.

Functions

child_spec(arg)

Returns a specification to start this module under a supervisor.

See Supervisor.

packs()

@spec packs() :: [pack_module()]

Returns bundled theme pack modules in startup order.

register_pack(pack_module)

@spec register_pack(pack_module()) :: :ok | {:error, term()}

Registers all themes owned by a pack, replacing stale entries from an earlier load.

reload_pack(pack_module)

@spec reload_pack(pack_module()) :: :ok | {:error, term()}

Reloads a pack by removing its previous source-owned entries, then registering its current modules.

source_for(pack_module)

@spec source_for(pack_module()) :: {:extension, atom()}

Returns the contribution source used for a pack.

start_link(opts \\ [])

@spec start_link(keyword()) :: Agent.on_start()

Starts the bundled theme pack loader.

unregister_pack(pack_module)

@spec unregister_pack(pack_module()) :: :ok

Unregisters all themes owned by a pack.