@optique/core 1.1.0-dev.2069 → 1.1.0-dev.2070

package/dist/completion.cjs

@@ -162,7 +162,7 @@ function _${programName} () {
 
       # Pre-expand file candidates.  When the glob base came from the
       # program's pattern and contains wildcard characters (* or ?),
-      # use it as-is via compgen -G (safe — no command substitution).
+      # use it as-is via compgen -G (safe—no command substitution).
       # Otherwise append * to treat it as a prefix.
       # Note: [ is NOT treated as a glob indicator because it commonly
       # appears in literal filenames like [draft] or foo[1].txt.
@@ -375,7 +375,7 @@ function _${programName.replace(/[^a-zA-Z0-9]/g, "_")} () {
             [[ "\$__compare_pattern" == */* ]] && __compare_pattern="\${__compare_pattern%/*}/" || __compare_pattern=""
           fi
           if [[ ( -n "\$__compare_pattern" || -n "\$__norm_prefix" ) && \${#__norm_prefix} -ge \${#__compare_pattern} && "\${__norm_prefix[1,\${#__compare_pattern}]}" == "\$__compare_pattern" && "\$PREFIX" != "\$pattern" ]]; then
-            # User typed an equivalent or extended form — keep PREFIX
+            # User typed an equivalent or extended form—keep PREFIX
             true
           else
             PREFIX="\$pattern"
@@ -536,7 +536,7 @@ ${escapedArgs ? `    set -l output (${programName} ${escapedArgs} $prev $current
                 end
             end
 
-            # Expand tilde prefix for globbing — fish does not expand ~
+            # Expand tilde prefix for globbing—fish does not expand ~
             # inside variable substitutions, so replace it with $HOME
             if string match -q '~/*' -- "$glob_base"
                 set __tilde_prefix "~"
@@ -1186,7 +1186,7 @@ ${escapedArgs ? `    \$completionArgs += @(${escapedArgs})
                     \$prefix = \$prefix + '/'
                 }
 
-                # Build the glob path — when the prefix contains wildcard
+                # Build the glob path—when the prefix contains wildcard
                 # characters, use it as-is; otherwise append *
                 \$globPath = if (\$prefix -match '[\*\?]') { \$prefix } else { "\${prefix}*" }
 

package/dist/completion.js

@@ -162,7 +162,7 @@ function _${programName} () {
 
       # Pre-expand file candidates.  When the glob base came from the
       # program's pattern and contains wildcard characters (* or ?),
-      # use it as-is via compgen -G (safe — no command substitution).
+      # use it as-is via compgen -G (safe—no command substitution).
       # Otherwise append * to treat it as a prefix.
       # Note: [ is NOT treated as a glob indicator because it commonly
       # appears in literal filenames like [draft] or foo[1].txt.
@@ -375,7 +375,7 @@ function _${programName.replace(/[^a-zA-Z0-9]/g, "_")} () {
             [[ "\$__compare_pattern" == */* ]] && __compare_pattern="\${__compare_pattern%/*}/" || __compare_pattern=""
           fi
           if [[ ( -n "\$__compare_pattern" || -n "\$__norm_prefix" ) && \${#__norm_prefix} -ge \${#__compare_pattern} && "\${__norm_prefix[1,\${#__compare_pattern}]}" == "\$__compare_pattern" && "\$PREFIX" != "\$pattern" ]]; then
-            # User typed an equivalent or extended form — keep PREFIX
+            # User typed an equivalent or extended form—keep PREFIX
             true
           else
             PREFIX="\$pattern"
@@ -536,7 +536,7 @@ ${escapedArgs ? `    set -l output (${programName} ${escapedArgs} $prev $current
                 end
             end
 
-            # Expand tilde prefix for globbing — fish does not expand ~
+            # Expand tilde prefix for globbing—fish does not expand ~
             # inside variable substitutions, so replace it with $HOME
             if string match -q '~/*' -- "$glob_base"
                 set __tilde_prefix "~"
@@ -1186,7 +1186,7 @@ ${escapedArgs ? `    \$completionArgs += @(${escapedArgs})
                     \$prefix = \$prefix + '/'
                 }
 
-                # Build the glob path — when the prefix contains wildcard
+                # Build the glob path—when the prefix contains wildcard
                 # characters, use it as-is; otherwise append *
                 \$globPath = if (\$prefix -match '[\*\?]') { \$prefix } else { "\${prefix}*" }
 

package/dist/constructs.cjs

@@ -1597,7 +1597,7 @@ function filterExcludedFieldParsers(pairs, excludedFields) {
 /**
 * Pre-completes dependency source fields and registers their values in
 * the given registry.  Unlike `completeDependencySourceDefaults()` (used
-* by suggest), this function handles all four Phase 1 cases — including
+* by suggest), this function handles all four Phase 1 cases—including
 * PendingDependencySourceState in arrays and wrappedDependencySourceMarker.
 *
 * The original state is NOT modified; only the registry is populated.

package/dist/constructs.js

@@ -1597,7 +1597,7 @@ function filterExcludedFieldParsers(pairs, excludedFields) {
 /**
 * Pre-completes dependency source fields and registers their values in
 * the given registry.  Unlike `completeDependencySourceDefaults()` (used
-* by suggest), this function handles all four Phase 1 cases — including
+* by suggest), this function handles all four Phase 1 cases—including
 * PendingDependencySourceState in arrays and wrappedDependencySourceMarker.
 *
 * The original state is NOT modified; only the registry is populated.

package/dist/dependency-metadata.d.cts

@@ -20,13 +20,13 @@ interface DependencySourceCapability {
    * The `state` argument is the current parser state for the source-owning
    * parser.  Each wrapper composes this method to handle its own state shape:
    * - plain source: reads from `DependencySourceState`
-   * - `optional()` / `withDefault()`: unwraps `[innerState]` first
+   * - `optional()`/`withDefault()`: unwraps `[innerState]` first
    * - `map()`: reads the pre-transform value from inner state
    *
    * Returns the `ValueParserResult` (which may be successful with any
    * value including `undefined`, or failed), a promise that resolves to the
    * same shape when extraction needs async work, or `undefined` if the state
-   * does not contain a source result at all (unpopulated / wrong shape).
+   * does not contain a source result at all (unpopulated/wrong shape).
    * Callers and wrapper authors must handle both direct and promise-wrapped
    * results when composing `extractSourceValue`.
    */

package/dist/dependency-metadata.d.ts

@@ -20,13 +20,13 @@ interface DependencySourceCapability {
    * The `state` argument is the current parser state for the source-owning
    * parser.  Each wrapper composes this method to handle its own state shape:
    * - plain source: reads from `DependencySourceState`
-   * - `optional()` / `withDefault()`: unwraps `[innerState]` first
+   * - `optional()`/`withDefault()`: unwraps `[innerState]` first
    * - `map()`: reads the pre-transform value from inner state
    *
    * Returns the `ValueParserResult` (which may be successful with any
    * value including `undefined`, or failed), a promise that resolves to the
    * same shape when extraction needs async work, or `undefined` if the state
-   * does not contain a source result at all (unpopulated / wrong shape).
+   * does not contain a source result at all (unpopulated/wrong shape).
    * Callers and wrapper authors must handle both direct and promise-wrapped
    * results when composing `extractSourceValue`.
    */

package/dist/internal/parser.d.cts

@@ -112,7 +112,7 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    *
    * Each built-in combinator computes this from its structural semantics.
    * Custom parser implementations must include every fixed token that
-   * the parser accepts at `argv[0]` — command names, option names, and
+   * the parser accepts at `argv[0]`—command names, option names, and
    * literal values alike.  For example, a parser whose usage declares
    * `{ type: "literal", value: "serve" }` should include `"serve"` in
    * this set.  Parsers that accept *any* token (like `argument()`) should
@@ -265,8 +265,8 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    * parser (e.g., regex patterns, numeric bounds, `choice()` values).
    *
    * Wrappers like `bindEnv()` and `bindConfig()` call this on fallback
-   * values — environment variables parsed by a looser env parser,
-   * configured defaults, and values loaded from config files — so that
+   * values—environment variables parsed by a looser env parser,
+   * configured defaults, and values loaded from config files—so that
    * those values obey the same validation semantics as CLI input.
    * Without it, parser constraints can be silently bypassed through
    * fallback paths.
@@ -292,7 +292,7 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    * current dependency value, and custom value parsers whose `format()`
    * intentionally throws for unsupported inputs.  Values that
    * `format()` successfully serializes to a string are always re-parsed,
-   * and any resulting parse failure is propagated — they represent the
+   * and any resulting parse failure is propagated—they represent the
    * bug class this method exists to surface.
    *
    * @param value The candidate value to validate.
@@ -413,7 +413,7 @@ interface ExecutionContext {
    * `preCompleteAndRegisterDependencies` results directly to children
    * in Phase 3.  Children read it in their own Phase 1 to avoid
    * re-evaluating non-idempotent default thunks, but never write to
-   * it — this prevents sibling completions from leaking into each
+   * it—this prevents sibling completions from leaking into each
    * other.
    *
    * Field-name keying naturally handles parser reuse across different

package/dist/internal/parser.d.ts

@@ -112,7 +112,7 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    *
    * Each built-in combinator computes this from its structural semantics.
    * Custom parser implementations must include every fixed token that
-   * the parser accepts at `argv[0]` — command names, option names, and
+   * the parser accepts at `argv[0]`—command names, option names, and
    * literal values alike.  For example, a parser whose usage declares
    * `{ type: "literal", value: "serve" }` should include `"serve"` in
    * this set.  Parsers that accept *any* token (like `argument()`) should
@@ -265,8 +265,8 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    * parser (e.g., regex patterns, numeric bounds, `choice()` values).
    *
    * Wrappers like `bindEnv()` and `bindConfig()` call this on fallback
-   * values — environment variables parsed by a looser env parser,
-   * configured defaults, and values loaded from config files — so that
+   * values—environment variables parsed by a looser env parser,
+   * configured defaults, and values loaded from config files—so that
    * those values obey the same validation semantics as CLI input.
    * Without it, parser constraints can be silently bypassed through
    * fallback paths.
@@ -292,7 +292,7 @@ interface Parser<M extends Mode = "sync", TValue = unknown, TState = unknown> {
    * current dependency value, and custom value parsers whose `format()`
    * intentionally throws for unsupported inputs.  Values that
    * `format()` successfully serializes to a string are always re-parsed,
-   * and any resulting parse failure is propagated — they represent the
+   * and any resulting parse failure is propagated—they represent the
    * bug class this method exists to surface.
    *
    * @param value The candidate value to validate.
@@ -413,7 +413,7 @@ interface ExecutionContext {
    * `preCompleteAndRegisterDependencies` results directly to children
    * in Phase 3.  Children read it in their own Phase 1 to avoid
    * re-evaluating non-idempotent default thunks, but never write to
-   * it — this prevents sibling completions from leaking into each
+   * it—this prevents sibling completions from leaking into each
    * other.
    *
    * Field-name keying naturally handles parser reuse across different

package/dist/modifiers.cjs

@@ -142,14 +142,14 @@ function extractOptionalLikePhase2Seed(parser, state, exec) {
 }
 /**
 * Computes the inner state to pass through to the wrapped parser inside
-* {@link optional} / {@link withDefault}.  When the outer state is an
+* {@link optional}/{@link withDefault}.  When the outer state is an
 * array, the inner state is `state[0]`.  Otherwise, including the
 * common case where `optional()` sits at top level and the outer state
-* is either `undefined` or an annotation wrapper from `parseOptionalLike`
-* / `parse({ annotations })`, we use the wrapped parser's
+* is either `undefined` or an annotation wrapper from `parseOptionalLike`/
+* `parse({ annotations })`, we use the wrapped parser's
 * `initialState`, propagating annotations from the outer state so that
-* source-binding wrappers under `optional()` / `withDefault()` (e.g.,
-* `bindEnv()` / `bindConfig()`) can resolve their fallbacks.
+* source-binding wrappers under `optional()`/`withDefault()` (e.g.,
+* `bindEnv()`/`bindConfig()`) can resolve their fallbacks.
 *
 * @internal
 */
@@ -677,7 +677,7 @@ function withDefault(parser, defaultValue, options) {
 *
 * Because the `deferred` flag is propagated conservatively, mapped scalar
 * results are treated as missing (`undefined`) during phase-two context
-* collection — even when `transform` only used non-deferred fields.
+* collection—even when `transform` only used non-deferred fields.
 * For example, `map(object({ apiKey: prompt(...), mode: option(...) }),
 * v => v.mode)` makes phase-two contexts see `undefined` instead of the
 * real `mode` value.  This is the intentional trade-off: the alternative

package/dist/modifiers.d.cts

@@ -138,7 +138,7 @@ declare function withDefault<M extends Mode, TValue, TState, const TDefault = TV
  *
  * Because the `deferred` flag is propagated conservatively, mapped scalar
  * results are treated as missing (`undefined`) during phase-two context
- * collection — even when `transform` only used non-deferred fields.
+ * collection—even when `transform` only used non-deferred fields.
  * For example, `map(object({ apiKey: prompt(...), mode: option(...) }),
  * v => v.mode)` makes phase-two contexts see `undefined` instead of the
  * real `mode` value.  This is the intentional trade-off: the alternative

package/dist/modifiers.d.ts

@@ -138,7 +138,7 @@ declare function withDefault<M extends Mode, TValue, TState, const TDefault = TV
  *
  * Because the `deferred` flag is propagated conservatively, mapped scalar
  * results are treated as missing (`undefined`) during phase-two context
- * collection — even when `transform` only used non-deferred fields.
+ * collection—even when `transform` only used non-deferred fields.
  * For example, `map(object({ apiKey: prompt(...), mode: option(...) }),
  * v => v.mode)` makes phase-two contexts see `undefined` instead of the
  * real `mode` value.  This is the intentional trade-off: the alternative

package/dist/modifiers.js

@@ -142,14 +142,14 @@ function extractOptionalLikePhase2Seed(parser, state, exec) {
 }
 /**
 * Computes the inner state to pass through to the wrapped parser inside
-* {@link optional} / {@link withDefault}.  When the outer state is an
+* {@link optional}/{@link withDefault}.  When the outer state is an
 * array, the inner state is `state[0]`.  Otherwise, including the
 * common case where `optional()` sits at top level and the outer state
-* is either `undefined` or an annotation wrapper from `parseOptionalLike`
-* / `parse({ annotations })`, we use the wrapped parser's
+* is either `undefined` or an annotation wrapper from `parseOptionalLike`/
+* `parse({ annotations })`, we use the wrapped parser's
 * `initialState`, propagating annotations from the outer state so that
-* source-binding wrappers under `optional()` / `withDefault()` (e.g.,
-* `bindEnv()` / `bindConfig()`) can resolve their fallbacks.
+* source-binding wrappers under `optional()`/`withDefault()` (e.g.,
+* `bindEnv()`/`bindConfig()`) can resolve their fallbacks.
 *
 * @internal
 */
@@ -677,7 +677,7 @@ function withDefault(parser, defaultValue, options) {
 *
 * Because the `deferred` flag is propagated conservatively, mapped scalar
 * results are treated as missing (`undefined`) during phase-two context
-* collection — even when `transform` only used non-deferred fields.
+* collection—even when `transform` only used non-deferred fields.
 * For example, `map(object({ apiKey: prompt(...), mode: option(...) }),
 * v => v.mode)` makes phase-two contexts see `undefined` instead of the
 * real `mode` value.  This is the intentional trade-off: the alternative

package/dist/usage-internals.cjs

@@ -55,7 +55,7 @@ function collectLeadingCandidates(terms, optionNames, commandNames) {
 *
 * This is the command-only projection of {@link collectLeadingCandidates}
 * and is used to generate accurate "Did you mean?" suggestions in
-* `command()` error messages — suggestions are scoped to commands actually
+* `command()` error messages—suggestions are scoped to commands actually
 * reachable at the current parse position rather than all commands anywhere
 * in the usage tree.
 *

package/dist/usage-internals.js

@@ -55,7 +55,7 @@ function collectLeadingCandidates(terms, optionNames, commandNames) {
 *
 * This is the command-only projection of {@link collectLeadingCandidates}
 * and is used to generate accurate "Did you mean?" suggestions in
-* `command()` error messages — suggestions are scoped to commands actually
+* `command()` error messages—suggestions are scoped to commands actually
 * reachable at the current parse position rather than all commands anywhere
 * in the usage tree.
 *

package/dist/valueparser.d.cts

@@ -161,7 +161,7 @@ type ValueParserResult<T> = {
  * A recursive map that tracks which fields in a parsed object hold deferred
  * placeholder values.  Each entry maps a property key to either `null`
  * (the field is fully deferred and should be replaced with `undefined`)
- * or another `DeferredMap` (the field is partially deferred — recurse into
+ * or another `DeferredMap` (the field is partially deferred—recurse into
  * its sub-fields).
  *
  * @since 1.0.0

package/dist/valueparser.d.ts

@@ -161,7 +161,7 @@ type ValueParserResult<T> = {
  * A recursive map that tracks which fields in a parsed object hold deferred
  * placeholder values.  Each entry maps a property key to either `null`
  * (the field is fully deferred and should be replaced with `undefined`)
- * or another `DeferredMap` (the field is partially deferred — recurse into
+ * or another `DeferredMap` (the field is partially deferred—recurse into
  * its sub-fields).
  *
  * @since 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.1.0-dev.2069",
+  "version": "1.1.0-dev.2070",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",