@picteus/extension-sdk 0.16.0 → 0.17.0

package/dist/generated/viewKit.js

@@ -58,6 +58,24 @@ export var TextIntensity;
     // High visual contrast / intense text color
     TextIntensity["high"] = "high";
 })(TextIntensity || (TextIntensity = {}));
+/** Geometric shape representation for visual containers and indicators. */
+export var Shape;
+(function (Shape) {
+    // Circular container shape
+    Shape["circle"] = "circle";
+    // Square container shape
+    Shape["square"] = "square";
+})(Shape || (Shape = {}));
+/** Relative sizing scale for visual elements and indicators. */
+export var Size;
+(function (Size) {
+    // Compact small size
+    Size["small"] = "small";
+    // Standard medium size
+    Size["medium"] = "medium";
+    // Prominent large size
+    Size["large"] = "large";
+})(Size || (Size = {}));
 /** Representation style for short string values. */
 export var StringShortRepresentation;
 (function (StringShortRepresentation) {
@@ -92,7 +110,7 @@ export var BadgeVariant;
 export var TimestampFormat;
 (function (TimestampFormat) {
     // Complete date and time display
-    TimestampFormat["full"] = "full";
+    TimestampFormat["datetime"] = "datetime";
     // Date-only display
     TimestampFormat["date"] = "date";
     // Time-only display
@@ -458,14 +476,14 @@ export class RatioElementClass extends BaseUiElement {
      * @defaultValue "ratio"
      */
     type = "ratio";
-    /** Aspect ratio textual expression */
+    /** Aspect ratio numerical expression */
     value;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     modifiers;
     /**
      * Constructs a new `RatioElementClass` instance.
      *
-     * @param value - Aspect ratio textual expression
+     * @param value - Aspect ratio numerical expression
      * @param options - Optional component settings. (modifiers).
      */
     constructor(value, options) {
@@ -478,28 +496,52 @@ export class RatioElementClass extends BaseUiElement {
  * Class implementation of the `ColourElement` interface.
  *
  * @remarks
- * Single color swatch representation with hex value and copy affordance.
+ * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
  */
 export class ColourElementClass extends BaseUiElement {
     /**
      * Discriminator identifier for `ColourElement`.
      *
-     * @defaultValue "color-swatch"
+     * @defaultValue "color"
      */
-    type = "color-swatch";
+    type = "color";
     /** Hexadecimal color code */
     value;
+    /** Optional descriptive color name label */
+    label;
+    /**
+     * Whether to display the textual color code or label next to the swatch
+     *
+     * @defaultValue true
+     */
+    showText;
+    /**
+     * Visual shape of the color indicator
+     *
+     * @defaultValue Shape.circle
+     */
+    shape;
+    /**
+     * Visual size of the color indicator
+     *
+     * @defaultValue Size.medium
+     */
+    size;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     modifiers;
     /**
      * Constructs a new `ColourElementClass` instance.
      *
      * @param value - Hexadecimal color code
-     * @param options - Optional component settings. (modifiers).
+     * @param options - Optional component settings. (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
      */
     constructor(value, options) {
         super();
         this.value = value;
+        this.label = options?.label;
+        this.showText = options?.showText ?? true;
+        this.shape = options?.shape ?? Shape.circle;
+        this.size = options?.size ?? Size.medium;
         this.modifiers = options?.modifiers;
     }
 }
@@ -700,12 +742,12 @@ export class TimestampElementClass extends BaseUiElement {
      * @defaultValue "timestamp"
      */
     type = "timestamp";
-    /** ISO 8601 date string or epoch timestamp in milliseconds */
+    /** The timestamp in milliseconds */
     value;
     /**
      * Presentation date/time format
      *
-     * @defaultValue TimestampFormat.full
+     * @defaultValue TimestampFormat.datetime
      */
     format;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
@@ -713,13 +755,13 @@ export class TimestampElementClass extends BaseUiElement {
     /**
      * Constructs a new `TimestampElementClass` instance.
      *
-     * @param value - ISO 8601 date string or epoch timestamp in milliseconds
-     * @param options - Optional component settings. (format (defaults to `full`), modifiers).
+     * @param value - The timestamp in milliseconds
+     * @param options - Optional component settings. (format (defaults to `datetime`), modifiers).
      */
     constructor(value, options) {
         super();
         this.value = value;
-        this.format = options?.format ?? TimestampFormat.full;
+        this.format = options?.format ?? TimestampFormat.datetime;
         this.modifiers = options?.modifiers;
     }
 }
@@ -762,31 +804,6 @@ export class ImageReferenceElementClass extends BaseUiElement {
         this.placeholder = options?.placeholder;
     }
 }
-/**
- * Class implementation of the `DominantColourSetElement` interface.
- *
- * @remarks
- * Dominant color set palette rendered in descending dominance order.
- */
-export class DominantColourSetElementClass extends BaseUiElement {
-    /**
-     * Discriminator identifier for `DominantColourSetElement`.
-     *
-     * @defaultValue "color-set"
-     */
-    type = "color-set";
-    /** List of hexadecimal color strings in descending priority */
-    colors;
-    /**
-     * Constructs a new `DominantColourSetElementClass` instance.
-     *
-     * @param colors - List of hexadecimal color strings in descending priority
-     */
-    constructor(colors) {
-        super();
-        this.colors = colors ? [...colors] : [];
-    }
-}
 /**
  * Class implementation of the `ButtonActionElement` interface.
  *
@@ -954,15 +971,15 @@ export class SlotClass extends ViewKitNode {
     }
 }
 /**
- * Class implementation of the `MultiSlotRowElement` interface.
+ * Class implementation of the `MultiSlotElement` interface.
  *
  * @remarks
  * Multi-slot horizontal row with declared column width proportions.
  * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
  */
-export class MultiSlotRowElementClass extends BaseUiElement {
+export class MultiSlotElementClass extends BaseUiElement {
     /**
-     * Discriminator identifier for `MultiSlotRowElement`.
+     * Discriminator identifier for `MultiSlotElement`.
      *
      * @defaultValue "multi-slot"
      */
@@ -972,7 +989,7 @@ export class MultiSlotRowElementClass extends BaseUiElement {
     /** Proportions descriptor (e.g. "1/3 + 2/3", "equal", "1/4 + 3/4") */
     proportions;
     /**
-     * Constructs a new `MultiSlotRowElementClass` instance.
+     * Constructs a new `MultiSlotElementClass` instance.
      *
      * @param slots - List of slots comprising the row
      * @param options - Optional component settings. (proportions).
@@ -984,15 +1001,41 @@ export class MultiSlotRowElementClass extends BaseUiElement {
     }
 }
 /**
- * Class implementation of the `LabelValueRowElement` interface.
+ * Class implementation of the `FlowingElement` interface.
+ *
+ * @remarks
+ * Flowing inline layout container with automatic line wrapping.
+ * Renders child elements horizontally in sequence, automatically wrapping to the next line when space runs out.
+ */
+export class FlowingElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `FlowingElement`.
+     *
+     * @defaultValue "flowing"
+     */
+    type = "flowing";
+    /** List of child elements rendered sequentially with line wrapping */
+    elements;
+    /**
+     * Constructs a new `FlowingElementClass` instance.
+     *
+     * @param elements - List of child elements rendered sequentially with line wrapping
+     */
+    constructor(elements) {
+        super();
+        this.elements = elements ? [...elements] : [];
+    }
+}
+/**
+ * Class implementation of the `LabelValueElement` interface.
  *
  * @remarks
  * Standard label and value row.
  * Displays a muted label on the left and value representation on the right with a vertical dividing line.
  */
-export class LabelValueRowElementClass extends BaseUiElement {
+export class LabelValueElementClass extends BaseUiElement {
     /**
-     * Discriminator identifier for `LabelValueRowElement`.
+     * Discriminator identifier for `LabelValueElement`.
      *
      * @defaultValue "label-value"
      */
@@ -1008,7 +1051,7 @@ export class LabelValueRowElementClass extends BaseUiElement {
      */
     withDivider;
     /**
-     * Constructs a new `LabelValueRowElementClass` instance.
+     * Constructs a new `LabelValueElementClass` instance.
      *
      * @param label - Key or descriptive label displayed muted on the left
      * @param value - Rendered value element on the right
@@ -1468,7 +1511,7 @@ export class UiContainerBuilder {
      * @remarks
      * Aspect ratio representation (e.g. "16:9", "4:3", "1:1").
      *
-     * @param value - Aspect ratio textual expression
+     * @param value - Aspect ratio numerical expression
      * @param options - Optional component settings (modifiers).
      * @returns This builder instance for method chaining.
      */
@@ -1479,10 +1522,10 @@ export class UiContainerBuilder {
      * Appends a `ColourElement` component.
      *
      * @remarks
-     * Single color swatch representation with hex value and copy affordance.
+     * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
      *
      * @param value - Hexadecimal color code
-     * @param options - Optional component settings (modifiers).
+     * @param options - Optional component settings (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
      * @returns This builder instance for method chaining.
      */
     addColour(value, options) {
@@ -1492,14 +1535,14 @@ export class UiContainerBuilder {
      * Appends a `ColourElement` component.
      *
      * @remarks
-     * Single color swatch representation with hex value and copy affordance.
+     * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
      *
      * @param value - Hexadecimal color code
-     * @param options - Optional component settings (modifiers).
+     * @param options - Optional component settings (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
      * @returns This builder instance for method chaining.
      */
-    addColorSwatch(value, options) {
-        return this.add(colorSwatch(value, options));
+    addColor(value, options) {
+        return this.add(color(value, options));
     }
     /**
      * Appends a `NumberUnboundedElement` component.
@@ -1598,8 +1641,8 @@ export class UiContainerBuilder {
      * @remarks
      * Formatted date and time representation.
      *
-     * @param value - ISO 8601 date string or epoch timestamp in milliseconds
-     * @param options - Optional component settings (format (defaults to `full`), modifiers).
+     * @param value - The timestamp in milliseconds
+     * @param options - Optional component settings (format (defaults to `datetime`), modifiers).
      * @returns This builder instance for method chaining.
      */
     addTimestamp(value, options) {
@@ -1631,30 +1674,6 @@ export class UiContainerBuilder {
     addImageRef(src, options) {
         return this.add(imageRef(src, options));
     }
-    /**
-     * Appends a `DominantColourSetElement` component.
-     *
-     * @remarks
-     * Dominant color set palette rendered in descending dominance order.
-     *
-     * @param colors - List of hexadecimal color strings in descending priority
-     * @returns This builder instance for method chaining.
-     */
-    addDominantColourSet(colors) {
-        return this.add(dominantColourSet(colors));
-    }
-    /**
-     * Appends a `DominantColourSetElement` component.
-     *
-     * @remarks
-     * Dominant color set palette rendered in descending dominance order.
-     *
-     * @param colors - List of hexadecimal color strings in descending priority
-     * @returns This builder instance for method chaining.
-     */
-    addDominantColors(colors) {
-        return this.add(dominantColors(colors));
-    }
     /**
      * Appends a `MarkdownBlockElement` component.
      *
@@ -1708,21 +1727,7 @@ export class UiContainerBuilder {
         return this.add(html(content, options));
     }
     /**
-     * Appends a `MultiSlotRowElement` component.
-     *
-     * @remarks
-     * Multi-slot horizontal row with declared column width proportions.
-     * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
-     *
-     * @param slots - List of slots comprising the row
-     * @param options - Optional component settings (proportions).
-     * @returns This builder instance for method chaining.
-     */
-    addMultiSlotRow(slots, options) {
-        return this.add(multiSlotRow(slots, options));
-    }
-    /**
-     * Appends a `MultiSlotRowElement` component.
+     * Appends a `MultiSlotElement` component.
      *
      * @remarks
      * Multi-slot horizontal row with declared column width proportions.
@@ -1736,22 +1741,20 @@ export class UiContainerBuilder {
         return this.add(multiSlot(slots, options));
     }
     /**
-     * Appends a `LabelValueRowElement` component.
+     * Appends a `FlowingElement` component.
      *
      * @remarks
-     * Standard label and value row.
-     * Displays a muted label on the left and value representation on the right with a vertical dividing line.
+     * Flowing inline layout container with automatic line wrapping.
+     * Renders child elements horizontally in sequence, automatically wrapping to the next line when space runs out.
      *
-     * @param label - Key or descriptive label displayed muted on the left
-     * @param value - Rendered value element on the right
-     * @param options - Optional component settings (withDivider (defaults to `false`)).
+     * @param elements - List of child elements rendered sequentially with line wrapping
      * @returns This builder instance for method chaining.
      */
-    addLabelValueRow(label, value, options) {
-        return this.add(labelValueRow(label, value, options));
+    addFlowing(elements) {
+        return this.add(flowing(elements));
     }
     /**
-     * Appends a `LabelValueRowElement` component.
+     * Appends a `LabelValueElement` component.
      *
      * @remarks
      * Standard label and value row.
@@ -2073,7 +2076,7 @@ export class UiCardBuilder {
      * @remarks
      * Aspect ratio representation (e.g. "16:9", "4:3", "1:1").
      *
-     * @param value - Aspect ratio textual expression
+     * @param value - Aspect ratio numerical expression
      * @param options - Optional component settings (modifiers).
      * @returns This builder instance for method chaining.
      */
@@ -2084,10 +2087,10 @@ export class UiCardBuilder {
      * Appends a `ColourElement` component.
      *
      * @remarks
-     * Single color swatch representation with hex value and copy affordance.
+     * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
      *
      * @param value - Hexadecimal color code
-     * @param options - Optional component settings (modifiers).
+     * @param options - Optional component settings (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
      * @returns This builder instance for method chaining.
      */
     addColour(value, options) {
@@ -2097,14 +2100,14 @@ export class UiCardBuilder {
      * Appends a `ColourElement` component.
      *
      * @remarks
-     * Single color swatch representation with hex value and copy affordance.
+     * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
      *
      * @param value - Hexadecimal color code
-     * @param options - Optional component settings (modifiers).
+     * @param options - Optional component settings (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
      * @returns This builder instance for method chaining.
      */
-    addColorSwatch(value, options) {
-        return this.add(colorSwatch(value, options));
+    addColor(value, options) {
+        return this.add(color(value, options));
     }
     /**
      * Appends a `NumberUnboundedElement` component.
@@ -2203,8 +2206,8 @@ export class UiCardBuilder {
      * @remarks
      * Formatted date and time representation.
      *
-     * @param value - ISO 8601 date string or epoch timestamp in milliseconds
-     * @param options - Optional component settings (format (defaults to `full`), modifiers).
+     * @param value - The timestamp in milliseconds
+     * @param options - Optional component settings (format (defaults to `datetime`), modifiers).
      * @returns This builder instance for method chaining.
      */
     addTimestamp(value, options) {
@@ -2236,30 +2239,6 @@ export class UiCardBuilder {
     addImageRef(src, options) {
         return this.add(imageRef(src, options));
     }
-    /**
-     * Appends a `DominantColourSetElement` component.
-     *
-     * @remarks
-     * Dominant color set palette rendered in descending dominance order.
-     *
-     * @param colors - List of hexadecimal color strings in descending priority
-     * @returns This builder instance for method chaining.
-     */
-    addDominantColourSet(colors) {
-        return this.add(dominantColourSet(colors));
-    }
-    /**
-     * Appends a `DominantColourSetElement` component.
-     *
-     * @remarks
-     * Dominant color set palette rendered in descending dominance order.
-     *
-     * @param colors - List of hexadecimal color strings in descending priority
-     * @returns This builder instance for method chaining.
-     */
-    addDominantColors(colors) {
-        return this.add(dominantColors(colors));
-    }
     /**
      * Appends a `MarkdownBlockElement` component.
      *
@@ -2313,21 +2292,7 @@ export class UiCardBuilder {
         return this.add(html(content, options));
     }
     /**
-     * Appends a `MultiSlotRowElement` component.
-     *
-     * @remarks
-     * Multi-slot horizontal row with declared column width proportions.
-     * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
-     *
-     * @param slots - List of slots comprising the row
-     * @param options - Optional component settings (proportions).
-     * @returns This builder instance for method chaining.
-     */
-    addMultiSlotRow(slots, options) {
-        return this.add(multiSlotRow(slots, options));
-    }
-    /**
-     * Appends a `MultiSlotRowElement` component.
+     * Appends a `MultiSlotElement` component.
      *
      * @remarks
      * Multi-slot horizontal row with declared column width proportions.
@@ -2341,22 +2306,20 @@ export class UiCardBuilder {
         return this.add(multiSlot(slots, options));
     }
     /**
-     * Appends a `LabelValueRowElement` component.
+     * Appends a `FlowingElement` component.
      *
      * @remarks
-     * Standard label and value row.
-     * Displays a muted label on the left and value representation on the right with a vertical dividing line.
+     * Flowing inline layout container with automatic line wrapping.
+     * Renders child elements horizontally in sequence, automatically wrapping to the next line when space runs out.
      *
-     * @param label - Key or descriptive label displayed muted on the left
-     * @param value - Rendered value element on the right
-     * @param options - Optional component settings (withDivider (defaults to `false`)).
+     * @param elements - List of child elements rendered sequentially with line wrapping
      * @returns This builder instance for method chaining.
      */
-    addLabelValueRow(label, value, options) {
-        return this.add(labelValueRow(label, value, options));
+    addFlowing(elements) {
+        return this.add(flowing(elements));
     }
     /**
-     * Appends a `LabelValueRowElement` component.
+     * Appends a `LabelValueElement` component.
      *
      * @remarks
      * Standard label and value row.
@@ -2701,7 +2664,7 @@ export function identifier(value, options) {
  * @remarks
  * Aspect ratio representation (e.g. "16:9", "4:3", "1:1").
  *
- * @param value - Aspect ratio textual expression
+ * @param value - Aspect ratio numerical expression
  * @param options - Optional settings (modifiers).
  * @returns A strongly-typed `RatioElement` object.
  */
@@ -2716,16 +2679,20 @@ export function ratio(value, options) {
  * Creates a `ColourElement` component instance.
  *
  * @remarks
- * Single color swatch representation with hex value and copy affordance.
+ * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
  *
  * @param value - Hexadecimal color code
- * @param options - Optional settings (modifiers).
+ * @param options - Optional settings (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
  * @returns A strongly-typed `ColourElement` object.
  */
 export function colour(value, options) {
     return {
-        type: "color-swatch",
+        type: "color",
         value,
+        label: options?.label,
+        showText: options?.showText ?? true,
+        shape: options?.shape ?? Shape.circle,
+        size: options?.size ?? Size.medium,
         modifiers: options?.modifiers
     };
 }
@@ -2733,16 +2700,20 @@ export function colour(value, options) {
  * Creates a `ColourElement` component instance.
  *
  * @remarks
- * Single color swatch representation with hex value and copy affordance.
+ * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
  *
  * @param value - Hexadecimal color code
- * @param options - Optional settings (modifiers).
+ * @param options - Optional settings (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
  * @returns A strongly-typed `ColourElement` object.
  */
-export function colorSwatch(value, options) {
+export function color(value, options) {
     return {
-        type: "color-swatch",
+        type: "color",
         value,
+        label: options?.label,
+        showText: options?.showText ?? true,
+        shape: options?.shape ?? Shape.circle,
+        size: options?.size ?? Size.medium,
         modifiers: options?.modifiers
     };
 }
@@ -2885,15 +2856,15 @@ export function booleanBadge(value, options) {
  * @remarks
  * Formatted date and time representation.
  *
- * @param value - ISO 8601 date string or epoch timestamp in milliseconds
- * @param options - Optional settings (format (defaults to `full`), modifiers).
+ * @param value - The timestamp in milliseconds
+ * @param options - Optional settings (format (defaults to `datetime`), modifiers).
  * @returns A strongly-typed `TimestampElement` object.
  */
 export function timestamp(value, options) {
     return {
         type: "timestamp",
         value,
-        format: options?.format ?? TimestampFormat.full,
+        format: options?.format ?? TimestampFormat.datetime,
         modifiers: options?.modifiers
     };
 }
@@ -2935,36 +2906,6 @@ export function imageRef(src, options) {
         placeholder: options?.placeholder
     };
 }
-/**
- * Creates a `DominantColourSetElement` component instance.
- *
- * @remarks
- * Dominant color set palette rendered in descending dominance order.
- *
- * @param colors - List of hexadecimal color strings in descending priority
- * @returns A strongly-typed `DominantColourSetElement` object.
- */
-export function dominantColourSet(colors) {
-    return {
-        type: "color-set",
-        colors: [...colors]
-    };
-}
-/**
- * Creates a `DominantColourSetElement` component instance.
- *
- * @remarks
- * Dominant color set palette rendered in descending dominance order.
- *
- * @param colors - List of hexadecimal color strings in descending priority
- * @returns A strongly-typed `DominantColourSetElement` object.
- */
-export function dominantColors(colors) {
-    return {
-        type: "color-set",
-        colors: [...colors]
-    };
-}
 /**
  * Creates a `ButtonActionElement` component instance.
  *
@@ -3091,7 +3032,7 @@ export function slot(content, options) {
     };
 }
 /**
- * Creates a `MultiSlotRowElement` component instance.
+ * Creates a `MultiSlotElement` component instance.
  *
  * @remarks
  * Multi-slot horizontal row with declared column width proportions.
@@ -3099,25 +3040,7 @@ export function slot(content, options) {
  *
  * @param slots - List of slots comprising the row
  * @param options - Optional settings (proportions).
- * @returns A strongly-typed `MultiSlotRowElement` object.
- */
-export function multiSlotRow(slots, options) {
-    return {
-        type: "multi-slot",
-        slots: [...slots],
-        proportions: options?.proportions
-    };
-}
-/**
- * Creates a `MultiSlotRowElement` component instance.
- *
- * @remarks
- * Multi-slot horizontal row with declared column width proportions.
- * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
- *
- * @param slots - List of slots comprising the row
- * @param options - Optional settings (proportions).
- * @returns A strongly-typed `MultiSlotRowElement` object.
+ * @returns A strongly-typed `MultiSlotElement` object.
  */
 export function multiSlot(slots, options) {
     return {
@@ -3127,27 +3050,23 @@ export function multiSlot(slots, options) {
     };
 }
 /**
- * Creates a `LabelValueRowElement` component instance.
+ * Creates a `FlowingElement` component instance.
  *
  * @remarks
- * Standard label and value row.
- * Displays a muted label on the left and value representation on the right with a vertical dividing line.
+ * Flowing inline layout container with automatic line wrapping.
+ * Renders child elements horizontally in sequence, automatically wrapping to the next line when space runs out.
  *
- * @param label - Key or descriptive label displayed muted on the left
- * @param value - Rendered value element on the right
- * @param options - Optional settings (withDivider (defaults to `false`)).
- * @returns A strongly-typed `LabelValueRowElement` object.
+ * @param elements - List of child elements rendered sequentially with line wrapping
+ * @returns A strongly-typed `FlowingElement` object.
  */
-export function labelValueRow(label, value, options) {
+export function flowing(elements) {
     return {
-        type: "label-value",
-        label,
-        value,
-        withDivider: options?.withDivider ?? false
+        type: "flowing",
+        elements: [...elements]
     };
 }
 /**
- * Creates a `LabelValueRowElement` component instance.
+ * Creates a `LabelValueElement` component instance.
  *
  * @remarks
  * Standard label and value row.
@@ -3156,7 +3075,7 @@ export function labelValueRow(label, value, options) {
  * @param label - Key or descriptive label displayed muted on the left
  * @param value - Rendered value element on the right
  * @param options - Optional settings (withDivider (defaults to `false`)).
- * @returns A strongly-typed `LabelValueRowElement` object.
+ * @returns A strongly-typed `LabelValueElement` object.
  */
 export function labelValue(label, value, options) {
     return {
@@ -3481,7 +3400,7 @@ export function isUiElement(value, withDeepValidation = false) {
             return isIdentifierElement(element, true);
         case "ratio":
             return isRatioElement(element, true);
-        case "color-swatch":
+        case "color":
             return isColourElement(element, true);
         case "number-unbounded":
             return isNumberUnboundedElement(element, true);
@@ -3497,16 +3416,16 @@ export function isUiElement(value, withDeepValidation = false) {
             return isTimestampElement(element, true);
         case "image-ref":
             return isImageReferenceElement(element, true);
-        case "color-set":
-            return isDominantColourSetElement(element, true);
         case "markdown":
             return isMarkdownBlockElement(element, true);
         case "html":
             return isHtmlBlockElement(element, true);
         case "multi-slot":
-            return isMultiSlotRowElement(element, true);
+            return isMultiSlotElement(element, true);
+        case "flowing":
+            return isFlowingElement(element, true);
         case "label-value":
-            return isLabelValueRowElement(element, true);
+            return isLabelValueElement(element, true);
         case "table":
             return isTableElement(element, true);
         case "repeating-group":
@@ -3663,7 +3582,7 @@ export function isRatioElement(value, withDeepValidation = false) {
         return true;
     }
     const element = value;
-    return ("value" in value && typeof element.value === "string") &&
+    return ("value" in value && typeof element.value === "number") &&
         (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
 }
 /**
@@ -3671,10 +3590,10 @@ export function isRatioElement(value, withDeepValidation = false) {
  *
  * @param value - The value to inspect.
  * @param withDeepValidation - Whether to recursively validate all properties.
- * @returns `true` if the value is a `ColourElement` (type = "color-swatch"), otherwise `false`.
+ * @returns `true` if the value is a `ColourElement` (type = "color"), otherwise `false`.
  */
 export function isColourElement(value, withDeepValidation = false) {
-    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "color-swatch") {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "color") {
         return false;
     }
     if (!withDeepValidation) {
@@ -3682,6 +3601,10 @@ export function isColourElement(value, withDeepValidation = false) {
     }
     const element = value;
     return ("value" in value && typeof element.value === "string") &&
+        (element.label === undefined || typeof element.label === "string") &&
+        (element.showText === undefined || typeof element.showText === "boolean") &&
+        (element.shape === undefined || Object.values(Shape).includes(element.shape)) &&
+        (element.size === undefined || Object.values(Size).includes(element.size)) &&
         (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
 }
 /**
@@ -3798,7 +3721,7 @@ export function isTimestampElement(value, withDeepValidation = false) {
         return true;
     }
     const element = value;
-    return ("value" in value && typeof element.value === "string") &&
+    return ("value" in value && typeof element.value === "number") &&
         (element.format === undefined || Object.values(TimestampFormat).includes(element.format)) &&
         (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
 }
@@ -3822,23 +3745,6 @@ export function isImageReferenceElement(value, withDeepValidation = false) {
         (element.aspectRatio === undefined || typeof element.aspectRatio === "string") &&
         (element.placeholder === undefined || typeof element.placeholder === "string");
 }
-/**
- * Type guard predicate narrowing a value to `DominantColourSetElement`.
- *
- * @param value - The value to inspect.
- * @param withDeepValidation - Whether to recursively validate all properties.
- * @returns `true` if the value is a `DominantColourSetElement` (type = "color-set"), otherwise `false`.
- */
-export function isDominantColourSetElement(value, withDeepValidation = false) {
-    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "color-set") {
-        return false;
-    }
-    if (!withDeepValidation) {
-        return true;
-    }
-    const element = value;
-    return ("colors" in value && (Array.isArray(element.colors) && element.colors.every((item) => typeof item === "string")));
-}
 /**
  * Type guard predicate narrowing a value to `MarkdownBlockElement`.
  *
@@ -3876,13 +3782,13 @@ export function isHtmlBlockElement(value, withDeepValidation = false) {
         (element.modifiers === undefined || isBaseModifiers(element.modifiers, true));
 }
 /**
- * Type guard predicate narrowing a value to `MultiSlotRowElement`.
+ * Type guard predicate narrowing a value to `MultiSlotElement`.
  *
  * @param value - The value to inspect.
  * @param withDeepValidation - Whether to recursively validate all properties.
- * @returns `true` if the value is a `MultiSlotRowElement` (type = "multi-slot"), otherwise `false`.
+ * @returns `true` if the value is a `MultiSlotElement` (type = "multi-slot"), otherwise `false`.
  */
-export function isMultiSlotRowElement(value, withDeepValidation = false) {
+export function isMultiSlotElement(value, withDeepValidation = false) {
     if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "multi-slot") {
         return false;
     }
@@ -3894,13 +3800,30 @@ export function isMultiSlotRowElement(value, withDeepValidation = false) {
         ("slots" in value && (Array.isArray(element.slots) && element.slots.every((item) => isSlot(item, true))));
 }
 /**
- * Type guard predicate narrowing a value to `LabelValueRowElement`.
+ * Type guard predicate narrowing a value to `FlowingElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `FlowingElement` (type = "flowing"), otherwise `false`.
+ */
+export function isFlowingElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "flowing") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("elements" in value && (Array.isArray(element.elements) && element.elements.every((item) => isUiElement(item, true))));
+}
+/**
+ * Type guard predicate narrowing a value to `LabelValueElement`.
  *
  * @param value - The value to inspect.
  * @param withDeepValidation - Whether to recursively validate all properties.
- * @returns `true` if the value is a `LabelValueRowElement` (type = "label-value"), otherwise `false`.
+ * @returns `true` if the value is a `LabelValueElement` (type = "label-value"), otherwise `false`.
  */
-export function isLabelValueRowElement(value, withDeepValidation = false) {
+export function isLabelValueElement(value, withDeepValidation = false) {
     if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "label-value") {
         return false;
     }