refineable 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# refineable
+
+A tiny TypeScript utility for chaining transformations over a value in a readable, functional style.
+
+## Install
+
+```bash
+npm install refineable
+```
+
+## Usage
+
+Wrap any value with `r()`, then chain `.refine()` calls to transform it step by step. Unwrap the final result with `.value`.
+
+```typescript
+import { r } from 'refineable';
+
+const result = r(42)
+  .refine(n => n * 2)       // 84
+  .refine(n => `${n}!`)     // "84!"
+  .refine(s => s.length)    // 3
+  .value;
+
+console.log(result); // 3
+```
+
+TypeScript infers the type at every step — no annotations needed.
+
+## Async
+
+Use `.refineAsync()` when your transformation returns a Promise. It resolves the value and keeps the chain going.
+
+```typescript
+const result = await r("hello")
+  .refineAsync(async s => s.toUpperCase())  // "HELLO"
+  .then(v => v.refine(s => s + "!"))        // "HELLO!"
+
+console.log(result.value); // "HELLO!"
+```
+
+## Why?
+
+It's just a cleaner alternative to deeply nested function calls or intermediate variables:
+
+```typescript
+// instead of this:
+const doubled = n * 2;
+const labeled = `${doubled}!`;
+const len = labeled.length;
+
+// or this:
+const len = getLength(label(double(n)));
+
+// do this:
+const len = r(n)
+  .refine(n => n * 2)
+  .refine(n => `${n}!`)
+  .refine(s => s.length)
+  .value;
+```

package/bun.lock

@@ -0,0 +1,26 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "refineable",
+      "devDependencies": {
+        "@types/bun": "latest",
+      },
+      "peerDependencies": {
+        "typescript": "^5",
+      },
+    },
+  },
+  "packages": {
+    "@types/bun": ["@types/bun@1.3.10", "", { "dependencies": { "bun-types": "1.3.10" } }, "sha512-0+rlrUrOrTSskibryHbvQkDOWRJwJZqZlxrUs1u4oOoTln8+WIXBPmAuCF35SWB2z4Zl3E84Nl/D0P7803nigQ=="],
+
+    "@types/node": ["@types/node@25.5.0", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw=="],
+
+    "bun-types": ["bun-types@1.3.10", "", { "dependencies": { "@types/node": "*" } }, "sha512-tcpfCCl6XWo6nCVnpcVrxQ+9AYN1iqMIzgrSKYMB/fjLtV2eyAVEg7AxQJuCq/26R6HpKWykQXuSOq/21RYcbg=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
+  }
+}

package/index.ts

@@ -0,0 +1,13 @@
+type Refineable<T> = {
+  value: T;
+  refine: <U>(f: (value: T) => U) => Refineable<U>;
+  refineAsync: <U>(f: (value: T) => Promise<U>) => Promise<Refineable<U>>;
+};
+
+const r = <T>(value: T): Refineable<T> => ({
+  value,
+  refine: <U>(f: (v: T) => U) => r(f(value)),
+  refineAsync: async <U>(f: (v: T) => Promise<U>) => r(await f(value)),
+});
+
+export { r, Refineable };

package/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "refineable",
+  "version": "1.0.0",
+  "module": "index.ts",
+  "type": "module",
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}