@yuuvis/client-framework 3.8.0 → 3.8.1

package/lib/assets/i18n/de.json

@@ -167,8 +167,15 @@
   "yuv.smart-search.combinator.or": "ODER",
   "yuv.smart-search.combinator.as-well-as": "sowie",
   "yuv.smart-search.condition.edit-aria": "Bedingung bearbeiten: {{label}}",
+  "yuv.smart-search.condition.mark-dynamic": "Als auszufüllendes Feld festlegen",
   "yuv.smart-search.condition.remove": "Bedingung entfernen",
+  "yuv.smart-search.condition.unmark-dynamic": "Aus auszufüllenden Feldern entfernen",
+  "yuv.smart-search.condition.unset-value": "Wert fehlt",
   "yuv.smart-search.confirm": "Bestätigen",
+  "yuv.smart-search.mode.empty": "Keine auszufüllenden Felder. Markiere Bedingungen mit dem Blitz-Symbol, um sie hier hinzuzufügen.",
+  "yuv.smart-search.mode.essentials": "Wesentliches",
+  "yuv.smart-search.mode.full": "Vollständige Suche",
+  "yuv.smart-search.mode.label": "Suchmodus",
   "yuv.smart-search.date-preset.this-month": "Dieser Monat",
   "yuv.smart-search.date-preset.this-week": "Diese Woche",
   "yuv.smart-search.date-preset.this-year": "Dieses Jahr",

package/lib/assets/i18n/en.json

@@ -167,8 +167,15 @@
   "yuv.smart-search.combinator.or": "OR",
   "yuv.smart-search.combinator.as-well-as": "as well as",
   "yuv.smart-search.condition.edit-aria": "Edit condition: {{label}}",
+  "yuv.smart-search.condition.mark-dynamic": "Make this a fill-out field",
   "yuv.smart-search.condition.remove": "Remove condition",
+  "yuv.smart-search.condition.unmark-dynamic": "Remove from fill-out fields",
+  "yuv.smart-search.condition.unset-value": "value missing",
   "yuv.smart-search.confirm": "Confirm",
+  "yuv.smart-search.mode.empty": "No fill-out fields. Mark conditions with the bolt icon to add them here.",
+  "yuv.smart-search.mode.essentials": "Essentials",
+  "yuv.smart-search.mode.full": "Full Form",
+  "yuv.smart-search.mode.label": "Search mode",
   "yuv.smart-search.date-preset.this-month": "This month",
   "yuv.smart-search.date-preset.this-week": "This week",
   "yuv.smart-search.date-preset.this-year": "This year",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuuvis/client-framework",
-  "version": "3.8.0",
+  "version": "3.8.1",
   "author": "OPTIMAL SYSTEMS GmbH <npm@optimal-systems.de>",
   "license": "MIT",
   "peerDependencies": {
@@ -8,16 +8,16 @@
     "@angular/common": "^21.2.9",
     "@angular/core": "^21.2.9",
     "angular-gridster2": "^21.0.1",
-    "@yuuvis/client-core": "^3.8.0",
-    "@yuuvis/client-shell-core": "^3.8.0",
-    "@yuuvis/client-components": "^3.8.0",
+    "@yuuvis/client-core": "^3.8.1",
+    "@yuuvis/client-shell-core": "^3.8.1",
+    "@yuuvis/client-components": "^3.8.1",
     "ng-dynamic-component": "^10.8.2",
     "modern-normalize": "^3.0.1"
   },
   "dependencies": {
     "@angular/material": "^21.2.7",
     "@ngrx/signals": "^21.1.0",
-    "@yuuvis/material": "^3.8.0",
+    "@yuuvis/material": "^3.8.1",
     "@yuuvis/media-viewer": "^3.0.4",
     "angular-split": "^20.0.0",
     "vis-network": "^10.0.2",

package/types/yuuvis-client-framework-smart-search.d.ts

@@ -1,8 +1,8 @@
-import * as _yuuvis_client_core from '@yuuvis/client-core';
-import { GenericObjectType, ObjectTypeField } from '@yuuvis/client-core';
-import * as _yuuvis_client_framework_smart_search from '@yuuvis/client-framework/smart-search';
 import * as _angular_core from '@angular/core';
 import { FormControl } from '@angular/forms';
+import * as _yuuvis_client_core from '@yuuvis/client-core';
+import { ObjectTypeField, GenericObjectType } from '@yuuvis/client-core';
+import * as _yuuvis_client_framework_smart_search from '@yuuvis/client-framework/smart-search';
 import { MatAutocomplete, MatAutocompleteTrigger, MatAutocompleteSelectedEvent } from '@angular/material/autocomplete';
 import { RendererDirectiveInput } from '@yuuvis/client-framework/renderer';
 
@@ -27,6 +27,13 @@ interface FieldCondition {
     value: string | string[];
     /** Full human-readable label for the chip (`"Name like foo"`). */
     conditionLabel: string;
+    /**
+     * Marked by the user as a *dynamic* condition: it is surfaced in the generated
+     * fill-out form (see form mode) so its value can be supplied/overridden at run time
+     * without rebuilding the query. Purely a builder annotation — it does not affect the
+     * emitted query on its own.
+     */
+    dynamic?: boolean;
 }
 /**
  * A parenthesized sub-expression with its own AND/OR combinator. Groups can
@@ -117,6 +124,26 @@ interface SmartSearchState {
     fulltext?: FulltextSearch;
 }
 
+/**
+ * A single row of the generated fill-out form: the dynamic condition it edits, its
+ * resolved value-editor field definition (or `null` to fall back to a plain text input)
+ * and the `FormControl` bound to the value widget.
+ */
+interface DynamicFormField {
+    condition: FieldCondition;
+    def: ObjectTypeField | null;
+    control: FormControl;
+}
+/**
+ * A block's worth of dynamic form rows. The generated fill-out form mirrors the builder's
+ * block layout: each block contributes a muted header listing its target types, followed by
+ * the dynamic conditions ({@link DynamicFormField}s) collected from anywhere within that block.
+ * Blocks with no dynamic conditions are omitted.
+ */
+interface DynamicFormBlock {
+    block: SearchBlock;
+    fields: DynamicFormField[];
+}
 /**
  * State + mutators for SmartSearch, shared between the host component and the
  * recursive `SmartSearchGroupComponent`. Provided at the host component level
@@ -160,6 +187,25 @@ declare class SmartSearchEditController {
     inputTerm: _angular_core.WritableSignal<string>;
     /** The whole-object full-text search unit (independent of the condition blocks). */
     fulltext: _angular_core.WritableSignal<FulltextSearch>;
+    /** Whether the dynamic-conditions feature is enabled (mirrors the host `supportDynamicConditions` input). */
+    supportDynamic: _angular_core.WritableSignal<boolean>;
+    /**
+     * Form mode: replace the builder with a generated form of the user-marked dynamic
+     * conditions. View state only — the template ({@link blocks}) is never mutated; the
+     * form's values are overlaid onto the dynamic conditions to drive {@link cmisQuery},
+     * so the template stays reusable.
+     */
+    formMode: _angular_core.WritableSignal<boolean>;
+    /** The dynamic conditions surfaced as form rows; rebuilt on each {@link enterFormMode}. */
+    formFields: _angular_core.WritableSignal<DynamicFormField[]>;
+    /**
+     * The dynamic form rows grouped by their owning block (each carrying a muted header of
+     * target types); rebuilt on each {@link enterFormMode}. Blocks combine with `OR`
+     * ("as well as"), matching the builder.
+     */
+    formBlocks: _angular_core.WritableSignal<DynamicFormBlock[]>;
+    /** Whether any condition is marked dynamic (gates the form-mode toggle). */
+    hasDynamicConditions: _angular_core.Signal<boolean>;
     objectTypes: _angular_core.Signal<GenericObjectType[]>;
     /** Fields for the active top-level block, used by the field-step suggestions. */
     activeBlockFields: _angular_core.Signal<SuggestionItem[]>;
@@ -187,6 +233,20 @@ declare class SmartSearchEditController {
     loadState(state: SmartSearchState): void;
     /** Reset all search state back to its initial empty values. */
     reset(): void;
+    /** Mark or unmark a condition as dynamic (immutably replaces the node in its container). */
+    setConditionDynamic(container: ConditionContainer, condition: FieldCondition, dynamic: boolean): void;
+    /**
+     * Enter form mode: collect every dynamic condition, resolve its value editor and seed a
+     * `FormControl` with its current value. The blocks themselves are left untouched — the
+     * form's edits are overlaid via {@link setFormValue} / {@link cmisQuery}.
+     */
+    enterFormMode(): void;
+    /** Leave form mode and discard the transient form state (the template is untouched). */
+    exitFormMode(): void;
+    /** Toggle form mode (rebuilds the form rows on each entry). */
+    toggleFormMode(): void;
+    /** Record a value entered in the form for a dynamic condition (drives the overlaid {@link cmisQuery}). */
+    setFormValue(condition: FieldCondition, raw: unknown): void;
     /** Set the full-text search term. */
     setFulltextTerm(term: string): void;
     /** Set the full-text search scope (`all` / `metadata` / `content`). */
@@ -244,7 +304,11 @@ declare class SmartSearchEditController {
      * original verbatim at its original index.
      */
     restoreEditingSnapshot(): void;
-    /** Whether the in-progress condition has all parts needed to be committed. */
+    /**
+     * Whether the in-progress condition has all parts needed to be committed. A value
+     * is *not* required: a field + operator with a blank value commits as an unset
+     * placeholder (see {@link isConditionUnset}).
+     */
     isConditionComplete(): boolean;
     /** The operators available for a field's internal type, as autocomplete items. */
     operatorsForField(field: SuggestionItem): SuggestionItem[];
@@ -262,6 +326,20 @@ declare class SmartSearchEditController {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<SmartSearchEditController>;
 }
 
+/**
+ * Operators that carry their own meaning and need no value step: date presets,
+ * the boolean `= true/false` shortcuts, and the null checks (`empty`/`not_empty`).
+ * The build flow commits these immediately instead of advancing to the value editor.
+ */
+declare function isValuelessOperator(operator: string): boolean;
+/**
+ * Whether a condition is an *unset placeholder*: it uses a value-requiring operator
+ * (eq / like / gt / …) but carries no value yet. Such conditions are kept in the tree
+ * — so a saved query can act as a fill-in template — but contribute nothing to the
+ * emitted CMIS query. An empty value is unambiguously "unset" here because null-checks
+ * have their own `empty` / `not_empty` operators (offered on every queryable type).
+ */
+declare function isConditionUnset(cond: FieldCondition): boolean;
 /**
  * Recursively render a condition node. Groups produce parenthesized
  * sub-expressions; empty groups contribute nothing; single-child groups
@@ -350,6 +428,13 @@ declare class SmartSearchComponent {
      * table columns alike.
      */
     skipProperties: _angular_core.InputSignal<string[]>;
+    /**
+     * Enables the **dynamic conditions** feature. When `true`, each committed condition can
+     * be marked dynamic and a form-mode toggle appears that swaps the builder for a generated
+     * fill-out form of those conditions. Off by default — the builder then behaves exactly as
+     * it does without the feature.
+     */
+    supportDynamicConditions: _angular_core.InputSignal<boolean>;
     /**
      * Emits the current CMIS query string whenever the search changes. An empty
      * string is emitted for an empty search (including the initial seed), so
@@ -402,6 +487,18 @@ declare class SmartSearchComponent {
     readonly fulltext: _angular_core.WritableSignal<_yuuvis_client_framework_smart_search.FulltextSearch>;
     readonly objectTypes: _angular_core.Signal<_yuuvis_client_core.GenericObjectType[]>;
     readonly activeBlockFields: _angular_core.Signal<SuggestionItem[]>;
+    readonly formMode: _angular_core.WritableSignal<boolean>;
+    readonly formFields: _angular_core.WritableSignal<DynamicFormField[]>;
+    readonly formBlocks: _angular_core.WritableSignal<DynamicFormBlock[]>;
+    readonly hasDynamicConditions: _angular_core.Signal<boolean>;
+    /** Whether a committed condition is an unset placeholder (drives the chip's "fill me" affordance). */
+    isUnset: typeof isConditionUnset;
+    /**
+     * Whether an operator carries its own meaning and has no value input (`is empty`,
+     * `is not empty`, date presets). Such conditions can't be made dynamic — there is
+     * nothing to fill out in the form.
+     */
+    isValueless: typeof isValuelessOperator;
     /**
      * Selected ids for the type multi-select. Falls back to the `ALL_TYPES`
      * sentinel when no concrete type is picked (empty selection = no restriction).
@@ -430,6 +527,18 @@ declare class SmartSearchComponent {
     loadState(state: SmartSearchState): void;
     /** Clear the whole search: discard all blocks, conditions and the full-text term. */
     clear(): void;
+    /**
+     * Toggle form mode: swap the builder for a generated fill-out form of the user-marked
+     * dynamic conditions. The template is left intact — the form's values are overlaid onto
+     * the query. No-op unless {@link supportDynamicConditions} is set.
+     */
+    toggleFormMode(): void;
+    /** Enter form mode ("Essentials") — generated fill-out form of the dynamic conditions. */
+    enterFormMode(): void;
+    /** Leave form mode ("Full Form") — back to the full builder search. */
+    exitFormMode(): void;
+    /** Mark/unmark a committed condition as dynamic (surfaced in the fill-out form). */
+    toggleDynamic(container: ConditionContainer, condition: FieldCondition): void;
     /**
      * Set the top-level combinator joining the query units (the full-text unit and
      * the type blocks). Kept for state round-tripping; the UI currently always
@@ -530,7 +639,7 @@ declare class SmartSearchComponent {
      */
     getObjectTypeField(item: SuggestionItem | null): ObjectTypeField | null;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SmartSearchComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SmartSearchComponent, "yuv-smart-search", never, { "types": { "alias": "types"; "required": false; "isSignal": true; }; "skipProperties": { "alias": "skipProperties"; "required": false; "isSignal": true; }; }, { "queryChange": "queryChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SmartSearchComponent, "yuv-smart-search", never, { "types": { "alias": "types"; "required": false; "isSignal": true; }; "skipProperties": { "alias": "skipProperties"; "required": false; "isSignal": true; }; "supportDynamicConditions": { "alias": "supportDynamicConditions"; "required": false; "isSignal": true; }; }, { "queryChange": "queryChange"; }, never, never, true, never>;
 }
 
 declare class YuvSmartSearchModule {