river-string 1.0.0

package/README.md

@@ -0,0 +1,55 @@
+# usage
+
+## Examples
+
+raw javascript
+
+```
+const raw = "  Score: 85%  ";
+const score = Math.round(parseInt(raw.replace('Score: ', '').replace('%', ''), 10) * 1.1);
+```
+
+river way
+
+```
+const score = s("  Score: 85%  ")
+  .replace('Score: ', '')
+  .replace('%', '')
+  .toNumber()
+  .multiply(1.1)
+  .round()
+  .value();
+```
+
+# development
+
+## Running tests
+
+need node version 25 to work properly the glob
+
+```
+npm run test
+```
+
+manually run
+
+```
+  npx tsx --test src/**/*.test.ts
+```
+
+## running demo
+
+npx tsx demo.ts
+
+## overview
+
+```
+/src
+  /logic
+    string-logic.ts   <-- All string methods (toPascal, shout, etc.)
+    number-logic.ts   <-- new math methods (add, multiply, round)
+  /types
+    types.ts    <-- TypeScript interfaces for String and Number flows
+  core.ts             <-- The "River" Proxy factory
+  index.ts            <-- Entry point (export s)
+```

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Define the custom methods we want to add to our "River"
+ */
+interface RiverMethods {
+    /** Converts string to PascalCase */
+    toPascal(): RiverString;
+    /** Adds a string to the beginning */
+    addPrefix(prefix: string): RiverString;
+    /** Truncates the string to a specific length */
+    shorten(len: number): RiverString;
+    /** Adds caps and exclamation points */
+    shout(): RiverString;
+    /** The "Terminal" command: Executes the queue and returns the raw string */
+    readonly value: string;
+}
+/**
+ * The "Magic" Type:
+ * Combines native String methods with our custom River methods.
+ * We use Omit to ensure our custom methods take priority over native ones.
+ */
+export type RiverString = RiverMethods & Omit<String, keyof RiverMethods | 'valueOf' | 'toString'>;
+/**
+ * The Main Entry Point
+ */
+export declare function s(initialValue: string): RiverString;
+export default s;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,UAAU,YAAY;IACpB,oCAAoC;IACpC,QAAQ,IAAI,WAAW,CAAC;IACxB,qCAAqC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IACvC,gDAAgD;IAChD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC;IAClC,uCAAuC;IACvC,KAAK,IAAI,WAAW,CAAC;IACrB,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC,CAAC;AAYnG;;GAEG;AACH,wBAAgB,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,CAiCnD;AAED,eAAe,CAAC,CAAC"}

package/dist/index.js

@@ -0,0 +1,53 @@
+/**
+ * Internal map of the actual logic for our custom methods.
+ */
+const MethodLogic = {
+    toPascal: (s) => s.replace(/(\w)(\w*)/g, (_, g1, g2) => g1.toUpperCase() + g2.toLowerCase()).replace(/\s/g, ''),
+    addPrefix: (s, prefix) => prefix + s,
+    shorten: (s, len) => s.substring(0, len),
+    shout: (s) => s.toUpperCase() + "!!!"
+};
+/**
+ * The Main Entry Point
+ */
+export function s(initialValue) {
+    // The "Command Queue" - stores actions as { name, args }
+    const queue = [];
+    const handler = {
+        get(_target, prop) {
+            // 1. TERMINAL: If the user asks for .value, run the whole queue
+            if (prop === 'value') {
+                return queue.reduce((current, action) => action.fn(current, ...action.args), initialValue);
+            }
+            const implementation = MethodLogic[prop] || String.prototype[prop];
+            // 2. CUSTOM METHODS: Look in our MethodLogic map
+            if (typeof implementation === 'function') {
+                return (...args) => {
+                    queue.push({
+                        name: prop,
+                        fn: (val, ...a) => val[prop](...a),
+                        args
+                    });
+                    return proxy;
+                };
+            }
+            // 3. FALLBACK: Native properties (like .length) require immediate execution
+            const currentValue = queue.reduce((current, action) => action.fn(current, ...action.args), initialValue);
+            return currentValue[prop];
+        }
+    };
+    const proxy = new Proxy({}, handler);
+    return proxy;
+}
+export default s;
+// --- USAGE ---
+function main() {
+    const request = s("hello world")
+        .toPascal()
+        .addPrefix("ID_")
+        .shout();
+    console.log("Proxy created. No methods executed yet.");
+    console.log("---");
+    console.log("Result:", request.value);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwBA;;GAEG;AACH,MAAM,WAAW,GAA4D;IAC3E,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;IAC/G,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,GAAG,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,CAAC,CAAC,YAAoB;IACpC,yDAAyD;IACzD,MAAM,KAAK,GAAuD,EAAE,CAAC;IAErE,MAAM,OAAO,GAAsB;QACjC,GAAG,CAAC,OAAO,EAAE,IAAY;YACvB,gEAAgE;YAChE,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;YAC7F,CAAC;YAED,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,SAAiB,CAAC,IAAI,CAAC,CAAC;YAE3E,iDAAiD;YACjD,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;gBACzC,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE;oBACxB,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,IAAI;wBACV,EAAE,EAAE,CAAC,GAAW,EAAE,GAAG,CAAQ,EAAE,EAAE,CAAE,GAAW,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;wBAC1D,IAAI;qBACL,CAAC,CAAC;oBACH,OAAO,KAAK,CAAC;gBACf,CAAC,CAAC;YACJ,CAAC;YAED,4EAA4E;YAC5E,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;YACzG,OAAQ,YAAoB,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,KAA+B,CAAC;AACzC,CAAC;AAED,eAAe,CAAC,CAAC;AAEjB,gBAAgB;AAChB,SAAS,IAAI;IACX,MAAM,OAAO,GAAG,CAAC,CAAC,aAAa,CAAC;SAC7B,QAAQ,EAAE;SACV,SAAS,CAAC,KAAK,CAAC;SAChB,KAAK,EAAE,CAAC;IAEX,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "river-string",
+  "version": "1.0.0",
+  "description": "",
+  "main": "dist/index.js",
+  "types": "dist/index.d.js",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "test": "tsx --test \"src/**/*.test.ts\""
+  },
+  "author": "Wesley Lin",
+  "license": "ISC",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "prettier": "^3.7.4",
+    "tsx": "^4.21.0"
+  }
+}