Struct ContributionEntry 

pub struct ContributionEntry {
    pub kind: String,
    pub id: String,
    pub title: Option<String>,
    pub when: Option<String>,
    pub scopes: Vec<String>,
    pub platforms: Vec<String>,
    pub config: BTreeMap<String, Value>,
}

A single [[contributes]] host-surface contribution.

[[contributes]]
kind = "editor.language"          # host-owned namespaced vocabulary
id = "latex"                      # unique within the package
title = "LaTeX"
when = "*.tex"                    # optional activation predicate (host-interpreted)
scopes = ["workspace:read_text"]  # MUST be a subset of [package].permissions
platforms = ["macos", "linux"]    # optional support/parity matrix; empty = all
# kind-specific keys are captured into `config` and interpreted by the host:
languageId = "latex"
extensions = [".tex", ".sty"]

Fields

kind: String

Host-owned, namespaced contribution kind (e.g. editor.language, editor.preview, build.profile, editor.command, editor.theme). Harn does not enumerate kinds — new ones need no release; it only requires the value be namespaced (segment(.segment)+).

id: String

Stable identifier, unique across the package’s contributions.

title: Option<String>

when: Option<String>

Optional activation predicate the host interprets (a glob, a languageId, or a host-defined expression). Absent = always available.

scopes: Vec<String>

Capability scopes this contribution exercises. Every entry MUST be declared in [package].permissions; validation fails closed otherwise.

platforms: Vec<String>

Optional support/parity matrix — which surfaces/platforms this contribution targets (e.g. macos, linux, windows, ide, tui). Empty means “all”.

config: BTreeMap<String, Value>

Kind-specific payload, captured verbatim and interpreted by the host.

Implementations

impl ContributionEntry

pub fn has_namespaced_kind(&self) -> bool

true when kind is a non-empty, dot-namespaced identifier such as editor.language. Single-segment kinds are rejected so third parties cannot squat unprefixed names.

Trait Implementations

impl Clone for ContributionEntry

fn clone(&self) -> ContributionEntry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ContributionEntry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContributionEntry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ContributionEntry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.