@monosmith/plugin-sdk 2.0.0-beta.2 → 2.0.0-beta.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monosmith/plugin-sdk",
-  "version": "2.0.0-beta.2",
+  "version": "2.0.0-beta.4",
   "description": "The TypeScript SDK for writing smith plugins: the protocol's types, the serve loop, a test host, the conformance checks, templating and key-order-keeping JSON editing. No runtime dependencies.",
   "license": "MIT",
   "type": "module",

package/protocol/protocol-schema.contract.js

@@ -616,6 +616,10 @@ export const protocolSchema = {
                 "channels": {
                     "type": "boolean",
                     "description": "Channels says a prerelease version the plugin publishes never takes the place of the stable one: the plugin publishes under PublishParams.Tag, a release channel's name, without moving the registry's stable pointer (npm's latest), or its registry orders a prerelease below the release (PyPI, NuGet) and needs no tag. A host does not publish a package of a release channel with a plugin that lacks it."
+                },
+                "declared": {
+                    "type": "boolean",
+                    "description": "Declared says the plugin describes the projects smith.toml declares for its language (DiscoverParams.declared): folders with no manifest of their own. A plugin without it finds a project by its manifest only, and the host refuses a declaration for its language with a message that says so."
                 }
             }
         },
@@ -1145,6 +1149,13 @@ export const protocolSchema = {
                         "$ref": "#/$defs/DeclaredProject"
                     },
                     "description": "Declared are the projects smith.toml declares for this plugin's language ([projects.<name>] with a root and a language): folders with no manifest of their own, such as a program that is a package of the Go module above it. The plugin describes each one in its result, or answers with an error saying why it cannot."
+                },
+                "settings": {
+                    "type": "object",
+                    "additionalProperties": {
+                        "type": "object"
+                    },
+                    "description": "Settings are this plugin's settings for projects, by project name, from smith.toml [projects.<project>.settings.<plugin>]. They reach the plugin here because the tasks it describes may depend on them (the Go plugin's build tags). A project with no settings is absent."
                 }
             },
             "required": [

package/protocol/protocol-types.contract.d.ts

@@ -204,6 +204,13 @@ export interface Capabilities {
      * plugin that lacks it.
      */
     channels?: boolean;
+    /**
+     * Declared says the plugin describes the projects smith.toml declares for its language
+     * (DiscoverParams.declared): folders with no manifest of their own. A plugin without it finds a
+     * project by its manifest only, and the host refuses a declaration for its language with a
+     * message that says so.
+     */
+    declared?: boolean;
 }
 /**
  * ChangeKindParams asks a plugin what changing a project's kind edits. The plugin writes nothing:
@@ -518,6 +525,13 @@ export interface DiscoverParams {
      * an error saying why it cannot.
      */
     declared?: DeclaredProject[];
+    /**
+     * Settings are this plugin's settings for projects, by project name, from smith.toml
+     * [projects.<project>.settings.<plugin>]. They reach the plugin here because the tasks it
+     * describes may depend on them (the Go plugin's build tags). A project with no settings is
+     * absent.
+     */
+    settings?: Record<string, Record<string, unknown>>;
 }
 /**
  * DiscoverResult describes every manifest that is a project of this plugin. A manifest the plugin