dksetup 1.0.0

package/installers/animator.ts

@@ -0,0 +1,115 @@
+import fs from 'fs';
+import path from 'path';
+
+/**
+ * Extracts animation frames from the provided HTML/JS file dynamically.
+ * @param filePath Path to the animation file
+ * @returns Array of string frames
+ */
+export function getAnimationFrames(filePath: string): string[] {
+    try {
+        const fullPath = path.resolve(filePath);
+        if (!fs.existsSync(fullPath)) {
+            return [];
+        }
+
+        const content = fs.readFileSync(fullPath, 'utf8');
+        const frames: string[] = [];
+
+        // Simple string splitting to avoid regex ReDoS
+        const parts = content.split('n[');
+        for (let i = 1; i < parts.length; i++) {
+            const p = parts[i];
+            const startStr = "] = '";
+            const startIdx = p.indexOf(startStr);
+            if (startIdx > -1) {
+                const body = p.substring(startIdx + startStr.length);
+                const endIdx = body.indexOf("';");
+
+                if (endIdx > -1) {
+                    // Extract the string and replace literal \\n with actual newlines
+                    let frame = body.substring(0, endIdx);
+                    frame = frame.replace(/\\n/g, '\n');
+                    // Add some spacing or trim if necessary, but keep original for now
+                    frames.push(frame);
+                }
+            }
+        }
+
+        // Second pass: Crop the frames to the minimum bounding box
+        let minLeadingSpaces = Infinity;
+        let minTrailingSpaces = Infinity;
+        let firstNonEmptyLine = Infinity;
+        let lastNonEmptyLine = -1;
+
+        const parsedFrames = frames.map(f => f.split('\n'));
+        const frameHeight = parsedFrames[0]?.length || 0;
+
+        for (const lines of parsedFrames) {
+            for (let r = 0; r < lines.length; r++) {
+                const line = lines[r];
+                if (line.trim().length === 0) continue;
+
+                firstNonEmptyLine = Math.min(firstNonEmptyLine, r);
+                lastNonEmptyLine = Math.max(lastNonEmptyLine, r);
+
+                const leading = line.match(/^ */)?.[0].length || 0;
+                const trailing = line.match(/ *$/)?.[0].length || 0;
+
+                minLeadingSpaces = Math.min(minLeadingSpaces, leading);
+                minTrailingSpaces = Math.min(minTrailingSpaces, trailing);
+            }
+        }
+
+        const croppedFrames: string[] = [];
+        for (const lines of parsedFrames) {
+            const croppedLines = [];
+            for (let r = firstNonEmptyLine; r <= lastNonEmptyLine; r++) {
+                const line = lines[r] || '';
+                // Remove the minimum leading spaces, and trim the end
+                croppedLines.push(line.substring(Math.min(minLeadingSpaces, line.length)).trimEnd());
+            }
+            croppedFrames.push(croppedLines.join('\n'));
+        }
+
+        // User requested smaller size, re-adding downscaling to maximum 25x12
+        const MAX_WIDTH = 25;
+        const MAX_HEIGHT = 12;
+
+        const scaledFrames: string[] = [];
+        for (const frame of croppedFrames) {
+            const lines = frame.split('\n');
+            const height = lines.length;
+            const width = Math.max(...lines.map(l => l.length));
+
+            if (height > MAX_HEIGHT || width > MAX_WIDTH) {
+                const scaleY = height / MAX_HEIGHT;
+                const scaleX = width / MAX_WIDTH;
+                const scale = Math.max(scaleX, scaleY);
+
+                const newHeight = Math.floor(height / scale);
+                const newWidth = Math.floor(width / scale);
+
+                const scaledLines = [];
+                for (let y = 0; y < newHeight; y++) {
+                    let newLine = '';
+                    for (let x = 0; x < newWidth; x++) {
+                        const origY = Math.floor(y * scale);
+                        const origX = Math.floor(x * scale);
+                        const origChar = lines[origY]?.[origX] || ' ';
+                        newLine += origChar;
+                    }
+                    scaledLines.push(newLine);
+                }
+                scaledFrames.push(scaledLines.join('\n'));
+            } else {
+                scaledFrames.push(frame);
+            }
+        }
+
+        return scaledFrames;
+    } catch (e) {
+        console.error("Animator error:", e);
+        return [];
+    }
+}

package/installers/blender.ts

@@ -0,0 +1,48 @@
+import { Installer } from './installer.js';
+import chalk from 'chalk';
+import { execSync } from 'child_process';
+import * as os from 'os';
+
+export const BlenderInstaller: Installer = {
+    name: 'Blender',
+    description: 'Free and open source 3D creation suite',
+    check: async () => {
+        const platform = os.platform();
+        try {
+            if (platform === 'win32') {
+                // Checking via winget or checking Program Files
+                execSync('winget list -e --id BlenderFoundation.Blender', { stdio: 'ignore' });
+                return true;
+            } else if (platform === 'darwin') {
+                execSync('ls /Applications/Blender.app', { stdio: 'ignore' });
+                return true;
+            } else {
+                execSync('blender --version', { stdio: 'ignore' });
+                return true;
+            }
+        } catch {
+            return false;
+        }
+    },
+    install: async () => {
+        const platform = os.platform();
+        console.log(chalk.cyan(`Installing or Updating ${chalk.bold('Blender')}...`));
+
+        try {
+            if (platform === 'win32') {
+                console.log(chalk.gray('> winget install --id BlenderFoundation.Blender -e --source winget --accept-package-agreements --accept-source-agreements'));
+                // Remove the comment below to actually run the command
+                execSync('winget install --id BlenderFoundation.Blender -e --source winget --accept-package-agreements --accept-source-agreements', { stdio: 'inherit' });
+            } else if (platform === 'darwin') {
+                console.log(chalk.gray('> brew install --cask blender'));
+                execSync('brew install --cask blender', { stdio: 'inherit' });
+            } else if (platform === 'linux') {
+                console.log(chalk.gray('> sudo snap install blender --classic'));
+                execSync('sudo snap install blender --classic', { stdio: 'inherit' });
+            }
+            console.log(chalk.green('✔ Blender installed/updated successfully!'));
+        } catch (error) {
+            console.log(chalk.red('✖ Failed to install or update Blender. It might already be running or require admin privileges.'));
+        }
+    }
+};

package/installers/git.ts

@@ -0,0 +1,35 @@
+import { Installer } from './installer.js';
+import chalk from 'chalk';
+import { execSync } from 'child_process';
+import * as os from 'os';
+
+export const GitInstaller: Installer = {
+    name: 'Git',
+    description: 'Distributed version control system',
+    check: async () => {
+        try {
+            execSync('git --version', { stdio: 'ignore' });
+            return true;
+        } catch {
+            return false;
+        }
+    },
+    install: async () => {
+        const platform = os.platform();
+        console.log(chalk.cyan(`Installing ${chalk.bold('Git')}...`));
+
+        try {
+            if (platform === 'win32') {
+                console.log(chalk.gray('> winget install --id Git.Git -e --source winget'));
+                // execSync('winget install --id Git.Git -e --source winget', { stdio: 'inherit' });
+            } else if (platform === 'darwin') {
+                console.log(chalk.gray('> brew install git'));
+            } else if (platform === 'linux') {
+                console.log(chalk.gray('> sudo apt-get install git'));
+            }
+            console.log(chalk.green('✔ Git installed successfully!'));
+        } catch (error) {
+            console.log(chalk.red('✖ Failed to install Git.'));
+        }
+    }
+};

package/installers/installer.ts

@@ -0,0 +1,13 @@
+export interface Installer {
+    name: string;
+    description: string;
+    /**
+     * Checks if the software is already installed.
+     * Returns true if installed, false otherwise.
+     */
+    check: () => Promise<boolean>;
+    /**
+     * Runs the installation process for the software.
+     */
+    install: () => Promise<void>;
+}

package/installers/npm.ts

@@ -0,0 +1,28 @@
+import { Installer } from './installer.js';
+import chalk from 'chalk';
+import { execSync } from 'child_process';
+
+export const NpmInstaller: Installer = {
+    name: 'npm',
+    description: 'Node Package Manager',
+    check: async () => {
+        try {
+            execSync('npm --version', { stdio: 'ignore' });
+            return true;
+        } catch {
+            return false;
+        }
+    },
+    install: async () => {
+        console.log(chalk.cyan(`Installing or Updating ${chalk.bold('npm')}...`));
+
+        try {
+            console.log(chalk.gray('> npm install -g npm'));
+            // Remove the comment below to actually run the command if desired
+            // execSync('npm install -g npm', { stdio: 'inherit' });
+            console.log(chalk.green('✔ npm installed/updated successfully!'));
+        } catch (error) {
+            console.log(chalk.red('✖ Failed to install or update npm. Make sure Node.js is installed first.'));
+        }
+    }
+};

package/installers/powertoys.ts

@@ -0,0 +1,38 @@
+import { Installer } from './installer.js';
+import chalk from 'chalk';
+import { execSync } from 'child_process';
+import * as os from 'os';
+
+export const PowerToysInstaller: Installer = {
+    name: 'PowerToys',
+    description: 'Microsoft PowerToys utility set',
+    check: async () => {
+        const platform = os.platform();
+        if (platform !== 'win32') return true; // Pretend installed/not applicable on non-Windows
+
+        try {
+            // Check if PowerToys is installed using winget
+            execSync('winget list -e --id Microsoft.PowerToys', { stdio: 'ignore' });
+            return true;
+        } catch {
+            return false;
+        }
+    },
+    install: async () => {
+        const platform = os.platform();
+        if (platform !== 'win32') {
+            console.log(chalk.yellow('⚠ PowerToys is only available on Windows. Skipping.'));
+            return;
+        }
+
+        console.log(chalk.cyan(`Installing ${chalk.bold('PowerToys')}...`));
+
+        try {
+            console.log(chalk.gray('> winget install Microsoft.PowerToys --source winget'));
+            // execSync('winget install Microsoft.PowerToys --source winget', { stdio: 'inherit' });
+            console.log(chalk.green('✔ PowerToys installed successfully!'));
+        } catch (error) {
+            console.log(chalk.red('✖ Failed to install PowerToys.'));
+        }
+    }
+};

package/languages/cpp.ts

@@ -0,0 +1,44 @@
+import { Installer } from '../installers/installer.js';
+import chalk from 'chalk';
+import { execSync } from 'child_process';
+import * as os from 'os';
+
+export const CppInstaller: Installer = {
+    name: 'C/C++ Compiler',
+    description: 'C/C++ development tools',
+    check: async () => {
+        const platform = os.platform();
+        try {
+            if (platform === 'win32') {
+                // simple check for clang, gcc or cl
+                try { execSync('gcc --version', { stdio: 'ignore' }); return true; } catch { }
+                try { execSync('clang --version', { stdio: 'ignore' }); return true; } catch { }
+                try { execSync('cl', { stdio: 'ignore' }); return true; } catch { }
+                return false;
+            } else {
+                execSync('gcc --version', { stdio: 'ignore' });
+                return true;
+            }
+        } catch {
+            return false;
+        }
+    },
+    install: async () => {
+        const platform = os.platform();
+        console.log(chalk.cyan(`Installing ${chalk.bold('C/C++ Compiler')}...`));
+
+        try {
+            if (platform === 'win32') {
+                console.log(chalk.gray('> winget install LLVM.LLVM'));
+                // execSync('winget install LLVM.LLVM', { stdio: 'inherit' });
+            } else if (platform === 'darwin') {
+                console.log(chalk.gray('> xcode-select --install'));
+            } else if (platform === 'linux') {
+                console.log(chalk.gray('> sudo apt-get install -y build-essential'));
+            }
+            console.log(chalk.green('✔ C/C++ Compiler installed successfully!'));
+        } catch (error) {
+            console.log(chalk.red('✖ Failed to install C/C++ Compiler.'));
+        }
+    }
+};

package/languages/nodejs.ts

@@ -0,0 +1,34 @@
+import { Installer } from '../installers/installer.js';
+import chalk from 'chalk';
+import { execSync } from 'child_process';
+import * as os from 'os';
+
+export const NodeInstaller: Installer = {
+    name: 'Node.js',
+    description: 'JavaScript runtime built on Chrome\'s V8 JavaScript engine',
+    check: async () => {
+        try {
+            execSync('node --version', { stdio: 'ignore' });
+            return true;
+        } catch {
+            return false;
+        }
+    },
+    install: async () => {
+        const platform = os.platform();
+        console.log(chalk.cyan(`Installing ${chalk.bold('Node.js')}...`));
+
+        try {
+            if (platform === 'win32') {
+                console.log(chalk.gray('> winget install OpenJS.NodeJS'));
+            } else if (platform === 'darwin') {
+                console.log(chalk.gray('> brew install node'));
+            } else if (platform === 'linux') {
+                console.log(chalk.gray('> curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs'));
+            }
+            console.log(chalk.green('✔ Node.js installed successfully!'));
+        } catch (error) {
+            console.log(chalk.red('✖ Failed to install Node.js.'));
+        }
+    }
+};

package/languages/python.ts

@@ -0,0 +1,35 @@
+import { Installer } from '../installers/installer.js';
+import chalk from 'chalk';
+import { execSync } from 'child_process';
+import * as os from 'os';
+
+export const PythonInstaller: Installer = {
+    name: 'Python',
+    description: 'Python programming language',
+    check: async () => {
+        try {
+            execSync('python --version', { stdio: 'ignore' });
+            return true;
+        } catch {
+            return false;
+        }
+    },
+    install: async () => {
+        const platform = os.platform();
+        console.log(chalk.cyan(`Installing ${chalk.bold('Python')}...`));
+
+        try {
+            if (platform === 'win32') {
+                console.log(chalk.gray('> winget install --id Python.Python.3.12 -e --source winget'));
+                // execSync('winget install --id Python.Python.3.12 -e --source winget', { stdio: 'inherit' });
+            } else if (platform === 'darwin') {
+                console.log(chalk.gray('> brew install python'));
+            } else if (platform === 'linux') {
+                console.log(chalk.gray('> sudo apt-get install -y python3 python3-pip'));
+            }
+            console.log(chalk.green('✔ Python installed successfully!'));
+        } catch (error) {
+            console.log(chalk.red('✖ Failed to install Python.'));
+        }
+    }
+};

package/languages/typescript.ts

@@ -0,0 +1,27 @@
+import { Installer } from '../installers/installer.js';
+import chalk from 'chalk';
+import { execSync } from 'child_process';
+
+export const TypeScriptInstaller: Installer = {
+    name: 'TypeScript',
+    description: 'TypeScript language (global install)',
+    check: async () => {
+        try {
+            execSync('tsc --version', { stdio: 'ignore' });
+            return true;
+        } catch {
+            return false;
+        }
+    },
+    install: async () => {
+        console.log(chalk.cyan(`Installing ${chalk.bold('TypeScript')}...`));
+
+        try {
+            console.log(chalk.gray('> npm install -g typescript ts-node'));
+            // execSync('npm install -g typescript ts-node', { stdio: 'inherit' });
+            console.log(chalk.green('✔ TypeScript installed successfully!'));
+        } catch (error) {
+            console.log(chalk.red('✖ Failed to install TypeScript. Ensure Node.js and npm are installed.'));
+        }
+    }
+};

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "dksetup",
+  "version": "1.0.0",
+  "description": "A CLI toolkit for DK-CLI.",
+  "main": "index.js",
+  "bin": {
+    "dksetup": "index.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "Dannan <your-email@example.com>",
+  "license": "MIT",
+  "type": "commonjs",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "chalk-animation": "^2.0.3",
+    "commander": "^14.0.3",
+    "enquirer": "^2.4.1",
+    "gradient-string": "^3.0.0",
+    "ora": "^9.3.0"
+  },
+  "devDependencies": {
+    "@types/chalk-animation": "^1.6.3",
+    "@types/gradient-string": "^1.1.6",
+    "@types/node": "^25.3.0",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}

package/plan.md

@@ -0,0 +1,53 @@
+## Outline: Full Environment Setup (Cross-Platform CLI Tool)
+
+## Purpose
+Enable users to set up a ready-to-use development environment on any OS (Windows, macOS, Linux) with a single command or guided menu.
+
+## Outline Steps
+## UI/UX Requirements
+- Each section should present a fancy, interactive CLI dashboard (using libraries like enquirer/inquirer/blessed).
+- Use toggles, checkboxes, and dynamic menus for all options (install, skip, configure, etc.).
+- Users can enable/disable any tool, package, or feature per section.
+- Dashboard should update in real time as users make selections.
+- Integrate dependencies between sections (e.g., if a theme is selected, apply it to VS Code and shell if possible).
+- Show a summary of selected actions before proceeding.
+- Allow users to go back and change selections at any step.
+
+1. **OS Detection**
+	- Detect the user's operating system.
+	- Branch logic for Windows, macOS, Linux.
+
+2. **Pre-Checks**
+	- If installed via npm, skip npm/node check.
+	- If installed via PowerShell/cmd/bash script, check for Node.js, npm/yarn/pnpm, and Git.
+	- Offer to install missing prerequisites (with user consent).
+
+3. **Package Manager Setup**
+	- For each OS, install or configure the preferred package manager (e.g., Homebrew for macOS, Chocolatey/Scoop/Winget for Windows, apt/yum/dnf/pacman for Linux).
+
+4. **Dev Tools Bundle**
+	- Bundle core dev tools as a group: VS Code, Node.js, npm, Git, Python, etc.
+	- Present as a single step with option to install all or skip.
+	- If skipped, proceed to next section.
+
+5. **Utilities & Extras**
+	- Present optional utilities (e.g., Blender, PowerToys, Windhawk, terminal enhancements).
+	- Allow user to select which utilities to install or skip.
+
+6. **Shell & Theme Setup**
+	- Offer to install and configure a shell (e.g., zsh, oh-my-zsh, PowerShell modules).
+	- Optionally apply themes, fonts, and prompt enhancements.
+
+7. **Editor Extensions**
+	- Offer to install VS Code extensions and settings.
+
+8. **Dotfiles & Configs**
+	- Optionally clone and apply user dotfiles or provide sensible defaults.
+
+9. **Finalization**
+	- Print summary of actions taken.
+	- Offer to reboot/reload shell if needed.
+	- Provide next steps or quickstart tips.
+
+## Notes
+

package/test-banner.ts

@@ -0,0 +1,38 @@
+import { getAnimationFrames } from './installers/animator.js';
+import gradient from 'gradient-string';
+
+async function test() {
+    const frames = getAnimationFrames('ASCII Animations/ring aniamtion.html');
+
+    console.clear();
+    const bannerText = [
+        "██████╗ ██╗  ██╗    ██████╗██╗     ██╗",
+        "██╔══██╗██║ ██╔╝   ██╔════╝██║     ██║",
+        "██║  ██║█████╔╝    ██║     ██║     ██║",
+        "██║  ██║██╔═██╗    ██║     ██║     ██║",
+        "██████╔╝██║  ██╗██╗╚██████╗███████╗██║",
+        "╚═════╝ ╚═╝  ╚═╝╚═╝ ╚═════╝╚══════╝╚═╝"
+    ];
+
+    if (frames.length > 0) {
+        for (let i = 0; i < 40; i++) {
+            const frameIdx = i % frames.length;
+            const Math = global.Math;
+            const frameLines = frames[frameIdx].split('\n');
+            const height = Math.max(bannerText.length, frameLines.length);
+            const combinedLines = [];
+            for (let line = 0; line < height; line++) {
+                const bLine = bannerText[line] || '';
+                const fLine = frameLines[line] || '';
+                combinedLines.push(bLine.padEnd(42, ' ') + fLine);
+            }
+            process.stdout.write('\x1b[0;0H');
+            console.log(gradient.rainbow(combinedLines.join('\n')));
+            await new Promise(r => setTimeout(r, 60));
+        }
+    } else {
+        console.log("no frames");
+    }
+}
+
+test();

package/test-ora.ts

@@ -0,0 +1,16 @@
+import ora from 'ora';
+import { getAnimationFrames } from './installers/animator.js';
+
+const frames = getAnimationFrames('ASCII Animations/ring aniamtion.html');
+
+const spinner = ora({
+    text: 'Installing...',
+    spinner: {
+        interval: 30,
+        frames: frames
+    }
+}).start();
+
+setTimeout(() => {
+    spinner.succeed('Installed!');
+}, 4000);

package/test.ts

@@ -0,0 +1,3 @@
+import { getAnimationFrames } from './installers/animator.js';
+const frames = getAnimationFrames('ASCII Animations/ring aniamtion.html');
+console.log(frames[0]);

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+    "compilerOptions": {
+        "target": "es2022",
+        "module": "NodeNext",
+        "moduleResolution": "NodeNext",
+        "esModuleInterop": true,
+        "forceConsistentCasingInFileNames": true,
+        "strict": true,
+        "skipLibCheck": true,
+        "outDir": "./dist"
+    },
+    "include": [
+        "**/*.ts"
+    ]
+}