lite-math 1.0.0

package/.eslintrc.json

@@ -0,0 +1,19 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
+  "plugins": ["@typescript-eslint"],
+  "env": {
+    "node": true,
+    "es2020": true
+  },
+  "parserOptions": {
+    "ecmaVersion": 2020,
+    "sourceType": "module"
+  },
+  "rules": {
+    "@typescript-eslint/explicit-function-return-types": "warn",
+    "@typescript-eslint/no-explicit-any": "error",
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "no-console": ["warn", { "allow": ["warn", "error"] }]
+  }
+}

package/.prettierrc

@@ -0,0 +1,10 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "bracketSpacing": true,
+  "arrowParens": "always"
+}

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-12-07
+
+### Added
+- Initial release with 40+ math utility functions
+- Arithmetic operations: add, subtract, multiply, divide, modulo, percentage, clamp, round, ceil, floor, abs, sign, power, sqrt
+- Advanced math: factorial, fibonacci, gcd, lcm, isPrime, randomInt, randomFloat, sum, product, average, median, mode, variance, stdDev
+- Statistics: mean, median, mode, range, variance, standardDeviation, quartiles, percentile, skewness, kurtosis
+- Random: randomInt, randomFloat, randomBoolean, randomChoice, shuffle, randomPermutation, randomSample
+- Algebra: solveLinear, solveQuadratic, evaluatePolynomial, matrixMultiply
+- Conversion: degreesToRadians, radiansToDegrees, celsiusToFahrenheit, fahrenheitToCelsius, kmToMiles, milesToKm, kgToLbs, lbsToKg
+- Comprehensive CLI tool with 40+ commands
+- Full TypeScript support with type definitions
+- JSDoc documentation for all functions
+- Extensive examples for each category
+- Jest test suite with coverage reporting

package/CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# Contributing to math-operations
+
+Thank you for considering contributing to math-operations! We appreciate your effort to improve this project.
+
+## Getting Started
+
+1. Fork the repository
+2. Clone your fork: `git clone https://github.com/yourusername/math-operations.git`
+3. Install dependencies: `npm install`
+4. Create a feature branch: `git checkout -b feature/your-feature-name`
+
+## Development
+
+- `npm run build` - Compile TypeScript to JavaScript
+- `npm run watch` - Watch mode for development
+- `npm test` - Run tests
+- `npm run test:coverage` - Run tests with coverage report
+- `npm run lint` - Run ESLint
+- `npm run format` - Format code with Prettier
+
+## Making Changes
+
+1. Write your code following the existing style
+2. Add tests for new functionality
+3. Ensure all tests pass: `npm test`
+4. Run linter: `npm run lint`
+5. Format code: `npm run format`
+
+## Submitting Changes
+
+1. Push to your fork
+2. Create a Pull Request with a clear title and description
+3. Reference any related issues
+4. Ensure CI passes
+
+## Code Style
+
+- Use TypeScript for all code
+- Follow the existing code style
+- Add JSDoc comments for all functions
+- Keep functions small and focused
+- Write tests for all new features
+
+## Reporting Issues
+
+- Check existing issues first
+- Provide clear description of the problem
+- Include code examples when possible
+- Specify your Node.js and npm versions
+
+Thank you for contributing!

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kanti Lal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,213 @@
+# math-operations
+
+A comprehensive, production-ready TypeScript NPM package providing 40+ mathematical utility functions with full CLI support. Built with strict TypeScript, ESM/CJS support, and ready for immediate publication.
+
+## Features
+
+- **40+ Math Functions** organized in 6 categories
+- **Full TypeScript Support** with strict type checking and JSDoc comments
+- **Dual Module Output** (ESM & CommonJS)
+- **CLI Tool** (`math-ops`) with 40+ commands
+- **Zero Dependencies** - Pure JavaScript/TypeScript implementation
+- **Production Ready** - Fully tested and documented
+
+## Installation
+
+\`\`\`bash
+npm install math-operations
+\`\`\`
+
+## Usage
+
+### ES Module
+
+\`\`\`typescript
+import { add, subtract, factorial, primeCheck } from 'math-operations'
+
+console.log(add(10, 20))              // 30
+console.log(factorial(5))              // 120
+console.log(primeCheck(17))            // true
+\`\`\`
+
+### CommonJS
+
+\`\`\`javascript
+const math = require('math-operations')
+
+console.log(math.add(10, 20))         // 30
+console.log(math.factorial(5))        // 120
+console.log(math.primeCheck(17))      // true
+\`\`\`
+
+## CLI Usage
+
+Install globally to use the CLI:
+
+\`\`\`bash
+npm install -g math-operations
+\`\`\`
+
+Then use the `math-ops` command:
+
+\`\`\`bash
+math-ops add 10 20                    # 30
+math-ops factorial 5                  # 120
+math-ops primeCheck 17                # true
+math-ops solveQuadratic 1 -3 2        # [2, 1]
+math-ops mean 10 20 30 40 50          # 30
+math-ops randomInt 1 100              # Random number between 1 and 100
+\`\`\`
+
+## Function Reference
+
+### Arithmetic Operations
+
+| Function | Parameters | Returns | Example |
+|----------|-----------|---------|---------|
+| `add` | `(a: number, b: number)` | `number` | `add(5, 3)` → `8` |
+| `subtract` | `(a: number, b: number)` | `number` | `subtract(10, 3)` → `7` |
+| `multiply` | `(a: number, b: number)` | `number` | `multiply(4, 5)` → `20` |
+| `divide` | `(a: number, b: number)` | `number` | `divide(20, 4)` → `5` |
+| `modulo` | `(a: number, b: number)` | `number` | `modulo(10, 3)` → `1` |
+| `percentage` | `(value: number, percent: number)` | `number` | `percentage(100, 25)` → `25` |
+| `clamp` | `(value, min, max)` | `number` | `clamp(15, 0, 10)` → `10` |
+| `round` | `(value: number, decimals?: number)` | `number` | `round(3.14159, 2)` → `3.14` |
+| `ceil` | `(value: number)` | `number` | `ceil(3.14)` → `4` |
+| `floor` | `(value: number)` | `number` | `floor(3.99)` → `3` |
+
+### Advanced Mathematics
+
+| Function | Parameters | Returns | Example |
+|----------|-----------|---------|---------|
+| `factorial` | `(n: number)` | `number` | `factorial(5)` → `120` |
+| `fibonacci` | `(n: number)` | `number` | `fibonacci(10)` → `55` |
+| `gcd` | `(a: number, b: number)` | `number` | `gcd(48, 18)` → `6` |
+| `lcm` | `(a: number, b: number)` | `number` | `lcm(12, 18)` → `36` |
+| `primeCheck` | `(n: number)` | `boolean` | `primeCheck(17)` → `true` |
+| `primeList` | `(n: number)` | `number[]` | `primeList(20)` → `[2, 3, 5, 7, 11, 13, 17, 19]` |
+| `power` | `(base: number, exponent: number)` | `number` | `power(2, 8)` → `256` |
+| `sqrt` | `(n: number)` | `number` | `sqrt(16)` → `4` |
+| `cubeRoot` | `(n: number)` | `number` | `cubeRoot(27)` → `3` |
+
+### Statistics
+
+| Function | Parameters | Returns | Example |
+|----------|-----------|---------|---------|
+| `mean` | `(numbers: number[])` | `number` | `mean([1, 2, 3, 4, 5])` → `3` |
+| `median` | `(numbers: number[])` | `number` | `median([1, 2, 3, 4, 5])` → `3` |
+| `mode` | `(numbers: number[])` | `number[]` | `mode([1, 1, 2, 3, 3, 3])` → `[3]` |
+| `variance` | `(numbers: number[])` | `number` | `variance([1, 2, 3, 4, 5])` → `2` |
+| `stdDev` | `(numbers: number[])` | `number` | `stdDev([1, 2, 3, 4, 5])` → `1.414...` |
+| `range` | `(numbers: number[])` | `number` | `range([1, 5, 3])` → `4` |
+| `sumArray` | `(numbers: number[])` | `number` | `sumArray([1, 2, 3])` → `6` |
+| `productArray` | `(numbers: number[])` | `number` | `productArray([1, 2, 3])` → `6` |
+
+### Random Number Generation
+
+| Function | Parameters | Returns | Example |
+|----------|-----------|---------|---------|
+| `randomInt` | `(min: number, max: number)` | `number` | `randomInt(1, 100)` → `42` |
+| `randomFloat` | `(min: number, max: number)` | `number` | `randomFloat(0, 1)` → `0.735...` |
+| `randomFromArray` | `(array: T[])` | `T` | `randomFromArray([1, 2, 3])` → `2` |
+| `randomArray` | `(length, min, max)` | `number[]` | `randomArray(5, 1, 10)` → `[3, 7, 2, 9, 4]` |
+
+### Algebra
+
+| Function | Parameters | Returns | Example |
+|----------|-----------|---------|---------|
+| `solveLinear` | `(a: number, b: number)` | `number` | `solveLinear(2, -4)` → `2` |
+| `solveQuadratic` | `(a, b, c)` | `number[]` | `solveQuadratic(1, -3, 2)` → `[2, 1]` |
+| `distance` | `(x1, y1, x2, y2)` | `number` | `distance(0, 0, 3, 4)` → `5` |
+| `slope` | `(x1, y1, x2, y2)` | `number` | `slope(0, 0, 2, 4)` → `2` |
+| `midpoint` | `(x1, y1, x2, y2)` | `[number, number]` | `midpoint(0, 0, 4, 4)` → `[2, 2]` |
+| `triangleArea` | `(a, b, c)` | `number` | `triangleArea(3, 4, 5)` → `6` |
+| `circleArea` | `(radius: number)` | `number` | `circleArea(5)` → `78.54...` |
+
+### Unit Conversion
+
+| Function | Parameters | Returns | Example |
+|----------|-----------|---------|---------|
+| `degToRad` | `(degrees: number)` | `number` | `degToRad(180)` → `3.14159...` |
+| `radToDeg` | `(radians: number)` | `number` | `radToDeg(3.14159)` → `180` |
+| `kmToMiles` | `(km: number)` | `number` | `kmToMiles(1)` → `0.621...` |
+| `milesToKm` | `(miles: number)` | `number` | `milesToKm(1)` → `1.609...` |
+| `cToF` | `(celsius: number)` | `number` | `cToF(0)` → `32` |
+| `fToC` | `(fahrenheit: number)` | `number` | `fToC(32)` → `0` |
+
+## Build & Publish
+
+### Build the package
+
+\`\`\`bash
+npm run build
+\`\`\`
+
+This creates:
+- `dist/index.esm.js` - ES Module version
+- `dist/index.cjs.js` - CommonJS version
+- `dist/index.d.ts` - TypeScript definitions
+- `dist/cli.cjs.js` - CLI executable
+
+### Publish to NPM
+
+\`\`\`bash
+npm publish --access public
+\`\`\`
+
+## Development
+
+\`\`\`bash
+# Install dependencies
+npm install
+
+# Build the package
+npm run build
+
+# Run tests
+npm test
+
+# Build CLI
+npm run build:cli
+
+# Type checking
+npm run type-check
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+.
+├── src/
+│   ├── arithmetic/          # Basic arithmetic operations
+│   ├── advanced/            # Advanced math functions
+│   ├── statistics/          # Statistical functions
+│   ├── random/              # Random number generation
+│   ├── algebra/             # Algebraic operations
+│   ├── convert/             # Unit conversions
+│   ├── index.ts             # Main export file
+│   └── cli.ts               # CLI interface
+├── dist/                    # Compiled output
+├── examples/                # Usage examples
+├── package.json
+├── tsconfig.json
+├── tsup.config.ts
+├── .gitignore
+└── README.md
+\`\`\`
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Author
+
+**Kanti Lal**
+- GitHub: https://github.com/kanti-lal
+
+---
+
+Built with ❤️ using TypeScript

package/app/globals.css

@@ -0,0 +1,125 @@
+@import 'tailwindcss';
+@import 'tw-animate-css';
+
+@custom-variant dark (&:is(.dark *));
+
+:root {
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --destructive-foreground: oklch(0.577 0.245 27.325);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+  --chart-1: oklch(0.646 0.222 41.116);
+  --chart-2: oklch(0.6 0.118 184.704);
+  --chart-3: oklch(0.398 0.07 227.392);
+  --chart-4: oklch(0.828 0.189 84.429);
+  --chart-5: oklch(0.769 0.188 70.08);
+  --radius: 0.625rem;
+  --sidebar: oklch(0.985 0 0);
+  --sidebar-foreground: oklch(0.145 0 0);
+  --sidebar-primary: oklch(0.205 0 0);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.97 0 0);
+  --sidebar-accent-foreground: oklch(0.205 0 0);
+  --sidebar-border: oklch(0.922 0 0);
+  --sidebar-ring: oklch(0.708 0 0);
+}
+
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.145 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.145 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.985 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.396 0.141 25.723);
+  --destructive-foreground: oklch(0.637 0.237 25.331);
+  --border: oklch(0.269 0 0);
+  --input: oklch(0.269 0 0);
+  --ring: oklch(0.439 0 0);
+  --chart-1: oklch(0.488 0.243 264.376);
+  --chart-2: oklch(0.696 0.17 162.48);
+  --chart-3: oklch(0.769 0.188 70.08);
+  --chart-4: oklch(0.627 0.265 303.9);
+  --chart-5: oklch(0.645 0.246 16.439);
+  --sidebar: oklch(0.205 0 0);
+  --sidebar-foreground: oklch(0.985 0 0);
+  --sidebar-primary: oklch(0.488 0.243 264.376);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.269 0 0);
+  --sidebar-accent-foreground: oklch(0.985 0 0);
+  --sidebar-border: oklch(0.269 0 0);
+  --sidebar-ring: oklch(0.439 0 0);
+}
+
+@theme inline {
+  --font-sans: 'Geist', 'Geist Fallback';
+  --font-mono: 'Geist Mono', 'Geist Mono Fallback';
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --color-chart-1: var(--chart-1);
+  --color-chart-2: var(--chart-2);
+  --color-chart-3: var(--chart-3);
+  --color-chart-4: var(--chart-4);
+  --color-chart-5: var(--chart-5);
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
+}
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}

package/app/layout.tsx

@@ -0,0 +1,27 @@
+import type { Metadata } from 'next'
+import { Geist, Geist_Mono } from 'next/font/google'
+import { Analytics } from '@vercel/analytics/next'
+import './globals.css'
+
+const _geist = Geist({ subsets: ["latin"] });
+const _geistMono = Geist_Mono({ subsets: ["latin"] });
+
+export const metadata: Metadata = {
+  title: 'math-operations',
+  description: 'Created by kanti-lal',
+}
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode
+}>) {
+  return (
+    <html lang="en">
+      <body className={`font-sans antialiased`}>
+        {children}
+        <Analytics />
+      </body>
+    </html>
+  )
+}

package/app/page.tsx

@@ -0,0 +1,7 @@
+"use client"
+
+import  from "../examples/conversion-examples"
+
+export default function SyntheticPageForDeployment() {
+  return < />
+}

package/components/theme-provider.tsx

@@ -0,0 +1,11 @@
+'use client'
+
+import * as React from 'react'
+import {
+  ThemeProvider as NextThemesProvider,
+  type ThemeProviderProps,
+} from 'next-themes'
+
+export function ThemeProvider({ children, ...props }: ThemeProviderProps) {
+  return <NextThemesProvider {...props}>{children}</NextThemesProvider>
+}

package/components/ui/accordion.tsx

@@ -0,0 +1,66 @@
+'use client'
+
+import * as React from 'react'
+import * as AccordionPrimitive from '@radix-ui/react-accordion'
+import { ChevronDownIcon } from 'lucide-react'
+
+import { cn } from '@/lib/utils'
+
+function Accordion({
+  ...props
+}: React.ComponentProps<typeof AccordionPrimitive.Root>) {
+  return <AccordionPrimitive.Root data-slot="accordion" {...props} />
+}
+
+function AccordionItem({
+  className,
+  ...props
+}: React.ComponentProps<typeof AccordionPrimitive.Item>) {
+  return (
+    <AccordionPrimitive.Item
+      data-slot="accordion-item"
+      className={cn('border-b last:border-b-0', className)}
+      {...props}
+    />
+  )
+}
+
+function AccordionTrigger({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof AccordionPrimitive.Trigger>) {
+  return (
+    <AccordionPrimitive.Header className="flex">
+      <AccordionPrimitive.Trigger
+        data-slot="accordion-trigger"
+        className={cn(
+          'focus-visible:border-ring focus-visible:ring-ring/50 flex flex-1 items-start justify-between gap-4 rounded-md py-4 text-left text-sm font-medium transition-all outline-none hover:underline focus-visible:ring-[3px] disabled:pointer-events-none disabled:opacity-50 [&[data-state=open]>svg]:rotate-180',
+          className,
+        )}
+        {...props}
+      >
+        {children}
+        <ChevronDownIcon className="text-muted-foreground pointer-events-none size-4 shrink-0 translate-y-0.5 transition-transform duration-200" />
+      </AccordionPrimitive.Trigger>
+    </AccordionPrimitive.Header>
+  )
+}
+
+function AccordionContent({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof AccordionPrimitive.Content>) {
+  return (
+    <AccordionPrimitive.Content
+      data-slot="accordion-content"
+      className="data-[state=closed]:animate-accordion-up data-[state=open]:animate-accordion-down overflow-hidden text-sm"
+      {...props}
+    >
+      <div className={cn('pt-0 pb-4', className)}>{children}</div>
+    </AccordionPrimitive.Content>
+  )
+}
+
+export { Accordion, AccordionItem, AccordionTrigger, AccordionContent }