First commit 🚀

Author: tuhinpal

.gitignore

@@ -0,0 +1,101 @@
+# Dependencies
+node_modules/
+
+# Build outputs
+dist/
+
+# Test coverage
+coverage/
+
+# TypeScript
+*.tsbuildinfo
+
+# Environment
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+public
+
+# Storybook build outputs
+.out
+.storybook-out
+
+# Temporary folders
+tmp/
+temp/
+
+# Editor directories and files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db 

.npmignore

@@ -0,0 +1,87 @@
+# Source files (only dist/ should be published)
+src/
+tsconfig.json
+tsup.config.ts
+
+# Tests and coverage
+__tests__/
+*.test.ts
+*.test.js
+*.spec.ts
+*.spec.js
+coverage/
+jest.config.js
+
+# Examples and documentation
+examples/
+PUBLISH.md
+
+# Development dependencies and configuration
+node_modules/
+.git/
+.gitignore
+
+# IDE and editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Environment files
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Cache directories
+.npm
+.eslintcache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Build artifacts (keep only dist/)
+build/
+lib/
+out/
+
+# Temporary folders
+tmp/
+temp/
+
+# Package files
+*.tgz
+
+# Yarn
+.yarn-integrity
+yarn.lock
+
+# Optional npm cache directory
+.npm
+
+# TypeScript cache
+*.tsbuildinfo 

PUBLISH.md

@@ -0,0 +1,49 @@
+# Publishing Guide
+
+### Step 1: Version the Package
+
+```bash
+# For patch releases (bug fixes)
+npm version patch
+
+# For minor releases (new features)
+npm version minor
+
+# For major releases (breaking changes)
+npm version major
+
+# Or set version manually
+npm version 1.0.0
+```
+
+### Step 2: Review Package Contents
+
+```bash
+# See what files will be published
+npm pack --dry-run
+
+# Create a test package (optional)
+npm pack
+```
+
+The package should include:
+
+- ✅ `dist/` directory with built files
+- ✅ `package.json`
+- ✅ `README.md`
+- ❌ `src/` directory (excluded)
+- ❌ `examples/` directory (excluded)
+- ❌ Test files (excluded)
+
+### Step 3: Publish to npm
+
+```bash
+# Login to npm (if not already logged in)
+npm login
+
+# Publish the package
+npm publish
+
+# For scoped packages or first-time publishing
+npm publish --access public
+```