anu-verzum 1.4.0 → 1.6.0

package/README.md

@@ -4,6 +4,7 @@
 
 <h3>@author: <strong>Anubis-programmer</strong></h3>
 <h3>@license: <strong>MIT</strong></h3>
+<h3>@version: <strong>1.6.0</strong></h3>
 
 <br>
 
@@ -193,6 +194,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 +1320,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/Component.js

@@ -17,7 +17,7 @@ class Component {
     this.state = this.state || {};
   }
   setState(partialState = {}) {
-    let partialStateObject = this.state;
+    let partialStateObject = {};
     let partialStateCallback;
     if (typeof partialState === 'object') {
       partialStateObject = {

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/core/components/Intl.js

@@ -49,6 +49,16 @@ const IntlProvider = ({
     return undefined;
   }
 };
+const interpolateValues = (text, values) => {
+  let result = text;
+  Object.keys(values).forEach(key => {
+    const variablePattern = `{${key}}`;
+    if (result.indexOf(variablePattern) > -1) {
+      result = result.replace(new RegExp(`\\{${key}\\}`, 'g'), String(values[key]));
+    }
+  });
+  return result;
+};
 const FormattedMessage = ({
   id,
   values,
@@ -58,7 +68,7 @@ const FormattedMessage = ({
     messages
   }
 }) => {
-  let textValue = '';
+  let textValue;
   try {
     if (messages && messages[id]) {
       textValue = messages[id];
@@ -71,12 +81,7 @@ const FormattedMessage = ({
       throw new Error('No text or fallback value to return.');
     } else {
       if (values && typeof values === 'object' && values !== null) {
-        Object.keys(values).forEach(key => {
-          const variablePattern = `{${key}}`;
-          if (textValue.indexOf(variablePattern) > -1) {
-            textValue = textValue.replace(variablePattern, String(values[key]));
-          }
-        });
+        textValue = interpolateValues(textValue, values);
       }
       return (0, _elements.createElement)(_elements.TEXT_ELEMENT, {
         nodeValue: textValue
@@ -104,12 +109,7 @@ const formatMessage = (id, values, defaultMessage) => {
     console.error(err);
   }
   if (values && typeof values === 'object' && values !== null) {
-    Object.keys(values).forEach(key => {
-      const variablePattern = `{${key}}`;
-      if (textValue.indexOf(variablePattern) > -1) {
-        textValue = textValue.replace(variablePattern, String(values[key]));
-      }
-    });
+    textValue = interpolateValues(textValue, values);
   }
   return textValue;
 };

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.6.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",