gleamdoc/interface

Lookup, search, and rendering for compiler-generated package interfaces.

Types

Entry

A public module, value, type, variant, or alias found in a package interface.

pub type Entry {
  ModuleEntry(
    package: package_interface.Package,
    name: String,
    module: package_interface.Module,
  )
  FunctionEntry(
    package: package_interface.Package,
    module: String,
    name: String,
    value: package_interface.Function,
  )
  ConstantEntry(
    package: package_interface.Package,
    module: String,
    name: String,
    value: package_interface.Constant,
  )
  TypeEntry(
    package: package_interface.Package,
    module: String,
    name: String,
    value: package_interface.TypeDefinition,
  )
  VariantEntry(
    package: package_interface.Package,
    module: String,
    type_name: String,
    type_parameters: Int,
    name: String,
    value: package_interface.TypeConstructor,
  )
  AliasEntry(
    package: package_interface.Package,
    module: String,
    name: String,
    value: package_interface.TypeAlias,
  )
}

Constructors

ModuleEntry(
  package: package_interface.Package,
  name: String,
  module: package_interface.Module,
)

FunctionEntry(
  package: package_interface.Package,
  module: String,
  name: String,
  value: package_interface.Function,
)

ConstantEntry(
  package: package_interface.Package,
  module: String,
  name: String,
  value: package_interface.Constant,
)

TypeEntry(
  package: package_interface.Package,
  module: String,
  name: String,
  value: package_interface.TypeDefinition,
)

VariantEntry(
  package: package_interface.Package,
  module: String,
  type_name: String,
  type_parameters: Int,
  name: String,
  value: package_interface.TypeConstructor,
)

AliasEntry(
  package: package_interface.Package,
  module: String,
  name: String,
  value: package_interface.TypeAlias,
)

SymbolKind

</>

Filter for symbol kinds in search results.

pub type SymbolKind {
  All
  Module
  Fn
  Const
  Type
  Variant
  Alias
}

Constructors

```
All
```
Match all symbol kinds.
```
Module
```
Match modules only.
```
Fn
```
Match functions only.
```
Const
```
Match constants only.
```
Type
```
Match types only.
```
Variant
```
Match variants only.
```
Alias
```
Match type aliases only.

Target

</>

Filter for runtime targets in search results.

pub type Target {
  AllTargets
  Erlang
  Javascript
}

Constructors

```
AllTargets
```
Match all targets (including entries without target metadata).
```
Erlang
```
Match Erlang-targeted entries only.
```
Javascript
```
Match JavaScript-targeted entries only.

Values

entries_json

</>

pub fn entries_json(entries: List(Entry)) -> json.Json

Encodes entries in Gleamdoc’s versioned JSON response envelope.

format_type

</>

pub fn format_type(type_: package_interface.Type) -> String

Formats a package-interface type as Gleam source syntax.

lookup

</>

pub fn lookup(
  package: package_interface.Package,
  query: String,
) -> List(Entry)

Looks up an exact module or qualified symbol in one package.

lookup_packages

</>

pub fn lookup_packages(
  packages: List(package_interface.Package),
  query: String,
) -> List(Entry)

Looks up an exact, optionally package-qualified symbol across packages.

packages_json

</>

pub fn packages_json(
  packages: List(package_interface.Package),
) -> json.Json

Encodes package summaries in Gleamdoc’s versioned JSON response envelope.

render

</>

pub fn render(entry: Entry) -> String

Renders complete documentation for one entry.

render_all

</>

pub fn render_all(entries: List(Entry)) -> String

Renders complete documentation for all entries.

render_packages

</>

pub fn render_packages(
  packages: List(package_interface.Package),
) -> String

Renders package names, versions, and module counts.

render_search_results

</>

pub fn render_search_results(entries: List(Entry)) -> String

Renders compact, one-line search results.

search

</>

pub fn search(
  package: package_interface.Package,
  query: String,
) -> List(Entry)

Searches one package by symbol name, module, package name, signature, and documentation.

search_packages

</>

pub fn search_packages(
  packages: List(package_interface.Package),
  query: String,
  limit: Int,
) -> List(Entry)

Searches packages and returns at most the requested number of ranked entries.

search_packages_filtered

</>

pub fn search_packages_filtered(
  packages: List(package_interface.Package),
  query: String,
  limit: Int,
  kind kind: SymbolKind,
  target target: Target,
) -> List(Entry)

Searches packages with optional entry-kind and runtime-target filters.

Target filters only match functions and constants because other entries do not have runtime-target metadata. Use All for kind and AllTargets for target to match all entries.