@staff0rd/assist 0.301.0 → 0.302.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@staff0rd/assist",
-	"version": "0.301.0",
+	"version": "0.302.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {

package/dist/commands/lint/biome.linter.json

@@ -1,66 +0,0 @@
-{
-	"overrides": [
-		{
-			"includes": [
-				"**/index.ts",
-				"**/shared.ts",
-				"**/types.ts",
-				"**/constants.ts",
-				"tsup.config.ts"
-			],
-			"linter": {
-				"rules": {
-					"style": {
-						"useFilenamingConvention": {
-							"level": "error",
-							"options": {
-								"filenameCases": ["kebab-case"],
-								"requireAscii": true
-							}
-						}
-					}
-				}
-			}
-		},
-		{
-			"includes": ["**/*.test.ts"],
-			"linter": {
-				"rules": {
-					"style": {
-						"useFilenamingConvention": "off"
-					}
-				}
-			}
-		}
-	],
-	"linter": {
-		"enabled": true,
-		"rules": {
-			"recommended": true,
-			"style": {
-				"useTemplate": {
-					"level": "error"
-				},
-				"useFilenamingConvention": {
-					"level": "error",
-					"options": {
-						"filenameCases": ["export"],
-						"requireAscii": true
-					}
-				},
-				"useConsistentTypeDefinitions": {
-					"level": "error",
-					"options": {
-						"style": "type"
-					}
-				},
-				"useConsistentMemberAccessibility": {
-					"level": "error",
-					"options": {
-						"accessibility": "noPublic"
-					}
-				}
-			}
-		}
-	}
-}

package/dist/commands/lint/init.ts

@@ -1,56 +0,0 @@
-import { execSync } from "node:child_process";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import chalk from "chalk";
-import { promptConfirm } from "../../shared/promptConfirm";
-import { removeEslint } from "../../shared/removeEslint";
-import { printDiff } from "../../utils/printDiff";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-export async function init(): Promise<void> {
-	removeEslint();
-
-	const biomeConfigPath = "biome.json";
-
-	if (!existsSync(biomeConfigPath)) {
-		console.log("Initializing Biome...");
-		execSync("npx @biomejs/biome init", { stdio: "inherit" });
-	}
-
-	if (!existsSync(biomeConfigPath)) {
-		console.log("No biome.json found, skipping linter config");
-		return;
-	}
-
-	const linterConfigPath = join(__dirname, "commands/lint/biome.linter.json");
-	const linterConfig = JSON.parse(readFileSync(linterConfigPath, "utf8"));
-	const biomeConfig = JSON.parse(readFileSync(biomeConfigPath, "utf8"));
-
-	const oldContent = `${JSON.stringify(biomeConfig, null, 2)}\n`;
-	biomeConfig.linter = linterConfig.linter;
-	if (linterConfig.overrides) {
-		biomeConfig.overrides = linterConfig.overrides;
-	}
-	const newContent = `${JSON.stringify(biomeConfig, null, 2)}\n`;
-
-	if (oldContent === newContent) {
-		console.log("biome.json already has the correct linter config");
-		return;
-	}
-
-	console.log(chalk.yellow("\n⚠️  biome.json will be updated:"));
-	console.log();
-	printDiff(oldContent, newContent);
-
-	const confirm = await promptConfirm(chalk.red("Update biome.json?"));
-
-	if (!confirm) {
-		console.log("Skipped biome.json update");
-		return;
-	}
-
-	writeFileSync(biomeConfigPath, newContent);
-	console.log("Updated biome.json with linter config");
-}

package/dist/commands/lint/lint/applyMoves.ts

@@ -1,50 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import type { Project } from "ts-morph";
-import { renameExports } from "./renameExports";
-
-type Move = { sourcePath: string; destPath: string };
-
-function isCaseOnly(a: string, b: string): boolean {
-	return a.toLowerCase() === b.toLowerCase();
-}
-
-function moveCaseInsensitive(absSource: string, absDest: string): void {
-	const tmp = `${absSource}.tmp`;
-	fs.renameSync(absSource, tmp);
-	fs.renameSync(tmp, absDest);
-}
-
-export function applyMoves(
-	project: Project,
-	moves: Move[],
-	cwd: string,
-	emit: (line: string) => void,
-): void {
-	for (const { sourcePath, destPath } of moves) {
-		const start = performance.now();
-		const absSource = path.resolve(sourcePath);
-		const absDest = path.resolve(destPath);
-
-		for (const r of renameExports(project, absSource, absDest)) {
-			emit(`  Renamed export ${r} in ${sourcePath}`);
-		}
-
-		const sourceFile = project.getSourceFile(absSource);
-		if (sourceFile) sourceFile.move(absDest);
-
-		const ms = (performance.now() - start).toFixed(0);
-		const rel = `${path.relative(cwd, absSource)} → ${path.relative(cwd, absDest)}`;
-		emit(`  Renamed ${rel} (${ms}ms)`);
-	}
-
-	project.saveSync();
-
-	for (const { sourcePath, destPath } of moves) {
-		const absSource = path.resolve(sourcePath);
-		const absDest = path.resolve(destPath);
-		if (isCaseOnly(absSource, absDest) && fs.existsSync(absSource)) {
-			moveCaseInsensitive(absSource, absDest);
-		}
-	}
-}

package/dist/commands/lint/lint/checkFileNames.ts

@@ -1,81 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { findSourceFiles } from "../../../shared/findSourceFiles";
-
-export type FileNameViolation = {
-	filePath: string;
-	fileName: string;
-	suggestedName: string;
-};
-
-function hasClassOrComponent(content: string): boolean {
-	const classPattern = /^(export\s+)?(abstract\s+)?class\s+\w+/m;
-	const functionComponentPattern =
-		/^(export\s+)?(default\s+)?function\s+[A-Z]\w*\s*\(/m;
-	const arrowComponentPattern = /^(export\s+)?(const|let)\s+[A-Z]\w*\s*=.*=>/m;
-
-	return (
-		classPattern.test(content) ||
-		functionComponentPattern.test(content) ||
-		arrowComponentPattern.test(content)
-	);
-}
-
-function hasMatchingTypeExport(
-	content: string,
-	nameWithoutExt: string,
-): boolean {
-	const typePattern = new RegExp(
-		`^export\\s+type\\s+${nameWithoutExt}\\b`,
-		"m",
-	);
-	const interfacePattern = new RegExp(
-		`^export\\s+interface\\s+${nameWithoutExt}\\b`,
-		"m",
-	);
-	return typePattern.test(content) || interfacePattern.test(content);
-}
-
-function suggestName(fileName: string): string {
-	const nameWithoutExt = fileName.replace(/\.(ts|tsx)$/, "");
-	const ext = fileName.slice(nameWithoutExt.length);
-
-	// SCREAMING_SNAKE_CASE → camelCase (e.g. OC_COLORS → ocColors)
-	if (/^[A-Z][A-Z0-9]*(_[A-Z0-9]+)+$/.test(nameWithoutExt)) {
-		const camel = nameWithoutExt
-			.toLowerCase()
-			.replace(/_([a-z0-9])/g, (_, c: string) => c.toUpperCase());
-		return `${camel}${ext}`;
-	}
-
-	return `${nameWithoutExt.charAt(0).toLowerCase()}${nameWithoutExt.slice(1)}${ext}`;
-}
-
-export function checkFileNames(): FileNameViolation[] {
-	const sourceFiles = findSourceFiles("src");
-	const violations: FileNameViolation[] = [];
-
-	for (const filePath of sourceFiles) {
-		const fileName = path.basename(filePath);
-		const nameWithoutExt = fileName.replace(/\.(ts|tsx)$/, "");
-
-		// Skip .stories and .test files — they mirror the component/module name
-		if (/\.(stories|test)\.(ts|tsx)$/.test(fileName)) continue;
-
-		if (/^[A-Z]/.test(nameWithoutExt)) {
-			const content = fs.readFileSync(filePath, "utf8");
-			if (
-				!hasClassOrComponent(content) &&
-				!hasMatchingTypeExport(content, nameWithoutExt)
-			) {
-				violations.push({
-					filePath,
-					fileName,
-					suggestedName: suggestName(fileName),
-				});
-			}
-		}
-	}
-
-	return violations;
-}

package/dist/commands/lint/lint/createLintProject.ts

@@ -1,16 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { Project } from "ts-morph";
-
-export function createLintProject(): Project {
-	const tsConfigPath = path.resolve("tsconfig.json");
-	const project = fs.existsSync(tsConfigPath)
-		? new Project({
-				tsConfigFilePath: tsConfigPath,
-				skipAddingFilesFromTsConfig: true,
-			})
-		: new Project();
-
-	project.addSourceFilesAtPaths("src/**/*.{ts,tsx}");
-	return project;
-}

package/dist/commands/lint/lint/fixFileNameViolations.ts

@@ -1,16 +0,0 @@
-import chalk from "chalk";
-import { applyMoves } from "./applyMoves";
-import { createLintProject } from "./createLintProject";
-
-type Move = { sourcePath: string; destPath: string };
-
-export function fixFileNameViolations(moves: Move[]): void {
-	const start = performance.now();
-	const project = createLintProject();
-	const cwd = process.cwd();
-
-	applyMoves(project, moves, cwd, (line) => console.log(chalk.green(line)));
-
-	const ms = (performance.now() - start).toFixed(0);
-	console.log(chalk.dim(`  Done in ${ms}ms`));
-}

package/dist/commands/lint/lint/index.ts

@@ -1,17 +0,0 @@
-import { runFileNameCheck } from "./runFileNameCheck";
-import { runImportExtensionCheck } from "./runImportExtensionCheck";
-import { runStaticImportCheck } from "./runStaticImportCheck";
-
-type LintOptions = {
-	fix?: boolean;
-};
-
-export function lint(options: LintOptions = {}): void {
-	const fileNamePassed = runFileNameCheck(options.fix);
-	const staticImportPassed = runStaticImportCheck();
-	const importExtensionPassed = runImportExtensionCheck();
-
-	if (!fileNamePassed || !staticImportPassed || !importExtensionPassed) {
-		process.exit(1);
-	}
-}

package/dist/commands/lint/lint/renameExports.ts

@@ -1,37 +0,0 @@
-import path from "node:path";
-import type { Project } from "ts-morph";
-import { SyntaxKind } from "ts-morph";
-
-function nameWithoutExtension(filePath: string): string {
-	return path.basename(filePath).replace(/\.(ts|tsx)$/, "");
-}
-
-export function renameExports(
-	project: Project,
-	absSource: string,
-	absDest: string,
-): string[] {
-	const oldName = nameWithoutExtension(absSource);
-	const newName = nameWithoutExtension(absDest);
-	const sourceFile = project.getSourceFile(absSource);
-	if (!sourceFile) return [];
-
-	const renamed: string[] = [];
-	for (const [, declarations] of sourceFile.getExportedDeclarations()) {
-		for (const decl of declarations) {
-			// Skip type aliases and interfaces — they should stay PascalCase
-			const kind = decl.getKind();
-			if (
-				kind === SyntaxKind.TypeAliasDeclaration ||
-				kind === SyntaxKind.InterfaceDeclaration
-			) {
-				continue;
-			}
-			const nameNode = decl.getFirstChildByKind(SyntaxKind.Identifier);
-			if (!nameNode || nameNode.getText() !== oldName) continue;
-			nameNode.rename(newName);
-			renamed.push(`${oldName} → ${newName}`);
-		}
-	}
-	return renamed;
-}

package/dist/commands/lint/lint/runFileNameCheck.ts

@@ -1,45 +0,0 @@
-import path from "node:path";
-import chalk from "chalk";
-import { checkFileNames, type FileNameViolation } from "./checkFileNames";
-import { fixFileNameViolations } from "./fixFileNameViolations";
-
-function reportViolations(violations: FileNameViolation[]): void {
-	console.error(chalk.red("\nFile name check failed:\n"));
-	console.error(
-		chalk.red(
-			"  Files without classes or React components should not start with a capital letter.\n",
-		),
-	);
-	for (const violation of violations) {
-		console.error(chalk.red(`  ${violation.filePath}`));
-		console.error(chalk.gray(`    Rename to: ${violation.suggestedName}\n`));
-	}
-	console.error(chalk.dim("  Run with -f to auto-fix.\n"));
-}
-
-export function runFileNameCheck(fix = false): boolean {
-	const violations = checkFileNames();
-
-	if (violations.length === 0) {
-		if (!process.env.CLAUDECODE) {
-			console.log(
-				"File name check passed. All PascalCase files contain classes or components.",
-			);
-		}
-		return true;
-	}
-
-	if (!fix) {
-		reportViolations(violations);
-		return false;
-	}
-
-	fixFileNameViolations(
-		violations.map((v) => ({
-			sourcePath: v.filePath,
-			destPath: path.join(path.dirname(v.filePath), v.suggestedName),
-		})),
-	);
-
-	return true;
-}

package/dist/commands/lint/lint/runImportExtensionCheck.ts

@@ -1,45 +0,0 @@
-import fs from "node:fs";
-import { findSourceFiles } from "../../../shared/findSourceFiles";
-import { type LintViolation, reportViolations } from "../shared";
-
-function checkForImportExtensions(filePath: string): LintViolation[] {
-	const content = fs.readFileSync(filePath, "utf8");
-	const lines = content.split("\n");
-	const violations: LintViolation[] = [];
-
-	// Matches relative imports with .js or .ts extensions
-	const importExtensionPattern = /from\s+["']\..*\.(js|ts)["']/;
-
-	for (let i = 0; i < lines.length; i++) {
-		const line = lines[i];
-		if (importExtensionPattern.test(line)) {
-			violations.push({
-				filePath,
-				line: i + 1,
-				content: line.trim(),
-			});
-		}
-	}
-
-	return violations;
-}
-
-function checkImportExtensions(): LintViolation[] {
-	const sourceFiles = findSourceFiles("src");
-	const violations: LintViolation[] = [];
-
-	for (const filePath of sourceFiles) {
-		violations.push(...checkForImportExtensions(filePath));
-	}
-
-	return violations;
-}
-
-export function runImportExtensionCheck(): boolean {
-	return reportViolations(
-		checkImportExtensions(),
-		"Import extension check",
-		"File extensions in imports are not allowed. Use extensionless imports instead.",
-		"Import extension check passed. No file extensions in imports found.",
-	);
-}

package/dist/commands/lint/lint/runStaticImportCheck.ts

@@ -1,45 +0,0 @@
-import fs from "node:fs";
-import { findSourceFiles } from "../../../shared/findSourceFiles";
-import { type LintViolation, reportViolations } from "../shared";
-
-function checkForDynamicImports(filePath: string): LintViolation[] {
-	const content = fs.readFileSync(filePath, "utf8");
-	const lines = content.split("\n");
-	const violations: LintViolation[] = [];
-
-	const requirePattern = /\brequire\s*\(/;
-	const dynamicImportPattern = /\bimport\s*\(/;
-
-	for (let i = 0; i < lines.length; i++) {
-		const line = lines[i];
-		if (requirePattern.test(line) || dynamicImportPattern.test(line)) {
-			violations.push({
-				filePath,
-				line: i + 1,
-				content: line.trim(),
-			});
-		}
-	}
-
-	return violations;
-}
-
-function checkStaticImports(): LintViolation[] {
-	const sourceFiles = findSourceFiles("src");
-	const violations: LintViolation[] = [];
-
-	for (const filePath of sourceFiles) {
-		violations.push(...checkForDynamicImports(filePath));
-	}
-
-	return violations;
-}
-
-export function runStaticImportCheck(): boolean {
-	return reportViolations(
-		checkStaticImports(),
-		"Static import check",
-		"Dynamic imports are not allowed. Use static imports instead.",
-		"Static import check passed. No dynamic imports found.",
-	);
-}

package/dist/commands/lint/shared.ts

@@ -1,29 +0,0 @@
-import chalk from "chalk";
-
-export type LintViolation = {
-	filePath: string;
-	line: number;
-	content: string;
-};
-
-export function reportViolations(
-	violations: LintViolation[],
-	checkName: string,
-	errorMessage: string,
-	successMessage: string,
-): boolean {
-	if (violations.length > 0) {
-		console.error(chalk.red(`\n${checkName} failed:\n`));
-		console.error(chalk.red(`  ${errorMessage}\n`));
-		for (const violation of violations) {
-			console.error(chalk.red(`  ${violation.filePath}:${violation.line}`));
-			console.error(chalk.gray(`    ${violation.content}\n`));
-		}
-		return false;
-	}
-
-	if (!process.env.CLAUDECODE) {
-		console.log(successMessage);
-	}
-	return true;
-}