anu-verzum 1.4.0 → 1.5.0

package/README.md

@@ -193,6 +193,9 @@ npm run format      # Format all source files with Prettier
         <li>
             <a href="#redirecting-with-history-goto">Redirecting with Anu.History.goTo()</a>
         </li>
+        <li>
+            <a href="#reading-url-parameters">Reading URL parameters</a>
+        </li>
     </ul>
     <li>
         <a href="#server-api">Calling the server asynchronously - The Server API</a>
@@ -1316,6 +1319,37 @@ when you want to imperatively modify a child outside of the typical dataflow.
         Anu.History.goTo('/about', true);
         ```
 
+<h3 id="reading-url-parameters">Reading URL parameters - <strong><code>Anu.History.getUrlParams()</code> and <code>Anu.History.getAllUrlParamNames()</code></strong></h3>
+
+URLs are expected to follow the REST resource-path convention:
+
+```
+/{noun-plural}/{id}/{noun-plural}/{id}/...
+```
+
+The router parses the current pathname into named parameters by singularizing each noun segment and appending `Id`.
+A trailing action segment (odd-length path) is ignored.
+
+| URL | Extracted params |
+|---|---|
+| `/products` | `{}` |
+| `/products/a3f8c2d1` | `{ productId: 'a3f8c2d1' }` |
+| `/users/asdf1234/products` | `{ userId: 'asdf1234' }` |
+| `/users/asdf1234/products/ghjk5678` | `{ userId: 'asdf1234', productId: 'ghjk5678' }` |
+| `/users/asdf1234/products/ghjk5678/delete` | `{ userId: 'asdf1234', productId: 'ghjk5678' }` |
+
+- **`Anu.History.getUrlParams(key)`** — returns the value of the named URL parameter derived from the current pathname, or `null` if the key is not present.
+- **`Anu.History.getAllUrlParamNames()`** — returns an array of all parameter key names extractable from the current pathname. Useful for development and debugging.
+
+    ```typescript
+    // URL: /users/asdf1234/products/ghjk5678
+    Anu.History.getUrlParams('userId');       // → 'asdf1234'
+    Anu.History.getUrlParams('productId');    // → 'ghjk5678'
+    Anu.History.getUrlParams('orderId');      // → null
+
+    Anu.History.getAllUrlParamNames();        // → ['userId', 'productId']
+    ```
+
 <br>
 
 <h2 id="server-api">Calling the server asynchronously - <strong>The Server API</strong></h2>

package/dist/core/components/History.d.ts

@@ -44,5 +44,7 @@ declare const History: {
     Link: typeof HistoryLink;
     Redirect: typeof HistoryRedirect;
     Route: typeof HistoryRoute;
+    getUrlParams: (key: string) => string | null;
+    getAllUrlParamNames: () => string[];
 };
 export default History;

package/dist/core/components/History.js

@@ -68,6 +68,38 @@ const matchPath = (pathname, options) => {
     isExact
   };
 };
+const singularize = word => {
+  if (word.endsWith('ies')) {
+    return `${word.slice(0, -3)}y`;
+  }
+  if (word.endsWith('sses')) {
+    return word.slice(0, -2);
+  }
+  if (word.endsWith('xes')) {
+    return word.slice(0, -2);
+  }
+  if (word.endsWith('zes')) {
+    return word.slice(0, -3);
+  }
+  if (word.endsWith('ches')) {
+    return word.slice(0, -2);
+  }
+  if (word.endsWith('shes')) {
+    return word.slice(0, -2);
+  }
+  if (word.endsWith('s')) {
+    return word.slice(0, -1);
+  }
+  return word;
+};
+const parseUrlParams = pathname => {
+  const segments = pathname.split('/').filter(Boolean);
+  const params = {};
+  for (let i = 0; i < segments.length - 1; i += 2) {
+    params[`${singularize(segments[i])}Id`] = segments[i + 1];
+  }
+  return params;
+};
 class HistoryRoute extends _Component.Component {
   constructor(props) {
     super(props);
@@ -166,9 +198,16 @@ const goTo = (path = '/', replace) => {
   }
 };
 exports.goTo = goTo;
+const getUrlParams = key => {
+  const params = parseUrlParams(window.location.pathname);
+  return params[key] ?? null;
+};
+const getAllUrlParamNames = () => Object.keys(parseUrlParams(window.location.pathname));
 const History = {
   Link: HistoryLink,
   Redirect: HistoryRedirect,
-  Route: HistoryRoute
+  Route: HistoryRoute,
+  getUrlParams,
+  getAllUrlParamNames
 };
 var _default = exports.default = History;

package/dist/index.d.ts

@@ -83,6 +83,8 @@ declare const Anu: {
             };
             isAnuComponent?: boolean;
         };
+        getUrlParams: (key: string) => string | null;
+        getAllUrlParamNames: () => string[];
     };
     Intl: {
         abbreviateNumber: (value: number, options?: import(".").AbbreviateNumberOptions) => string | number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anu-verzum",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "A \"React-like\" UI library that supports JSX syntax, Redux-like state management, array-rendering, i18n, routing and many more.",
   "keywords": [
     "anu-verzum",