@optique/core 1.0.0-dev.488 → 1.0.0-dev.489

package/dist/facade.d.cts

@@ -32,6 +32,7 @@ interface CommandSubConfig {
    * - `true`: Hidden from usage, documentation, and suggestions.
    * - `"usage"`: Hidden from usage lines only.
    * - `"doc"`: Hidden from documentation only.
+   * - `"help"`: Hidden from usage and documentation only.
    */
   readonly hidden?: HiddenVisibility;
 }
@@ -55,6 +56,7 @@ interface OptionSubConfig {
    * - `true`: Hidden from usage, documentation, and suggestions.
    * - `"usage"`: Hidden from usage lines only.
    * - `"doc"`: Hidden from documentation only.
+   * - `"help"`: Hidden from usage and documentation only.
    */
   readonly hidden?: HiddenVisibility;
 }

package/dist/facade.d.ts

@@ -32,6 +32,7 @@ interface CommandSubConfig {
    * - `true`: Hidden from usage, documentation, and suggestions.
    * - `"usage"`: Hidden from usage lines only.
    * - `"doc"`: Hidden from documentation only.
+   * - `"help"`: Hidden from usage and documentation only.
    */
   readonly hidden?: HiddenVisibility;
 }
@@ -55,6 +56,7 @@ interface OptionSubConfig {
    * - `true`: Hidden from usage, documentation, and suggestions.
    * - `"usage"`: Hidden from usage lines only.
    * - `"doc"`: Hidden from documentation only.
+   * - `"help"`: Hidden from usage and documentation only.
    */
   readonly hidden?: HiddenVisibility;
 }

package/dist/primitives.d.cts

@@ -52,6 +52,7 @@ interface OptionOptions {
    * - `true`: hide from usage, docs, and suggestions
    * - `"usage"`: hide from usage only
    * - `"doc"`: hide from docs only
+   * - `"help"`: hide from usage and docs, keep suggestions
    *
    * @since 0.9.0
    */
@@ -166,6 +167,7 @@ interface FlagOptions {
    * - `true`: hide from usage, docs, and suggestions
    * - `"usage"`: hide from usage only
    * - `"doc"`: hide from docs only
+   * - `"help"`: hide from usage and docs, keep suggestions
    *
    * @since 0.9.0
    */
@@ -255,6 +257,7 @@ interface ArgumentOptions {
    * - `true`: hide from usage, docs, and suggestions
    * - `"usage"`: hide from usage only
    * - `"doc"`: hide from docs only
+   * - `"help"`: hide from usage and docs, keep suggestions
    *
    * @since 0.9.0
    */
@@ -329,6 +332,7 @@ interface CommandOptions {
    * - `true`: hide from usage, docs, and suggestions
    * - `"usage"`: hide from usage only
    * - `"doc"`: hide from docs only
+   * - `"help"`: hide from usage and docs, keep suggestions
    *
    * @since 0.9.0
    */
@@ -416,6 +420,7 @@ interface PassThroughOptions {
    * - `true`: hide from usage, docs, and suggestions
    * - `"usage"`: hide from usage only
    * - `"doc"`: hide from docs only
+   * - `"help"`: hide from usage and docs, keep suggestions
    *
    * @since 0.9.0
    */

package/dist/primitives.d.ts

@@ -52,6 +52,7 @@ interface OptionOptions {
    * - `true`: hide from usage, docs, and suggestions
    * - `"usage"`: hide from usage only
    * - `"doc"`: hide from docs only
+   * - `"help"`: hide from usage and docs, keep suggestions
    *
    * @since 0.9.0
    */
@@ -166,6 +167,7 @@ interface FlagOptions {
    * - `true`: hide from usage, docs, and suggestions
    * - `"usage"`: hide from usage only
    * - `"doc"`: hide from docs only
+   * - `"help"`: hide from usage and docs, keep suggestions
    *
    * @since 0.9.0
    */
@@ -255,6 +257,7 @@ interface ArgumentOptions {
    * - `true`: hide from usage, docs, and suggestions
    * - `"usage"`: hide from usage only
    * - `"doc"`: hide from docs only
+   * - `"help"`: hide from usage and docs, keep suggestions
    *
    * @since 0.9.0
    */
@@ -329,6 +332,7 @@ interface CommandOptions {
    * - `true`: hide from usage, docs, and suggestions
    * - `"usage"`: hide from usage only
    * - `"doc"`: hide from docs only
+   * - `"help"`: hide from usage and docs, keep suggestions
    *
    * @since 0.9.0
    */
@@ -416,6 +420,7 @@ interface PassThroughOptions {
    * - `true`: hide from usage, docs, and suggestions
    * - `"usage"`: hide from usage only
    * - `"doc"`: hide from docs only
+   * - `"help"`: hide from usage and docs, keep suggestions
    *
    * @since 0.9.0
    */

package/dist/usage.cjs

@@ -4,13 +4,13 @@
 * Returns whether the term should be hidden from usage output.
 */
 function isUsageHidden(hidden) {
-	return hidden === true || hidden === "usage";
+	return hidden === true || hidden === "usage" || hidden === "help";
 }
 /**
 * Returns whether the term should be hidden from documentation output.
 */
 function isDocHidden(hidden) {
-	return hidden === true || hidden === "doc";
+	return hidden === true || hidden === "doc" || hidden === "help";
 }
 /**
 * Returns whether the term should be hidden from suggestion/error candidates.
@@ -25,7 +25,11 @@ function mergeHidden(a, b) {
 	if (a == null) return b;
 	if (b == null) return a;
 	if (a === true || b === true) return true;
-	if (a !== b) return true;
+	if (a === false) return b;
+	if (b === false) return a;
+	if (a === b) return a;
+	if (a === "help" || b === "help") return "help";
+	if ((a === "usage" || a === "doc") && (b === "usage" || b === "doc")) return "help";
 	return a;
 }
 /**

package/dist/usage.d.cts

@@ -18,8 +18,9 @@ type OptionName = `--${string}` | `-${string}` | `/${string}` | `+${string}`;
  * - `true`: hidden from usage, documentation, and suggestions
  * - `"usage"`: hidden from usage only
  * - `"doc"`: hidden from documentation only
+ * - `"help"`: hidden from usage and documentation, but shown in suggestions
  */
-type HiddenVisibility = boolean | "usage" | "doc";
+type HiddenVisibility = boolean | "usage" | "doc" | "help";
 /**
  * Returns whether the term should be hidden from usage output.
  */

package/dist/usage.d.ts

@@ -18,8 +18,9 @@ type OptionName = `--${string}` | `-${string}` | `/${string}` | `+${string}`;
  * - `true`: hidden from usage, documentation, and suggestions
  * - `"usage"`: hidden from usage only
  * - `"doc"`: hidden from documentation only
+ * - `"help"`: hidden from usage and documentation, but shown in suggestions
  */
-type HiddenVisibility = boolean | "usage" | "doc";
+type HiddenVisibility = boolean | "usage" | "doc" | "help";
 /**
  * Returns whether the term should be hidden from usage output.
  */

package/dist/usage.js

@@ -3,13 +3,13 @@
 * Returns whether the term should be hidden from usage output.
 */
 function isUsageHidden(hidden) {
-	return hidden === true || hidden === "usage";
+	return hidden === true || hidden === "usage" || hidden === "help";
 }
 /**
 * Returns whether the term should be hidden from documentation output.
 */
 function isDocHidden(hidden) {
-	return hidden === true || hidden === "doc";
+	return hidden === true || hidden === "doc" || hidden === "help";
 }
 /**
 * Returns whether the term should be hidden from suggestion/error candidates.
@@ -24,7 +24,11 @@ function mergeHidden(a, b) {
 	if (a == null) return b;
 	if (b == null) return a;
 	if (a === true || b === true) return true;
-	if (a !== b) return true;
+	if (a === false) return b;
+	if (b === false) return a;
+	if (a === b) return a;
+	if (a === "help" || b === "help") return "help";
+	if ((a === "usage" || a === "doc") && (b === "usage" || b === "doc")) return "help";
 	return a;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.488+690cf201",
+  "version": "1.0.0-dev.489+709d13c5",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",