@optique/core 1.4.0-dev.2928 → 1.4.0-dev.2935

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@optique/core",
3
- "version": "1.4.0-dev.2928",
3
+ "version": "1.4.0-dev.2935",
4
4
  "description": "Type-safe combinatorial command-line interface parser",
5
5
  "keywords": [
6
6
  "CLI",
@@ -269,7 +269,7 @@
269
269
  },
270
270
  "sideEffects": false,
271
271
  "devDependencies": {
272
- "@optique/env": "1.4.0-dev.2928+80c003f2",
272
+ "@optique/env": "1.4.0-dev.2935+fc126fd1",
273
273
  "@types/node": "^24.0.0",
274
274
  "fast-check": "^4.7.0",
275
275
  "tsdown": "^0.13.0",
@@ -243,15 +243,13 @@ Common mistakes checklist
243
243
  - Wrap required `flag("--x")` in `optional()` or `withDefault(..., false)`.
244
244
  - Do not expect `multiple(p)` to fail when absent; it returns `[]`. Wrap with
245
245
  `nonEmpty()` when at least one value is required.
246
- - Do not confuse free-order parsing with `seq()`. Most constructs let child
247
- parsers compete by priority; use `seq()` only for truly ordered grammars.
246
+ - Use `seq()` only for ordered grammars; most constructs use parser priority.
248
247
  - Use structured `message` values for errors and descriptions.
249
248
  - Register contexts for `bindEnv()`, `bindConfig()`, `bindDerivedDefault()`,
250
249
  and `bindKeyring()` in the runner's `contexts` option.
251
250
  - Use `bindEnv().readFallback()` for env/default in error handlers.
252
251
  - Enable `showEnvironment` for env-only help; set `documentation.description`.
253
- - Keep multi-level dependency graphs with `dependency()` rather than
254
- duplicating one-level factories.
252
+ - Keep multi-level `dependency()` graphs; avoid duplicate one-level factories.
255
253
  - Put runtime prompt checks in `when`, with typed `otherwise`; evaluate them
256
254
  only at fallback, never eagerly during construction.
257
255
 
@@ -263,7 +261,6 @@ For the detailed maintained guide, use <https://optique.dev/pitfalls.md>.
263
261
  Reference links
264
262
  ---------------
265
263
 
266
- - Documentation index for agents: <https://optique.dev/llms.txt>
267
264
  - Runners and entry points: <https://optique.dev/concepts/runners.md>
268
265
  - Primitive parsers: <https://optique.dev/concepts/primitives.md>
269
266
  - Construct combinators: <https://optique.dev/concepts/constructs.md>
@@ -273,8 +270,11 @@ Reference links
273
270
  - Structured messages: <https://optique.dev/concepts/messages.md>
274
271
  - Shell completion: <https://optique.dev/concepts/completion.md>
275
272
  - Command discovery: <https://optique.dev/concepts/discover.md>
273
+ - [CLI recipe][file-inspect]
276
274
  - Markdown references: <https://optique.dev/concepts/markdown-reference.md>
277
275
 
276
+ [file-inspect]: https://github.com/dahlia/optique/tree/main/examples/file-inspect
277
+
278
278
 
279
279
  Integration packages
280
280
  --------------------