@zhin.js/runtime 1.0.17 → 1.0.18

package/lib/config-composer.d.ts

@@ -23,6 +23,8 @@ export declare class ConfigValidationError extends Error {
     source?: string | undefined);
 }
 export declare class ConfigComposer {
+    private readonly inactivePluginInstanceKeys;
+    constructor(inactivePluginInstanceKeys?: readonly string[]);
     compose(graph: ProjectGraph, input?: RuntimeConfigDocument, 
     /** Source config file name, annotated on ConfigValidationError. */
     source?: string): Promise<ComposedConfig>;

package/lib/config-composer.js

@@ -36,6 +36,10 @@ export class ConfigValidationError extends Error {
     }
 }
 export class ConfigComposer {
+    inactivePluginInstanceKeys;
+    constructor(inactivePluginInstanceKeys = []) {
+        this.inactivePluginInstanceKeys = inactivePluginInstanceKeys;
+    }
     async compose(graph, input = {}, 
     /** Source config file name, annotated on ConfigValidationError. */
     source) {
@@ -61,7 +65,10 @@ export class ConfigComposer {
                     type: 'object',
                     additionalProperties: false,
                     default: {},
-                    properties: Object.fromEntries(childSchemas.map(([key, schema]) => [key, withDefault(schema)])),
+                    properties: Object.fromEntries([
+                        ...this.inactivePluginInstanceKeys.map((key) => [key, {}]),
+                        ...childSchemas.map(([key, schema]) => [key, withDefault(schema)]),
+                    ]),
                 },
             },
         });

package/lib/project-graph.d.ts

@@ -20,6 +20,7 @@ export interface ProjectGraph {
 }
 export interface ProjectGraphServiceOptions {
     readonly engineVersion?: string;
+    readonly disabledPluginInstanceKeys?: readonly string[];
 }
 export declare class ProjectGraphError extends Error {
     constructor(message: string);

package/lib/project-graph.js

@@ -11,11 +11,15 @@ export class ProjectGraphError extends Error {
 export class ProjectGraphService {
     #resolver;
     #engineVersion;
+    #disabledPluginInstanceKeys;
     constructor(resolver, engineVersionOrOptions = runtimeEngineVersion) {
         this.#resolver = resolver;
         this.#engineVersion = typeof engineVersionOrOptions === 'string'
             ? engineVersionOrOptions
             : (engineVersionOrOptions.engineVersion ?? runtimeEngineVersion);
+        this.#disabledPluginInstanceKeys = new Set(typeof engineVersionOrOptions === 'string'
+            ? []
+            : (engineVersionOrOptions.disabledPluginInstanceKeys ?? []));
     }
     async inspect(projectRoot) {
         const rootPackage = await this.#resolver.root(projectRoot);
@@ -58,6 +62,9 @@ export class ProjectGraphService {
                 pluginRefs = mergeChildPluginReferences(manifest.plugins, inheritedPlugins);
             }
         }
+        if (isRoot && this.#disabledPluginInstanceKeys.size > 0) {
+            pluginRefs = pluginRefs.filter((reference) => !this.#disabledPluginInstanceKeys.has(reference.instanceKey));
+        }
         const featurePackages = new Set();
         const features = await Promise.all(featureRefs.map(async (reference) => {
             if (featurePackages.has(reference.package)) {

package/lib/root-runtime.d.ts

@@ -21,6 +21,7 @@ export interface RootRuntimeOptions {
     readonly installResources?: RootResourceInstaller;
     readonly isolation?: IsolatedPluginRuntimePort;
     readonly onControlError?: ControlErrorHandler;
+    readonly disabledPluginInstanceKeys?: readonly string[];
 }
 export type RootHmrOptions = Omit<HmrCoordinatorOptions, 'modules' | 'ownership' | 'runtime'>;
 export declare class RootRuntime {

package/lib/root-runtime.js

@@ -37,6 +37,7 @@ export class RootRuntime {
     #configPatchTail = Promise.resolve();
     #stopResult;
     #controller;
+    #disabledPluginInstanceKeys;
     constructor(options) {
         this.#projectRoot = resolve(options.projectRoot);
         this.#modules = options.modules;
@@ -50,6 +51,7 @@ export class RootRuntime {
             this.#configDocument = structuredClone(options.config ?? {});
         this.#installResources = options.installResources;
         this.#isolation = options.isolation;
+        this.#disabledPluginInstanceKeys = Object.freeze([...(options.disabledPluginInstanceKeys ?? [])]);
         this.#controller = new RootController(emptyState(), options.onControlError, Object.freeze({ ownership: SourceOwnershipIndex.empty() }));
     }
     get snapshot() {
@@ -187,7 +189,9 @@ export class RootRuntime {
     }
     async #inspectProject() {
         const resolver = await NodePackageResolver.create(this.#projectRoot);
-        const graph = await new ProjectGraphService(resolver).inspect(this.#projectRoot);
+        const graph = await new ProjectGraphService(resolver, {
+            disabledPluginInstanceKeys: this.#disabledPluginInstanceKeys,
+        }).inspect(this.#projectRoot);
         await this.#refreshConfigDocument();
         if (this.#configResolver) {
             return {
@@ -196,7 +200,8 @@ export class RootRuntime {
                 primaryConfigDocument: Object.freeze({}),
             };
         }
-        const composed = await new ConfigComposer().compose(graph, this.#configDocument);
+        const composed = await new ConfigComposer(this.#disabledPluginInstanceKeys)
+            .compose(graph, this.#configDocument);
         return {
             graph,
             configResolver: this.#configViewResolver(composed.views),
@@ -243,8 +248,10 @@ export class RootRuntime {
             let prepared;
             signal.throwIfAborted();
             const resolver = await NodePackageResolver.create(this.#projectRoot);
-            const graph = await new ProjectGraphService(resolver).inspect(this.#projectRoot);
-            const planned = await new ConfigPatchPlanner().plan(graph, currentDocument, patches);
+            const graph = await new ProjectGraphService(resolver, {
+                disabledPluginInstanceKeys: this.#disabledPluginInstanceKeys,
+            }).inspect(this.#projectRoot);
+            const planned = await new ConfigPatchPlanner(new ConfigComposer(this.#disabledPluginInstanceKeys)).plan(graph, currentDocument, patches);
             plan = planned;
             if (!planned.documentChanged)
                 return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/runtime",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "description": "Static Plugin graph, generation transaction and HMR Root runtime for Zhin.js",
   "type": "module",
   "main": "./lib/index.js",
@@ -25,8 +25,8 @@
     "@types/node": "^26.1.2",
     "typescript": "^6.0.3",
     "@zhin.js/adapter": "1.2.1",
-    "@zhin.js/command": "1.0.16",
     "@zhin.js/agent-feature": "1.0.13",
+    "@zhin.js/command": "1.0.16",
     "@zhin.js/component": "1.0.13",
     "@zhin.js/layout": "1.0.13",
     "@zhin.js/mcp-feature": "1.0.13",