umsizi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Jack WebDev
+
+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,202 @@
+# Umsizi
+
+> The missing TypeScript standard library.
+
+**Umsizi** (pronounced *oom-see-zee*) is a modern, zero-dependency utility library built from the ground up for TypeScript applications. The name comes from the Zulu word for **"helper"** or **"assistant"**—which is exactly what this library is designed to be.
+
+It provides small, focused utilities that preserve types, eliminate repetitive code, and replace the disorganized `utils/` folder every project eventually creates.
+
+```ts
+import { identity } from "umsizi";
+
+const user = {
+	id: "1",
+	name: "Jack",
+};
+
+const result = identity(user);
+// inferred as:
+// {
+//   id: string;
+//   name: string;
+// }
+```
+
+---
+
+## Why Umsizi
+
+Most TypeScript projects slowly accumulate a standard set of custom helpers:
+
+```ts
+src/
+ └─ utils/
+     ├─ arrays.ts
+     ├─ objects.ts
+     ├─ promises.ts
+     └─ guards.ts
+
+```
+
+These copy-pasted snippets usually become undocumented, inconsistently typed, and completely untested. Umsizi replaces that folder with a single, production-ready, and highly optimized package.
+
+### Core Principles
+
+- **TypeScript-First:** Built around strict type inference. Types flow naturally through every utility so you never have to manually cast with `as`.
+- **Composition Over Configuration:** Every function does exactly one thing cleanly, favoring simple composition over complex, bloated configuration objects.
+- **Zero Dependencies:** No runtime dependencies means smaller installs, fewer security vulnerabilities, and predictable behavior.
+- **Tree-Shakable:** Only ship what you use. Unused utilities will never affect your production bundle size.
+- **Immutable by Default:** Utilities avoid mutating your existing data structures.
+
+---
+
+## Installation
+
+Install via your package manager of choice:
+
+```bash
+# npm
+npm install umsizi
+
+# pnpm
+pnpm add umsizi
+
+# yarn
+yarn add umsizi
+
+# bun
+bun add umsizi
+
+```
+
+---
+
+## Package Structure
+
+Umsizi is split into focused entry points:
+
+```ts
+import { identity } from "umsizi";
+import { isRenderFunction } from "umsizi/react";
+import { normalizePathname } from "umsizi/next";
+import { hasFileExtension } from "umsizi/node";
+```
+
+Current structure:
+
+```txt
+src/
+  core/
+  react/
+  next/
+  node/
+```
+
+- `umsizi`: framework-agnostic core utilities
+- `umsizi/react`: React-oriented helpers
+- `umsizi/next`: Next.js-oriented helpers
+- `umsizi/node`: Node-oriented helpers
+
+---
+
+## API Reference
+
+### Core Utilities
+
+#### `identity`
+
+```ts
+import { identity } from "umsizi";
+
+const value = identity("umsizi");
+// "umsizi"
+
+```
+
+### React Utilities (`umsizi/react`)
+
+#### `isRenderFunction`
+
+Small guard for values that should be callable in render-oriented code paths.
+
+```ts
+import { isRenderFunction } from "umsizi/react";
+
+const value: unknown = () => "ready";
+
+if (isRenderFunction(value)) {
+	value();
+}
+```
+
+### Next.js Utilities (`umsizi/next`)
+
+#### `normalizePathname`
+
+Normalizes path-like strings by ensuring a leading slash, collapsing duplicate slashes, and preserving root.
+
+```ts
+import { normalizePathname } from "umsizi/next";
+
+normalizePathname("dashboard");
+// "/dashboard"
+
+normalizePathname("//dashboard///settings");
+// "/dashboard/settings"
+```
+
+### Node.js Utilities (`umsizi/node`)
+
+#### `hasFileExtension`
+
+Checks whether a file path ends with a specific extension.
+
+```ts
+import { hasFileExtension } from "umsizi/node";
+
+hasFileExtension("src/index.ts", ".ts");
+// true
+
+hasFileExtension("package.json", "json");
+// true
+```
+
+---
+
+## Current Status
+
+Umsizi is still in early development. The package structure is in place, the initial utilities are implemented, and the public API is intentionally small.
+
+New helpers should only be added when they meet the project standards for:
+
+- type safety
+- runtime correctness
+- API clarity
+- zero-dependency design
+
+---
+
+## How Umsizi Compares
+
+- **vs Lodash:** Lodash was built for an era before modern JavaScript and TypeScript existed. Umsizi embraces modern JS features and prioritizes zero-overhead type inference.
+- **vs Radash:** While Radash is excellent, Umsizi hones in purely on application development patterns and strict, seamless type inference.
+- **vs Remeda:** Remeda heavily emphasizes functional programming paradigms like data-last currying. Umsizi targets straightforward, standard-library-style code for everyday projects.
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+If you want to introduce a helper, ensure it meets the baseline:
+
+1. It solves a highly recurring, real-world application problem.
+2. It features bulletproof TypeScript type safety.
+3. It includes comprehensive runtime and type-level tests.
+4. It remains entirely dependency-free.
+
+---
+
+## License
+
+MIT

package/dist/index-Bi-DJKKn.d.ts

@@ -0,0 +1,5 @@
+//#region src/node/has-file-extension.d.ts
+declare function hasFileExtension(filePath: string, extension: string): boolean;
+//#endregion
+export { hasFileExtension as t };
+//# sourceMappingURL=index-Bi-DJKKn.d.ts.map

package/dist/index-Cfup-UnB.d.ts

@@ -0,0 +1,5 @@
+//#region src/next/normalize-pathname.d.ts
+declare function normalizePathname(pathname: string): string;
+//#endregion
+export { normalizePathname as t };
+//# sourceMappingURL=index-Cfup-UnB.d.ts.map

package/dist/index-uHJbGgdS.d.ts

@@ -0,0 +1,5 @@
+//#region src/react/is-render-function.d.ts
+declare function isRenderFunction(value: unknown): value is (...args: readonly unknown[]) => unknown;
+//#endregion
+export { isRenderFunction as t };
+//# sourceMappingURL=index-uHJbGgdS.d.ts.map

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { t as normalizePathname } from "./index-Cfup-UnB.js";
+import { t as hasFileExtension } from "./index-Bi-DJKKn.js";
+import { t as isRenderFunction } from "./index-uHJbGgdS.js";
+
+//#region src/core/identity.d.ts
+declare function identity<T>(value: T): T;
+//#endregion
+export { hasFileExtension, identity, isRenderFunction, normalizePathname };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,12 @@
+import { t as normalizePathname } from "./next-B9pvCR1P.js";
+import { t as hasFileExtension } from "./node-Di-uva1n.js";
+import { t as isRenderFunction } from "./react-DPRQiKYh.js";
+
+//#region src/core/identity.ts
+function identity(value) {
+	return value;
+}
+
+//#endregion
+export { hasFileExtension, identity, isRenderFunction, normalizePathname };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/core/identity.ts"],"sourcesContent":["export function identity<T>(value: T): T {\n\treturn value;\n}\n"],"mappings":";;;;;AAAA,SAAgB,SAAY,OAAa;AACxC,QAAO"}

package/dist/next-B9pvCR1P.js

@@ -0,0 +1,11 @@
+//#region src/next/normalize-pathname.ts
+function normalizePathname(pathname) {
+	if (pathname === "") return "/";
+	const normalized = pathname.replace(/\/{2,}/g, "/").replace(/\/$/, "");
+	if (normalized === "") return "/";
+	return normalized.startsWith("/") ? normalized : `/${normalized}`;
+}
+
+//#endregion
+export { normalizePathname as t };
+//# sourceMappingURL=next-B9pvCR1P.js.map

package/dist/next-B9pvCR1P.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-B9pvCR1P.js","names":[],"sources":["../src/next/normalize-pathname.ts"],"sourcesContent":["export function normalizePathname(pathname: string): string {\n\tif (pathname === \"\") {\n\t\treturn \"/\";\n\t}\n\n\tconst normalized = pathname.replace(/\\/{2,}/g, \"/\").replace(/\\/$/, \"\");\n\n\tif (normalized === \"\") {\n\t\treturn \"/\";\n\t}\n\n\treturn normalized.startsWith(\"/\") ? normalized : `/${normalized}`;\n}\n"],"mappings":";AAAA,SAAgB,kBAAkB,UAA0B;AAC3D,KAAI,aAAa,GAChB,QAAO;CAGR,MAAM,aAAa,SAAS,QAAQ,WAAW,IAAI,CAAC,QAAQ,OAAO,GAAG;AAEtE,KAAI,eAAe,GAClB,QAAO;AAGR,QAAO,WAAW,WAAW,IAAI,GAAG,aAAa,IAAI"}

package/dist/next.d.ts

@@ -0,0 +1,2 @@
+import { t as normalizePathname } from "./index-Cfup-UnB.js";
+export { normalizePathname };

package/dist/next.js

@@ -0,0 +1,3 @@
+import { t as normalizePathname } from "./next-B9pvCR1P.js";
+
+export { normalizePathname };

package/dist/node-Di-uva1n.js

@@ -0,0 +1,9 @@
+//#region src/node/has-file-extension.ts
+function hasFileExtension(filePath, extension) {
+	const normalizedExtension = extension.startsWith(".") ? extension : `.${extension}`;
+	return filePath.endsWith(normalizedExtension);
+}
+
+//#endregion
+export { hasFileExtension as t };
+//# sourceMappingURL=node-Di-uva1n.js.map

package/dist/node-Di-uva1n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-Di-uva1n.js","names":[],"sources":["../src/node/has-file-extension.ts"],"sourcesContent":["export function hasFileExtension(filePath: string, extension: string): boolean {\n\tconst normalizedExtension = extension.startsWith(\".\")\n\t\t? extension\n\t\t: `.${extension}`;\n\n\treturn filePath.endsWith(normalizedExtension);\n}\n"],"mappings":";AAAA,SAAgB,iBAAiB,UAAkB,WAA4B;CAC9E,MAAM,sBAAsB,UAAU,WAAW,IAAI,GAClD,YACA,IAAI;AAEP,QAAO,SAAS,SAAS,oBAAoB"}

package/dist/node.d.ts

@@ -0,0 +1,2 @@
+import { t as hasFileExtension } from "./index-Bi-DJKKn.js";
+export { hasFileExtension };

package/dist/node.js

@@ -0,0 +1,3 @@
+import { t as hasFileExtension } from "./node-Di-uva1n.js";
+
+export { hasFileExtension };

package/dist/react-DPRQiKYh.js

@@ -0,0 +1,8 @@
+//#region src/react/is-render-function.ts
+function isRenderFunction(value) {
+	return typeof value === "function";
+}
+
+//#endregion
+export { isRenderFunction as t };
+//# sourceMappingURL=react-DPRQiKYh.js.map

package/dist/react-DPRQiKYh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-DPRQiKYh.js","names":[],"sources":["../src/react/is-render-function.ts"],"sourcesContent":["export function isRenderFunction(\n\tvalue: unknown,\n): value is (...args: readonly unknown[]) => unknown {\n\treturn typeof value === \"function\";\n}\n"],"mappings":";AAAA,SAAgB,iBACf,OACoD;AACpD,QAAO,OAAO,UAAU"}

package/dist/react.d.ts

@@ -0,0 +1,2 @@
+import { t as isRenderFunction } from "./index-uHJbGgdS.js";
+export { isRenderFunction };

package/dist/react.js

@@ -0,0 +1,3 @@
+import { t as isRenderFunction } from "./react-DPRQiKYh.js";
+
+export { isRenderFunction };

package/package.json

@@ -0,0 +1,85 @@
+{
+	"name": "umsizi",
+	"version": "0.1.0",
+	"description": "A zero-dependency TypeScript utility library.",
+	"license": "MIT",
+	"author": "Jack-WebDev",
+	"type": "module",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/Jack-WebDev/umsizi.git"
+	},
+	"homepage": "https://github.com/Jack-WebDev/umsizi#readme",
+	"bugs": {
+		"url": "https://github.com/Jack-WebDev/umsizi/issues"
+	},
+	"keywords": [
+		"typescript",
+		"utilities",
+		"helpers",
+		"toolkit",
+		"zero-dependency"
+	],
+	"files": [
+		"dist"
+	],
+	"sideEffects": false,
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./react": {
+			"types": "./dist/react.d.ts",
+			"import": "./dist/react.js"
+		},
+		"./next": {
+			"types": "./dist/next.d.ts",
+			"import": "./dist/next.js"
+		},
+		"./node": {
+			"types": "./dist/node.d.ts",
+			"import": "./dist/node.js"
+		}
+	},
+	"types": "./dist/index.d.ts",
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"scripts": {
+		"build": "tsdown",
+		"ci": "pnpm run lint && pnpm run check-types && pnpm run test && pnpm run build && pnpm run check:package",
+		"check:package": "pnpm run check:package:npm && pnpm run check:package:jsr",
+		"check:package:jsr": "pnpm dlx jsr publish --dry-run --allow-dirty",
+		"check:package:npm": "HUSKY=0 npm_config_cache=/tmp/umsizi-npm-cache npm pack --dry-run --ignore-scripts",
+		"dev": "tsdown --watch",
+		"format": "biome format --write .",
+		"lint": "biome check .",
+		"lint:fix": "biome check --write .",
+		"check-types": "tsc --noEmit",
+		"release:publish": "pnpm run build && pnpm exec changeset publish && pnpm dlx jsr publish --allow-dirty",
+		"release:version": "pnpm exec changeset version && node ./scripts/sync-release-version.mjs",
+		"test": "vitest run",
+		"prepare": "husky"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.5.1",
+		"husky": "^9.1.7",
+		"tsdown": "^0.16.8",
+		"typescript": "5.9.2",
+		"vitest": "4.1.9",
+		"lint-staged": "^16.1.2",
+		"@changesets/cli": "2.31.0"
+	},
+	"packageManager": "pnpm@10.32.1",
+	"publishConfig": {
+		"access": "public"
+	},
+	"lint-staged": {
+		"*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
+			"biome check --write ."
+		]
+	},
+	"engines": {
+		"node": ">=20"
+	}
+}