@pistachiojs/react 0.1.0-dev.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Pistachio
+
+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,73 @@
+# @pistachiojs/react
+
+A collection React hooks library for reactive programming tasks. Built on top of @pistachiojs/core packages.
+
+[![npm version](https://img.shields.io/npm/v/@pistachiojs/react)](https://www.npmjs.com/package/@pistachiojs/react)
+[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen)](../../coverage)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Key features
+
+- **Full type safety** - TypeScript-first with complete inference
+- **React optimized** - Built specifically for React 17+
+- **Tree shakeable** - Modular imports for minimal bundle size
+- **Well tested** - Comprehensive test coverage
+
+## Installation
+
+```bash
+# npm
+npm install @pistachiojs/core @pistachiojs/react
+
+# pnpm
+pnpm add @pistachiojs/core @pistachiojs/react
+
+# yarn
+yarn add @pistachiojs/core @pistachiojs/react
+```
+
+## Usage
+
+```jsx
+import { useCounter } from '@pistachiojs/react'
+
+function Counter() {
+  const [count, handlers] = useCounter(0, {
+    min: 0,
+    max: 10,
+  })
+
+  return (
+    <div>
+      <p>Count: {count}</p>
+      <button onClick={handlers.increment}>+</button>
+      <button onClick={handlers.decrement}>-</button>
+      <button onClick={() => handlers.set(5)}>Set to 5</button>
+      <button onClick={handlers.reset}>Reset</button>
+    </div>
+  )
+}
+```
+
+## Type safety
+
+This package is written in TypeScript and includes type definitions out of the box.
+
+```typescript
+import { useCounter } from '@pistachiojs/react'
+
+function TypeSafeCounter() {
+  // Full type inference
+  const [count, handlers] = useCounter(0, { min: 0, max: 100 })
+  // count: number
+  // handlers: UseCounterHandler
+
+  // All handlers are fully typed
+  handlers.increment() // () => void
+  handlers.set(50) // (value: number) => void
+}
+```
+
+## License
+
+MIT © [Dirga Prakesha](https://github.com/dirgaprksha)

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+type UseCounterOptions = {
+    min?: number;
+    max?: number;
+};
+type UseCounterHandler = {
+    increment: () => void;
+    decrement: () => void;
+    set: (value: number) => void;
+    reset: () => void;
+};
+type UseCounterReturn = [number, UseCounterHandler];
+/**
+ * React hook to manage counter state with optional min and max bounds.
+ * @param initialValue - Number value for initial.
+ * @param options - Configuration object.
+ * @returns Tuple containing current count and handler object.
+ */
+declare function useCounter(initialValue?: number, options?: UseCounterOptions): UseCounterReturn;
+
+export { useCounter };
+export type { UseCounterHandler, UseCounterOptions, UseCounterReturn };

package/dist/index.esm.js

@@ -0,0 +1 @@
+import{useState as x,useCallback as a}from"react";function m(n,c,e){return Math.min(Math.max(n,c),e)}function C(n=0,c={}){const{min:e=-1/0,max:t=1/0}=c,[i,o]=x(m(n,e,t)),s=a(()=>{o(r=>m(r+1,e,t))},[e,t]),u=a(()=>{o(r=>m(r-1,e,t))},[e,t]),f=a(r=>{o(m(r,e,t))},[e,t]),p=a(()=>{o(m(n,e,t))},[n,e,t]);return[i,{increment:s,decrement:u,set:f,reset:p}]}export{C as useCounter};

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var r=require("react");function u(a,s,e){return Math.min(Math.max(a,s),e)}function b(a=0,s={}){const{min:e=-1/0,max:t=1/0}=s,[i,c]=r.useState(u(a,e,t)),l=r.useCallback(()=>{c(n=>u(n+1,e,t))},[e,t]),C=r.useCallback(()=>{c(n=>u(n-1,e,t))},[e,t]),m=r.useCallback(n=>{c(u(n,e,t))},[e,t]),o=r.useCallback(()=>{c(u(a,e,t))},[a,e,t]);return[i,{increment:l,decrement:C,set:m,reset:o}]}exports.useCounter=b;

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@pistachiojs/react",
+  "description": "A React hooks library for reactive programming tasks",
+  "version": "0.1.0-dev.0",
+  "author": "Dirga Prakesha <dirga.prakesha@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dirgaprksha/pistachio.git",
+    "directory": "packages/react"
+  },
+  "keywords": [
+    "utility",
+    "typescript",
+    "javascript",
+    "helpers",
+    "functional",
+    "react",
+    "type-safe",
+    "tree-shakeable"
+  ],
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/index.js",
+    "dist/index.esm.js",
+    "dist/index.d.ts"
+  ],
+  "peerDependencies": {
+    "react": ">=17"
+  },
+  "dependencies": {
+    "@types/react": "^17.0.0",
+    "@pistachiojs/core": "0.3.0-dev.0"
+  },
+  "scripts": {
+    "build": "rollup -c ../../rollup.config.mjs --environment TARGET:react",
+    "build:types": "tsc --emitDeclarationOnly --declaration --declarationDir dist/types",
+    "clean": "rimraf node_modules dist"
+  }
+}