@breadstone/mosaik-elements-foundation 0.0.229 → 0.0.230

package/Controls/Components/Layouts/Grid/IGridElementProps.d.ts

@@ -1,19 +1,16 @@
-import type { HorizontalAlignment } from '../../../Types/HorizontalAlignment';
+import type { IAlignableProps } from '../../../Behaviors/Alignable';
+import type { IThemeableProps } from '../../../Behaviors/Themeable';
 import type { ColumnDefinitions } from './ColumnDefinitions';
-import type { IGridLayoutGap } from './IGridLayoutGapSettings';
+import type { GridLayoutGap } from './IGridLayoutGap';
 import type { RowDefinitions } from './RowDefinitions';
-import type { VerticalAlignment } from '../../../Types/VerticalAlignment';
-import type { IThemeableProps } from '../../../Behaviors/Themeable';
 /**
  * Represents the `IGridElementProps` interface.
  *
  * @public
  */
-export interface IGridElementProps extends IThemeableProps {
+export interface IGridElementProps extends IThemeableProps, IAlignableProps {
     rowDefinitions: RowDefinitions;
     columnDefinitions: ColumnDefinitions;
-    gap: string | number | IGridLayoutGap;
-    horizontalAlignment: HorizontalAlignment;
-    verticalAlignment: VerticalAlignment;
+    gap: GridLayoutGap;
 }
 //# sourceMappingURL=IGridElementProps.d.ts.map

package/Controls/Components/Layouts/Grid/IGridElementProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IGridElementProps.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Layouts/Grid/IGridElementProps.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIpE;;;;GAIG;AACH,MAAM,WAAW,iBACb,SAAQ,eAAe;IAIvB,cAAc,EAAE,cAAc,CAAC;IAE/B,iBAAiB,EAAE,iBAAiB,CAAC;IAErC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC;IAEtC,mBAAmB,EAAE,mBAAmB,CAAC;IAEzC,iBAAiB,EAAE,iBAAiB,CAAC;CAIxC"}
+{"version":3,"file":"IGridElementProps.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Layouts/Grid/IGridElementProps.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD;;;;GAIG;AACH,MAAM,WAAW,iBACb,SAAQ,eAAe,EAAE,eAAe;IAIxC,cAAc,EAAE,cAAc,CAAC;IAE/B,iBAAiB,EAAE,iBAAiB,CAAC;IAErC,GAAG,EAAE,aAAa,CAAC;CAItB"}

package/Controls/Components/Layouts/Grid/IGridItemElementProps.d.ts

@@ -1,6 +1,6 @@
 import type { IThemeableProps } from '../../../Behaviors/Themeable';
 /**
- * Represents the `{@link IGridItemElementProps}` interface.
+ * Represents the `IGridItemElementProps` interface.
  *
  * @public
  */

package/Controls/Components/Layouts/Grid/IGridLayoutGap.d.ts

@@ -0,0 +1,72 @@
+import { CssLength } from '@breadstone/mosaik-themes';
+/**
+ * Describes the gaps between rows and columns of a grid layout.
+ *
+ * When both `rows` and `columns` are specified separately, the grid
+ * will use different gap sizes per axis.
+ *
+ * @example
+ * ```ts
+ * const gap: IGridLayoutGap = {
+ *     rows: 16,          // 16px row gap
+ *     columns: '1.5rem', // 1.5rem column gap
+ * };
+ * ```
+ *
+ * @public
+ */
+export interface IGridLayoutGap {
+    /**
+     * The gap between rows in pixels (if `number`) or as a CSS length string.
+     *
+     * @defaultValue `0`
+     * @public
+     */
+    rows?: CssLength;
+    /**
+     * The gap between columns in pixels (if `number`) or as a CSS length string.
+     *
+     * @defaultValue `0`
+     * @public
+     */
+    columns?: CssLength;
+}
+/**
+ * Accepted input forms for the grid `gap` property.
+ *
+ * | Form             | Example                           | Meaning                                       |
+ * |------------------|-----------------------------------|-----------------------------------------------|
+ * | `CssLength`      | `16`, `'1rem'`, `'8px'`           | Uniform gap on both axes.                     |
+ * | `IGridLayoutGap` | `{ rows: 8, columns: '1.5rem' }` | Separate gap per axis.                        |
+ *
+ * @public
+ */
+export type GridLayoutGap = CssLength | IGridLayoutGap;
+/**
+ * Parses a `GridLayoutGap` input into a resolved `IGridLayoutGap`
+ * with both axes normalised to CSS length strings.
+ *
+ * @example
+ * ```ts
+ * parseGridLayoutGap(16);
+ * // → { rows: '16px', columns: '16px' }
+ *
+ * parseGridLayoutGap('1rem');
+ * // → { rows: '1rem', columns: '1rem' }
+ *
+ * parseGridLayoutGap({ rows: 8, columns: '1.5rem' });
+ * // → { rows: '8px', columns: '1.5rem' }
+ * ```
+ *
+ * @param value - The raw gap input.
+ * @returns An object with resolved `rows` and `columns` CSS strings.
+ *
+ * @throws {Error} If any axis value is invalid or negative.
+ *
+ * @public
+ */
+export declare function parseGridLayoutGap(value: GridLayoutGap): {
+    rows: string;
+    columns: string;
+};
+//# sourceMappingURL=IGridLayoutGap.d.ts.map

package/Controls/Components/Layouts/Grid/IGridLayoutGap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IGridLayoutGap.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Layouts/Grid/IGridLayoutGap.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAItD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,cAAc;IAI3B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CAIvB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,cAAc,CAAC;AA+BvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAW1F"}

package/Controls/Components/Layouts/Grid/IGridLayoutGap.js

@@ -0,0 +1,58 @@
+// #region Imports
+import { CssLength } from '@breadstone/mosaik-themes';
+/**
+ * Resolves a single gap axis value into a CSS length string.
+ *
+ * Delegates to `CssLength.toString` for number → px conversion
+ * and validates that the value is non-negative.
+ *
+ * @param value - A `CssLength` value (number or CSS length string).
+ * @returns A CSS length string (e.g. `'16px'`, `'1rem'`).
+ *
+ * @throws {Error} If the value is negative.
+ *
+ * @internal
+ */
+function resolveGapAxis(value) {
+    if (value === 'auto') {
+        throw new Error('Grid gap does not support "auto".');
+    }
+    const numericPart = CssLength.toNumber(value);
+    if (numericPart < 0) {
+        throw new Error(`Grid gap value must be non-negative. Received: ${typeof value === 'string' ? `"${value}"` : value}`);
+    }
+    return CssLength.toString(value);
+}
+/**
+ * Parses a `GridLayoutGap` input into a resolved `IGridLayoutGap`
+ * with both axes normalised to CSS length strings.
+ *
+ * @example
+ * ```ts
+ * parseGridLayoutGap(16);
+ * // → { rows: '16px', columns: '16px' }
+ *
+ * parseGridLayoutGap('1rem');
+ * // → { rows: '1rem', columns: '1rem' }
+ *
+ * parseGridLayoutGap({ rows: 8, columns: '1.5rem' });
+ * // → { rows: '8px', columns: '1.5rem' }
+ * ```
+ *
+ * @param value - The raw gap input.
+ * @returns An object with resolved `rows` and `columns` CSS strings.
+ *
+ * @throws {Error} If any axis value is invalid or negative.
+ *
+ * @public
+ */
+export function parseGridLayoutGap(value) {
+    if (typeof value === 'number' || typeof value === 'string') {
+        const resolved = resolveGapAxis(value);
+        return { rows: resolved, columns: resolved };
+    }
+    const rows = resolveGapAxis(value.rows ?? 0);
+    const columns = resolveGapAxis(value.columns ?? 0);
+    return { rows, columns };
+}
+//# sourceMappingURL=IGridLayoutGap.js.map

package/Controls/Components/Layouts/Grid/IGridLayoutGap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IGridLayoutGap.js","sourceRoot":"","sources":["../../../../../src/Controls/Components/Layouts/Grid/IGridLayoutGap.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAwDtD;;;;;;;;;;;;GAYG;AACH,SAAS,cAAc,CAAC,KAAgB;IACpC,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE9C,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACX,kDAAkD,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CACvG,CAAC;IACN,CAAC;IAED,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAoB;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACzD,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAEvC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAEnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/Controls/Components/Layouts/Grid/RowDefinition.d.ts

@@ -1,16 +1,64 @@
 import { GridLength, type IGridLength } from './GridLength';
 /**
- * Represents the `IRowDefinition` interface.
+ * Describes the configuration of a single row track in a grid layout.
+ *
+ * Each row definition carries a `height`
+ * that determines the sizing mode (pixel, auto, or star) and optional
+ * `minHeight` /
+ * `maxHeight` constraints that clamp the
+ * resolved height during layout.
  *
  * @public
  */
 export interface IRowDefinition {
+    /**
+     * The height specification for this row.
+     *
+     * Accepts any `IGridLength` value - absolute pixels, `auto`, or
+     * star (`*` / `n*`).
+     *
+     * @public
+     */
     height: IGridLength;
+    /**
+     * The minimum height of this row in pixels/DIPs.
+     * Must be non-negative. Defaults to `0`.
+     *
+     * @public
+     */
     minHeight: number;
+    /**
+     * The maximum height of this row in pixels/DIPs.
+     * Must be non-negative and greater than or equal to
+     * `minHeight`.
+     * Defaults to `Number.MAX_SAFE_INTEGER` (unbounded).
+     *
+     * @public
+     */
     maxHeight: number;
 }
 /**
- * The `RowDefinition` class.
+ * Represents a single row track definition in a grid layout.
+ *
+ * A `RowDefinition` pairs a `GridLength` height with optional
+ * minimum / maximum pixel constraints. During layout the resolved track
+ * height is clamped to `[minHeight, maxHeight]`.
+ *
+ * **Validation rules**
+ * - `minHeight` and `maxHeight` must be non-negative.
+ * - `minHeight` must not exceed `maxHeight`.
+ *
+ * @example
+ * ```ts
+ * // 100 px fixed row
+ * new RowDefinition(new GridLength(100, 'pixel'));
+ *
+ * // Star row (proportional) clamped between 40 px and 200 px
+ * new RowDefinition(new GridLength(1, 'star'), 40, 200);
+ *
+ * // Auto row – height determined by content
+ * new RowDefinition(new GridLength(1, 'auto'));
+ * ```
  *
  * @public
  */
@@ -22,26 +70,34 @@ export declare class RowDefinition implements IRowDefinition {
      * Constructs a new instance of the `RowDefinition` class.
      *
      * @public
+     * @param height The height specification. Defaults to `1*` (one star).
+     * @param minHeight Minimum height in pixels/DIPs. Must be ≥ 0. Defaults to `0`.
+     * @param maxHeight Maximum height in pixels/DIPs. Must be ≥ 0 and ≥ `minHeight`. Defaults to `Number.MAX_SAFE_INTEGER` (unbounded).
+     * @throws {Error} If `minHeight` is negative.
+     * @throws {Error} If `maxHeight` is negative.
+     * @throws {Error} If `minHeight` exceeds `maxHeight`.
      */
     constructor(height?: IGridLength, minHeight?: number, maxHeight?: number);
     /**
-     * Gets or sets the `height` property.
+     * Gets or sets the height specification for this row.
      *
      * @public
      */
     get height(): GridLength;
     set height(value: GridLength);
     /**
-     * Gets or sets the `minHeight` property.
+     * Gets or sets the minimum height in pixels/DIPs.
      *
      * @public
+     * @throws {Error} If the new value is negative.
      */
     get minHeight(): number;
     set minHeight(value: number);
     /**
-     * Gets or sets the `maxHeight` property.
+     * Gets or sets the maximum height in pixels/DIPs.
      *
      * @public
+     * @throws {Error} If the new value is negative.
      */
     get maxHeight(): number;
     set maxHeight(value: number);

package/Controls/Components/Layouts/Grid/RowDefinition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RowDefinition.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Layouts/Grid/RowDefinition.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAQ5D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAI3B,MAAM,EAAE,WAAW,CAAC;IAEpB,SAAS,EAAE,MAAM,CAAC;IAElB,SAAS,EAAE,MAAM,CAAC;CAIrB;AAED;;;;GAIG;AACH,qBAAa,aAAc,YAAW,cAAc;IAIhD,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAM3B;;;;OAIG;gBACgB,MAAM,GAAE,WAAuC,EAAE,SAAS,GAAE,MAAU,EAAE,SAAS,GAAE,MAAgC;IAUtI;;;;OAIG;IACH,IAAW,MAAM,IAAI,UAAU,CAE9B;IACD,IAAW,MAAM,CAAC,KAAK,EAAE,UAAU,EAElC;IAED;;;;OAIG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,MAAM,EAEjC;IAED;;;;OAIG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,MAAM,EAEjC;CAIJ"}
+{"version":3,"file":"RowDefinition.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Layouts/Grid/RowDefinition.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAI5D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAI3B;;;;;;;OAOG;IACH,MAAM,EAAE,WAAW,CAAC;IAEpB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;OAOG;IACH,SAAS,EAAE,MAAM,CAAC;CAIrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,aAAc,YAAW,cAAc;IAIhD,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAM3B;;;;;;;;;;OAUG;gBAEC,MAAM,GAAE,WAAuC,EAC/C,SAAS,GAAE,MAAU,EACrB,SAAS,GAAE,MAAgC;IA2B/C;;;;OAIG;IACH,IAAW,MAAM,IAAI,UAAU,CAE9B;IACD,IAAW,MAAM,CAAC,KAAK,EAAE,UAAU,EAElC;IAED;;;;;OAKG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,MAAM,EAMjC;IAED;;;;;OAKG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,MAAM,EAMjC;CAIJ"}

package/Controls/Components/Layouts/Grid/RowDefinition.js

@@ -1,7 +1,27 @@
 // #region Imports
 import { GridLength } from './GridLength';
 /**
- * The `RowDefinition` class.
+ * Represents a single row track definition in a grid layout.
+ *
+ * A `RowDefinition` pairs a `GridLength` height with optional
+ * minimum / maximum pixel constraints. During layout the resolved track
+ * height is clamped to `[minHeight, maxHeight]`.
+ *
+ * **Validation rules**
+ * - `minHeight` and `maxHeight` must be non-negative.
+ * - `minHeight` must not exceed `maxHeight`.
+ *
+ * @example
+ * ```ts
+ * // 100 px fixed row
+ * new RowDefinition(new GridLength(100, 'pixel'));
+ *
+ * // Star row (proportional) clamped between 40 px and 200 px
+ * new RowDefinition(new GridLength(1, 'star'), 40, 200);
+ *
+ * // Auto row – height determined by content
+ * new RowDefinition(new GridLength(1, 'auto'));
+ * ```
  *
  * @public
  */
@@ -16,16 +36,33 @@ export class RowDefinition {
      * Constructs a new instance of the `RowDefinition` class.
      *
      * @public
+     * @param height The height specification. Defaults to `1*` (one star).
+     * @param minHeight Minimum height in pixels/DIPs. Must be ≥ 0. Defaults to `0`.
+     * @param maxHeight Maximum height in pixels/DIPs. Must be ≥ 0 and ≥ `minHeight`. Defaults to `Number.MAX_SAFE_INTEGER` (unbounded).
+     * @throws {Error} If `minHeight` is negative.
+     * @throws {Error} If `maxHeight` is negative.
+     * @throws {Error} If `minHeight` exceeds `maxHeight`.
      */
     constructor(height = new GridLength(1, 'star'), minHeight = 0, maxHeight = Number.MAX_SAFE_INTEGER) {
-        this._height = height instanceof GridLength ? height : new GridLength(height.value, height.type);
+        if (minHeight < 0) {
+            throw new Error(`RowDefinition minHeight must be non-negative. Received: ${minHeight}`);
+        }
+        if (maxHeight < 0) {
+            throw new Error(`RowDefinition maxHeight must be non-negative. Received: ${maxHeight}`);
+        }
+        if (minHeight > maxHeight) {
+            throw new Error(`RowDefinition minHeight (${minHeight}) must not exceed maxHeight (${maxHeight}).`);
+        }
+        this._height = height instanceof GridLength
+            ? height
+            : new GridLength(height.value, height.type);
         this._minHeight = minHeight;
         this._maxHeight = maxHeight;
     }
     // #endregion
     // #region Properties
     /**
-     * Gets or sets the `height` property.
+     * Gets or sets the height specification for this row.
      *
      * @public
      */
@@ -36,25 +73,33 @@ export class RowDefinition {
         this._height = value;
     }
     /**
-     * Gets or sets the `minHeight` property.
+     * Gets or sets the minimum height in pixels/DIPs.
      *
      * @public
+     * @throws {Error} If the new value is negative.
      */
     get minHeight() {
         return this._minHeight;
     }
     set minHeight(value) {
+        if (value < 0) {
+            throw new Error(`RowDefinition minHeight must be non-negative. Received: ${value}`);
+        }
         this._minHeight = value;
     }
     /**
-     * Gets or sets the `maxHeight` property.
+     * Gets or sets the maximum height in pixels/DIPs.
      *
      * @public
+     * @throws {Error} If the new value is negative.
      */
     get maxHeight() {
         return this._maxHeight;
     }
     set maxHeight(value) {
+        if (value < 0) {
+            throw new Error(`RowDefinition maxHeight must be non-negative. Received: ${value}`);
+        }
         this._maxHeight = value;
     }
 }

package/Controls/Components/Layouts/Grid/RowDefinition.js.map

@@ -1 +1 @@
-{"version":3,"file":"RowDefinition.js","sourceRoot":"","sources":["../../../../../src/Controls/Components/Layouts/Grid/RowDefinition.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AA2B5D;;;;GAIG;AACH,MAAM,OAAO,aAAa;IAEtB,iBAAiB;IAET,OAAO,CAAa;IACpB,UAAU,CAAS;IACnB,UAAU,CAAS;IAE3B,aAAa;IAEb,eAAe;IAEf;;;;OAIG;IACH,YAAmB,SAAsB,IAAI,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,YAAoB,CAAC,EAAE,YAAoB,MAAM,CAAC,gBAAgB;QAClI,IAAI,CAAC,OAAO,GAAG,MAAM,YAAY,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACjG,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAChC,CAAC;IAED,aAAa;IAEb,qBAAqB;IAErB;;;;OAIG;IACH,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,IAAW,MAAM,CAAC,KAAiB;QAC/B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,IAAW,SAAS,CAAC,KAAa;QAC9B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,IAAW,SAAS,CAAC,KAAa;QAC9B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC5B,CAAC;CAIJ"}
+{"version":3,"file":"RowDefinition.js","sourceRoot":"","sources":["../../../../../src/Controls/Components/Layouts/Grid/RowDefinition.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAmD5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,aAAa;IAEtB,iBAAiB;IAET,OAAO,CAAa;IACpB,UAAU,CAAS;IACnB,UAAU,CAAS;IAE3B,aAAa;IAEb,eAAe;IAEf;;;;;;;;;;OAUG;IACH,YACI,SAAsB,IAAI,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,EAC/C,YAAoB,CAAC,EACrB,YAAoB,MAAM,CAAC,gBAAgB;QAE3C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,2DAA2D,SAAS,EAAE,CAAC,CAAC;QAC5F,CAAC;QAED,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,2DAA2D,SAAS,EAAE,CAAC,CAAC;QAC5F,CAAC;QAED,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACX,4BAA4B,SAAS,gCAAgC,SAAS,IAAI,CACrF,CAAC;QACN,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,MAAM,YAAY,UAAU;YACvC,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAChC,CAAC;IAED,aAAa;IAEb,qBAAqB;IAErB;;;;OAIG;IACH,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,IAAW,MAAM,CAAC,KAAiB;QAC/B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,IAAW,SAAS,CAAC,KAAa;QAC9B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,2DAA2D,KAAK,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,IAAW,SAAS,CAAC,KAAa;QAC9B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,2DAA2D,KAAK,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC5B,CAAC;CAIJ"}

package/Controls/Components/Layouts/Grid/RowDefinitions.d.ts

@@ -1,16 +1,182 @@
-import type { WithRequired } from '../../../../Types/WithRequired';
-import { RowDefinition, type IRowDefinition } from './RowDefinition';
+import { GridLength, type GridLengthInput } from './GridLength';
+import { RowDefinition } from './RowDefinition';
 /**
+ * Describes the object form of a single row definition input.
+ *
+ * The `height` property is required and accepts any `GridLengthInput`
+ * shorthand or a `GridLength` instance. The optional `minHeight` and
+ * `maxHeight` constrain the resolved track height in pixels/DIPs.
+ *
+ * @example
+ * ```ts
+ * const row: IRowDefinitionInput = {
+ *     height: '2*',
+ *     minHeight: 40,
+ *     maxHeight: 200,
+ * };
+ * ```
+ *
  * @public
  */
-export type RowDefinitions = Array<string | number | WithRequired<IRowDefinition, 'height'>>;
+export interface IRowDefinitionInput {
+    /**
+     * The height specification for this row.
+     *
+     * Accepts a `GridLengthInput` shorthand (`number`, `'auto'`,
+     * `'*'`, `` `${number}*` ``) or a `GridLength` instance.
+     *
+     * @public
+     */
+    height: GridLengthInput | GridLength;
+    /**
+     * The minimum height of this row in pixels/DIPs.
+     * Must be non-negative. Defaults to `0` when omitted.
+     *
+     * @public
+     */
+    minHeight?: number;
+    /**
+     * The maximum height of this row in pixels/DIPs.
+     * Must be non-negative and `≥ minHeight`.
+     * Defaults to `Number.MAX_SAFE_INTEGER` when omitted.
+     *
+     * @public
+     */
+    maxHeight?: number;
+}
+/**
+ * Accepted input for a single row track.
+ *
+ * | Form                        | Example                                          | Meaning                                  |
+ * |-----------------------------|--------------------------------------------------|------------------------------------------|
+ * | `number`                    | `100`                                            | Fixed height in pixels/DIPs.             |
+ * | `'auto'`                    | `'auto'`                                         | Content-based sizing.                    |
+ * | `'*'` / `` `${number}*` `` | `'*'`, `'2*'`, `'0.5*'`                           | Star (proportional) sizing.              |
+ * | object                      | `{ height: '2*', minHeight: 40, maxHeight: 200 }` | Full definition with optional min/max.   |
+ *
+ * Bare `string` is **not** accepted - only the exact literal forms listed
+ * above pass compile-time validation.
+ *
+ * @public
+ */
+export type RowDefinitionInput = GridLengthInput | IRowDefinitionInput;
+/**
+ * A space-separated string of `GridLengthInput` tokens that can be
+ * used as an HTML attribute value to define row tracks.
+ *
+ * Each token must be one of:
+ * - A non-negative number (pixels/DIPs), e.g. `"100"`
+ * - `"auto"` for content-based sizing
+ * - `"*"` or `"n*"` for star (proportional) sizing, e.g. `"2*"`
+ *
+ * Tokens are separated by whitespace.
+ *
+ * @example
+ * ```html
+ * <mosaik-grid row-definitions="auto * 100"></mosaik-grid>
+ * ```
+ *
+ * @public
+ */
+export type RowDefinitionsString = string & {
+    readonly __brand?: 'RowDefinitionsString';
+};
+/**
+ * Row track definitions for a grid layout.
+ *
+ * Accepts either an array of `RowDefinitionInput` entries (for
+ * programmatic / Lit property binding usage) or a space-separated
+ * `RowDefinitionsString` (for plain HTML attribute usage).
+ *
+ * The array length (or number of tokens) determines the number of
+ * rows; each entry defines the sizing of the corresponding row track.
+ *
+ * @example
+ * Array form (JavaScript / Lit property binding):
+ * ```ts
+ * const rows: RowDefinitions = [
+ *     'auto',                            // content-sized
+ *     '*',                               // 1 star (proportional)
+ *     '2*',                              // 2 stars (proportional)
+ *     100,                               // 100 px fixed
+ *     { height: '0.5*', minHeight: 40, maxHeight: 200 }
+ * ];
+ * ```
+ *
+ * @example
+ * String form (HTML attribute):
+ * ```html
+ * <mosaik-grid row-definitions="auto * 2* 100"></mosaik-grid>
+ * ```
+ *
+ * @public
+ */
+export type RowDefinitions = Array<RowDefinitionInput> | RowDefinitionsString;
 /**
  * @public
  */
 export declare namespace RowDefinitions {
     /**
+     * Parses a `RowDefinitions` value (array or space-separated
+     * string) into validated `RowDefinition` instances.
+     *
+     * When `self` is a `string`, it is first split on whitespace into
+     * individual tokens, each of which must be a valid
+     * `GridLengthInput` literal (`number`, `'auto'`, `'*'`,
+     * `` `${number}*` ``).
+     *
+     * When `self` is an array, each element is validated strictly:
+     * - Numbers must be non-negative (absolute pixel sizing).
+     * - String literals are parsed via `parseGridLength`.
+     * - Object entries must carry a valid `height` and optional
+     *   non-negative `minHeight` / `maxHeight` where `minHeight ≤ maxHeight`.
+     *
      * @public
+     * @param self The raw definitions to parse.
+     * @returns An array of fully validated `RowDefinition` instances.
+     * @throws {Error} If any entry is invalid.
      */
     function parse(self: RowDefinitions): Array<RowDefinition>;
+    /**
+     * Parses a space-separated string of grid-length tokens into an
+     * array of `RowDefinitionInput` values.
+     *
+     * Each whitespace-delimited token is interpreted as a
+     * `GridLengthInput`: a non-negative number (pixels), `"auto"`,
+     * `"*"`, or `"n*"` (star sizing).
+     *
+     * @example
+     * ```ts
+     * RowDefinitions.fromString('auto * 100');
+     * // → ['auto', '*', 100]
+     * ```
+     *
+     * @public
+     * @param value The space-separated definition string.
+     * @returns An array of parsed `RowDefinitionInput` values.
+     * @throws {Error} If the string is empty or any token is invalid.
+     */
+    function fromString(value: RowDefinitionsString): Array<RowDefinitionInput>;
+    /**
+     * Serializes a `RowDefinitions` value into a space-separated
+     * string suitable for use as an HTML attribute value.
+     *
+     * Each entry is converted to its shortest `GridLength` string
+     * representation via `GridLength.toString`. Object entries
+     * (with `minHeight`/`maxHeight`) are serialized using their `height`
+     * component only, as min/max constraints cannot be expressed in the
+     * string format.
+     *
+     * @example
+     * ```ts
+     * RowDefinitions.toString(['auto', '*', 100]);
+     * // → 'auto * 100'
+     * ```
+     *
+     * @public
+     * @param self The definitions to serialize.
+     * @returns A space-separated string representation.
+     */
+    function toString(self: RowDefinitions): RowDefinitionsString;
 }
 //# sourceMappingURL=RowDefinitions.d.ts.map

package/Controls/Components/Layouts/Grid/RowDefinitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RowDefinitions.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Layouts/Grid/RowDefinitions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIrE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE7F;;GAEG;AACH,yBAAiB,cAAc,CAAC;IAE5B;;OAEG;IACH,SAAgB,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC,CAIhE;CAEJ"}
+{"version":3,"file":"RowDefinitions.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Layouts/Grid/RowDefinitions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAmB,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,mBAAmB;IAIhC;;;;;;;OAOG;IACH,MAAM,EAAE,eAAe,GAAG,UAAU,CAAC;IAErC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CAItB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAEvE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,kBAAkB,CAAC,GAAG,oBAAoB,CAAC;AAE9E;;GAEG;AACH,yBAAiB,cAAc,CAAC;IAE5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAgB,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC,CAsBhE;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAgB,UAAU,CAAC,KAAK,EAAE,oBAAoB,GAAG,KAAK,CAAC,kBAAkB,CAAC,CAgCjF;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAgB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,oBAAoB,CAoBnE;CAEJ"}