add super parameter

Author: waseemdev

README.md

@@ -127,7 +127,7 @@ class HomeController extends HomeControllerBase {
 
   //
   // here you can add you own logic and call the variables and methods
-  // from the XML file. e.g. <Text text="ctrl.myText" />
+  // within the XML file. e.g. <Text text="ctrl.myText" />
   //
 
   @override
@@ -155,6 +155,7 @@ class HomeController extends HomeControllerBase {
 ### 2. [Pipes](./docs/pipes.md)
 ### 3. [Custom properties](./docs/custom-properties.md)
 ### 4. [Injecting providers](./docs/providers.md)
+### 4. [Parameters](./docs/parameters.md)
 ### 5. [Adding controllers to widgets](./docs/controllers.md)
 ### 6. [Adding mixin to widget's states](./docs/mixins.md)
 ### 7. [Localization](./docs/localization.md)

docs/parameters.md

@@ -1,15 +1,30 @@
 
 
 # Passing parameters to widgets
-Parameters are used to pass information from one widget to another, and since you can't modify the widget code (generated file), the XML structure enables you to declare the parameter(s) as follow:
+Parameters are used to pass data from one widget to another, and since you can't modify the widget code (generated file), the XML structure enables you to declare the parameter(s) as follow:
 ```XML
 <MyPage controller="MyController">
   <param type="CategoryModel" name="category" />
+
+  <param type="int" name="index" required="true" />
+  <!-- 
+    final int index;
+    MyPage({@required this.index})
+  -->
+  
+  <param type="UniqueKey" name="key" superParamName="key" />
+  <!-- 
+    final UniqueKey key;
+    MyPage({this.key}) : super(key: key);
+  -->
+  
+  <param type="UniqueKey" superParamName="key" />
+  <!-- MyPage({UniqueKey key}) : super(key: key) -->
   ...
 </MyPage>
 ```
 
-And you can access it directly inside XML:
+And you can access it directly in the XML file:
 ```XML
   <Text text="category.name" />
 ```

src/generators/class-generator.ts

@@ -125,7 +125,7 @@ export class ClassCodeGenerator {
             ...controllers.filter(a => !a.isPrivate && !a.skipGenerate).map(a => this.createControllerVar(a)),
             ...vars.map(a => a.type ? `final ${a.name} = new ${a.type}();` : a.name),
             ...rootWidget.vars.map(a => this.createControllerVar(a)),
-            ...rootWidget.params.map(a => this.createControllerVar(a)),
+            ...rootWidget.params.filter(a => !!a.name).map(a => this.createControllerVar(a)),
             ...rootWidget.providers.map(a => this.createControllerVar(a))
         ];
         const disposeLines = [
@@ -187,9 +187,9 @@ class ${rootWidget.controller}Base {
       return `
 
 class ${widgetName} extends StatelessWidget${mixinsCode} {
-  ${rootWidget.params.map(a => `final ${a.type ? a.type + ' ' : ''}${a.name}${a.value !== undefined ? ' = ' + a.value : ''};`).join('\n  ')}
+  ${rootWidget.params.filter(a => !!a.name).map(a => `final ${a.type ? a.type + ' ' : ''}${a.name}${a.value !== undefined ? ' = ' + a.value : ''};`).join('\n  ')}
   ${widgetName}(${rootWidget.params.length ? '{': ''}
-    ${rootWidget.params.map(a => `${a.required ? '@required ' : ''}this.${a.name}`).join(',\n    ')}
+    ${rootWidget.params.map(a => `${a.required ? '@required ' : ''}${a.name ? `this.${a.name}` : `${(a.type ? a.type + ' ' : '')}${a.superParamName}`}`).join(',\n    ')}
   ${rootWidget.params.length ? '}': ''});
   ${buildMethodContent}
 }
@@ -206,19 +206,24 @@ class ${widgetName} extends StatelessWidget${mixinsCode} {
         ];
         const stateVarsInit: string[] = [
             ...(hasController ? [`ctrl = new ${rootWidget.controller}();`] : []),
-            ...rootWidget.params.map(a => `ctrl._${a.name} = widget.${a.name};`),
+            ...rootWidget.params.filter(a => !!a.name).map(a => `ctrl._${a.name} = widget.${a.name};`),
             ...controllers.filter(a => !a.isPrivate && !a.skipGenerate).map(a => `${hasController ? `ctrl._${a.name} = `: ''}${a.name} = ${a.value ? a.value : `new ${a.type}()`};`),
             ...rootWidget.vars.map(a => `${hasController ? `ctrl._${a.name} = `: ''}${a.name} = ${a.value};`),
             ...(hasController ? [`WidgetsBinding.instance.addPostFrameCallback((_) => ctrl.afterFirstBuild(context));`] : [])
         ];
+        const superParams = rootWidget.params
+          .filter(a => a.superParamName)
+          .map(a => `${a.superParamName}: ${a.name || a.superParamName}`)
+          .join(', ');
+        const superCtor = superParams ? ` : super(${superParams})` : '';
 
         return `
 
 class ${widgetName} extends StatefulWidget {
-  ${rootWidget.params.map(a => `final ${a.type ? a.type + ' ' : ''}${a.name}${a.value !== undefined ? ' = ' + a.value : ''};`).join('\n  ')}
+  ${rootWidget.params.filter(a => !!a.name).map(a => `final ${a.type ? a.type + ' ' : ''}${a.name}${a.value !== undefined ? ' = ' + a.value : ''};`).join('\n  ')}
   ${widgetName}(${rootWidget.params.length ? '{': ''}
-    ${rootWidget.params.map(a => `${a.required ? '@required ' : ''}this.${a.name}`).join(',\n    ')}
-  ${rootWidget.params.length ? '}': ''});
+    ${rootWidget.params.map(a => `${a.required ? '@required ' : ''}${a.name ? `this.${a.name}` : `${(a.type ? a.type + ' ' : '')}${a.superParamName}`}`).join(',\n    ')}
+  ${rootWidget.params.length ? '}': ''})${superCtor};
 
   @override
   _${widgetName}State createState() => _${widgetName}State();

src/resolvers/widget-resolver.ts

@@ -119,9 +119,10 @@ export class WidgetResolver {
                 type: n.attributes['type'] || 'dynamic',
                 name: n.attributes['name'],
                 value: n.attributes['value'],
+                superParamName: n.attributes['superParamName'],
                 required: 'required' in n.attributes
             };
-        }).filter(a => !!a.name);
+        }).filter(a => !!a.name || !!a.superParamName);
 
         return params;
     }