init

Author: ProgrammerHasan

README.md

@@ -0,0 +1,32 @@
+# Qwik Utilities
+
+This package provides utility functions for Qwik framework, including CSV export, date formatting, JSON helpers, and more.
+
+## Installation
+
+```bash
+npm install qwik-utilities
+```
+
+### Usage
+
+CSV Export
+```
+import { downloadCSV } from 'qwik-utilities';
+const data = [{ name: 'Alice', age: 25 }, { name: 'Bob', age: 30 }];
+downloadCSV(data);
+```
+
+Date Formatting
+```
+import { formatDate, formatDateToMonthShort } from 'qwik-utilities';
+formatDate('2025-08-14');
+formatDateToMonthShort('2025-08-14');
+```
+JSON and Object Helpers
+```
+import { removeFalsy, duplicateObj, doesObjsMatch } from 'qwik-utilities';
+removeFalsy({ a: '', b: 0, c: null });
+duplicateObj({ a: 1 });
+doesObjsMatch({ a: 1 }, { a: 1 });
+```

package.json

@@ -0,0 +1,20 @@
+{
+  "name": "qwik-utilities",
+  "version": "1.0.0",
+  "description": "A collection of utility functions and hooks for Qwik framework.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "echo No tests specified && exit 0"
+  },
+  "keywords": ["qwik", "utilities", "hooks", "debounce", "csv", "date", "helpers"],
+  "author": "Your Name",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.1.6"
+  },
+  "dependencies": {
+    "@builder.io/qwik": "^0.23.0"
+  }
+}

src/components/DarkModeSwitch.tsx

@@ -0,0 +1 @@
+// DarkModeSwitch component here

src/components/ToastNotification.tsx

@@ -0,0 +1 @@
+// ToastNotification component here

src/hooks/useDebounce.ts

@@ -0,0 +1,30 @@
+// src/hooks/useDebounce.ts
+import { useSignal, useTask$ } from '@builder.io/qwik';
+
+/**
+
+ Custom Qwik hook to debounce a value.
+
+ @param value The value to debounce
+
+ @param delay Delay in milliseconds
+ */
+export function useDebounce(value: any, delay: number) {
+    const debouncedValue = useSignal(value);
+
+    useTask$((options: { track: (fn: () => any) => void; cleanup: (fn: () => void) => void }) => {
+        const { track, cleanup } = options;
+
+        track(() => value);
+
+        const timeout = setTimeout(() => {
+            debouncedValue.value = value;
+        }, delay);
+
+        cleanup(() => clearTimeout(timeout));
+
+    });
+
+    return debouncedValue;
+}
+

src/hooks/useLocalStorage.ts

@@ -0,0 +1,17 @@
+import { useStore } from "@builder.io/qwik";
+
+export function useLocalStorage<T>(key: string, initialValue: T) {
+    const state = useStore({ value: initialValue });
+
+    const saved = localStorage.getItem(key);
+    if (saved !== null) {
+        state.value = JSON.parse(saved);
+    }
+
+    const setValue = (val: T) => {
+        state.value = val;
+        localStorage.setItem(key, JSON.stringify(val));
+    };
+
+    return [state, setValue] as const;
+}

src/index.ts

@@ -0,0 +1,3 @@
+export * from './utils/csvExporter';
+export * from './utils/generalUtils';
+export * from "./hooks/useLocalStorage";

src/utils/csvExporter.ts

@@ -0,0 +1,38 @@
+export function convertArrayOfObjectsToCSV(array: any[]) {
+    let result: string;
+    const columnDelimiter = ',';
+    const lineDelimiter = '\n';
+    const keys = Object.keys(array[0]);
+
+    result = '';
+    result += keys.join(columnDelimiter);
+    result += lineDelimiter;
+
+    array.forEach(item => {
+        let ctr = 0;
+        keys.forEach(key => {
+            if (ctr > 0) result += columnDelimiter;
+            result += item[key];
+            ctr++;
+        });
+        result += lineDelimiter;
+    });
+
+    return result;
+}
+
+export function downloadCSV(array: any[]) {
+    const link = document.createElement('a');
+    let csv = convertArrayOfObjectsToCSV(array);
+    if (csv === null) return;
+
+    const filename = 'export.csv';
+
+    if (!csv.match(/^data:text\/csv/i)) {
+        csv = `data:text/csv;charset=utf-8,${csv}`;
+    }
+
+    link.setAttribute('href', encodeURI(csv));
+    link.setAttribute('download', filename);
+    link.click();
+}

src/utils/generalUtils.ts

@@ -0,0 +1,81 @@
+export const formatDate = (
+    value: string | Date,
+    formatting: Intl.DateTimeFormatOptions = { month: "short", day: "numeric", year: "numeric" }
+) => {
+    if (!value) return value;
+    return new Intl.DateTimeFormat("en-US", formatting).format(new Date(value));
+};
+
+export const formatDateToMonthShort = (value: string | Date, toTimeForCurrentDay = true) => {
+    const date = new Date(value);
+    let formatting: Intl.DateTimeFormatOptions = { month: "short", day: "numeric" };
+    if (toTimeForCurrentDay && date.toDateString() === new Date().toDateString()) {
+        formatting = { hour: "numeric", minute: "numeric" };
+    }
+    return new Intl.DateTimeFormat("en-US", formatting).format(new Date(value));
+};
+
+export const getFileExt = (uri: string) => uri.includes('.') ? uri.split('.').pop() : '';
+
+export const getYearOptions = (from = 1950, to = new Date().getFullYear()) => {
+    let result = [];
+    for (let i = to; i >= from; i--) {
+        result.push({ label: i, value: i });
+    }
+    return result;
+};
+
+export const removeFalsy = (obj: any) => {
+    let newObj: any = {};
+    Object.keys(obj).forEach(props => {
+        if (obj[props] || obj[props] === '0' || obj[props] === 0 || obj[props] !== '') {
+            newObj[props] = obj[props];
+        }
+    });
+    return newObj;
+};
+
+export const getNumberWithOrdinal = (n: number) => {
+    const s = ["th", "st", "nd", "rd"], v = n % 100;
+    return n + (s[(v - 20) % 10] || s[v] || s[0]);
+};
+
+export const handleGetDirection = (lat = '', lng = '') => {
+    window.open(`https://www.google.com/maps/search/?api=1&query=${lat},${lng}`, '_blank');
+};
+
+export const convertTimeFormat = (time = '') => {
+    if (!time) return '';
+    let [hr, min] = time.split(':');
+    let hour = parseInt(hr);
+    if (hour < 12) return `${hour}:${min} AM`;
+    return `${hour - 12 < 10 ? `0${hour-12}` : hour-12}:${min} PM`;
+};
+
+export const isJsonParsable = (str: string) => {
+    try { JSON.parse(str); } catch { return false; }
+    return true;
+};
+
+export const duplicateObj = (obj: any) => JSON.parse(JSON.stringify(obj));
+
+export const makeTwoDigit = (num: number) => num < 10 ? `0${num}` : num.toString();
+
+export const doesObjsMatch = (obj1: any, obj2: any) => JSON.stringify(obj1) === JSON.stringify(obj2);
+
+export const onlyAllowNumber = (evt: KeyboardEvent) => {
+    const charCode = evt.which ? evt.which : evt.keyCode;
+    if (charCode > 31 && (charCode < 48 || charCode > 57) && charCode !== 46) evt.preventDefault();
+};
+
+export const createDateObj = (date: string, time: string) => {
+    try {
+        const [y, m, d] = date.split('-');
+        const [hr, min] = time.split(':');
+        return new Date(parseInt(y), parseInt(m)-1, parseInt(d), parseInt(hr), parseInt(min));
+    } catch (e) { console.log('Error createDateObj', e); return null; }
+};
+
+export const getYoutubeVideoId = (link: string) => {
+    try { let url = new URL(link); return url.searchParams.get('v') || ''; } catch { return ''; }
+};

tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "target": "ES6",
+    "module": "ESNext",
+    "jsx": "react-jsx",
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "strict": true
+  },
+  "include": ["src"]
+}