@zudojs/plugins 1.3.0 → 1.3.2

package/README.md

@@ -102,6 +102,24 @@ and the dependency itself. Cycles throw `PluginDependencyCycleError` with
 the cycle path. Optional dependencies that are present still participate in
 ordering; optional dependencies that are absent are ignored.
 
+A dependency is optional when it is listed in `optionalDependencies` or
+marked `optional: true` inside `dependencies` — the two forms are
+equivalent:
+
+```typescript
+manager.register({
+  metadata: { name: "@acme/api" },
+  dependencies: [
+    { name: "@acme/db" }, // required: start() throws if it is missing
+    { name: "@acme/metrics", optional: true }, // skipped when missing
+  ],
+});
+// Same as: optionalDependencies: [{ name: "@acme/metrics" }]
+```
+
+When `@acme/metrics` is registered, `@acme/api` starts after it, and any
+`version` constraint on it is enforced.
+
 Declared versions are enforced before any hook runs:
 
 ```typescript

package/dist/pluginDependencies/dependencyResolver.core.d.ts

@@ -41,7 +41,8 @@ export declare class DependencyResolver {
      * Optional dependencies that are present participate in ordering — a
      * plugin that optionally integrates with a peer must still start after
      * it — while optional dependencies that are absent are ignored rather
-     * than reported missing.
+     * than reported missing. A dependency is optional when it is listed in
+     * `optionalDependencies` or carries `optional: true` in `dependencies`.
      */
     resolve(plugins: Map<string, ResolvablePlugin>): DependencyResolution;
     /**

package/dist/pluginDependencies/dependencyResolver.core.js

@@ -9,14 +9,15 @@ export class DependencyResolver {
      * Optional dependencies that are present participate in ordering — a
      * plugin that optionally integrates with a peer must still start after
      * it — while optional dependencies that are absent are ignored rather
-     * than reported missing.
+     * than reported missing. A dependency is optional when it is listed in
+     * `optionalDependencies` or carries `optional: true` in `dependencies`.
      */
     resolve(plugins) {
         const missingDetails = [];
         const cycles = [];
         for (const [name, plugin] of plugins) {
             for (const dep of plugin.dependencies ?? []) {
-                if (!plugins.has(dep.name)) {
+                if (dep.optional !== true && !plugins.has(dep.name)) {
                     missingDetails.push({ plugin: name, dependency: dep.name });
                 }
             }

package/dist/pluginTypes/pluginDependency.type.d.ts

@@ -4,6 +4,11 @@
 export interface PluginDependency {
     readonly name: string;
     readonly version?: string;
+    /**
+     * When `true`, a missing plugin of this name is skipped instead of
+     * failing `start()`; when it is registered, the declaring plugin still
+     * starts after it. Equivalent to listing it in `optionalDependencies`.
+     */
     readonly optional?: boolean;
 }
 //# sourceMappingURL=pluginDependency.type.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zudojs/plugins",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Plugin system for extending Zudojs applications with modular capabilities.",
   "license": "MIT",
   "author": {
@@ -24,11 +24,11 @@
     "!dist/.tsbuildinfo"
   ],
   "dependencies": {
-    "@zudojs/errors": "1.3.0"
+    "@zudojs/errors": "1.3.1"
   },
   "devDependencies": {
     "@types/node": "^26.6.2",
-    "@zudojs/events": "1.3.0",
+    "@zudojs/events": "1.3.2",
     "typescript": "7.0.2",
     "vitest": "^5.0.1"
   },