@ngneers/controls 0.0.1-pre5 → 0.0.1-pre7

package/types/ngneers-controls-splitter.d.ts

@@ -29,6 +29,8 @@ type SplitterPanelSize<U extends SplitterPanelSizeUnit = SplitterPanelSizeUnit>
 type SplitterPanelSizeLimitUnit = 'px' | '%';
 type SplitterPanelSizeLimit<U extends SplitterPanelSizeLimitUnit = SplitterPanelSizeLimitUnit> = `${number}${U}`;
 type SplitterLayout = 'horizontal' | 'vertical';
+/** Splitter supports adjacent and proportional resize modes (not push). */
+type SplitterResizeMode = 'adjacent' | 'proportional';
 type _SplitterState = {
     layout?: SplitterLayout;
     panelOrder?: string[] | null;
@@ -39,15 +41,6 @@ type SplitterState = _SplitterState & {
     [key: string]: unknown;
 };
 
-type ExpandedSplitterPanelSize = {
-    value: number;
-    unit: SplitterPanelSizeUnit;
-};
-type ExpandedSplitterPanelSizeLimit = {
-    value: number;
-    unit: SplitterPanelSizeLimitUnit;
-};
-
 /**
  * Type interface for the {@link SplitterCalculator} interface.
  */
@@ -109,36 +102,6 @@ interface SplitterCalculator {
      */
     moveDivider(index: number, pxDelta: number): void;
 }
-type SplitterFractionFactors = {
-    /**
-     * The number of fraction units per pixel.
-     * This is used to convert pixel values to fraction values.
-     */
-    frPerPx: number;
-    /**
-     * The number of pixels per fraction unit.
-     * This is used to convert fraction values to pixel values.
-     */
-    pxPerFr: number;
-};
-type SplitterDragContextPanel = {
-    /**
-     * A reference to the panel component.
-     */
-    panel: NgnSplitterPanel;
-    /**
-     * The starting size of the panel at the beginning of the drag operation.
-     */
-    startSize: ExpandedSplitterPanelSize;
-    /**
-     * The minimum size limit of the panel.
-     */
-    minSize: ExpandedSplitterPanelSizeLimit;
-    /**
-     * The maximum size limit of the panel.
-     */
-    maxSize: ExpandedSplitterPanelSizeLimit;
-};
 /**
  * Represents the context of a drag operation in the splitter.
  */
@@ -155,17 +118,10 @@ type SplitterDragContext = {
      * The starting position of the pointer when the drag operation started, in pixels.
      */
     startPosition: number;
-    /**
-     * An array of panels involved in the drag operation.
-     */
-    panels: SplitterDragContextPanel[];
-    /**
-     * The fraction factors used for calculating sizes during the drag operation.
-     */
-    fractionFactors: SplitterFractionFactors;
 };
 /**
  * Default implementation of the {@link SplitterCalculator} interface.
+ * Delegates all resize math to the generic {@link ResizeEngine}.
  */
 declare class DefaultSplitterCalculator implements SplitterCalculator {
     protected readonly panels: Signal<readonly NgnSplitterPanel[]>;
@@ -173,6 +129,7 @@ declare class DefaultSplitterCalculator implements SplitterCalculator {
     protected readonly panelOrder: Signal<readonly string[] | null | undefined>;
     protected readonly layout: Signal<SplitterLayout>;
     protected readonly splitterSize: Signal<number>;
+    private readonly _engine;
     constructor(splitter: NgnSplitter);
     readonly orderedPanels: Signal<readonly NgnSplitterPanel[]>;
     readonly gridTemplateSizes: Signal<string>;
@@ -181,21 +138,17 @@ declare class DefaultSplitterCalculator implements SplitterCalculator {
     readonly maxSize: Signal<string>;
     readonly dragContext: _angular_core.WritableSignal<SplitterDragContext | null>;
     protected readonly dividerSizes: Signal<number[]>;
-    protected readonly totalDividerSize: Signal<number>;
-    protected readonly totalPanelSizes: Signal<{
-        px: number;
-        fr: number;
-    }>;
     startDrag(index: number, event: PointerEvent): void;
     drag(index: number, event: PointerEvent): void;
     endDrag(index: number, event: PointerEvent, isCancel: boolean): void;
     moveDivider(index: number, pxDelta: number): void;
+    /**
+     * Ensures all panels respect their min/max size constraints.
+     * Delegates to the underlying {@link ResizeEngine}.
+     */
     ensureMinMaxSizes(): void;
-    private createContextPanel;
-    private getCurrentFractionFactors;
-    private setPanelSize;
-    private isPanelSizeCalculated;
-    private applyDividerDelta;
+    /** @internal — used by tests to seed panel sizes into the engine. */
+    setPanelSize(panel: NgnSplitterPanel, size: string): void;
 }
 
 /**
@@ -250,10 +203,14 @@ declare class NgnSplitter extends NgnBase<'splitter'> implements OnDestroy {
             addCondition: string;
             removeCondition: string;
             clear: string;
+            apply: string;
+            cancel: string;
             matchModeLabel: string;
             match: {
                 all: string;
                 any: string;
+                and: string;
+                or: string;
             };
             selected: string;
             conditions: string;
@@ -322,6 +279,19 @@ declare class NgnSplitter extends NgnBase<'splitter'> implements OnDestroy {
      * @default `DefaultSplitterCalculator`
      */
     readonly calculatorType: _angular_core.InputSignal<SplitterCalculatorType>;
+    /**
+     * The resize distribution mode for the splitter.
+     * - `'adjacent'` (default): Only the panels adjacent to the divider are resized.
+     * - `'proportional'`: The deficit is distributed proportionally across all panels on the other side.
+     */
+    readonly resizeMode: _angular_core.InputSignal<SplitterResizeMode>;
+    /**
+     * Whether to lock affected panels to fixed `px` values after a resize completes.
+     * When `true`, panels whose size changed are converted from their original unit to `px`.
+     * When `false`, panels keep their original units (`fr`, `px`).
+     * @default false
+     */
+    readonly lockSizes: _angular_core.InputSignal<boolean>;
     /**
      * The step size for moving the dividers using the keyboard.
      * This can be a pixel value (e.g., '5px') or a percentage value (e.g., '5%').
@@ -378,7 +348,7 @@ declare class NgnSplitter extends NgnBase<'splitter'> implements OnDestroy {
     private applyFromState;
     private getStepInPx;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgnSplitter, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnSplitter, "ngn-splitter", never, { "layout": { "alias": "layout"; "required": true; "isSignal": true; }; "panelOrder": { "alias": "panelOrder"; "required": false; "isSignal": true; }; "stateStorage": { "alias": "stateStorage"; "required": false; "isSignal": true; }; "stateKey": { "alias": "stateKey"; "required": false; "isSignal": true; }; "stateData": { "alias": "stateData"; "required": false; "isSignal": true; }; "calculatorType": { "alias": "calculatorType"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; }, { "layout": "layoutChange"; "panelOrder": "panelOrderChange"; "stateSaving": "stateSaving"; "stateLoading": "stateLoading"; }, ["panels"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnSplitter, "ngn-splitter", never, { "layout": { "alias": "layout"; "required": true; "isSignal": true; }; "panelOrder": { "alias": "panelOrder"; "required": false; "isSignal": true; }; "stateStorage": { "alias": "stateStorage"; "required": false; "isSignal": true; }; "stateKey": { "alias": "stateKey"; "required": false; "isSignal": true; }; "stateData": { "alias": "stateData"; "required": false; "isSignal": true; }; "calculatorType": { "alias": "calculatorType"; "required": false; "isSignal": true; }; "resizeMode": { "alias": "resizeMode"; "required": false; "isSignal": true; }; "lockSizes": { "alias": "lockSizes"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; }, { "layout": "layoutChange"; "panelOrder": "panelOrderChange"; "stateSaving": "stateSaving"; "stateLoading": "stateLoading"; }, ["panels"], ["*"], true, never>;
 }
 
 declare class NgnSplitterModule {
@@ -388,4 +358,4 @@ declare class NgnSplitterModule {
 }
 
 export { DefaultSplitterCalculator, NgnSplitter, NgnSplitterModule, NgnSplitterPanel };
-export type { SplitterCalculator, SplitterCalculatorType, SplitterDragContext, SplitterLayout, SplitterPanelSize, SplitterPanelSizeLimit, SplitterPanelSizeLimitUnit, SplitterPanelSizeUnit, SplitterState, SplitterStateData };
+export type { SplitterCalculator, SplitterCalculatorType, SplitterDragContext, SplitterLayout, SplitterPanelSize, SplitterPanelSizeLimit, SplitterPanelSizeLimitUnit, SplitterPanelSizeUnit, SplitterResizeMode, SplitterState, SplitterStateData };