@skedulo/mex-types 1.1.0 → 1.2.1

package/README.md

@@ -1,6 +1,11 @@
 # mex-types
 
-A central repository store for all the interfaces, type definitions of MEX engine.
+A central repository store for all the interfaces, type definitions of MEX engine. It also includes scripts that can read information from TypeScript files, which contain these interfaces and definitions. The data extracted from these files is then used by the Form Builder.
+
+
+
+## Node version
+18.x
 
 ## Install
 
@@ -10,25 +15,70 @@ Bootstrap
 yarn bootstrap
 ```
 
-Linting
+## How to test the package locally
+From the root of **mex-types**, run
 
 ```sh
-yarn lint
+yarn clean
+yarn build
+npm pack --pack-destination /tmp
 ```
 
-Build
+After this step, you should see a new file in the /tmp folder
+- For example: /tmp/skedulo-mex-types-0.0.1.tgz
 
-```sh
-yarn build
+Inside project uses this package, update **package.json** to point to ***.tgz** above
+```json
+"dependencies": {
+  "@skedulo@mex-types": "file:/tmp/skedulo-mex-types-0.0.1.tgz"
+}
 ```
 
-## Publish
+## Semantic release
+
+This project adheres to the Semantic Versioning (SemVer) release approach, and as such, we employ the tool [Semantic Release](https://github.com/semantic-release/semantic-release) to facilitate automated version incrementation.
+
+### Commit message convention
+> Tips: To simplify the process of creating commit messages that adhere to the Conventional Commits format, consider using the Commitizen tool. After you've staged all your changes, you can run either yarn commit or git cz. This tool will guide you through the process and make it easier to generate the correct commit message format.
+
+Please use the [guidelines](https://www.conventionalcommits.org/en/v1.0.0/) outlined in this guide when writing your commit messages. Following this guide ensures that your commit messages follow a standard format. This standard format is **important** because it helps the semantic-release tool understand and manage versioning more effectively.
+
+The table below shows which commit message gets you which release type when **semantic-release** runs (using the default configuration):
+
+| Commit message                                                                                                                                                                                   | Release type                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
+| fix(api): resolve issue with data parsing                                                                                                                             | ~~Patch~~ Fix Release                                                                                           |
+| feat(login): add user authentication feature                                                                                                                                                       | ~~Minor~~ Feature Release                                                                                       |
+| feat(login): No backward compatibility <br><br>BREAKING CHANGE: The graphiteWidth option has been removed.<br>The default graphite width of 10mm is always used for performance reasons.` | ~~Major~~ Breaking Release <br /> (Note that the BREAKING CHANGE:  token must be in the footer of the commit) |
+
+### Publish workflow
+#### Release channel
+**main** branch
+
+### Pre-release channel
+**beta** branch (**Must** be branched from **main**)
+
+**New feature** (Pre-release) flow:
+- Create a branch from **beta**
+- Implement the feature
+- Raise PR from new branch into **beta**
+- After approved, using squash merge. Please enter commit message following conventional guidelines
+  - At this stage, your beta version is ready to install. It might have a format like this *1.0.1-beta*. (There is a bot will comment on your PR about new version after semantic-release publishing successfully.)
+- Raise PR from **beta** to **main**
+- Wait for approval and squash merge
+
+**Hot fix**
+- Create a branch from **main**
+- Implement the fix
+- Raise PR from new branch into **main**
+- After approved, using squash merge.(Please use *fix* convention message)
+
+### Release type rules
+- If adding comments into the code that affect the output of parsed info, must release in patch type. Here are list of change might contribute to parsed output
+  - jsdocs comment
+  - the parser scripts get updated
+- If add new property, interface, type defs,  must release in minor type
+- Break change (TBD)
+
 
-Bump up the semantic version in package.json and run the following commands -
 
-```sh
-git tag vd.d.d (e.g. v0.4.9)
-git push --tags
-yarn build
-npm publish
-```

package/dist/common/CommonTypes.d.ts

@@ -1,8 +1,11 @@
 import { BaseFlatPageViewComponentModel, SkedButtonTheme } from '../view/FlatPageViewComponentModel';
+import { SelectPageOnlineSource } from '../view';
 export type DataExpressionType = string;
 export type ValueExpressionType = string | ValueExpressionLogic[];
 export type LocalizedKey = string;
 export type OneLevelBindingObject = any;
+export type FunctionExpressionType = string;
+export type TimezoneType = 'none' | 'job' | 'local';
 export type ValueExpressionLogic = {
     condition?: DataExpressionType;
     value: ValueExpressionType;
@@ -35,7 +38,7 @@ export interface ButtonGroupItemComponentModel {
     behavior: ButtonBehaviorComponentModel;
 }
 export interface ButtonBehaviorComponentModel {
-    type: 'custom' | 'sms' | 'phone' | 'openUrl' | 'email';
+    type: 'custom' | 'sms' | 'phone' | 'openUrl' | 'email' | 'openSelector';
 }
 export interface CustomFunctionButtonBehaviorComponentModel extends ButtonBehaviorComponentModel {
     functionExpression: DataExpressionType;
@@ -52,3 +55,30 @@ export interface OpenURLButtonBehaviorComponentModel extends ButtonBehaviorCompo
 export interface EmailButtonBehaviorComponentModel extends ButtonBehaviorComponentModel {
     emailExpression: DataExpressionType;
 }
+export type SelectPageConfig = {
+    searchBar: {
+        filterOnProperties: string[] | undefined;
+        placeholder: LocalizedKey;
+    };
+    itemCaption: LocalizedKey;
+    itemTitle: LocalizedKey;
+    dataSourceExpression: DataExpressionType;
+    emptyText: LocalizedKey;
+    filterExpression?: DataExpressionType;
+    singleSelectionConfig: {
+        dismissPageAfterChosen: boolean;
+    } | undefined;
+    isMultiSelect?: boolean;
+    header: {
+        title: LocalizedKey;
+        hasClearBtn: boolean;
+    } | undefined;
+    onlineSource?: SelectPageOnlineSource;
+    selectedDataExpression?: DataExpressionType;
+};
+export interface OpenSelectorButtonBehaviorComponentModel extends ButtonBehaviorComponentModel {
+    selectPage: SelectPageConfig;
+    events: {
+        onDataChosen: FunctionExpressionType;
+    };
+}

package/dist/page/PageComponentModel.d.ts

@@ -1,4 +1,4 @@
-import { ButtonGroupItemComponentModel, DataExpressionType, ListPageAddNewDefaultDataType, LocalizedKey, OneLevelBindingObject, RoutingType } from '../common/CommonTypes';
+import { ButtonGroupItemComponentModel, DataExpressionType, FunctionExpressionType, ListPageAddNewDefaultDataType, LocalizedKey, OneLevelBindingObject, RoutingType } from '../common/CommonTypes';
 import { BaseListPageViewComponentModel } from '../view/ListPageViewComponentModel';
 import { BaseComponentModel } from '../common/BaseComponentModel';
 import { BaseFlatPageViewComponentModel } from '../view/FlatPageViewComponentModel';
@@ -84,6 +84,11 @@ export interface FlatPageComponentModel extends BasePageComponentModel {
     };
     items: BaseFlatPageViewComponentModel[];
     description: LocalizedKey;
+    events: {
+        onInitialized: FunctionExpressionType;
+        onSubmitted: FunctionExpressionType;
+        onRemoved: FunctionExpressionType;
+    };
 }
 export type AllPageComponentModel = ListPageComponentModel | FlatPageComponentModel;
 export {};

package/dist/view/FlatPageViewComponentModel.d.ts

@@ -1,5 +1,5 @@
 import { BaseComponentModel } from '../common/BaseComponentModel';
-import { ButtonGroupItemComponentModel, DataExpressionType, ListPageAddNewDefaultDataType, LocalizedKey, OneLevelBindingObject, RoutingType } from '../common/CommonTypes';
+import { ButtonGroupItemComponentModel, DataExpressionType, FunctionExpressionType, ListPageAddNewDefaultDataType, LocalizedKey, OneLevelBindingObject, RoutingType, TimezoneType } from '../common/CommonTypes';
 import { SelectPageOnlineSource, SelectPageSearchBarConfig } from './SearchPage';
 import { ValidatorDefinitionModel } from '../validator/ValidatorModel';
 export interface BaseFlatPageViewComponentModel extends BaseComponentModel {
@@ -11,6 +11,10 @@ export interface CommonEditorViewComponentModel extends BaseFlatPageViewComponen
     validator: ValidatorDefinitionModel | undefined;
     mandatory: boolean | DataExpressionType | undefined;
     readonly: boolean | DataExpressionType | undefined;
+    editorEvents: CommonEditorEvents;
+}
+export interface CommonEditorEvents {
+    onValueChanged: FunctionExpressionType;
 }
 export interface CommonEditorWithPlaceholder {
     placeholder: LocalizedKey;
@@ -68,6 +72,9 @@ export interface ToggleEditorItemModel {
 }
 export interface DateTimePickerViewComponentModel extends CommonEditorViewComponentModel, CommonEditorWithPlaceholder {
     mode: 'datetime' | 'date' | 'time';
+    datetimeOptions?: {
+        timezone?: TimezoneType;
+    };
     valueExpression: DataExpressionType;
 }
 export interface BaseSublistViewComponentModel extends BaseComponentModel {

package/dist/view/SearchPage.d.ts

@@ -1,24 +1,4 @@
 import { DataExpressionType, LocalizedKey, OneLevelBindingObject } from '../common/CommonTypes';
-export type SelectPageConfig = {
-    searchBar: {
-        filterOnProperties: string[] | undefined;
-        placeholder: LocalizedKey;
-    };
-    itemCaption: LocalizedKey;
-    itemTitle: LocalizedKey;
-    dataSourceExpression: DataExpressionType;
-    emptyText: LocalizedKey;
-    filterExpression?: DataExpressionType;
-    singleSelectionConfig: {
-        dismissPageAfterChosen: boolean;
-    } | undefined;
-    isMultiSelect?: boolean;
-    header: {
-        title: LocalizedKey;
-        hasClearBtn: boolean;
-    };
-    onlineSource?: SelectPageOnlineSource;
-};
 export type SelectPageOnlineSource = {
     key: DataExpressionType;
     variables: OneLevelBindingObject;

package/package.json

@@ -3,6 +3,7 @@
   "description": "A central repository store for all the interfaces, type definitions of MEX engine",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "version": "1.2.1",
   "scripts": {
     "bootstrap": "rm -rf node_modules && yarn install --pure-lockfile --peer",
     "lint": "tslint 'src/**/*.ts'",
@@ -44,6 +45,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "version": "1.1.0"
+  }
 }