@futdevpro/fsm-dynamo 1.16.38 → 1.16.40

package/src/_modules/ngx-models/_models/control-models/forms-new/select-field-new-settings.control-model.ts

@@ -1,46 +1,46 @@
-import { DyFM_Field_Type } from '../../../_enums/field-type.enum';
-import { DyFM_FieldNew_Settings } from './field-new-settings.control-model';
-
-/**
- * Forms v2 (Wave-1A) — select option shape (label/value pár).
- *
- * POJO — szerver-importálható. A `compareWith` függvény NEM itt él, hanem a Params
- * runtime-options-jában (lásd 02-spec section 5.2).
- */
-export interface DyFM_SelectNewOption<T> {
-  label: string;
-  value: T;
-  /** Opcionális per-option disabled flag. */
-  disabled?: boolean;
-  /** Opcionális leírás (pl. tooltip a chip vagy dropdown alatt). */
-  description?: string;
-}
-
-/**
- * Forms v2 (Wave-1A) — single select field settings.
- *
- * Multi-select: `DyFM_MultiselectFieldNew_Settings` (külön osztály).
- *
- * @see _specifications/forms-v2/02-architecture-spec.md (2.2)
- */
-export class DyFM_SelectFieldNew_Settings<T = string> extends DyFM_FieldNew_Settings<T> {
-  override readonly type: DyFM_Field_Type.select = DyFM_Field_Type.select;
-
-  /** Választási opciók listája. */
-  options: DyFM_SelectNewOption<T>[] = [];
-
-  /**
-   * Opcionális null-option (üres-választás) — ha string, label-ként renderelődik.
-   * Ha `false` (vagy hiányzik), nincs null-option.
-   */
-  nullOptionLabel?: string;
-
-  constructor(set: Partial<DyFM_SelectFieldNew_Settings<T>>) {
-    super(set);
-    const { type: _ignoredType, ...rest } = set;
-    Object.assign(this, rest);
-    if (!this.options) {
-      this.options = [];
-    }
-  }
-}
+import { DyFM_Field_Type } from '../../../_enums/field-type.enum';
+import { DyFM_FieldNew_Settings } from './field-new-settings.control-model';
+
+/**
+ * Forms v2 (Wave-1A) — select option shape (label/value pár).
+ *
+ * POJO — szerver-importálható. A `compareWith` függvény NEM itt él, hanem a Params
+ * runtime-options-jában (lásd 02-spec section 5.2).
+ */
+export interface DyFM_SelectNewOption<T> {
+  label: string;
+  value: T;
+  /** Opcionális per-option disabled flag. */
+  disabled?: boolean;
+  /** Opcionális leírás (pl. tooltip a chip vagy dropdown alatt). */
+  description?: string;
+}
+
+/**
+ * Forms v2 (Wave-1A) — single select field settings.
+ *
+ * Multi-select: `DyFM_MultiselectFieldNew_Settings` (külön osztály).
+ *
+ * @see _specifications/forms-v2/02-architecture-spec.md (2.2)
+ */
+export class DyFM_SelectFieldNew_Settings<T = string> extends DyFM_FieldNew_Settings<T> {
+  override readonly type: DyFM_Field_Type.select = DyFM_Field_Type.select;
+
+  /** Választási opciók listája. */
+  options: DyFM_SelectNewOption<T>[] = [];
+
+  /**
+   * Opcionális null-option (üres-választás) — ha string, label-ként renderelődik.
+   * Ha `false` (vagy hiányzik), nincs null-option.
+   */
+  nullOptionLabel?: string;
+
+  constructor(set: Partial<DyFM_SelectFieldNew_Settings<T>>) {
+    super(set);
+    const { type: _ignoredType, ...rest } = set;
+    Object.assign(this, rest);
+    if (!this.options) {
+      this.options = [];
+    }
+  }
+}

package/src/_modules/ngx-models/_models/control-models/forms-new/slider-field-new-settings.control-model.ts

@@ -1,37 +1,37 @@
-import { DyFM_Field_Type } from '../../../_enums/field-type.enum';
-import { DyFM_FieldNew_Settings } from './field-new-settings.control-model';
-
-/**
- * Forms v2 (Wave-2a) — Slider input field settings.
- *
- * Egyértékű csúszka. Render-réteg: natív `<input type="range">`, Tailwind
- * `accent-cyan-500` track/thumb-coloring + sajat value-display. Material-mentes.
- *
- * Multi-handle (start+end) változat: `DyFM_SliderRangeFieldNew_Settings`.
- *
- * @see _specifications/forms-v2/02-architecture-spec.md (2.2)
- */
-export class DyFM_SliderFieldNew_Settings extends DyFM_FieldNew_Settings<number> {
-  override readonly type: DyFM_Field_Type.slider = DyFM_Field_Type.slider;
-
-  /** Alsó határ. Kotelezo (a render `<input type="range">` `min` attr-ja). */
-  min: number = 0;
-
-  /** Felso hatar. Kotelezo. */
-  max: number = 100;
-
-  /** Lepes-koz (default `1`). */
-  step?: number;
-
-  /**
-   * Megmutatja-e a jelenlegi erteket a slider mellett. Default `true`.
-   * Render-szinten a Component egy `<output>` element-en mutatja.
-   */
-  showValueDisplay?: boolean;
-
-  constructor(set: Partial<DyFM_SliderFieldNew_Settings>) {
-    super(set);
-    const { type: _ignoredType, ...rest } = set;
-    Object.assign(this, rest);
-  }
-}
+import { DyFM_Field_Type } from '../../../_enums/field-type.enum';
+import { DyFM_FieldNew_Settings } from './field-new-settings.control-model';
+
+/**
+ * Forms v2 (Wave-2a) — Slider input field settings.
+ *
+ * Egyértékű csúszka. Render-réteg: natív `<input type="range">`, Tailwind
+ * `accent-cyan-500` track/thumb-coloring + sajat value-display. Material-mentes.
+ *
+ * Multi-handle (start+end) változat: `DyFM_SliderRangeFieldNew_Settings`.
+ *
+ * @see _specifications/forms-v2/02-architecture-spec.md (2.2)
+ */
+export class DyFM_SliderFieldNew_Settings extends DyFM_FieldNew_Settings<number> {
+  override readonly type: DyFM_Field_Type.slider = DyFM_Field_Type.slider;
+
+  /** Alsó határ. Kotelezo (a render `<input type="range">` `min` attr-ja). */
+  min: number = 0;
+
+  /** Felso hatar. Kotelezo. */
+  max: number = 100;
+
+  /** Lepes-koz (default `1`). */
+  step?: number;
+
+  /**
+   * Megmutatja-e a jelenlegi erteket a slider mellett. Default `true`.
+   * Render-szinten a Component egy `<output>` element-en mutatja.
+   */
+  showValueDisplay?: boolean;
+
+  constructor(set: Partial<DyFM_SliderFieldNew_Settings>) {
+    super(set);
+    const { type: _ignoredType, ...rest } = set;
+    Object.assign(this, rest);
+  }
+}

package/src/_modules/ngx-models/_models/control-models/forms-new/slider-range-field-new-settings.control-model.ts

@@ -1,45 +1,45 @@
-import { DyFM_Field_Type } from '../../../_enums/field-type.enum';
-import { DyFM_FieldNew_Settings } from './field-new-settings.control-model';
-
-/**
- * Forms v2 (Wave-2a) — slider-range value shape (`{ start: number, end: number }`).
- *
- * Object-shape (NEM tuple) — a JSON-szerializáció szelektivebb, a server-oldali
- * fsm-dynamo modelek POJO-kent kezelhetik.
- */
-export interface DyFM_SliderRangeNewValue {
-  start: number;
-  end: number;
-}
-
-/**
- * Forms v2 (Wave-2a) — Slider-range input field settings.
- *
- * Két szinkronizált natív `<input type="range">`. Cross-field validator a Params
- * szinten (`start <= end` invariant). Material-mentes.
- *
- * @see _specifications/forms-v2/02-architecture-spec.md (2.2)
- */
-export class DyFM_SliderRangeFieldNew_Settings extends DyFM_FieldNew_Settings<DyFM_SliderRangeNewValue> {
-  override readonly type: DyFM_Field_Type.sliderRange = DyFM_Field_Type.sliderRange;
-
-  /** Alsó határ (mindkét slider-ra). */
-  min: number = 0;
-
-  /** Felső határ (mindkét slider-ra). */
-  max: number = 100;
-
-  /** Lépésköz (default `1`). */
-  step?: number;
-
-  /**
-   * Megmutatja-e a `start..end` ertekeket a sliderek mellett. Default `true`.
-   */
-  showValueDisplay?: boolean;
-
-  constructor(set: Partial<DyFM_SliderRangeFieldNew_Settings>) {
-    super(set);
-    const { type: _ignoredType, ...rest } = set;
-    Object.assign(this, rest);
-  }
-}
+import { DyFM_Field_Type } from '../../../_enums/field-type.enum';
+import { DyFM_FieldNew_Settings } from './field-new-settings.control-model';
+
+/**
+ * Forms v2 (Wave-2a) — slider-range value shape (`{ start: number, end: number }`).
+ *
+ * Object-shape (NEM tuple) — a JSON-szerializáció szelektivebb, a server-oldali
+ * fsm-dynamo modelek POJO-kent kezelhetik.
+ */
+export interface DyFM_SliderRangeNewValue {
+  start: number;
+  end: number;
+}
+
+/**
+ * Forms v2 (Wave-2a) — Slider-range input field settings.
+ *
+ * Két szinkronizált natív `<input type="range">`. Cross-field validator a Params
+ * szinten (`start <= end` invariant). Material-mentes.
+ *
+ * @see _specifications/forms-v2/02-architecture-spec.md (2.2)
+ */
+export class DyFM_SliderRangeFieldNew_Settings extends DyFM_FieldNew_Settings<DyFM_SliderRangeNewValue> {
+  override readonly type: DyFM_Field_Type.sliderRange = DyFM_Field_Type.sliderRange;
+
+  /** Alsó határ (mindkét slider-ra). */
+  min: number = 0;
+
+  /** Felső határ (mindkét slider-ra). */
+  max: number = 100;
+
+  /** Lépésköz (default `1`). */
+  step?: number;
+
+  /**
+   * Megmutatja-e a `start..end` ertekeket a sliderek mellett. Default `true`.
+   */
+  showValueDisplay?: boolean;
+
+  constructor(set: Partial<DyFM_SliderRangeFieldNew_Settings>) {
+    super(set);
+    const { type: _ignoredType, ...rest } = set;
+    Object.assign(this, rest);
+  }
+}

package/src/_modules/ngx-models/_models/control-models/forms-new/text-field-new-settings.control-model.ts

@@ -1,30 +1,30 @@
-import { DyFM_Field_Type } from '../../../_enums/field-type.enum';
-import { DyFM_FieldNew_Settings } from './field-new-settings.control-model';
-
-/**
- * Forms v2 (Wave-1A) — text input field settings.
- *
- * Egysoros text. Multi-line szöveghez `DyFM_TextAreaFieldNew_Settings` van.
- *
- * @see _specifications/forms-v2/02-architecture-spec.md (2.2)
- */
-export class DyFM_TextFieldNew_Settings extends DyFM_FieldNew_Settings<string> {
-  override readonly type: DyFM_Field_Type.text = DyFM_Field_Type.text;
-
-  /** Beviteli maszk (pl. `'(00) 000-0000'`). Render-réteg konzumálja. */
-  mask?: string;
-  /** Input prefix-string (pl. `'$'`). */
-  prefix?: string;
-  /** Input suffix-string (pl. `'kg'`). */
-  suffix?: string;
-  /** Karakter-korlát. */
-  maxLength?: number;
-
-  constructor(set: Partial<DyFM_TextFieldNew_Settings>) {
-    super(set);
-    // A `type` mezőt kiszűrjük a Partial-ból, mert a readonly-osztály-mezőt JS-szinten
-    // Object.assign felülírhatná (lásd 05-deep-review C.9).
-    const { type: _ignoredType, ...rest } = set;
-    Object.assign(this, rest);
-  }
-}
+import { DyFM_Field_Type } from '../../../_enums/field-type.enum';
+import { DyFM_FieldNew_Settings } from './field-new-settings.control-model';
+
+/**
+ * Forms v2 (Wave-1A) — text input field settings.
+ *
+ * Egysoros text. Multi-line szöveghez `DyFM_TextAreaFieldNew_Settings` van.
+ *
+ * @see _specifications/forms-v2/02-architecture-spec.md (2.2)
+ */
+export class DyFM_TextFieldNew_Settings extends DyFM_FieldNew_Settings<string> {
+  override readonly type: DyFM_Field_Type.text = DyFM_Field_Type.text;
+
+  /** Beviteli maszk (pl. `'(00) 000-0000'`). Render-réteg konzumálja. */
+  mask?: string;
+  /** Input prefix-string (pl. `'$'`). */
+  prefix?: string;
+  /** Input suffix-string (pl. `'kg'`). */
+  suffix?: string;
+  /** Karakter-korlát. */
+  maxLength?: number;
+
+  constructor(set: Partial<DyFM_TextFieldNew_Settings>) {
+    super(set);
+    // A `type` mezőt kiszűrjük a Partial-ból, mert a readonly-osztály-mezőt JS-szinten
+    // Object.assign felülírhatná (lásd 05-deep-review C.9).
+    const { type: _ignoredType, ...rest } = set;
+    Object.assign(this, rest);
+  }
+}

package/src/_modules/ngx-models/_models/control-models/forms-new/textarea-field-new-settings.control-model.ts

@@ -1,22 +1,22 @@
-import { DyFM_Field_Type } from '../../../_enums/field-type.enum';
-import { DyFM_FieldNew_Settings } from './field-new-settings.control-model';
-
-/**
- * Forms v2 (Wave-1A) — textarea (multi-line text) field settings.
- *
- * @see _specifications/forms-v2/02-architecture-spec.md (2.2)
- */
-export class DyFM_TextAreaFieldNew_Settings extends DyFM_FieldNew_Settings<string> {
-  override readonly type: DyFM_Field_Type.textarea = DyFM_Field_Type.textarea;
-
-  /** Sor-szám hint (default 3). */
-  rows?: number;
-  /** Karakter-korlát. */
-  maxLength?: number;
-
-  constructor(set: Partial<DyFM_TextAreaFieldNew_Settings>) {
-    super(set);
-    const { type: _ignoredType, ...rest } = set;
-    Object.assign(this, rest);
-  }
-}
+import { DyFM_Field_Type } from '../../../_enums/field-type.enum';
+import { DyFM_FieldNew_Settings } from './field-new-settings.control-model';
+
+/**
+ * Forms v2 (Wave-1A) — textarea (multi-line text) field settings.
+ *
+ * @see _specifications/forms-v2/02-architecture-spec.md (2.2)
+ */
+export class DyFM_TextAreaFieldNew_Settings extends DyFM_FieldNew_Settings<string> {
+  override readonly type: DyFM_Field_Type.textarea = DyFM_Field_Type.textarea;
+
+  /** Sor-szám hint (default 3). */
+  rows?: number;
+  /** Karakter-korlát. */
+  maxLength?: number;
+
+  constructor(set: Partial<DyFM_TextAreaFieldNew_Settings>) {
+    super(set);
+    const { type: _ignoredType, ...rest } = set;
+    Object.assign(this, rest);
+  }
+}

package/src/_modules/ngx-models/_models/control-models/frames/frames-pojo.spec.ts

@@ -1,108 +1,108 @@
-import { DyFM_HeaderItem_Type } from '../../../_enums/frames/header-item-type.enum';
-import { DyFM_Header_Position } from '../../../_enums/frames/header-position.enum';
-import { DyFM_SideNavBadge_Color } from '../../../_enums/frames/side-nav-badge-color.enum';
-import { DyFM_HeaderItem_Settings } from './header-item-settings.control-model';
-import { DyFM_MainFrame_Settings } from './main-frame-settings.control-model';
-import { DyFM_SideNavItem_Settings } from './side-nav-item-settings.control-model';
-import { DyFM_SideNav_Settings } from './side-nav-settings.control-model';
-
-describe('CCAP-mirror Wave-1a — Frames POJO', () => {
-
-  describe('DyFM_HeaderItem_Settings', () => {
-    it('| throws if `id` missing', () => {
-      expect(() => new DyFM_HeaderItem_Settings({ type: DyFM_HeaderItem_Type.logo }))
-        .toThrowError(/`id` is required/);
-    });
-
-    it('| throws if `type` missing', () => {
-      expect(() => new DyFM_HeaderItem_Settings({ id: 'logo' } as Partial<DyFM_HeaderItem_Settings>))
-        .toThrowError(/`type` is required/);
-    });
-
-    it('| accepts a Signal-like callable on `signal`', () => {
-      let count = 5;
-      const item = new DyFM_HeaderItem_Settings({
-        id: 'errBadge',
-        type: DyFM_HeaderItem_Type.badgeIndicator,
-        position: DyFM_Header_Position.right,
-        signal: (): number => count,
-      });
-      expect(item.signal!()).toBe(5);
-      count = 7;
-      expect(item.signal!()).toBe(7);
-    });
-  });
-
-  describe('DyFM_MainFrame_Settings', () => {
-    it('| throws if `headerItems` missing', () => {
-      expect(() => new DyFM_MainFrame_Settings()).toThrowError(/`headerItems` is required/);
-    });
-
-    it('| accepts empty headerItems array', () => {
-      const f = new DyFM_MainFrame_Settings({ headerItems: [] });
-      expect(f.headerItems).toEqual([]);
-    });
-
-    it('| accepts header item list with defaults', () => {
-      const f = new DyFM_MainFrame_Settings({
-        headerItems: [
-          new DyFM_HeaderItem_Settings({ id: 'logo', type: DyFM_HeaderItem_Type.logo }),
-        ],
-        headerHeightPx: 44,
-        sideNavWidthPx: 256,
-        sideNavCollapsible: true,
-      });
-      expect(f.headerItems.length).toBe(1);
-      expect(f.headerHeightPx).toBe(44);
-    });
-  });
-
-  describe('DyFM_SideNavItem_Settings', () => {
-    it('| throws if `id` missing', () => {
-      expect(() => new DyFM_SideNavItem_Settings({ label: 'Home' })).toThrowError(/`id` is required/);
-    });
-
-    it('| throws if `label` missing', () => {
-      expect(() => new DyFM_SideNavItem_Settings({ id: 'home' })).toThrowError(/`label` is required/);
-    });
-
-    it('| accepts a Signal-like callable on `badgeSignal`', () => {
-      let count = 0;
-      const item = new DyFM_SideNavItem_Settings({
-        id: 'errors',
-        label: 'Errors',
-        routerLink: '/errors',
-        badgeSignal: (): number => count,
-        badgeColor: DyFM_SideNavBadge_Color.red,
-      });
-      expect(item.badgeSignal!()).toBe(0);
-      count = 3;
-      expect(item.badgeSignal!()).toBe(3);
-      expect(item.badgeColor).toBe(DyFM_SideNavBadge_Color.red);
-    });
-
-    it('| supports nested childItems', () => {
-      const parent = new DyFM_SideNavItem_Settings({
-        id: 'settings',
-        label: 'Settings',
-        childItems: [
-          new DyFM_SideNavItem_Settings({ id: 'profile', label: 'Profile' }),
-          new DyFM_SideNavItem_Settings({ id: 'security', label: 'Security' }),
-        ],
-      });
-      expect(parent.childItems!.length).toBe(2);
-      expect(parent.childItems![0].id).toBe('profile');
-    });
-  });
-
-  describe('DyFM_SideNav_Settings', () => {
-    it('| throws if `items` missing', () => {
-      expect(() => new DyFM_SideNav_Settings()).toThrowError(/`items` is required/);
-    });
-
-    it('| accepts empty items array', () => {
-      const s = new DyFM_SideNav_Settings({ items: [] });
-      expect(s.items).toEqual([]);
-    });
-  });
-});
+import { DyFM_HeaderItem_Type } from '../../../_enums/frames/header-item-type.enum';
+import { DyFM_Header_Position } from '../../../_enums/frames/header-position.enum';
+import { DyFM_SideNavBadge_Color } from '../../../_enums/frames/side-nav-badge-color.enum';
+import { DyFM_HeaderItem_Settings } from './header-item-settings.control-model';
+import { DyFM_MainFrame_Settings } from './main-frame-settings.control-model';
+import { DyFM_SideNavItem_Settings } from './side-nav-item-settings.control-model';
+import { DyFM_SideNav_Settings } from './side-nav-settings.control-model';
+
+describe('CCAP-mirror Wave-1a — Frames POJO', () => {
+
+  describe('DyFM_HeaderItem_Settings', () => {
+    it('| throws if `id` missing', () => {
+      expect(() => new DyFM_HeaderItem_Settings({ type: DyFM_HeaderItem_Type.logo }))
+        .toThrowError(/`id` is required/);
+    });
+
+    it('| throws if `type` missing', () => {
+      expect(() => new DyFM_HeaderItem_Settings({ id: 'logo' } as Partial<DyFM_HeaderItem_Settings>))
+        .toThrowError(/`type` is required/);
+    });
+
+    it('| accepts a Signal-like callable on `signal`', () => {
+      let count = 5;
+      const item = new DyFM_HeaderItem_Settings({
+        id: 'errBadge',
+        type: DyFM_HeaderItem_Type.badgeIndicator,
+        position: DyFM_Header_Position.right,
+        signal: (): number => count,
+      });
+      expect(item.signal!()).toBe(5);
+      count = 7;
+      expect(item.signal!()).toBe(7);
+    });
+  });
+
+  describe('DyFM_MainFrame_Settings', () => {
+    it('| throws if `headerItems` missing', () => {
+      expect(() => new DyFM_MainFrame_Settings()).toThrowError(/`headerItems` is required/);
+    });
+
+    it('| accepts empty headerItems array', () => {
+      const f = new DyFM_MainFrame_Settings({ headerItems: [] });
+      expect(f.headerItems).toEqual([]);
+    });
+
+    it('| accepts header item list with defaults', () => {
+      const f = new DyFM_MainFrame_Settings({
+        headerItems: [
+          new DyFM_HeaderItem_Settings({ id: 'logo', type: DyFM_HeaderItem_Type.logo }),
+        ],
+        headerHeightPx: 44,
+        sideNavWidthPx: 256,
+        sideNavCollapsible: true,
+      });
+      expect(f.headerItems.length).toBe(1);
+      expect(f.headerHeightPx).toBe(44);
+    });
+  });
+
+  describe('DyFM_SideNavItem_Settings', () => {
+    it('| throws if `id` missing', () => {
+      expect(() => new DyFM_SideNavItem_Settings({ label: 'Home' })).toThrowError(/`id` is required/);
+    });
+
+    it('| throws if `label` missing', () => {
+      expect(() => new DyFM_SideNavItem_Settings({ id: 'home' })).toThrowError(/`label` is required/);
+    });
+
+    it('| accepts a Signal-like callable on `badgeSignal`', () => {
+      let count = 0;
+      const item = new DyFM_SideNavItem_Settings({
+        id: 'errors',
+        label: 'Errors',
+        routerLink: '/errors',
+        badgeSignal: (): number => count,
+        badgeColor: DyFM_SideNavBadge_Color.red,
+      });
+      expect(item.badgeSignal!()).toBe(0);
+      count = 3;
+      expect(item.badgeSignal!()).toBe(3);
+      expect(item.badgeColor).toBe(DyFM_SideNavBadge_Color.red);
+    });
+
+    it('| supports nested childItems', () => {
+      const parent = new DyFM_SideNavItem_Settings({
+        id: 'settings',
+        label: 'Settings',
+        childItems: [
+          new DyFM_SideNavItem_Settings({ id: 'profile', label: 'Profile' }),
+          new DyFM_SideNavItem_Settings({ id: 'security', label: 'Security' }),
+        ],
+      });
+      expect(parent.childItems!.length).toBe(2);
+      expect(parent.childItems![0].id).toBe('profile');
+    });
+  });
+
+  describe('DyFM_SideNav_Settings', () => {
+    it('| throws if `items` missing', () => {
+      expect(() => new DyFM_SideNav_Settings()).toThrowError(/`items` is required/);
+    });
+
+    it('| accepts empty items array', () => {
+      const s = new DyFM_SideNav_Settings({ items: [] });
+      expect(s.items).toEqual([]);
+    });
+  });
+});