@wawjs/ngx-bos 22.0.0 → 22.0.2

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 (56) hide show
  1. package/AGENTS.md +23 -23
  2. package/README.md +105 -105
  3. package/RELEASES.md +41 -15
  4. package/ai/architecture.md +40 -40
  5. package/ai/code-style.md +33 -33
  6. package/ai/decisions/2026-06-02-browser-only-bos-spa.md +16 -16
  7. package/ai/decisions/2026-06-02-package-boundary.md +22 -22
  8. package/ai/decisions/2026-06-02-version-start.md +12 -12
  9. package/ai/decisions/index.md +7 -7
  10. package/ai/onboarding.md +19 -19
  11. package/ai/task-execution.md +35 -35
  12. package/ai/tooling.md +33 -33
  13. package/fesm2022/wawjs-ngx-bos.mjs +138 -98
  14. package/fesm2022/wawjs-ngx-bos.mjs.map +1 -1
  15. package/package.json +1 -1
  16. package/src/feature/file/file.component.html +1 -1
  17. package/src/feature/file/file.component.ts +236 -220
  18. package/src/feature/file/file.interface.ts +12 -12
  19. package/src/feature/file/file.service.ts +35 -34
  20. package/src/feature/file/pages/files/files.component.html +2 -2
  21. package/src/feature/file/pages/files/files.component.ts +117 -117
  22. package/src/feature/file/pages/files/files.routes.ts +9 -9
  23. package/src/feature/file/selectors/file/file-selector.component.html +2 -5
  24. package/src/feature/file/selectors/file/file-selector.component.ts +24 -27
  25. package/src/feature/user/guards/admins.guard.ts +22 -22
  26. package/src/feature/user/guards/authenticated.guard.ts +14 -14
  27. package/src/feature/user/guards/guest.guard.ts +14 -14
  28. package/src/feature/user/pages/clients/clients.component.ts +45 -45
  29. package/src/feature/user/pages/clients/clients.routes.ts +1 -1
  30. package/src/feature/user/pages/users/users.component.html +3 -2
  31. package/src/feature/user/pages/users/users.component.scss +12 -0
  32. package/src/feature/user/pages/users/users.component.ts +78 -45
  33. package/src/feature/user/pages/users/users.routes.ts +1 -1
  34. package/src/feature/user/selectors/user/user-selector.component.ts +17 -17
  35. package/src/feature/user/user.const.ts +3 -3
  36. package/src/feature/user/user.form.ts +54 -54
  37. package/src/feature/user/user.interface.ts +12 -12
  38. package/src/feature/user/user.service.ts +178 -176
  39. package/src/form-components/ace/ace.component.ts +210 -210
  40. package/src/form-components/button/button.component.ts +31 -31
  41. package/src/form-components/file/file.component.ts +91 -91
  42. package/src/form-components/form-bridge.interface.ts +27 -27
  43. package/src/form-components/index.ts +85 -85
  44. package/src/form-components/input/input.component.html +1 -0
  45. package/src/form-components/input/input.component.ts +31 -31
  46. package/src/form-components/select/select.component.html +2 -2
  47. package/src/form-components/select/select.component.ts +31 -31
  48. package/src/form-components/tinymce/tinymce.component.ts +221 -221
  49. package/src/ngx-bos.config.ts +55 -55
  50. package/src/pages/form/form.component.ts +86 -86
  51. package/src/pages/form/form.routes.ts +1 -1
  52. package/src/pages/forms/forms.component.ts +15 -15
  53. package/src/pages/forms/forms.routes.ts +1 -1
  54. package/src/pipes/phone.pipe.ts +17 -17
  55. package/src/public-api.ts +36 -36
  56. package/types/wawjs-ngx-bos.d.ts +13 -9
@@ -1,86 +1,86 @@
1
- import { Component, effect, inject } from '@angular/core';
2
- import { Router } from '@angular/router';
3
- import { TableComponent } from '@wawjs/ngx-ui';
4
- import {
5
- Formcomponent,
6
- FormcomponentService,
7
- formcomponentForm,
8
- FormInterface,
9
- FormService,
10
- } from '@wawjs/ngx-form';
11
- import { CrudComponent } from '@wawjs/ngx-crud';
12
- import { FORM_COMPONENT_FORM } from '../../form-components';
13
- import { NGX_BOS_CONFIG } from '../../ngx-bos.config';
14
-
15
- @Component({
16
- imports: [TableComponent],
17
- templateUrl: './form.component.html',
18
- })
19
- export class FormComponent extends CrudComponent<
20
- FormcomponentService,
21
- Formcomponent,
22
- FormInterface
23
- > {
24
- private _router = inject(Router);
25
- private _bosConfig = inject(NGX_BOS_CONFIG);
26
-
27
- readonly formId = this._router.url.split('form/')[1];
28
-
29
- protected override configType: 'server' | 'local' = 'local';
30
-
31
- protected override preCreate(doc: Formcomponent) {
32
- doc.formId = this.formId;
33
-
34
- doc.appId = this._bosConfig.appId;
35
- }
36
-
37
- protected override localDocumentsFilter = (doc: Formcomponent) => {
38
- return doc.formId === this.formId;
39
- };
40
-
41
- protected override allowUrl() {
42
- return false;
43
- }
44
-
45
- /** Basic columns for clients table */
46
- columns = ['name', 'key'];
47
-
48
- /** wtable config built by CrudComponent, aware of server mode */
49
- config = this.getConfig();
50
-
51
- constructor(
52
- _formcomponentService: FormcomponentService,
53
- _formService: FormService,
54
- ) {
55
- super(formcomponentForm, _formService, _formcomponentService, 'user');
56
-
57
- effect(() => {
58
- if (_formcomponentService.isLoaded()) {
59
- this.setDocuments();
60
- }
61
- });
62
-
63
- this.config.buttons.unshift({
64
- icon: 'settings',
65
- click: (doc: Formcomponent) => {
66
- _formService.modal<Record<string, unknown>>(
67
- FORM_COMPONENT_FORM(doc.name),
68
- {
69
- label: 'Update',
70
- click: async (updated: unknown, close: () => void) => {
71
- close();
72
-
73
- doc.props = {
74
- ...doc.props,
75
- ...(updated as object),
76
- };
77
-
78
- _formcomponentService.update(doc);
79
- },
80
- },
81
- doc.props || {},
82
- );
83
- },
84
- });
85
- }
86
- }
1
+ import { Component, effect, inject } from '@angular/core';
2
+ import { Router } from '@angular/router';
3
+ import { TableComponent } from '@wawjs/ngx-ui';
4
+ import {
5
+ Formcomponent,
6
+ FormcomponentService,
7
+ formcomponentForm,
8
+ FormInterface,
9
+ FormService,
10
+ } from '@wawjs/ngx-form';
11
+ import { CrudComponent } from '@wawjs/ngx-crud';
12
+ import { FORM_COMPONENT_FORM } from '../../form-components';
13
+ import { NGX_BOS_CONFIG } from '../../ngx-bos.config';
14
+
15
+ @Component({
16
+ imports: [TableComponent],
17
+ templateUrl: './form.component.html',
18
+ })
19
+ export class FormComponent extends CrudComponent<
20
+ FormcomponentService,
21
+ Formcomponent,
22
+ FormInterface
23
+ > {
24
+ private _router = inject(Router);
25
+ private _bosConfig = inject(NGX_BOS_CONFIG);
26
+
27
+ readonly formId = this._router.url.split('form/')[1];
28
+
29
+ protected override configType: 'server' | 'local' = 'local';
30
+
31
+ protected override preCreate(doc: Formcomponent) {
32
+ doc.formId = this.formId;
33
+
34
+ doc.appId = this._bosConfig.appId;
35
+ }
36
+
37
+ protected override localDocumentsFilter = (doc: Formcomponent) => {
38
+ return doc.formId === this.formId;
39
+ };
40
+
41
+ protected override allowUrl() {
42
+ return false;
43
+ }
44
+
45
+ /** Basic columns for clients table */
46
+ columns = ['name', 'key'];
47
+
48
+ /** wtable config built by CrudComponent, aware of server mode */
49
+ config = this.getConfig();
50
+
51
+ constructor() {
52
+ const formcomponentService = inject(FormcomponentService);
53
+ const formService = inject(FormService);
54
+
55
+ super(formcomponentForm, formService, formcomponentService, 'user');
56
+
57
+ effect(() => {
58
+ if (formcomponentService.isLoaded()) {
59
+ this.setDocuments();
60
+ }
61
+ });
62
+
63
+ this.config.buttons.unshift({
64
+ icon: 'settings',
65
+ click: (doc: Formcomponent) => {
66
+ formService.modal<Record<string, unknown>>(
67
+ FORM_COMPONENT_FORM(doc.name),
68
+ {
69
+ label: 'Update',
70
+ click: async (updated: unknown, close: () => void) => {
71
+ close();
72
+
73
+ doc.props = {
74
+ ...doc.props,
75
+ ...(updated as object),
76
+ };
77
+
78
+ formcomponentService.update(doc);
79
+ },
80
+ },
81
+ doc.props || {},
82
+ );
83
+ },
84
+ });
85
+ }
86
+ }
@@ -1,6 +1,6 @@
1
1
  import { Routes } from '@angular/router';
2
2
 
3
- export const formRoutes: Routes = [
3
+ export const formRoutes: Routes = [
4
4
  {
5
5
  path: '',
6
6
  loadComponent: () =>
@@ -1,20 +1,20 @@
1
- import {
2
- Component,
3
- effect,
4
- inject,
5
- signal,
6
- } from '@angular/core';
7
- import { Form, formForm, FormService } from '@wawjs/ngx-form';
8
- import { TableComponent } from '@wawjs/ngx-ui';
9
- import { NGX_BOS_CONFIG } from '../../ngx-bos.config';
1
+ import {
2
+ Component,
3
+ effect,
4
+ inject,
5
+ signal,
6
+ } from '@angular/core';
7
+ import { Form, formForm, FormService } from '@wawjs/ngx-form';
8
+ import { TableComponent } from '@wawjs/ngx-ui';
9
+ import { NGX_BOS_CONFIG } from '../../ngx-bos.config';
10
10
 
11
11
  @Component({
12
12
  imports: [TableComponent],
13
13
  templateUrl: './forms.component.html',
14
14
  })
15
15
  export class FormsComponent {
16
- private _formService = inject(FormService);
17
- private _bosConfig = inject(NGX_BOS_CONFIG);
16
+ private _formService = inject(FormService);
17
+ private _bosConfig = inject(NGX_BOS_CONFIG);
18
18
 
19
19
  columns: string[] = ['formId', 'title'];
20
20
 
@@ -36,10 +36,10 @@ export class FormsComponent {
36
36
  if (form._id) {
37
37
  this._formService.update(updated as Form);
38
38
  } else {
39
- this._formService.create({
40
- ...(updated as Form),
41
- appId: this._bosConfig.appId,
42
- });
39
+ this._formService.create({
40
+ ...(updated as Form),
41
+ appId: this._bosConfig.appId,
42
+ });
43
43
  }
44
44
  },
45
45
  },
@@ -1,6 +1,6 @@
1
1
  import { Routes } from '@angular/router';
2
2
 
3
- export const formsRoutes: Routes = [
3
+ export const formsRoutes: Routes = [
4
4
  {
5
5
  path: '',
6
6
  loadComponent: () =>
@@ -1,17 +1,17 @@
1
- import { Pipe, PipeTransform } from '@angular/core';
2
- import { CountryCode, parsePhoneNumberFromString } from 'libphonenumber-js';
3
-
4
- @Pipe({ name: 'phone' })
5
- export class PhonePipe implements PipeTransform {
6
- transform(
7
- value: string | null | undefined,
8
- country: CountryCode = 'US',
9
- ): string {
10
- const raw = String(value ?? '').trim();
11
- if (!raw) return '';
12
-
13
- const phone = parsePhoneNumberFromString(raw, country);
14
-
15
- return phone ? phone.formatInternational() : raw;
16
- }
17
- }
1
+ import { Pipe, PipeTransform } from '@angular/core';
2
+ import { CountryCode, parsePhoneNumberFromString } from 'libphonenumber-js';
3
+
4
+ @Pipe({ name: 'phone' })
5
+ export class PhonePipe implements PipeTransform {
6
+ transform(
7
+ value: string | null | undefined,
8
+ country: CountryCode = 'US',
9
+ ): string {
10
+ const raw = String(value ?? '').trim();
11
+ if (!raw) return '';
12
+
13
+ const phone = parsePhoneNumberFromString(raw, country);
14
+
15
+ return phone ? phone.formatInternational() : raw;
16
+ }
17
+ }
package/src/public-api.ts CHANGED
@@ -1,36 +1,36 @@
1
- /*
2
- * Public API surface for @wawjs/ngx-bos.
3
- *
4
- * Reusable BOS contracts and services will be exported here as code moves from
5
- * the source app into the package.
6
- */
7
-
8
- export const NGX_BOS_VERSION = '22.0.0' as const;
9
-
10
- export type NgxBosVersion = typeof NGX_BOS_VERSION;
11
-
12
- export * from './ngx-bos.config';
13
- export * from './feature/file';
14
- export * from './feature/file/selectors/file/file-selector.component';
15
- export * from './feature/file/pages/files/files.component';
16
- export * from './feature/file/pages/files/files.routes';
17
- export * from './form-components';
18
- export * from './feature/user/user.interface';
19
- export * from './feature/user/user.const';
20
- export * from './feature/user/user.form';
21
- export * from './feature/user/user.service';
22
- export * from './feature/user/guards/admins.guard';
23
- export * from './feature/user/guards/authenticated.guard';
24
- export * from './feature/user/guards/guest.guard';
25
- export * from './feature/user/selectors/user/user-selector.component';
26
- export * from './feature/user/components/user-preview/user-preview.component';
27
- export * from './feature/user/pages/users/users.component';
28
- export * from './feature/user/pages/users/users.routes';
29
- export * from './feature/user/pages/clients/clients.component';
30
- export * from './feature/user/pages/clients/clients.routes';
31
- export * from './pages/form/form.component';
32
- export * from './pages/form/form.routes';
33
- export * from './pages/forms/forms.component';
34
- export * from './pages/forms/forms.routes';
35
- export * from './icons/spider';
36
- export * from './pipes/phone.pipe';
1
+ /*
2
+ * Public API surface for @wawjs/ngx-bos.
3
+ *
4
+ * Reusable BOS contracts and services will be exported here as code moves from
5
+ * the source app into the package.
6
+ */
7
+
8
+ export const NGX_BOS_VERSION = '22.0.2' as const;
9
+
10
+ export type NgxBosVersion = typeof NGX_BOS_VERSION;
11
+
12
+ export * from './ngx-bos.config';
13
+ export * from './feature/file';
14
+ export * from './feature/file/selectors/file/file-selector.component';
15
+ export * from './feature/file/pages/files/files.component';
16
+ export * from './feature/file/pages/files/files.routes';
17
+ export * from './form-components';
18
+ export * from './feature/user/user.interface';
19
+ export * from './feature/user/user.const';
20
+ export * from './feature/user/user.form';
21
+ export * from './feature/user/user.service';
22
+ export * from './feature/user/guards/admins.guard';
23
+ export * from './feature/user/guards/authenticated.guard';
24
+ export * from './feature/user/guards/guest.guard';
25
+ export * from './feature/user/selectors/user/user-selector.component';
26
+ export * from './feature/user/components/user-preview/user-preview.component';
27
+ export * from './feature/user/pages/users/users.component';
28
+ export * from './feature/user/pages/users/users.routes';
29
+ export * from './feature/user/pages/clients/clients.component';
30
+ export * from './feature/user/pages/clients/clients.routes';
31
+ export * from './pages/form/form.component';
32
+ export * from './pages/form/form.routes';
33
+ export * from './pages/forms/forms.component';
34
+ export * from './pages/forms/forms.routes';
35
+ export * from './icons/spider';
36
+ export * from './pipes/phone.pipe';
@@ -1,12 +1,12 @@
1
1
  import * as _wawjs_ngx_crud from '@wawjs/ngx-crud';
2
2
  import { CrudDocument, CrudService, CrudComponent } from '@wawjs/ngx-crud';
3
- import { FormComponentInterface, FormInterface, FormcomponentService, Formcomponent, FormService, Form } from '@wawjs/ngx-form';
3
+ import { FormComponentInterface, FormInterface, FormcomponentService, Formcomponent, Form } from '@wawjs/ngx-form';
4
4
  import * as rxjs from 'rxjs';
5
5
  import * as _angular_core from '@angular/core';
6
- import { InjectionToken, EnvironmentProviders, TemplateRef, Signal, Type, Provider, PipeTransform } from '@angular/core';
7
- import { CountryCode } from 'libphonenumber-js';
6
+ import { InjectionToken, EnvironmentProviders, TemplateRef, Type, Provider, PipeTransform } from '@angular/core';
8
7
  import * as _wawjs_ngx_bos from '@wawjs/ngx-bos';
9
8
  import { SelectValue } from '@wawjs/ngx-ui';
9
+ import { CountryCode } from 'libphonenumber-js';
10
10
  import { Routes, CanActivateFn } from '@angular/router';
11
11
 
12
12
  interface NgxBosConfig {
@@ -54,7 +54,6 @@ declare class FileComponent {
54
54
  readonly wFiles: _angular_core.ModelSignal<string[]>;
55
55
  private readonly _modal;
56
56
  private readonly _fs;
57
- readonly isDisabled: _angular_core.Signal<boolean>;
58
57
  readonly isMultiple: _angular_core.Signal<boolean>;
59
58
  readonly isImageMode: _angular_core.Signal<boolean>;
60
59
  /** Normalized list of URLs for rendering */
@@ -64,6 +63,8 @@ declare class FileComponent {
64
63
  onPicked(input: HTMLInputElement): Promise<void>;
65
64
  removeAt(index: number): void;
66
65
  clear(): void;
66
+ private _cropStageWidth;
67
+ private _cropStageHeight;
67
68
  private _applyNewUrls;
68
69
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<FileComponent, never>;
69
70
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileComponent, "ngx-file", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "preview": { "alias": "preview"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "cropWidth": { "alias": "cropWidth"; "required": false; "isSignal": true; }; "cropHeight": { "alias": "cropHeight"; "required": false; "isSignal": true; }; "t_item": { "alias": "t_item"; "required": false; "isSignal": true; }; "t_empty": { "alias": "t_empty"; "required": false; "isSignal": true; }; "container": { "alias": "container"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "wImage": { "alias": "wImage"; "required": false; "isSignal": true; }; "wFile": { "alias": "wFile"; "required": false; "isSignal": true; }; "wImages": { "alias": "wImages"; "required": false; "isSignal": true; }; "wFiles": { "alias": "wFiles"; "required": false; "isSignal": true; }; }, { "wImage": "wImageChange"; "wFile": "wFileChange"; "wImages": "wImagesChange"; "wFiles": "wFilesChange"; }, never, never, true, never>;
@@ -81,7 +82,6 @@ interface ImageResizeBounds {
81
82
 
82
83
  declare class FileService extends CrudService<File$1> {
83
84
  private readonly _http;
84
- private readonly _bosConfig;
85
85
  constructor();
86
86
  /**
87
87
  * Upload base64 (data URL) to backend with optional container/name.
@@ -122,8 +122,9 @@ declare class FileSelectorComponent {
122
122
  private _translate;
123
123
  readonly wModel: _angular_core.InputSignal<string | null>;
124
124
  readonly wChange: _angular_core.OutputEmitterRef<string | null>;
125
- readonly items: Signal<File$1[]>;
125
+ readonly items: _angular_core.Signal<_wawjs_ngx_bos.File[]>;
126
126
  readonly placeholder: _angular_core.WritableSignal<string>;
127
+ onSelect(value: SelectValue): void;
127
128
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<FileSelectorComponent, never>;
128
129
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileSelectorComponent, "file-selector", never, { "wModel": { "alias": "wModel"; "required": false; "isSignal": true; }; }, { "wChange": "wChange"; }, never, never, true, never>;
129
130
  }
@@ -199,7 +200,7 @@ declare class UserService extends CrudService<User> {
199
200
  readonly url: string;
200
201
  roles: string[];
201
202
  employees: string[];
202
- users: _angular_core.WritableSignal<User[]>;
203
+ readonly users: _angular_core.Signal<User[]>;
203
204
  user: _angular_core.WritableSignal<User>;
204
205
  thumb: _angular_core.Signal<string>;
205
206
  role(role: string): boolean;
@@ -239,14 +240,17 @@ declare class UserPreviewComponent {
239
240
 
240
241
  declare class UsersComponent extends CrudComponent<UserService, User, FormInterface> {
241
242
  protected configType: 'server' | 'local';
243
+ private readonly _formService;
242
244
  protected allowUrl(): boolean;
243
245
  protected delete(doc: User): Promise<void>;
246
+ protected update(doc: User): void;
244
247
  private _router;
245
248
  userService: UserService;
246
249
  readonly roles: string[];
247
250
  columns: string[];
248
251
  config: _wawjs_ngx_crud.TableConfig<User>;
249
252
  constructor();
253
+ updateRole(user: User, role: string, value: boolean): void;
250
254
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<UsersComponent, never>;
251
255
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<UsersComponent, "ng-component", never, {}, {}, never, never, true, never>;
252
256
  }
@@ -280,7 +284,7 @@ declare class FormComponent extends CrudComponent<FormcomponentService, Formcomp
280
284
  columns: string[];
281
285
  /** wtable config built by CrudComponent, aware of server mode */
282
286
  config: _wawjs_ngx_crud.TableConfig<Formcomponent>;
283
- constructor(_formcomponentService: FormcomponentService, _formService: FormService);
287
+ constructor();
284
288
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<FormComponent, never>;
285
289
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<FormComponent, "ng-component", never, {}, {}, never, never, true, never>;
286
290
  }
@@ -325,7 +329,7 @@ declare class PhonePipe implements PipeTransform {
325
329
  static ɵpipe: _angular_core.ɵɵPipeDeclaration<PhonePipe, "phone", true>;
326
330
  }
327
331
 
328
- declare const NGX_BOS_VERSION: "22.0.0";
332
+ declare const NGX_BOS_VERSION: "22.0.2";
329
333
  type NgxBosVersion = typeof NGX_BOS_VERSION;
330
334
 
331
335
  export { ClientsComponent, DEFAULT_NGX_BOS_CONFIG, FORM_COMPONENTS, FORM_COMPONENT_FORM, FORM_TEMPLATE_COMPONENTS, FileComponent, FileSelectorComponent, FileService, FilesComponent, FormComponent, FormsComponent, NEW_USER, NGX_BOS_CONFIG, NGX_BOS_VERSION, PhonePipe, SpiderComponent, UserPreviewComponent, UserSelectorComponent, UserService, UsersComponent, adminsGuard, authenticatedGuard, clientsRoutes, createUserFormComponents, fileDefaults, fileToDataUrl, filesRoutes, formRoutes, formsRoutes, guestGuard, ngxBosProvide, provideFormComponents, provideNgxBos, resizeImageToBounds, userFormComponentsFactory, usersRoutes };