Struct Importmap 

pub struct Importmap { /* private fields */ }

An ES module import map ({ "imports": { … } }).

This is the imports-only dialect the build emits and validates — not a WHATWG import-map processor. scopes, base-URL resolution and multi-map merging are out of scope, because the build only ever interprets the map it generated itself. The struct is the wire shape: serde derives both directions of the { "imports": { … } } document, so parsing and printing cannot drift apart. Unknown top-level keys (scopes, integrity, …) are ignored on read.

Implementations

impl Importmap

pub fn new() -> Self

An empty import map.

pub fn from_mounts(mounts: &[Mount]) -> Self

Build an import map from a set of Mounts: each mount with a non-empty specifier contributes <specifier> → <url>. The runtime counterpart to tsconfig’s editor paths, generated from the same mount set.

pub fn insert( &mut self, specifier: impl Into<String>, url: impl Into<String>, ) -> &mut Self

Add or replace an entry. Returns &mut self for chaining.

pub fn extend(&mut self, other: Importmap) -> &mut Self

Merge other into self; on key conflicts other wins (call order is precedence: merge more specific fragments last).

pub fn is_empty(&self) -> bool

Whether the map has no entries.

pub fn len(&self) -> usize

Number of entries.

pub fn iter(&self) -> impl Iterator<Item = (&str, &str)>

Iterate (specifier, url) pairs in sorted order.

pub fn resolves(&self, specifier: &str) -> bool

Whether specifier resolves under this map: an exact key, or a prefix key (ending in /) that prefixes the specifier, e.g. "lit/" resolves lit/decorators.js.

pub fn from_json_file(path: &Path) -> Result<Self>

Read an import-map fragment file: a JSON document whose top-level "imports" object has string values.

pub fn from_json_str(json: &str, context: &str) -> Result<Self>

Parse an import-map JSON document (a top-level "imports" object with string values); context names the source in error messages.

pub fn to_json(&self) -> String

Serialize to a pretty JSON document.

pub fn to_script_tag(&self) -> String

Render a complete <script type="importmap">…</script> element (compact JSON).

Specifiers and URLs are auto-derived from each package’s package.json, which is untrusted. <, > and & in the JSON are emitted as \uXXXX escapes so a hostile value (e.g. a specifier containing </script>) cannot terminate the element; the escapes are valid JSON, so the browser parses the same import map.

pub fn write_to(&self, path: &Path) -> Result<()>

Write the import map to path, creating parent directories.

Trait Implementations

impl Clone for Importmap

fn clone(&self) -> Importmap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Importmap

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

Formats the value using the given formatter.

impl Default for Importmap

fn default() -> Importmap

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Importmap

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Importmap

impl PartialEq for Importmap

fn eq(&self, other: &Importmap) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Importmap

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Importmap