@molecule/app-angular 2.0.1 → 3.0.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.
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
|
|
|
3
3
|
Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
|
|
4
4
|
Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
|
|
5
5
|
To change this document, edit the module-level JSDoc in src/index.ts.
|
|
6
|
-
Generated: 2026-10-
|
|
6
|
+
Generated: 2026-10-27T23:35:25.792Z
|
|
7
7
|
-->
|
|
8
8
|
|
|
9
9
|
# @molecule/app-angular
|
|
@@ -301,7 +301,7 @@ Form controller interface.
|
|
|
301
301
|
All form providers must implement this interface.
|
|
302
302
|
|
|
303
303
|
```typescript
|
|
304
|
-
interface FormController<T extends
|
|
304
|
+
interface FormController<T extends FormValuesConstraint<T> = Record<string, unknown>> {
|
|
305
305
|
/**
|
|
306
306
|
* Gets the current form state.
|
|
307
307
|
*/
|
|
@@ -409,7 +409,7 @@ interface FormController<T extends Record<string, unknown> = Record<string, unkn
|
|
|
409
409
|
Form creation options.
|
|
410
410
|
|
|
411
411
|
```typescript
|
|
412
|
-
interface FormOptions<T extends
|
|
412
|
+
interface FormOptions<T extends FormValuesConstraint<T>> {
|
|
413
413
|
/**
|
|
414
414
|
* Default values, captured as the form's clean baseline when the controller
|
|
415
415
|
* is created. Mutating this object afterwards does not change the baseline.
|
|
@@ -1067,6 +1067,31 @@ interface StorageProvider {
|
|
|
1067
1067
|
* Removes multiple values from storage.
|
|
1068
1068
|
*/
|
|
1069
1069
|
removeMany?(keys: string[]): Promise<void>
|
|
1070
|
+
/**
|
|
1071
|
+
* Reads a value synchronously.
|
|
1072
|
+
*
|
|
1073
|
+
* Optional: only a provider backed by a SYNCHRONOUS store (browser
|
|
1074
|
+
* `localStorage`, an in-memory map) can answer without I/O. A render-time
|
|
1075
|
+
* caller reads through `getPreferenceStore()`, which uses this method to see
|
|
1076
|
+
* the persisted value on the first paint; a provider without it is read
|
|
1077
|
+
* through {@link StorageProvider.get} and subscribers update when the value
|
|
1078
|
+
* lands.
|
|
1079
|
+
* @param key - The storage key.
|
|
1080
|
+
* @returns The stored value, or `null` when it is absent, unreadable or corrupt.
|
|
1081
|
+
*/
|
|
1082
|
+
getSync?<T = unknown>(key: string): T | null
|
|
1083
|
+
/**
|
|
1084
|
+
* Subscribes to changes made to a key OUTSIDE this provider instance — for
|
|
1085
|
+
* example another browser tab's `localStorage` write.
|
|
1086
|
+
*
|
|
1087
|
+
* Writes made through the same provider instance do not re-emit here; a
|
|
1088
|
+
* synchronous caller observes them through `getPreferenceStore()`'s own
|
|
1089
|
+
* subscribers.
|
|
1090
|
+
* @param key - The storage key.
|
|
1091
|
+
* @param listener - Called with the new value, or `null` when it was removed.
|
|
1092
|
+
* @returns A function that stops the subscription.
|
|
1093
|
+
*/
|
|
1094
|
+
subscribe?(key: string, listener: (value: unknown) => void): () => void
|
|
1070
1095
|
}
|
|
1071
1096
|
```
|
|
1072
1097
|
|
|
@@ -1605,7 +1630,7 @@ Wrapper around a FormController that provides RxJS observables and
|
|
|
1605
1630
|
synchronous accessors for use in Angular components.
|
|
1606
1631
|
|
|
1607
1632
|
```typescript
|
|
1608
|
-
class MoleculeFormInstance<T extends
|
|
1633
|
+
class MoleculeFormInstance<T extends FormValuesConstraint<T>> {
|
|
1609
1634
|
private stateSubject: BehaviorSubject<FormState<T>>
|
|
1610
1635
|
private unsubscribe: (() => void) | null = null
|
|
1611
1636
|
|
|
@@ -1826,7 +1851,7 @@ export class MoleculeFormsService implements OnDestroy {
|
|
|
1826
1851
|
* @param options - Form configuration including default values and validation mode.
|
|
1827
1852
|
* @returns A new form instance with RxJS observables for reactive state tracking.
|
|
1828
1853
|
*/
|
|
1829
|
-
createForm<T extends
|
|
1854
|
+
createForm<T extends FormValuesConstraint<T>>(
|
|
1830
1855
|
provider: FormProvider,
|
|
1831
1856
|
options: FormOptions<T>,
|
|
1832
1857
|
): MoleculeFormInstance<T> {
|
|
@@ -3032,7 +3057,7 @@ Peer dependencies:
|
|
|
3032
3057
|
- `@angular/core` 22.0.0
|
|
3033
3058
|
- `@molecule/app-auth` ^3.0.0
|
|
3034
3059
|
- `@molecule/app-device` ^1.0.1
|
|
3035
|
-
- `@molecule/app-forms` ^
|
|
3060
|
+
- `@molecule/app-forms` ^2.0.0
|
|
3036
3061
|
- `@molecule/app-http` ^1.0.1
|
|
3037
3062
|
- `@molecule/app-i18n` ^1.0.1
|
|
3038
3063
|
- `@molecule/app-logger` ^1.0.1
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
*/
|
|
6
6
|
import { type OnDestroy } from '@angular/core';
|
|
7
7
|
import { type Observable } from 'rxjs';
|
|
8
|
-
import type { FieldRegistration, FormController, FormOptions, FormProvider, FormState, RegisterOptions } from '@molecule/app-forms';
|
|
8
|
+
import type { FieldRegistration, FormController, FormOptions, FormProvider, FormState, FormValuesConstraint, RegisterOptions } from '@molecule/app-forms';
|
|
9
9
|
import * as i0 from "@angular/core";
|
|
10
10
|
/**
|
|
11
11
|
* Wrapper around a FormController that provides RxJS observables and
|
|
@@ -55,7 +55,7 @@ import * as i0 from "@angular/core";
|
|
|
55
55
|
* }
|
|
56
56
|
* ```
|
|
57
57
|
*/
|
|
58
|
-
export declare class MoleculeFormInstance<T extends
|
|
58
|
+
export declare class MoleculeFormInstance<T extends FormValuesConstraint<T>> {
|
|
59
59
|
private controller;
|
|
60
60
|
private stateSubject;
|
|
61
61
|
private unsubscribe;
|
|
@@ -226,7 +226,7 @@ export declare class MoleculeFormsService implements OnDestroy {
|
|
|
226
226
|
* @param options - Form configuration including default values and validation mode.
|
|
227
227
|
* @returns A new form instance with RxJS observables for reactive state tracking.
|
|
228
228
|
*/
|
|
229
|
-
createForm<T extends
|
|
229
|
+
createForm<T extends FormValuesConstraint<T>>(provider: FormProvider, options: FormOptions<T>): MoleculeFormInstance<T>;
|
|
230
230
|
/**
|
|
231
231
|
* Destroy all managed form instances on service destruction.
|
|
232
232
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"forms.service.d.ts","sourceRoot":"","sources":["../../src/services/forms.service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAA8C,KAAK,UAAU,EAAE,MAAM,MAAM,CAAA;AAElF,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,eAAe,EAChB,MAAM,qBAAqB,CAAA;;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,oBAAoB,CAAC,CAAC,SAAS,
|
|
1
|
+
{"version":3,"file":"forms.service.d.ts","sourceRoot":"","sources":["../../src/services/forms.service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAA8C,KAAK,UAAU,EAAE,MAAM,MAAM,CAAA;AAElF,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,oBAAoB,EACpB,eAAe,EAChB,MAAM,qBAAqB,CAAA;;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,oBAAoB,CAAC,CAAC,SAAS,oBAAoB,CAAC,CAAC,CAAC;IA6BrD,OAAO,CAAC,UAAU;IA5B9B,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,WAAW,CAA4B;IAE/C;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IAEhC;;OAEG;IACH,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;IAE7B;;OAEG;IACH,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;IAE7B;;OAEG;IACH,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;IAElC;;OAEG;IACH,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;gBAEjC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;IA8BjD;;;OAGG;IACH,IAAI,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,CAExB;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,iBAAiB;IAInF;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAI1C;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAKvD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS;IAK3C;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IASxD;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;;;;;OAMG;IACH,YAAY,CACV,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC7C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,GAC3D,CAAC,KAAK,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAIhC;;;;OAIG;IACH,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAI5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,qBAGa,oBAAqB,YAAW,SAAS;IACpD,OAAO,CAAC,SAAS,CAAsD;IAEvE;;;;;;OAMG;IACH,UAAU,CAAC,CAAC,SAAS,oBAAoB,CAAC,CAAC,CAAC,EAC1C,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GACtB,oBAAoB,CAAC,CAAC,CAAC;IAO1B;;OAEG;IACH,WAAW,IAAI,IAAI;yCAvBR,oBAAoB;;CA6BhC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"forms.service.js","sourceRoot":"","sources":["../../src/services/forms.service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAkB,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,GAAG,EAAmB,MAAM,MAAM,CAAA;;
|
|
1
|
+
{"version":3,"file":"forms.service.js","sourceRoot":"","sources":["../../src/services/forms.service.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@molecule/app-angular",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "3.0.0",
|
|
4
4
|
"description": "Angular framework bindings for molecule.dev",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
"@angular/core": "22.0.0",
|
|
25
25
|
"@molecule/app-auth": "^3.0.0",
|
|
26
26
|
"@molecule/app-device": "^1.0.1",
|
|
27
|
-
"@molecule/app-forms": "^
|
|
27
|
+
"@molecule/app-forms": "^2.0.0",
|
|
28
28
|
"@molecule/app-http": "^1.0.1",
|
|
29
29
|
"@molecule/app-i18n": "^1.0.1",
|
|
30
30
|
"@molecule/app-logger": "^1.0.1",
|