Merge branch 'main' into main

Author: steam-bell-92

.DS_Store

@@ -0,0 +1,21 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.yml]
+indent_size = 2
+
+[*.yaml]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

.editorconfig

@@ -1,56 +1,23 @@
-name: Bug report 🐞
-description: File a bug report
-title: "🐞[Bug]: "
-labels: 'bug'
-body:
-  - type: checkboxes
-    id: existing-issue
-    attributes:
-      label: Is there an existing issue for this?
-      description: Please search to see if an issue already exists for the bug you encountered.
-      options:
-        - label: I have searched the existing issues
-          required: true
-  - type: textarea
-    id: what-happened
-    attributes:
-      label: Describe the bug
-      description: A concise description of what you are experiencing.
-      placeholder: Tell us what you see!
-    validations:
-      required: true
-  - type: textarea
-    id: expected-behaviour
-    attributes:
-      label: Expected behavior
-      description: A clear and concise description of what you expected to happen.
-    validations:
-      required: true
-  - type: textarea
-    id: screenshots
-    attributes:
-      label: Add Screenshots
-      description: Add sufficient screenshots to explain your issue.
-  - type: textarea
-    id: environment
-    attributes:
-      label: Environment
-      description: Please provide details about your environment
-      placeholder: |
-        - OS: [e.g., Windows 11, macOS 14, Ubuntu 22.04]
-        - Python Version: [e.g., 3.10.5]
-        - Project File: [e.g., Rock-Paper-Scissor.py]
-  - type: textarea
-    id: additional-context
-    attributes:
-      label: Additional Context
-      description: Add any other context about the problem here.
-  - type: checkboxes
-    id: contribution-record
-    attributes:
-      label: Before you submit
-      options:
-        - label: "I have read the Contributing Guidelines"
-          required: true
-        - label: "I want to work on this issue"
-          required: false
+---
+name: 🐛 Bug Report
+about: Report a bug or unexpected behavior in a mini-project
+title: '🐛 [Bug]: '
+labels: ['type:bug']
+---
+
+### 📝 Description
+### 🔄 Steps to Reproduce
+1. Go to '...'
+2. Run script '...'
+3. See error
+
+### 🎯 Expected Behavior
+### ❌ Actual Behavior / Error Logs
+### 💻 Environment
+- **OS:** [e.g. Windows 11, macOS, Ubuntu]
+- **Python Version:** [e.g. 3.10.x]
+- **File Name:** [e.g. rock_paper_scissors.py]
+
+---
+- [ ] I am a registered **GSSoC 2026** contributor.
+- [ ] I want to be assigned to fix this issue.

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,76 +1,13 @@
-name: Feature request ✨
-description: Suggest an idea for this project
-title: "✨[Feature]: "
-labels: 'enhancement'
-body:
-  - type: checkboxes
-    id: existing-issue
-    attributes:
-      label: Is there an existing issue for this?
-      description: Please search to see if a similar feature request already exists.
-      options:
-        - label: I have searched the existing issues
-          required: true
-  - type: textarea
-    id: feature-description
-    attributes:
-      label: Feature Description
-      description: A clear and concise description of the feature you'd like to see.
-      placeholder: Tell us about your feature idea!
-    validations:
-      required: true
-  - type: textarea
-    id: problem-statement
-    attributes:
-      label: Problem Statement
-      description: Is this feature request related to a problem? Please describe.
-      placeholder: "Example: I'm always frustrated when..."
-    validations:
-      required: true
-  - type: textarea
-    id: proposed-solution
-    attributes:
-      label: Proposed Solution
-      description: Describe the solution you'd like to see implemented.
-    validations:
-      required: true
-  - type: textarea
-    id: alternatives
-    attributes:
-      label: Alternatives Considered
-      description: Describe any alternative solutions or features you've considered.
-  - type: textarea
-    id: benefits
-    attributes:
-      label: Benefits
-      description: How would this feature benefit users or learners?
-  - type: dropdown
-    id: project-type
-    attributes:
-      label: If suggesting a new mini-project, which category does it fit?
-      options:
-        - Select an option
-        - Game
-        - Mathematical Tool
-        - Utility
-        - Crypto/Text Tool
-        - Other (please specify)
-  - type: checkboxes
-    id: implementation
-    attributes:
-      label: Implementation
-      description: Would you be willing to work on this?
-      options:
-        - label: "Yes, I can work on this"
-        - label: "No, but I can help test"
-        - label: "Just suggesting the idea"
-  - type: checkboxes
-    id: contribution-record
-    attributes:
-      label: Before you submit
-      options:
-        - label: "I have read the Contributing Guidelines"
-          required: true
-        - label: "I want to work on this issue"
-          required: false
+---
+name: 💡 Feature Request
+about: Propose a new feature or enhancement for an existing script
+title: '💡 [Feature]: '
+labels: ['type:feature']
+---
 
+### ❓ Problem Statement
+### 🚀 Proposed Enhancement
+### 🛠️ Suggested Implementation
+---
+- [ ] I am a registered **GSSoC 2026** contributor.
+- [ ] I would like to implement this feature myself.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,106 +1,17 @@
-name: New Project Proposal 🎮
-description: Propose a new mini-project to add to the collection
-title: "🎮[Project]: "
-labels: 'new-project'
-body:
-  - type: checkboxes
-    id: existing-issue
-    attributes:
-      label: Is there an existing issue for this?
-      description: Please search to see if a similar project proposal already exists.
-      options:
-        - label: I have searched the existing issues
-          required: true
-  - type: textarea
-    id: project-name
-    attributes:
-      label: Project Name
-      description: Enter the name of your proposed project.
-      placeholder: "e.g., Number Guessing Game"
-    validations:
-      required: true
-  - type: textarea
-    id: description
-    attributes:
-      label: Description
-      description: A clear and concise description of what this project does.
-      placeholder: "Tell us what this project is about!"
-    validations:
-      required: true
-  - type: dropdown
-    id: category
-    attributes:
-      label: Category
-      description: Which category does this project fit into?
-      options:
-        - Select an option
-        - Game
-        - Mathematical Tool
-        - Utility/Calculator
-        - Crypto/Text Tool
-        - Pattern/Art Generator
-        - Other
-      multiple: false
-    validations:
-      required: true
-  - type: textarea
-    id: learning-objectives
-    attributes:
-      label: Learning Objectives
-      description: What Python concepts will users learn from this project?
-      placeholder: |
-        - Loops
-        - Conditionals
-        - Data Structures
-        - [Add more...]
-  - type: textarea
-    id: key-features
-    attributes:
-      label: Key Features
-      description: List the main features of this project.
-      placeholder: |
-        - Feature 1
-        - Feature 2
-        - Feature 3
-    validations:
-      required: true
-  - type: textarea
-    id: ui-ux
-    attributes:
-      label: UI/UX
-      description: Describe the user interface (emojis, menu structure, etc.)
-  - type: textarea
-    id: example-output
-    attributes:
-      label: Example Output
-      description: Show an example of what the project output would look like.
-      placeholder: |
-        ```
-        Example output here
-        ```
-  - type: dropdown
-    id: implementation-status
-    attributes:
-      label: Implementation Status
-      options:
-        - Select an option
-        - Just an idea
-        - Already coded and ready
-        - Need help implementing
-      multiple: false
-    validations:
-      required: true
-  - type: textarea
-    id: additional-info
-    attributes:
-      label: Additional Information
-      description: Any other details, mockups, or references?
-  - type: checkboxes
-    id: contribution-record
-    attributes:
-      label: Before you submit
-      options:
-        - label: "I have read the Contributing Guidelines"
-          required: true
-        - label: "I want to work on this issue"
-          required: false
+---
+name: 🎮 New Mini-Project Proposal
+about: Propose a completely new Python mini-project script
+title: '🎮 [Proposal]: '
+labels: ['type:feature', 'enhancement']
+---
+
+### 📛 Project Name
+### 📊 Category
+### 📝 Project Overview
+### ✅ Code Compliance Checklist
+- [ ] This project will use **ONLY** Python's Standard Library (No `pip install`).
+- [ ] The codebase will use **procedural logic** (No unnecessary classes/functions unless creating a GUI/Web App).
+- [ ] The terminal interface will include interactive **emojis**.
+
+---
+- [ ] I am a registered **GSSoC 2026** contributor and want this assigned to me.

.github/ISSUE_TEMPLATE/project_proposal.md

@@ -0,0 +1,50 @@
+documentation:
+  - '**/*.md'
+  - 'docs/**'
+
+python:
+  - '**/*.py'
+
+github-actions:
+  - '.github/**'
+
+enhancement:
+  - 'src/**'
+  - '*/**.py'
+
+beginner:
+  - '**/*.md'
+
+intermediate:
+  - '**/*.py'
+
+advanced:
+  - '.github/**'
+  - 'tests/**'
+
+"type:design":
+  - 'web-app/**'
+  - 'web-app/*.html'
+  - 'web-app/js/**'
+  - 'web-app/css/**'
+
+"type:feature":
+  - '**/*.py'
+
+"type:docs":
+  - '**/*.md'
+  - 'README.html'
+  - 'docs/**'
+
+"type:devops":
+  - '.github/**'
+  - '.github/workflows/**'
+
+"type:refactor":
+  - '**/*.py'
+  - 'web-app/**'
+
+"type:bug":
+  - '**/*.py'
+  - 'tests/**'
+