Merge branch 'main' into feature/search

Author: barrymun

.github/CODEOWNERS

@@ -4,10 +4,13 @@
 * @Mathys-Gasnier
 
 # Code maintainers
-/src/ @psychlone77 @saminjay
+/src/ @psychlone77 @saminjay @Mathys-Gasnier
 
 # Snippets maintainers
-/snippets @Mathys-Gasnier
+/snippets @majvax @Mathys-Gasnier
+/snippets/javascript @psychlone77 @saminjay
+/snippets/python @psychlone77 @saminjay
+/snippets/cpp @saminjay
 
 
 # ---------- What is a maintainer ----------

VISION.md

@@ -1,3 +1,55 @@
 # Vision for QuickSnip
 
-Will be updating soon...
+## What is QuickSnip?
+
+QuickSnip is an open-source tool designed for developers who want to organize, search, and share code snippets. It aims to streamline the coding process by providing a centralized platform for snippet management.
+
+## Core Principles
+
+- **Developer Focused**: Focus on features that truly improve developer productivity.
+
+- **Open and Extensible**: Encourage community contributions and integrations.
+
+- **Lightweight and Fast**: Keep performance high and avoid unnecessary complexity.
+
+## Our Goals
+
+- Seamless snippet management without turning into an overly complex tool
+
+- Enable collaboration and sharing while respecting user privacy and customization needs.
+
+We do **NOT** aim to be:
+
+- a component library
+- a documentation 
+
+## QuickSnip Roadmap
+
+### v1.0 (Launching Soon)
+
+- [x] A new snippets storage system for better maintainability and scalability
+- [ ] Search functionality
+- [ ] A support for frameworks and libraries
+- [ ] An ability to share snippets with others
+- [ ] A basic SEO (Search Engine Optimization)
+
+### v2.0 (Planned Vision)
+
+- [ ] An ability to have private snippets with personal account
+- [ ] Improved search functionality with filters
+- [ ] An improved SEO (Search Engine Optimization)
+
+### Potential Future Ideas
+
+- [ ] Plugins for IDEs like VS Code and JetBrains
+- [ ] Enterprise-grade support for larger organizations
+
+## Disclaimer on Future Plans
+
+This roadmap outlines our current vision for QuickSnip and may evolve based on user feedback, community contributions, and shifting priorities. We welcome your input and encourage you to help shape QuickSnip’s future.
+
+## Future Vision
+
+QuickSnip aims to become the preferred platform for developers to store, retrieve, and collaborate on code snippets.
+
+Explore our [GitHub Releases](https://github.com/dostonnabotov/quicksnip/releases) for updates and join us on this journey.

public/consolidated/cpp.json

@@ -32,6 +32,23 @@
             }
         ]
     },
+    {
+        "categoryName": "Debuging",
+        "snippets": [
+            {
+                "title": "Vector Print",
+                "description": "Overloads the << operator to print the contents of a vector just like in python.",
+                "author": "Mohamed-faaris",
+                "tags": [
+                    "printing",
+                    "debuging",
+                    "vector"
+                ],
+                "contributors": [],
+                "code": "#include <iostream> \n#include <vector>   \n\ntemplate <typename T>\nstd::ostream& operator<<(std::ostream& os, const std::vector<T>& vec) {\n    os << \"[\"; \n    for (size_t i = 0; i < vec.size(); ++i) {\n        os << vec[i]; // Print each vector element\n        if (i != vec.size() - 1) {\n            os << \", \"; // Add separator\n        }\n    }\n    os << \"]\"; \n    return os; // Return the stream\n}\n\n// Usage:\nstd::vector<int> numbers = {1, 2, 3, 4, 5};\nstd::cout << numbers << std::endl; // Outputs: [1, 2, 3, 4, 5]\n\n"
+            }
+        ]
+    },
     {
         "categoryName": "Math And Numbers",
         "snippets": [

public/consolidated/javascript.json

@@ -77,6 +77,22 @@
             }
         ]
     },
+    {
+        "categoryName": "Color Manipulation",
+        "snippets": [
+            {
+                "title": "RGB to Hex Color",
+                "description": "Converts RGB color values to hexadecimal color code.",
+                "author": "jjcantu",
+                "tags": [
+                    "color",
+                    "conversion"
+                ],
+                "contributors": [],
+                "code": "function rgbToHex(r, g, b) {\n  const toHex = (n) => {\n    const hex = n.toString(16);\n    return hex.length === 1 ? '0' + hex : hex;\n  };\n  \n  return '#' + toHex(r) + toHex(g) + toHex(b);\n}\n\n// Usage:\nconsole.log(rgbToHex(255, 128, 0)); // Output: \"#ff8000\"\nconsole.log(rgbToHex(0, 255, 0)); // Output: \"#00ff00\"\n"
+            }
+        ]
+    },
     {
         "categoryName": "Date And Time",
         "snippets": [
@@ -384,6 +400,17 @@
                 "contributors": [],
                 "code": "const toScientificNotation = (num) => {\n  if (isNaN(num)) {\n    throw new Error('Input must be a number');\n  }\n  if (num === 0) {\n    return '0e+0';\n  }\n  const exponent = Math.floor(Math.log10(Math.abs(num)));\n  const mantissa = num / Math.pow(10, exponent);\n  return `${mantissa.toFixed(2)}e${exponent >= 0 ? '+' : ''}${exponent}`;\n};\n\n// Usage:\ntoScientificNotation(12345); // Returns: '1.23e+4'\ntoScientificNotation(0.0005678); // Returns: '5.68e-4'\ntoScientificNotation(1000); // Returns: '1.00e+3'\ntoScientificNotation(0); // Returns: '0e+0'\ntoScientificNotation(-54321); // Returns: '-5.43e+4'\n"
             },
+            {
+                "title": "Format File Size",
+                "description": "Converts bytes into human-readable file size format.",
+                "author": "jjcantu",
+                "tags": [
+                    "format",
+                    "size"
+                ],
+                "contributors": [],
+                "code": "function formatFileSize(bytes) {\n  if (bytes === 0) return '0 Bytes';\n  \n  const k = 1024;\n  const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];\n  const i = Math.floor(Math.log(bytes) / Math.log(k));\n  \n  return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];\n}\n\n// Usage:\nconsole.log(formatFileSize(1234)); // Output: \"1.21 KB\"\nconsole.log(formatFileSize(1234567)); // Output: \"1.18 MB\"\n"
+            },
             {
                 "title": "Format Number with Commas",
                 "description": "Formats a number with commas for better readability (e.g., 1000 -> 1,000).",
@@ -470,6 +497,17 @@
                 "contributors": [],
                 "code": "function countProperties(obj) {\n  return Object.keys(obj).length;\n}\n\n// Usage:\nconst obj = { a: 1, b: 2, c: 3 };\ncountProperties(obj); // Returns: 3\n"
             },
+            {
+                "title": "Deep Clone Object",
+                "description": "Creates a deep copy of an object or array without reference.",
+                "author": "jjcantu",
+                "tags": [
+                    "object",
+                    "clone"
+                ],
+                "contributors": [],
+                "code": "function deepClone(obj) {\n  if (obj === null || typeof obj !== 'object') return obj;\n  \n  const clone = Array.isArray(obj) ? [] : {};\n  \n  for (let key in obj) {\n    if (Object.prototype.hasOwnProperty.call(obj, key)) {\n      clone[key] = deepClone(obj[key]);\n    }\n  }\n  \n  return clone;\n}\n\n// Usage:\nconst original = { a: 1, b: { c: 2 }, d: [1, 2, 3] };\nconst cloned = deepClone(original);\nconsole.log(cloned); // Output: 'original' but cloned\n"
+            },
             {
                 "title": "Filter Object",
                 "description": "Filter out entries in an object where the value is falsy, including empty strings, empty objects, null, and undefined.",
@@ -709,6 +747,18 @@
                 "contributors": [],
                 "code": "function getInitials(name) {\n  return name.split(' ').map(part => part.charAt(0).toUpperCase()).join('');\n}\n\n// Usage:\ngetInitials('John Doe'); // Returns: 'JD'\n"
             },
+            {
+                "title": "Generate UUID",
+                "description": "Generates a UUID (v4) string.",
+                "author": "jjcantu",
+                "tags": [
+                    "uuid",
+                    "generate",
+                    "string"
+                ],
+                "contributors": [],
+                "code": "function generateUUID() {\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {\n    const r = Math.random() * 16 | 0;\n    const v = c === 'x' ? r : (r & 0x3 | 0x8);\n    return v.toString(16);\n  });\n}\n\n// Usage:\nconsole.log(generateUUID()); // Output: \"a1b2c3d4-e5f6-4g7h-8i9j-k0l1m2n3o4p5\"\n"
+            },
             {
                 "title": "Mask Sensitive Information",
                 "description": "Masks parts of a sensitive string, like a credit card or email address.",

snippets/cpp/debuging/vector-print.md

@@ -0,0 +1,29 @@
+---
+title: Vector Print
+description: Overloads the << operator to print the contents of a vector just like in python.
+author: Mohamed-faaris
+tags: printing,debuging,vector
+---
+
+```cpp
+#include <iostream> 
+#include <vector>   
+
+template <typename T>
+std::ostream& operator<<(std::ostream& os, const std::vector<T>& vec) {
+    os << "["; 
+    for (size_t i = 0; i < vec.size(); ++i) {
+        os << vec[i]; // Print each vector element
+        if (i != vec.size() - 1) {
+            os << ", "; // Add separator
+        }
+    }
+    os << "]"; 
+    return os; // Return the stream
+}
+
+// Usage:
+std::vector<int> numbers = {1, 2, 3, 4, 5};
+std::cout << numbers << std::endl; // Outputs: [1, 2, 3, 4, 5]
+
+```

snippets/javascript/color-manipulation/rgb-to-hex-color.md

@@ -0,0 +1,21 @@
+---
+title: RGB to Hex Color
+description: Converts RGB color values to hexadecimal color code.
+author: jjcantu
+tags: color,conversion
+---
+
+```js
+function rgbToHex(r, g, b) {
+  const toHex = (n) => {
+    const hex = n.toString(16);
+    return hex.length === 1 ? '0' + hex : hex;
+  };
+  
+  return '#' + toHex(r) + toHex(g) + toHex(b);
+}
+
+// Usage:
+console.log(rgbToHex(255, 128, 0)); // Output: "#ff8000"
+console.log(rgbToHex(0, 255, 0)); // Output: "#00ff00"
+``` 

snippets/javascript/number-formatting/format-file-size.md

@@ -0,0 +1,22 @@
+---
+title: Format File Size
+description: Converts bytes into human-readable file size format.
+author: jjcantu
+tags: format,size
+---
+
+```js
+function formatFileSize(bytes) {
+  if (bytes === 0) return '0 Bytes';
+  
+  const k = 1024;
+  const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  
+  return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+}
+
+// Usage:
+console.log(formatFileSize(1234)); // Output: "1.21 KB"
+console.log(formatFileSize(1234567)); // Output: "1.18 MB"
+``` 

snippets/javascript/object-manipulation/deep-clone-object.md

@@ -0,0 +1,27 @@
+---
+title: Deep Clone Object
+description: Creates a deep copy of an object or array without reference.
+author: jjcantu
+tags: object,clone
+---
+
+```js
+function deepClone(obj) {
+  if (obj === null || typeof obj !== 'object') return obj;
+  
+  const clone = Array.isArray(obj) ? [] : {};
+  
+  for (let key in obj) {
+    if (Object.prototype.hasOwnProperty.call(obj, key)) {
+      clone[key] = deepClone(obj[key]);
+    }
+  }
+  
+  return clone;
+}
+
+// Usage:
+const original = { a: 1, b: { c: 2 }, d: [1, 2, 3] };
+const cloned = deepClone(original);
+console.log(cloned); // Output: 'original' but cloned
+``` 

snippets/javascript/string-manipulation/generate-uuid.md

@@ -0,0 +1,19 @@
+---
+title: Generate UUID
+description: Generates a UUID (v4) string.
+author: jjcantu
+tags: uuid, generate, string
+---
+
+```js
+function generateUUID() {
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
+    const r = Math.random() * 16 | 0;
+    const v = c === 'x' ? r : (r & 0x3 | 0x8);
+    return v.toString(16);
+  });
+}
+
+// Usage:
+console.log(generateUUID()); // Output: "a1b2c3d4-e5f6-4g7h-8i9j-k0l1m2n3o4p5"
+```