@neocompose/cli 0.27.1 → 0.28.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.27.1",
+  "version": "0.28.0",
   "description": "Neo Compose native project-source CLI with bidirectional sync.",
   "license": "MIT",
   "type": "module",

package/skills/neocompose-cli/SKILL.md

@@ -9,7 +9,7 @@ description: >-
   `@neocompose/cli` or `node cli/bin/neo.mjs` in the neo-compose repository.
 ---
 
-<!-- reviewed-through-cli: 0.27.1 -->
+<!-- reviewed-through-cli: 0.28.0 -->
 
 # Neo Compose CLI
 

package/skills/neocompose-cli/references/cli-development.md

@@ -83,7 +83,7 @@ wrappers.
 The marker near the top of `SKILL.md` must exactly match the package version:
 
 ```html
-<!-- reviewed-through-cli: 0.27.1 -->
+<!-- reviewed-through-cli: 0.28.0 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale

package/skills/neocompose-cli/references/declarations-and-construction.md

@@ -152,6 +152,41 @@ them from member initializers. Each declared constructor must settle every
 required member on its own; a call-site block cannot repair an invalid
 constructor declaration.
 
+## Parameter default values
+
+Default a parameter with `= <constant>` on class headers, declared
+constructors, native functions, NSFunctions, and interface functions:
+
+```neo
+class Foo(string bar = "BAR", int volume = 3) {
+  public string Bar = bar;
+
+  public string Shout(string text = "hey", bool loud = true) {
+    return loud ? text.ToUpper() : text;
+  }
+}
+
+Foo a = new();                 // fully defaulted header: all defaults apply
+Foo b = new(bar: "bar");       // volume fills from its default
+```
+
+Use only constants: bool, int, float, and decimal literals (optional leading
+`-`), string literals without interpolation, leading-dot enum options
+(`.North`), and `null` on a nullable parameter. Place every defaulted
+parameter after every non-defaulted one. `Type? name` stays nullable-and-
+mandatory unless it also declares a default — nullability and defaultedness
+are independent.
+
+Omit defaulted arguments at call sites: function calls bind positionally and
+drop only a trailing suffix; constructor calls name a subset that covers
+every non-defaulted parameter. When several overloads match, the one filling
+in the fewest defaults wins, and a residual tie is a declaration-time error.
+Implementations of an interface function restate its defaults exactly.
+
+Do not default parameters of deferred functions, delegates, actions,
+closures, or overrides. Enum defaults store the option id, so renaming the
+option changes the emitted `.Option` spelling without a record change.
+
 ## Required constructors and settlement
 
 Put one required constructor on the class header when the entire class body