@punica/form 1.0.2 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (167) hide show
  1. package/dist/controller/index.d.ts +84 -20
  2. package/dist/controller/index.js +217 -129
  3. package/dist/decorator/Readers.d.ts +9 -0
  4. package/dist/decorator/Readers.js +15 -0
  5. package/dist/decorator/Services.d.ts +9 -0
  6. package/dist/decorator/Services.js +15 -0
  7. package/dist/decorator/Starters.d.ts +9 -0
  8. package/dist/decorator/Starters.js +15 -0
  9. package/dist/decorator/index.d.ts +3 -0
  10. package/dist/{model/decorator → decorator}/index.js +3 -8
  11. package/dist/define/FormItem.d.ts +9 -0
  12. package/dist/{model/formItem/define/index.js → define/FormItem.js} +10 -4
  13. package/dist/define/FormItemProperty.d.ts +8 -0
  14. package/dist/define/FormItemProperty.js +21 -0
  15. package/dist/define/FormProperty.d.ts +7 -0
  16. package/dist/define/FormProperty.js +15 -0
  17. package/dist/define/index.d.ts +3 -0
  18. package/dist/define/index.js +12 -0
  19. package/dist/index.d.ts +5 -1
  20. package/dist/index.js +5 -2
  21. package/dist/model/command/index.d.ts +2 -0
  22. package/dist/model/{formItem/base → command}/index.js +2 -8
  23. package/dist/model/command/item.d.ts +7 -0
  24. package/dist/model/{form/IForm.js → command/item.js} +0 -1
  25. package/dist/model/command/service.d.ts +15 -0
  26. package/dist/model/{action/index.js → command/service.js} +0 -1
  27. package/dist/model/constants/index.d.ts +4 -7
  28. package/dist/model/constants/index.js +0 -10
  29. package/dist/model/form/index.d.ts +11 -2
  30. package/dist/model/form/index.js +0 -17
  31. package/dist/model/index.d.ts +6 -7
  32. package/dist/model/index.js +6 -8
  33. package/dist/model/item/index.d.ts +25 -0
  34. package/dist/model/{chapter → item}/index.js +0 -1
  35. package/dist/model/reader/index.d.ts +3 -4
  36. package/dist/model/reader/index.js +0 -1
  37. package/dist/model/service/index.d.ts +20 -0
  38. package/dist/model/{controller → service}/index.js +0 -1
  39. package/dist/model/starter/index.d.ts +13 -0
  40. package/dist/model/{initializer → starter}/index.js +0 -1
  41. package/dist/model/util/GetItem.d.ts +9 -0
  42. package/dist/model/util/GetItem.js +2 -0
  43. package/dist/model/util/WriteItems.d.ts +8 -0
  44. package/dist/model/util/WriteItems.js +2 -0
  45. package/dist/model/util/index.d.ts +2 -0
  46. package/dist/model/{formItem → util}/index.js +0 -13
  47. package/dist/reader/decorators/base/index.d.ts +37 -0
  48. package/dist/reader/decorators/base/index.js +75 -0
  49. package/dist/reader/decorators/readers/FormItemsReader.d.ts +17 -0
  50. package/dist/reader/decorators/readers/FormItemsReader.js +55 -0
  51. package/dist/reader/decorators/readers/ItemDataReader.d.ts +24 -0
  52. package/dist/reader/decorators/readers/ItemDataReader.js +42 -0
  53. package/dist/reader/decorators/readers/ItemInitializerReader.d.ts +16 -0
  54. package/dist/reader/decorators/readers/ItemInitializerReader.js +34 -0
  55. package/dist/reader/decorators/readers/index.d.ts +3 -0
  56. package/dist/reader/decorators/readers/index.js +12 -0
  57. package/dist/reader/index.d.ts +19 -0
  58. package/dist/reader/index.js +30 -0
  59. package/dist/reader/reader/Reader.d.ts +18 -0
  60. package/dist/reader/reader/Reader.js +30 -0
  61. package/dist/reader/reader/index.d.ts +1 -0
  62. package/dist/reader/reader/index.js +8 -0
  63. package/dist/register/index.d.ts +40 -8
  64. package/dist/register/index.js +50 -10
  65. package/dist/utils/index.d.ts +18 -0
  66. package/dist/utils/index.js +82 -0
  67. package/package.json +2 -3
  68. package/dist/controller/index.js.map +0 -1
  69. package/dist/index.js.map +0 -1
  70. package/dist/model/action/index.d.ts +0 -8
  71. package/dist/model/action/index.js.map +0 -1
  72. package/dist/model/chapter/index.d.ts +0 -9
  73. package/dist/model/chapter/index.js.map +0 -1
  74. package/dist/model/constants/index.js.map +0 -1
  75. package/dist/model/controller/index.d.ts +0 -14
  76. package/dist/model/controller/index.js.map +0 -1
  77. package/dist/model/decorator/Actions.d.ts +0 -3
  78. package/dist/model/decorator/Actions.js +0 -12
  79. package/dist/model/decorator/Actions.js.map +0 -1
  80. package/dist/model/decorator/Chapter.d.ts +0 -4
  81. package/dist/model/decorator/Chapter.js +0 -16
  82. package/dist/model/decorator/Chapter.js.map +0 -1
  83. package/dist/model/decorator/Description.d.ts +0 -3
  84. package/dist/model/decorator/Description.js +0 -12
  85. package/dist/model/decorator/Description.js.map +0 -1
  86. package/dist/model/decorator/Initializer.d.ts +0 -4
  87. package/dist/model/decorator/Initializer.js +0 -12
  88. package/dist/model/decorator/Initializer.js.map +0 -1
  89. package/dist/model/decorator/Name.d.ts +0 -3
  90. package/dist/model/decorator/Name.js +0 -12
  91. package/dist/model/decorator/Name.js.map +0 -1
  92. package/dist/model/decorator/Store.d.ts +0 -3
  93. package/dist/model/decorator/Store.js +0 -12
  94. package/dist/model/decorator/Store.js.map +0 -1
  95. package/dist/model/decorator/Title.d.ts +0 -3
  96. package/dist/model/decorator/Title.js +0 -12
  97. package/dist/model/decorator/Title.js.map +0 -1
  98. package/dist/model/decorator/index.d.ts +0 -7
  99. package/dist/model/decorator/index.js.map +0 -1
  100. package/dist/model/form/IForm.d.ts +0 -12
  101. package/dist/model/form/IForm.js.map +0 -1
  102. package/dist/model/form/IItemMap.d.ts +0 -3
  103. package/dist/model/form/IItemMap.js +0 -3
  104. package/dist/model/form/IItemMap.js.map +0 -1
  105. package/dist/model/form/index.js.map +0 -1
  106. package/dist/model/formItem/FormItemControl.d.ts +0 -13
  107. package/dist/model/formItem/FormItemControl.js +0 -3
  108. package/dist/model/formItem/FormItemControl.js.map +0 -1
  109. package/dist/model/formItem/FormItemConverter.d.ts +0 -5
  110. package/dist/model/formItem/FormItemConverter.js +0 -3
  111. package/dist/model/formItem/FormItemConverter.js.map +0 -1
  112. package/dist/model/formItem/FormItemError.d.ts +0 -17
  113. package/dist/model/formItem/FormItemError.js +0 -3
  114. package/dist/model/formItem/FormItemError.js.map +0 -1
  115. package/dist/model/formItem/FormItemGetData.d.ts +0 -3
  116. package/dist/model/formItem/FormItemGetData.js +0 -3
  117. package/dist/model/formItem/FormItemGetData.js.map +0 -1
  118. package/dist/model/formItem/FormItemInitializer.d.ts +0 -13
  119. package/dist/model/formItem/FormItemInitializer.js +0 -3
  120. package/dist/model/formItem/FormItemInitializer.js.map +0 -1
  121. package/dist/model/formItem/FormItemLayout.d.ts +0 -9
  122. package/dist/model/formItem/FormItemLayout.js +0 -3
  123. package/dist/model/formItem/FormItemLayout.js.map +0 -1
  124. package/dist/model/formItem/FormItemSubmit.d.ts +0 -13
  125. package/dist/model/formItem/FormItemSubmit.js +0 -3
  126. package/dist/model/formItem/FormItemSubmit.js.map +0 -1
  127. package/dist/model/formItem/GetItem.d.ts +0 -2
  128. package/dist/model/formItem/GetItem.js +0 -3
  129. package/dist/model/formItem/GetItem.js.map +0 -1
  130. package/dist/model/formItem/IFormItem.d.ts +0 -16
  131. package/dist/model/formItem/IFormItem.js +0 -3
  132. package/dist/model/formItem/IFormItem.js.map +0 -1
  133. package/dist/model/formItem/IFormItemOptions.d.ts +0 -6
  134. package/dist/model/formItem/IFormItemOptions.js +0 -3
  135. package/dist/model/formItem/IFormItemOptions.js.map +0 -1
  136. package/dist/model/formItem/WriteItems.d.ts +0 -2
  137. package/dist/model/formItem/WriteItems.js +0 -3
  138. package/dist/model/formItem/WriteItems.js.map +0 -1
  139. package/dist/model/formItem/base/GetStoreItem.d.ts +0 -1
  140. package/dist/model/formItem/base/GetStoreItem.js +0 -3
  141. package/dist/model/formItem/base/GetStoreItem.js.map +0 -1
  142. package/dist/model/formItem/base/IBaseFormItem.d.ts +0 -18
  143. package/dist/model/formItem/base/IBaseFormItem.js +0 -3
  144. package/dist/model/formItem/base/IBaseFormItem.js.map +0 -1
  145. package/dist/model/formItem/base/Renderer.d.ts +0 -2
  146. package/dist/model/formItem/base/Renderer.js +0 -3
  147. package/dist/model/formItem/base/Renderer.js.map +0 -1
  148. package/dist/model/formItem/base/SetStoreItem.d.ts +0 -1
  149. package/dist/model/formItem/base/SetStoreItem.js +0 -3
  150. package/dist/model/formItem/base/SetStoreItem.js.map +0 -1
  151. package/dist/model/formItem/base/UpdatePropertyValue.d.ts +0 -1
  152. package/dist/model/formItem/base/UpdatePropertyValue.js +0 -3
  153. package/dist/model/formItem/base/UpdatePropertyValue.js.map +0 -1
  154. package/dist/model/formItem/base/UpdateValue.d.ts +0 -1
  155. package/dist/model/formItem/base/UpdateValue.js +0 -3
  156. package/dist/model/formItem/base/UpdateValue.js.map +0 -1
  157. package/dist/model/formItem/base/index.d.ts +0 -7
  158. package/dist/model/formItem/base/index.js.map +0 -1
  159. package/dist/model/formItem/define/index.d.ts +0 -2
  160. package/dist/model/formItem/define/index.js.map +0 -1
  161. package/dist/model/formItem/index.d.ts +0 -14
  162. package/dist/model/formItem/index.js.map +0 -1
  163. package/dist/model/index.js.map +0 -1
  164. package/dist/model/initializer/index.d.ts +0 -3
  165. package/dist/model/initializer/index.js.map +0 -1
  166. package/dist/model/reader/index.js.map +0 -1
  167. package/dist/register/index.js.map +0 -1
@@ -1,22 +1,86 @@
1
- import { IEntity } from '@punica/common';
2
1
  import { BaseListener } from '@punica/common';
3
- import { IForm, IFormItem, IReader, GetItem, WriteItems, FormEvents, IFormController } from '..';
4
- export declare abstract class BaseFormController<E extends IEntity, F extends IFormItem> extends BaseListener<FormEvents> implements IFormController<E, F> {
5
- protected _formData: IForm<F>;
6
- protected _entity: E;
7
- protected _hasError: boolean;
8
- constructor(entity: E);
9
- protected getItem: GetItem;
10
- protected writeItems: WriteItems;
11
- protected fireEvent(eventType: FormEvents, data: any): void;
12
- start(reader: IReader<E, F>, formData?: IForm<F>): Promise<IForm<F>>;
13
- getEntity(): Promise<E>;
14
- validate(): Promise<boolean>;
15
- reset(): void;
16
- updatePropertyValue(property: string, key: string, value: any): void;
17
- submitControl(): Promise<boolean>;
18
- getInitialEntity(): IEntity;
19
- getStoreItem(key: string): any;
20
- setStoreItem(key: string, value: any): void;
21
- abstract updateValue(property: string, value: any): void;
2
+ import { Form, FormEvents, FormItem, IServiceCommand, IServiceInitialize, IServiceControl } from '..';
3
+ /**
4
+ * Controller for managing a form and its associated services.
5
+ */
6
+ export declare class FormController<E, F extends FormItem<E>> extends BaseListener<FormEvents> {
7
+ #private;
8
+ /**
9
+ * Private constructor to prevent direct instantiation.
10
+ */
11
+ private constructor();
12
+ /**
13
+ * Static method to initialize the FormController with form data.
14
+ * @param form The initial form data
15
+ */
16
+ static fromForm<E, F extends FormItem<E>>(form: Form<E, F>): Promise<FormController<E, F>>;
17
+ /**
18
+ * Static method to initialize the FormController with an entity.
19
+ * @param entity The entity for the form
20
+ */
21
+ static fromEntity<E, F extends FormItem<E>>(entity: E): Promise<FormController<E, F>>;
22
+ /**
23
+ * Trigger a form event.
24
+ * @param eventType The type of the event
25
+ * @param data Data associated with the event
26
+ */
27
+ private fireEvent;
28
+ /**
29
+ * Create a command item for a form item.
30
+ * @param item The form item
31
+ * @returns A promise that resolves to a CommandItem
32
+ */
33
+ private createCommandItem;
34
+ /**
35
+ * Create a command service for the form.
36
+ * @returns A CommandService for the form
37
+ */
38
+ private createCommandService;
39
+ /**
40
+ * Get a form item by its property key.
41
+ * @param property The property key of the form item
42
+ * @returns The form item corresponding to the property key
43
+ */
44
+ private getItem;
45
+ /**
46
+ * Write an array of form items to the form data.
47
+ * @param items An array of form items
48
+ */
49
+ private writeItems;
50
+ /**
51
+ * Get services by their names.
52
+ * @param serviceName The name of the service
53
+ * @param additionalServiceNames Additional names of services
54
+ * @returns The requested services
55
+ */
56
+ getServices<T = IServiceInitialize<E, F> & IServiceControl & IServiceCommand, R = T & Array<T>>(serviceName: string, ...additionalServiceNames: string[]): R;
57
+ /**
58
+ * Registers form items by triggering the REGISTER_ITEMS event.
59
+ */
60
+ private registerFormItems;
61
+ /**
62
+ * Maps form items to their properties.
63
+ */
64
+ private mapFormItems;
65
+ /**
66
+ * Initializes the services defined in the form data.
67
+ */
68
+ private initializeServices;
69
+ /**
70
+ * Executes the readers defined in the form data.
71
+ */
72
+ private runReaders;
73
+ /**
74
+ * Executes the starters defined in the form data.
75
+ */
76
+ private runStarters;
77
+ /**
78
+ * Creates a deep copy of the form data for the initial state.
79
+ */
80
+ private deepCopyForm;
81
+ /**
82
+ * Starts the form controller by executing all necessary steps to initialize the form.
83
+ * @returns A promise that resolves when the form is fully initialized.
84
+ */
85
+ start(): Promise<Form<E, F>>;
22
86
  }
@@ -1,150 +1,238 @@
1
1
  "use strict";
2
+ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
3
+ if (kind === "m") throw new TypeError("Private method is not writable");
4
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
5
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
6
+ return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
7
+ };
8
+ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
9
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
10
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
11
+ return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
12
+ };
13
+ var _FormController_serviceMap, _FormController_itemsMap, _FormController_form, _FormController_initialForm, _FormController_initialEntity;
2
14
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.BaseFormController = void 0;
4
- const util_1 = require("@punica/util");
15
+ exports.FormController = void 0;
5
16
  const common_1 = require("@punica/common");
6
17
  const __1 = require("..");
7
- class BaseFormController extends common_1.BaseListener {
8
- constructor(entity) {
18
+ /**
19
+ * Controller for managing a form and its associated services.
20
+ */
21
+ class FormController extends common_1.BaseListener {
22
+ //#region constructor
23
+ /**
24
+ * Private constructor to prevent direct instantiation.
25
+ */
26
+ constructor() {
9
27
  super();
10
- this.getItem = (property) => {
11
- const { items, itemsMap } = this._formData;
12
- const itemIndex = itemsMap[property];
13
- if (!Number.isInteger(itemIndex)) {
14
- return null;
15
- }
16
- return items[itemIndex];
17
- };
18
- this.writeItems = async (items) => {
19
- for await (const item of items) {
20
- const { itemsMap, items } = this._formData;
21
- const { property } = item;
22
- const index = itemsMap[property];
23
- items[index] = item;
24
- }
25
- };
26
- this._entity = entity;
27
- this.updateValue = this.updateValue.bind(this);
28
- this.getInitialEntity = this.getInitialEntity.bind(this);
29
- this.updatePropertyValue = this.updatePropertyValue.bind(this);
30
- this.getStoreItem = this.getStoreItem.bind(this);
31
- this.setStoreItem = this.setStoreItem.bind(this);
28
+ _FormController_serviceMap.set(this, void 0); // Map to store services by their names
29
+ _FormController_itemsMap.set(this, void 0); // Map to store form items by their properties
30
+ _FormController_form.set(this, void 0); // Current form data
31
+ _FormController_initialForm.set(this, void 0); // Initial deep copy of the form data
32
+ _FormController_initialEntity.set(this, void 0); // Initial entity for the form
33
+ __classPrivateFieldSet(this, _FormController_serviceMap, {}, "f");
34
+ __classPrivateFieldSet(this, _FormController_itemsMap, {}, "f");
32
35
  }
33
- fireEvent(eventType, data) {
34
- this.trigger(eventType, data);
35
- }
36
- start(reader, formData = null) {
37
- return new Promise(async (resolve) => {
38
- let updateMaps = false;
39
- this.fireEvent(__1.FormEvents.REGISTER_ITEMS, __1.FormItemRegister.getInstance().getKeys());
40
- if (formData) {
41
- this._formData = formData;
42
- }
43
- else {
44
- this._formData = await reader.read(this._entity);
45
- }
46
- if (this._formData.initializer) {
47
- this._formData = await this._formData.initializer(this._formData, this._entity);
48
- this._formData.itemsMap = {};
49
- updateMaps = true;
50
- }
51
- let index = 0;
52
- for await (const item of this._formData.items) {
53
- item.updateValue = this.updateValue;
54
- item.updatePropertyValue = this.updatePropertyValue;
55
- item.getInitialEntity = this.getInitialEntity;
56
- item.getStoreItem = this.getStoreItem;
57
- item.setStoreItem = this.setStoreItem;
58
- if (updateMaps) {
59
- this._formData.itemsMap[item.property] = index++;
60
- }
61
- }
62
- resolve(this._formData);
36
+ /**
37
+ * Static method to initialize the FormController with form data.
38
+ * @param form The initial form data
39
+ */
40
+ static fromForm(form) {
41
+ return new Promise((resolve) => {
42
+ const instance = new FormController();
43
+ __classPrivateFieldSet(instance, _FormController_form, form, "f");
44
+ __classPrivateFieldSet(instance, _FormController_initialEntity, {}, "f");
45
+ resolve(instance);
63
46
  });
64
47
  }
65
- getEntity() {
48
+ /**
49
+ * Static method to initialize the FormController with an entity.
50
+ * @param entity The entity for the form
51
+ */
52
+ static fromEntity(entity) {
66
53
  return new Promise(async (resolve) => {
67
- const { items } = this._formData;
68
- const entity = { ...this._entity };
69
- for await (const item of items) {
70
- const { property, value, propertyPath } = item;
71
- let writePath = property;
72
- if (propertyPath) {
73
- writePath = propertyPath;
74
- }
75
- (0, util_1.WriteToPropertyPath)(entity, writePath, value);
76
- }
77
- resolve(entity);
54
+ const instance = new FormController();
55
+ const initialReader = (0, __1.createInitialReader)();
56
+ __classPrivateFieldSet(instance, _FormController_initialEntity, entity, "f");
57
+ __classPrivateFieldSet(instance, _FormController_form, {
58
+ itemsMap: null,
59
+ items: null,
60
+ services: null,
61
+ starters: null,
62
+ readers: null
63
+ }, "f");
64
+ await initialReader.read(__classPrivateFieldGet(instance, _FormController_initialEntity, "f"), __classPrivateFieldGet(instance, _FormController_form, "f"));
65
+ resolve(instance);
78
66
  });
79
67
  }
80
- validate() {
81
- return new Promise(async (resolve) => {
82
- const { items } = this._formData;
83
- this._hasError = false;
84
- for await (const item of items) {
85
- const { errorChecking, hidden } = item;
86
- if (errorChecking && !hidden) {
87
- const { error, errorMessage } = await errorChecking({
88
- formItem: item,
89
- entity: this._entity,
90
- getItem: this.getItem,
91
- store: { get: this.getStoreItem, set: this.setStoreItem }
92
- });
93
- if (error) {
94
- this._hasError = true;
95
- }
96
- item.error = error;
97
- item.errorMessage = errorMessage;
98
- }
68
+ //#endregion
69
+ /**
70
+ * Trigger a form event.
71
+ * @param eventType The type of the event
72
+ * @param data Data associated with the event
73
+ */
74
+ fireEvent(eventType, data) {
75
+ this.trigger(eventType, data);
76
+ }
77
+ /**
78
+ * Create a command item for a form item.
79
+ * @param item The form item
80
+ * @returns A promise that resolves to a CommandItem
81
+ */
82
+ async createCommandItem(item) {
83
+ var _a;
84
+ let itemCustomCommand = {};
85
+ for await (const service of (_a = __classPrivateFieldGet(this, _FormController_form, "f")) === null || _a === void 0 ? void 0 : _a.services) {
86
+ const { addCustomFeaturesForCommandItem } = service;
87
+ if (addCustomFeaturesForCommandItem) {
88
+ const command = addCustomFeaturesForCommandItem();
89
+ itemCustomCommand = { ...itemCustomCommand, ...command };
99
90
  }
100
- this.fireEvent(__1.FormEvents.UPDATE, this._formData);
101
- resolve(this._hasError);
102
- });
91
+ }
92
+ return {
93
+ formItem: item,
94
+ initialEntity: __classPrivateFieldGet(this, _FormController_initialEntity, "f"),
95
+ getItem: this.getItem.bind(this),
96
+ writeItems: this.writeItems.bind(this),
97
+ ...itemCustomCommand
98
+ };
103
99
  }
104
- reset() {
105
- this._formData.items.forEach((formItem) => {
106
- formItem.value = formItem.defaultValue;
107
- });
108
- this.fireEvent(__1.FormEvents.RESET, null);
109
- this.fireEvent(__1.FormEvents.UPDATE, this._formData);
110
- }
111
- updatePropertyValue(property, key, value) {
112
- const item = this.getItem(property);
113
- item[key] = value;
114
- this.writeItems([item]);
115
- this.fireEvent(__1.FormEvents.UPDATE_PROPERTY_VALUE, {
116
- property,
117
- key,
118
- value
119
- });
120
- this.fireEvent(__1.FormEvents.UPDATE, this._formData);
100
+ /**
101
+ * Create a command service for the form.
102
+ * @returns A CommandService for the form
103
+ */
104
+ createCommandService() {
105
+ return {
106
+ initialForm: __classPrivateFieldGet(this, _FormController_initialForm, "f"),
107
+ initialEntity: __classPrivateFieldGet(this, _FormController_initialEntity, "f"),
108
+ form: __classPrivateFieldGet(this, _FormController_form, "f"),
109
+ itemsMap: __classPrivateFieldGet(this, _FormController_itemsMap, "f"),
110
+ getItem: this.getItem.bind(this),
111
+ writeItems: this.writeItems.bind(this),
112
+ fireEvent: this.fireEvent.bind(this),
113
+ createCommandItem: this.createCommandItem.bind(this)
114
+ };
121
115
  }
122
- submitControl() {
123
- return new Promise(async (resolve) => {
124
- const { items } = this._formData;
125
- for await (const item of items) {
126
- const { submit } = item;
127
- if (submit) {
128
- await submit({
129
- formItem: item,
130
- entity: this._entity,
131
- getItem: this.getItem,
132
- store: { get: this.getStoreItem, set: this.setStoreItem }
133
- });
116
+ /**
117
+ * Get a form item by its property key.
118
+ * @param property The property key of the form item
119
+ * @returns The form item corresponding to the property key
120
+ */
121
+ getItem(property) {
122
+ const { items, itemsMap } = __classPrivateFieldGet(this, _FormController_form, "f");
123
+ const itemIndex = itemsMap[property];
124
+ if (!Number.isInteger(itemIndex)) {
125
+ return null;
126
+ }
127
+ return items[itemIndex];
128
+ }
129
+ /**
130
+ * Write an array of form items to the form data.
131
+ * @param items An array of form items
132
+ */
133
+ async writeItems(items) {
134
+ for await (const item of items) {
135
+ const { itemsMap, items } = __classPrivateFieldGet(this, _FormController_form, "f");
136
+ const { property } = item;
137
+ const index = itemsMap[property];
138
+ items[index] = item;
139
+ }
140
+ }
141
+ /**
142
+ * Get services by their names.
143
+ * @param serviceName The name of the service
144
+ * @param additionalServiceNames Additional names of services
145
+ * @returns The requested services
146
+ */
147
+ getServices(serviceName, ...additionalServiceNames) {
148
+ if (Array.isArray(additionalServiceNames) &&
149
+ additionalServiceNames.length > 0) {
150
+ const services = [
151
+ __classPrivateFieldGet(this, _FormController_serviceMap, "f")[serviceName],
152
+ ...additionalServiceNames.map((name) => __classPrivateFieldGet(this, _FormController_serviceMap, "f")[name])
153
+ ];
154
+ return services;
155
+ }
156
+ return __classPrivateFieldGet(this, _FormController_serviceMap, "f")[serviceName];
157
+ }
158
+ /**
159
+ * Registers form items by triggering the REGISTER_ITEMS event.
160
+ */
161
+ registerFormItems() {
162
+ this.fireEvent('REGISTER_ITEMS', __1.FormItemRegister.getInstance().getItemKeys());
163
+ }
164
+ /**
165
+ * Maps form items to their properties.
166
+ */
167
+ mapFormItems() {
168
+ let index = 0;
169
+ __classPrivateFieldSet(this, _FormController_itemsMap, {}, "f");
170
+ for (const item of __classPrivateFieldGet(this, _FormController_form, "f").items) {
171
+ __classPrivateFieldGet(this, _FormController_itemsMap, "f")[item.property] = index++;
172
+ }
173
+ }
174
+ /**
175
+ * Initializes the services defined in the form data.
176
+ */
177
+ async initializeServices() {
178
+ if (__classPrivateFieldGet(this, _FormController_form, "f").services) {
179
+ for await (const service of __classPrivateFieldGet(this, _FormController_form, "f").services) {
180
+ const command = this.createCommandService();
181
+ const serviceControl = service;
182
+ __classPrivateFieldGet(this, _FormController_serviceMap, "f")[service.name] = service;
183
+ if (serviceControl.initialize) {
184
+ serviceControl.initialize(command);
134
185
  }
135
186
  }
136
- resolve(true);
137
- });
187
+ }
188
+ }
189
+ /**
190
+ * Executes the readers defined in the form data.
191
+ */
192
+ async runReaders() {
193
+ if (__classPrivateFieldGet(this, _FormController_form, "f").readers) {
194
+ for await (const reader of __classPrivateFieldGet(this, _FormController_form, "f").readers) {
195
+ reader.read(__classPrivateFieldGet(this, _FormController_initialEntity, "f"), __classPrivateFieldGet(this, _FormController_form, "f"));
196
+ }
197
+ }
138
198
  }
139
- getInitialEntity() {
140
- return this._entity;
199
+ /**
200
+ * Executes the starters defined in the form data.
201
+ */
202
+ async runStarters() {
203
+ if (__classPrivateFieldGet(this, _FormController_form, "f").starters) {
204
+ for await (const starter of __classPrivateFieldGet(this, _FormController_form, "f").starters) {
205
+ __classPrivateFieldSet(this, _FormController_form, await starter.run(__classPrivateFieldGet(this, _FormController_form, "f"), __classPrivateFieldGet(this, _FormController_initialEntity, "f")), "f");
206
+ }
207
+ }
141
208
  }
142
- getStoreItem(key) {
143
- return this._formData.store.get(key);
209
+ /**
210
+ * Creates a deep copy of the form data for the initial state.
211
+ */
212
+ deepCopyForm() {
213
+ __classPrivateFieldSet(this, _FormController_initialForm, (0, __1.deepCopy)(__classPrivateFieldGet(this, _FormController_form, "f")), "f");
144
214
  }
145
- setStoreItem(key, value) {
146
- this._formData.store.set(key, value);
215
+ /**
216
+ * Starts the form controller by executing all necessary steps to initialize the form.
217
+ * @returns A promise that resolves when the form is fully initialized.
218
+ */
219
+ async start() {
220
+ try {
221
+ this.registerFormItems();
222
+ this.mapFormItems();
223
+ await this.initializeServices();
224
+ await this.runReaders();
225
+ await this.runStarters();
226
+ this.mapFormItems();
227
+ this.deepCopyForm();
228
+ // Trigger an update event after the form is fully initialized
229
+ return __classPrivateFieldGet(this, _FormController_form, "f");
230
+ }
231
+ catch (error) {
232
+ console.error('Error starting the form controller:', error);
233
+ throw error;
234
+ }
147
235
  }
148
236
  }
149
- exports.BaseFormController = BaseFormController;
150
- //# sourceMappingURL=index.js.map
237
+ exports.FormController = FormController;
238
+ _FormController_serviceMap = new WeakMap(), _FormController_itemsMap = new WeakMap(), _FormController_form = new WeakMap(), _FormController_initialForm = new WeakMap(), _FormController_initialEntity = new WeakMap();
@@ -0,0 +1,9 @@
1
+ import { FormItem, IReader } from '..';
2
+ /**
3
+ * Constant for identifying form readers decorator.
4
+ */
5
+ export declare const DECORATOR_READERS = "form-readers";
6
+ /**
7
+ * Decorator for adding readers to a form class.
8
+ */
9
+ export declare const Readers: <E, F extends FormItem<E>>(data: IReader<E, F>[]) => ClassDecorator;
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Readers = exports.DECORATOR_READERS = void 0;
4
+ const __1 = require("..");
5
+ /**
6
+ * Constant for identifying form readers decorator.
7
+ */
8
+ exports.DECORATOR_READERS = 'form-readers';
9
+ /**
10
+ * Decorator for adding readers to a form class.
11
+ */
12
+ const Readers = (data) => {
13
+ return (0, __1.defineFormProperty)(exports.DECORATOR_READERS)(data);
14
+ };
15
+ exports.Readers = Readers;
@@ -0,0 +1,9 @@
1
+ import { IService } from '..';
2
+ /**
3
+ * Constant for identifying form services decorator.
4
+ */
5
+ export declare const DECORATOR_SERVICES = "form-services";
6
+ /**
7
+ * Decorator for adding services to a form class.
8
+ */
9
+ export declare const Services: (data: Array<IService>) => ClassDecorator;
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Services = exports.DECORATOR_SERVICES = void 0;
4
+ const __1 = require("..");
5
+ /**
6
+ * Constant for identifying form services decorator.
7
+ */
8
+ exports.DECORATOR_SERVICES = 'form-services';
9
+ /**
10
+ * Decorator for adding services to a form class.
11
+ */
12
+ const Services = (data) => {
13
+ return (0, __1.defineFormProperty)(exports.DECORATOR_SERVICES)(data);
14
+ };
15
+ exports.Services = Services;
@@ -0,0 +1,9 @@
1
+ import { FormItem, IStarter } from '..';
2
+ /**
3
+ * Constant for identifying form starters decorator.
4
+ */
5
+ export declare const DECORATOR_STARTERS = "form-starters";
6
+ /**
7
+ * Decorator for adding starters to a form class.
8
+ */
9
+ export declare const Starters: <E, F extends FormItem<E>>(data: IStarter<E, F>[]) => ClassDecorator;
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Starters = exports.DECORATOR_STARTERS = void 0;
4
+ const __1 = require("..");
5
+ /**
6
+ * Constant for identifying form starters decorator.
7
+ */
8
+ exports.DECORATOR_STARTERS = 'form-starters';
9
+ /**
10
+ * Decorator for adding starters to a form class.
11
+ */
12
+ const Starters = (data) => {
13
+ return (0, __1.defineFormProperty)(exports.DECORATOR_STARTERS)(data);
14
+ };
15
+ exports.Starters = Starters;
@@ -0,0 +1,3 @@
1
+ export * from './Readers';
2
+ export * from './Starters';
3
+ export * from './Services';
@@ -14,11 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
14
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
- __exportStar(require("./Actions"), exports);
18
- __exportStar(require("./Chapter"), exports);
19
- __exportStar(require("./Description"), exports);
20
- __exportStar(require("./Initializer"), exports);
21
- __exportStar(require("./Name"), exports);
22
- __exportStar(require("./Title"), exports);
23
- __exportStar(require("./Store"), exports);
24
- //# sourceMappingURL=index.js.map
17
+ __exportStar(require("./Readers"), exports);
18
+ __exportStar(require("./Starters"), exports);
19
+ __exportStar(require("./Services"), exports);
@@ -0,0 +1,9 @@
1
+ import { IPropertyDecorator } from '@punica/common';
2
+ /**
3
+ * Defines a form item with the specified type and renderer.
4
+ * @param {string} type - Type of the form item.
5
+ * @param {Function} renderer - Renderer function for the form item.
6
+ * @returns {IPropertyDecorator<T>} - Decorator function.
7
+ */
8
+ declare const defineFormItem: <T>(type: string, renderer: (props: T) => any) => IPropertyDecorator<T>;
9
+ export default defineFormItem;
@@ -1,14 +1,21 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.defineFormItem = void 0;
4
- const __1 = require("../../..");
3
+ const __1 = require("..");
4
+ /**
5
+ * Defines a form item with the specified type and renderer.
6
+ * @param {string} type - Type of the form item.
7
+ * @param {Function} renderer - Renderer function for the form item.
8
+ * @returns {IPropertyDecorator<T>} - Decorator function.
9
+ */
5
10
  const defineFormItem = (type, renderer) => {
11
+ // Register the form item type and renderer
6
12
  __1.FormItemRegister.getInstance().register(type, renderer);
7
13
  return (data) => {
8
14
  return (target, propertyKey) => {
9
15
  const allMetadata = Reflect.getMetadata(type, target) || {};
10
16
  allMetadata[propertyKey] = allMetadata[propertyKey] || {};
11
17
  allMetadata[propertyKey]['type'] = type;
18
+ // Copy properties from data to metadata
12
19
  for (const key of Reflect.ownKeys(data)) {
13
20
  allMetadata[propertyKey][key] = data[key];
14
21
  }
@@ -16,5 +23,4 @@ const defineFormItem = (type, renderer) => {
16
23
  };
17
24
  };
18
25
  };
19
- exports.defineFormItem = defineFormItem;
20
- //# sourceMappingURL=index.js.map
26
+ exports.default = defineFormItem;
@@ -0,0 +1,8 @@
1
+ import { IPropertyDecorator } from '@punica/common';
2
+ /**
3
+ * Defines a form item with the specified type and renderer.
4
+ * @param {string} type - Type of the form item.
5
+ * @returns {IPropertyDecorator<T>} - Decorator function.
6
+ */
7
+ declare const defineFormItemProperty: <T>(type: string) => IPropertyDecorator<T>;
8
+ export default defineFormItemProperty;
@@ -0,0 +1,21 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ /**
4
+ * Defines a form item with the specified type and renderer.
5
+ * @param {string} type - Type of the form item.
6
+ * @returns {IPropertyDecorator<T>} - Decorator function.
7
+ */
8
+ const defineFormItemProperty = (type) => {
9
+ return (data) => {
10
+ return (target, propertyKey) => {
11
+ const allMetadata = Reflect.getMetadata(type, target) || {};
12
+ allMetadata[propertyKey] = allMetadata[propertyKey] || {};
13
+ // Copy properties from data to metadata
14
+ for (const key of Reflect.ownKeys(data)) {
15
+ allMetadata[propertyKey][key] = data[key];
16
+ }
17
+ Reflect.defineMetadata(type, allMetadata, target);
18
+ };
19
+ };
20
+ };
21
+ exports.default = defineFormItemProperty;