@reliverse/dler 1.7.92 → 1.7.94

package/bin/app/utils/handlers/shadcn.js

@@ -0,0 +1,299 @@
+import path from "@reliverse/pathkit";
+import fs from "@reliverse/relifso";
+import { relinka } from "@reliverse/relinka";
+import { execa } from "execa";
+import { pmx } from "../getPackageManager.js";
+const COMPONENT_DEPENDENCIES = {
+  "alert-dialog": ["button"],
+  "context-menu": ["button"],
+  "dropdown-menu": ["button"],
+  form: ["button", "label", "input"],
+  "hover-card": ["button"],
+  menubar: ["button"],
+  "navigation-menu": ["button"],
+  popover: ["button"],
+  sheet: ["button"],
+  toast: ["toast", "button"],
+  combobox: ["popover", "command"],
+  command: ["dialog"],
+  "date-picker": ["button", "calendar", "popover"],
+  "input-otp": ["input"],
+  resizable: ["separator"],
+  sonner: [],
+  "toggle-group": ["toggle"]
+};
+const THEMES = [
+  {
+    name: "Default",
+    colors: {
+      "--background": "0 0% 100%",
+      "--foreground": "240 10% 3.9%",
+      "--card": "0 0% 100%",
+      "--card-foreground": "240 3% 6%",
+      "--card-two": "240 10% 3.9%",
+      "--card-two-foreground": "0 0% 98%",
+      "--popover": "0 0% 100%",
+      "--popover-foreground": "240 10% 3.9%",
+      "--primary": "240 5.9% 10%",
+      "--primary-foreground": "0 0% 98%",
+      "--secondary": "240 4.8% 95.9%",
+      "--secondary-foreground": "240 5.9% 10%",
+      "--muted": "240 4.8% 95.9%",
+      "--muted-foreground": "240 3.8% 46.1%",
+      "--accent": "240 4.8% 95.9%",
+      "--accent-foreground": "240 5.9% 10%",
+      "--destructive": "0 84.2% 60.2%",
+      "--destructive-foreground": "0 0% 98%",
+      "--border": "240 5.9% 90%",
+      "--input": "240 5.9% 90%",
+      "--ring": "240 10% 3.9%",
+      "--chart-1": "12 76% 61%",
+      "--chart-2": "173 58% 39%",
+      "--chart-3": "197 37% 24%",
+      "--chart-4": "43 74% 66%",
+      "--chart-5": "27 87% 67%",
+      "--radius": "0.5rem",
+      "--sidebar-background": "0 0% 98%",
+      "--sidebar-foreground": "240 5.3% 26.1%",
+      "--sidebar-primary": "240 5.9% 10%",
+      "--sidebar-primary-foreground": "0 0% 98%",
+      "--sidebar-accent": "240 4.8% 95.9%",
+      "--sidebar-accent-foreground": "240 5.9% 10%",
+      "--sidebar-border": "220 13% 91%",
+      "--sidebar-ring": "217.2 91.2% 59.8%"
+    }
+  },
+  {
+    name: "Dark",
+    colors: {
+      "--background": "240 10% 3.9%",
+      "--foreground": "0 0% 98%",
+      "--card": "240 10% 3.9%",
+      "--card-foreground": "0 0% 98%",
+      "--card-two": "240 3% 6%",
+      "--card-two-foreground": "0 0% 98%",
+      "--popover": "240 10% 3.9%",
+      "--popover-foreground": "0 0% 98%",
+      "--primary": "0 0% 98%",
+      "--primary-foreground": "240 5.9% 10%",
+      "--secondary": "240 3.7% 15.9%",
+      "--secondary-foreground": "0 0% 98%",
+      "--muted": "240 3.7% 15.9%",
+      "--muted-foreground": "240 5% 64.9%",
+      "--accent": "240 3.7% 15.9%",
+      "--accent-foreground": "0 0% 98%",
+      "--destructive": "0 62.8% 30.6%",
+      "--destructive-foreground": "0 0% 98%",
+      "--border": "240 3.7% 15.9%",
+      "--input": "240 3.7% 15.9%",
+      "--ring": "240 4.9% 83.9%",
+      "--chart-1": "220 70% 50%",
+      "--chart-2": "160 60% 45%",
+      "--chart-3": "30 80% 55%",
+      "--chart-4": "280 65% 60%",
+      "--chart-5": "340 75% 55%",
+      "--radius": "0.5rem",
+      "--sidebar-background": "240 5.9% 10%",
+      "--sidebar-foreground": "240 4.8% 95.9%",
+      "--sidebar-primary": "224.3 76.3% 48%",
+      "--sidebar-primary-foreground": "0 0% 100%",
+      "--sidebar-accent": "240 3.7% 15.9%",
+      "--sidebar-accent-foreground": "240 4.8% 95.9%",
+      "--sidebar-border": "240 3.7% 15.9%",
+      "--sidebar-ring": "217.2 91.2% 59.8%"
+    }
+  }
+];
+export async function readShadcnConfig(cwd) {
+  const configPath = path.join(cwd, "components.json");
+  try {
+    if (await fs.pathExists(configPath)) {
+      return await fs.readJson(configPath);
+    }
+  } catch (error) {
+    relinka(
+      "error",
+      "Error reading shadcn config:",
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+  return null;
+}
+export async function getInstalledComponents(cwd, config) {
+  const uiPath = path.join(cwd, config.aliases.ui.replace("~", "src"));
+  try {
+    if (await fs.pathExists(uiPath)) {
+      const files = await fs.readdir(uiPath);
+      return files.filter((f) => f.endsWith(".tsx")).map((f) => f.replace(".tsx", ""));
+    }
+  } catch (error) {
+    relinka(
+      "error",
+      "Error reading UI components:",
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+  return [];
+}
+async function ensureComponentDependencies(cwd, component, config) {
+  const dependencies = COMPONENT_DEPENDENCIES[component] ?? [];
+  const installedComponents = await getInstalledComponents(cwd, config);
+  for (const dep of dependencies) {
+    if (!installedComponents.includes(dep)) {
+      relinka("info", `Installing required dependency: ${dep}`);
+      await installComponent(cwd, dep);
+    }
+  }
+}
+export async function installComponent(cwd, component, options = {}) {
+  try {
+    const config = await readShadcnConfig(cwd);
+    if (!config) {
+      relinka("error", "shadcn/ui configuration not found");
+      return;
+    }
+    await ensureComponentDependencies(cwd, component, config);
+    const args = ["shadcn-ui@latest", "add", component];
+    if (options.yes) {
+      args.push("--yes");
+    }
+    if (options.overwrite) {
+      args.push("--overwrite");
+    }
+    if (options.all) {
+      args.push("--all");
+    }
+    if (options.path) {
+      args.push("--path");
+      args.push(options.path);
+    }
+    await execa(pmx, args, { cwd });
+    relinka("success", `Installed component: ${component}`);
+  } catch (error) {
+    relinka(
+      "error",
+      `Failed to install ${component}:`,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+}
+export async function updateComponent(cwd, component) {
+  return installComponent(cwd, component, { overwrite: true });
+}
+export async function removeComponent(cwd, config, component) {
+  try {
+    const dependentComponents = Object.entries(COMPONENT_DEPENDENCIES).filter(([_, deps]) => deps.includes(component)).map(([comp]) => comp);
+    const installedComponents = await getInstalledComponents(cwd, config);
+    const installedDependents = dependentComponents.filter(
+      (comp) => installedComponents.includes(comp)
+    );
+    if (installedDependents.length > 0) {
+      relinka(
+        "error",
+        `Cannot remove ${component} as it is required by: ${installedDependents.join(", ")}`
+      );
+      return;
+    }
+    const componentPath = path.join(cwd, config.aliases.ui.replace("~", "src"), `${component}.tsx`);
+    await fs.remove(componentPath);
+    relinka("success", `Removed component: ${component}`);
+  } catch (error) {
+    relinka(
+      "error",
+      `Failed to remove ${component}:`,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+}
+export async function applyTheme(cwd, config, theme) {
+  const cssPath = path.join(cwd, config.tailwind.css.replace("~", "src"));
+  try {
+    let cssContent = await fs.readFile(cssPath, "utf-8");
+    await fs.writeFile(`${cssPath}.backup`, cssContent);
+    const rootRegex = /:root\s*{[^}]*}/;
+    const newRootSection = `:root {
+${Object.entries(theme.colors).map(([key, value]) => `    ${key}: ${value};`).join("\n")}
+  }`;
+    cssContent = cssContent.replace(rootRegex, newRootSection);
+    await fs.writeFile(cssPath, cssContent);
+    relinka("success", `Applied theme: ${theme.name} (backup created at ${cssPath}.backup)`);
+  } catch (error) {
+    relinka(
+      "error",
+      `Failed to apply theme ${theme.name}:`,
+      error instanceof Error ? error.message : String(error)
+    );
+    try {
+      if (await fs.pathExists(`${cssPath}.backup`)) {
+        await fs.copy(`${cssPath}.backup`, cssPath);
+        relinka("info", "Restored previous theme from backup");
+      }
+    } catch (backupError) {
+      relinka(
+        "error",
+        "Failed to restore theme backup:",
+        backupError instanceof Error ? backupError.message : String(backupError)
+      );
+    }
+  }
+}
+export const AVAILABLE_COMPONENTS = [
+  "accordion",
+  "alert-dialog",
+  "alert",
+  "aspect-ratio",
+  "avatar",
+  "badge",
+  "button",
+  "calendar",
+  "card",
+  "carousel",
+  "charts",
+  "checkbox",
+  "collapsible",
+  "combobox",
+  "command",
+  "context-menu",
+  "data-table",
+  "date-picker",
+  "dialog",
+  "drawer",
+  "dropdown-menu",
+  "form",
+  "hover-card",
+  "input",
+  "input-otp",
+  "label",
+  "menubar",
+  "navigation-menu",
+  "pagination",
+  "popover",
+  "progress",
+  "radio-group",
+  "resizable",
+  "scroll-area",
+  "select",
+  "separator",
+  "sheet",
+  "sidebar",
+  "skeleton",
+  "slider",
+  "sonner",
+  "switch",
+  "table",
+  "tabs",
+  "textarea",
+  "toast",
+  "toggle",
+  "toggle-group",
+  "tooltip"
+];
+export { THEMES };
+export function selectSidebarPrompt(projectPath) {
+  relinka("verbose", "The following project requested sidebar installation", projectPath);
+  relinka("verbose", "Coming soon...");
+}
+export function selectChartsPrompt(projectPath) {
+  relinka("verbose", "The following project requested charts installation", projectPath);
+  relinka("verbose", "Coming soon...");
+}

package/bin/app/utils/hasOnlyRseConfig.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Checks if a directory contains only rseg files
+ * @param directory Path to the directory
+ * @returns Boolean indicating if the directory contains only rseg files
+ */
+export declare function hasOnlyRse(directory: string): Promise<boolean>;

package/bin/app/utils/hasOnlyRseConfig.js

@@ -0,0 +1,15 @@
+import fs from "@reliverse/relifso";
+const cliConfigTs = "reliverse.ts";
+const cliConfigJsonc = "rse";
+export async function hasOnlyRse(directory) {
+  try {
+    const files = await fs.readdir(directory);
+    if (files.length === 0) {
+      return false;
+    }
+    const rseFiles = [cliConfigJsonc, cliConfigTs];
+    return files.every((file) => rseFiles.includes(file));
+  } catch (_error) {
+    return false;
+  }
+}

package/bin/app/utils/init/init-const.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Known file types with possible variations.
+ */
+export declare const FILE_TYPES: readonly [{
+    readonly type: "cfg:eslint";
+    readonly variations: readonly ["eslint.config.js"];
+}, {
+    readonly type: "cfg:knip";
+    readonly variations: readonly ["knip.json"];
+}, {
+    readonly type: "cfg:reliverse";
+    readonly variations: readonly ["reliverse.jsonc", "reliverse.ts"];
+}, {
+    readonly type: "cfg:package.json";
+    readonly variations: readonly ["package.json"];
+}, {
+    readonly type: "cfg:tsconfig.json";
+    readonly variations: readonly ["tsconfig.json"];
+}, {
+    readonly type: "git:gitattributes";
+    readonly variations: readonly [".gitattributes"];
+}, {
+    readonly type: "git:gitignore";
+    readonly variations: readonly [".gitignore"];
+}, {
+    readonly type: "md:LICENSE";
+    readonly variations: readonly ["LICENSE.md", "LICENSE"];
+}, {
+    readonly type: "md:README";
+    readonly variations: readonly ["README.md", "README"];
+}];
+export declare const INIT_BEHAVIOURS: readonly ["create", "copy", "create-if-copy-failed"];
+export declare const DEST_FILE_EXISTS_BEHAVIOURS: readonly ["rewrite", "skip", "attach-index", "prompt"];
+export declare const CONTENT_CREATE_MODES: string[];

package/bin/app/utils/init/init-const.js

@@ -0,0 +1,17 @@
+export const FILE_TYPES = [
+  { type: "cfg:eslint", variations: ["eslint.config.js"] },
+  { type: "cfg:knip", variations: ["knip.json"] },
+  {
+    type: "cfg:reliverse",
+    variations: ["reliverse.jsonc", "reliverse.ts"]
+  },
+  { type: "cfg:package.json", variations: ["package.json"] },
+  { type: "cfg:tsconfig.json", variations: ["tsconfig.json"] },
+  { type: "git:gitattributes", variations: [".gitattributes"] },
+  { type: "git:gitignore", variations: [".gitignore"] },
+  { type: "md:LICENSE", variations: ["LICENSE.md", "LICENSE"] },
+  { type: "md:README", variations: ["README.md", "README"] }
+];
+export const INIT_BEHAVIOURS = ["create", "copy", "create-if-copy-failed"];
+export const DEST_FILE_EXISTS_BEHAVIOURS = ["rewrite", "skip", "attach-index", "prompt"];
+export const CONTENT_CREATE_MODES = ["license-basic", "simple-readme"];

package/bin/app/utils/instanceGithub.d.ts

@@ -0,0 +1,29 @@
+import type { ReliverseMemory } from "./schemaMemory";
+export declare const OctokitWithRest: typeof import("@octokit/core").Octokit & (new (...args: any[]) => import("@octokit/plugin-rest-endpoint-methods/dist-types/generated/method-types").RestEndpointMethods & import("@octokit/plugin-rest-endpoint-methods").Api & {
+    paginate: import("@octokit/plugin-paginate-rest").PaginateInterface;
+}) & import("@octokit/core/dist-types/types").Constructor<import("@octokit/plugin-rest-endpoint-methods").Api>;
+export declare const octokitUserAgent: string;
+export type InstanceGithub = InstanceType<typeof OctokitWithRest>;
+/**
+ * Ensures a valid GitHub token is available in rse's memory.
+ *
+ * If a token is already stored in memory, this function validates it by fetching the
+ * authenticated user's information. If the token is missing or invalid, the user is prompted
+ * to input one. The new token is then saved persistently.
+ *
+ * @param memory - The rse memory object.
+ * @param maskInput - A flag or the string "prompt" that determines if input should be masked.
+ * @returns The valid GitHub token.
+ */
+export declare function ensureGithubToken(memory: ReliverseMemory, maskInput: "prompt" | boolean): Promise<string>;
+/**
+ * Initializes a GitHub SDK instance and returns the GitHub token along with the Octokit instance.
+ *
+ * This function is analogous to the Vercel SDK init function; it ensures that a valid GitHub token is
+ * available (prompting for one if necessary), initializes Octokit with the token, and returns both.
+ *
+ * @param memory - The rse memory object.
+ * @param maskInput - A flag or "prompt" to determine if the token input should be masked.
+ * @returns A tuple containing the GitHub token and works as the wrapper for the Octokit instance.
+ */
+export declare function initGithubSDK(memory: ReliverseMemory, frontendUsername: string, maskInput: "prompt" | boolean): Promise<[string, InstanceGithub, string]>;

package/bin/app/utils/instanceGithub.js

@@ -0,0 +1,50 @@
+import { restEndpointMethods } from "@octokit/plugin-rest-endpoint-methods";
+import { Octokit } from "@octokit/rest";
+import { relinka } from "@reliverse/relinka";
+import { inputPrompt } from "@reliverse/rempts";
+import { cliVersion } from "../config/constants.js";
+import { askUsernameGithub } from "./prompts/askUsernameGithub.js";
+import { updateReliverseMemory } from "./reliverseMemory.js";
+export const OctokitWithRest = Octokit.plugin(restEndpointMethods);
+export const octokitUserAgent = `rse/${cliVersion}`;
+function initOctokitSDK(githubKey) {
+  return new OctokitWithRest({
+    auth: githubKey.trim(),
+    userAgent: octokitUserAgent,
+    throttle: {
+      onRateLimit: (_retryAfter, options, octokit) => {
+        octokit.log.warn(`Request quota exhausted for ${options.method} ${options.url}`);
+        return options.request.retryCount === 0;
+      },
+      onSecondaryRateLimit: (_retryAfter, options, octokit) => {
+        octokit.log.warn(`Secondary rate limit encountered for ${options.method} ${options.url}`);
+        return options.request.retryCount === 0;
+      }
+    }
+  });
+}
+export async function ensureGithubToken(memory, maskInput) {
+  if (memory.githubKey) {
+    try {
+      const octokit = initOctokitSDK(memory.githubKey);
+      await octokit.rest.users.getAuthenticated();
+      return memory.githubKey.trim();
+    } catch (error) {
+      relinka("warn", "Existing GitHub token is invalid. Please provide a new one.");
+      relinka("verbose", error instanceof Error ? error.message : String(error));
+    }
+  }
+  const token = await inputPrompt({
+    title: "Please enter your GitHub personal access token.\n(It will be securely stored on your machine):",
+    content: "Create one at https://github.com/settings/tokens/new\nEnsure you select the `repo` scope, then click `Generate token`.",
+    mode: maskInput ? "password" : "plain"
+  });
+  await updateReliverseMemory({ githubKey: token });
+  return token;
+}
+export async function initGithubSDK(memory, frontendUsername, maskInput) {
+  const githubUsername = await askUsernameGithub(memory, frontendUsername);
+  const githubToken = await ensureGithubToken(memory, maskInput);
+  const githubInstance = initOctokitSDK(githubToken);
+  return [githubToken, githubInstance, githubUsername];
+}

package/bin/app/utils/instanceVercel.d.ts

@@ -0,0 +1,16 @@
+import { VercelCore } from "@vercel/sdk/core";
+import type { ReliverseMemory } from "./schemaMemory.js";
+export type InstanceVercel = VercelCore;
+/**
+ * Prompts the user for a Vercel token if none is stored
+ */
+export declare function askVercelToken(maskInput: boolean, memory: ReliverseMemory): Promise<string | undefined>;
+/**
+ * Creates a new Vercel SDK instance by obtaining the token either from memory
+ * or by prompting the user. The token is then used to initialize VercelCore.
+ *
+ * It's recommended to call it once and pass the instance through the user flow.
+ *
+ * This `@vercel/sdk` init returns `[token, vercel]`.
+ */
+export declare function initVercelSDK(memory: ReliverseMemory, maskInput: boolean): Promise<[string, VercelCore] | undefined>;

package/bin/app/utils/instanceVercel.js

@@ -0,0 +1,39 @@
+import { relinka } from "@reliverse/relinka";
+import { inputPrompt } from "@reliverse/rempts";
+import { VercelCore } from "@vercel/sdk/core";
+import { saveVercelToken } from "../init/use-template/cp-modules/git-deploy-prompts/vercel/vercel-utils.js";
+export async function askVercelToken(maskInput, memory) {
+  if (!memory?.vercelKey) {
+    const token = await inputPrompt({
+      title: "Please enter your Vercel personal access token.\n(It will be securely stored on your machine):",
+      content: "Create one at https://vercel.com/account/settings/tokens",
+      mode: maskInput ? "password" : "plain",
+      validate: (value) => {
+        if (!value?.trim()) return "Token is required";
+        return true;
+      }
+    });
+    if (!token) {
+      relinka("error", "No token provided");
+      return;
+    }
+    return token;
+  }
+  return memory.vercelKey;
+}
+export async function initVercelSDK(memory, maskInput) {
+  let vercelToken = memory?.vercelKey;
+  if (!vercelToken) {
+    vercelToken = await askVercelToken(maskInput, memory);
+    if (!vercelToken) {
+      relinka("error", "No token provided");
+      return;
+    }
+  }
+  const vercelInstance = new VercelCore({ bearerToken: vercelToken });
+  if (!memory.vercelKey) {
+    await saveVercelToken(vercelToken, memory, vercelInstance);
+    memory.vercelKey = vercelToken;
+  }
+  return [vercelToken, vercelInstance];
+}

package/bin/app/utils/microHelpers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Helper function to compute maximum items based on terminal height.
+ * @returns Number of maximum items allowed.
+ */
+export declare function getMaxHeightSize(): number;
+/**
+ * Sleeps for the specified number of milliseconds.
+ * @param ms - Milliseconds to sleep.
+ * @returns A promise that resolves after the given time.
+ */
+export declare function sleep(ms: number): Promise<void>;

package/bin/app/utils/microHelpers.js

@@ -0,0 +1,8 @@
+import { getTerminalHeight } from "@reliverse/rempts";
+export function getMaxHeightSize() {
+  const hSize = getTerminalHeight();
+  return hSize < 30 ? 10 : hSize;
+}
+export function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/bin/app/utils/mrseHelpers.d.ts

@@ -0,0 +1,6 @@
+export declare function hasConfigFiles(projectPath: string): Promise<boolean>;
+/**
+ * Checks if the given project path is a Mrse project
+ * @param projectPath The path to the project to check
+ */
+export declare function isMrseProject(projectPath: string): Promise<boolean>;

package/bin/app/utils/mrseHelpers.js

@@ -0,0 +1,21 @@
+import path from "@reliverse/pathkit";
+import fs from "@reliverse/relifso";
+export async function hasConfigFiles(projectPath) {
+  try {
+    const files = await fs.readdir(projectPath);
+    return files.some(
+      (file) => (file.endsWith(".jsonc") || file.endsWith(".ts")) && !file.includes("mrse.")
+    );
+  } catch (_err) {
+    return false;
+  }
+}
+export async function isMrseProject(projectPath) {
+  const configPath = path.join(projectPath, ".config");
+  const mrseFolderPath = path.join(projectPath, "mrse");
+  const hasMrseConfig = await Promise.all([
+    fs.pathExists(path.join(configPath, "mreliverse.ts")),
+    fs.pathExists(path.join(configPath, "mreliverse.jsonc"))
+  ]).then(([hasTs, hasJsonc]) => hasTs || hasJsonc);
+  return hasMrseConfig && await fs.pathExists(mrseFolderPath) && await hasConfigFiles(mrseFolderPath);
+}

package/bin/app/utils/native-cli/nc-impl.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Downloads all files for a given JSR package concurrently.
+ *
+ * @param scope - e.g. "luca"
+ * @param packageName - e.g. "flag"
+ * @param version - Specific version; if omitted, the highest valid version is chosen.
+ * @param outputDir - Where to save files. (Defaults to "<__dirname>/output")
+ * @param useSinglePath - If true, writes all files directly into outputDir; otherwise uses a nested structure.
+ * @param concurrency - Maximum number of parallel downloads (default: 5)
+ * @param pkgIsCLI - Whether the package is a CLI tool.
+ * @param msgDownloadStarted - Optional custom message when download starts.
+ * @param revertTsxFiles - If true (and pkgIsCLI), renames -tsx.txt files back to .tsx after download.
+ * @param cliInstallDeps - If true (and pkgIsCLI), installs dependencies after download.
+ */
+export declare function downloadJsrDist(scope: string, packageName: string, version?: string, outputDir?: string, useSinglePath?: boolean, concurrency?: number, pkgIsCLI?: boolean, msgDownloadStarted?: string, revertTsxFiles?: boolean, cliInstallDeps?: boolean): Promise<void>;