@vltpkg/spec - npm Package Compare versions

+131

dist/browser.d.ts

		import type { Range } from '@vltpkg/semver';
		import type { GitSelectorParsed, Scope, SpecLike, SpecOptions, SpecOptionsFilled, SpecType } from './types.ts';
		export * from './types.ts';
		export declare const kCustomInspect: unique symbol;
		export declare const defaultRegistry = "https://registry.npmjs.org/";
		export declare const defaultRegistryName = "npm";
		export declare const defaultRegistries: {
		npm: string;
		gh: string;
		};
		export declare const defaultJsrRegistries: {
		jsr: string;
		};
		export declare const defaultGitHosts: {
		github: string;
		bitbucket: string;
		gitlab: string;
		gist: string;
		};
		export declare const defaultGitHostArchives: {
		github: string;
		bitbucket: string;
		gist: string;
		gitlab: string;
		};
		/**
		* These are just for legacy support of urls that are supported by npm
		* and observed in the wild.
		*
		* Not configurable, because no more will be added. If you wish to define
		* custom git hosts, use it with the `'git-hosts'` and `'git-host-archives'`
		* options.
		*/
		export declare const gitHostWebsites: {
		github: string;
		bitbucket: string;
		gist: string;
		gitlab: string;
		};
		export declare const defaultScopeRegistries: {
		'@jsr': string;
		};
		export declare const getOptions: (options?: SpecOptions) => SpecOptionsFilled;
		/**
		* Injects the Node.js dependencies into the Spec class.
		*/
		export type NodeJSDependenciesOptions = {
		homedir: typeof import('os').homedir;
		isAbsolute: typeof import('node:path').isAbsolute;
		join: typeof import('node:path').join;
		resolve: typeof import('node:path').resolve;
		winPath: typeof import('node:path').win32;
		};
		export declare const isSpec: (spec: unknown) => spec is Spec;
		/**
		* Retrieves the short configured name of the default registry if one
		* is available.
		*/
		export declare const currentDefaultRegistryName: (registry: string, options: SpecOptions) => string \| undefined;
		/**
		* The base, isomorphic Spec implementation.
		*/
		export declare class Spec implements SpecLike<Spec> {
		#private;
		/**
		* Create a Spec object from a full spec, name+bareSpec, or Spec object
		*
		* Note: If a Spec object is provided, it is returned as-is, without
		* investigating whether the options match.
		*/
		static parse(name: string, bareSpec: string, options?: SpecOptions): Spec;
		static parse(spec: string, options?: SpecOptions): Spec;
		static parse(spec: Spec, options?: SpecOptions): Spec;
		static parseArgs(specOrBareSpec: string, opts?: SpecOptions): Spec;
		static nodejsDependencies?: NodeJSDependenciesOptions;
		type: SpecType;
		spec: string;
		options: SpecOptionsFilled;
		name: string;
		scope?: Scope;
		scopeRegistry?: string;
		bareSpec: string;
		gitRemote?: string;
		gitSelector?: string;
		gitSelectorParsed?: GitSelectorParsed;
		gitCommittish?: string;
		namedGitHost?: string;
		namedGitHostPath?: string;
		workspaceSpec?: string;
		workspace?: string;
		namedRegistry?: string;
		namedJsrRegistry?: string;
		registry?: string;
		registrySpec?: string;
		conventionalRegistryTarball?: string;
		semver?: string;
		range?: Range;
		distTag?: string;
		remoteURL?: string;
		file?: string;
		catalog?: string;
		subspec?: Spec;
		overridden: boolean;
		/**
		* Return the final entry in the chain of subspecs
		* When deciding which thing to actually fetch, spec.final is the thing
		* to look at.
		*/
		get final(): Spec & {
		type: Exclude<SpecType, 'catalog'>;
		};
		/**
		* Normally, the string value of a Spec is just the string passed in to
		* be parsed. However, in the case of a chain of subspecs, like
		* `foo@npm:bar@npm:baz@npm:quux@latest`, this simplifies out the middle
		* parts of the chain, returning just `foo@npm:quux@latest`
		*/
		toString(): string;
		['constructor']: typeof Spec;
		constructor(name: string, bareSpec: string, options?: SpecOptions);
		constructor(spec: string, options?: SpecOptions);
		constructor(spec: Spec \| string, bareOrOptions?: SpecOptions \| string, options?: SpecOptions);
		[kCustomInspect](): string;
		/**
		* Should only ever be called with the bit that comes AFTER the #
		* in the git remote url.
		*/
		static parseGitSelector(selector: string, spec?: Spec): [parsed: GitSelectorParsed, committish?: string, range?: Range];
		}
		export declare const getNormalizeFile: (opts?: NodeJSDependenciesOptions) => (bareSpec: string, spec: Spec) => [path: string, uri: string];
		//# sourceMappingURL=browser.d.ts.map

+1

dist/browser.d.ts.map

{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"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"}

+801

dist/browser.js

		import { error, typeError } from '@vltpkg/error-cause';
		import { parseRange } from '@vltpkg/semver';
		export * from "./types.js";
		export const kCustomInspect = Symbol.for('nodejs.util.inspect.custom');
		export const defaultRegistry = 'https://registry.npmjs.org/';
		export const defaultRegistryName = 'npm';
		export const defaultRegistries = {
		npm: defaultRegistry,
		gh: 'https://npm.pkg.github.com/',
		};
		export const defaultJsrRegistries = { jsr: 'https://npm.jsr.io/' };
		export const defaultGitHosts = {
		github: 'git+ssh://git@github.com:$1/$2.git',
		bitbucket: 'git+ssh://git@bitbucket.org:$1/$2.git',
		gitlab: 'git+ssh://git@gitlab.com:$1/$2.git',
		gist: 'git+ssh://git@gist.github.com/$1.git',
		};
		export const defaultGitHostArchives = {
		github: 'https://api.github.com/repos/$1/$2/tarball/$committish',
		bitbucket: 'https://bitbucket.org/$1/$2/get/$committish.tar.gz',
		gist: 'https://codeload.github.com/gist/$1/tar.gz/$committish',
		gitlab: 'https://gitlab.com/$1/$2/repository/archive.tar.gz?ref=$committish',
		};
		/**
		* These are just for legacy support of urls that are supported by npm
		* and observed in the wild.
		*
		* Not configurable, because no more will be added. If you wish to define
		* custom git hosts, use it with the `'git-hosts'` and `'git-host-archives'`
		* options.
		*/
		export const gitHostWebsites = {
		github: 'https://github.com/',
		bitbucket: 'https://bitbucket.org/',
		gist: 'https://gist.github.com/',
		gitlab: 'https://gitlab.com/',
		};
		export const defaultScopeRegistries = {
		'@jsr': 'https://npm.jsr.io/',
		};
		export const getOptions = (options) => ({
		catalog: {},
		catalogs: {},
		...options,
		'jsr-registries': {
		...(options?.['jsr-registries'] ?? {}),
		...defaultJsrRegistries,
		},
		registry: options?.registry ?? defaultRegistry,
		'scope-registries': options?.['scope-registries'] ?? {},
		'git-hosts': options?.['git-hosts'] ?
		{
		...defaultGitHosts,
		...options['git-hosts'],
		}
		: defaultGitHosts,
		registries: {
		...(options?.registries ?? {}),
		...defaultRegistries,
		},
		'git-host-archives': options?.['git-host-archives'] ?
		{
		...defaultGitHostArchives,
		...options['git-host-archives'],
		}
		: defaultGitHostArchives,
		});
		/**
		* Various nameless scenarios that are handled in the
		* standard spec parsing and should return an unknown name.
		*
		* Returns `true` if the name can not be inferred, `false` otherwise.
		*/
		const startsWithSpecIdentifier = (spec, options) => spec.startsWith('/') \|\|
		spec.startsWith('./') \|\|
		spec.startsWith('../') \|\|
		spec.startsWith('file:') \|\|
		spec.startsWith('http:') \|\|
		spec.startsWith('https:') \|\|
		spec.startsWith('workspace:') \|\|
		spec.startsWith('catalog:') \|\|
		spec.startsWith('git@') \|\|
		spec.startsWith('git://') \|\|
		spec.startsWith('git+ssh://') \|\|
		spec.startsWith('git+http://') \|\|
		spec.startsWith('git+https://') \|\|
		spec.startsWith('git+file://') \|\|
		spec.startsWith('git@github.com') \|\|
		spec.startsWith('registry:') \|\|
		spec.startsWith('npm:') \|\|
		spec.startsWith('jsr:') \|\|
		spec.startsWith('gh:') \|\|
		// anything that starts with a known git host key, or a
		// custom registered registry protocol e.g: `github:`, `custom:`
		[
		...Object.keys(options['git-hosts']),
		...Object.keys(options.registries),
		...Object.keys(options['jsr-registries']),
		].some(key => spec.startsWith(`${key}:`));
		/**
		* Returns the location in which the first `@` value is found in a given
		* string, also takes into account that a string starting with @ is
		* using a scoped-name.
		*/
		const findFirstAt = (spec, hasScope) => spec.indexOf('@', hasScope ? 1 : 0);
		/**
		* Return `true` if a given spec string is likely to be a git spec.
		*/
		const findGitIdentifier = (spec) => spec.indexOf('#') > 2;
		/**
		* Return `true` if a given spec string is likely to be a file spec.
		*/
		const findFileIdentifier = (spec) => spec.includes('/');
		export const isSpec = (spec) => typeof spec === 'object' &&
		spec !== null &&
		'spec' in spec &&
		'bareSpec' in spec &&
		'name' in spec &&
		'type' in spec &&
		'options' in spec &&
		typeof spec.spec === 'string' &&
		typeof spec.bareSpec === 'string' &&
		typeof spec.name === 'string';
		/**
		* Retrieves the short configured name of the default registry if one
		* is available.
		*/
		export const currentDefaultRegistryName = (registry, options) => {
		for (const [name, url] of Object.entries(options.registries /* c8 ignore next */ ?? {})) {
		const specRegURL = registry.endsWith('/') ? registry : registry + '/';
		const knownRegURL = url.endsWith('/') ? url : url + '/';
		if (specRegURL === knownRegURL) {
		return name;
		}
		}
		};
		/**
		* The base, isomorphic Spec implementation.
		*/
		export class Spec {
		static parse(spec, bareOrOptions, options) {
		return typeof spec === 'object' ? spec : (new this(spec, bareOrOptions, options));
		}
		static parseArgs(specOrBareSpec, opts) {
		const options = getOptions(opts ?? {});
		if (startsWithSpecIdentifier(specOrBareSpec, options)) {
		const parsed = this.parse('(unknown)', specOrBareSpec, options);
		// try to look into a potential parsed subspec for a name
		if (parsed.subspec) {
		const { namedJsrRegistry: jsrHost } = parsed;
		if (!jsrHost) {
		parsed.name = parsed.subspec.name;
		}
		parsed.spec = `${parsed.name}@${parsed.bareSpec}`;
		}
		return parsed;
		}
		else {
		const hasScope = specOrBareSpec.startsWith('@');
		const at = findFirstAt(specOrBareSpec, hasScope);
		if (at > -1) {
		return this.parse(specOrBareSpec.substring(0, at), specOrBareSpec.substring(at + 1), options);
		}
		else if (findGitIdentifier(specOrBareSpec) \|\|
		(!hasScope && findFileIdentifier(specOrBareSpec))) {
		return this.parse('(unknown)', specOrBareSpec, options);
		}
		else {
		// doesn't have an @, so it's just a name with no version
		return this.parse(`${specOrBareSpec}@`, options);
		}
		}
		}
		static nodejsDependencies;
		type;
		spec;
		options;
		name;
		scope;
		scopeRegistry;
		bareSpec;
		gitRemote;
		gitSelector;
		gitSelectorParsed;
		gitCommittish;
		namedGitHost;
		namedGitHostPath;
		workspaceSpec;
		workspace;
		namedRegistry;
		namedJsrRegistry;
		registry;
		registrySpec;
		conventionalRegistryTarball;
		semver;
		range;
		distTag;
		remoteURL;
		file;
		catalog;
		subspec;
		overridden = false;
		#final;
		#toString;
		/**
		* Return the final entry in the chain of subspecs
		* When deciding which thing to actually fetch, spec.final is the thing
		* to look at.
		*/
		get final() {
		if (this.#final)
		return this.#final;
		const final = this.subspec ? this.subspec.final : this;
		/* c8 ignore start - impossible */
		if (final.type === 'catalog') {
		throw error('invalid Spec.final value, type is "catalog"');
		}
		/* c8 ignore stop */
		return (this.#final = final);
		}
		/**
		* Normally, the string value of a Spec is just the string passed in to
		* be parsed. However, in the case of a chain of subspecs, like
		* `foo@npm:bar@npm:baz@npm:quux@latest`, this simplifies out the middle
		* parts of the chain, returning just `foo@npm:quux@latest`
		*/
		toString() {
		if (this.#toString !== undefined)
		return this.#toString;
		let sub = this;
		// we want the SECOND from the last in the chain
		while (sub.subspec?.subspec)
		sub = sub.subspec;
		if (sub.subspec && sub.subspec.type !== 'registry')
		sub = sub.subspec;
		return (this.#toString = this.name + '@' + sub.bareSpec);
		}
		constructor(spec, bareOrOptions, options = {}) {
		if (bareOrOptions && typeof bareOrOptions === 'object') {
		options = bareOrOptions;
		bareOrOptions = undefined;
		}
		this.options = getOptions(options);
		if (typeof bareOrOptions === 'string') {
		this.name = spec;
		this.#parseScope(spec);
		this.bareSpec = bareOrOptions;
		this.spec = `${this.name}@${bareOrOptions}`;
		}
		else {
		this.spec = spec;
		// Check if this spec starts with a known registry identifier
		// but exclude git specs like 'git@github:a/b'
		if (!spec.startsWith('git@') &&
		startsWithSpecIdentifier(spec, this.options) &&
		spec.includes(':') &&
		[
		...Object.keys(this.options.registries),
		...Object.keys(defaultRegistries),
		].some(key => spec.startsWith(`${key}:`))) {
		// For specs like 'gh:@octocat/hello-world@1.0.0', don't split at the @
		// Instead, set a temporary name and let the registry logic handle it
		this.name = spec;
		this.bareSpec = spec;
		}
		else {
		const hasScope = spec.startsWith('@');
		let at = findFirstAt(spec, hasScope);
		if (at === -1) {
		// assume that an unadorned spec is just a name at the default
		// registry
		at = spec.length;
		spec += '@';
		}
		this.name = spec.substring(0, at);
		if (hasScope)
		this.#parseScope(this.name);
		this.bareSpec = spec.substring(at + 1);
		}
		}
		if (this.bareSpec.startsWith('catalog:')) {
		this.catalog = this.bareSpec.substring('catalog:'.length);
		const catalog = this.catalog ?
		this.options.catalogs?.[this.catalog]
		: this.options.catalog;
		if (!catalog) {
		throw this.#error('Named catalog not found', {
		name: this.catalog,
		validOptions: this.options.catalogs &&
		Object.keys(this.options.catalogs),
		});
		}
		const sub = catalog[this.name];
		if (!sub) {
		throw this.#error('Name not found in catalog', {
		name: this.name,
		validOptions: Object.keys(catalog),
		});
		}
		this.subspec = Spec.parse(this.name, sub);
		this.type = 'catalog';
		return;
		}
		// legacy affordance: allow project urls like
		// 'https://github.com/user/project#commitish' because npm suports it and
		// this pattern is observed in the wild.
		if (this.bareSpec.startsWith('https://')) {
		for (const [name, origin] of Object.entries(gitHostWebsites)) {
		if (this.bareSpec.startsWith(origin)) {
		const parsed = new URL(this.bareSpec);
		const [user, project] = parsed.pathname
		.replace(/\.git$/, '')
		.replace(/\/+/g, ' ')
		.trim()
		.split(' ');
		if (user && project) {
		this.bareSpec = `${name}:${user}/${project}${parsed.hash}`;
		this.spec = `${this.name}@${this.bareSpec}`;
		break;
		}
		}
		}
		}
		if (this.bareSpec.startsWith('workspace:')) {
		this.type = 'workspace';
		const ws = this.bareSpec.substring('workspace:'.length).trim();
		const w = ws.lastIndexOf('@');
		if (w === -1) {
		this.workspace = this.name;
		}
		else {
		const wsName = ws.substring(0, w);
		if (!wsName \|\|
		wsName === '*' \|\|
		wsName === '~' \|\|
		wsName === '^' \|\|
		(wsName.startsWith('@') ?
		wsName.split('/').length !== 2 \|\|
		wsName.substring(1).includes('@')
		: wsName.includes('@'))) {
		throw this.#error('workspace: name must be a path or valid package name', { found: wsName });
		}
		this.workspace = wsName;
		}
		// workspace: is the same as workspace:*
		const wss = w === -1 ? ws : ws.substring(w + 1) \|\| '*';
		const range = wss === '*' ? undefined : parseRange(wss);
		if (wss !== '*' && wss !== '~' && wss !== '^' && !range) {
		throw this.#error('workspace: spec must be one of *, ~, or ^, or a valid semver range', {
		found: wss,
		wanted: `'*'\|'~'\|'^'\|SemverRange`,
		});
		}
		this.workspaceSpec = wss;
		if (range) {
		this.semver = wss;
		this.range = range;
		}
		return;
		}
		if (this.bareSpec.startsWith('git://') \|\|
		this.bareSpec.startsWith('git+ssh://') \|\|
		this.bareSpec.startsWith('git+http://') \|\|
		this.bareSpec.startsWith('git+https://') \|\|
		this.bareSpec.startsWith('git+file://') \|\|
		// legacy affordance
		this.bareSpec.startsWith('git@github.com')) {
		if (this.bareSpec.startsWith('git@')) {
		this.bareSpec = `git+ssh://${this.bareSpec}`;
		this.spec = `${this.name}@${this.bareSpec}`;
		}
		this.type = 'git';
		// see if it's one of the known named hosts, and if so, prefer
		// the shorter syntax.
		for (const [name, host] of Object.entries(this.options['git-hosts'])) {
		const s = host.indexOf('$');
		if (s > 0 && this.bareSpec.startsWith(host.substring(0, s))) {
		const p = this.bareSpec
		.substring(s)
		.replace(/\.git(#.*)?$/, '$1');
		this.bareSpec = `${name}:${p}`;
		this.spec = `${this.name}@${this.bareSpec}`;
		this.#parseHostedGit(name, host);
		this.type = 'git';
		return;
		}
		}
		this.#parseGitSelector(this.bareSpec);
		return;
		}
		// Check registries before git hosts to avoid conflicts
		const regs = Object.entries(this.options.registries);
		if (this.bareSpec.startsWith('registry:')) {
		const reg = this.bareSpec.substring('registry:'.length);
		const h = reg.indexOf('#');
		if (h === -1) {
		throw this.#error('registry: must include name/version');
		}
		this.type = 'registry';
		let url = reg.substring(0, h);
		if (!url.endsWith('/'))
		url += '/';
		const regSpec = reg.substring(h + 1);
		for (let [name, u] of regs) {
		if (!u.endsWith('/')) {
		u += '/';
		this.options.registries[name] = u;
		}
		if (u === url)
		this.namedRegistry = name;
		}
		this.#parseRegistrySpec(regSpec, url);
		this.#guessRegistryTarball();
		return;
		}
		for (const [host, url] of regs) {
		const h = `${host}:`;
		if (this.bareSpec.startsWith(h)) {
		this.type = 'registry';
		this.namedRegistry = host;
		this.#parseRegistrySpec(this.bareSpec.substring(h.length), url).namedRegistry ??= host;
		// If we parsed a spec identifier, update the name and spec format
		if (this.subspec && this.name === this.bareSpec) {
		this.name = this.subspec.name;
		this.spec = `${this.name}@${this.bareSpec}`;
		}
		this.#guessRegistryTarball();
		return;
		}
		}
		// spooky
		const ghosts = Object.entries(this.options['git-hosts']);
		for (const [name, template] of ghosts) {
		if (this.#parseHostedGit(name, template)) {
		this.type = 'git';
		return;
		}
		}
		const jsrs = Object.entries(this.options['jsr-registries']);
		for (const [host, url] of jsrs) {
		const h = `${host}:`;
		if (this.bareSpec.startsWith(h)) {
		this.type = 'registry';
		this.namedJsrRegistry = host;
		this.#parseJsrRegistrySpec(this.bareSpec.substring(h.length), url).namedJsrRegistry ??= host;
		return;
		}
		}
		if (this.bareSpec.startsWith('https://') \|\|
		this.bareSpec.startsWith('http://')) {
		this.remoteURL = this.bareSpec;
		this.type = 'remote';
		return;
		}
		// explicit file: url
		if (this.bareSpec.startsWith('file:')) {
		this.type = 'file';
		const [path, uri] = getNormalizeFile(this.constructor.nodejsDependencies)(this.bareSpec, this);
		this.file = path;
		this.bareSpec = uri.replace(/\/+$/, '');
		this.spec = `${this.name}@${this.bareSpec}`;
		return;
		}
		// legacy! once upon a time, `user/project` was a shorthand for pulling
		// packages from github, instead of the more verbose and explicit
		// `github:user/project`.
		if (!this.bareSpec.startsWith('./') &&
		!this.bareSpec.startsWith('../') &&
		this.options['git-hosts'].github) {
		const hash = this.bareSpec.indexOf('#');
		const up = hash === -1 ? this.bareSpec : this.bareSpec.substring(0, hash);
		if (up.split('/').length === 2) {
		this.bareSpec = `github:${this.bareSpec}`;
		this.spec = `${this.name}@${this.bareSpec}`;
		this.#parseHostedGit('github', this.options['git-hosts'].github);
		this.type = 'git';
		return;
		}
		}
		// if it contains a / and isn't picked up in the github shorthand,
		// then convert to file: specifier
		if (this.bareSpec.includes('/') \|\|
		this.bareSpec === '.' \|\|
		this.bareSpec === '..') {
		this.type = 'file';
		const [file, uri] = getNormalizeFile(this.constructor.nodejsDependencies)(`file:${this.bareSpec}`, this);
		this.bareSpec = uri;
		this.spec = `${this.name}@${this.bareSpec}`;
		this.file = file;
		return;
		}
		// at this point, must be either semver range or dist-tag
		this.type = 'registry';
		const range = parseRange(this.bareSpec);
		if (range) {
		this.semver = this.bareSpec.trim();
		this.range = range;
		}
		else {
		this.distTag = this.bareSpec;
		}
		this.registrySpec = this.bareSpec;
		const { 'scope-registries': scopeRegs, registry } = this.options;
		const scopeReg = this.scope && scopeRegs[this.scope];
		this.registry = scopeReg ?? registry;
		// no guessing the tarball for JSR registries
		for (const r of Object.values(this.options['jsr-registries'])) {
		if (this.registry === r)
		return;
		}
		this.#guessRegistryTarball();
		}
		#parseScope(name) {
		if (!name.startsWith('@'))
		return;
		const s = name.indexOf('/');
		if (s > 1 && s < name.length - 1) {
		const scope = name.substring(0, s);
		this.registry = this.scopeRegistry =
		this.options['scope-registries'][scope];
		this.scope = scope;
		}
		}
		#parseHostedGit(name, template) {
		if (this.bareSpec.startsWith(`${name}:`)) {
		const h = this.bareSpec.indexOf('#');
		const bare = h === -1 ? this.bareSpec : this.bareSpec.substring(0, h);
		const hash = h === -1 ? '' : this.bareSpec.substring(h);
		const hostPath = bare.substring(name.length + 1);
		if (!hostPath) {
		throw this.#error('invalid named git host specifier');
		}
		const split = hostPath.split('/');
		let t = template;
		for (let i = 0; i < split.length; i++) {
		t = t.split(`$${i + 1}`).join(split[i]);
		}
		t += hash;
		this.namedGitHost = name;
		this.namedGitHostPath = hostPath;
		this.#parseGitSelector(t);
		if (this.gitCommittish && !this.gitSelectorParsed?.path) {
		const archiveHost = this.options['git-host-archives'][name];
		if (name === 'github' &&
		this.gitCommittish.startsWith('pull/') &&
		this.gitCommittish.match(/\//g)?.length === 1) {
		this.gitCommittish += '/head';
		}
		if (archiveHost) {
		this.type = 'remote';
		let t = archiveHost;
		t = t.split('$committish').join(this.gitCommittish);
		for (let i = 0; i < split.length; i++) {
		t = t.split(`$${i + 1}`).join(split[i]);
		}
		this.remoteURL = t;
		}
		}
		return true;
		}
		return false;
		}
		/* c8 ignore start */
		[kCustomInspect]() {
		return `@vltpkg/spec.Spec ${String(this)}`;
		}
		/* c8 ignore stop */
		#guessRegistryTarball() {
		// only try to guess if it's a single comparator for a single version
		const { name, registry, range } = this.final;
		if (!registry \|\| !range?.isSingle)
		return;
		const stripScope = /^@[^/]+\//;
		this.conventionalRegistryTarball = String(new URL(`/${name}/-/${name.replace(stripScope, '')}-${range}.tgz`, registry));
		}
		#parseRegistrySpec(s, url) {
		// note: this takes priority over the scoped registry, if set
		this.registry = url;
		this.subspec = this.constructor.parse(s, {
		...this.options,
		registry: url,
		});
		return this.subspec;
		}
		#parseJsrRegistrySpec(s, url) {
		this.registry = url;
		// @luca/cases@jsr:1.x
		if (!s.startsWith('@'))
		s = `${this.name}@${s}`;
		// If the name already starts with @jsr/, it's already in JSR npm
		// format and should be used as-is (e.g. from lockfile hydration)
		const name = s.startsWith('@jsr/') ? s : (`@jsr/${s.replace(/^@/, '').replace(/\//, '__')}`);
		this.subspec = this.constructor.parse(name, {
		...this.options,
		'scope-registries': {
		...this.options['scope-registries'],
		'@jsr': url,
		},
		});
		if (this.name === '(unknown)') {
		const nextAt = s.indexOf('@', 1);
		if (nextAt === -1) {
		this.name = s;
		}
		else {
		this.name = s.substring(0, s.indexOf('@', 1));
		}
		}
		const reg = `${this.namedJsrRegistry}:`;
		const n = `${reg}${this.name}`;
		if (this.bareSpec.startsWith(n + '@')) {
		this.bareSpec = reg + this.bareSpec.substring(n.length + 1);
		}
		else if (this.bareSpec === n) {
		this.bareSpec = reg;
		}
		this.spec = this.name + '@' + this.bareSpec;
		return this.subspec;
		}
		#error(message, extra = {}) {
		return error(message, { spec: this.spec, ...extra }, this.#error);
		}
		#parseGitSelector(s) {
		const h = s.indexOf('#');
		if (h === -1) {
		this.gitRemote = s;
		return;
		}
		this.gitRemote = s.substring(0, h);
		this.gitSelector = s.substring(h + 1);
		const [selectorParsed, committish, range] = this.constructor.parseGitSelector(this.gitSelector, this);
		this.range = range;
		this.gitCommittish = committish;
		this.gitSelectorParsed = selectorParsed;
		}
		/**
		* Should only ever be called with the bit that comes AFTER the #
		* in the git remote url.
		*/
		static parseGitSelector(selector, spec) {
		if (!selector)
		return [{}];
		const split = selector.split('::');
		const first = split[0];
		let committish = undefined;
		let range = undefined;
		const parsed = {};
		/* c8 ignore start - for TS's benefit */
		if (typeof first !== 'string') {
		throw typeError('impossible', {
		found: first,
		wanted: String,
		});
		}
		/* c8 ignore stop */
		if (!first.includes(':')) {
		committish = first;
		split.shift();
		}
		for (const kv of split) {
		const c = kv.indexOf(':');
		/* c8 ignore next */
		if (c === -1)
		continue;
		const k = kv.substring(0, c);
		const v = kv.substring(c + 1);
		if (k === 'semver') {
		if (committish) {
		throw error('Cannot specify a semver range and committish value', { spec });
		}
		range = parseRange(v);
		if (!range) {
		throw error(`Invalid git tag semver range: ${v}`, { spec });
		}
		}
		if (k === 'semver' \|\| k === 'path') {
		if (k === 'path') {
		if (
		/* c8 ignore next */ this.nodejsDependencies?.isAbsolute(v) \|\|
		/(^\|\/\|\\)\.\.($\|\\\|\/)/.test(v)) {
		throw error('Invalid path in git selector', { spec });
		}
		// normalize
		/* c8 ignore start */
		parsed.path = (this.nodejsDependencies ?
		this.nodejsDependencies.join('/', v).substring(1)
		: v).replace(/\\/g, '/');
		/* c8 ignore stop */
		}
		else {
		parsed[k] = v;
		}
		}
		}
		return [parsed, committish, range];
		}
		}
		// normalize our kinda-sorta spec compliant `file:` specifiers
		//
		// For historical reasons, we need to support a lot of non-spec-compliant
		// behaviors, but this massages the result into a slightly less offensive
		// shape.
		//
		// The result will be either a fully compliant `file://` with an absolute path,
		// or a `file:` with a relative path starting with `~`, `./`, or `../`.
		export const getNormalizeFile = (opts) => (bareSpec, spec) => {
		const slashes = bareSpec.substring('file:'.length, 'file://'.length);
		const pref = `file:${slashes === '//' ? slashes : ''}`;
		const rest = bareSpec.substring(pref.length);
		// default to '/' because eol == '/' for parsing purposes
		const [a = '', b = '/', c = '/', d = '/'] = rest.split('', 4);
		if (!a) {
		// file:// => file:.
		// file: => file:.
		return ['.', 'file:.'];
		}
		if ((a === '/' && b === '~' && c !== '/') \|\|
		(a === '~' && b !== '/')) {
		throw error(`invalid file: specifier. '~username' not supported`, { spec });
		}
		if (a === '~') {
		// file://~ => file:~
		// file://~/x => file:~/x
		return /* c8 ignore start */ opts ?
		[
		opts.resolve(opts.homedir(), rest.substring(2)),
		`file:${rest}`,
		]
		: [rest, `file:${rest}`];
		}
		if (a === '/' && b === '~') {
		// file:///~ => file:~
		// file:/~/x => file:~/x
		/* c8 ignore start - tested in test/index.ts */
		return opts ?
		[
		opts.resolve(opts.homedir(), rest.substring(3)),
		`file:${rest.substring(1)}`,
		]
		: /* c8 ignore stop */
		[rest.substring(1), `file:${rest.substring(1)}`];
		}
		if (a === '/' &&
		b === '.' &&
		(c === '/' \|\| (c === '.' && d === '/'))) {
		// file:/./x => file:./x
		// file:///./x => file:./x
		// file:/../x => file:../x
		// file://../x => file:../x
		return [rest.substring(1), `file:${rest.substring(1)}`];
		}
		if (a === '.' && (b === '/' \|\| (b === '.' && c === '/'))) {
		// file://. => file:.
		// file://./x => file:./x
		// file://../x => file:../x
		return [rest, `file:${rest}`];
		}
		if (slashes === '//') {
		// must be valid URI, since we ruled out relative and homedir above
		// not relative, but note that file://host/share is
		// windows-specific and does not work on darwin, so disallow it.
		try {
		const parsed = new URL(bareSpec);
		if (parsed.host) {
		if (parsed.host !== 'localhost') {
		throw error(`invalid file:// specifier. host must be empty or 'localhost'`, {
		spec,
		found: parsed.host,
		validOptions: ['', 'localhost'],
		});
		}
		}
		// normalize blank authority
		// file://X:/foo => file:///X:/foo
		// file://localhost/x => file:///x
		// interpret a `file:///D:/x` as `D:/x` though
		return [
		parsed.pathname.replace(/^\/([a-zA-Z]:\/)/, '$1'),
		`file://${parsed.pathname}`,
		];
		}
		catch (er) {
		// invalid URI for other reasons, eg file://x\u0000y/z
		throw error('invalid file:// specifier', {
		spec,
		cause: er,
		});
		}
		}
		// no //, no authority, be ungovernable
		/* c8 ignore start */
		if (opts?.winPath.isAbsolute(rest)) {
		// file:/absolute => file:///absolute
		// file:/D:/foo => file:///D:/foo
		return [rest, `file://${rest}`];
		}
		/* c8 ignore stop */
		// file:x => file:./x
		return [`./${rest}`, `file:./${rest}`];
		};
		//# sourceMappingURL=browser.js.map

+1

dist/browser.js.map

+8

dist/index.d.ts

		import type { InspectOptions } from 'node:util';
		import type { SpecLike } from './browser.ts';
		import { Spec as BrowserSpec, kCustomInspect } from './browser.ts';
		export * from './browser.ts';
		export declare class Spec extends BrowserSpec implements SpecLike<Spec> {
		[kCustomInspect](_depth?: number, options?: InspectOptions): string;
		}
		//# sourceMappingURL=index.d.ts.map

+1

dist/index.d.ts.map

{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAGlE,cAAc,cAAc,CAAA;AAG5B,qBAAa,IAAK,SAAQ,WAAY,YAAW,QAAQ,CAAC,IAAI,CAAC;IAC7D,CAAC,cAAc,CAAC,CACd,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM;CAWV"}

+23

dist/index.js

		import { homedir } from 'node:os';
		import { isAbsolute, join, resolve, win32 as winPath, } from 'node:path';
		import { inspect } from 'node:util';
		import { Spec as BrowserSpec, kCustomInspect } from "./browser.js";
		// eslint-disable-next-line import/export
		export * from "./browser.js";
		// eslint-disable-next-line import/export
		export class Spec extends BrowserSpec {
		[kCustomInspect](_depth, options) {
		const str = inspect(Object.fromEntries(Object.entries(this).filter(([k, v]) => {
		return k !== 'options' && v !== undefined;
		})), options);
		return `@vltpkg/spec.Spec ${str}`;
		}
		}
		Spec.nodejsDependencies = {
		homedir,
		isAbsolute,
		join,
		resolve,
		winPath,
		};
		//# sourceMappingURL=index.js.map

+1

dist/index.js.map

{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EACL,UAAU,EACV,IAAI,EACJ,OAAO,EACP,KAAK,IAAI,OAAO,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElE,yCAAyC;AACzC,cAAc,cAAc,CAAA;AAE5B,yCAAyC;AACzC,MAAM,OAAO,IAAK,SAAQ,WAAW;IACnC,CAAC,cAAc,CAAC,CACd,MAAe,EACf,OAAwB;QAExB,MAAM,GAAG,GAAG,OAAO,CACjB,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;YACrC,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS,CAAA;QAC3C,CAAC,CAAC,CACH,EACD,OAAO,CACR,CAAA;QACD,OAAO,qBAAqB,GAAG,EAAE,CAAA;IACnC,CAAC;CACF;AAED,IAAI,CAAC,kBAAkB,GAAG;IACxB,OAAO;IACP,UAAU;IACV,IAAI;IACJ,OAAO;IACP,OAAO;CACR,CAAA","sourcesContent":["import { homedir } from 'node:os'\nimport {\n isAbsolute,\n join,\n resolve,\n win32 as winPath,\n} from 'node:path'\nimport { inspect } from 'node:util'\nimport type { InspectOptions } from 'node:util'\nimport type { SpecLike } from './browser.ts'\nimport { Spec as BrowserSpec, kCustomInspect } from './browser.ts'\n\n// eslint-disable-next-line import/export\nexport * from './browser.ts'\n\n// eslint-disable-next-line import/export\nexport class Spec extends BrowserSpec implements SpecLike<Spec> {\n [kCustomInspect](\n _depth?: number,\n options?: InspectOptions,\n ): string {\n const str = inspect(\n Object.fromEntries(\n Object.entries(this).filter(([k, v]) => {\n return k !== 'options' && v !== undefined\n }),\n ),\n options,\n )\n return `@vltpkg/spec.Spec ${str}`\n }\n}\n\nSpec.nodejsDependencies = {\n homedir,\n isAbsolute,\n join,\n resolve,\n winPath,\n}\n"]}

+117

dist/types.d.ts

		import type { Range } from '@vltpkg/semver';
		export type SpecOptions = {
		[k in keyof SpecOptionsFilled]?: SpecOptionsFilled[k];
		};
		export type Scope = `@${string}`;
		export type SpecOptionsFilled = {
		/** the registry where a spec should be resolved against */
		registry: string;
		/** shorthand prefix names for known registries */
		registries: Record<string, string>;
		/** shorthand prefix names for known git hosts */
		'git-hosts': Record<string, string>;
		/** tarball hosting services for hosts listed in git-hosts */
		'git-host-archives': Record<string, string>;
		/** registries mapped to a `@scope` */
		'scope-registries': Record<Scope, string>;
		/** registries that work like https://npm.jsr.io */
		'jsr-registries': Record<string, string>;
		catalog: Record<string, string>;
		catalogs?: Record<string, Record<string, string>>;
		};
		export type GitSelectorParsed = {
		path?: string;
		semver?: string;
		};
		export type SpecType = 'file' \| 'git' \| 'registry' \| 'remote' \| 'workspace' \| 'catalog';
		export type SpecLikeBase = {
		/** the type of spec that this is, ultimately */
		type: SpecType;
		/** the full named specifier passed to the constructor */
		spec: string;
		/** options passed to the constructor, plus defaults */
		options: SpecOptionsFilled;
		/** the name portion, so `foo` in `foo@1.x` */
		name: string;
		/** the name's scope, so `@acme` in `@acme/foo@1.x` */
		scope?: Scope;
		/**
		* if the name is scoped, and there's a registry associated with the scope,
		* then this is that registry
		*/
		scopeRegistry?: string;
		/** just the part AFTER the name, so `1.x` in `foo@1.x` */
		bareSpec: string;
		/** the git remote to fetch from */
		gitRemote?: string;
		/** the committish, semver range, and/or path portion of a git remote */
		gitSelector?: string;
		/**
		* the parsed '::'-separated key/value pairs:
		* `semver:<range>` and `path:<subpath>`
		*/
		gitSelectorParsed?: GitSelectorParsed;
		/** the commit value we will check out */
		gitCommittish?: string;
		/** github, gitlab, bitbucket, gist, etc. */
		namedGitHost?: string;
		/** the path that's parsed when we have a named git host */
		namedGitHostPath?: string;
		/**
		* the specifier when using `workspace:` specs
		* This can be either a semver range, `*`, `~`, or `^`,
		* if the name is not modified. Or, it can include a workspace
		* package name or path, like `workspace:packages/foo@*` or
		* `workspace:@scope/foo@*`.
		*/
		workspaceSpec?: string;
		/**
		* the package name or path of the workspace being referenced
		*/
		workspace?: string;
		/**
		* In specs like `foo@npm:bar@1`, this is the 'npm' part. Other
		* registries can be mapped using the `registries` option.
		*/
		namedRegistry?: string;
		/** registry to consult to resolve this spec */
		registry?: string;
		/** semver range or dist-tag for resolving against a packument */
		registrySpec?: string;
		/**
		* conventional location of the tarball on the registry, if it can be
		* guessed. This is only attempted if the spec is a registry type, with a
		* single version comparator. This can be used to elide resolved urls that
		* are repetitive and predictable.
		*/
		conventionalRegistryTarball?: string;
		/** spec to resolve against available versions */
		semver?: string;
		/** parsed semver range specifier */
		range?: Range;
		/** a dist-tag like 'latest' */
		distTag?: string;
		/**
		* URL to download a tarball from, if it can be determined.
		*
		* This is set for url specs of course, but also git remotes on known
		* hosts that provide a gitHostArchive template.
		*/
		remoteURL?: string;
		/** file path for file:// url specs */
		file?: string;
		/** in `bar@npm:foo@1.x`, this is the spec for `foo@1.x` */
		subspec?: SpecLikeBase;
		/**
		* getter that retrieves the actual spec value to be used
		*/
		final: SpecLikeBase;
		/** Is this a spec that overrides another spec? */
		overridden: boolean;
		toString(): string;
		};
		export type SpecLike<Type extends SpecLikeBase> = SpecLikeBase & {
		subspec?: Type;
		final: Type;
		};
		//# sourceMappingURL=types.d.ts.map

+1

dist/types.d.ts.map

{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

+2

dist/types.js

		export {};
		//# sourceMappingURL=types.js.map

+1

dist/types.js.map

{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Range } from '@vltpkg/semver'\n\nexport type SpecOptions = {\n [k in keyof SpecOptionsFilled]?: SpecOptionsFilled[k]\n}\n\nexport type Scope = `@${string}`\n\nexport type SpecOptionsFilled = {\n /** the registry where a spec should be resolved against */\n registry: string\n /** shorthand prefix names for known registries */\n registries: Record<string, string>\n /** shorthand prefix names for known git hosts */\n 'git-hosts': Record<string, string>\n /** tarball hosting services for hosts listed in git-hosts */\n 'git-host-archives': Record<string, string>\n /** registries mapped to a `@scope` */\n 'scope-registries': Record<Scope, string>\n /** registries that work like https://npm.jsr.io */\n 'jsr-registries': Record<string, string>\n catalog: Record<string, string>\n catalogs?: Record<string, Record<string, string>>\n}\n\nexport type GitSelectorParsed = {\n path?: string\n semver?: string\n}\n\nexport type SpecType =\n | 'file'\n | 'git'\n | 'registry'\n | 'remote'\n | 'workspace'\n | 'catalog'\n\nexport type SpecLikeBase = {\n /** the type of spec that this is, ultimately */\n type: SpecType\n\n /** the full named specifier passed to the constructor */\n spec: string\n\n /** options passed to the constructor, plus defaults */\n options: SpecOptionsFilled\n\n /** the name portion, so `foo` in `foo@1.x` */\n name: string\n\n /** the name's scope, so `@acme` in `@acme/foo@1.x` */\n scope?: Scope\n\n /**\n * if the name is scoped, and there's a registry associated with the scope,\n * then this is that registry\n */\n scopeRegistry?: string\n\n /** just the part AFTER the name, so `1.x` in `foo@1.x` */\n bareSpec: string\n\n /** the git remote to fetch from */\n gitRemote?: string\n\n /** the committish, semver range, and/or path portion of a git remote */\n gitSelector?: string\n /**\n * the parsed '::'-separated key/value pairs:\n * `semver:<range>` and `path:<subpath>`\n */\n gitSelectorParsed?: GitSelectorParsed\n /** the commit value we will check out */\n gitCommittish?: string\n /** github, gitlab, bitbucket, gist, etc. */\n namedGitHost?: string\n /** the path that's parsed when we have a named git host */\n namedGitHostPath?: string\n\n /**\n * the specifier when using `workspace:` specs\n * This can be either a semver range, `*`, `~`, or `^`,\n * if the name is not modified. Or, it can include a workspace\n * package name or path, like `workspace:packages/foo@*` or\n * `workspace:@scope/foo@*`.\n */\n workspaceSpec?: string\n\n /**\n * the package name or path of the workspace being referenced\n */\n workspace?: string\n\n /**\n * In specs like `foo@npm:bar@1`, this is the 'npm' part. Other\n * registries can be mapped using the `registries` option.\n */\n namedRegistry?: string\n\n /** registry to consult to resolve this spec */\n registry?: string\n\n /** semver range or dist-tag for resolving against a packument */\n registrySpec?: string\n\n /**\n * conventional location of the tarball on the registry, if it can be\n * guessed. This is only attempted if the spec is a registry type, with a\n * single version comparator. This can be used to elide resolved urls that\n * are repetitive and predictable.\n */\n conventionalRegistryTarball?: string\n\n /** spec to resolve against available versions */\n semver?: string\n\n /** parsed semver range specifier */\n range?: Range\n\n /** a dist-tag like 'latest' */\n distTag?: string\n\n /**\n * URL to download a tarball from, if it can be determined.\n *\n * This is set for url specs of course, but also git remotes on known\n * hosts that provide a gitHostArchive template.\n */\n remoteURL?: string\n\n /** file path for file:// url specs */\n file?: string\n\n /** in `bar@npm:foo@1.x`, this is the spec for `foo@1.x` */\n subspec?: SpecLikeBase\n /**\n * getter that retrieves the actual spec value to be used\n */\n final: SpecLikeBase\n /** Is this a spec that overrides another spec? */\n overridden: boolean\n\n toString(): string\n}\n\nexport type SpecLike<Type extends SpecLikeBase> = SpecLikeBase & {\n subspec?: Type\n final: Type\n}\n"]}

+6

-22

package.json

		{
		"name": "@vltpkg/spec",
		"description": "Package specifier library",
		"version": "1.0.0-rc.10",
		"version": "1.0.0-rc.11",
		"repository": {
		@@ -11,17 +11,5 @@ "type": "git",
		"author": "vlt technology inc. <support@vlt.sh> (http://vlt.sh)",
		"tshy": {
		"selfLink": false,
		"liveDev": true,
		"dialects": [
		"esm"
		],
		"exports": {
		"./package.json": "./package.json",
		".": "./src/index.ts",
		"./browser": "./src/browser.ts"
		}
		},
		"dependencies": {
		"@vltpkg/error-cause": "1.0.0-rc.10",
		"@vltpkg/semver": "1.0.0-rc.10"
		"@vltpkg/error-cause": "1.0.0-rc.11",
		"@vltpkg/semver": "1.0.0-rc.11"
		},
		@@ -36,3 +24,2 @@ "devDependencies": {
		"tap": "^21.5.0",
		"tshy": "^3.1.0",
		"typedoc": "~0.27.9",
		@@ -51,3 +38,3 @@ "typescript": "5.7.3",
		"prettier": "../../.prettierrc.js",
		"module": "./dist/esm/index.js",
		"module": "./dist/index.js",
		"type": "module",
		@@ -58,4 +45,3 @@ "exports": {
		"import": {
		"types": "./dist/esm/index.d.ts",
		"default": "./dist/esm/index.js"
		"default": "./dist/index.js"
		}
		@@ -65,4 +51,3 @@ },
		"import": {
		"types": "./dist/esm/browser.d.ts",
		"default": "./dist/esm/browser.js"
		"default": "./dist/browser.js"
		}
		@@ -83,5 +68,4 @@ }
		"posttest": "tsc --noEmit",
		"tshy": "tshy",
		"typecheck": "tsc --noEmit"
		}
		}

-131

dist/esm/browser.d.ts

		import type { Range } from '@vltpkg/semver';
		import type { GitSelectorParsed, Scope, SpecLike, SpecOptions, SpecOptionsFilled, SpecType } from './types.ts';
		export * from './types.ts';
		export declare const kCustomInspect: unique symbol;
		export declare const defaultRegistry = "https://registry.npmjs.org/";
		export declare const defaultRegistryName = "npm";
		export declare const defaultRegistries: {
		npm: string;
		gh: string;
		};
		export declare const defaultJsrRegistries: {
		jsr: string;
		};
		export declare const defaultGitHosts: {
		github: string;
		bitbucket: string;
		gitlab: string;
		gist: string;
		};
		export declare const defaultGitHostArchives: {
		github: string;
		bitbucket: string;
		gist: string;
		gitlab: string;
		};
		/**
		* These are just for legacy support of urls that are supported by npm
		* and observed in the wild.
		*
		* Not configurable, because no more will be added. If you wish to define
		* custom git hosts, use it with the `'git-hosts'` and `'git-host-archives'`
		* options.
		*/
		export declare const gitHostWebsites: {
		github: string;
		bitbucket: string;
		gist: string;
		gitlab: string;
		};
		export declare const defaultScopeRegistries: {
		'@jsr': string;
		};
		export declare const getOptions: (options?: SpecOptions) => SpecOptionsFilled;
		/**
		* Injects the Node.js dependencies into the Spec class.
		*/
		export type NodeJSDependenciesOptions = {
		homedir: typeof import('os').homedir;
		isAbsolute: typeof import('node:path').isAbsolute;
		join: typeof import('node:path').join;
		resolve: typeof import('node:path').resolve;
		winPath: typeof import('node:path').win32;
		};
		export declare const isSpec: (spec: unknown) => spec is Spec;
		/**
		* Retrieves the short configured name of the default registry if one
		* is available.
		*/
		export declare const currentDefaultRegistryName: (registry: string, options: SpecOptions) => string \| undefined;
		/**
		* The base, isomorphic Spec implementation.
		*/
		export declare class Spec implements SpecLike<Spec> {
		#private;
		/**
		* Create a Spec object from a full spec, name+bareSpec, or Spec object
		*
		* Note: If a Spec object is provided, it is returned as-is, without
		* investigating whether the options match.
		*/
		static parse(name: string, bareSpec: string, options?: SpecOptions): Spec;
		static parse(spec: string, options?: SpecOptions): Spec;
		static parse(spec: Spec, options?: SpecOptions): Spec;
		static parseArgs(specOrBareSpec: string, opts?: SpecOptions): Spec;
		static nodejsDependencies?: NodeJSDependenciesOptions;
		type: SpecType;
		spec: string;
		options: SpecOptionsFilled;
		name: string;
		scope?: Scope;
		scopeRegistry?: string;
		bareSpec: string;
		gitRemote?: string;
		gitSelector?: string;
		gitSelectorParsed?: GitSelectorParsed;
		gitCommittish?: string;
		namedGitHost?: string;
		namedGitHostPath?: string;
		workspaceSpec?: string;
		workspace?: string;
		namedRegistry?: string;
		namedJsrRegistry?: string;
		registry?: string;
		registrySpec?: string;
		conventionalRegistryTarball?: string;
		semver?: string;
		range?: Range;
		distTag?: string;
		remoteURL?: string;
		file?: string;
		catalog?: string;
		subspec?: Spec;
		overridden: boolean;
		/**
		* Return the final entry in the chain of subspecs
		* When deciding which thing to actually fetch, spec.final is the thing
		* to look at.
		*/
		get final(): Spec & {
		type: Exclude<SpecType, 'catalog'>;
		};
		/**
		* Normally, the string value of a Spec is just the string passed in to
		* be parsed. However, in the case of a chain of subspecs, like
		* `foo@npm:bar@npm:baz@npm:quux@latest`, this simplifies out the middle
		* parts of the chain, returning just `foo@npm:quux@latest`
		*/
		toString(): string;
		['constructor']: typeof Spec;
		constructor(name: string, bareSpec: string, options?: SpecOptions);
		constructor(spec: string, options?: SpecOptions);
		constructor(spec: Spec \| string, bareOrOptions?: SpecOptions \| string, options?: SpecOptions);
		[kCustomInspect](): string;
		/**
		* Should only ever be called with the bit that comes AFTER the #
		* in the git remote url.
		*/
		static parseGitSelector(selector: string, spec?: Spec): [parsed: GitSelectorParsed, committish?: string, range?: Range];
		}
		export declare const getNormalizeFile: (opts?: NodeJSDependenciesOptions) => (bareSpec: string, spec: Spec) => [path: string, uri: string];
		//# sourceMappingURL=browser.d.ts.map

-1

dist/esm/browser.d.ts.map

{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"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"}

-799

dist/esm/browser.js

		import { error, typeError } from '@vltpkg/error-cause';
		import { parseRange } from '@vltpkg/semver';
		export * from "./types.js";
		export const kCustomInspect = Symbol.for('nodejs.util.inspect.custom');
		export const defaultRegistry = 'https://registry.npmjs.org/';
		export const defaultRegistryName = 'npm';
		export const defaultRegistries = {
		npm: defaultRegistry,
		gh: 'https://npm.pkg.github.com/',
		};
		export const defaultJsrRegistries = { jsr: 'https://npm.jsr.io/' };
		export const defaultGitHosts = {
		github: 'git+ssh://git@github.com:$1/$2.git',
		bitbucket: 'git+ssh://git@bitbucket.org:$1/$2.git',
		gitlab: 'git+ssh://git@gitlab.com:$1/$2.git',
		gist: 'git+ssh://git@gist.github.com/$1.git',
		};
		export const defaultGitHostArchives = {
		github: 'https://api.github.com/repos/$1/$2/tarball/$committish',
		bitbucket: 'https://bitbucket.org/$1/$2/get/$committish.tar.gz',
		gist: 'https://codeload.github.com/gist/$1/tar.gz/$committish',
		gitlab: 'https://gitlab.com/$1/$2/repository/archive.tar.gz?ref=$committish',
		};
		/**
		* These are just for legacy support of urls that are supported by npm
		* and observed in the wild.
		*
		* Not configurable, because no more will be added. If you wish to define
		* custom git hosts, use it with the `'git-hosts'` and `'git-host-archives'`
		* options.
		*/
		export const gitHostWebsites = {
		github: 'https://github.com/',
		bitbucket: 'https://bitbucket.org/',
		gist: 'https://gist.github.com/',
		gitlab: 'https://gitlab.com/',
		};
		export const defaultScopeRegistries = {
		'@jsr': 'https://npm.jsr.io/',
		};
		export const getOptions = (options) => ({
		catalog: {},
		catalogs: {},
		...options,
		'jsr-registries': {
		...(options?.['jsr-registries'] ?? {}),
		...defaultJsrRegistries,
		},
		registry: options?.registry ?? defaultRegistry,
		'scope-registries': options?.['scope-registries'] ?? {},
		'git-hosts': options?.['git-hosts'] ?
		{
		...defaultGitHosts,
		...options['git-hosts'],
		}
		: defaultGitHosts,
		registries: {
		...(options?.registries ?? {}),
		...defaultRegistries,
		},
		'git-host-archives': options?.['git-host-archives'] ?
		{
		...defaultGitHostArchives,
		...options['git-host-archives'],
		}
		: defaultGitHostArchives,
		});
		/**
		* Various nameless scenarios that are handled in the
		* standard spec parsing and should return an unknown name.
		*
		* Returns `true` if the name can not be inferred, `false` otherwise.
		*/
		const startsWithSpecIdentifier = (spec, options) => spec.startsWith('/') \|\|
		spec.startsWith('./') \|\|
		spec.startsWith('../') \|\|
		spec.startsWith('file:') \|\|
		spec.startsWith('http:') \|\|
		spec.startsWith('https:') \|\|
		spec.startsWith('workspace:') \|\|
		spec.startsWith('catalog:') \|\|
		spec.startsWith('git@') \|\|
		spec.startsWith('git://') \|\|
		spec.startsWith('git+ssh://') \|\|
		spec.startsWith('git+http://') \|\|
		spec.startsWith('git+https://') \|\|
		spec.startsWith('git+file://') \|\|
		spec.startsWith('git@github.com') \|\|
		spec.startsWith('registry:') \|\|
		spec.startsWith('npm:') \|\|
		spec.startsWith('jsr:') \|\|
		spec.startsWith('gh:') \|\|
		// anything that starts with a known git host key, or a
		// custom registered registry protocol e.g: `github:`, `custom:`
		[
		...Object.keys(options['git-hosts']),
		...Object.keys(options.registries),
		...Object.keys(options['jsr-registries']),
		].some(key => spec.startsWith(`${key}:`));
		/**
		* Returns the location in which the first `@` value is found in a given
		* string, also takes into account that a string starting with @ is
		* using a scoped-name.
		*/
		const findFirstAt = (spec, hasScope) => spec.indexOf('@', hasScope ? 1 : 0);
		/**
		* Return `true` if a given spec string is likely to be a git spec.
		*/
		const findGitIdentifier = (spec) => spec.indexOf('#') > 2;
		/**
		* Return `true` if a given spec string is likely to be a file spec.
		*/
		const findFileIdentifier = (spec) => spec.includes('/');
		export const isSpec = (spec) => typeof spec === 'object' &&
		spec !== null &&
		'spec' in spec &&
		'bareSpec' in spec &&
		'name' in spec &&
		'type' in spec &&
		'options' in spec &&
		typeof spec.spec === 'string' &&
		typeof spec.bareSpec === 'string' &&
		typeof spec.name === 'string';
		/**
		* Retrieves the short configured name of the default registry if one
		* is available.
		*/
		export const currentDefaultRegistryName = (registry, options) => {
		for (const [name, url] of Object.entries(options.registries /* c8 ignore next */ ?? {})) {
		const specRegURL = registry.endsWith('/') ? registry : registry + '/';
		const knownRegURL = url.endsWith('/') ? url : url + '/';
		if (specRegURL === knownRegURL) {
		return name;
		}
		}
		};
		/**
		* The base, isomorphic Spec implementation.
		*/
		export class Spec {
		static parse(spec, bareOrOptions, options) {
		return typeof spec === 'object' ? spec : (new this(spec, bareOrOptions, options));
		}
		static parseArgs(specOrBareSpec, opts) {
		const options = getOptions(opts ?? {});
		if (startsWithSpecIdentifier(specOrBareSpec, options)) {
		const parsed = this.parse('(unknown)', specOrBareSpec, options);
		// try to look into a potential parsed subspec for a name
		if (parsed.subspec) {
		const { namedJsrRegistry: jsrHost } = parsed;
		if (!jsrHost) {
		parsed.name = parsed.subspec.name;
		}
		parsed.spec = `${parsed.name}@${parsed.bareSpec}`;
		}
		return parsed;
		}
		else {
		const hasScope = specOrBareSpec.startsWith('@');
		const at = findFirstAt(specOrBareSpec, hasScope);
		if (at > -1) {
		return this.parse(specOrBareSpec.substring(0, at), specOrBareSpec.substring(at + 1), options);
		}
		else if (findGitIdentifier(specOrBareSpec) \|\|
		(!hasScope && findFileIdentifier(specOrBareSpec))) {
		return this.parse('(unknown)', specOrBareSpec, options);
		}
		else {
		// doesn't have an @, so it's just a name with no version
		return this.parse(`${specOrBareSpec}@`, options);
		}
		}
		}
		static nodejsDependencies;
		type;
		spec;
		options;
		name;
		scope;
		scopeRegistry;
		bareSpec;
		gitRemote;
		gitSelector;
		gitSelectorParsed;
		gitCommittish;
		namedGitHost;
		namedGitHostPath;
		workspaceSpec;
		workspace;
		namedRegistry;
		namedJsrRegistry;
		registry;
		registrySpec;
		conventionalRegistryTarball;
		semver;
		range;
		distTag;
		remoteURL;
		file;
		catalog;
		subspec;
		overridden = false;
		#final;
		#toString;
		/**
		* Return the final entry in the chain of subspecs
		* When deciding which thing to actually fetch, spec.final is the thing
		* to look at.
		*/
		get final() {
		if (this.#final)
		return this.#final;
		const final = this.subspec ? this.subspec.final : this;
		/* c8 ignore start - impossible */
		if (final.type === 'catalog') {
		throw error('invalid Spec.final value, type is "catalog"');
		}
		/* c8 ignore stop */
		return (this.#final = final);
		}
		/**
		* Normally, the string value of a Spec is just the string passed in to
		* be parsed. However, in the case of a chain of subspecs, like
		* `foo@npm:bar@npm:baz@npm:quux@latest`, this simplifies out the middle
		* parts of the chain, returning just `foo@npm:quux@latest`
		*/
		toString() {
		if (this.#toString !== undefined)
		return this.#toString;
		let sub = this;
		// we want the SECOND from the last in the chain
		while (sub.subspec?.subspec)
		sub = sub.subspec;
		if (sub.subspec && sub.subspec.type !== 'registry')
		sub = sub.subspec;
		return (this.#toString = this.name + '@' + sub.bareSpec);
		}
		constructor(spec, bareOrOptions, options = {}) {
		if (bareOrOptions && typeof bareOrOptions === 'object') {
		options = bareOrOptions;
		bareOrOptions = undefined;
		}
		this.options = getOptions(options);
		if (typeof bareOrOptions === 'string') {
		this.name = spec;
		this.#parseScope(spec);
		this.bareSpec = bareOrOptions;
		this.spec = `${this.name}@${bareOrOptions}`;
		}
		else {
		this.spec = spec;
		// Check if this spec starts with a known registry identifier
		// but exclude git specs like 'git@github:a/b'
		if (!spec.startsWith('git@') &&
		startsWithSpecIdentifier(spec, this.options) &&
		spec.includes(':') &&
		[
		...Object.keys(this.options.registries),
		...Object.keys(defaultRegistries),
		].some(key => spec.startsWith(`${key}:`))) {
		// For specs like 'gh:@octocat/hello-world@1.0.0', don't split at the @
		// Instead, set a temporary name and let the registry logic handle it
		this.name = spec;
		this.bareSpec = spec;
		}
		else {
		const hasScope = spec.startsWith('@');
		let at = findFirstAt(spec, hasScope);
		if (at === -1) {
		// assume that an unadorned spec is just a name at the default
		// registry
		at = spec.length;
		spec += '@';
		}
		this.name = spec.substring(0, at);
		if (hasScope)
		this.#parseScope(this.name);
		this.bareSpec = spec.substring(at + 1);
		}
		}
		if (this.bareSpec.startsWith('catalog:')) {
		this.catalog = this.bareSpec.substring('catalog:'.length);
		const catalog = this.catalog ?
		this.options.catalogs?.[this.catalog]
		: this.options.catalog;
		if (!catalog) {
		throw this.#error('Named catalog not found', {
		name: this.catalog,
		validOptions: this.options.catalogs &&
		Object.keys(this.options.catalogs),
		});
		}
		const sub = catalog[this.name];
		if (!sub) {
		throw this.#error('Name not found in catalog', {
		name: this.name,
		validOptions: Object.keys(catalog),
		});
		}
		this.subspec = Spec.parse(this.name, sub);
		this.type = 'catalog';
		return;
		}
		// legacy affordance: allow project urls like
		// 'https://github.com/user/project#commitish' because npm suports it and
		// this pattern is observed in the wild.
		if (this.bareSpec.startsWith('https://')) {
		for (const [name, origin] of Object.entries(gitHostWebsites)) {
		if (this.bareSpec.startsWith(origin)) {
		const parsed = new URL(this.bareSpec);
		const [user, project] = parsed.pathname
		.replace(/\.git$/, '')
		.replace(/\/+/g, ' ')
		.trim()
		.split(' ');
		if (user && project) {
		this.bareSpec = `${name}:${user}/${project}${parsed.hash}`;
		this.spec = `${this.name}@${this.bareSpec}`;
		break;
		}
		}
		}
		}
		if (this.bareSpec.startsWith('workspace:')) {
		this.type = 'workspace';
		const ws = this.bareSpec.substring('workspace:'.length).trim();
		const w = ws.lastIndexOf('@');
		if (w === -1) {
		this.workspace = this.name;
		}
		else {
		const wsName = ws.substring(0, w);
		if (!wsName \|\|
		wsName === '*' \|\|
		wsName === '~' \|\|
		wsName === '^' \|\|
		(wsName.startsWith('@') ?
		wsName.split('/').length !== 2 \|\|
		wsName.substring(1).includes('@')
		: wsName.includes('@'))) {
		throw this.#error('workspace: name must be a path or valid package name', { found: wsName });
		}
		this.workspace = wsName;
		}
		// workspace: is the same as workspace:*
		const wss = w === -1 ? ws : ws.substring(w + 1) \|\| '*';
		const range = wss === '*' ? undefined : parseRange(wss);
		if (wss !== '*' && wss !== '~' && wss !== '^' && !range) {
		throw this.#error('workspace: spec must be one of *, ~, or ^, or a valid semver range', {
		found: wss,
		wanted: `'*'\|'~'\|'^'\|SemverRange`,
		});
		}
		this.workspaceSpec = wss;
		if (range) {
		this.semver = wss;
		this.range = range;
		}
		return;
		}
		if (this.bareSpec.startsWith('git://') \|\|
		this.bareSpec.startsWith('git+ssh://') \|\|
		this.bareSpec.startsWith('git+http://') \|\|
		this.bareSpec.startsWith('git+https://') \|\|
		this.bareSpec.startsWith('git+file://') \|\|
		// legacy affordance
		this.bareSpec.startsWith('git@github.com')) {
		if (this.bareSpec.startsWith('git@')) {
		this.bareSpec = `git+ssh://${this.bareSpec}`;
		this.spec = `${this.name}@${this.bareSpec}`;
		}
		this.type = 'git';
		// see if it's one of the known named hosts, and if so, prefer
		// the shorter syntax.
		for (const [name, host] of Object.entries(this.options['git-hosts'])) {
		const s = host.indexOf('$');
		if (s > 0 && this.bareSpec.startsWith(host.substring(0, s))) {
		const p = this.bareSpec
		.substring(s)
		.replace(/\.git(#.*)?$/, '$1');
		this.bareSpec = `${name}:${p}`;
		this.spec = `${this.name}@${this.bareSpec}`;
		this.#parseHostedGit(name, host);
		this.type = 'git';
		return;
		}
		}
		this.#parseGitSelector(this.bareSpec);
		return;
		}
		// Check registries before git hosts to avoid conflicts
		const regs = Object.entries(this.options.registries);
		if (this.bareSpec.startsWith('registry:')) {
		const reg = this.bareSpec.substring('registry:'.length);
		const h = reg.indexOf('#');
		if (h === -1) {
		throw this.#error('registry: must include name/version');
		}
		this.type = 'registry';
		let url = reg.substring(0, h);
		if (!url.endsWith('/'))
		url += '/';
		const regSpec = reg.substring(h + 1);
		for (let [name, u] of regs) {
		if (!u.endsWith('/')) {
		u += '/';
		this.options.registries[name] = u;
		}
		if (u === url)
		this.namedRegistry = name;
		}
		this.#parseRegistrySpec(regSpec, url);
		this.#guessRegistryTarball();
		return;
		}
		for (const [host, url] of regs) {
		const h = `${host}:`;
		if (this.bareSpec.startsWith(h)) {
		this.type = 'registry';
		this.namedRegistry = host;
		this.#parseRegistrySpec(this.bareSpec.substring(h.length), url).namedRegistry ??= host;
		// If we parsed a spec identifier, update the name and spec format
		if (this.subspec && this.name === this.bareSpec) {
		this.name = this.subspec.name;
		this.spec = `${this.name}@${this.bareSpec}`;
		}
		this.#guessRegistryTarball();
		return;
		}
		}
		// spooky
		const ghosts = Object.entries(this.options['git-hosts']);
		for (const [name, template] of ghosts) {
		if (this.#parseHostedGit(name, template)) {
		this.type = 'git';
		return;
		}
		}
		const jsrs = Object.entries(this.options['jsr-registries']);
		for (const [host, url] of jsrs) {
		const h = `${host}:`;
		if (this.bareSpec.startsWith(h)) {
		this.type = 'registry';
		this.namedJsrRegistry = host;
		this.#parseJsrRegistrySpec(this.bareSpec.substring(h.length), url).namedJsrRegistry ??= host;
		return;
		}
		}
		if (this.bareSpec.startsWith('https://') \|\|
		this.bareSpec.startsWith('http://')) {
		this.remoteURL = this.bareSpec;
		this.type = 'remote';
		return;
		}
		// explicit file: url
		if (this.bareSpec.startsWith('file:')) {
		this.type = 'file';
		const [path, uri] = getNormalizeFile(this.constructor.nodejsDependencies)(this.bareSpec, this);
		this.file = path;
		this.bareSpec = uri.replace(/\/+$/, '');
		this.spec = `${this.name}@${this.bareSpec}`;
		return;
		}
		// legacy! once upon a time, `user/project` was a shorthand for pulling
		// packages from github, instead of the more verbose and explicit
		// `github:user/project`.
		if (!this.bareSpec.startsWith('./') &&
		!this.bareSpec.startsWith('../') &&
		this.options['git-hosts'].github) {
		const hash = this.bareSpec.indexOf('#');
		const up = hash === -1 ? this.bareSpec : this.bareSpec.substring(0, hash);
		if (up.split('/').length === 2) {
		this.bareSpec = `github:${this.bareSpec}`;
		this.spec = `${this.name}@${this.bareSpec}`;
		this.#parseHostedGit('github', this.options['git-hosts'].github);
		this.type = 'git';
		return;
		}
		}
		// if it contains a / and isn't picked up in the github shorthand,
		// then convert to file: specifier
		if (this.bareSpec.includes('/') \|\|
		this.bareSpec === '.' \|\|
		this.bareSpec === '..') {
		this.type = 'file';
		const [file, uri] = getNormalizeFile(this.constructor.nodejsDependencies)(`file:${this.bareSpec}`, this);
		this.bareSpec = uri;
		this.spec = `${this.name}@${this.bareSpec}`;
		this.file = file;
		return;
		}
		// at this point, must be either semver range or dist-tag
		this.type = 'registry';
		const range = parseRange(this.bareSpec);
		if (range) {
		this.semver = this.bareSpec.trim();
		this.range = range;
		}
		else {
		this.distTag = this.bareSpec;
		}
		this.registrySpec = this.bareSpec;
		const { 'scope-registries': scopeRegs, registry } = this.options;
		const scopeReg = this.scope && scopeRegs[this.scope];
		this.registry = scopeReg ?? registry;
		// no guessing the tarball for JSR registries
		for (const r of Object.values(this.options['jsr-registries'])) {
		if (this.registry === r)
		return;
		}
		this.#guessRegistryTarball();
		}
		#parseScope(name) {
		if (!name.startsWith('@'))
		return;
		const s = name.indexOf('/');
		if (s > 1 && s < name.length - 1) {
		const scope = name.substring(0, s);
		this.registry = this.scopeRegistry =
		this.options['scope-registries'][scope];
		this.scope = scope;
		}
		}
		#parseHostedGit(name, template) {
		if (this.bareSpec.startsWith(`${name}:`)) {
		const h = this.bareSpec.indexOf('#');
		const bare = h === -1 ? this.bareSpec : this.bareSpec.substring(0, h);
		const hash = h === -1 ? '' : this.bareSpec.substring(h);
		const hostPath = bare.substring(name.length + 1);
		if (!hostPath) {
		throw this.#error('invalid named git host specifier');
		}
		const split = hostPath.split('/');
		let t = template;
		for (let i = 0; i < split.length; i++) {
		t = t.split(`$${i + 1}`).join(split[i]);
		}
		t += hash;
		this.namedGitHost = name;
		this.namedGitHostPath = hostPath;
		this.#parseGitSelector(t);
		if (this.gitCommittish && !this.gitSelectorParsed?.path) {
		const archiveHost = this.options['git-host-archives'][name];
		if (name === 'github' &&
		this.gitCommittish.startsWith('pull/') &&
		this.gitCommittish.match(/\//g)?.length === 1) {
		this.gitCommittish += '/head';
		}
		if (archiveHost) {
		this.type = 'remote';
		let t = archiveHost;
		t = t.split('$committish').join(this.gitCommittish);
		for (let i = 0; i < split.length; i++) {
		t = t.split(`$${i + 1}`).join(split[i]);
		}
		this.remoteURL = t;
		}
		}
		return true;
		}
		return false;
		}
		/* c8 ignore start */
		[kCustomInspect]() {
		return `@vltpkg/spec.Spec ${String(this)}`;
		}
		/* c8 ignore stop */
		#guessRegistryTarball() {
		// only try to guess if it's a single comparator for a single version
		const { name, registry, range } = this.final;
		if (!registry \|\| !range?.isSingle)
		return;
		const stripScope = /^@[^/]+\//;
		this.conventionalRegistryTarball = String(new URL(`/${name}/-/${name.replace(stripScope, '')}-${range}.tgz`, registry));
		}
		#parseRegistrySpec(s, url) {
		// note: this takes priority over the scoped registry, if set
		this.registry = url;
		this.subspec = this.constructor.parse(s, {
		...this.options,
		registry: url,
		});
		return this.subspec;
		}
		#parseJsrRegistrySpec(s, url) {
		this.registry = url;
		// @luca/cases@jsr:1.x
		if (!s.startsWith('@'))
		s = `${this.name}@${s}`;
		const name = `@jsr/${s.replace(/^@/, '').replace(/\//, '__')}`;
		this.subspec = this.constructor.parse(name, {
		...this.options,
		'scope-registries': {
		...this.options['scope-registries'],
		'@jsr': url,
		},
		});
		if (this.name === '(unknown)') {
		const nextAt = s.indexOf('@', 1);
		if (nextAt === -1) {
		this.name = s;
		}
		else {
		this.name = s.substring(0, s.indexOf('@', 1));
		}
		}
		const reg = `${this.namedJsrRegistry}:`;
		const n = `${reg}${this.name}`;
		if (this.bareSpec.startsWith(n + '@')) {
		this.bareSpec = reg + this.bareSpec.substring(n.length + 1);
		}
		else if (this.bareSpec === n) {
		this.bareSpec = reg;
		}
		this.spec = this.name + '@' + this.bareSpec;
		return this.subspec;
		}
		#error(message, extra = {}) {
		return error(message, { spec: this.spec, ...extra }, this.#error);
		}
		#parseGitSelector(s) {
		const h = s.indexOf('#');
		if (h === -1) {
		this.gitRemote = s;
		return;
		}
		this.gitRemote = s.substring(0, h);
		this.gitSelector = s.substring(h + 1);
		const [selectorParsed, committish, range] = this.constructor.parseGitSelector(this.gitSelector, this);
		this.range = range;
		this.gitCommittish = committish;
		this.gitSelectorParsed = selectorParsed;
		}
		/**
		* Should only ever be called with the bit that comes AFTER the #
		* in the git remote url.
		*/
		static parseGitSelector(selector, spec) {
		if (!selector)
		return [{}];
		const split = selector.split('::');
		const first = split[0];
		let committish = undefined;
		let range = undefined;
		const parsed = {};
		/* c8 ignore start - for TS's benefit */
		if (typeof first !== 'string') {
		throw typeError('impossible', {
		found: first,
		wanted: String,
		});
		}
		/* c8 ignore stop */
		if (!first.includes(':')) {
		committish = first;
		split.shift();
		}
		for (const kv of split) {
		const c = kv.indexOf(':');
		/* c8 ignore next */
		if (c === -1)
		continue;
		const k = kv.substring(0, c);
		const v = kv.substring(c + 1);
		if (k === 'semver') {
		if (committish) {
		throw error('Cannot specify a semver range and committish value', { spec });
		}
		range = parseRange(v);
		if (!range) {
		throw error(`Invalid git tag semver range: ${v}`, { spec });
		}
		}
		if (k === 'semver' \|\| k === 'path') {
		if (k === 'path') {
		if (
		/* c8 ignore next */ this.nodejsDependencies?.isAbsolute(v) \|\|
		/(^\|\/\|\\)\.\.($\|\\\|\/)/.test(v)) {
		throw error('Invalid path in git selector', { spec });
		}
		// normalize
		/* c8 ignore start */
		parsed.path = (this.nodejsDependencies ?
		this.nodejsDependencies.join('/', v).substring(1)
		: v).replace(/\\/g, '/');
		/* c8 ignore stop */
		}
		else {
		parsed[k] = v;
		}
		}
		}
		return [parsed, committish, range];
		}
		}
		// normalize our kinda-sorta spec compliant `file:` specifiers
		//
		// For historical reasons, we need to support a lot of non-spec-compliant
		// behaviors, but this massages the result into a slightly less offensive
		// shape.
		//
		// The result will be either a fully compliant `file://` with an absolute path,
		// or a `file:` with a relative path starting with `~`, `./`, or `../`.
		export const getNormalizeFile = (opts) => (bareSpec, spec) => {
		const slashes = bareSpec.substring('file:'.length, 'file://'.length);
		const pref = `file:${slashes === '//' ? slashes : ''}`;
		const rest = bareSpec.substring(pref.length);
		// default to '/' because eol == '/' for parsing purposes
		const [a = '', b = '/', c = '/', d = '/'] = rest.split('', 4);
		if (!a) {
		// file:// => file:.
		// file: => file:.
		return ['.', 'file:.'];
		}
		if ((a === '/' && b === '~' && c !== '/') \|\|
		(a === '~' && b !== '/')) {
		throw error(`invalid file: specifier. '~username' not supported`, { spec });
		}
		if (a === '~') {
		// file://~ => file:~
		// file://~/x => file:~/x
		return /* c8 ignore start */ opts ?
		[
		opts.resolve(opts.homedir(), rest.substring(2)),
		`file:${rest}`,
		]
		: [rest, `file:${rest}`];
		}
		if (a === '/' && b === '~') {
		// file:///~ => file:~
		// file:/~/x => file:~/x
		/* c8 ignore start - tested in test/index.ts */
		return opts ?
		[
		opts.resolve(opts.homedir(), rest.substring(3)),
		`file:${rest.substring(1)}`,
		]
		: /* c8 ignore stop */
		[rest.substring(1), `file:${rest.substring(1)}`];
		}
		if (a === '/' &&
		b === '.' &&
		(c === '/' \|\| (c === '.' && d === '/'))) {
		// file:/./x => file:./x
		// file:///./x => file:./x
		// file:/../x => file:../x
		// file://../x => file:../x
		return [rest.substring(1), `file:${rest.substring(1)}`];
		}
		if (a === '.' && (b === '/' \|\| (b === '.' && c === '/'))) {
		// file://. => file:.
		// file://./x => file:./x
		// file://../x => file:../x
		return [rest, `file:${rest}`];
		}
		if (slashes === '//') {
		// must be valid URI, since we ruled out relative and homedir above
		// not relative, but note that file://host/share is
		// windows-specific and does not work on darwin, so disallow it.
		try {
		const parsed = new URL(bareSpec);
		if (parsed.host) {
		if (parsed.host !== 'localhost') {
		throw error(`invalid file:// specifier. host must be empty or 'localhost'`, {
		spec,
		found: parsed.host,
		validOptions: ['', 'localhost'],
		});
		}
		}
		// normalize blank authority
		// file://X:/foo => file:///X:/foo
		// file://localhost/x => file:///x
		// interpret a `file:///D:/x` as `D:/x` though
		return [
		parsed.pathname.replace(/^\/([a-zA-Z]:\/)/, '$1'),
		`file://${parsed.pathname}`,
		];
		}
		catch (er) {
		// invalid URI for other reasons, eg file://x\u0000y/z
		throw error('invalid file:// specifier', {
		spec,
		cause: er,
		});
		}
		}
		// no //, no authority, be ungovernable
		/* c8 ignore start */
		if (opts?.winPath.isAbsolute(rest)) {
		// file:/absolute => file:///absolute
		// file:/D:/foo => file:///D:/foo
		return [rest, `file://${rest}`];
		}
		/* c8 ignore stop */
		// file:x => file:./x
		return [`./${rest}`, `file:./${rest}`];
		};
		//# sourceMappingURL=browser.js.map

-1

dist/esm/browser.js.map

-8

dist/esm/index.d.ts

		import type { InspectOptions } from 'node:util';
		import type { SpecLike } from './browser.ts';
		import { Spec as BrowserSpec, kCustomInspect } from './browser.ts';
		export * from './browser.ts';
		export declare class Spec extends BrowserSpec implements SpecLike<Spec> {
		[kCustomInspect](_depth?: number, options?: InspectOptions): string;
		}
		//# sourceMappingURL=index.d.ts.map

-1

dist/esm/index.d.ts.map

{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAGlE,cAAc,cAAc,CAAA;AAG5B,qBAAa,IAAK,SAAQ,WAAY,YAAW,QAAQ,CAAC,IAAI,CAAC;IAC7D,CAAC,cAAc,CAAC,CACd,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM;CAWV"}

-23

dist/esm/index.js

		import { homedir } from 'node:os';
		import { isAbsolute, join, resolve, win32 as winPath, } from 'node:path';
		import { inspect } from 'node:util';
		import { Spec as BrowserSpec, kCustomInspect } from "./browser.js";
		// eslint-disable-next-line import/export
		export * from "./browser.js";
		// eslint-disable-next-line import/export
		export class Spec extends BrowserSpec {
		[kCustomInspect](_depth, options) {
		const str = inspect(Object.fromEntries(Object.entries(this).filter(([k, v]) => {
		return k !== 'options' && v !== undefined;
		})), options);
		return `@vltpkg/spec.Spec ${str}`;
		}
		}
		Spec.nodejsDependencies = {
		homedir,
		isAbsolute,
		join,
		resolve,
		winPath,
		};
		//# sourceMappingURL=index.js.map

-1

dist/esm/index.js.map

{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EACL,UAAU,EACV,IAAI,EACJ,OAAO,EACP,KAAK,IAAI,OAAO,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElE,yCAAyC;AACzC,cAAc,cAAc,CAAA;AAE5B,yCAAyC;AACzC,MAAM,OAAO,IAAK,SAAQ,WAAW;IACnC,CAAC,cAAc,CAAC,CACd,MAAe,EACf,OAAwB;QAExB,MAAM,GAAG,GAAG,OAAO,CACjB,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;YACrC,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS,CAAA;QAC3C,CAAC,CAAC,CACH,EACD,OAAO,CACR,CAAA;QACD,OAAO,qBAAqB,GAAG,EAAE,CAAA;IACnC,CAAC;CACF;AAED,IAAI,CAAC,kBAAkB,GAAG;IACxB,OAAO;IACP,UAAU;IACV,IAAI;IACJ,OAAO;IACP,OAAO;CACR,CAAA","sourcesContent":["import { homedir } from 'node:os'\nimport {\n isAbsolute,\n join,\n resolve,\n win32 as winPath,\n} from 'node:path'\nimport { inspect } from 'node:util'\nimport type { InspectOptions } from 'node:util'\nimport type { SpecLike } from './browser.ts'\nimport { Spec as BrowserSpec, kCustomInspect } from './browser.ts'\n\n// eslint-disable-next-line import/export\nexport * from './browser.ts'\n\n// eslint-disable-next-line import/export\nexport class Spec extends BrowserSpec implements SpecLike<Spec> {\n [kCustomInspect](\n _depth?: number,\n options?: InspectOptions,\n ): string {\n const str = inspect(\n Object.fromEntries(\n Object.entries(this).filter(([k, v]) => {\n return k !== 'options' && v !== undefined\n }),\n ),\n options,\n )\n return `@vltpkg/spec.Spec ${str}`\n }\n}\n\nSpec.nodejsDependencies = {\n homedir,\n isAbsolute,\n join,\n resolve,\n winPath,\n}\n"]}

-3

dist/esm/package.json

		{
		"type": "module"
		}

-117

dist/esm/types.d.ts

		import type { Range } from '@vltpkg/semver';
		export type SpecOptions = {
		[k in keyof SpecOptionsFilled]?: SpecOptionsFilled[k];
		};
		export type Scope = `@${string}`;
		export type SpecOptionsFilled = {
		/** the registry where a spec should be resolved against */
		registry: string;
		/** shorthand prefix names for known registries */
		registries: Record<string, string>;
		/** shorthand prefix names for known git hosts */
		'git-hosts': Record<string, string>;
		/** tarball hosting services for hosts listed in git-hosts */
		'git-host-archives': Record<string, string>;
		/** registries mapped to a `@scope` */
		'scope-registries': Record<Scope, string>;
		/** registries that work like https://npm.jsr.io */
		'jsr-registries': Record<string, string>;
		catalog: Record<string, string>;
		catalogs?: Record<string, Record<string, string>>;
		};
		export type GitSelectorParsed = {
		path?: string;
		semver?: string;
		};
		export type SpecType = 'file' \| 'git' \| 'registry' \| 'remote' \| 'workspace' \| 'catalog';
		export type SpecLikeBase = {
		/** the type of spec that this is, ultimately */
		type: SpecType;
		/** the full named specifier passed to the constructor */
		spec: string;
		/** options passed to the constructor, plus defaults */
		options: SpecOptionsFilled;
		/** the name portion, so `foo` in `foo@1.x` */
		name: string;
		/** the name's scope, so `@acme` in `@acme/foo@1.x` */
		scope?: Scope;
		/**
		* if the name is scoped, and there's a registry associated with the scope,
		* then this is that registry
		*/
		scopeRegistry?: string;
		/** just the part AFTER the name, so `1.x` in `foo@1.x` */
		bareSpec: string;
		/** the git remote to fetch from */
		gitRemote?: string;
		/** the committish, semver range, and/or path portion of a git remote */
		gitSelector?: string;
		/**
		* the parsed '::'-separated key/value pairs:
		* `semver:<range>` and `path:<subpath>`
		*/
		gitSelectorParsed?: GitSelectorParsed;
		/** the commit value we will check out */
		gitCommittish?: string;
		/** github, gitlab, bitbucket, gist, etc. */
		namedGitHost?: string;
		/** the path that's parsed when we have a named git host */
		namedGitHostPath?: string;
		/**
		* the specifier when using `workspace:` specs
		* This can be either a semver range, `*`, `~`, or `^`,
		* if the name is not modified. Or, it can include a workspace
		* package name or path, like `workspace:packages/foo@*` or
		* `workspace:@scope/foo@*`.
		*/
		workspaceSpec?: string;
		/**
		* the package name or path of the workspace being referenced
		*/
		workspace?: string;
		/**
		* In specs like `foo@npm:bar@1`, this is the 'npm' part. Other
		* registries can be mapped using the `registries` option.
		*/
		namedRegistry?: string;
		/** registry to consult to resolve this spec */
		registry?: string;
		/** semver range or dist-tag for resolving against a packument */
		registrySpec?: string;
		/**
		* conventional location of the tarball on the registry, if it can be
		* guessed. This is only attempted if the spec is a registry type, with a
		* single version comparator. This can be used to elide resolved urls that
		* are repetitive and predictable.
		*/
		conventionalRegistryTarball?: string;
		/** spec to resolve against available versions */
		semver?: string;
		/** parsed semver range specifier */
		range?: Range;
		/** a dist-tag like 'latest' */
		distTag?: string;
		/**
		* URL to download a tarball from, if it can be determined.
		*
		* This is set for url specs of course, but also git remotes on known
		* hosts that provide a gitHostArchive template.
		*/
		remoteURL?: string;
		/** file path for file:// url specs */
		file?: string;
		/** in `bar@npm:foo@1.x`, this is the spec for `foo@1.x` */
		subspec?: SpecLikeBase;
		/**
		* getter that retrieves the actual spec value to be used
		*/
		final: SpecLikeBase;
		/** Is this a spec that overrides another spec? */
		overridden: boolean;
		toString(): string;
		};
		export type SpecLike<Type extends SpecLikeBase> = SpecLikeBase & {
		subspec?: Type;
		final: Type;
		};
		//# sourceMappingURL=types.d.ts.map

-1

dist/esm/types.d.ts.map

{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAE3C,MAAM,MAAM,WAAW,GAAG;KACvB,CAAC,IAAI,MAAM,iBAAiB,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC;CACtD,CAAA;AAED,MAAM,MAAM,KAAK,GAAG,IAAI,MAAM,EAAE,CAAA;AAEhC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,6DAA6D;IAC7D,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3C,sCAAsC;IACtC,kBAAkB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACzC,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAClD,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,KAAK,GACL,UAAU,GACV,QAAQ,GACR,WAAW,GACX,SAAS,CAAA;AAEb,MAAM,MAAM,YAAY,GAAG;IACzB,gDAAgD;IAChD,IAAI,EAAE,QAAQ,CAAA;IAEd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;IAEZ,uDAAuD;IACvD,OAAO,EAAE,iBAAiB,CAAA;IAE1B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IAEZ,sDAAsD;IACtD,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAA;IAEhB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;;OAKG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAA;IAEpC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,oCAAoC;IACpC,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,2DAA2D;IAC3D,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB;;OAEG;IACH,KAAK,EAAE,YAAY,CAAA;IACnB,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAA;IAEnB,QAAQ,IAAI,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,QAAQ,CAAC,IAAI,SAAS,YAAY,IAAI,YAAY,GAAG;IAC/D,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,KAAK,EAAE,IAAI,CAAA;CACZ,CAAA"}

-2

dist/esm/types.js

		export {};
		//# sourceMappingURL=types.js.map

-1

dist/esm/types.js.map

{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Range } from '@vltpkg/semver'\n\nexport type SpecOptions = {\n [k in keyof SpecOptionsFilled]?: SpecOptionsFilled[k]\n}\n\nexport type Scope = `@${string}`\n\nexport type SpecOptionsFilled = {\n /** the registry where a spec should be resolved against */\n registry: string\n /** shorthand prefix names for known registries */\n registries: Record<string, string>\n /** shorthand prefix names for known git hosts */\n 'git-hosts': Record<string, string>\n /** tarball hosting services for hosts listed in git-hosts */\n 'git-host-archives': Record<string, string>\n /** registries mapped to a `@scope` */\n 'scope-registries': Record<Scope, string>\n /** registries that work like https://npm.jsr.io */\n 'jsr-registries': Record<string, string>\n catalog: Record<string, string>\n catalogs?: Record<string, Record<string, string>>\n}\n\nexport type GitSelectorParsed = {\n path?: string\n semver?: string\n}\n\nexport type SpecType =\n | 'file'\n | 'git'\n | 'registry'\n | 'remote'\n | 'workspace'\n | 'catalog'\n\nexport type SpecLikeBase = {\n /** the type of spec that this is, ultimately */\n type: SpecType\n\n /** the full named specifier passed to the constructor */\n spec: string\n\n /** options passed to the constructor, plus defaults */\n options: SpecOptionsFilled\n\n /** the name portion, so `foo` in `foo@1.x` */\n name: string\n\n /** the name's scope, so `@acme` in `@acme/foo@1.x` */\n scope?: Scope\n\n /**\n * if the name is scoped, and there's a registry associated with the scope,\n * then this is that registry\n */\n scopeRegistry?: string\n\n /** just the part AFTER the name, so `1.x` in `foo@1.x` */\n bareSpec: string\n\n /** the git remote to fetch from */\n gitRemote?: string\n\n /** the committish, semver range, and/or path portion of a git remote */\n gitSelector?: string\n /**\n * the parsed '::'-separated key/value pairs:\n * `semver:<range>` and `path:<subpath>`\n */\n gitSelectorParsed?: GitSelectorParsed\n /** the commit value we will check out */\n gitCommittish?: string\n /** github, gitlab, bitbucket, gist, etc. */\n namedGitHost?: string\n /** the path that's parsed when we have a named git host */\n namedGitHostPath?: string\n\n /**\n * the specifier when using `workspace:` specs\n * This can be either a semver range, `*`, `~`, or `^`,\n * if the name is not modified. Or, it can include a workspace\n * package name or path, like `workspace:packages/foo@*` or\n * `workspace:@scope/foo@*`.\n */\n workspaceSpec?: string\n\n /**\n * the package name or path of the workspace being referenced\n */\n workspace?: string\n\n /**\n * In specs like `foo@npm:bar@1`, this is the 'npm' part. Other\n * registries can be mapped using the `registries` option.\n */\n namedRegistry?: string\n\n /** registry to consult to resolve this spec */\n registry?: string\n\n /** semver range or dist-tag for resolving against a packument */\n registrySpec?: string\n\n /**\n * conventional location of the tarball on the registry, if it can be\n * guessed. This is only attempted if the spec is a registry type, with a\n * single version comparator. This can be used to elide resolved urls that\n * are repetitive and predictable.\n */\n conventionalRegistryTarball?: string\n\n /** spec to resolve against available versions */\n semver?: string\n\n /** parsed semver range specifier */\n range?: Range\n\n /** a dist-tag like 'latest' */\n distTag?: string\n\n /**\n * URL to download a tarball from, if it can be determined.\n *\n * This is set for url specs of course, but also git remotes on known\n * hosts that provide a gitHostArchive template.\n */\n remoteURL?: string\n\n /** file path for file:// url specs */\n file?: string\n\n /** in `bar@npm:foo@1.x`, this is the spec for `foo@1.x` */\n subspec?: SpecLikeBase\n /**\n * getter that retrieves the actual spec value to be used\n */\n final: SpecLikeBase\n /** Is this a spec that overrides another spec? */\n overridden: boolean\n\n toString(): string\n}\n\nexport type SpecLike<Type extends SpecLikeBase> = SpecLikeBase & {\n subspec?: Type\n final: Type\n}\n"]}

@vltpkg/spec - npm Package Compare versions

New alerts

Improved metrics

Worsened metrics

Dependency changes