@uxf/core 11.95.0 → 11.100.0

package/README.md

@@ -139,6 +139,22 @@ switch(value) {
 }
 ```
 
+### ts-pattern
+
+Re-export of the [ts-pattern](https://github.com/gvergnaud/ts-pattern) library for exhaustive pattern matching. This provides a more powerful and type-safe alternative to switch statements with support for complex patterns, guards, and exhaustiveness checking.
+
+```ts
+import { match, Pattern } from "@uxf/core/utils/ts-pattern";
+
+const result = match(value)
+    .with("a", () => "A")
+    .with("b", () => "B")
+    .with(Pattern.string, (str) => `String: ${str}`)
+    .exhaustive();
+```
+
+For full documentation, see the [official ts-pattern docs](https://github.com/gvergnaud/ts-pattern).
+
 ## assertNotNil
 
 ```tsx
@@ -287,6 +303,18 @@ escapeQuotes('The "quick" fox');
 // Output: The \"quick\" fox
 ```
 
+## humanIndex
+
+Converts a 0-based index to a 1-based (human-readable) index.
+
+```tsx
+import { humanIndex } from "@uxf/core/utils/human-index";
+
+humanIndex(0);  /* returns 1 */
+humanIndex(9);  /* returns 10 */
+humanIndex(-1);  /* throws error */
+```
+
 ## filterNullish
 
 ```tsx

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uxf/core",
-    "version": "11.95.0",
+    "version": "11.100.0",
     "description": "UXF Core",
     "author": "Petr Vejvoda <vejvoda@uxf.cz>",
     "homepage": "https://gitlab.com/uxf-npm/core#readme",
@@ -19,6 +19,9 @@
         "build": "tsc -P tsconfig.json",
         "typecheck": "tsc --noEmit --skipLibCheck"
     },
+    "dependencies": {
+        "ts-pattern": "5.9.0"
+    },
     "bugs": {
         "url": "https://gitlab.com/uxf-npm/core/issues"
     },

package/utils/human-index.d.ts

@@ -0,0 +1 @@
+export declare function humanIndex(index: number): number;

package/utils/human-index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.humanIndex = humanIndex;
+function humanIndex(index) {
+    if (index < 0) {
+        throw Error("Negative indexes are not supported.");
+    }
+    return index + 1;
+}

package/utils/human-index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/utils/human-index.test.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const human_index_1 = require("./human-index");
+test("human-index", () => {
+    expect((0, human_index_1.humanIndex)(0)).toBe(1);
+    expect((0, human_index_1.humanIndex)(1)).toBe(2);
+    expect((0, human_index_1.humanIndex)(9)).toBe(10);
+    expect(() => (0, human_index_1.humanIndex)(-1)).toThrow();
+});

package/utils/ts-pattern.d.ts

@@ -0,0 +1 @@
+export { NonExhaustiveError, P, Pattern, isMatching, match } from "ts-pattern";

package/utils/ts-pattern.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.match = exports.isMatching = exports.Pattern = exports.P = exports.NonExhaustiveError = void 0;
+var ts_pattern_1 = require("ts-pattern");
+Object.defineProperty(exports, "NonExhaustiveError", { enumerable: true, get: function () { return ts_pattern_1.NonExhaustiveError; } });
+Object.defineProperty(exports, "P", { enumerable: true, get: function () { return ts_pattern_1.P; } });
+Object.defineProperty(exports, "Pattern", { enumerable: true, get: function () { return ts_pattern_1.Pattern; } });
+Object.defineProperty(exports, "isMatching", { enumerable: true, get: function () { return ts_pattern_1.isMatching; } });
+Object.defineProperty(exports, "match", { enumerable: true, get: function () { return ts_pattern_1.match; } });