Merge pull request #51 from BUMETCS673/annotationsByJames

Adding annotations to my files

Author: prlara23Pro

code/frontend/src/components/asideAndToggler/Aside.tsx

@@ -3,11 +3,14 @@ import Location from './Location';
 import Type from './Type';
 import ThemeToggler from './themeToggler';
 
-/**
- * Aside container for filters + theme toggle.
- * Styling (border, bg, spacing) is applied by the Layout wrapper,
- * so this component just provides clean structure for filters and theme toggle.
- */
+/*
+ AI-generated code: 80% (tool: ChatGPT, modified and adapted,
+   functions: Aside,
+   classes: none,
+   AI chat links: https://chatgpt.com/share/68cdcba0-1218-8006-87a6-66d632a41ec8 )
+ Human code: 15% (functions: small structural edits, comments, import/casing fixes; classes: none)
+ Framework-generated code: 5% (tool: Vite/React app template)
+*/
 export default function Aside() {
   return (
     <div className="d-flex flex-column gap-3" aria-label="Filters and theme">

code/frontend/src/components/asideAndToggler/Field.tsx

@@ -1,11 +1,14 @@
 import { useState, useRef, useEffect } from 'react';
 import { createPortal } from 'react-dom';
 
-/**
- * Field filter component used in the Aside panel.
- * Provides a dropdown for selecting job fields.
- */
-
+/*
+ AI-generated code: 85% (tool: ChatGPT, modified and adapted,
+   functions: Field (dropdown/popup, click-outside, portal/positioning),
+   classes: none,
+   AI chat links: https://chatgpt.com/share/68cdcba0-1218-8006-87a6-66d632a41ec8 )
+ Human code: 10% (functions: minor tweaks, comments, import moves; classes: none)
+ Framework-generated code: 5% (tool: Vite/React)
+*/
 const FIELDS = ['Engineering', 'Product', 'Design', 'Data', 'Operations'];
 
 interface FieldProps {

code/frontend/src/components/asideAndToggler/Location.tsx

@@ -1,10 +1,15 @@
 import { useEffect, useRef, useState } from 'react';
 import { createPortal } from 'react-dom';
 
-/**
- * Location filter component used in the Aside panel.
- * Clicking the button opens an inline input prompt.
- */
+/*
+ AI-generated code: 85% (tool: ChatGPT, modified and adapted,
+   functions: Location (inline panel, later portal version, centering, close button, keyboard handling),
+   classes: none,
+   AI chat links: https://chatgpt.com/share/68cdcba0-1218-8006-87a6-66d632a41ec8 )
+ Human code: 10% (functions: copy/fit tweaks, comments; classes: none)
+ Framework-generated code: 5% (tool: Vite/React)
+*/
+
 interface LocationProps {
   onChange?: (value: string | null) => void;
 }

code/frontend/src/components/asideAndToggler/Type.tsx

@@ -1,10 +1,14 @@
 import { useEffect, useRef, useState } from 'react';
 import { createPortal } from 'react-dom';
 
-/**
- * Type filter component used in the Aside panel.
- * Provides a dropdown for selecting job types (e.g., full-time, part-time).
- */
+/*
+ AI-generated code: 80% (tool: ChatGPT, modified and adapted,
+   functions: Type (dropdown/popup variants, shorter fitted panel),
+   classes: none,
+   AI chat links: https://chatgpt.com/share/68cdcba0-1218-8006-87a6-66d632a41ec8 )
+ Human code: 15% (functions: constraints, removing search, comments; classes: none)
+ Framework-generated code: 5% (tool: Vite/React)
+*/
 
 const TYPES = ['Full-time', 'Part-time', 'Contract', 'Internship'];
 

code/frontend/src/components/asideAndToggler/themeToggler.tsx

@@ -2,10 +2,16 @@ import { useTheme } from '../../theme/ThemeContext';
 import sunImage from '../../assets/sun.png';
 import moonImage from '../../assets/moon.jpg';
 
-/**
- * Theme toggle button for switching between light and dark mode.
- * Updates global font/background colors and persists preference.
- */
+/*
+ AI-generated code: 80% (tool: ChatGPT, modified and adapted,
+   functions: ThemeToggler,
+   classes: none,
+   AI chat links: https://chatgpt.com/share/68cdcba0-1218-8006-87a6-66d632a41ec8 )
+ Human code: 15% (functions: casing/paths, comments; classes: none)
+ Framework-generated code: 5% (tool: Vite/React)
+*/
+
+// Theme toggle button component
 export default function ThemeToggler() {
   const { theme, toggle } = useTheme();
 

code/frontend/src/components/loginAndRegistration/LoginForm.tsx

@@ -2,6 +2,19 @@ import React, { useState } from "react";
 import { Link } from "react-router-dom"; // Link to navigate to Register page
 import { isRequired, isEmail } from "./validation"; // keep path simple (no .ts extension)
 
+/*
+ AI-generated code: ~70% 
+   - Tool: ChatGPT (link: https://chatgpt.com/share/68d43c9d-4d60-8006-a1a7-14ae49475a5a)
+   - Modified and adapted by human
+   - Functions/classes: LoginForm component structure, validation logic integration, JSX layout
+ Human code: ~30% 
+   - Adjustments: added centering fixes, styled footer text, ensured responsive Bootstrap card
+   - Functions/classes: final layout tweaks, style adjustments, props handling refinements
+ Framework-generated code: 0%
+   - (React/Bootstrap boilerplate is used but not auto-generated)
+*/
+
+
 /**
  * @typedef {Object} LoginValues
  * @property {string} email

code/frontend/src/components/loginAndRegistration/RegisterForm.tsx

@@ -2,6 +2,18 @@ import React, { useState } from "react";
 import { Link } from "react-router-dom"; // Link to navigate to Login page
 import { isRequired, isEmail } from "./validation"; // keep path simple (no .ts extension)
 
+/*
+ AI-generated code: ~65% 
+   - Tool: ChatGPT (link: https://chatgpt.com/share/68d43c9d-4d60-8006-a1a7-14ae49475a5a)
+   - Modified and adapted by human
+   - Functions/classes: RegisterForm component structure, validation integration, JSX layout
+ Human code: ~35% 
+   - Adjustments: footer text "Already have an account?", fixed link targets, applied centering card layout
+   - Functions/classes: human refinements for props, consistent styling with LoginForm
+ Framework-generated code: 0%
+   - (React/Bootstrap boilerplate is used but not auto-generated)
+*/
+
 type RegisterValues = { name: string; email: string; password: string };
 type Props = {
   onSubmit?: (values: RegisterValues) => void;

code/frontend/src/components/loginAndRegistration/validation.ts

@@ -1,5 +1,14 @@
-// Basic validation helpers shared by Login and Register forms
+/*
+ AI-generated code: ~50% 
+   - Tool: ChatGPT (link: https://chatgpt.com/share/68d43c9d-4d60-8006-a1a7-14ae49475a5a)
+   - Functions/classes: isRequired, isEmail utility functions suggested by AI
+ Human code: ~50% 
+   - Adjustments: simplified regex validation, added doc comments, integration testing with forms
+ Framework-generated code: 0%
+   - (Plain TypeScript helpers, no framework generation)
+*/
 
+// Basic validation helpers shared by Login and Register forms
 // Check that a value is not empty/whitespace
 export const isRequired = (v: string) => v.trim().length > 0;
 

code/frontend/src/types/images.d.ts

@@ -0,0 +1,35 @@
+// Module declarations for importing image assets in TypeScript/TSX files.
+// Without these, TypeScript may report errors like "Cannot find module '*.png'".
+
+declare module '*.avif' {
+  const src: string;
+  export default src;
+}
+declare module '*.bmp' {
+  const src: string;
+  export default src;
+}
+declare module '*.gif' {
+  const src: string;
+  export default src;
+}
+declare module '*.jpg' {
+  const src: string;
+  export default src;
+}
+declare module '*.jpeg' {
+  const src: string;
+  export default src;
+}
+declare module '*.png' {
+  const src: string;
+  export default src;
+}
+declare module '*.webp' {
+  const src: string;
+  export default src;
+}
+declare module '*.svg' {
+  const src: string;
+  export default src;
+}