@shell-shock/core 0.17.21 → 0.17.23

package/dist/helpers/utilities.mjs

@@ -1,94 +0,0 @@
-import { constantCase } from "@stryke/string-format/constant-case";
-import { getUniqueBy } from "@stryke/helpers/get-unique";
-import { formatTree } from "@stryke/cli/utils/tree";
-import { isFunction } from "@stryke/type-checks/is-function";
-
-//#region src/helpers/utilities.ts
-const __ΩRecord = [
-	"K",
-	"T",
-	"Record",
-	"l'e#\"Rb!b\"Pde\"!N#!w#y"
-];
-function __assignType(fn, args) {
-	fn.__type = args;
-	return fn;
-}
-function innerFormatCommandTree(command) {
-	return {
-		name: `${command.name}${command.virtual ? " (virtual)" : ""}`,
-		children: Object.values(command.children ?? {}).map(innerFormatCommandTree)
-	};
-}
-innerFormatCommandTree.__type = [
-	"CommandTree",
-	"command",
-	"innerFormatCommandTree",
-	"P\"w!2\"!/#"
-];
-function formatCommandTree(context) {
-	return formatTree({
-		name: context.config.name,
-		children: Object.values(context.commands ?? {}).map(innerFormatCommandTree)
-	});
-}
-formatCommandTree.__type = [
-	"Context",
-	"context",
-	"formatCommandTree",
-	"P\"w!2\"&/#"
-];
-/**
-* Retrieves the global command options based on the context configuration.
-*
-* @param context - The build context.
-* @param command - The command for which to retrieve global options.
-* @returns A record of global command options.
-*/
-function getGlobalOptions(context, command) {
-	let options;
-	if (Array.isArray(context.config.globalOptions)) options = Object.fromEntries(getUniqueBy(context.config.globalOptions, __assignType((item) => item.name, [
-		"CommandOption",
-		"item",
-		"",
-		"P\"w!2\"\"/#"
-	])).map(__assignType((option) => [option.name, option], [
-		"option",
-		"",
-		"P\"2!\"/\""
-	])));
-	else if (isFunction(context.config.globalOptions)) options = Object.fromEntries(getUniqueBy(context.config.globalOptions(context, command), __assignType((item) => item.name, [
-		"CommandOption",
-		"item",
-		"",
-		"P\"w!2\"\"/#"
-	])).map(__assignType((option) => [option.name, option], [
-		"option",
-		"",
-		"P\"2!\"/\""
-	])));
-	else options = {};
-	return Object.fromEntries(Object.entries(options).map(__assignType(([key, value]) => [key, {
-		...value,
-		env: value.env ?? constantCase(key)
-	}], [
-		"param0",
-		"",
-		"P\"2!\"/\""
-	])));
-}
-getGlobalOptions.__type = [
-	"Context",
-	"context",
-	"CommandBase",
-	"command",
-	() => __ΩRecord,
-	"CommandOption",
-	"getGlobalOptions",
-	"Retrieves the global command options based on the context configuration.",
-	"P\"w!2\"\"w#2$&\"w&o%#/'?("
-];
-
-//#endregion
-export { formatCommandTree, getGlobalOptions };
-//# sourceMappingURL=utilities.mjs.map

package/dist/helpers/utilities.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"utilities.mjs","names":[],"sources":[],"mappings":""}

package/dist/helpers/validations.cjs

@@ -1,71 +0,0 @@
-
-//#region src/helpers/validations.ts
-const __ΩValidationFailure = [
-	"code",
-	"details",
-	"ValidationFailure",
-	"P&4!&4\"Mw#y"
-];
-function validateArguments(command) {
-	const failures = [];
-	let sequential = false;
-	for (const argument of command.args ?? []) if ((argument.type === "string" || argument.type === "number") && argument.variadic) if (!sequential) sequential = true;
-	else failures.push({
-		code: "SEQUENTIAL_VARIADIC_ARGUMENTS",
-		details: `Sequential variadic arguments are not allowed - since the argument preceding ${argument.name} is variadic, it must not also be variadic.`
-	});
-	else sequential = false;
-	return failures;
-}
-validateArguments.__type = [
-	"CommandTree",
-	"command",
-	() => __ΩValidationFailure,
-	"validateArguments",
-	"P\"w!2\"n#F/$"
-];
-function validateOptions(command) {
-	const failures = [];
-	const optionNames = (Set.Ω = [["&"]], /* @__PURE__ */ new Set());
-	for (const option of Object.values(command.options ?? {})) {
-		if (optionNames.has(option.name)) failures.push({
-			code: "DUPLICATE_OPTION_NAME",
-			details: `Duplicate option name "${option.name}" found in command.`
-		});
-		optionNames.add(option.name);
-		for (const alias of option.alias) {
-			if (optionNames.has(alias)) failures.push({
-				code: "DUPLICATE_OPTION_ALIAS",
-				details: `Duplicate option name "${alias}" (an alias of "${option.name}") found in command.`
-			});
-			optionNames.add(alias);
-		}
-	}
-	return failures;
-}
-validateOptions.__type = [
-	"CommandTree",
-	"command",
-	() => __ΩValidationFailure,
-	"validateOptions",
-	"P\"w!2\"n#F/$"
-];
-function validateCommand(command) {
-	const results = [];
-	let failures = validateOptions(command);
-	if (failures.length > 0) results.push(...failures);
-	failures = validateArguments(command);
-	if (failures.length > 0) results.push(...failures);
-	return results;
-}
-validateCommand.__type = [
-	"CommandTree",
-	"command",
-	() => __ΩValidationFailure,
-	"validateCommand",
-	"P\"w!2\"n#F/$"
-];
-
-//#endregion
-exports.validateCommand = validateCommand;
-//# sourceMappingURL=validations.cjs.map

package/dist/helpers/validations.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"validations.cjs","names":[],"sources":[],"mappings":""}

package/dist/helpers/validations.mjs

@@ -1,70 +0,0 @@
-//#region src/helpers/validations.ts
-const __ΩValidationFailure = [
-	"code",
-	"details",
-	"ValidationFailure",
-	"P&4!&4\"Mw#y"
-];
-function validateArguments(command) {
-	const failures = [];
-	let sequential = false;
-	for (const argument of command.args ?? []) if ((argument.type === "string" || argument.type === "number") && argument.variadic) if (!sequential) sequential = true;
-	else failures.push({
-		code: "SEQUENTIAL_VARIADIC_ARGUMENTS",
-		details: `Sequential variadic arguments are not allowed - since the argument preceding ${argument.name} is variadic, it must not also be variadic.`
-	});
-	else sequential = false;
-	return failures;
-}
-validateArguments.__type = [
-	"CommandTree",
-	"command",
-	() => __ΩValidationFailure,
-	"validateArguments",
-	"P\"w!2\"n#F/$"
-];
-function validateOptions(command) {
-	const failures = [];
-	const optionNames = (Set.Ω = [["&"]], /* @__PURE__ */ new Set());
-	for (const option of Object.values(command.options ?? {})) {
-		if (optionNames.has(option.name)) failures.push({
-			code: "DUPLICATE_OPTION_NAME",
-			details: `Duplicate option name "${option.name}" found in command.`
-		});
-		optionNames.add(option.name);
-		for (const alias of option.alias) {
-			if (optionNames.has(alias)) failures.push({
-				code: "DUPLICATE_OPTION_ALIAS",
-				details: `Duplicate option name "${alias}" (an alias of "${option.name}") found in command.`
-			});
-			optionNames.add(alias);
-		}
-	}
-	return failures;
-}
-validateOptions.__type = [
-	"CommandTree",
-	"command",
-	() => __ΩValidationFailure,
-	"validateOptions",
-	"P\"w!2\"n#F/$"
-];
-function validateCommand(command) {
-	const results = [];
-	let failures = validateOptions(command);
-	if (failures.length > 0) results.push(...failures);
-	failures = validateArguments(command);
-	if (failures.length > 0) results.push(...failures);
-	return results;
-}
-validateCommand.__type = [
-	"CommandTree",
-	"command",
-	() => __ΩValidationFailure,
-	"validateCommand",
-	"P\"w!2\"n#F/$"
-];
-
-//#endregion
-export { validateCommand };
-//# sourceMappingURL=validations.mjs.map

package/dist/helpers/validations.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"validations.mjs","names":[],"sources":[],"mappings":""}

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","names":[],"sources":[],"mappings":""}

package/dist/package.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"package.cjs","names":[],"sources":[],"mappings":""}

package/dist/package.mjs

@@ -1,6 +0,0 @@
-//#region package.json
-var version = "0.17.20";
-
-//#endregion
-export { version };
-//# sourceMappingURL=package.mjs.map

package/dist/package.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"package.mjs","names":[],"sources":[],"mappings":""}

package/dist/plugin-utils/compute-bin.cjs

@@ -1,49 +0,0 @@
-const require_context_helpers = require('./context-helpers.cjs');
-let _stryke_path_join_paths = require("@stryke/path/join-paths");
-
-//#region src/plugin-utils/compute-bin.ts
-function __assignType(fn, args) {
-	fn.__type = args;
-	return fn;
-}
-/**
-* Computes the command tree for the root binary command based on the provided context.
-*
-* @param context - The plugin context containing the necessary information to compute the command tree.
-* @returns The computed command tree for the root binary command.
-*/
-function computeBin(context) {
-	return {
-		id: "",
-		name: require_context_helpers.getAppName(context),
-		title: require_context_helpers.getAppTitle(context),
-		description: require_context_helpers.getAppDescription(context),
-		virtual: true,
-		path: null,
-		segments: [],
-		alias: [],
-		tags: [],
-		options: Object.fromEntries(context.globalOptions.map(__assignType((option) => [option.name, option], [
-			"option",
-			"",
-			"P\"2!\"/\""
-		]))),
-		args: [],
-		entry: { file: (0, _stryke_path_join_paths.joinPaths)(context.entryPath, "bin.ts") },
-		parent: null,
-		children: context.commands,
-		docs: context.config.docs?.app
-	};
-}
-computeBin.__type = [
-	"Context",
-	"context",
-	"CommandTree",
-	"computeBin",
-	"Computes the command tree for the root binary command based on the provided context.",
-	"P\"w!2\"\"w#/$?%"
-];
-
-//#endregion
-exports.computeBin = computeBin;
-//# sourceMappingURL=compute-bin.cjs.map

package/dist/plugin-utils/compute-bin.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"compute-bin.cjs","names":[],"sources":[],"mappings":""}

package/dist/plugin-utils/compute-bin.d.cts

@@ -1,13 +0,0 @@
-import { CommandTree } from "../types/command.cjs";
-import { Context } from "../types/context.cjs";
-//#region src/plugin-utils/compute-bin.d.ts
-/**
- * Computes the command tree for the root binary command based on the provided context.
- *
- * @param context - The plugin context containing the necessary information to compute the command tree.
- * @returns The computed command tree for the root binary command.
- */
-declare function computeBin(context: Context): CommandTree;
-//#endregion
-export { computeBin };
-//# sourceMappingURL=compute-bin.d.cts.map

package/dist/plugin-utils/compute-bin.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"compute-bin.d.cts","names":[],"sources":["../../src/plugin-utils/compute-bin.ts"],"mappings":";;;;;;;AA4BA;;iBAAgB,UAAA,CAAW,OAAA,EAAS,OAAA,GAAU,WAAW"}

package/dist/plugin-utils/compute-bin.d.mts

@@ -1,13 +0,0 @@
-import { CommandTree } from "../types/command.mjs";
-import { Context } from "../types/context.mjs";
-//#region src/plugin-utils/compute-bin.d.ts
-/**
- * Computes the command tree for the root binary command based on the provided context.
- *
- * @param context - The plugin context containing the necessary information to compute the command tree.
- * @returns The computed command tree for the root binary command.
- */
-declare function computeBin(context: Context): CommandTree;
-//#endregion
-export { computeBin };
-//# sourceMappingURL=compute-bin.d.mts.map

package/dist/plugin-utils/compute-bin.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"compute-bin.d.mts","names":[],"sources":["../../src/plugin-utils/compute-bin.ts"],"mappings":""}

package/dist/plugin-utils/compute-bin.mjs

@@ -1,49 +0,0 @@
-import { getAppDescription, getAppName, getAppTitle } from "./context-helpers.mjs";
-import { joinPaths } from "@stryke/path/join-paths";
-
-//#region src/plugin-utils/compute-bin.ts
-function __assignType(fn, args) {
-	fn.__type = args;
-	return fn;
-}
-/**
-* Computes the command tree for the root binary command based on the provided context.
-*
-* @param context - The plugin context containing the necessary information to compute the command tree.
-* @returns The computed command tree for the root binary command.
-*/
-function computeBin(context) {
-	return {
-		id: "",
-		name: getAppName(context),
-		title: getAppTitle(context),
-		description: getAppDescription(context),
-		virtual: true,
-		path: null,
-		segments: [],
-		alias: [],
-		tags: [],
-		options: Object.fromEntries(context.globalOptions.map(__assignType((option) => [option.name, option], [
-			"option",
-			"",
-			"P\"2!\"/\""
-		]))),
-		args: [],
-		entry: { file: joinPaths(context.entryPath, "bin.ts") },
-		parent: null,
-		children: context.commands,
-		docs: context.config.docs?.app
-	};
-}
-computeBin.__type = [
-	"Context",
-	"context",
-	"CommandTree",
-	"computeBin",
-	"Computes the command tree for the root binary command based on the provided context.",
-	"P\"w!2\"\"w#/$?%"
-];
-
-//#endregion
-export { computeBin };
-//# sourceMappingURL=compute-bin.mjs.map

package/dist/plugin-utils/compute-bin.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"compute-bin.mjs","names":[],"sources":[],"mappings":""}

package/dist/plugin-utils/context-helpers.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-helpers.cjs","names":[],"sources":[],"mappings":""}

package/dist/plugin-utils/context-helpers.d.cts

@@ -1,106 +0,0 @@
-import { Context, UnresolvedContext } from "../types/context.cjs";
-//#region src/plugin-utils/context-helpers.d.ts
-/**
- * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.
- *
- * @param aliases - An array of argument aliases to sort.
- * @returns A new array of sorted aliases.
- */
-declare function sortArgAliases(aliases: string[]): string[];
-/**
- * Retrieves the application name from the context and configuration.
- *
- * @param context - The build context containing workspace and package information.
- * @returns The application name in kebab-case format.
- * @throws An error if no valid application name is found.
- */
-declare function getAppName<TContext extends UnresolvedContext | Context>(context: TContext): string;
-/**
- * Retrieves the application title from the context and configuration.
- *
- * @param context - The build context containing workspace and package information.
- * @param replaceCLI - Whether to replace CLI-related terms in the title with the application name.
- * @returns The application title in title-case format.
- */
-declare function getAppTitle<TContext extends UnresolvedContext | Context>(context: TContext, replaceCLI?: boolean): string;
-/**
- * Retrieves the application description from the context and configuration.
- *
- * @param context - The build context containing workspace and package information.
- * @returns The application description.
- */
-declare function getAppDescription<TContext extends UnresolvedContext | Context>(context: TContext): string;
-/**
- * Retrieves the primary binary name for the application.
- *
- * @param context - The build context containing workspace and package information.
- * @returns The primary binary name as a string.
- */
-declare function getAppBin<TContext extends UnresolvedContext | Context>(context: TContext): string;
-/**
- * Determines if a given command path segment is variable (enclosed in square brackets).
- *
- * @example
- * ```typescript
- * isDynamicPathSegment("[user]"); // true
- * isDynamicPathSegment("user"); // false
- * ```
- *
- * @param path - The command path segment to check.
- * @returns True if the path is variable, false otherwise.
- */
-declare function isDynamicPathSegment(path: string): boolean;
-/**
- * Extracts the variable name from a command path segment by removing enclosing square brackets.
- *
- * @example
- * ```typescript
- * getDynamicPathSegmentName("[user]"); // "user"
- * ```
- *
- * @param path - The command path segment.
- * @returns The variable name without square brackets.
- */
-declare function getDynamicPathSegmentName(path: string): string;
-/**
- * Determines if a given command path segment is a path segment group (enclosed in parentheses).
- *
- * @example
- * ```typescript
- * isPathSegmentGroup("(user)"); // true
- * isPathSegmentGroup("[user]"); // false
- * isPathSegmentGroup("user"); // false
- * ```
- *
- * @param path - The command path segment to check.
- * @returns True if the path is a path segment group, false otherwise.
- */
-declare function isPathSegmentGroup(path: string): boolean;
-/**
- * Extracts the group name from a command path segment by removing enclosing parentheses.
- *
- * @example
- * ```typescript
- * getPathSegmentGroupName("(admin)"); // "admin"
- * getPathSegmentGroupName("((group))"); // "group"
- * ```
- *
- * @param path - The command path segment.
- * @returns The group name without parentheses.
- */
-declare function getPathSegmentGroupName(path: string): string;
-/**
- * Extracts the variable name from a command path segment by removing enclosing square brackets.
- *
- * @example
- * ```typescript
- * getDynamicPathSegmentName("[user]"); // "user"
- * ```
- *
- * @param path - The command path segment.
- * @returns The variable name without square brackets.
- */
-declare function getPathSegmentName(path: string): string;
-//#endregion
-export { getAppBin, getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases };
-//# sourceMappingURL=context-helpers.d.cts.map

package/dist/plugin-utils/context-helpers.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-helpers.d.cts","names":[],"sources":["../../src/plugin-utils/context-helpers.ts"],"mappings":";;;;;AA8BA;;;iBAAgB,cAAA,CAAe,OAAiB;AAAA;AAkBhD;;;;;;AAlBgD,iBAkBhC,UAAA,kBAA4B,iBAAA,GAAoB,OAAA,EAC9D,OAAA,EAAS,QAAA;;;;;;;;iBA4BK,WAAA,kBAA6B,iBAAA,GAAoB,OAAA,EAC/D,OAAA,EAAS,QAAA,EACT,UAAA;AAFF;;;;;;AAAA,iBAwBgB,iBAAA,kBAAmC,iBAAA,GAAoB,OAAA,EACrE,OAAA,EAAS,QAAA;;;;;;;iBAeK,SAAA,kBAA2B,iBAAA,GAAoB,OAAA,EAC7D,OAAA,EAAS,QAAA;;AAvCS;AAsBpB;;;;;;;;;;iBAoCgB,oBAAA,CAAqB,IAAY;;;;AAnC9B;AAenB;;;;;;;iBAmCgB,yBAAA,CAA0B,IAAY;;;;;;;AAlCnC;AAmBnB;;;;AAAiD;AAejD;iBAiBgB,kBAAA,CAAmB,IAAY;;;AAjBO;AAiBtD;;;;AAA+C;AAgB/C;;;;iBAAgB,uBAAA,CAAwB,IAAY;AAkBpD;;;;AAA+C;;;;;;;AAA/C,iBAAgB,kBAAA,CAAmB,IAAY"}

package/dist/plugin-utils/context-helpers.d.mts

@@ -1,106 +0,0 @@
-import { Context, UnresolvedContext } from "../types/context.mjs";
-//#region src/plugin-utils/context-helpers.d.ts
-/**
- * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.
- *
- * @param aliases - An array of argument aliases to sort.
- * @returns A new array of sorted aliases.
- */
-declare function sortArgAliases(aliases: string[]): string[];
-/**
- * Retrieves the application name from the context and configuration.
- *
- * @param context - The build context containing workspace and package information.
- * @returns The application name in kebab-case format.
- * @throws An error if no valid application name is found.
- */
-declare function getAppName<TContext extends UnresolvedContext | Context>(context: TContext): string;
-/**
- * Retrieves the application title from the context and configuration.
- *
- * @param context - The build context containing workspace and package information.
- * @param replaceCLI - Whether to replace CLI-related terms in the title with the application name.
- * @returns The application title in title-case format.
- */
-declare function getAppTitle<TContext extends UnresolvedContext | Context>(context: TContext, replaceCLI?: boolean): string;
-/**
- * Retrieves the application description from the context and configuration.
- *
- * @param context - The build context containing workspace and package information.
- * @returns The application description.
- */
-declare function getAppDescription<TContext extends UnresolvedContext | Context>(context: TContext): string;
-/**
- * Retrieves the primary binary name for the application.
- *
- * @param context - The build context containing workspace and package information.
- * @returns The primary binary name as a string.
- */
-declare function getAppBin<TContext extends UnresolvedContext | Context>(context: TContext): string;
-/**
- * Determines if a given command path segment is variable (enclosed in square brackets).
- *
- * @example
- * ```typescript
- * isDynamicPathSegment("[user]"); // true
- * isDynamicPathSegment("user"); // false
- * ```
- *
- * @param path - The command path segment to check.
- * @returns True if the path is variable, false otherwise.
- */
-declare function isDynamicPathSegment(path: string): boolean;
-/**
- * Extracts the variable name from a command path segment by removing enclosing square brackets.
- *
- * @example
- * ```typescript
- * getDynamicPathSegmentName("[user]"); // "user"
- * ```
- *
- * @param path - The command path segment.
- * @returns The variable name without square brackets.
- */
-declare function getDynamicPathSegmentName(path: string): string;
-/**
- * Determines if a given command path segment is a path segment group (enclosed in parentheses).
- *
- * @example
- * ```typescript
- * isPathSegmentGroup("(user)"); // true
- * isPathSegmentGroup("[user]"); // false
- * isPathSegmentGroup("user"); // false
- * ```
- *
- * @param path - The command path segment to check.
- * @returns True if the path is a path segment group, false otherwise.
- */
-declare function isPathSegmentGroup(path: string): boolean;
-/**
- * Extracts the group name from a command path segment by removing enclosing parentheses.
- *
- * @example
- * ```typescript
- * getPathSegmentGroupName("(admin)"); // "admin"
- * getPathSegmentGroupName("((group))"); // "group"
- * ```
- *
- * @param path - The command path segment.
- * @returns The group name without parentheses.
- */
-declare function getPathSegmentGroupName(path: string): string;
-/**
- * Extracts the variable name from a command path segment by removing enclosing square brackets.
- *
- * @example
- * ```typescript
- * getDynamicPathSegmentName("[user]"); // "user"
- * ```
- *
- * @param path - The command path segment.
- * @returns The variable name without square brackets.
- */
-declare function getPathSegmentName(path: string): string;
-//#endregion
-export { getAppBin, getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases };
-//# sourceMappingURL=context-helpers.d.mts.map

package/dist/plugin-utils/context-helpers.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-helpers.d.mts","names":[],"sources":["../../src/plugin-utils/context-helpers.ts"],"mappings":""}

package/dist/plugin-utils/context-helpers.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-helpers.mjs","names":[],"sources":[],"mappings":""}