@esmate/utils 1.0.0

package/LICENSE

@@ -0,0 +1,16 @@
+MIT License
+
+Copyright (c) 2025 Vien Dinh
+
+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,23 @@
+# @esmate/react
+
+## React Hooks
+
+### useSearchParam
+
+React sensor hook that tracks browser's location search param.
+
+```tsx
+import { useSearchParam } from "@esmate/react/hooks/use-search-param";
+
+export function Search() {
+  const searchParam = useSearchParam();
+
+  return <div>{searchParam.get("q")}</div>;
+}
+```
+
+#### Caveats/Gotchas
+
+When using a hash router, like `react-router`'s
+[`<HashRouter>`](https://github.com/ReactTraining/react-router/blob/master/packages/react-router-dom/docs/api/HashRouter.md),
+this hook won't be able to read the search parameters as they are considered part of the hash of the URL by browsers.

package/dist/locale.d.ts

@@ -0,0 +1,6 @@
+export interface TimeZone {
+    name: string;
+    value: string;
+    offset: string;
+}
+export declare function getTimeZoneList(): TimeZone[];

package/dist/locale.js

@@ -0,0 +1,20 @@
+function getTimeZoneList() {
+    const timeZones = Intl.supportedValuesOf("timeZone");
+    const getOffset = (timeZone)=>{
+        const offset = new Intl.DateTimeFormat("en-US", {
+            timeZone,
+            timeZoneName: "longOffset"
+        }).formatToParts(new Date()).find((part)=>"timeZoneName" === part.type)?.value || "GMT";
+        return "GMT" === offset ? "+00:00" : offset.replace("GMT", "");
+    };
+    return timeZones.map((value)=>{
+        const offset = getOffset(value);
+        const place = (value.split("/").pop() || value).replaceAll("_", " ");
+        return {
+            name: `${offset} ${place}`,
+            value,
+            offset
+        };
+    }).sort((a, b)=>a.offset.localeCompare(b.offset) || a.name.localeCompare(b.name));
+}
+export { getTimeZoneList };

package/dist/pkgs/iso-639-1.d.ts

@@ -0,0 +1,2 @@
+export * from "iso-639-1";
+export { default } from "iso-639-1";

package/dist/pkgs/iso-639-1.js

@@ -0,0 +1,4 @@
+import * as __WEBPACK_EXTERNAL_MODULE_iso_639_1_39eb3c8b__ from "iso-639-1";
+export * from "iso-639-1";
+var __webpack_exports__default = __WEBPACK_EXTERNAL_MODULE_iso_639_1_39eb3c8b__["default"];
+export { __webpack_exports__default as default };

package/dist/pkgs/tiny-invariant.d.ts

@@ -0,0 +1,2 @@
+export * from "tiny-invariant";
+export { default } from "tiny-invariant";

package/dist/pkgs/tiny-invariant.js

@@ -0,0 +1,4 @@
+import * as __WEBPACK_EXTERNAL_MODULE_tiny_invariant_25fdef25__ from "tiny-invariant";
+export * from "tiny-invariant";
+var __webpack_exports__default = __WEBPACK_EXTERNAL_MODULE_tiny_invariant_25fdef25__["default"];
+export { __webpack_exports__default as default };

package/dist/pkgs/title.d.ts

@@ -0,0 +1,2 @@
+export * from "title";
+export { default } from "title";

package/dist/pkgs/title.js

@@ -0,0 +1,4 @@
+import * as __WEBPACK_EXTERNAL_MODULE_title__ from "title";
+export * from "title";
+var __webpack_exports__default = __WEBPACK_EXTERNAL_MODULE_title__["default"];
+export { __webpack_exports__default as default };

package/dist/pkgs/typopo.d.ts

@@ -0,0 +1 @@
+export * from "typopo";

package/dist/pkgs/typopo.js

@@ -0,0 +1 @@
+export * from "typopo";

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@esmate/utils",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "JavaScript/TypeScript utils, functions, and classes in one package.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/viendinhcom/esmate.git"
+  },
+  "keywords": [
+    "esmate",
+    "utils",
+    "tools",
+    "classes",
+    "functions",
+    "javascript",
+    "typescript"
+  ],
+  "exports": {
+    "./lib/*": {
+      "types": "./dist/lib/*.d.ts",
+      "import": "./dist/lib/*.js"
+    },
+    "./pkgs/*": {
+      "types": "./dist/pkgs/*.d.ts",
+      "import": "./dist/pkgs/*.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@types/typopo": "^2.5.4",
+    "iso-639-1": "^3.1.5",
+    "tiny-invariant": "^1.3.3",
+    "title": "^4.0.1",
+    "typopo": "^2.7.1"
+  },
+  "devDependencies": {
+    "@esmate/eslint": "^1.1.2",
+    "@esmate/prettier": "^1.0.5",
+    "@rslib/core": "^0.7.1",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.18.7",
+    "@types/react": "^18.3.24",
+    "@types/react-dom": "^18.3.7",
+    "eslint": "^9.36.0",
+    "fs-extra": "^11.3.2",
+    "globby": "^14.1.0",
+    "prettier": "^3.6.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.2"
+  },
+  "scripts": {
+    "build": "tsx export.ts && rslib build",
+    "dev": "rslib build --watch",
+    "start": "astro preview",
+    "fix": "prettier --write . && eslint --fix .",
+    "check": "tsc && prettier --check . && eslint ."
+  }
+}