Struct ExtensionDescriptionStateDTO 

pub struct ExtensionDescriptionStateDTO {

    pub Identifier: Value,
    pub Name: String,
    pub Version: String,
    pub Publisher: String,
    pub Engines: Value,
    pub Main: Option<String>,
    pub Browser: Option<String>,
    pub ModuleType: Option<String>,
    pub IsBuiltin: bool,
    pub IsUnderDevelopment: bool,
    pub ExtensionLocation: Value,
    pub ActivationEvents: Option<Vec<String>>,
    pub Contributes: Option<Value>,
    pub Categories: Option<Vec<String>>,
    pub DisplayName: Option<String>,
    pub Description: Option<String>,
    pub Keywords: Option<Vec<String>>,
    pub Repository: Option<Value>,
    pub Bugs: Option<Value>,
    pub Homepage: Option<String>,
    pub License: Option<String>,
    pub Icon: Option<String>,
    pub AiKey: Option<String>,
    pub ExtensionKind: Option<Value>,
    pub Capabilities: Option<Value>,
    pub ExtensionDependencies: Option<Vec<String>>,
    pub ExtensionPack: Option<Vec<String>>,
}

Represents the deserialized content of an extension’s package.json file, augmented with location information and other metadata.

This is stored in ApplicationState to provide the extension host with the list of available extensions and their capabilities. VS Code extensions use camelCase in package.json. Serde renames from PascalCase Rust fields to camelCase JSON automatically. Fields that don’t exist in package.json (Identifier, ExtensionLocation, IsBuiltin) default to their zero values on deserialization.

Fields

Identifier: Value

Extension identifier: { value: string, uuid?: string } Not present in package.json - constructed from publisher.name after parsing.

Name: String

Extension name (from package.json “name”)

Always serialized, even when empty, because VS Code’s scanner and the trusted-publishers migration (extensions.contribution.ts) both evaluate extension.manifest.name.toLowerCase() unconditionally. Dropping the field would leave a bare undefined and crash the renderer with TypeError: undefined is not an object.

Version: String

Semantic version string (e.g., “1.0.0”).

Always serialized for the same reason as Name / Publisher: the renderer reads manifest.version in several hot paths and crashes if the field is missing outright.

Publisher: String

Publisher name or identifier.

Always serialized, even when empty. VS Code’s extensions.contribution.ts trusted-publishers migration runs on every User-extension at workbench boot and executes extension.manifest.publisher.toLowerCase(). If the key is omitted the renderer crashes with TypeError: undefined is not an object (evaluating 'manifest.publisher').

Engines: Value

Engine compatibility requirements: { vscode: string }

Main: Option<String>

Main entry point path (Node.js runtime)

Browser: Option<String>

Browser entry point path (web extension)

ModuleType: Option<String>

Module type: commonjs or esm

IsBuiltin: bool

Whether this is a built-in extension (not in package.json, set by scanner)

IsUnderDevelopment: bool

Whether extension is under active development

ExtensionLocation: Value

Installation location URI (set by scanner, not in package.json)

ActivationEvents: Option<Vec<String>>

Activation event triggers (e.g., “onStartupFinished”)

Contributes: Option<Value>

Extension contributions (commands, views, etc.)

Categories: Option<Vec<String>>

VS Code category tags (“Themes”, “Programming Languages”, “Snippets”, “Language Packs”, “Debuggers”, “Formatters”, “Keymaps”, “SCM Providers”, “Testing”, “Education”, “Other”).

Atom TH1: Wind’s Extensions sidebar filters @builtin category:themes against this array. Without the field the filter never matches - user reported theme extensions absent on @builtin search despite being on disk. Scanner-passthrough surfaces the raw package.json value; resolved NLS placeholders survive because the serde deserialisation happens after the NLS rewrite.

DisplayName: Option<String>

Human-readable display name, usually a VS Code NLS placeholder like %displayName% that the scanner resolves against package.nls.json. Atom TH1: sidebar row rendering falls back to name when this is absent; having the real value populates tooltips and the details editor.

Description: Option<String>

Short prose description. Same NLS-placeholder rules as DisplayName.

Keywords: Option<Vec<String>>

Extension keywords array - searched by the sidebar when the query doesn’t match name, displayName, or description.

Repository: Option<Value>

Repository info: Either a string URL or { type, url } object.

Bugs: Option<Value>

Bug-tracker URL or object.

Homepage: Option<String>

Homepage URL.

License: Option<String>

License identifier (SPDX short code) or URL.

Icon: Option<String>

Icon path relative to the extension root (for sidebar thumbnails).

AiKey: Option<String>

Marketplace API key placeholder - still present in some upstream built-in manifests. @vscode/extension-telemetry reads its length on construction; if missing the activate throws Cannot read properties of undefined (reading 'length').

ExtensionKind: Option<Value>

Marketplace-side extension kind (["ui"], ["workspace"], ["web"]). Wind uses this to decide which host to run the extension in. Missing → VS Code falls back to heuristics.

Capabilities: Option<Value>

Capabilities descriptor - untrustedWorkspaces, virtualWorkspaces.

ExtensionDependencies: Option<Vec<String>>

Dependency list - other extensions this one needs activated first.

ExtensionPack: Option<Vec<String>>

Extension-pack children - extensions this one bundles by reference.

Implementations

impl ExtensionDescriptionStateDTO

pub fn Validate(&self) -> Result<(), String>

Validates the extension description data.

Returns

Result indicating success or validation error with reason

pub fn CreateMinimal( Identifier: Value, Name: String, Version: String, Publisher: String, ) -> Result<Self, String>

Creates a minimal extension description for testing or placeholder use.

Arguments

• Identifier - Extension identifier value
• Name - Extension name
• Version - Extension version
• Publisher - Publisher name

Returns

A new ExtensionDescriptionStateDTO with minimal required fields

Trait Implementations

impl Clone for ExtensionDescriptionStateDTO

fn clone(&self) -> ExtensionDescriptionStateDTO

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExtensionDescriptionStateDTO

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ExtensionDescriptionStateDTO

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ExtensionDescriptionStateDTO

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

where __S: Serializer,

Serialize this value into the given Serde serializer.