@mintplayer/ng-bootstrap 21.25.0 → 21.27.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mintplayer/ng-bootstrap",
   "private": false,
-  "version": "21.25.0",
+  "version": "21.27.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/MintPlayer/mintplayer-ng-bootstrap",

package/types/mintplayer-ng-bootstrap-color-picker.d.ts

@@ -3,6 +3,50 @@ import { ElementRef } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import * as i1 from '@mintplayer/ng-swiper/observe-size';
 
+interface HslColor {
+    hue: number;
+    saturation: number;
+    luminosity: number;
+}
+
+interface HsvColor {
+    hue: number;
+    saturation: number;
+    value: number;
+}
+
+interface RgbColor {
+    r: number;
+    g: number;
+    b: number;
+}
+
+declare function hex2rgb(hex: string): RgbColor;
+declare function rgb2hex(rgb: RgbColor): string;
+declare function rgb2hsv(rgb: RgbColor): HsvColor;
+declare function hsv2rgb(hsv: HsvColor): RgbColor;
+declare function rgb2hsl(rgb: RgbColor): HslColor;
+declare function hsl2rgb(hsl: HslColor): RgbColor;
+declare function hsv2hsl(hsv: HsvColor): HslColor;
+declare function hsl2hsv(hsl: HslColor): HsvColor;
+declare function hex2hsv(hex: string): HsvColor;
+declare function hsv2hex(hsv: HsvColor): string;
+/** Polar position (cx, cy) on a disc of radius R → HSV (hue, saturation). */
+declare function polar2hs(dx: number, dy: number, radius: number): {
+    hue: number;
+    saturation: number;
+};
+/** Inverse of polar2hs. Hue in degrees, saturation in [0, 1] → (dx, dy) on a disc of given radius. */
+declare function hs2polar(hue: number, saturation: number, radius: number): {
+    dx: number;
+    dy: number;
+};
+
+/**
+ * Hue + Saturation pair shared between the wheel and the strips.
+ * Saturation is HSV-saturation (0..1) — at S=0 the color is white at V=1
+ * and gray at V<1. (Not HSL-saturation; HSL would put gray at S=0 regardless of L.)
+ */
 interface HS {
     hue: number;
     saturation: number;
@@ -12,7 +56,7 @@ declare class BsAlphaStripComponent {
     readonly canvas: _angular_core.Signal<ElementRef<HTMLCanvasElement>>;
     disabled: _angular_core.InputSignal<boolean>;
     hs: _angular_core.ModelSignal<HS>;
-    luminosity: _angular_core.ModelSignal<number>;
+    brightness: _angular_core.ModelSignal<number>;
     alpha: _angular_core.ModelSignal<number>;
     alphaChange: _angular_core.OutputEmitterRef<number>;
     private canvasContext;
@@ -20,75 +64,60 @@ declare class BsAlphaStripComponent {
     constructor();
     ngAfterViewInit(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BsAlphaStripComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BsAlphaStripComponent, "bs-alpha-strip", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "hs": { "alias": "hs"; "required": false; "isSignal": true; }; "luminosity": { "alias": "luminosity"; "required": false; "isSignal": true; }; "alpha": { "alias": "alpha"; "required": false; "isSignal": true; }; }, { "hs": "hsChange"; "luminosity": "luminosityChange"; "alpha": "alphaChange"; "alphaChange": "alphaChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BsAlphaStripComponent, "bs-alpha-strip", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "hs": { "alias": "hs"; "required": false; "isSignal": true; }; "brightness": { "alias": "brightness"; "required": false; "isSignal": true; }; "alpha": { "alias": "alpha"; "required": false; "isSignal": true; }; }, { "hs": "hsChange"; "brightness": "brightnessChange"; "alpha": "alphaChange"; "alphaChange": "alphaChange"; }, never, never, true, never>;
 }
 
-declare class BsColorWheelComponent {
-    private element;
+declare class BsBrightnessStripComponent {
     readonly canvas: _angular_core.Signal<ElementRef<HTMLCanvasElement>>;
+    disabled: _angular_core.InputSignal<boolean>;
+    hs: _angular_core.ModelSignal<HS>;
+    brightness: _angular_core.ModelSignal<number>;
+    brightnessChange: _angular_core.OutputEmitterRef<number>;
+    private canvasContext;
+    resultBackground: _angular_core.Signal<string>;
+    constructor();
+    ngAfterViewInit(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BsBrightnessStripComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BsBrightnessStripComponent, "bs-brightness-strip", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "hs": { "alias": "hs"; "required": false; "isSignal": true; }; "brightness": { "alias": "brightness"; "required": false; "isSignal": true; }; }, { "hs": "hsChange"; "brightness": "brightnessChange"; "brightnessChange": "brightnessChange"; }, never, never, true, never>;
+}
+
+declare class BsColorWheelComponent {
+    readonly surface: _angular_core.Signal<ElementRef<HTMLDivElement>>;
     width: _angular_core.ModelSignal<number>;
     height: _angular_core.ModelSignal<number>;
-    diameterRatio: _angular_core.ModelSignal<number>;
-    luminosity: _angular_core.ModelSignal<number>;
+    brightness: _angular_core.ModelSignal<number>;
     hs: _angular_core.ModelSignal<HS>;
     hsChange: _angular_core.OutputEmitterRef<HS>;
     disabled: _angular_core.InputSignal<boolean>;
-    viewInited: _angular_core.WritableSignal<boolean>;
     private readonly isPointerDown;
-    private canvasContext;
-    squareSize: _angular_core.Signal<number | null>;
-    shiftX: _angular_core.Signal<number | null>;
-    shiftY: _angular_core.Signal<number | null>;
-    innerRadius: _angular_core.Signal<number>;
+    squareSize: _angular_core.Signal<number>;
+    shiftX: _angular_core.Signal<number>;
+    shiftY: _angular_core.Signal<number>;
     outerRadius: _angular_core.Signal<number>;
+    overlayOpacity: _angular_core.Signal<number>;
     markerPosition: _angular_core.Signal<{
         x: number;
         y: number;
     }>;
     constructor();
-    ngAfterViewInit(): void;
     onPointerDown(ev: MouseEvent | TouchEvent): void;
     onPointerMove(ev: MouseEvent | TouchEvent): void;
-    onMouseMove(ev: MouseEvent): void;
-    onPointerUp(ev: MouseEvent | TouchEvent): void;
+    onPointerUp(_ev: MouseEvent | TouchEvent): void;
     private updateColor;
-    private isInsideCircle;
-    private position2color;
-    private color2position;
-    private rgb2Hsl;
-    /**
-     * Divide 1 to n, handling floating point errors.
-     * Ensures that the value is in between 0 and 1.
-     **/
-    private bound01;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BsColorWheelComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BsColorWheelComponent, "bs-color-wheel", never, { "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "diameterRatio": { "alias": "diameterRatio"; "required": false; "isSignal": true; }; "luminosity": { "alias": "luminosity"; "required": false; "isSignal": true; }; "hs": { "alias": "hs"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "width": "widthChange"; "height": "heightChange"; "diameterRatio": "diameterRatioChange"; "luminosity": "luminosityChange"; "hs": "hsChange"; "hsChange": "hsChange"; }, never, never, true, never>;
-}
-
-interface RgbColor {
-    r: number;
-    g: number;
-    b: number;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BsColorWheelComponent, "bs-color-wheel", never, { "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "brightness": { "alias": "brightness"; "required": false; "isSignal": true; }; "hs": { "alias": "hs"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "width": "widthChange"; "height": "heightChange"; "brightness": "brightnessChange"; "hs": "hsChange"; "hsChange": "hsChange"; }, never, never, true, never>;
 }
 
 declare class BsColorPickerValueAccessor implements ControlValueAccessor {
     private host;
     onValueChange?: (value: string) => void;
     onTouched?: () => void;
+    private lastHex;
     constructor();
-    hsl2rgb(h: number, s: number, l: number): RgbColor;
     registerOnChange(fn: (_: any) => void): void;
     registerOnTouched(fn: () => void): void;
     writeValue(value: string | null): void;
     setDisabledState(isDisabled: boolean): void;
-    private rgb2hex;
-    private hex2rgb;
-    /**
-     * Divide 1 to n, handling floating point errors.
-     * Ensures that the value is in between 0 and 1.
-     **/
-    private bound01;
-    private rgb2Hsl;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BsColorPickerValueAccessor, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BsColorPickerValueAccessor, "bs-color-picker", ["bsColorPicker"], {}, {}, never, never, true, never>;
 }
@@ -99,7 +128,7 @@ declare class BsColorPickerComponent {
     disabled: _angular_core.WritableSignal<boolean>;
     allowAlpha: _angular_core.InputSignal<boolean>;
     hs: _angular_core.WritableSignal<HS>;
-    luminosity: _angular_core.WritableSignal<number>;
+    brightness: _angular_core.WritableSignal<number>;
     alpha: _angular_core.ModelSignal<number>;
     alphaChange: _angular_core.OutputEmitterRef<number>;
     constructor();
@@ -107,20 +136,6 @@ declare class BsColorPickerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<BsColorPickerComponent, "bs-color-picker", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "allowAlpha": { "alias": "allowAlpha"; "required": false; "isSignal": true; }; "alpha": { "alias": "alpha"; "required": false; "isSignal": true; }; }, { "alpha": "alphaChange"; "alphaChange": "alphaChange"; }, never, never, true, [{ directive: typeof BsColorPickerValueAccessor; inputs: {}; outputs: {}; }]>;
 }
 
-declare class BsLuminosityStripComponent {
-    readonly canvas: _angular_core.Signal<ElementRef<HTMLCanvasElement>>;
-    disabled: _angular_core.InputSignal<boolean>;
-    hs: _angular_core.ModelSignal<HS>;
-    luminosity: _angular_core.ModelSignal<number>;
-    luminosityChange: _angular_core.OutputEmitterRef<number>;
-    private canvasContext;
-    resultBackground: _angular_core.Signal<string>;
-    constructor();
-    ngAfterViewInit(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BsLuminosityStripComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BsLuminosityStripComponent, "bs-luminosity-strip", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "hs": { "alias": "hs"; "required": false; "isSignal": true; }; "luminosity": { "alias": "luminosity"; "required": false; "isSignal": true; }; }, { "hs": "hsChange"; "luminosity": "luminosityChange"; "luminosityChange": "luminosityChange"; }, never, never, true, never>;
-}
-
 declare class BsSliderComponent {
     private observeSize;
     readonly track: _angular_core.Signal<ElementRef<HTMLDivElement>>;
@@ -148,13 +163,7 @@ declare class BsTrackDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BsTrackDirective, "[bsTrack]", never, {}, {}, never, never, true, never>;
 }
 
-interface HslColor {
-    hue: number;
-    saturation: number;
-    luminosity: number;
-}
-
 type HtmlColor = `#${string}`;
 
-export { BsAlphaStripComponent, BsColorPickerComponent, BsColorPickerValueAccessor, BsColorWheelComponent, BsLuminosityStripComponent, BsSliderComponent, BsThumbDirective, BsTrackDirective };
-export type { HS, HslColor, HtmlColor, RgbColor };
+export { BsAlphaStripComponent, BsBrightnessStripComponent, BsColorPickerComponent, BsColorPickerValueAccessor, BsColorWheelComponent, BsSliderComponent, BsThumbDirective, BsTrackDirective, hex2hsv, hex2rgb, hs2polar, hsl2hsv, hsl2rgb, hsv2hex, hsv2hsl, hsv2rgb, polar2hs, rgb2hex, rgb2hsl, rgb2hsv };
+export type { HS, HslColor, HsvColor, HtmlColor, RgbColor };

package/types/mintplayer-ng-bootstrap-dock.d.ts

@@ -114,6 +114,7 @@ declare class MintDockManagerElement extends LitElement {
     private cornerSnapXTargets;
     private cornerSnapYTargets;
     private showSnapMarkers;
+    debugLayoutIntegrity: boolean;
     private renderSnapMarkersForCorner;
     private clearSnapMarkers;
     private pendingDragEndTimeout;
@@ -275,8 +276,6 @@ declare class MintDockManagerElement extends LitElement {
     private getNodeAtPath;
     private resolveSplitNode;
     private replaceNodeInTree;
-    private cleanupEmptyStackInTree;
-    private cleanupSplitIfNecessary;
     private dockNodeBeside;
     private forEachStack;
     private findStackContainingPane;
@@ -294,12 +293,42 @@ declare class MintDockManagerElement extends LitElement {
     private removePaneFromLocation;
     private addPaneToLocation;
     private setActivePaneForLocation;
-    private cleanupLocation;
     private reorderPaneInLocation;
     private removeFloatingAt;
     private removePaneFromFloating;
     private normalizeSizesArray;
     private normalizeSplitNode;
+    /**
+     * Bottom-up layout sanitizer. Returns a normalized version of `node` where:
+     * - Empty stacks (panes.length === 0) are dropped (returned as null).
+     * - A stack's `activePane` is repaired if it no longer references one of `panes`.
+     * - Splits whose direction matches a child split are flattened, with sizes
+     *   combined multiplicatively so the resulting on-screen pixel layout is
+     *   identical to the pre-merge one.
+     * - Splits with 0 children become null. Splits with 1 child are unwrapped.
+     *
+     * Idempotent: passing the result back through this method yields the same
+     * structure. Mutates the input tree in place but only returns nodes that
+     * remain part of the layout.
+     */
+    private normalizeLayoutNode;
+    /**
+     * Apply `normalizeLayoutNode` to `rootLayout` and every floating window's
+     * root, drop floating windows whose root collapses to null, and repair
+     * stale `activePane` references on each floating window. Run this at the
+     * end of every public mutation entry point (drop handlers, layout setter,
+     * pane removal) so the tree the renderer sees is always in canonical form.
+     */
+    private normalizeAllLayouts;
+    /**
+     * Dev-mode integrity guard: walks every pane referenced by the current
+     * layout and asserts that the rendered shadow DOM contains a matching
+     * `<slot name="${pane}">`. A missing slot means the layout tree got into
+     * a state the renderer can't display — typically a missed normalize() call
+     * or a render bug. Opt in via the `debug-layout-integrity` attribute or
+     * the `debugLayoutIntegrity` property; off by default.
+     */
+    private verifyProjectionSlots;
     private dispatchLayoutChanged;
     private cloneLayoutNode;
     private cloneFloatingArray;
@@ -307,6 +336,14 @@ declare class MintDockManagerElement extends LitElement {
 
 declare class BsDockManagerComponent implements AfterViewInit {
     readonly layout: _angular_core.InputSignal<DockLayoutNode | DockLayout | null>;
+    /**
+     * Dev-mode integrity guard. When `true`, the inner web component throws
+     * after each render if any registered pane has no projection slot in the
+     * shadow DOM — a signal that the layout tree got corrupted. Off by default;
+     * enable in development to catch layout-logic bugs loudly.
+     */
+    readonly debugLayoutIntegrity: _angular_core.InputSignal<boolean>;
+    protected readonly debugLayoutIntegrityAttr: _angular_core.Signal<"" | null>;
     get layoutSnapshot(): DockLayoutSnapshot | null;
     readonly layoutChange: _angular_core.OutputEmitterRef<DockLayoutSnapshot | null>;
     readonly layoutSnapshotChange: _angular_core.OutputEmitterRef<DockLayoutSnapshot>;
@@ -324,7 +361,7 @@ declare class BsDockManagerComponent implements AfterViewInit {
     private stringifyLayout;
     private cloneLayout;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BsDockManagerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BsDockManagerComponent, "bs-dock-manager", never, { "layout": { "alias": "layout"; "required": false; "isSignal": true; }; }, { "layoutChange": "layoutChange"; "layoutSnapshotChange": "layoutSnapshotChange"; }, ["panes"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BsDockManagerComponent, "bs-dock-manager", never, { "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "debugLayoutIntegrity": { "alias": "debugLayoutIntegrity"; "required": false; "isSignal": true; }; }, { "layoutChange": "layoutChange"; "layoutSnapshotChange": "layoutSnapshotChange"; }, ["panes"], never, true, never>;
 }
 
 export { BsDockManagerComponent, BsDockPaneComponent, MintDockManagerElement };