@spec all_ignored() :: MapSet.t(module())

Returns all ignored modules as a MapSet.

@spec all_reclassified() :: %{required(module()) => module()}

Returns all reclassified modules as a map of module => target context.

@spec context(module()) :: map() | nil

Returns the config for a context module, or nil.

@spec contexts() :: %{required(module()) => map()}

Returns all registered contexts as a map of module => config.

@spec create_tables() :: :ok

Creates the ETS tables in the calling process. Only Store.Owner should call this — everything else goes through init/0 so the tables are owned by the stable process rather than the caller.

@spec ensure_loaded() :: :ok

Loads Frontier config from compiled BEAM files if ETS is empty.

@spec ignored?(module()) :: boolean()

Returns true if the module is ignored.

@spec init() :: :ok

Ensures the ETS tables exist, owned by a stable process.

Idempotent and safe to call concurrently from parallel compiler workers: delegates to Frontier.Store.Owner, which spawns an unlinked, detached process to own the tables so ownership never rides on the transient worker that triggered it. Blocks until the tables exist, so a caller can insert immediately on return.

@spec initialize_module(module()) :: :ok

Marks a module as initialized, clearing its previous references. Idempotent per compilation.

@spec load_from_modules() :: :ok

Scans compiled BEAM files for persisted frontier_opts attributes and registers them.

@spec reclassified_to(module()) :: module() | nil

Returns the target context for a reclassified module, or nil.

@spec record_reference(module(), map()) :: true

Records a cross-module reference from the tracer.

@spec references() :: [map()]

Returns all recorded references with :from key injected.

@spec register_context(module(), map()) :: true

Registers a context module and its config.

@spec register_ignored(module()) :: true

Registers a module as ignored.

@spec register_reclassified(module(), module()) :: true

Registers a module as reclassified to a different context.

@spec register_root(module(), map()) :: true

Registers the root module config.

@spec reset() :: :ok

Wipes all ETS tables.

@spec reset_initialized() :: :ok | true

Resets the initialized tracking table.

@spec root() :: {module(), map()} | nil

Returns the root module and its config, or nil.