@optique/core 0.6.8 → 0.6.9

package/dist/constructs.cjs

@@ -647,8 +647,16 @@ function merge(...args) {
 			});
 		},
 		getDocFragments(state, _defaultValue) {
-			const fragments = parsers.flatMap((p) => {
-				const parserState = p.initialState === void 0 ? { kind: "unavailable" } : state.kind === "unavailable" ? { kind: "unavailable" } : {
+			const fragments = parsers.flatMap((p, i) => {
+				let parserState;
+				if (p.initialState === void 0) {
+					const key = `__parser_${i}`;
+					if (state.kind === "available" && state.state && typeof state.state === "object" && key in state.state) parserState = {
+						kind: "available",
+						state: state.state[key]
+					};
+					else parserState = { kind: "unavailable" };
+				} else parserState = state.kind === "unavailable" ? { kind: "unavailable" } : {
 					kind: "available",
 					state: state.state
 				};

package/dist/constructs.js

@@ -647,8 +647,16 @@ function merge(...args) {
 			});
 		},
 		getDocFragments(state, _defaultValue) {
-			const fragments = parsers.flatMap((p) => {
-				const parserState = p.initialState === void 0 ? { kind: "unavailable" } : state.kind === "unavailable" ? { kind: "unavailable" } : {
+			const fragments = parsers.flatMap((p, i) => {
+				let parserState;
+				if (p.initialState === void 0) {
+					const key = `__parser_${i}`;
+					if (state.kind === "available" && state.state && typeof state.state === "object" && key in state.state) parserState = {
+						kind: "available",
+						state: state.state[key]
+					};
+					else parserState = { kind: "unavailable" };
+				} else parserState = state.kind === "unavailable" ? { kind: "unavailable" } : {
 					kind: "available",
 					state: state.state
 				};

package/dist/parser.cjs

@@ -93,6 +93,26 @@ function suggest(parser, args) {
 	return Array.from(parser.suggest(context, prefix));
 }
 /**
+* Recursively searches for a command within nested exclusive usage terms.
+* When the command is found, returns the expanded usage terms for that command.
+*
+* @param term The usage term to search in
+* @param commandName The command name to find
+* @returns The expanded usage terms if found, null otherwise
+*/
+function findCommandInExclusive(term, commandName) {
+	if (term.type !== "exclusive") return null;
+	for (const termGroup of term.terms) {
+		const firstTerm = termGroup[0];
+		if (firstTerm?.type === "command" && firstTerm.name === commandName) return termGroup;
+		if (firstTerm?.type === "exclusive") {
+			const found = findCommandInExclusive(firstTerm, commandName);
+			if (found) return [...found, ...termGroup.slice(1)];
+		}
+	}
+	return null;
+}
+/**
 * Generates a documentation page for a parser based on its current state after
 * attempting to parse the provided arguments. This function is useful for
 * creating help documentation that reflects the current parsing context.
@@ -152,11 +172,9 @@ function getDocPage(parser, args = []) {
 	let i = 0;
 	for (const arg of args) {
 		const term = usage[i];
-		if (usage.length > i && term.type === "exclusive") for (const termGroup of term.terms) {
-			const firstTerm = termGroup[0];
-			if (firstTerm?.type !== "command" || firstTerm.name !== arg) continue;
-			usage.splice(i, 1, ...termGroup);
-			break;
+		if (usage.length > i && term.type === "exclusive") {
+			const found = findCommandInExclusive(term, arg);
+			if (found) usage.splice(i, 1, ...found);
 		}
 		i++;
 	}

package/dist/parser.js

@@ -93,6 +93,26 @@ function suggest(parser, args) {
 	return Array.from(parser.suggest(context, prefix));
 }
 /**
+* Recursively searches for a command within nested exclusive usage terms.
+* When the command is found, returns the expanded usage terms for that command.
+*
+* @param term The usage term to search in
+* @param commandName The command name to find
+* @returns The expanded usage terms if found, null otherwise
+*/
+function findCommandInExclusive(term, commandName) {
+	if (term.type !== "exclusive") return null;
+	for (const termGroup of term.terms) {
+		const firstTerm = termGroup[0];
+		if (firstTerm?.type === "command" && firstTerm.name === commandName) return termGroup;
+		if (firstTerm?.type === "exclusive") {
+			const found = findCommandInExclusive(firstTerm, commandName);
+			if (found) return [...found, ...termGroup.slice(1)];
+		}
+	}
+	return null;
+}
+/**
 * Generates a documentation page for a parser based on its current state after
 * attempting to parse the provided arguments. This function is useful for
 * creating help documentation that reflects the current parsing context.
@@ -152,11 +172,9 @@ function getDocPage(parser, args = []) {
 	let i = 0;
 	for (const arg of args) {
 		const term = usage[i];
-		if (usage.length > i && term.type === "exclusive") for (const termGroup of term.terms) {
-			const firstTerm = termGroup[0];
-			if (firstTerm?.type !== "command" || firstTerm.name !== arg) continue;
-			usage.splice(i, 1, ...termGroup);
-			break;
+		if (usage.length > i && term.type === "exclusive") {
+			const found = findCommandInExclusive(term, arg);
+			if (found) usage.splice(i, 1, ...found);
 		}
 		i++;
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "0.6.8",
+  "version": "0.6.9",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",