@peter.naydenov/morph 1.2.0 → 1.2.1

package/Changelog.md

@@ -2,6 +2,12 @@
 
 
 
+### 1.2.1 (2025-03-16)
+- [x]Enhanced Error Handling in setupActions.js: Improved the error message to provide more context about the missing level markers, making it easier to debug;
+- [x] Added TypeScript Type Definitions: Created a types directory with an index.d.ts file containing TypeScript definitions for the library, and added the "types" field to package.json for better TypeScript support;
+
+
+
 ### 1.2.0 (2025-03-14)
 - [x] Bug fix: Deeply nested data;
 - [x] Improve: Error message if actions do not have deepness of the data (very difficult to debug);

package/package.json

@@ -1,11 +1,12 @@
 {
     "name": "@peter.naydenov/morph",
     "description": "Template engine",
-    "version": "1.2.0",
+    "version": "1.2.1",
     "license": "MIT",
     "author": "Peter Naydenov",
-    "main": ".src/main.js",
+    "main": "./src/main.js",
     "type": "module",
+    "types": "./types/index.d.ts",
     "exports": {
         ".": {
             "import": "./src/main.js",

package/src/methods/_defineData.js

@@ -1,5 +1,4 @@
 import walk from '@peter.naydenov/walk'
-// import _defineDataType from './_defineType';'../methods/_defineType.js'
 
 
 

package/src/methods/_setupActions.js

@@ -8,7 +8,7 @@ function _setupActions ( actions, dataDeepLevel=10 ) {
     ;
 
     actionList.forEach ( action => {   if ( action === '#' )  countHashes++   })
-    if ( countHashes < dataDeepLevel )   console.error ( `Error: Actions doesn't describe all levels of data. Actions: ${actions}` )
+    if ( countHashes < dataDeepLevel )   console.error ( `Error: Not enough level markers (#) for data with depth level ${dataDeepLevel}. Found ${countHashes} level markers in actions: ${actions.join(', ')}` )
 
     do {
             actSetup[i] = []

package/src/methods/build.js

@@ -86,7 +86,8 @@ function build  ( tpl, extra=false, buildDependencies={} ) {
                                         
                                         if ( topLevelType !== 'array' )   d = [ d ]
                                         
-                                        // TODO: If 'd' is null -> then no data for all the placeholders   
+                                        // Handle null data case - just return the template without placeholders
+                                        if ( topLevelType === 'null' )   return cuts.join ( '' ).replace(/{{.*?}}/g, '')
                                         
                                         d.forEach ( dElement => {
                                         placeholders.forEach ( holder => {   // Placeholders

package/types/index.d.ts

@@ -0,0 +1,60 @@
+declare module '@peter.naydenov/morph' {
+  /**
+   * Template description object
+   */
+  interface TemplateDescription {
+    /**
+     * Template string with placeholders
+     */
+    template: string;
+    /**
+     * Optional helper functions or templates
+     */
+    helpers?: Record<string, any>;
+    /**
+     * Optional example data for rendering
+     */
+    handshake?: Record<string, any>;
+  }
+
+  /**
+   * Build a component from template description
+   */
+  function build(tpl: TemplateDescription, extra?: boolean, buildDependencies?: Record<string, any>): Function;
+
+  /**
+   * Get a component from component storage
+   */
+  function get(location: [string, string?]): Function;
+
+  /**
+   * Add a component to component storage
+   */
+  function add(location: [string, string?], tplfn: Function | TemplateDescription, ...args: any[]): void;
+
+  /**
+   * List the names of all components in the component storage
+   */
+  function list(storageNames?: string[]): string[];
+
+  /**
+   * Clear up all the components in the storage
+   */
+  function clear(): void;
+
+  /**
+   * Remove a template from component storage
+   */
+  function remove(location: [string, string?]): void | string;
+
+  const morphAPI: {
+    build: typeof build;
+    get: typeof get;
+    add: typeof add;
+    list: typeof list;
+    clear: typeof clear;
+    remove: typeof remove;
+  };
+
+  export default morphAPI;
+}