@shgysk8zer0/importmap 1.5.0 → 1.5.1

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [v1.5.1] - 2025-12-04
+
+### Added
+- Add `Importmap` methods to set local imports using `package.json`
+- Add static `Importmap.importFromFile()` to import from a local JSON file
+
+### Changed
+- Update package & module `exports`
+
 ## [v1.5.0] - 2025-12-03
 
 ### Added

package/cli.cjs

@@ -4,7 +4,7 @@ var json_js = require('@shgysk8zer0/npm-utils/json.js');
 var yaml_js = require('@shgysk8zer0/npm-utils/yaml.js');
 var commander = require('commander');
 var node_path = require('node:path');
-require('node:fs/promises');
+var promises = require('node:fs/promises');
 require('@shgysk8zer0/polyfills');
 require('@shgysk8zer0/npm-utils/path.js');
 
@@ -98,11 +98,11 @@ const imports$1 = {
 	"firebase/storage": "https://www.gstatic.com/firebasejs/10.12.1/firebase-storage.js",
 	"firebase/analytics": "https://www.gstatic.com/firebasejs/10.12.1/firebase-analytics.js"
 };
-const scope$1 = {
+const scopes$1 = {
 };
 var json = {
 	imports: imports$1,
-	scope: scope$1
+	scopes: scopes$1
 };
 
 const SHA256 = 'SHA-256';
@@ -112,15 +112,23 @@ const DEFAULT_ALGO = SHA384;
 
 const BASE64 = 'base64';
 
-const { imports, scope } = json;
+const { imports, scopes } = json;
 
 class Importmap {
 	#imports = {};
-	#scope = {};
+	#scopes = {};
 
-	constructor({ imports: i = imports, scope: s = scope } = {}) {
+	constructor({ imports: i = imports, scopes: s = scopes } = {}) {
 		this.#imports = i;
-		this.#scope = s;
+		this.#scopes = s;
+	}
+
+	get imports() {
+		return structuredClone(this.#imports);
+	}
+
+	get scopes() {
+		return structuredClone(this.#scopes);
 	}
 
 	delete(key) {
@@ -140,13 +148,56 @@ class Importmap {
 	}
 
 	toJSON() {
-		return { imports: this.#imports, scope: this.#scope };
+		return { imports: this.#imports, scopes: this.#scopes };
 	}
 
 	toString() {
 		return JSON.stringify(this);
 	}
 
+	async importLocalPackage(name = 'package.json', { signal } = {}) {
+		const path = node_path.join(process.cwd(), name);
+		const pkg = await promises.readFile(path, { encoding: 'utf8', signal });
+
+		return this.setLocalPackage(JSON.parse(pkg));
+	}
+
+	setLocalPackage({ name, module, exports = {} }) {
+		if (typeof name !== 'string') {
+			return false;
+		} else if (typeof exports === 'string' ) {
+			this.set(name, exports);
+			return true;
+		} else if (typeof exports === 'object') {
+			Object.entries(exports).forEach(([key, value]) => {
+				if (key.startsWith('.')) {
+					const importKey = key === '.' ? name : `${name}${key.substring(1)}`;
+					const resolved = typeof value === 'string' ? value : value.import ?? value.default;
+
+					if (typeof resolved === 'string' && resolved.startsWith('./')) {
+						if (importKey.includes('*') && resolved.includes('*')) {
+							const [prefix, suffix] = importKey.split('*');
+
+							if (resolved.endsWith('*' + suffix)) {
+								this.set(prefix, resolved.substring(1).replace('*' + suffix, ''));
+							}
+						} else {
+							this.set(importKey, resolved.substring(1));
+						}
+					}
+				}
+			});
+
+			return true;
+		} else if (typeof module === 'string') {
+			this.set(name, module);
+			return true;
+		} else {
+			this.set(name, '/');
+			return true;
+		}
+	}
+
 	async getScript({ algo = DEFAULT_ALGO, alphabet = BASE64, signal } = {}) {
 		const integrity = await this.getIntegrity({ algo, alphabet, signal });
 
@@ -176,18 +227,16 @@ class Importmap {
 	static get SHA512() {
 		return SHA512;
 	}
-}
 
-const importmap = new Importmap({ imports, scope });
+	static async importFromFile(path = 'importmap.json', { signal } = {}) {
+		const fullPath = node_path.join(process.cwd(), path);
+		const importmap = await promises.readFile(fullPath, { encoding: 'utf8', signal });
 
-var importmap$1 = /*#__PURE__*/Object.freeze({
-  __proto__: null,
-  Importmap: Importmap,
-  default: importmap,
-  importmap: importmap,
-  imports: imports,
-  scope: scope
-});
+		return new Importmap(JSON.parse(importmap));
+	}
+}
+
+const importmap = new Importmap({ imports, scopes });
 
 /* eslint-env node */
 
@@ -244,12 +293,12 @@ async function init() {
 
 init().then(async ({ opts: { input, encoding, format, output }}) => {
 	const mod = typeof input === 'string'
-		? await parse(input, { encoding }).then(({ imports: imports$1, scope: scope$1 = {}, ...rest }) => ({
+		? await parse(input, { encoding }).then(({ imports, scope = {}, ...rest }) => ({
 			...rest,
-			imports: { ...imports$1, ...imports },
-			scope: { ...scope$1, ...scope },
+			imports: { ...imports, ...importmap.imports },
+			scope: { ...scope, ...importmap.scope },
 		}))
-		: importmap$1;
+		: importmap;
 
 	console.log(mod);
 

package/cli.js

@@ -1,8 +1,8 @@
 import { writeJSONFile, readJSONFile } from '@shgysk8zer0/npm-utils/json.js';
 import { writeYAMLFile, readYAMLFile } from '@shgysk8zer0/npm-utils/yaml.js';
 import { program } from 'commander';
-import { extname } from 'node:path';
-import 'node:fs/promises';
+import { join, extname } from 'node:path';
+import { readFile } from 'node:fs/promises';
 import '@shgysk8zer0/polyfills';
 import '@shgysk8zer0/npm-utils/path.js';
 
@@ -95,11 +95,11 @@ const imports$1 = {
 	"firebase/storage": "https://www.gstatic.com/firebasejs/10.12.1/firebase-storage.js",
 	"firebase/analytics": "https://www.gstatic.com/firebasejs/10.12.1/firebase-analytics.js"
 };
-const scope$1 = {
+const scopes$1 = {
 };
 var json = {
 	imports: imports$1,
-	scope: scope$1
+	scopes: scopes$1
 };
 
 const SHA256 = 'SHA-256';
@@ -109,15 +109,23 @@ const DEFAULT_ALGO = SHA384;
 
 const BASE64 = 'base64';
 
-const { imports, scope } = json;
+const { imports, scopes } = json;
 
 class Importmap {
 	#imports = {};
-	#scope = {};
+	#scopes = {};
 
-	constructor({ imports: i = imports, scope: s = scope } = {}) {
+	constructor({ imports: i = imports, scopes: s = scopes } = {}) {
 		this.#imports = i;
-		this.#scope = s;
+		this.#scopes = s;
+	}
+
+	get imports() {
+		return structuredClone(this.#imports);
+	}
+
+	get scopes() {
+		return structuredClone(this.#scopes);
 	}
 
 	delete(key) {
@@ -137,13 +145,56 @@ class Importmap {
 	}
 
 	toJSON() {
-		return { imports: this.#imports, scope: this.#scope };
+		return { imports: this.#imports, scopes: this.#scopes };
 	}
 
 	toString() {
 		return JSON.stringify(this);
 	}
 
+	async importLocalPackage(name = 'package.json', { signal } = {}) {
+		const path = join(process.cwd(), name);
+		const pkg = await readFile(path, { encoding: 'utf8', signal });
+
+		return this.setLocalPackage(JSON.parse(pkg));
+	}
+
+	setLocalPackage({ name, module, exports = {} }) {
+		if (typeof name !== 'string') {
+			return false;
+		} else if (typeof exports === 'string' ) {
+			this.set(name, exports);
+			return true;
+		} else if (typeof exports === 'object') {
+			Object.entries(exports).forEach(([key, value]) => {
+				if (key.startsWith('.')) {
+					const importKey = key === '.' ? name : `${name}${key.substring(1)}`;
+					const resolved = typeof value === 'string' ? value : value.import ?? value.default;
+
+					if (typeof resolved === 'string' && resolved.startsWith('./')) {
+						if (importKey.includes('*') && resolved.includes('*')) {
+							const [prefix, suffix] = importKey.split('*');
+
+							if (resolved.endsWith('*' + suffix)) {
+								this.set(prefix, resolved.substring(1).replace('*' + suffix, ''));
+							}
+						} else {
+							this.set(importKey, resolved.substring(1));
+						}
+					}
+				}
+			});
+
+			return true;
+		} else if (typeof module === 'string') {
+			this.set(name, module);
+			return true;
+		} else {
+			this.set(name, '/');
+			return true;
+		}
+	}
+
 	async getScript({ algo = DEFAULT_ALGO, alphabet = BASE64, signal } = {}) {
 		const integrity = await this.getIntegrity({ algo, alphabet, signal });
 
@@ -173,18 +224,16 @@ class Importmap {
 	static get SHA512() {
 		return SHA512;
 	}
-}
 
-const importmap = new Importmap({ imports, scope });
+	static async importFromFile(path = 'importmap.json', { signal } = {}) {
+		const fullPath = join(process.cwd(), path);
+		const importmap = await readFile(fullPath, { encoding: 'utf8', signal });
 
-var importmap$1 = /*#__PURE__*/Object.freeze({
-  __proto__: null,
-  Importmap: Importmap,
-  default: importmap,
-  importmap: importmap,
-  imports: imports,
-  scope: scope
-});
+		return new Importmap(JSON.parse(importmap));
+	}
+}
+
+const importmap = new Importmap({ imports, scopes });
 
 /* eslint-env node */
 
@@ -241,12 +290,12 @@ async function init() {
 
 init().then(async ({ opts: { input, encoding, format, output }}) => {
 	const mod = typeof input === 'string'
-		? await parse(input, { encoding }).then(({ imports: imports$1, scope: scope$1 = {}, ...rest }) => ({
+		? await parse(input, { encoding }).then(({ imports, scope = {}, ...rest }) => ({
 			...rest,
-			imports: { ...imports$1, ...imports },
-			scope: { ...scope$1, ...scope },
+			imports: { ...imports, ...importmap.imports },
+			scope: { ...scope, ...importmap.scope },
 		}))
-		: importmap$1;
+		: importmap;
 
 	console.log(mod);
 

package/importmap.cjs

@@ -2,6 +2,8 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var node_path = require('node:path');
+var promises = require('node:fs/promises');
 require('@shgysk8zer0/polyfills');
 
 const imports$1 = {
@@ -93,11 +95,11 @@ const imports$1 = {
 	"firebase/storage": "https://www.gstatic.com/firebasejs/10.12.1/firebase-storage.js",
 	"firebase/analytics": "https://www.gstatic.com/firebasejs/10.12.1/firebase-analytics.js"
 };
-const scope$1 = {
+const scopes$1 = {
 };
 var json = {
 	imports: imports$1,
-	scope: scope$1
+	scopes: scopes$1
 };
 
 const SHA256 = 'SHA-256';
@@ -107,15 +109,23 @@ const DEFAULT_ALGO = SHA384;
 
 const BASE64 = 'base64';
 
-const { imports, scope } = json;
+const { imports, scopes } = json;
 
 class Importmap {
 	#imports = {};
-	#scope = {};
+	#scopes = {};
 
-	constructor({ imports: i = imports, scope: s = scope } = {}) {
+	constructor({ imports: i = imports, scopes: s = scopes } = {}) {
 		this.#imports = i;
-		this.#scope = s;
+		this.#scopes = s;
+	}
+
+	get imports() {
+		return structuredClone(this.#imports);
+	}
+
+	get scopes() {
+		return structuredClone(this.#scopes);
 	}
 
 	delete(key) {
@@ -135,13 +145,56 @@ class Importmap {
 	}
 
 	toJSON() {
-		return { imports: this.#imports, scope: this.#scope };
+		return { imports: this.#imports, scopes: this.#scopes };
 	}
 
 	toString() {
 		return JSON.stringify(this);
 	}
 
+	async importLocalPackage(name = 'package.json', { signal } = {}) {
+		const path = node_path.join(process.cwd(), name);
+		const pkg = await promises.readFile(path, { encoding: 'utf8', signal });
+
+		return this.setLocalPackage(JSON.parse(pkg));
+	}
+
+	setLocalPackage({ name, module, exports = {} }) {
+		if (typeof name !== 'string') {
+			return false;
+		} else if (typeof exports === 'string' ) {
+			this.set(name, exports);
+			return true;
+		} else if (typeof exports === 'object') {
+			Object.entries(exports).forEach(([key, value]) => {
+				if (key.startsWith('.')) {
+					const importKey = key === '.' ? name : `${name}${key.substring(1)}`;
+					const resolved = typeof value === 'string' ? value : value.import ?? value.default;
+
+					if (typeof resolved === 'string' && resolved.startsWith('./')) {
+						if (importKey.includes('*') && resolved.includes('*')) {
+							const [prefix, suffix] = importKey.split('*');
+
+							if (resolved.endsWith('*' + suffix)) {
+								this.set(prefix, resolved.substring(1).replace('*' + suffix, ''));
+							}
+						} else {
+							this.set(importKey, resolved.substring(1));
+						}
+					}
+				}
+			});
+
+			return true;
+		} else if (typeof module === 'string') {
+			this.set(name, module);
+			return true;
+		} else {
+			this.set(name, '/');
+			return true;
+		}
+	}
+
 	async getScript({ algo = DEFAULT_ALGO, alphabet = BASE64, signal } = {}) {
 		const integrity = await this.getIntegrity({ algo, alphabet, signal });
 
@@ -171,12 +224,20 @@ class Importmap {
 	static get SHA512() {
 		return SHA512;
 	}
+
+	static async importFromFile(path = 'importmap.json', { signal } = {}) {
+		const fullPath = node_path.join(process.cwd(), path);
+		const importmap = await promises.readFile(fullPath, { encoding: 'utf8', signal });
+
+		return new Importmap(JSON.parse(importmap));
+	}
 }
 
-const importmap = new Importmap({ imports, scope });
+const importmap = new Importmap({ imports, scopes });
+var importmap$1 = { imports, scopes };
 
 exports.Importmap = Importmap;
-exports.default = importmap;
+exports.default = importmap$1;
 exports.importmap = importmap;
 exports.imports = imports;
-exports.scope = scope;
+exports.scopes = scopes;

package/importmap.js

@@ -1,3 +1,5 @@
+import { join } from 'node:path';
+import { readFile } from 'node:fs/promises';
 import '@shgysk8zer0/polyfills';
 
 const imports$1 = {
@@ -89,11 +91,11 @@ const imports$1 = {
 	"firebase/storage": "https://www.gstatic.com/firebasejs/10.12.1/firebase-storage.js",
 	"firebase/analytics": "https://www.gstatic.com/firebasejs/10.12.1/firebase-analytics.js"
 };
-const scope$1 = {
+const scopes$1 = {
 };
 var json = {
 	imports: imports$1,
-	scope: scope$1
+	scopes: scopes$1
 };
 
 const SHA256 = 'SHA-256';
@@ -103,15 +105,23 @@ const DEFAULT_ALGO = SHA384;
 
 const BASE64 = 'base64';
 
-const { imports, scope } = json;
+const { imports, scopes } = json;
 
 class Importmap {
 	#imports = {};
-	#scope = {};
+	#scopes = {};
 
-	constructor({ imports: i = imports, scope: s = scope } = {}) {
+	constructor({ imports: i = imports, scopes: s = scopes } = {}) {
 		this.#imports = i;
-		this.#scope = s;
+		this.#scopes = s;
+	}
+
+	get imports() {
+		return structuredClone(this.#imports);
+	}
+
+	get scopes() {
+		return structuredClone(this.#scopes);
 	}
 
 	delete(key) {
@@ -131,13 +141,56 @@ class Importmap {
 	}
 
 	toJSON() {
-		return { imports: this.#imports, scope: this.#scope };
+		return { imports: this.#imports, scopes: this.#scopes };
 	}
 
 	toString() {
 		return JSON.stringify(this);
 	}
 
+	async importLocalPackage(name = 'package.json', { signal } = {}) {
+		const path = join(process.cwd(), name);
+		const pkg = await readFile(path, { encoding: 'utf8', signal });
+
+		return this.setLocalPackage(JSON.parse(pkg));
+	}
+
+	setLocalPackage({ name, module, exports = {} }) {
+		if (typeof name !== 'string') {
+			return false;
+		} else if (typeof exports === 'string' ) {
+			this.set(name, exports);
+			return true;
+		} else if (typeof exports === 'object') {
+			Object.entries(exports).forEach(([key, value]) => {
+				if (key.startsWith('.')) {
+					const importKey = key === '.' ? name : `${name}${key.substring(1)}`;
+					const resolved = typeof value === 'string' ? value : value.import ?? value.default;
+
+					if (typeof resolved === 'string' && resolved.startsWith('./')) {
+						if (importKey.includes('*') && resolved.includes('*')) {
+							const [prefix, suffix] = importKey.split('*');
+
+							if (resolved.endsWith('*' + suffix)) {
+								this.set(prefix, resolved.substring(1).replace('*' + suffix, ''));
+							}
+						} else {
+							this.set(importKey, resolved.substring(1));
+						}
+					}
+				}
+			});
+
+			return true;
+		} else if (typeof module === 'string') {
+			this.set(name, module);
+			return true;
+		} else {
+			this.set(name, '/');
+			return true;
+		}
+	}
+
 	async getScript({ algo = DEFAULT_ALGO, alphabet = BASE64, signal } = {}) {
 		const integrity = await this.getIntegrity({ algo, alphabet, signal });
 
@@ -167,8 +220,16 @@ class Importmap {
 	static get SHA512() {
 		return SHA512;
 	}
+
+	static async importFromFile(path = 'importmap.json', { signal } = {}) {
+		const fullPath = join(process.cwd(), path);
+		const importmap = await readFile(fullPath, { encoding: 'utf8', signal });
+
+		return new Importmap(JSON.parse(importmap));
+	}
 }
 
-const importmap = new Importmap({ imports, scope });
+const importmap = new Importmap({ imports, scopes });
+var importmap$1 = { imports, scopes };
 
-export { Importmap, importmap as default, importmap, imports, scope };
+export { Importmap, importmap$1 as default, importmap, imports, scopes };

package/importmap.json

@@ -88,5 +88,5 @@
     "firebase/storage": "https://www.gstatic.com/firebasejs/10.12.1/firebase-storage.js",
     "firebase/analytics": "https://www.gstatic.com/firebasejs/10.12.1/firebase-analytics.js"
   },
-  "scope": {}
+  "scopes": {}
 }

package/index.cjs

@@ -1,12 +1,13 @@
 'use strict';
 
 var promises = require('node:fs/promises');
+var node_path = require('node:path');
 require('@shgysk8zer0/polyfills');
 var yaml_js = require('@shgysk8zer0/npm-utils/yaml.js');
 var json_js = require('@shgysk8zer0/npm-utils/json.js');
 var path_js = require('@shgysk8zer0/npm-utils/path.js');
 
-const imports$2 = {
+const imports$1 = {
 	"@node/": "/node_modules/",
 	"@shgysk8zer0/kazoo/": "https://unpkg.com/@shgysk8zer0/kazoo@1.0.10/",
 	"@shgysk8zer0/konami": "https://unpkg.com/@shgysk8zer0/konami@1.1.1/konami.js",
@@ -95,11 +96,11 @@ const imports$2 = {
 	"firebase/storage": "https://www.gstatic.com/firebasejs/10.12.1/firebase-storage.js",
 	"firebase/analytics": "https://www.gstatic.com/firebasejs/10.12.1/firebase-analytics.js"
 };
-const scope$2 = {
+const scopes$1 = {
 };
 var json = {
-	imports: imports$2,
-	scope: scope$2
+	imports: imports$1,
+	scopes: scopes$1
 };
 
 const SHA256 = 'SHA-256';
@@ -141,15 +142,23 @@ async function hash(data, { algo = DEFAULT_ALGO, output = BUFFER } = {}) {
 
 const sri = async(data, { algo = SHA384 } = {}) => hash(data, { algo, output: SRI });
 
-const { imports: imports$1, scope: scope$1 } = json;
+const { imports, scopes } = json;
 
 class Importmap {
 	#imports = {};
-	#scope = {};
+	#scopes = {};
 
-	constructor({ imports: i = imports$1, scope: s = scope$1 } = {}) {
+	constructor({ imports: i = imports, scopes: s = scopes } = {}) {
 		this.#imports = i;
-		this.#scope = s;
+		this.#scopes = s;
+	}
+
+	get imports() {
+		return structuredClone(this.#imports);
+	}
+
+	get scopes() {
+		return structuredClone(this.#scopes);
 	}
 
 	delete(key) {
@@ -169,13 +178,56 @@ class Importmap {
 	}
 
 	toJSON() {
-		return { imports: this.#imports, scope: this.#scope };
+		return { imports: this.#imports, scopes: this.#scopes };
 	}
 
 	toString() {
 		return JSON.stringify(this);
 	}
 
+	async importLocalPackage(name = 'package.json', { signal } = {}) {
+		const path = node_path.join(process.cwd(), name);
+		const pkg = await promises.readFile(path, { encoding: 'utf8', signal });
+
+		return this.setLocalPackage(JSON.parse(pkg));
+	}
+
+	setLocalPackage({ name, module, exports = {} }) {
+		if (typeof name !== 'string') {
+			return false;
+		} else if (typeof exports === 'string' ) {
+			this.set(name, exports);
+			return true;
+		} else if (typeof exports === 'object') {
+			Object.entries(exports).forEach(([key, value]) => {
+				if (key.startsWith('.')) {
+					const importKey = key === '.' ? name : `${name}${key.substring(1)}`;
+					const resolved = typeof value === 'string' ? value : value.import ?? value.default;
+
+					if (typeof resolved === 'string' && resolved.startsWith('./')) {
+						if (importKey.includes('*') && resolved.includes('*')) {
+							const [prefix, suffix] = importKey.split('*');
+
+							if (resolved.endsWith('*' + suffix)) {
+								this.set(prefix, resolved.substring(1).replace('*' + suffix, ''));
+							}
+						} else {
+							this.set(importKey, resolved.substring(1));
+						}
+					}
+				}
+			});
+
+			return true;
+		} else if (typeof module === 'string') {
+			this.set(name, module);
+			return true;
+		} else {
+			this.set(name, '/');
+			return true;
+		}
+	}
+
 	async getScript({ algo = DEFAULT_ALGO, alphabet = BASE64, signal } = {}) {
 		const integrity = await this.getIntegrity({ algo, alphabet, signal });
 
@@ -205,18 +257,16 @@ class Importmap {
 	static get SHA512() {
 		return SHA512;
 	}
-}
 
-const importmap = new Importmap({ imports: imports$1, scope: scope$1 });
+	static async importFromFile(path = 'importmap.json', { signal } = {}) {
+		const fullPath = node_path.join(process.cwd(), path);
+		const importmap = await promises.readFile(fullPath, { encoding: 'utf8', signal });
 
-var importmap$1 = /*#__PURE__*/Object.freeze({
-  __proto__: null,
-  Importmap: Importmap,
-  default: importmap,
-  importmap: importmap,
-  imports: imports$1,
-  scope: scope$1
-});
+		return new Importmap(JSON.parse(importmap));
+	}
+}
+
+const importmap = new Importmap({ imports, scopes });
 
 const UNPKG = 'https://unpkg.com/';
 
@@ -343,18 +393,17 @@ var unpkg = /*#__PURE__*/Object.freeze({
   updateYAML: updateYAML
 });
 
-const { imports, scope } = importmap$1;
 const ENCODING = 'utf8';
 
-function mergeWithImportmap({ imports = {}, scope = {}}) {
+function mergeWithImportmap({ imports = {}, scopes = {}}) {
 	return {
-		imports: { ...imports$1, ...imports },
-		scope: { ...scope$1, ...scope },
+		imports: { ...importmap.imports, ...imports },
+		scopes: { ...importmap.scope, ...scopes },
 	};
 }
 
 async function createImportmapJSON(path = 'importmap.json', {
-	importmap = { imports, scope },
+	importmap = { imports, scopes },
 	spaces = 2,
 	signal,
 } = {}) {
@@ -362,14 +411,14 @@ async function createImportmapJSON(path = 'importmap.json', {
 }
 
 async function getImportmapIntegrity({
-	importmap = { imports, scope },
+	importmap = { imports, scopes },
 	algo = DEFAULT_ALGO,
 } = {}) {
 	return await sri(JSON.stringify(importmap), { algo });
 }
 
 async function getImportmapScript({
-	importmap = { imports, scope },
+	importmap = { imports, scopes },
 	algo = DEFAULT_ALGO,
 } = {}) {
 	const integrity = await getImportmapIntegrity({ importmap, algo });
@@ -377,11 +426,12 @@ async function getImportmapScript({
 }
 
 exports.ENCODING = ENCODING;
+exports.Importmap = Importmap;
 exports.createImportmapJSON = createImportmapJSON;
 exports.getImportmapIntegrity = getImportmapIntegrity;
 exports.getImportmapScript = getImportmapScript;
-exports.importmap = importmap$1;
+exports.importmap = importmap;
 exports.imports = imports;
 exports.mergeWithImportmap = mergeWithImportmap;
-exports.scope = scope;
+exports.scopes = scopes;
 exports.unpkg = unpkg;

package/index.js

@@ -1,10 +1,11 @@
-import { writeFile } from 'node:fs/promises';
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
 import '@shgysk8zer0/polyfills';
 import { readYAMLFile, writeYAMLFile } from '@shgysk8zer0/npm-utils/yaml.js';
 import { readJSONFile, writeJSONFile } from '@shgysk8zer0/npm-utils/json.js';
 import { getFileURL } from '@shgysk8zer0/npm-utils/path.js';
 
-const imports$2 = {
+const imports$1 = {
 	"@node/": "/node_modules/",
 	"@shgysk8zer0/kazoo/": "https://unpkg.com/@shgysk8zer0/kazoo@1.0.10/",
 	"@shgysk8zer0/konami": "https://unpkg.com/@shgysk8zer0/konami@1.1.1/konami.js",
@@ -93,11 +94,11 @@ const imports$2 = {
 	"firebase/storage": "https://www.gstatic.com/firebasejs/10.12.1/firebase-storage.js",
 	"firebase/analytics": "https://www.gstatic.com/firebasejs/10.12.1/firebase-analytics.js"
 };
-const scope$2 = {
+const scopes$1 = {
 };
 var json = {
-	imports: imports$2,
-	scope: scope$2
+	imports: imports$1,
+	scopes: scopes$1
 };
 
 const SHA256 = 'SHA-256';
@@ -139,15 +140,23 @@ async function hash(data, { algo = DEFAULT_ALGO, output = BUFFER } = {}) {
 
 const sri = async(data, { algo = SHA384 } = {}) => hash(data, { algo, output: SRI });
 
-const { imports: imports$1, scope: scope$1 } = json;
+const { imports, scopes } = json;
 
 class Importmap {
 	#imports = {};
-	#scope = {};
+	#scopes = {};
 
-	constructor({ imports: i = imports$1, scope: s = scope$1 } = {}) {
+	constructor({ imports: i = imports, scopes: s = scopes } = {}) {
 		this.#imports = i;
-		this.#scope = s;
+		this.#scopes = s;
+	}
+
+	get imports() {
+		return structuredClone(this.#imports);
+	}
+
+	get scopes() {
+		return structuredClone(this.#scopes);
 	}
 
 	delete(key) {
@@ -167,13 +176,56 @@ class Importmap {
 	}
 
 	toJSON() {
-		return { imports: this.#imports, scope: this.#scope };
+		return { imports: this.#imports, scopes: this.#scopes };
 	}
 
 	toString() {
 		return JSON.stringify(this);
 	}
 
+	async importLocalPackage(name = 'package.json', { signal } = {}) {
+		const path = join(process.cwd(), name);
+		const pkg = await readFile(path, { encoding: 'utf8', signal });
+
+		return this.setLocalPackage(JSON.parse(pkg));
+	}
+
+	setLocalPackage({ name, module, exports = {} }) {
+		if (typeof name !== 'string') {
+			return false;
+		} else if (typeof exports === 'string' ) {
+			this.set(name, exports);
+			return true;
+		} else if (typeof exports === 'object') {
+			Object.entries(exports).forEach(([key, value]) => {
+				if (key.startsWith('.')) {
+					const importKey = key === '.' ? name : `${name}${key.substring(1)}`;
+					const resolved = typeof value === 'string' ? value : value.import ?? value.default;
+
+					if (typeof resolved === 'string' && resolved.startsWith('./')) {
+						if (importKey.includes('*') && resolved.includes('*')) {
+							const [prefix, suffix] = importKey.split('*');
+
+							if (resolved.endsWith('*' + suffix)) {
+								this.set(prefix, resolved.substring(1).replace('*' + suffix, ''));
+							}
+						} else {
+							this.set(importKey, resolved.substring(1));
+						}
+					}
+				}
+			});
+
+			return true;
+		} else if (typeof module === 'string') {
+			this.set(name, module);
+			return true;
+		} else {
+			this.set(name, '/');
+			return true;
+		}
+	}
+
 	async getScript({ algo = DEFAULT_ALGO, alphabet = BASE64, signal } = {}) {
 		const integrity = await this.getIntegrity({ algo, alphabet, signal });
 
@@ -203,18 +255,16 @@ class Importmap {
 	static get SHA512() {
 		return SHA512;
 	}
-}
 
-const importmap = new Importmap({ imports: imports$1, scope: scope$1 });
+	static async importFromFile(path = 'importmap.json', { signal } = {}) {
+		const fullPath = join(process.cwd(), path);
+		const importmap = await readFile(fullPath, { encoding: 'utf8', signal });
 
-var importmap$1 = /*#__PURE__*/Object.freeze({
-  __proto__: null,
-  Importmap: Importmap,
-  default: importmap,
-  importmap: importmap,
-  imports: imports$1,
-  scope: scope$1
-});
+		return new Importmap(JSON.parse(importmap));
+	}
+}
+
+const importmap = new Importmap({ imports, scopes });
 
 const UNPKG = 'https://unpkg.com/';
 
@@ -341,18 +391,17 @@ var unpkg = /*#__PURE__*/Object.freeze({
   updateYAML: updateYAML
 });
 
-const { imports, scope } = importmap$1;
 const ENCODING = 'utf8';
 
-function mergeWithImportmap({ imports = {}, scope = {}}) {
+function mergeWithImportmap({ imports = {}, scopes = {}}) {
 	return {
-		imports: { ...imports$1, ...imports },
-		scope: { ...scope$1, ...scope },
+		imports: { ...importmap.imports, ...imports },
+		scopes: { ...importmap.scope, ...scopes },
 	};
 }
 
 async function createImportmapJSON(path = 'importmap.json', {
-	importmap = { imports, scope },
+	importmap = { imports, scopes },
 	spaces = 2,
 	signal,
 } = {}) {
@@ -360,18 +409,18 @@ async function createImportmapJSON(path = 'importmap.json', {
 }
 
 async function getImportmapIntegrity({
-	importmap = { imports, scope },
+	importmap = { imports, scopes },
 	algo = DEFAULT_ALGO,
 } = {}) {
 	return await sri(JSON.stringify(importmap), { algo });
 }
 
 async function getImportmapScript({
-	importmap = { imports, scope },
+	importmap = { imports, scopes },
 	algo = DEFAULT_ALGO,
 } = {}) {
 	const integrity = await getImportmapIntegrity({ importmap, algo });
 	return `<script type="importmap" integrity="${integrity}">${JSON.stringify(importmap)}</script>`;
 }
 
-export { ENCODING, createImportmapJSON, getImportmapIntegrity, getImportmapScript, importmap$1 as importmap, imports, mergeWithImportmap, scope, unpkg };
+export { ENCODING, Importmap, createImportmapJSON, getImportmapIntegrity, getImportmapScript, importmap, imports, mergeWithImportmap, scopes, unpkg };

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@shgysk8zer0/importmap",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.10.0"
   },
   "description": "Front-End dependencies based on `<script type=\"importmap\">`",
   "type": "module",
@@ -14,6 +14,9 @@
       "import": "./index.js",
       "require": "./index.cjs"
     },
+    "./importmap": {
+      "import": "./importmap.js"
+    },
     "./*.js": {
       "import": "./*.js",
       "require": "./*.cjs"