@optique/core 1.4.0-dev.2716 → 1.4.0-dev.2720

package/dist/extension.cjs

@@ -124,6 +124,7 @@ function delegateOptionParsing(wrapper, inner, getInnerState) {
 *
 * @param parser The parser to annotate.
 * @param behavior The known outcomes; omitted fields stay unknown.
+* @returns Nothing; updates the parser's metadata in place.
 * @throws {TypeError} If a value is invalid, afterStep is supplied for a failing
 *                    step, or the metadata cannot be defined or cleared.
 * @since 1.4.0
@@ -165,6 +166,7 @@ function getEmptyInputBehavior(parser) {
 *
 * @param wrapper The parser receiving the facts.
 * @param inner The parser whose behavior is preserved.
+* @returns Nothing; updates the wrapper's metadata in place.
 * @throws {TypeError} If modes differ or metadata cannot be defined or cleared.
 * @since 1.4.0
 */

package/dist/extension.d.cts

@@ -158,6 +158,7 @@ interface EmptyInputBehavior {
  *
  * @param parser The parser to annotate.
  * @param behavior The known outcomes; omitted fields stay unknown.
+ * @returns Nothing; updates the parser's metadata in place.
  * @throws {TypeError} If a value is invalid, afterStep is supplied for a failing
  *                    step, or the metadata cannot be defined or cleared.
  * @since 1.4.0
@@ -188,6 +189,7 @@ declare function getEmptyInputBehavior(parser: Parser<Mode, unknown, unknown>):
  *
  * @param wrapper The parser receiving the facts.
  * @param inner The parser whose behavior is preserved.
+ * @returns Nothing; updates the wrapper's metadata in place.
  * @throws {TypeError} If modes differ or metadata cannot be defined or cleared.
  * @since 1.4.0
  */

package/dist/extension.d.ts

@@ -158,6 +158,7 @@ interface EmptyInputBehavior {
  *
  * @param parser The parser to annotate.
  * @param behavior The known outcomes; omitted fields stay unknown.
+ * @returns Nothing; updates the parser's metadata in place.
  * @throws {TypeError} If a value is invalid, afterStep is supplied for a failing
  *                    step, or the metadata cannot be defined or cleared.
  * @since 1.4.0
@@ -188,6 +189,7 @@ declare function getEmptyInputBehavior(parser: Parser<Mode, unknown, unknown>):
  *
  * @param wrapper The parser receiving the facts.
  * @param inner The parser whose behavior is preserved.
+ * @returns Nothing; updates the wrapper's metadata in place.
  * @throws {TypeError} If modes differ or metadata cannot be defined or cleared.
  * @since 1.4.0
  */

package/dist/extension.js

@@ -124,6 +124,7 @@ function delegateOptionParsing(wrapper, inner, getInnerState) {
 *
 * @param parser The parser to annotate.
 * @param behavior The known outcomes; omitted fields stay unknown.
+* @returns Nothing; updates the parser's metadata in place.
 * @throws {TypeError} If a value is invalid, afterStep is supplied for a failing
 *                    step, or the metadata cannot be defined or cleared.
 * @since 1.4.0
@@ -165,6 +166,7 @@ function getEmptyInputBehavior(parser) {
 *
 * @param wrapper The parser receiving the facts.
 * @param inner The parser whose behavior is preserved.
+* @returns Nothing; updates the wrapper's metadata in place.
 * @throws {TypeError} If modes differ or metadata cannot be defined or cleared.
 * @since 1.4.0
 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.4.0-dev.2716",
+  "version": "1.4.0-dev.2720",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",
@@ -245,7 +245,7 @@
   },
   "sideEffects": false,
   "devDependencies": {
-    "@optique/env": "1.4.0-dev.2716+57cbdb77",
+    "@optique/env": "1.4.0-dev.2720+93db84aa",
     "@types/node": "^24.0.0",
     "fast-check": "^4.7.0",
     "tsdown": "^0.13.0",

package/skills/optique/SKILL.md

@@ -236,13 +236,11 @@ Common mistakes checklist
     `parse()` in tests and embedded use. Do not pre-parse `process.argv`.
  -  Declare only static facts with `defineEmptyInputBehavior()` in
     `@optique/core/extension`; use `inheritEmptyInputBehavior()` for
-    transparent wrappers. See <https://optique.dev/concepts/extend.md>.
+    transparent wrappers. See [extension APIs].
  -  Do not treat `or(a, b)` as “zero or more alternatives.” Wrap it in
     `optional()` or `withDefault()` to allow no matching branch.
- -  Do not use `object()` for mutually exclusive subcommands. Use
-    `or(command(...), command(...))`.
- -  Do not forget that `flag("--x")` is required. Wrap it in `optional()` or
-    `withDefault(..., false)` for ordinary optional flags.
+ -  Use `or(command(...), command(...))` for mutually exclusive subcommands.
+ -  Wrap required `flag("--x")` in `optional()` or `withDefault(..., false)`.
  -  Do not expect `multiple(p)` to fail when absent; it returns `[]`. Wrap with
     `nonEmpty()` when at least one value is required.
  -  Do not confuse free-order parsing with `seq()`. Most constructs let child
@@ -259,6 +257,8 @@ Common mistakes checklist
 
 For the detailed maintained guide, use <https://optique.dev/pitfalls.md>.
 
+[extension APIs]: https://optique.dev/concepts/extend.md
+
 
 Reference links
 ---------------