// @generated — DO NOT EDIT. Source: packages/shared/project.ts
/**
 * Project Utility — Pure Functions
 *
 * String sanitization and path extraction helpers.
 * Runtime-agnostic: no Bun or Node-specific APIs.
 */

/**
 * Sanitize a string for use as a tag
 * - lowercase
 * - replace spaces/underscores with hyphens
 * - remove special characters
 * - trim to reasonable length
 */
export function sanitizeTag(name: string): string | null {
  if (!name || typeof name !== "string") return null;

  const sanitized = name
    .toLowerCase()
    .trim()
    .replace(/[\s_]+/g, "-")      // spaces/underscores -> hyphens
    .replace(/[^a-z0-9-]/g, "")   // remove special chars
    .replace(/-+/g, "-")          // collapse multiple hyphens
    .replace(/^-|-$/g, "")        // trim leading/trailing hyphens
    .slice(0, 30);                // max 30 chars

  return sanitized.length >= 2 ? sanitized : null;
}

/**
 * Extract repo name from a git root path
 */
export function extractRepoName(gitRootPath: string): string | null {
  if (!gitRootPath || typeof gitRootPath !== "string") return null;

  const trimmed = gitRootPath.trim().replace(/\/+$/, ""); // remove trailing slashes
  const parts = trimmed.split("/");
  const name = parts[parts.length - 1];

  return sanitizeTag(name);
}

/**
 * Extract directory name from a path
 */
export function extractDirName(path: string): string | null {
  if (!path || typeof path !== "string") return null;

  const trimmed = path.trim().replace(/\/+$/, "");
  if (trimmed === "" || trimmed === "/") return null;

  const parts = trimmed.split("/");
  const name = parts[parts.length - 1];

  // Skip generic names
  const skipNames = new Set(["home", "users", "user", "root", "tmp", "var"]);
  if (skipNames.has(name.toLowerCase())) return null;

  return sanitizeTag(name);
}

/**
 * Extract hostname from a URL string, or return the original string on failure.
 */
export function hostnameOrFallback(url: string): string {
  try {
    return new URL(url).hostname;
  } catch {
    return url;
  }
}