godot-cli 0.13.3 → 0.15.0

package/dist/lib/types.d.ts

@@ -1,3 +1,4 @@
+import type { ExtensionDescriptor } from '../utils/extensions-catalog.js';
 /**
  * Discriminated union describing every progress event the library can emit to
  * the optional `onProgress` callback. Consumers narrow on `event.phase`.
@@ -360,11 +361,11 @@ export interface AddonMaterializeOutcome {
     /** The local source directory used (`--source` path only). */
     sourceDir?: string;
 }
-/** What `install-plugin` did to the consumer `.csproj`'s PackageReferences. */
+/** What `install-plugin` did to the consumer `.csproj`'s PackageReferences + EmbeddedResources. */
 export interface CsprojPatchOutcome {
     /** Absolute path to the consumer `.csproj` that was patched, if one was found. */
     csprojPath?: string;
-    /** True when the csproj text was modified. */
+    /** True when the csproj text was modified (pins and/or embeds). */
     changed: boolean;
     /** Per-package summary: each addon pin's add / update / unchanged outcome. */
     packages: {
@@ -372,6 +373,12 @@ export interface CsprojPatchOutcome {
         action: 'added' | 'updated' | 'unchanged';
         version: string;
     }[];
+    /** Per-resource summary: each addon `<EmbeddedResource>`'s add / update / unchanged outcome. */
+    embeds: {
+        include: string;
+        action: 'added' | 'updated' | 'unchanged';
+        logicalName: string;
+    }[];
 }
 export interface InstallPluginSuccess {
     kind: 'success';
@@ -415,3 +422,57 @@ export interface RemovePluginFailure {
     error: Error;
 }
 export type RemovePluginResult = RemovePluginSuccess | RemovePluginFailure;
+/**
+ * What `installExtension` did to the consumer `.csproj` — the CLI mirror of the dock's
+ * `ExtensionInstallOutcome`:
+ *  - `added`             — the `<PackageReference>` was newly added (rebuild required).
+ *  - `updated`           — its version was bumped up (rebuild required).
+ *  - `already-up-to-date`— present at an equal/newer version, or the descriptor has no pin (no write).
+ *  - `no-project`        — no consumer `.csproj` was found to install into (nothing written).
+ */
+export type ExtensionInstallOutcome = 'added' | 'updated' | 'already-up-to-date' | 'no-project';
+export interface InstallExtensionOptions {
+    /** Absolute or relative path to the Godot project root (holds `project.godot` + the consumer `.csproj`). */
+    godotProjectPath: string;
+    /** The extension `<id>` to install — matched against the catalog by `packageId` (then `name`), case-insensitive. */
+    extensionId: string;
+    /** Override the catalog's pinned version for this install (the `--version` flag). Ignored when empty. */
+    version?: string;
+    /**
+     * Catalog to resolve `extensionId` against. Defaults to the bundled `EXTENSIONS_CATALOG`
+     * (single-sourced from `addons/godot_mcp/extensions.catalog.json`). Injectable for tests.
+     */
+    catalog?: readonly ExtensionDescriptor[];
+    onProgress?: ProgressCallback;
+}
+export interface InstallExtensionSuccess {
+    kind: 'success';
+    success: true;
+    /** The classified outcome (added / updated / already-up-to-date / no-project). */
+    outcome: ExtensionInstallOutcome;
+    /** True when the `.csproj` was written (added or updated). */
+    changed: boolean;
+    /** True when a write happened, so the consumer must rebuild solutions (Godot has no programmatic restore). */
+    rebuildRequired: boolean;
+    /** The user-supplied id that resolved to the descriptor. */
+    extensionId: string;
+    /** The resolved descriptor's package id (the `<PackageReference Include>`). */
+    packageId: string;
+    /** Version currently referenced before this install: `null` when not installed, `''` when referenced unversioned. */
+    fromVersion: string | null;
+    /** The version this install targeted (catalog pin or `--version` override), or `null` when unpinned. */
+    toVersion: string | null;
+    /** Absolute path to the consumer `.csproj`, when one was located. */
+    csprojPath?: string;
+    /** A short human-readable status line, safe to print. */
+    message: string;
+    warnings: string[];
+}
+export interface InstallExtensionFailure {
+    kind: 'failure';
+    success: false;
+    projectGodotPath?: string;
+    warnings: string[];
+    error: Error;
+}
+export type InstallExtensionResult = InstallExtensionSuccess | InstallExtensionFailure;

package/dist/lib.d.ts

@@ -5,4 +5,7 @@ export { runTool, runSystemTool } from './lib/run-tool.js';
 export { setupMcp, listAgentIds } from './lib/setup-mcp.js';
 export { setupSkills } from './lib/setup-skills.js';
 export { installPlugin, removePlugin } from './lib/install-plugin.js';
-export type { ProgressEvent, ProgressCallback, ResultKind, OpenProjectOptions, OpenProjectResult, OpenProjectSuccess, OpenProjectFailure, OpenProjectAuthOption, OpenProjectConnectionMode, BuildProjectOptions, BuildProjectResult, BuildProjectSuccess, BuildProjectFailure, BuildSkipReason, CreateProjectOptions, CreateProjectResult, CreateProjectSuccess, CreateProjectFailure, RunToolOptions, RunToolResult, RunToolSuccess, RunToolFailure, RunToolFailureReason, RunSystemToolOptions, RunSystemToolResult, RunSystemToolSuccess, RunSystemToolFailure, SetupMcpOptions, SetupMcpResult, SetupMcpSuccess, SetupMcpFailure, SetupSkillsOptions, SetupSkillsResult, SetupSkillsSuccess, SetupSkillsFailure, InstallPluginOptions, InstallPluginResult, InstallPluginSuccess, InstallPluginFailure, AddonMaterializeOutcome, CsprojPatchOutcome, RemovePluginOptions, RemovePluginResult, RemovePluginSuccess, RemovePluginFailure, } from './lib/types.js';
+export { installExtension } from './lib/install-extension.js';
+export { EXTENSIONS_CATALOG, findExtension, hasVersion } from './utils/extensions-catalog.js';
+export type { ExtensionDescriptor, ExtensionTool } from './utils/extensions-catalog.js';
+export type { ProgressEvent, ProgressCallback, ResultKind, OpenProjectOptions, OpenProjectResult, OpenProjectSuccess, OpenProjectFailure, OpenProjectAuthOption, OpenProjectConnectionMode, BuildProjectOptions, BuildProjectResult, BuildProjectSuccess, BuildProjectFailure, BuildSkipReason, CreateProjectOptions, CreateProjectResult, CreateProjectSuccess, CreateProjectFailure, RunToolOptions, RunToolResult, RunToolSuccess, RunToolFailure, RunToolFailureReason, RunSystemToolOptions, RunSystemToolResult, RunSystemToolSuccess, RunSystemToolFailure, SetupMcpOptions, SetupMcpResult, SetupMcpSuccess, SetupMcpFailure, SetupSkillsOptions, SetupSkillsResult, SetupSkillsSuccess, SetupSkillsFailure, InstallPluginOptions, InstallPluginResult, InstallPluginSuccess, InstallPluginFailure, AddonMaterializeOutcome, CsprojPatchOutcome, RemovePluginOptions, RemovePluginResult, RemovePluginSuccess, RemovePluginFailure, InstallExtensionOptions, InstallExtensionResult, InstallExtensionSuccess, InstallExtensionFailure, ExtensionInstallOutcome, } from './lib/types.js';

package/dist/lib.js

@@ -19,4 +19,8 @@ export { runTool, runSystemTool } from './lib/run-tool.js';
 export { setupMcp, listAgentIds } from './lib/setup-mcp.js';
 export { setupSkills } from './lib/setup-skills.js';
 export { installPlugin, removePlugin } from './lib/install-plugin.js';
+export { installExtension } from './lib/install-extension.js';
+// Shared extension catalog (single-sourced from addons/godot_mcp/extensions.catalog.json)
+// + its lookup helpers, so the app can render the same list the dock + CLI install from.
+export { EXTENSIONS_CATALOG, findExtension, hasVersion } from './utils/extensions-catalog.js';
 //# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -1 +1 @@
-{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,eAAe;AACf,+EAA+E;AAC/E,wDAAwD;AACxD,oDAAoD;AACpD,yEAAyE;AACzE,4DAA4D;AAC5D,+EAA+E;AAC/E,gEAAgE;AAChE,6EAA6E;AAC7E,EAAE;AACF,0EAA0E;AAC1E,4CAA4C;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,eAAe;AACf,+EAA+E;AAC/E,wDAAwD;AACxD,oDAAoD;AACpD,yEAAyE;AACzE,4DAA4D;AAC5D,+EAA+E;AAC/E,gEAAgE;AAChE,6EAA6E;AAC7E,EAAE;AACF,0EAA0E;AAC1E,4CAA4C;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,0FAA0F;AAC1F,yFAAyF;AACzF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/utils/addon-deps.d.ts

@@ -5,11 +5,34 @@ export interface AddonPackageReference {
     /** The pinned version (the `Version=` attribute). */
     version: string;
 }
+/**
+ * A single `<EmbeddedResource>` the consumer csproj must declare so an asset the
+ * addon reads at editor runtime via `GetManifestResourceStream` is embedded into
+ * the consumer's compiled project assembly (Godot globs every `*.cs` into one
+ * assembly, but does NOT carry the addon's own `Godot-MCP.csproj` `<EmbeddedResource>`
+ * — the addon ships as source, not a NuGet package).
+ */
+export interface AddonEmbeddedResource {
+    /** The file to embed, relative to the consumer project root (the `Include=` attribute). */
+    include: string;
+    /** The manifest-resource name the addon resolves it by (the `LogicalName=` attribute). */
+    logicalName: string;
+}
 /**
  * The exact NuGet `PackageReference`s the consumer's project `.csproj` needs,
  * single-sourced from the addon's `Godot-MCP.csproj` pins. Order matches the
  * addon csproj (ReflectorNet first, then McpPlugin).
  */
 export declare const ADDON_PACKAGE_REFERENCES: readonly AddonPackageReference[];
+/**
+ * The exact `<EmbeddedResource>`s the consumer's project `.csproj` needs, single-sourced
+ * from the addon's `Godot-MCP.csproj`. The extension catalog is read at editor runtime by
+ * the pure-managed `GodotExtensionRegistry` via `GetManifestResourceStream` (no `res://` /
+ * filesystem fallback), so without this embed a consumer that installs via `install-plugin`
+ * gets an EMPTY Extensions panel. A parity test (`cli/tests/addon-deps-parity.test.ts`)
+ * reads `Godot-MCP.csproj` and FAILS the build if these constants ever drift from the addon's
+ * own `<EmbeddedResource>` (Include path + LogicalName), mirroring the NuGet-pin tripwire.
+ */
+export declare const ADDON_EMBEDDED_RESOURCES: readonly AddonEmbeddedResource[];
 /** The resource path of the addon manifest a consumer project loads the plugin from. */
 export declare const ADDON_PLUGIN_CFG_RESOURCE = "res://addons/godot_mcp/plugin.cfg";

package/dist/utils/addon-deps.js

@@ -22,6 +22,21 @@ export const ADDON_PACKAGE_REFERENCES = [
     { id: 'com.IvanMurzak.ReflectorNet', version: '5.3.1' },
     { id: 'com.IvanMurzak.McpPlugin', version: '6.10.0' },
 ];
+/**
+ * The exact `<EmbeddedResource>`s the consumer's project `.csproj` needs, single-sourced
+ * from the addon's `Godot-MCP.csproj`. The extension catalog is read at editor runtime by
+ * the pure-managed `GodotExtensionRegistry` via `GetManifestResourceStream` (no `res://` /
+ * filesystem fallback), so without this embed a consumer that installs via `install-plugin`
+ * gets an EMPTY Extensions panel. A parity test (`cli/tests/addon-deps-parity.test.ts`)
+ * reads `Godot-MCP.csproj` and FAILS the build if these constants ever drift from the addon's
+ * own `<EmbeddedResource>` (Include path + LogicalName), mirroring the NuGet-pin tripwire.
+ */
+export const ADDON_EMBEDDED_RESOURCES = [
+    {
+        include: 'addons/godot_mcp/extensions.catalog.json',
+        logicalName: 'Godot-MCP.extensions.catalog.json',
+    },
+];
 /** The resource path of the addon manifest a consumer project loads the plugin from. */
 export const ADDON_PLUGIN_CFG_RESOURCE = 'res://addons/godot_mcp/plugin.cfg';
 //# sourceMappingURL=addon-deps.js.map

package/dist/utils/addon-deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"addon-deps.js","sourceRoot":"","sources":["../../src/utils/addon-deps.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,mFAAmF;AACnF,oEAAoE;AACpE,8EAA8E;AAC9E,yEAAyE;AACzE,EAAE;AACF,6EAA6E;AAC7E,kFAAkF;AAClF,8EAA8E;AAC9E,4EAA4E;AAC5E,iFAAiF;AACjF,iFAAiF;AACjF,+CAA+C;AAC/C,EAAE;AACF,sEAAsE;AAUtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACxE,EAAE,EAAE,EAAE,6BAA6B,EAAE,OAAO,EAAE,OAAO,EAAE;IACvD,EAAE,EAAE,EAAE,0BAA0B,EAAE,OAAO,EAAE,QAAQ,EAAE;CAC7C,CAAC;AAEX,wFAAwF;AACxF,MAAM,CAAC,MAAM,yBAAyB,GAAG,mCAAmC,CAAC"}
+{"version":3,"file":"addon-deps.js","sourceRoot":"","sources":["../../src/utils/addon-deps.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,mFAAmF;AACnF,oEAAoE;AACpE,8EAA8E;AAC9E,yEAAyE;AACzE,EAAE;AACF,6EAA6E;AAC7E,kFAAkF;AAClF,8EAA8E;AAC9E,4EAA4E;AAC5E,iFAAiF;AACjF,iFAAiF;AACjF,+CAA+C;AAC/C,EAAE;AACF,sEAAsE;AAwBtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACxE,EAAE,EAAE,EAAE,6BAA6B,EAAE,OAAO,EAAE,OAAO,EAAE;IACvD,EAAE,EAAE,EAAE,0BAA0B,EAAE,OAAO,EAAE,QAAQ,EAAE;CAC7C,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACxE;QACE,OAAO,EAAE,0CAA0C;QACnD,WAAW,EAAE,mCAAmC;KACjD;CACO,CAAC;AAEX,wFAAwF;AACxF,MAAM,CAAC,MAAM,yBAAyB,GAAG,mCAAmC,CAAC"}

package/dist/utils/csproj-deps.d.ts

@@ -1,4 +1,4 @@
-import { type AddonPackageReference } from './addon-deps.js';
+import { type AddonPackageReference, type AddonEmbeddedResource } from './addon-deps.js';
 /**
  * Idempotently reconcile a Godot consumer `.csproj`'s `<PackageReference>`s so it
  * declares exactly the addon's two required NuGet pins (see `addon-deps.ts`).
@@ -37,4 +37,40 @@ export interface CsprojPatchResult {
     /** One entry per required package describing what happened to it. */
     changes: CsprojPatchChange[];
 }
+export type CsprojEmbedChange = {
+    include: string;
+    action: 'added';
+    logicalName: string;
+} | {
+    include: string;
+    action: 'updated';
+    from: string;
+    logicalName: string;
+} | {
+    include: string;
+    action: 'unchanged';
+    logicalName: string;
+};
+export interface CsprojEmbedResult {
+    /** The new csproj text (identical to input when nothing changed). */
+    text: string;
+    /** True when the text was modified. */
+    changed: boolean;
+    /** One entry per required embedded resource describing what happened to it. */
+    changes: CsprojEmbedChange[];
+}
 export declare function addAddonPackageReferences(csprojText: string, requiredRefs?: readonly AddonPackageReference[]): CsprojPatchResult;
+/**
+ * Idempotently reconcile a Godot consumer `.csproj`'s `<EmbeddedResource>`s so it
+ * declares exactly the addon's required embeds (see `addon-deps.ts`
+ * `ADDON_EMBEDDED_RESOURCES`). Pure (operates on csproj TEXT, never touches the
+ * filesystem) and exported for unit tests. Sibling of `addAddonPackageReferences`.
+ * Handles, idempotently:
+ *  - a project with NO `<EmbeddedResource>` ItemGroup (groups into one, else appends
+ *    a fresh `<ItemGroup>` before `</Project>`);
+ *  - a project that already embeds the resource with the right LogicalName (no change);
+ *  - a project that embeds the same Include with a DIFFERENT LogicalName (reconciles
+ *    in place);
+ * Re-running `install-plugin` therefore never duplicates the `<EmbeddedResource>`.
+ */
+export declare function addAddonEmbeddedResources(csprojText: string, requiredResources?: readonly AddonEmbeddedResource[]): CsprojEmbedResult;

package/dist/utils/csproj-deps.js

@@ -1,4 +1,4 @@
-import { ADDON_PACKAGE_REFERENCES } from './addon-deps.js';
+import { ADDON_PACKAGE_REFERENCES, ADDON_EMBEDDED_RESOURCES, } from './addon-deps.js';
 /** Escape a string for use inside a RegExp source. */
 function escapeRegExp(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
@@ -18,16 +18,32 @@ function packageRefRegex(id) {
         `|` +
         `<PackageReference\\b[^>]*?\\bVersion\\s*=\\s*"([^"]*)"[^>]*?\\bInclude\\s*=\\s*"${escId}"[^>]*?(?:/>|></PackageReference>)`, 'i');
 }
+/**
+ * Match an existing `<EmbeddedResource ... Include="<include>" ... />` element for a
+ * specific file path, capturing the whole element (in either attribute order, and
+ * whether self-closed `/>` or an explicit `></EmbeddedResource>` pair). The
+ * `LogicalName` is extracted from the captured element text separately so the regex
+ * stays order-agnostic and tolerant of an absent `LogicalName`.
+ */
+function embeddedResourceRegex(include) {
+    const escInclude = escapeRegExp(include);
+    return new RegExp(`<EmbeddedResource\\b[^>]*?\\bInclude\\s*=\\s*"${escInclude}"[^>]*?(?:/>|></EmbeddedResource>)`, 'i');
+}
 /** Render the canonical self-closing element for a required reference. */
 function renderRef(ref) {
     return `<PackageReference Include="${ref.id}" Version="${ref.version}" />`;
 }
+/** Render the canonical self-closing element for a required embedded resource. */
+function renderEmbed(res) {
+    return `<EmbeddedResource Include="${res.include}" LogicalName="${res.logicalName}" />`;
+}
 /**
- * Detect the indentation used by the FIRST existing `<PackageReference>` (or fall
- * back to 4 spaces) so appended/inserted elements match the consumer's style.
+ * Detect the indentation used by the FIRST existing `<PackageReference>` /
+ * `<EmbeddedResource>` (or fall back to 4 spaces) so appended/inserted elements
+ * match the consumer's style.
  */
 function detectIndent(text) {
-    const m = text.match(/\n([ \t]*)<PackageReference\b/);
+    const m = text.match(/\n([ \t]*)<(?:PackageReference|EmbeddedResource)\b/);
     return m ? m[1] : '    ';
 }
 /**
@@ -101,16 +117,99 @@ export function addAddonPackageReferences(csprojText, requiredRefs = ADDON_PACKA
         changes: orderedChanges,
     };
 }
+/**
+ * Idempotently reconcile a Godot consumer `.csproj`'s `<EmbeddedResource>`s so it
+ * declares exactly the addon's required embeds (see `addon-deps.ts`
+ * `ADDON_EMBEDDED_RESOURCES`). Pure (operates on csproj TEXT, never touches the
+ * filesystem) and exported for unit tests. Sibling of `addAddonPackageReferences`.
+ * Handles, idempotently:
+ *  - a project with NO `<EmbeddedResource>` ItemGroup (groups into one, else appends
+ *    a fresh `<ItemGroup>` before `</Project>`);
+ *  - a project that already embeds the resource with the right LogicalName (no change);
+ *  - a project that embeds the same Include with a DIFFERENT LogicalName (reconciles
+ *    in place);
+ * Re-running `install-plugin` therefore never duplicates the `<EmbeddedResource>`.
+ */
+export function addAddonEmbeddedResources(csprojText, requiredResources = ADDON_EMBEDDED_RESOURCES) {
+    const changes = [];
+    let text = csprojText;
+    const indent = detectIndent(text);
+    const eol = detectEol(text);
+    // First pass: reconcile any embeds that already exist (possibly with a different
+    // LogicalName). Collect the ones still missing for the append pass.
+    const missing = [];
+    for (const res of requiredResources) {
+        const re = embeddedResourceRegex(res.include);
+        const match = text.match(re);
+        if (!match) {
+            missing.push(res);
+            continue;
+        }
+        const logicalMatch = match[0].match(/\bLogicalName\s*=\s*"([^"]*)"/i);
+        const existingLogical = logicalMatch ? logicalMatch[1] : '';
+        if (existingLogical === res.logicalName) {
+            changes.push({ include: res.include, action: 'unchanged', logicalName: res.logicalName });
+            continue;
+        }
+        // Reconcile in place: replace the whole element with the canonical embed.
+        text = text.replace(re, renderEmbed(res));
+        changes.push({ include: res.include, action: 'updated', from: existingLogical, logicalName: res.logicalName });
+    }
+    // Second pass: add the missing embeds. Prefer an existing <ItemGroup> that already
+    // holds an <EmbeddedResource> (group them together); else append a fresh
+    // <ItemGroup> just before </Project>. Deliberately NOT grouped with the
+    // PackageReference ItemGroup — the addon's own csproj keeps the two in separate
+    // groups, and this keeps the scaffold's layout identical.
+    if (missing.length > 0) {
+        const block = missing.map((res) => `${indent}${renderEmbed(res)}`).join(eol);
+        const embedItemGroupClose = findItemGroupCloseContaining(text, /<EmbeddedResource\b/i);
+        if (embedItemGroupClose !== -1) {
+            text = `${text.slice(0, embedItemGroupClose)}${block}${eol}${text.slice(embedItemGroupClose)}`;
+        }
+        else {
+            const groupIndent = indent.length >= 2 ? indent.slice(0, Math.floor(indent.length / 2)) : '  ';
+            const newGroup = `${groupIndent}<ItemGroup>${eol}${block}${eol}${groupIndent}</ItemGroup>${eol}`;
+            const closeIdx = text.lastIndexOf('</Project>');
+            if (closeIdx === -1) {
+                text = `${text}${eol}${newGroup}`;
+            }
+            else {
+                text = `${text.slice(0, closeIdx)}${newGroup}${text.slice(closeIdx)}`;
+            }
+        }
+        for (const res of missing) {
+            changes.push({ include: res.include, action: 'added', logicalName: res.logicalName });
+        }
+    }
+    // Restore required-order in `changes` to match `requiredResources` for stable output.
+    const orderedChanges = requiredResources
+        .map((res) => changes.find((c) => c.include === res.include))
+        .filter((c) => c !== undefined);
+    return {
+        text,
+        changed: orderedChanges.some((c) => c.action !== 'unchanged'),
+        changes: orderedChanges,
+    };
+}
 /**
  * Return the index of the `</ItemGroup>` that closes the FIRST `<ItemGroup>`
  * containing a `<PackageReference>`, or -1 when none exists. Used to group the
  * added pins with the consumer's existing package references.
  */
 function findPackageReferenceItemGroupClose(text) {
+    return findItemGroupCloseContaining(text, /<PackageReference\b/i);
+}
+/**
+ * Return the index of the `</ItemGroup>` that closes the FIRST `<ItemGroup>` whose
+ * body matches `childTagRe`, or -1 when none exists. Used to group an added element
+ * with the consumer's existing items of the same kind. `childTagRe` MUST NOT be a
+ * global regex (a stateful `lastIndex` would corrupt the `.test` below).
+ */
+function findItemGroupCloseContaining(text, childTagRe) {
     const itemGroupRe = /<ItemGroup\b[^>]*>([\s\S]*?)<\/ItemGroup>/gi;
     let m;
     while ((m = itemGroupRe.exec(text)) !== null) {
-        if (/<PackageReference\b/i.test(m[1])) {
+        if (childTagRe.test(m[1])) {
             // The close tag starts at the end of the match minus its length.
             const closeTag = '</ItemGroup>';
             return m.index + m[0].length - closeTag.length;

package/dist/utils/csproj-deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"csproj-deps.js","sourceRoot":"","sources":["../../src/utils/csproj-deps.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"csproj-deps.js","sourceRoot":"","sources":["../../src/utils/csproj-deps.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GAGzB,MAAM,iBAAiB,CAAC;AA+CzB,sDAAsD;AACtD,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,EAAU;IACjC,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;IAC/B,qFAAqF;IACrF,gFAAgF;IAChF,gEAAgE;IAChE,OAAO,IAAI,MAAM,CACf,iDAAiD,KAAK,sEAAsE;QAC1H,GAAG;QACH,mFAAmF,KAAK,oCAAoC,EAC9H,GAAG,CACJ,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAAC,OAAe;IAC5C,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,IAAI,MAAM,CACf,iDAAiD,UAAU,oCAAoC,EAC/F,GAAG,CACJ,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,SAAS,SAAS,CAAC,GAA0B;IAC3C,OAAO,8BAA8B,GAAG,CAAC,EAAE,cAAc,GAAG,CAAC,OAAO,MAAM,CAAC;AAC7E,CAAC;AAED,kFAAkF;AAClF,SAAS,WAAW,CAAC,GAA0B;IAC7C,OAAO,8BAA8B,GAAG,CAAC,OAAO,kBAAkB,GAAG,CAAC,WAAW,MAAM,CAAC;AAC1F,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAC3E,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;IACnD,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,UAAkB,EAClB,eAAiD,wBAAwB;IAEzE,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE5B,yEAAyE;IACzE,0EAA0E;IAC1E,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,SAAS;QACX,CAAC;QACD,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnD,IAAI,eAAe,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,SAAS;QACX,CAAC;QACD,wEAAwE;QACxE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,+EAA+E;IAC/E,gFAAgF;IAChF,sCAAsC;IACtC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE3E,MAAM,iBAAiB,GAAG,kCAAkC,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,iBAAiB,KAAK,CAAC,CAAC,EAAE,CAAC;YAC7B,oEAAoE;YACpE,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAAG,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC7F,CAAC;aAAM,CAAC;YACN,sEAAsE;YACtE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/F,MAAM,QAAQ,GAAG,GAAG,WAAW,cAAc,GAAG,GAAG,KAAK,GAAG,GAAG,GAAG,WAAW,eAAe,GAAG,EAAE,CAAC;YACjG,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YAChD,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;gBACpB,wDAAwD;gBACxD,IAAI,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,QAAQ,EAAE,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxE,CAAC;QACH,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,qFAAqF;IACrF,MAAM,cAAc,GAAG,YAAY;SAChC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;SAClD,MAAM,CAAC,CAAC,CAAC,EAA0B,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAE1D,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC;QAC7D,OAAO,EAAE,cAAc;KACxB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAkB,EAClB,oBAAsD,wBAAwB;IAE9E,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE5B,iFAAiF;IACjF,oEAAoE;IACpE,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,SAAS;QACX,CAAC;QACD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACtE,MAAM,eAAe,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,IAAI,eAAe,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YAC1F,SAAS;QACX,CAAC;QACD,0EAA0E;QAC1E,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IACjH,CAAC;IAED,mFAAmF;IACnF,yEAAyE;IACzE,wEAAwE;IACxE,gFAAgF;IAChF,0DAA0D;IAC1D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE7E,MAAM,mBAAmB,GAAG,4BAA4B,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;QACvF,IAAI,mBAAmB,KAAK,CAAC,CAAC,EAAE,CAAC;YAC/B,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,GAAG,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACjG,CAAC;aAAM,CAAC;YACN,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/F,MAAM,QAAQ,GAAG,GAAG,WAAW,cAAc,GAAG,GAAG,KAAK,GAAG,GAAG,GAAG,WAAW,eAAe,GAAG,EAAE,CAAC;YACjG,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YAChD,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;gBACpB,IAAI,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,QAAQ,EAAE,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxE,CAAC;QACH,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAED,sFAAsF;IACtF,MAAM,cAAc,GAAG,iBAAiB;SACrC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;SAC5D,MAAM,CAAC,CAAC,CAAC,EAA0B,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAE1D,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC;QAC7D,OAAO,EAAE,cAAc;KACxB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,kCAAkC,CAAC,IAAY;IACtD,OAAO,4BAA4B,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,SAAS,4BAA4B,CAAC,IAAY,EAAE,UAAkB;IACpE,MAAM,WAAW,GAAG,6CAA6C,CAAC;IAClE,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1B,iEAAiE;YACjE,MAAM,QAAQ,GAAG,cAAc,CAAC;YAChC,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QACjD,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC"}

package/dist/utils/extension-install.d.ts

@@ -0,0 +1,47 @@
+import type { ExtensionDescriptor } from './extensions-catalog.js';
+export type ExtensionInstallAction = 'add' | 'update' | 'noop';
+/**
+ * The MSBuild floating-version marker written for an UNPINNED (null/empty-version) descriptor.
+ * A versionless `<PackageReference Include="x" />` fails NuGet restore with NU1015, so the
+ * "float to latest" intent is materialized as `Version="*"`. Mirrors C# `ExtensionInstallPlanner.FloatVersion`.
+ */
+export declare const FLOAT_VERSION = "*";
+export interface ExtensionInstallPlan {
+    /** The add / update / no-op decision. */
+    action: ExtensionInstallAction;
+    /** The full `.csproj` text after applying the action (=== input for a no-op). */
+    resultingCsproj: string;
+    /** The package id the plan targets. */
+    packageId: string;
+    /** Version currently referenced: `null` when not installed; `''` when referenced without a version. */
+    fromVersion: string | null;
+    /** The version the plan writes: the descriptor's pin when set, `"*"` (the float marker) when unpinned and a reference is added or self-healed, `null` only on a no-op. */
+    toVersion: string | null;
+}
+/** Thrown by {@link planExtensionInstall} on a genuinely unparseable `.csproj` (the lib turns it into a structured failure). */
+export declare class CsprojParseError extends Error {
+}
+/**
+ * Compare two dotted numeric version strings component-by-component as integers
+ * (so `1.10.0` > `1.2.0`, unlike an ordinal string compare). A trailing pre-release
+ * / build suffix on a component (`1.0.0-rc1`) is tolerated — only the leading integer
+ * of each component is read; a non-numeric component reads as 0. Missing trailing
+ * components are treated as 0 (`1.0` === `1.0.0`). Returns >0 when `a` is newer, <0
+ * when older, 0 when equal. Exact port of C# `InstalledStateDetector.CompareVersions`.
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Parse every `<PackageReference>` in the `.csproj` into a `{ packageId → version }`
+ * map (ids lower-cased — NuGet ids are case-insensitive; value is the `Version`
+ * attribute, else a child `<Version>` element, else `''`). Returns an EMPTY map for
+ * empty/whitespace input. Port of C# `InstalledStateDetector.ParsePackageReferences`
+ * (the CLI never needs the bad-XML tolerance branch — the planner validates first).
+ */
+export declare function parsePackageReferences(csprojText: string | null | undefined): Map<string, string>;
+/**
+ * Compute the install plan for `descriptor` against `csprojText`. Port of
+ * `ExtensionInstallPlanner.Plan`. Throws {@link CsprojParseError} only on a genuinely
+ * malformed `.csproj` (no recognizable `<Project ...>` root) — the caller maps that to
+ * a structured failure rather than corrupting the file.
+ */
+export declare function planExtensionInstall(descriptor: ExtensionDescriptor, csprojText: string): ExtensionInstallPlan;