@wawjs/ngx-bos 22.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.
Files changed (90) hide show
  1. package/AGENTS.md +23 -0
  2. package/README.md +105 -0
  3. package/RELEASES.md +21 -0
  4. package/ai/architecture.md +40 -0
  5. package/ai/code-style.md +33 -0
  6. package/ai/decisions/2026-06-02-browser-only-bos-spa.md +16 -0
  7. package/ai/decisions/2026-06-02-package-boundary.md +22 -0
  8. package/ai/decisions/2026-06-02-version-start.md +12 -0
  9. package/ai/decisions/index.md +7 -0
  10. package/ai/onboarding.md +19 -0
  11. package/ai/task-execution.md +35 -0
  12. package/ai/tooling.md +33 -0
  13. package/fesm2022/wawjs-ngx-bos.mjs +2287 -0
  14. package/fesm2022/wawjs-ngx-bos.mjs.map +1 -0
  15. package/package.json +38 -0
  16. package/src/feature/file/file.component.html +123 -0
  17. package/src/feature/file/file.component.scss +209 -0
  18. package/src/feature/file/file.component.ts +220 -0
  19. package/src/feature/file/file.const.ts +20 -0
  20. package/src/feature/file/file.interface.ts +12 -0
  21. package/src/feature/file/file.service.ts +34 -0
  22. package/src/feature/file/file.util.ts +72 -0
  23. package/src/feature/file/index.ts +9 -0
  24. package/src/feature/file/pages/files/files.component.html +12 -0
  25. package/src/feature/file/pages/files/files.component.ts +117 -0
  26. package/src/feature/file/pages/files/files.routes.ts +9 -0
  27. package/src/feature/file/selectors/file/file-selector.component.html +11 -0
  28. package/src/feature/file/selectors/file/file-selector.component.ts +27 -0
  29. package/src/feature/user/LICENSE +21 -0
  30. package/src/feature/user/README.md +1 -0
  31. package/src/feature/user/components/user-preview/user-preview.component.html +7 -0
  32. package/src/feature/user/components/user-preview/user-preview.component.scss +27 -0
  33. package/src/feature/user/components/user-preview/user-preview.component.ts +16 -0
  34. package/src/feature/user/guards/admins.guard.ts +22 -0
  35. package/src/feature/user/guards/authenticated.guard.ts +14 -0
  36. package/src/feature/user/guards/guest.guard.ts +14 -0
  37. package/src/feature/user/module.json +1 -0
  38. package/src/feature/user/pages/clients/clients.component.html +8 -0
  39. package/src/feature/user/pages/clients/clients.component.scss +0 -0
  40. package/src/feature/user/pages/clients/clients.component.ts +45 -0
  41. package/src/feature/user/pages/clients/clients.routes.ts +9 -0
  42. package/src/feature/user/pages/users/users.component.html +18 -0
  43. package/src/feature/user/pages/users/users.component.ts +57 -0
  44. package/src/feature/user/pages/users/users.routes.ts +9 -0
  45. package/src/feature/user/selectors/user/user-selector.component.html +6 -0
  46. package/src/feature/user/selectors/user/user-selector.component.scss +0 -0
  47. package/src/feature/user/selectors/user/user-selector.component.ts +17 -0
  48. package/src/feature/user/user.const.ts +13 -0
  49. package/src/feature/user/user.form.ts +54 -0
  50. package/src/feature/user/user.interface.ts +12 -0
  51. package/src/feature/user/user.service.ts +176 -0
  52. package/src/form-components/ace/ace.component.html +14 -0
  53. package/src/form-components/ace/ace.component.scss +22 -0
  54. package/src/form-components/ace/ace.component.ts +210 -0
  55. package/src/form-components/ace/ace.form.ts +184 -0
  56. package/src/form-components/button/button.component.html +15 -0
  57. package/src/form-components/button/button.component.ts +31 -0
  58. package/src/form-components/button/button.form.ts +74 -0
  59. package/src/form-components/file/file.component.html +73 -0
  60. package/src/form-components/file/file.component.ts +91 -0
  61. package/src/form-components/file/file.form.ts +112 -0
  62. package/src/form-components/form-bridge.interface.ts +27 -0
  63. package/src/form-components/index.ts +85 -0
  64. package/src/form-components/input/input.component.html +16 -0
  65. package/src/form-components/input/input.component.ts +31 -0
  66. package/src/form-components/input/input.form.ts +117 -0
  67. package/src/form-components/select/select.component.html +24 -0
  68. package/src/form-components/select/select.component.ts +31 -0
  69. package/src/form-components/select/select.form.ts +88 -0
  70. package/src/form-components/tinymce/tinymce.component.html +13 -0
  71. package/src/form-components/tinymce/tinymce.component.scss +19 -0
  72. package/src/form-components/tinymce/tinymce.component.ts +221 -0
  73. package/src/form-components/tinymce/tinymce.form.ts +191 -0
  74. package/src/icons/spider/LICENSE +21 -0
  75. package/src/icons/spider/README.md +127 -0
  76. package/src/icons/spider/index.ts +1 -0
  77. package/src/icons/spider/module.json +4 -0
  78. package/src/icons/spider/spider.component.html +115 -0
  79. package/src/icons/spider/spider.component.scss +20 -0
  80. package/src/icons/spider/spider.component.ts +20 -0
  81. package/src/ngx-bos.config.ts +55 -0
  82. package/src/pages/form/form.component.html +9 -0
  83. package/src/pages/form/form.component.ts +86 -0
  84. package/src/pages/form/form.routes.ts +9 -0
  85. package/src/pages/forms/forms.component.html +9 -0
  86. package/src/pages/forms/forms.component.ts +77 -0
  87. package/src/pages/forms/forms.routes.ts +9 -0
  88. package/src/pipes/phone.pipe.ts +17 -0
  89. package/src/public-api.ts +36 -0
  90. package/types/wawjs-ngx-bos.d.ts +332 -0
@@ -0,0 +1,332 @@
1
+ import * as _wawjs_ngx_crud from '@wawjs/ngx-crud';
2
+ import { CrudDocument, CrudService, CrudComponent } from '@wawjs/ngx-crud';
3
+ import { FormComponentInterface, FormInterface, FormcomponentService, Formcomponent, FormService, Form } from '@wawjs/ngx-form';
4
+ import * as rxjs from 'rxjs';
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';
8
+ import * as _wawjs_ngx_bos from '@wawjs/ngx-bos';
9
+ import { SelectValue } from '@wawjs/ngx-ui';
10
+ import { Routes, CanActivateFn } from '@angular/router';
11
+
12
+ interface NgxBosConfig {
13
+ appId?: string;
14
+ url?: string;
15
+ cdnUrl?: string;
16
+ roles?: string[];
17
+ userFields?: string[];
18
+ userForm?: FormComponentInterface[];
19
+ signPath?: string;
20
+ profilePath?: string;
21
+ defaultUserThumb?: string;
22
+ }
23
+ declare const DEFAULT_NGX_BOS_CONFIG: Required<NgxBosConfig>;
24
+ declare const NGX_BOS_CONFIG: InjectionToken<Required<NgxBosConfig>>;
25
+ declare function ngxBosProvide(config?: NgxBosConfig): EnvironmentProviders;
26
+ declare const provideNgxBos: typeof ngxBosProvide;
27
+
28
+ type FileMode = 'single-image' | 'single-file' | 'multi-image' | 'multi-file';
29
+ type FileView = 'dropzone' | 'list' | 'thumb-only';
30
+ declare class FileComponent {
31
+ /** UI props */
32
+ readonly label: _angular_core.InputSignal<string>;
33
+ readonly placeholder: _angular_core.InputSignal<string>;
34
+ readonly disabled: _angular_core.InputSignal<boolean>;
35
+ readonly clearable: _angular_core.InputSignal<boolean>;
36
+ readonly accept: _angular_core.InputSignal<string>;
37
+ readonly preview: _angular_core.InputSignal<boolean>;
38
+ /** Behaviour */
39
+ readonly mode: _angular_core.InputSignal<FileMode>;
40
+ readonly view: _angular_core.InputSignal<FileView>;
41
+ /** Optional crop box (for image modes) */
42
+ readonly cropWidth: _angular_core.InputSignal<number | null>;
43
+ readonly cropHeight: _angular_core.InputSignal<number | null>;
44
+ /** Custom templates */
45
+ readonly t_item: _angular_core.InputSignal<TemplateRef<unknown> | undefined>;
46
+ readonly t_empty: _angular_core.InputSignal<TemplateRef<unknown> | undefined>;
47
+ /** Back-end routing */
48
+ readonly container: _angular_core.InputSignal<string>;
49
+ readonly name: _angular_core.InputSignal<string>;
50
+ /** Separate models for each mode */
51
+ readonly wImage: _angular_core.ModelSignal<string | null>;
52
+ readonly wFile: _angular_core.ModelSignal<string | null>;
53
+ readonly wImages: _angular_core.ModelSignal<string[]>;
54
+ readonly wFiles: _angular_core.ModelSignal<string[]>;
55
+ private readonly _modal;
56
+ private readonly _fs;
57
+ readonly isDisabled: _angular_core.Signal<boolean>;
58
+ readonly isMultiple: _angular_core.Signal<boolean>;
59
+ readonly isImageMode: _angular_core.Signal<boolean>;
60
+ /** Normalized list of URLs for rendering */
61
+ readonly files: _angular_core.Signal<string[]>;
62
+ triggerPick(input: HTMLInputElement): void;
63
+ isImage(src: string): boolean;
64
+ onPicked(input: HTMLInputElement): Promise<void>;
65
+ removeAt(index: number): void;
66
+ clear(): void;
67
+ private _applyNewUrls;
68
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FileComponent, never>;
69
+ 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>;
70
+ }
71
+
72
+ interface File$1 extends CrudDocument<File$1> {
73
+ name: string;
74
+ description: string;
75
+ url?: string;
76
+ }
77
+ interface ImageResizeBounds {
78
+ width: number;
79
+ height: number;
80
+ }
81
+
82
+ declare class FileService extends CrudService<File$1> {
83
+ private readonly _http;
84
+ private readonly _bosConfig;
85
+ constructor();
86
+ /**
87
+ * Upload base64 (data URL) to backend with optional container/name.
88
+ * Returns a URL string from the API.
89
+ */
90
+ uploadBase64(dataUrl: string, container?: string, name?: string): Promise<string>;
91
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FileService, never>;
92
+ static ɵprov: _angular_core.ɵɵInjectableDeclaration<FileService>;
93
+ }
94
+
95
+ /**
96
+ * Read a File as base64 data URL.
97
+ */
98
+ declare function fileToDataUrl(file: File): Promise<string>;
99
+ /**
100
+ * Resize an image file so it fits within given bounds, preserving aspect ratio.
101
+ * Returns a base64 data URL (or the original if no resize is needed / not image).
102
+ */
103
+ declare function resizeImageToBounds(file: File, bounds: ImageResizeBounds): Promise<string>;
104
+
105
+ declare const fileDefaults: {
106
+ label: string;
107
+ placeholder: string;
108
+ disabled: boolean;
109
+ clearable: boolean;
110
+ accept: string;
111
+ preview: boolean;
112
+ mode: string;
113
+ view: string;
114
+ cropWidth: number | null;
115
+ cropHeight: number | null;
116
+ container: string;
117
+ name: string;
118
+ };
119
+
120
+ declare class FileSelectorComponent {
121
+ private _files;
122
+ private _translate;
123
+ readonly wModel: _angular_core.InputSignal<string | null>;
124
+ readonly wChange: _angular_core.OutputEmitterRef<string | null>;
125
+ readonly items: Signal<File$1[]>;
126
+ readonly placeholder: _angular_core.WritableSignal<string>;
127
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FileSelectorComponent, never>;
128
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileSelectorComponent, "file-selector", never, { "wModel": { "alias": "wModel"; "required": false; "isSignal": true; }; }, { "wChange": "wChange"; }, never, never, true, never>;
129
+ }
130
+
131
+ declare class FilesComponent {
132
+ private _fileService;
133
+ private _clipboard;
134
+ private _alert;
135
+ private _form;
136
+ private _core;
137
+ columns: string[];
138
+ form: FormInterface;
139
+ config: {
140
+ paginate: (page?: number) => void;
141
+ perPage: number;
142
+ setPerPage: (perPage: number) => void;
143
+ allDocs: boolean;
144
+ create: () => void;
145
+ delete: (doc: File$1) => void;
146
+ };
147
+ rows: File$1[];
148
+ constructor();
149
+ copy(text: string): void;
150
+ setRows(page?: number): void;
151
+ private _page;
152
+ private _preCreate;
153
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilesComponent, never>;
154
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilesComponent, "ng-component", never, {}, {}, never, never, true, never>;
155
+ }
156
+
157
+ declare const filesRoutes: Routes;
158
+
159
+ declare const FORM_COMPONENTS: string[];
160
+ declare const FORM_COMPONENT_FORM: (key: string) => FormInterface;
161
+ /**
162
+ * Central registry: template name → component class.
163
+ * Names must match `component.name` in form schema (e.g. `{ name: 'Input', ... }`)
164
+ * and what the template component passes into FormService.addTemplateComponent().
165
+ */
166
+ declare const FORM_TEMPLATE_COMPONENTS: Record<string, Type<unknown>>;
167
+ declare const provideFormComponents: () => Provider;
168
+
169
+ interface User extends CrudDocument<User> {
170
+ data: Record<string, unknown>;
171
+ is: Record<string, boolean>;
172
+ roles: string[];
173
+ name: string;
174
+ phone: string;
175
+ bio: string;
176
+ email: string;
177
+ thumb: string;
178
+ }
179
+
180
+ declare const NEW_USER: User;
181
+
182
+ declare const createUserFormComponents: (userForm?: FormComponentInterface[]) => {
183
+ formId: string;
184
+ title: string;
185
+ components: FormComponentInterface[];
186
+ };
187
+ declare const userFormComponentsFactory: () => {
188
+ formId: string;
189
+ title: string;
190
+ components: FormComponentInterface[];
191
+ };
192
+
193
+ declare class UserService extends CrudService<User> {
194
+ private readonly _userHttpService;
195
+ private readonly _alertService;
196
+ private readonly _router;
197
+ private readonly _emitterService;
198
+ private readonly _bosConfig;
199
+ readonly url: string;
200
+ roles: string[];
201
+ employees: string[];
202
+ users: _angular_core.WritableSignal<User[]>;
203
+ user: _angular_core.WritableSignal<User>;
204
+ thumb: _angular_core.Signal<string>;
205
+ role(role: string): boolean;
206
+ readonly usersByRole: _angular_core.Signal<Record<string, User[]>>;
207
+ constructor();
208
+ setUser(user: User): void;
209
+ updateMe(): rxjs.Subscription;
210
+ updateMeAfterWhile(): void;
211
+ changePassword(oldPass: string, newPass: string): rxjs.Observable<any>;
212
+ logout(): void;
213
+ updateAdmin(user: User): rxjs.Observable<User>;
214
+ deleteAdmin(user: User): rxjs.Observable<User>;
215
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserService, never>;
216
+ static ɵprov: _angular_core.ɵɵInjectableDeclaration<UserService>;
217
+ }
218
+
219
+ declare const adminsGuard: CanActivateFn;
220
+
221
+ declare const authenticatedGuard: CanActivateFn;
222
+
223
+ declare const guestGuard: CanActivateFn;
224
+
225
+ declare class UserSelectorComponent {
226
+ userService: UserService;
227
+ value: _angular_core.InputSignal<string>;
228
+ onChange: _angular_core.OutputEmitterRef<SelectValue>;
229
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserSelectorComponent, never>;
230
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<UserSelectorComponent, "user-selector", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "onChange": "onChange"; }, never, never, true, never>;
231
+ }
232
+
233
+ declare class UserPreviewComponent {
234
+ userService: UserService;
235
+ protected readonly bosConfig: Required<_wawjs_ngx_bos.NgxBosConfig>;
236
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserPreviewComponent, never>;
237
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<UserPreviewComponent, "user-preview", never, {}, {}, never, never, true, never>;
238
+ }
239
+
240
+ declare class UsersComponent extends CrudComponent<UserService, User, FormInterface> {
241
+ protected configType: 'server' | 'local';
242
+ protected allowUrl(): boolean;
243
+ protected delete(doc: User): Promise<void>;
244
+ private _router;
245
+ userService: UserService;
246
+ readonly roles: string[];
247
+ columns: string[];
248
+ config: _wawjs_ngx_crud.TableConfig<User>;
249
+ constructor();
250
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<UsersComponent, never>;
251
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<UsersComponent, "ng-component", never, {}, {}, never, never, true, never>;
252
+ }
253
+
254
+ declare const usersRoutes: Routes;
255
+
256
+ declare class ClientsComponent extends CrudComponent<UserService, User, FormInterface> {
257
+ /** Use server-side pagination for clients */
258
+ protected configType: 'server' | 'local';
259
+ /** Basic columns for clients table */
260
+ columns: string[];
261
+ /** wtable config built by CrudComponent, aware of server mode */
262
+ config: _wawjs_ngx_crud.TableConfig<User>;
263
+ protected allowUrl(): boolean;
264
+ constructor();
265
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClientsComponent, never>;
266
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClientsComponent, "ng-component", never, {}, {}, never, never, true, never>;
267
+ }
268
+
269
+ declare const clientsRoutes: Routes;
270
+
271
+ declare class FormComponent extends CrudComponent<FormcomponentService, Formcomponent, FormInterface> {
272
+ private _router;
273
+ private _bosConfig;
274
+ readonly formId: string;
275
+ protected configType: 'server' | 'local';
276
+ protected preCreate(doc: Formcomponent): void;
277
+ protected localDocumentsFilter: (doc: Formcomponent) => boolean;
278
+ protected allowUrl(): boolean;
279
+ /** Basic columns for clients table */
280
+ columns: string[];
281
+ /** wtable config built by CrudComponent, aware of server mode */
282
+ config: _wawjs_ngx_crud.TableConfig<Formcomponent>;
283
+ constructor(_formcomponentService: FormcomponentService, _formService: FormService);
284
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FormComponent, never>;
285
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FormComponent, "ng-component", never, {}, {}, never, never, true, never>;
286
+ }
287
+
288
+ declare const formRoutes: Routes;
289
+
290
+ declare class FormsComponent {
291
+ private _formService;
292
+ private _bosConfig;
293
+ columns: string[];
294
+ config: {
295
+ buttons: ({
296
+ icon: string;
297
+ click: (form: Form) => void;
298
+ hrefFunc?: undefined;
299
+ } | {
300
+ icon: string;
301
+ hrefFunc: (form: Form) => string;
302
+ click?: undefined;
303
+ })[];
304
+ };
305
+ documents: _angular_core.WritableSignal<Form[]>;
306
+ constructor();
307
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FormsComponent, never>;
308
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FormsComponent, "ng-component", never, {}, {}, never, never, true, never>;
309
+ }
310
+
311
+ declare const formsRoutes: Routes;
312
+
313
+ declare class SpiderComponent {
314
+ width: _angular_core.InputSignal<string>;
315
+ height: _angular_core.InputSignal<string>;
316
+ start: _angular_core.InputSignal<string>;
317
+ end: _angular_core.InputSignal<string>;
318
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SpiderComponent, never>;
319
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SpiderComponent, "icon-spider", never, { "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "start": { "alias": "start"; "required": false; "isSignal": true; }; "end": { "alias": "end"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
320
+ }
321
+
322
+ declare class PhonePipe implements PipeTransform {
323
+ transform(value: string | null | undefined, country?: CountryCode): string;
324
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<PhonePipe, never>;
325
+ static ɵpipe: _angular_core.ɵɵPipeDeclaration<PhonePipe, "phone", true>;
326
+ }
327
+
328
+ declare const NGX_BOS_VERSION: "22.0.0";
329
+ type NgxBosVersion = typeof NGX_BOS_VERSION;
330
+
331
+ 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 };
332
+ export type { File$1 as File, FileMode, FileView, ImageResizeBounds, NgxBosConfig, NgxBosVersion, User };