Function resolveDevcontainerSelection

src/browser/utils/devcontainerSelection.ts:48–117

(
  params: ResolveDevcontainerSelectionParams
)

 * - Loaded + no configs → input mode, user must provide path
 */
export function resolveDevcontainerSelection(
  params: ResolveDevcontainerSelectionParams
): DevcontainerSelection {
  const { selectedRuntime, availabilityState } = params;

  // Not devcontainer mode - hide controls, allow creation
  if (selectedRuntime.mode !== RUNTIME_MODE.DEVCONTAINER) {
    return {
      configPath: "",
      configs: [],
      uiMode: "hidden",
      helperText: null,
      isCreatable: true,
    };
  }

  const selectedPath = selectedRuntime.configPath.trim();

  // Loading state - show skeleton placeholder to avoid flash when switching to dropdown
  if (availabilityState.status === "loading") {
    return {
      configPath: selectedPath,
      configs: [],
      uiMode: "loading",
      helperText: null,
      isCreatable: false, // Block creation until configs loaded
    };
  }

  // Failed state - show input, default to standard path if no selection
  if (availabilityState.status === "failed") {
    const resolvedPath = selectedPath || DEFAULT_DEVCONTAINER_CONFIG_PATH;
    return {
      configPath: resolvedPath,
      configs: [],
      uiMode: "input",
      helperText: "Configs couldn't be loaded. Enter a path to continue.",
      isCreatable: resolvedPath.length > 0,
    };
  }

  // Loaded state - check for available configs
  const availability = availabilityState.data.devcontainer;
  const configs = availability ? getDevcontainerConfigs(availability) : [];

  // Loaded but no configs found - devcontainer option is hidden in UI,
  // but if somehow reached, block creation
  if (configs.length === 0) {
    return {
      configPath: "",
      configs: [],
      uiMode: "hidden",
      helperText: null,
      isCreatable: false,
    };
  }

  // Loaded with configs - show dropdown