@jspm/local-mcp 0.1.1 → 0.1.3

package/Readme.md

@@ -1,37 +1,62 @@
 # `@jspm/local-mcp`
 
-`@jspm/local-mcp` is a local-first [Model Context Protocol](https://modelcontextprotocol.io/) server for managing JSPM import maps inside a real project directory.
+A local-first [Model Context Protocol](https://modelcontextprotocol.io/) server for managing JSPM import maps inside a real project directory. Uses `@jspm/generator` to keep the full import map correct instead of hand-editing only the `imports` section.
 
-It is built for coding agents that already have filesystem access to your repo, such as Codex, Claude Code / Claude Desktop, Cursor, and VS Code MCP clients.
+Built for coding agents with filesystem access to your repo (Codex, Claude Code / Claude Desktop, Cursor, VS Code MCP).
 
-Instead of asking an LLM to hand-edit only the `imports` section and accidentally break `scopes`, this server uses `@jspm/generator` to keep the full import map correct.
+## Tools
 
-## Why local-first
+### Read-only
 
-- It works directly against your project files.
-- It can write either `importmap.json` or inject an inline import map into an HTML file.
-- It can trace local source files and install the dependencies they actually use.
-- It preserves and reloads an existing import map when you revisit a project.
+| Tool | Description | Inputs |
+|------|-------------|--------|
+| `get_status` | Returns the active project path, map target, environment conditions, and generator options. | none |
+| `get_importmap` | Returns the current import map as JSON with the list of installed top-level specifiers. Requires `set_project` first. | none |
 
-## Tools
+### Project setup
 
-The server exposes these MCP tools:
+| Tool | Description | Inputs |
+|------|-------------|--------|
+| `set_project` | Sets the active project directory. | `path: string` |
+| `set_target` | Choose `importmap` file or HTML injection mode. | `target: string`, `fileName?: string`, `esModuleShims?: boolean` |
+| `set_env` | Switch between `"production"` and `"development"`. | `environment: "production"|"development"`, `customConditions?: string[]` |
 
-- `set_project`: set the working project directory.
-- `set_target`: choose `importmap` or `html` output mode.
-- `install_package`: install one or more packages with JSPM.
-- `uninstall_package`: remove one or more packages from the import map.
-- `trace_file`: trace imports from local source files and add the required mappings.
+### Generator configuration
 
-## Install
+| Tool | Description | Inputs |
+|------|-------------|--------|
+| `set_generator_options` | Configure CommonJS, TypeScript, SystemJS, integrity, fetch retries, default provider, and more. | `commonJS?`, `typeScript?`, `system?`, `integrity?`, `fetchRetries?`, `defaultProvider?`, `cache?`, `providers?`, `resolutions?`, `ignore?`, `reinstall?` |
+| `set_provider` | Set default provider (e.g. `"jspm.io"`, `"jsdelivr"`, `"unpkg"`) and scoped overrides. | `defaultProvider?`, `overrides?`, `reinstall?` |
+| `remove_provider_override` | Remove one or more scoped provider overrides. | `specifiers: string[]`, `reinstall?` |
+| `set_cache` | Configure cache mode (`true`, `false`, or `"offline"`). | `cache: boolean|"offline"`, `reinstall?` |
+| `set_resolution` | Add or update package resolution overrides. | `resolutions: {specifier, target}[]`, `reinstall?` |
+| `remove_resolution` | Remove package resolution overrides. | `specifiers: string[]`, `reinstall?` |
+| `set_ignore` | Replace the list of specifiers JSPM ignores during tracing. | `specifiers: string[]`, `reinstall?` |
+
+### Package management
+
+| Tool | Description | Inputs |
+|------|-------------|--------|
+| `install_package` | Install one or more packages via the configured provider. | `packages: {packageName, version?}[]` |
+| `uninstall_package` | Remove one or more packages from the import map. | `packageName: string|string[]` |
+| `trace_file` | Trace imports from local source files and add required mappings. | `fileNames: string[]` |
+
+## Typical Flow
+
+```text
+1. set_project({ path: "/absolute/path/to/project" })
+2. set_target({ target: "html", fileName: "index.html" })
+3. install_package({ packages: [{ packageName: "react" }, { packageName: "react-dom" }] })
+4. trace_file({ fileNames: ["src/main.js"] })
+```
 
-After publish, the simplest way to run it will be with `npx`:
+## Install
 
 ```sh
 npx -y @jspm/local-mcp
 ```
 
-You can also install it globally:
+Or globally:
 
 ```sh
 npm install -g @jspm/local-mcp
@@ -40,9 +65,7 @@ jspm-local-mcp
 
 ## MCP Client Setup
 
-### Codex
-
-Add an MCP server that runs `npx`:
+All clients use the same pattern:
 
 ```json
 {
@@ -55,60 +78,17 @@ Add an MCP server that runs `npx`:
 }
 ```
 
-### Claude Desktop
-
-```json
-{
-  "mcpServers": {
-    "jspm": {
-      "command": "npx",
-      "args": ["-y", "@jspm/local-mcp"]
-    }
-  }
-}
-```
+For VS Code / GitHub Copilot, use the `"servers"` key instead of `"mcpServers"`.
 
-### VS Code MCP / GitHub Copilot
+If `npx` is unavailable, point directly to the installed executable:
 
 ```json
 {
-  "servers": {
-    "jspm": {
-      "command": "npx",
-      "args": ["-y", "@jspm/local-mcp"]
-    }
-  }
+  "command": "node",
+  "args": ["/path/to/jspm-mcp/dist/cli.js"]
 }
 ```
 
-If your environment does not expose `npx`, point the client at the installed executable instead.
-
-## Typical Flow
-
-Example conversation:
-
-```text
-Set the project to the current workspace.
-Use index.html as the import map target.
-Install react and react-dom.
-Trace src/main.js and update the import map.
-```
-
-Equivalent tool calls:
-
-1. `set_project({ path: "/absolute/path/to/project" })`
-2. `set_target({ target: "html", fileName: "index.html" })`
-3. `install_package({ packages: [{ packageName: "react" }, { packageName: "react-dom" }] })`
-4. `trace_file({ fileNames: ["src/main.js"] })`
-
-## Behavior Notes
-
-- `set_project` defaults to `importmap.json`.
-- Switching targets reloads the generator from the current file state.
-- `set_target("html")` reads the existing HTML file and preserves any inline import map already there.
-- `trace_file` works on files inside the configured project directory.
-- Target files are restricted to the configured project directory.
-
 ## Local Development
 
 ```sh
@@ -117,16 +97,14 @@ npm run build
 npm start
 ```
 
-For local unpublished testing, point your MCP client to:
+For auto-reload during development:
 
-```json
-{
-  "command": "node",
-  "args": ["/absolute/path/to/jspm-mcp/dist/index.js"]
-}
-```
+- Terminal: `npm run dev` (watches `src/` and rebuilds `dist/` on save)
+- MCP client config: `node --watch /path/to/jspm-mcp/dist/cli.js`
+
+The `--watch` flag restarts the server automatically when `dist/` changes.
 
-## Publish Checklist
+## Publish
 
 ```sh
 npm run build

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { createServer } from "./index.js";
+async function main() {
+    const { server } = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    await server.sendLoggingMessage({
+        level: "info",
+        data: "JSPM MCP server started",
+    });
+    console.error(`JSPM MCP server running from ${fileURLToPath(import.meta.url)}`);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAC,oBAAoB,EAAC,MAAM,2CAA2C,CAAA;AAC9E,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAA;AACtC,OAAO,EAAC,YAAY,EAAC,MAAM,YAAY,CAAA;AAEvC,KAAK,UAAU,IAAI;IACjB,MAAM,EAAC,MAAM,EAAC,GAAG,YAAY,EAAE,CAAA;IAC/B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAE5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/B,MAAM,MAAM,CAAC,kBAAkB,CAAC;QAC9B,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,yBAAyB;KAChC,CAAC,CAAA;IAEF,OAAO,CAAC,KAAK,CACX,gCAAgC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACjE,CAAA;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;IACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/context.d.ts

@@ -0,0 +1,39 @@
+import { Generator } from "@jspm/generator";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { type ProjectGeneratorOptions } from "./generator-options.js";
+export type MapTarget = "importmap" | "html";
+export type ProjectEnvironment = "production" | "development";
+export declare const DEFAULT_GENERATOR_ENV: string[];
+export type ProjectContextState = {
+    projectPath?: string;
+    mapTarget: MapTarget;
+    env: string[];
+    generatorOptions: ProjectGeneratorOptions;
+    htmlFileName?: string;
+    esModuleShims: boolean;
+    generator?: Generator;
+};
+export type ProjectContext = {
+    state: ProjectContextState;
+    failure(text: string): CallToolResult;
+    ensureStateProjectPath(): string;
+    resolveProjectFilePath(fileName: string): string;
+    getGenerator(): Generator;
+    setEnv(env: string[]): void;
+    setGeneratorOptions(options: Partial<ProjectGeneratorOptions>): void;
+    setProviderOverride(specifier: string, provider: string): void;
+    removeProviderOverride(specifier: string): void;
+    setResolution(specifier: string, target: string): void;
+    removeResolution(specifier: string): void;
+    setIgnoreList(ignore: string[]): void;
+    reinstallTopLevelImports(): Promise<void>;
+    refreshGenerator(): Promise<void>;
+    resyncFromDisk(): Promise<void>;
+    applyConfigChange(mutate: () => void, reinstall: boolean): Promise<void>;
+    runExclusive<T>(work: () => Promise<T>): Promise<T>;
+    saveImportMap(): Promise<void>;
+    setDefaultMapTarget(): Promise<void>;
+};
+export declare function buildGeneratorEnv(environment: ProjectEnvironment, extraConditions?: string[]): string[];
+export declare function createProjectContext(): ProjectContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAC,cAAc,EAAC,MAAM,oCAAoC,CAAA;AAWjE,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAA;AAE/B,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,CAAA;AAC5C,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,aAAa,CAAA;AAE7D,eAAO,MAAM,qBAAqB,UAAsC,CAAA;AAExE,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,SAAS,CAAA;IACpB,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,gBAAgB,EAAE,uBAAuB,CAAA;IACzC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,OAAO,CAAA;IACtB,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,mBAAmB,CAAA;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAA;IACrC,sBAAsB,IAAI,MAAM,CAAA;IAChC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IAChD,YAAY,IAAI,SAAS,CAAA;IACzB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC3B,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAAA;IACpE,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9D,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/C,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACtD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACrC,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,iBAAiB,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxE,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACnD,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACrC,CAAA;AAiBD,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,kBAAkB,EAC/B,eAAe,GAAE,MAAM,EAAO,GAC7B,MAAM,EAAE,CAIV;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAsRrD"}

package/dist/context.js

@@ -0,0 +1,254 @@
+import { Generator } from "@jspm/generator";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve, sep } from "node:path";
+import { pathToFileURL } from "node:url";
+import { ensureProjectDirectory, ensureWritable, getImportMapLocation, getProjectFileLocation, isPathInside, } from "./utils.js";
+import { DEFAULT_GENERATOR_OPTIONS, } from "./generator-options.js";
+export const DEFAULT_GENERATOR_ENV = ["production", "browser", "module"];
+function trailingSlash(path) {
+    return path.endsWith(sep) ? path : `${path}${sep}`;
+}
+function assertInsideProject(projectPath, candidatePath) {
+    if (!isPathInside(projectPath, candidatePath)) {
+        throw new Error("Target file must stay inside the configured project");
+    }
+    return resolve(candidatePath);
+}
+export function buildGeneratorEnv(environment, extraConditions = []) {
+    return Array.from(new Set([environment, "module", "browser", ...extraConditions]));
+}
+export function createProjectContext() {
+    const state = {
+        mapTarget: "importmap",
+        env: [...DEFAULT_GENERATOR_ENV],
+        generatorOptions: { ...DEFAULT_GENERATOR_OPTIONS },
+        esModuleShims: false,
+    };
+    // The MCP SDK dispatches incoming requests without serializing them, so a
+    // client that pipelines tool calls can run two handlers concurrently against
+    // this shared mutable context. Chain every mutating handler through a single
+    // promise queue so each one's refresh/reinstall/save runs atomically.
+    let queue = Promise.resolve();
+    function runExclusive(work) {
+        const result = queue.then(work, work);
+        queue = result.then(() => undefined, () => undefined);
+        return result;
+    }
+    async function setDefaultMapTarget() {
+        const projectPath = ensureStateProjectPath();
+        const importmapPath = getImportMapLocation(projectPath);
+        const htmlFileName = "index.html";
+        const htmlPath = getProjectFileLocation(projectPath, htmlFileName);
+        if (existsSync(importmapPath)) {
+            state.mapTarget = "importmap";
+            state.htmlFileName = undefined;
+        }
+        else if (existsSync(htmlPath)) {
+            state.mapTarget = "html";
+            state.htmlFileName = htmlFileName;
+        }
+        else {
+            state.mapTarget = "html";
+            state.htmlFileName = undefined;
+        }
+    }
+    function failure(text) {
+        return {
+            content: [{ type: "text", text }],
+            isError: true,
+        };
+    }
+    function ensureStateProjectPath() {
+        return ensureProjectDirectory(state.projectPath);
+    }
+    function resolveProjectFilePath(fileName) {
+        const projectPath = ensureStateProjectPath();
+        const filePath = getProjectFileLocation(projectPath, fileName);
+        return assertInsideProject(projectPath, filePath);
+    }
+    function getGenerator() {
+        if (!state.generator) {
+            throw new Error("Generator is not ready. Call set_project first and optionally set_target.");
+        }
+        return state.generator;
+    }
+    function setEnv(env) {
+        state.env = env;
+    }
+    function setGeneratorOptions(options) {
+        state.generatorOptions = {
+            ...state.generatorOptions,
+            ...options,
+        };
+    }
+    function setProviderOverride(specifier, provider) {
+        state.generatorOptions.providers = {
+            ...state.generatorOptions.providers,
+            [specifier]: provider,
+        };
+    }
+    function removeProviderOverride(specifier) {
+        const providers = { ...state.generatorOptions.providers };
+        delete providers[specifier];
+        state.generatorOptions.providers = providers;
+    }
+    function setResolution(specifier, target) {
+        state.generatorOptions.resolutions = {
+            ...state.generatorOptions.resolutions,
+            [specifier]: target,
+        };
+    }
+    function removeResolution(specifier) {
+        const resolutions = { ...state.generatorOptions.resolutions };
+        delete resolutions[specifier];
+        state.generatorOptions.resolutions = resolutions;
+    }
+    function setIgnoreList(ignore) {
+        state.generatorOptions.ignore = Array.from(new Set(ignore));
+    }
+    async function refreshGenerator() {
+        const projectPath = ensureStateProjectPath();
+        const projectUrl = pathToFileURL(trailingSlash(projectPath));
+        const mapPath = state.mapTarget === "html"
+            ? resolveProjectFilePath(state.htmlFileName)
+            : getImportMapLocation(projectPath);
+        const mapUrl = pathToFileURL(mapPath);
+        const generator = new Generator({
+            mapUrl,
+            rootUrl: projectUrl,
+            env: state.env,
+            defaultProvider: state.generatorOptions.defaultProvider,
+            cache: state.generatorOptions.cache,
+            providers: state.generatorOptions.providers,
+            resolutions: state.generatorOptions.resolutions,
+            ignore: state.generatorOptions.ignore,
+            commonJS: state.generatorOptions.commonJS,
+            typeScript: state.generatorOptions.typeScript,
+            system: state.generatorOptions.system,
+            integrity: state.generatorOptions.integrity,
+            fetchRetries: state.generatorOptions.fetchRetries,
+        });
+        if (state.mapTarget === "importmap") {
+            if (existsSync(mapPath)) {
+                const mapSource = readFileSync(mapPath, "utf-8");
+                let mapJson;
+                try {
+                    mapJson = JSON.parse(mapSource);
+                }
+                catch (error) {
+                    throw new Error(`importmap.json is not valid JSON: ${error.message}`);
+                }
+                await generator.addMappings(mapJson, mapUrl, projectUrl);
+            }
+        }
+        else {
+            const htmlSource = readFileSync(mapPath, "utf-8");
+            await generator.addMappings(htmlSource, mapUrl, projectUrl);
+        }
+        state.generator = generator;
+    }
+    async function reinstallTopLevelImports() {
+        const generator = getGenerator();
+        try {
+            await generator.install();
+        }
+        catch (error) {
+            // An argumentless install() reinstalls the top-level imports, but the
+            // generator's reinstall path throws a "reading 'target'" TypeError when
+            // there are no top-level locks to reinstall (e.g. an empty project).
+            // Reinstalling nothing is a no-op, so swallow that specific crash and
+            // let any genuine install error propagate.
+            if (error instanceof TypeError &&
+                /reading 'target'/.test(error.message)) {
+                return;
+            }
+            throw error;
+        }
+    }
+    // Discard any in-memory generator mutations from a failed operation by
+    // rebuilding the generator from the on-disk map, so a failed tool call
+    // cannot be silently persisted by a later one.
+    async function resyncFromDisk() {
+        if (state.generator) {
+            await refreshGenerator();
+        }
+    }
+    // Apply a configuration change transactionally: snapshot the config,
+    // mutate, rebuild the generator, optionally reinstall, then save. On any
+    // failure, restore the snapshot and resync from disk so a rejected change
+    // never lingers in memory to activate on a later call. Runs exclusively so
+    // it cannot interleave with another mutating handler.
+    function applyConfigChange(mutate, reinstall) {
+        return runExclusive(async () => {
+            const previousOptions = { ...state.generatorOptions };
+            const previousEnv = [...state.env];
+            try {
+                mutate();
+                await refreshGenerator();
+                if (reinstall) {
+                    await reinstallTopLevelImports();
+                }
+                await saveImportMap();
+            }
+            catch (error) {
+                state.generatorOptions = previousOptions;
+                state.env = previousEnv;
+                await resyncFromDisk();
+                throw error;
+            }
+        });
+    }
+    async function saveImportMap() {
+        const projectPath = ensureStateProjectPath();
+        const generator = getGenerator();
+        const projectUrl = pathToFileURL(trailingSlash(projectPath));
+        try {
+            if (state.mapTarget === "importmap") {
+                const importMapPath = getImportMapLocation(projectPath);
+                const parentDirectory = dirname(importMapPath);
+                await ensureWritable(parentDirectory);
+                writeFileSync(importMapPath, `${JSON.stringify(generator.getMap(), null, 2)}\n`, "utf-8");
+                return;
+            }
+            const htmlPath = resolveProjectFilePath(state.htmlFileName);
+            const htmlSource = readFileSync(htmlPath, "utf-8");
+            await ensureWritable(htmlPath);
+            const injectedHtml = await generator.htmlInject(htmlSource, {
+                trace: true,
+                pins: true,
+                htmlUrl: pathToFileURL(htmlPath),
+                rootUrl: projectUrl,
+                esModuleShims: state.esModuleShims,
+            });
+            writeFileSync(htmlPath, injectedHtml, "utf-8");
+        }
+        catch (error) {
+            if (error.code === "EACCES") {
+                throw new Error("Permission denied while updating the import map target");
+            }
+            throw error;
+        }
+    }
+    return {
+        state,
+        failure,
+        ensureStateProjectPath,
+        resolveProjectFilePath,
+        getGenerator,
+        setEnv,
+        setGeneratorOptions,
+        setProviderOverride,
+        removeProviderOverride,
+        setResolution,
+        removeResolution,
+        setIgnoreList,
+        reinstallTopLevelImports,
+        refreshGenerator,
+        resyncFromDisk,
+        applyConfigChange,
+        runExclusive,
+        saveImportMap,
+        setDefaultMapTarget,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}

package/dist/generator-options.d.ts

@@ -0,0 +1,64 @@
+import { type GeneratorOptions } from "@jspm/generator";
+import { z } from "zod";
+export declare const PROVIDER_SCHEMA: z.ZodEnum<["jspm.io", "jspm.io#system", "nodemodules", "skypack", "jsdelivr", "unpkg", "esm.sh"]>;
+export declare const PROJECT_GENERATOR_OPTION_KEYS: readonly ["commonJS", "typeScript", "system", "integrity", "fetchRetries", "defaultProvider", "cache", "providers", "resolutions", "ignore"];
+export type ProjectGeneratorOptions = Required<Pick<GeneratorOptions, (typeof PROJECT_GENERATOR_OPTION_KEYS)[number]>>;
+export declare const DEFAULT_GENERATOR_OPTIONS: {
+    commonJS: false;
+    typeScript: false;
+    system: false;
+    integrity: false;
+    fetchRetries: number;
+    defaultProvider: string;
+    cache: true;
+    providers: {};
+    resolutions: {};
+    ignore: never[];
+};
+export declare const PROJECT_GENERATOR_OPTION_FIELDS: {
+    readonly commonJS: z.ZodOptional<z.ZodBoolean>;
+    readonly typeScript: z.ZodOptional<z.ZodBoolean>;
+    readonly system: z.ZodOptional<z.ZodBoolean>;
+    readonly integrity: z.ZodOptional<z.ZodBoolean>;
+    readonly fetchRetries: z.ZodOptional<z.ZodNumber>;
+    readonly defaultProvider: z.ZodOptional<z.ZodEnum<["jspm.io", "jspm.io#system", "nodemodules", "skypack", "jsdelivr", "unpkg", "esm.sh"]>>;
+    readonly cache: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"offline">]>>;
+    readonly providers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["jspm.io", "jspm.io#system", "nodemodules", "skypack", "jsdelivr", "unpkg", "esm.sh"]>>>;
+    readonly resolutions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    readonly ignore: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+export declare const PROJECT_GENERATOR_OPTIONS_SCHEMA: z.ZodObject<{
+    readonly commonJS: z.ZodOptional<z.ZodBoolean>;
+    readonly typeScript: z.ZodOptional<z.ZodBoolean>;
+    readonly system: z.ZodOptional<z.ZodBoolean>;
+    readonly integrity: z.ZodOptional<z.ZodBoolean>;
+    readonly fetchRetries: z.ZodOptional<z.ZodNumber>;
+    readonly defaultProvider: z.ZodOptional<z.ZodEnum<["jspm.io", "jspm.io#system", "nodemodules", "skypack", "jsdelivr", "unpkg", "esm.sh"]>>;
+    readonly cache: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"offline">]>>;
+    readonly providers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["jspm.io", "jspm.io#system", "nodemodules", "skypack", "jsdelivr", "unpkg", "esm.sh"]>>>;
+    readonly resolutions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    readonly ignore: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    commonJS?: boolean | undefined;
+    typeScript?: boolean | undefined;
+    system?: boolean | undefined;
+    integrity?: boolean | undefined;
+    fetchRetries?: number | undefined;
+    defaultProvider?: "jspm.io" | "jspm.io#system" | "nodemodules" | "skypack" | "jsdelivr" | "unpkg" | "esm.sh" | undefined;
+    cache?: boolean | "offline" | undefined;
+    providers?: Record<string, "jspm.io" | "jspm.io#system" | "nodemodules" | "skypack" | "jsdelivr" | "unpkg" | "esm.sh"> | undefined;
+    resolutions?: Record<string, string> | undefined;
+    ignore?: string[] | undefined;
+}, {
+    commonJS?: boolean | undefined;
+    typeScript?: boolean | undefined;
+    system?: boolean | undefined;
+    integrity?: boolean | undefined;
+    fetchRetries?: number | undefined;
+    defaultProvider?: "jspm.io" | "jspm.io#system" | "nodemodules" | "skypack" | "jsdelivr" | "unpkg" | "esm.sh" | undefined;
+    cache?: boolean | "offline" | undefined;
+    providers?: Record<string, "jspm.io" | "jspm.io#system" | "nodemodules" | "skypack" | "jsdelivr" | "unpkg" | "esm.sh"> | undefined;
+    resolutions?: Record<string, string> | undefined;
+    ignore?: string[] | undefined;
+}>;
+//# sourceMappingURL=generator-options.d.ts.map

package/dist/generator-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-options.d.ts","sourceRoot":"","sources":["../src/generator-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,gBAAgB,EAAC,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAA;AAErB,eAAO,MAAM,eAAe,mGAQ1B,CAAA;AAEF,eAAO,MAAM,6BAA6B,8IAWhC,CAAA;AAEV,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAC5C,IAAI,CAAC,gBAAgB,EAAE,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC,CACvE,CAAA;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;CAWH,CAAA;AAEnC,eAAO,MAAM,+BAA+B;;;;;;;;;;;CA+ClC,CAAA;AAEV,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5C,CAAA"}