@ajf/material 18.3.2 → 18.4.1

package/form-builder/form-builder-module.d.ts

@@ -12,32 +12,34 @@ import * as i10 from "./validation-condition-editor-dialog";
 import * as i11 from "./warning-condition-editor-dialog";
 import * as i12 from "./form-builder";
 import * as i13 from "./node-type-filter.pipe";
-import * as i14 from "@ajf/material/node-icon";
-import * as i15 from "@angular/common";
-import * as i16 from "@angular/cdk/drag-drop";
-import * as i17 from "@angular/forms";
-import * as i18 from "@angular/material/autocomplete";
-import * as i19 from "@angular/material/button";
-import * as i20 from "@angular/material/card";
-import * as i21 from "@angular/material/checkbox";
-import * as i22 from "@angular/material/chips";
-import * as i23 from "@angular/material/dialog";
-import * as i24 from "@angular/material/form-field";
-import * as i25 from "@angular/material/icon";
-import * as i26 from "@angular/material/input";
-import * as i27 from "@angular/material/list";
-import * as i28 from "@angular/material/menu";
-import * as i29 from "@angular/material/select";
-import * as i30 from "@angular/material/sidenav";
-import * as i31 from "@angular/material/slider";
-import * as i32 from "@angular/material/table";
-import * as i33 from "@angular/material/toolbar";
-import * as i34 from "@angular/material/tooltip";
-import * as i35 from "@ajf/core/transloco";
-import * as i36 from "@angular/material/expansion";
-import * as i37 from "@angular/material/slide-toggle";
+import * as i14 from "./node-type-groups.pipe";
+import * as i15 from "@ajf/material/node-icon";
+import * as i16 from "@angular/common";
+import * as i17 from "@angular/cdk/drag-drop";
+import * as i18 from "@angular/forms";
+import * as i19 from "@angular/material/autocomplete";
+import * as i20 from "@angular/material/button";
+import * as i21 from "@angular/material/card";
+import * as i22 from "@angular/material/checkbox";
+import * as i23 from "@angular/material/chips";
+import * as i24 from "@angular/material/dialog";
+import * as i25 from "@angular/material/form-field";
+import * as i26 from "@angular/material/icon";
+import * as i27 from "@angular/material/input";
+import * as i28 from "@angular/material/list";
+import * as i29 from "@angular/material/menu";
+import * as i30 from "@angular/material/select";
+import * as i31 from "ngx-mat-select-search";
+import * as i32 from "@angular/material/sidenav";
+import * as i33 from "@angular/material/slider";
+import * as i34 from "@angular/material/table";
+import * as i35 from "@angular/material/toolbar";
+import * as i36 from "@angular/material/tooltip";
+import * as i37 from "@ajf/core/transloco";
+import * as i38 from "@angular/material/expansion";
+import * as i39 from "@angular/material/slide-toggle";
 export declare class AjfFormBuilderModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<AjfFormBuilderModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<AjfFormBuilderModule, [typeof i1.AjfFbBranchLine, typeof i2.AjfFbChoicesOriginEditor, typeof i3.AjfFbChoicesOriginEditorDialog, typeof i4.AjfFbConditionEditor, typeof i5.AjfFbConditionEditorDialog, typeof i6.AjfFbNodeEntry, typeof i7.AjfFbNodeProperties, typeof i8.AjfFbNodeTypeEntry, typeof i9.AjfFbStringIdentifierDialogComponent, typeof i10.AjfFbValidationConditionEditorDialog, typeof i11.AjfFbWarningConditionEditorDialog, typeof i12.AjfFormBuilder, typeof i13.NodeTypeFilterPipe], [typeof i14.AjfNodeIconModule, typeof i15.CommonModule, typeof i16.DragDropModule, typeof i17.FormsModule, typeof i18.MatAutocompleteModule, typeof i19.MatButtonModule, typeof i20.MatCardModule, typeof i21.MatCheckboxModule, typeof i22.MatChipsModule, typeof i23.MatDialogModule, typeof i24.MatFormFieldModule, typeof i25.MatIconModule, typeof i26.MatInputModule, typeof i27.MatListModule, typeof i28.MatMenuModule, typeof i29.MatSelectModule, typeof i30.MatSidenavModule, typeof i31.MatSliderModule, typeof i32.MatTableModule, typeof i33.MatToolbarModule, typeof i34.MatTooltipModule, typeof i17.ReactiveFormsModule, typeof i35.AjfTranslocoModule, typeof i36.MatExpansionModule, typeof i37.MatSlideToggleModule], [typeof i12.AjfFormBuilder]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<AjfFormBuilderModule, [typeof i1.AjfFbBranchLine, typeof i2.AjfFbChoicesOriginEditor, typeof i3.AjfFbChoicesOriginEditorDialog, typeof i4.AjfFbConditionEditor, typeof i5.AjfFbConditionEditorDialog, typeof i6.AjfFbNodeEntry, typeof i7.AjfFbNodeProperties, typeof i8.AjfFbNodeTypeEntry, typeof i9.AjfFbStringIdentifierDialogComponent, typeof i10.AjfFbValidationConditionEditorDialog, typeof i11.AjfFbWarningConditionEditorDialog, typeof i12.AjfFormBuilder, typeof i13.NodeTypeFilterPipe, typeof i14.NodeTypeGroupsPipe], [typeof i15.AjfNodeIconModule, typeof i16.CommonModule, typeof i17.DragDropModule, typeof i18.FormsModule, typeof i19.MatAutocompleteModule, typeof i20.MatButtonModule, typeof i21.MatCardModule, typeof i22.MatCheckboxModule, typeof i23.MatChipsModule, typeof i24.MatDialogModule, typeof i25.MatFormFieldModule, typeof i26.MatIconModule, typeof i27.MatInputModule, typeof i28.MatListModule, typeof i29.MatMenuModule, typeof i30.MatSelectModule, typeof i31.NgxMatSelectSearchModule, typeof i32.MatSidenavModule, typeof i33.MatSliderModule, typeof i34.MatTableModule, typeof i35.MatToolbarModule, typeof i36.MatTooltipModule, typeof i18.ReactiveFormsModule, typeof i37.AjfTranslocoModule, typeof i38.MatExpansionModule, typeof i39.MatSlideToggleModule], [typeof i12.AjfFormBuilder]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<AjfFormBuilderModule>;
 }

package/form-builder/form-builder-service.d.ts

@@ -23,6 +23,19 @@ import { AjfAttachmentsOrigin, AjfChoicesOrigin, AjfField, AjfFieldType, AjfForm
 import { AjfCondition } from '@ajf/core/models';
 import { BehaviorSubject, Observable } from 'rxjs';
 import * as i0 from "@angular/core";
+/**
+ * The categories the entries of the form builder field types palette are
+ * grouped into, in display order. The values are translation keys, rendered as
+ * the header of each group.
+ */
+export declare const AjfFormBuilderNodeTypeCategories: {
+    readonly structure: "Structure";
+    readonly text: "Text";
+    readonly numeric: "Numeric";
+    readonly choices: "Choice fields";
+    readonly dateTime: "Date & time";
+    readonly advanced: "Advanced";
+};
 export interface AjfFormBuilderNodeTypeEntry {
     label: string;
     nodeType: {
@@ -30,6 +43,13 @@ export interface AjfFormBuilderNodeTypeEntry {
         field?: AjfFieldType;
     };
     isSlide?: boolean;
+    /**
+     * The category the entry belongs to, one of
+     * {@link AjfFormBuilderNodeTypeCategories}. Entries sharing a category are
+     * rendered under a common header; entries without a category are rendered
+     * last, with no header.
+     */
+    category?: string;
 }
 export interface AjfFormBuilderNodeEntry {
     node: AjfNode;
@@ -79,6 +99,11 @@ export type AjfContainerNode = AjfSlide | AjfRepeatingSlide | AjfNodeGroup;
 export declare function cleanDefaultValue(value: any, node: AjfField<any>): string | null;
 export declare function flattenNodes(nodes: AjfNode[]): AjfNode[];
 export declare class AjfFormBuilderService {
+    /**
+     * The node types available in the palette, listed by category in display
+     * order. Entries of the same category are rendered under a common header, see
+     * {@link AjfFormBuilderNodeTypeCategories}.
+     */
     private _availableNodeTypes;
     /**
      * Available node types

package/form-builder/form-builder.d.ts

@@ -20,8 +20,9 @@
  *
  */
 import { AjfChoicesOrigin, AjfForm } from '@ajf/core/forms';
+import { BooleanInput } from '@angular/cdk/coercion';
 import { CdkDrag, CdkDragDrop } from '@angular/cdk/drag-drop';
-import { AfterContentInit, AfterViewChecked, ChangeDetectorRef, ElementRef, OnDestroy } from '@angular/core';
+import { AfterContentInit, AfterViewChecked, ChangeDetectorRef, ElementRef, EventEmitter, OnDestroy } from '@angular/core';
 import { MatDialog } from '@angular/material/dialog';
 import { MatSlideToggleChange } from '@angular/material/slide-toggle';
 import { Observable } from 'rxjs';
@@ -35,6 +36,32 @@ export declare class AjfFormBuilder implements AfterViewChecked, AfterContentIni
     private _form;
     get form(): AjfForm | undefined;
     set form(form: AjfForm | undefined);
+    /**
+     * True when the slides of the designer are kept expanded. Slides added later
+     * follow this state as well.
+     * It drives the "expand slides" toggle of the toolbar and can be set by the
+     * host, both one-way (`[expandSlides]="true"`) and two-way
+     * (`[(expandSlides)]="expanded"`).
+     */
+    private _expandSlides;
+    get expandSlides(): boolean;
+    set expandSlides(expandSlides: boolean);
+    /**
+     * Emits whenever the slides expansion state is changed from inside the form
+     * builder, i.e. by the toolbar controls.
+     */
+    readonly expandSlidesChange: EventEmitter<boolean>;
+    /**
+     * When true the form builder fills the whole height of its container: the
+     * field types palette, the designer and the properties panel stretch to the
+     * available height and scroll internally, instead of growing with their
+     * content. Requires the container to have a definite height.
+     */
+    private _fillHeight;
+    get fillHeight(): boolean;
+    set fillHeight(fillHeight: boolean);
+    static ngAcceptInputType_expandSlides: BooleanInput;
+    static ngAcceptInputType_fillHeight: BooleanInput;
     /**
      * Called to set form builder validation errors
      */
@@ -79,11 +106,23 @@ export declare class AjfFormBuilder implements AfterViewChecked, AfterContentIni
     onDrop(event: CdkDragDrop<AjfFormBuilderNodeEntry> | CdkDragDrop<AjfFormBuilderNodeTypeEntry>, content?: boolean): void;
     editChoicesOrigin(choicesOrigin: AjfChoicesOrigin<any>): void;
     editStringIdentifier(): void;
+    /**
+     * Expands all the slides of the designer and keeps the slides added later expanded.
+     */
     expandAll(): void;
+    /**
+     * Collapses all the slides of the designer and keeps the slides added later collapsed.
+     */
     collapseAll(): void;
     expandToggle(evt: MatSlideToggleChange): void;
+    /**
+     * Applies the slides expansion state to the service.
+     * @param expanded True to keep the slides expanded
+     * @param notify True to emit expandSlidesChange when the state changes
+     */
+    private _setSlidesExpanded;
     downloadAsXlsform(): Promise<void>;
     private _setCurrentForm;
     static ɵfac: i0.ɵɵFactoryDeclaration<AjfFormBuilder, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AjfFormBuilder, "ajf-form-builder", never, { "form": { "alias": "form"; "required": false; }; }, { "formBuilderValidation": "formBuilderValidation"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AjfFormBuilder, "ajf-form-builder", never, { "form": { "alias": "form"; "required": false; }; "expandSlides": { "alias": "expandSlides"; "required": false; }; "fillHeight": { "alias": "fillHeight"; "required": false; }; }, { "expandSlidesChange": "expandSlidesChange"; "formBuilderValidation": "formBuilderValidation"; }, never, never, false, never>;
 }

package/form-builder/node-type-groups.pipe.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright (C) Gnucoop soc. coop.
+ *
+ * This file is part of the Advanced JSON forms (ajf).
+ *
+ * Advanced JSON forms (ajf) is free software: you can redistribute it and/or
+ * modify it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the License,
+ * or (at your option) any later version.
+ *
+ * Advanced JSON forms (ajf) is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with Advanced JSON forms (ajf).
+ * If not, see http://www.gnu.org/licenses/.
+ *
+ */
+import { PipeTransform } from '@angular/core';
+import { AjfFormBuilderNodeTypeEntry } from './form-builder-service';
+import * as i0 from "@angular/core";
+/**
+ * A group of node types of the palette, rendered under a common header.
+ */
+export interface AjfFormBuilderNodeTypeGroup {
+    /**
+     * The translation key of the group header. Empty for the group of the entries
+     * that have no category, which is rendered without a header.
+     */
+    category: string;
+    nodeTypes: AjfFormBuilderNodeTypeEntry[];
+}
+/**
+ * Groups the node types of the palette by category, keeping the categories in
+ * the order of their first entry. Applied after the search filter, so that the
+ * categories left without entries produce no header.
+ */
+export declare class NodeTypeGroupsPipe implements PipeTransform {
+    transform(nodeTypes: AjfFormBuilderNodeTypeEntry[]): AjfFormBuilderNodeTypeGroup[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<NodeTypeGroupsPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<NodeTypeGroupsPipe, "nodeTypeGroups", false>;
+}

package/form-builder/public_api.d.ts

@@ -23,3 +23,4 @@ export * from './form-builder-module';
 export * from './form-builder-service';
 export * from './form-builder-utils';
 export * from './form-builder';
+export * from './node-type-groups.pipe';

package/form-builder/string-identifier-dialog.d.ts

@@ -19,30 +19,24 @@
  * If not, see http://www.gnu.org/licenses/.
  *
  */
-import { AjfFormStringIdentifier } from '@ajf/core/forms';
-import { ChangeDetectorRef, OnDestroy } from '@angular/core';
-import { MatAutocompleteSelectedEvent } from '@angular/material/autocomplete';
-import { MatChipInputEvent } from '@angular/material/chips';
-import { MatTableDataSource } from '@angular/material/table';
+import { AjfField } from '@ajf/core/forms';
+import { OnDestroy } from '@angular/core';
+import { FormControl } from '@angular/forms';
 import { Observable } from 'rxjs';
 import { AjfFormBuilderService } from './form-builder-service';
 import * as i0 from "@angular/core";
 export declare class AjfFbStringIdentifierDialogComponent implements OnDestroy {
     private _service;
-    private _cdr;
-    readonly dataSource: MatTableDataSource<AjfFormStringIdentifier>;
-    readonly displayedColumns: string[];
-    readonly fields$: Observable<string[]>;
-    readonly separatorKeysCodes: number[];
+    readonly fields$: Observable<AjfField[]>;
+    readonly filteredFields$: Observable<AjfField[]>;
+    readonly searchFilterCtrl: FormControl<string>;
+    selectedFieldNames: string[];
+    private _fields;
+    private _fieldsSub;
     private _stringIdentifierSub;
-    constructor(_service: AjfFormBuilderService, _cdr: ChangeDetectorRef);
-    addRow(): void;
-    deleteRow(rowIdx: number): void;
-    addValue(row: AjfFormStringIdentifier, evt: MatChipInputEvent, valueInput: HTMLInputElement): void;
-    removeValue(row: AjfFormStringIdentifier, value: string): void;
+    constructor(_service: AjfFormBuilderService);
     ngOnDestroy(): void;
     saveStringIdentifier(): void;
-    selected(row: AjfFormStringIdentifier, evt: MatAutocompleteSelectedEvent): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AjfFbStringIdentifierDialogComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<AjfFbStringIdentifierDialogComponent, "ajf-fb-string-identifier-dialog", never, {}, {}, never, never, false, never>;
 }

package/forms/range-field.d.ts

@@ -26,6 +26,11 @@ import { AjfWarningAlertService } from './warning-alert-service';
 import * as i0 from "@angular/core";
 export declare class AjfRangeFieldComponent extends AjfRange {
     constructor(cdr: ChangeDetectorRef, service: AjfFormRendererService, was: AjfWarningAlertService);
+    /**
+     * True when no value has been selected yet, so that the slider is not
+     * rendered as if the minimum value had been picked.
+     */
+    isEmpty(value: unknown): boolean;
     enumerateStars(): number[];
     static ɵfac: i0.ɵɵFactoryDeclaration<AjfRangeFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<AjfRangeFieldComponent, "ajf-range", never, {}, {}, never, never, false, never>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ajf/material",
-  "version": "18.3.2",
+  "version": "18.4.1",
   "description": "",
   "repository": {
     "type": "git",
@@ -13,7 +13,7 @@
   },
   "homepage": "https://github.com/gnucoop/ajf#readme",
   "peerDependencies": {
-    "@ajf/core": "18.3.2",
+    "@ajf/core": "18.4.1",
     "@angular/animations": "^18.2.13",
     "@angular/cdk": "^18.2.14",
     "@angular/common": "^18.2.13",