@picteus/extension-sdk 0.16.0 → 0.17.0

package/dist/generated/viewKit.d.ts

@@ -25,6 +25,17 @@ export declare enum TextIntensity {
     medium = "medium",
     high = "high"
 }
+/** Geometric shape representation for visual containers and indicators. */
+export declare enum Shape {
+    circle = "circle",
+    square = "square"
+}
+/** Relative sizing scale for visual elements and indicators. */
+export declare enum Size {
+    small = "small",
+    medium = "medium",
+    large = "large"
+}
 /** Representation style for short string values. */
 export declare enum StringShortRepresentation {
     plain = "plain",
@@ -45,7 +56,7 @@ export declare enum BadgeVariant {
 }
 /** Presentation format styles for timestamp elements. */
 export declare enum TimestampFormat {
-    full = "full",
+    datetime = "datetime",
     date = "date",
     time = "time",
     relative = "relative"
@@ -245,21 +256,41 @@ export interface RatioElement extends UiElementBase {
      * @defaultValue "ratio"
      */
     readonly type: "ratio";
-    /** Aspect ratio textual expression */
-    readonly value: string;
+    /** Aspect ratio numerical expression */
+    readonly value: number;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     readonly modifiers?: PrimitiveModifiers;
 }
-/** 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 interface ColourElement extends UiElementBase {
     /**
      * Discriminator type
      *
-     * @defaultValue "color-swatch"
+     * @defaultValue "color"
      */
-    readonly type: "color-swatch";
+    readonly type: "color";
     /** Hexadecimal color code */
     readonly value: string;
+    /** Optional descriptive color name label */
+    readonly label?: string;
+    /**
+     * Whether to display the textual color code or label next to the swatch
+     *
+     * @defaultValue true
+     */
+    readonly showText?: boolean;
+    /**
+     * Visual shape of the color indicator
+     *
+     * @defaultValue Shape.circle
+     */
+    readonly shape?: Shape;
+    /**
+     * Visual size of the color indicator
+     *
+     * @defaultValue Size.medium
+     */
+    readonly size?: Size;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     readonly modifiers?: PrimitiveModifiers;
 }
@@ -366,12 +397,12 @@ export interface TimestampElement extends UiElementBase {
      * @defaultValue "timestamp"
      */
     readonly type: "timestamp";
-    /** ISO 8601 date string or epoch timestamp in milliseconds */
-    readonly value: string;
+    /** The timestamp in milliseconds */
+    readonly value: number;
     /**
      * Presentation date/time format
      *
-     * @defaultValue TimestampFormat.full
+     * @defaultValue TimestampFormat.datetime
      */
     readonly format?: TimestampFormat;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
@@ -398,17 +429,6 @@ export interface ImageReferenceElement extends UiElementBase {
     /** Fallback placeholder image URI */
     readonly placeholder?: string;
 }
-/** Dominant color set palette rendered in descending dominance order. */
-export interface DominantColourSetElement extends UiElementBase {
-    /**
-     * Discriminator type
-     *
-     * @defaultValue "color-set"
-     */
-    readonly type: "color-set";
-    /** List of hexadecimal color strings in descending priority */
-    readonly colors: string[];
-}
 /** Interactive button action triggering an extension command. */
 export interface ButtonActionElement extends UiActionBase {
     /**
@@ -488,7 +508,7 @@ export interface Slot {
  * Multi-slot horizontal row with declared column width proportions.
  * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
  */
-export interface MultiSlotRowElement extends UiElementBase {
+export interface MultiSlotElement extends UiElementBase {
     /**
      * Discriminator type
      *
@@ -500,11 +520,25 @@ export interface MultiSlotRowElement extends UiElementBase {
     /** List of slots comprising the row */
     readonly slots: Slot[];
 }
+/**
+ * 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 interface FlowingElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "flowing"
+     */
+    readonly type: "flowing";
+    /** List of child elements rendered sequentially with line wrapping */
+    readonly elements: UiElement[];
+}
 /**
  * Standard label and value row.
  * Displays a muted label on the left and value representation on the right with a vertical dividing line.
  */
-export interface LabelValueRowElement extends UiElementBase {
+export interface LabelValueElement extends UiElementBase {
     /**
      * Discriminator type
      *
@@ -669,7 +703,7 @@ export interface UiCard extends UiContainer {
  * Uses the @discriminator("type") decorator so all child models inheriting from UiElement
  * are automatically recognized by schema emitters and SDK code generators.
  */
-export type UiElement = StringShortElement | StringLongElement | StringCodeElement | XmlElement | JsonElement | StringUrlElement | IdentifierElement | RatioElement | ColourElement | NumberUnboundedElement | NumberBoundedStarsElement | NumberBoundedMeterElement | BooleanPlainElement | BooleanBadgeElement | TimestampElement | ImageReferenceElement | DominantColourSetElement | MarkdownBlockElement | HtmlBlockElement | MultiSlotRowElement | LabelValueRowElement | TableElement | RepeatingGroupElement | CollapsibleGroupElement | DividerElement;
+export type UiElement = StringShortElement | StringLongElement | StringCodeElement | XmlElement | JsonElement | StringUrlElement | IdentifierElement | RatioElement | ColourElement | NumberUnboundedElement | NumberBoundedStarsElement | NumberBoundedMeterElement | BooleanPlainElement | BooleanBadgeElement | TimestampElement | ImageReferenceElement | MarkdownBlockElement | HtmlBlockElement | MultiSlotElement | FlowingElement | LabelValueElement | TableElement | RepeatingGroupElement | CollapsibleGroupElement | DividerElement;
 /** Polymorphic base model for interactive actions. */
 export type UiAction = ButtonActionElement | ExternalLinkActionElement;
 /**
@@ -973,17 +1007,17 @@ export declare class RatioElementClass extends BaseUiElement<RatioElement> imple
      * @defaultValue "ratio"
      */
     readonly type = "ratio";
-    /** Aspect ratio textual expression */
-    readonly value: string;
+    /** Aspect ratio numerical expression */
+    readonly value: number;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     readonly modifiers?: PrimitiveModifiers;
     /**
      * 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: string, options?: {
+    constructor(value: number, options?: {
         modifiers?: PrimitiveModifiers;
     });
 }
@@ -991,26 +1025,50 @@ export declare class RatioElementClass extends BaseUiElement<RatioElement> imple
  * 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 declare class ColourElementClass extends BaseUiElement<ColourElement> implements ColourElement {
     /**
      * Discriminator identifier for `ColourElement`.
      *
-     * @defaultValue "color-swatch"
+     * @defaultValue "color"
      */
-    readonly type = "color-swatch";
+    readonly type = "color";
     /** Hexadecimal color code */
     readonly value: string;
+    /** Optional descriptive color name label */
+    readonly label?: string;
+    /**
+     * Whether to display the textual color code or label next to the swatch
+     *
+     * @defaultValue true
+     */
+    readonly showText?: boolean;
+    /**
+     * Visual shape of the color indicator
+     *
+     * @defaultValue Shape.circle
+     */
+    readonly shape?: Shape;
+    /**
+     * Visual size of the color indicator
+     *
+     * @defaultValue Size.medium
+     */
+    readonly size?: Size;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     readonly modifiers?: PrimitiveModifiers;
     /**
      * 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: string, options?: {
+        label?: string;
+        showText?: boolean;
+        shape?: Shape;
+        size?: Size;
         modifiers?: PrimitiveModifiers;
     });
 }
@@ -1201,12 +1259,12 @@ export declare class TimestampElementClass extends BaseUiElement<TimestampElemen
      * @defaultValue "timestamp"
      */
     readonly type = "timestamp";
-    /** ISO 8601 date string or epoch timestamp in milliseconds */
-    readonly value: string;
+    /** The timestamp in milliseconds */
+    readonly value: number;
     /**
      * Presentation date/time format
      *
-     * @defaultValue TimestampFormat.full
+     * @defaultValue TimestampFormat.datetime
      */
     readonly format?: TimestampFormat;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
@@ -1214,10 +1272,10 @@ export declare class TimestampElementClass extends BaseUiElement<TimestampElemen
     /**
      * 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: string, options?: {
+    constructor(value: number, options?: {
         format?: TimestampFormat;
         modifiers?: PrimitiveModifiers;
     });
@@ -1259,28 +1317,6 @@ export declare class ImageReferenceElementClass extends BaseUiElement<ImageRefer
         placeholder?: string;
     });
 }
-/**
- * Class implementation of the `DominantColourSetElement` interface.
- *
- * @remarks
- * Dominant color set palette rendered in descending dominance order.
- */
-export declare class DominantColourSetElementClass extends BaseUiElement<DominantColourSetElement> implements DominantColourSetElement {
-    /**
-     * Discriminator identifier for `DominantColourSetElement`.
-     *
-     * @defaultValue "color-set"
-     */
-    readonly type = "color-set";
-    /** List of hexadecimal color strings in descending priority */
-    readonly colors: string[];
-    /**
-     * Constructs a new `DominantColourSetElementClass` instance.
-     *
-     * @param colors - List of hexadecimal color strings in descending priority
-     */
-    constructor(colors: string[]);
-}
 /**
  * Class implementation of the `ButtonActionElement` interface.
  *
@@ -1435,15 +1471,15 @@ export declare class SlotClass extends ViewKitNode<Slot> implements Slot {
     });
 }
 /**
- * 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 declare class MultiSlotRowElementClass extends BaseUiElement<MultiSlotRowElement> implements MultiSlotRowElement {
+export declare class MultiSlotElementClass extends BaseUiElement<MultiSlotElement> implements MultiSlotElement {
     /**
-     * Discriminator identifier for `MultiSlotRowElement`.
+     * Discriminator identifier for `MultiSlotElement`.
      *
      * @defaultValue "multi-slot"
      */
@@ -1453,7 +1489,7 @@ export declare class MultiSlotRowElementClass extends BaseUiElement<MultiSlotRow
     /** Proportions descriptor (e.g. "1/3 + 2/3", "equal", "1/4 + 3/4") */
     readonly proportions?: string;
     /**
-     * Constructs a new `MultiSlotRowElementClass` instance.
+     * Constructs a new `MultiSlotElementClass` instance.
      *
      * @param slots - List of slots comprising the row
      * @param options - Optional component settings. (proportions).
@@ -1463,15 +1499,38 @@ export declare class MultiSlotRowElementClass extends BaseUiElement<MultiSlotRow
     });
 }
 /**
- * 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 declare class FlowingElementClass extends BaseUiElement<FlowingElement> implements FlowingElement {
+    /**
+     * Discriminator identifier for `FlowingElement`.
+     *
+     * @defaultValue "flowing"
+     */
+    readonly type = "flowing";
+    /** List of child elements rendered sequentially with line wrapping */
+    readonly elements: UiElement[];
+    /**
+     * Constructs a new `FlowingElementClass` instance.
+     *
+     * @param elements - List of child elements rendered sequentially with line wrapping
+     */
+    constructor(elements: UiElement[]);
+}
+/**
+ * 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 declare class LabelValueRowElementClass extends BaseUiElement<LabelValueRowElement> implements LabelValueRowElement {
+export declare class LabelValueElementClass extends BaseUiElement<LabelValueElement> implements LabelValueElement {
     /**
-     * Discriminator identifier for `LabelValueRowElement`.
+     * Discriminator identifier for `LabelValueElement`.
      *
      * @defaultValue "label-value"
      */
@@ -1487,7 +1546,7 @@ export declare class LabelValueRowElementClass extends BaseUiElement<LabelValueR
      */
     readonly withDivider?: boolean;
     /**
-     * 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
@@ -1920,37 +1979,45 @@ export declare 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.
      */
-    addRatio(value: string, options?: {
+    addRatio(value: number, options?: {
         modifiers?: PrimitiveModifiers;
     }): this;
     /**
      * 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: string, options?: {
+        label?: string;
+        showText?: boolean;
+        shape?: Shape;
+        size?: Size;
         modifiers?: PrimitiveModifiers;
     }): this;
     /**
      * 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: string, options?: {
+    addColor(value: string, options?: {
+        label?: string;
+        showText?: boolean;
+        shape?: Shape;
+        size?: Size;
         modifiers?: PrimitiveModifiers;
     }): this;
     /**
@@ -2064,11 +2131,11 @@ export declare 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: string, options?: {
+    addTimestamp(value: number, options?: {
         format?: TimestampFormat;
         modifiers?: PrimitiveModifiers;
     }): this;
@@ -2102,26 +2169,6 @@ export declare class UiContainerBuilder {
         aspectRatio?: string;
         placeholder?: string;
     }): this;
-    /**
-     * 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: string[]): this;
-    /**
-     * 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: string[]): this;
     /**
      * Appends a `MarkdownBlockElement` component.
      *
@@ -2175,21 +2222,7 @@ export declare class UiContainerBuilder {
         modifiers?: BaseModifiers;
     }): this;
     /**
-     * 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: Slot[], options?: {
-        proportions?: string;
-    }): this;
-    /**
-     * Appends a `MultiSlotRowElement` component.
+     * Appends a `MultiSlotElement` component.
      *
      * @remarks
      * Multi-slot horizontal row with declared column width proportions.
@@ -2203,22 +2236,18 @@ export declare class UiContainerBuilder {
         proportions?: string;
     }): this;
     /**
-     * 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: string, value: UiElement, options?: {
-        withDivider?: boolean;
-    }): this;
+    addFlowing(elements: UiElement[]): this;
     /**
-     * Appends a `LabelValueRowElement` component.
+     * Appends a `LabelValueElement` component.
      *
      * @remarks
      * Standard label and value row.
@@ -2515,37 +2544,45 @@ export declare 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.
      */
-    addRatio(value: string, options?: {
+    addRatio(value: number, options?: {
         modifiers?: PrimitiveModifiers;
     }): this;
     /**
      * 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: string, options?: {
+        label?: string;
+        showText?: boolean;
+        shape?: Shape;
+        size?: Size;
         modifiers?: PrimitiveModifiers;
     }): this;
     /**
      * 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: string, options?: {
+    addColor(value: string, options?: {
+        label?: string;
+        showText?: boolean;
+        shape?: Shape;
+        size?: Size;
         modifiers?: PrimitiveModifiers;
     }): this;
     /**
@@ -2659,11 +2696,11 @@ export declare 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: string, options?: {
+    addTimestamp(value: number, options?: {
         format?: TimestampFormat;
         modifiers?: PrimitiveModifiers;
     }): this;
@@ -2697,26 +2734,6 @@ export declare class UiCardBuilder {
         aspectRatio?: string;
         placeholder?: string;
     }): this;
-    /**
-     * 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: string[]): this;
-    /**
-     * 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: string[]): this;
     /**
      * Appends a `MarkdownBlockElement` component.
      *
@@ -2770,21 +2787,7 @@ export declare class UiCardBuilder {
         modifiers?: BaseModifiers;
     }): this;
     /**
-     * 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: Slot[], options?: {
-        proportions?: string;
-    }): this;
-    /**
-     * Appends a `MultiSlotRowElement` component.
+     * Appends a `MultiSlotElement` component.
      *
      * @remarks
      * Multi-slot horizontal row with declared column width proportions.
@@ -2798,22 +2801,18 @@ export declare class UiCardBuilder {
         proportions?: string;
     }): this;
     /**
-     * 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: string, value: UiElement, options?: {
-        withDivider?: boolean;
-    }): this;
+    addFlowing(elements: UiElement[]): this;
     /**
-     * Appends a `LabelValueRowElement` component.
+     * Appends a `LabelValueElement` component.
      *
      * @remarks
      * Standard label and value row.
@@ -3107,37 +3106,45 @@ export declare function identifier(value: string, 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.
  */
-export declare function ratio(value: string, options?: {
+export declare function ratio(value: number, options?: {
     modifiers?: PrimitiveModifiers;
 }): RatioElement;
 /**
  * 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 declare function colour(value: string, options?: {
+    label?: string;
+    showText?: boolean;
+    shape?: Shape;
+    size?: Size;
     modifiers?: PrimitiveModifiers;
 }): ColourElement;
 /**
  * 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 declare function colorSwatch(value: string, options?: {
+export declare function color(value: string, options?: {
+    label?: string;
+    showText?: boolean;
+    shape?: Shape;
+    size?: Size;
     modifiers?: PrimitiveModifiers;
 }): ColourElement;
 /**
@@ -3251,11 +3258,11 @@ export declare function booleanBadge(value: boolean, 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 declare function timestamp(value: string, options?: {
+export declare function timestamp(value: number, options?: {
     format?: TimestampFormat;
     modifiers?: PrimitiveModifiers;
 }): TimestampElement;
@@ -3289,26 +3296,6 @@ export declare function imageRef(src: string, options?: {
     aspectRatio?: string;
     placeholder?: string;
 }): ImageReferenceElement;
-/**
- * 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 declare function dominantColourSet(colors: string[]): DominantColourSetElement;
-/**
- * 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 declare function dominantColors(colors: string[]): DominantColourSetElement;
 /**
  * Creates a `ButtonActionElement` component instance.
  *
@@ -3405,21 +3392,7 @@ export declare function slot(content: UiElement, options?: {
     width?: string;
 }): Slot;
 /**
- * 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.
- */
-export declare function multiSlotRow(slots: Slot[], options?: {
-    proportions?: string;
-}): MultiSlotRowElement;
-/**
- * Creates a `MultiSlotRowElement` component instance.
+ * Creates a `MultiSlotElement` component instance.
  *
  * @remarks
  * Multi-slot horizontal row with declared column width proportions.
@@ -3427,28 +3400,24 @@ export declare function multiSlotRow(slots: Slot[], options?: {
  *
  * @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 declare function multiSlot(slots: Slot[], options?: {
     proportions?: string;
-}): MultiSlotRowElement;
+}): MultiSlotElement;
 /**
- * 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 declare function labelValueRow(label: string, value: UiElement, options?: {
-    withDivider?: boolean;
-}): LabelValueRowElement;
+export declare function flowing(elements: UiElement[]): FlowingElement;
 /**
- * Creates a `LabelValueRowElement` component instance.
+ * Creates a `LabelValueElement` component instance.
  *
  * @remarks
  * Standard label and value row.
@@ -3457,11 +3426,11 @@ export declare function labelValueRow(label: string, value: UiElement, 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 declare function labelValue(label: string, value: UiElement, options?: {
     withDivider?: boolean;
-}): LabelValueRowElement;
+}): LabelValueElement;
 /**
  * Creates a `TableColumn` component instance.
  *
@@ -3711,7 +3680,7 @@ export declare function isRatioElement(value: unknown, withDeepValidation?: bool
  *
  * @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 declare function isColourElement(value: unknown, withDeepValidation?: boolean): value is ColourElement;
 /**
@@ -3770,14 +3739,6 @@ export declare function isTimestampElement(value: unknown, withDeepValidation?:
  * @returns `true` if the value is a `ImageReferenceElement` (type = "image-ref"), otherwise `false`.
  */
 export declare function isImageReferenceElement(value: unknown, withDeepValidation?: boolean): value is ImageReferenceElement;
-/**
- * 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 declare function isDominantColourSetElement(value: unknown, withDeepValidation?: boolean): value is DominantColourSetElement;
 /**
  * Type guard predicate narrowing a value to `MarkdownBlockElement`.
  *
@@ -3795,21 +3756,29 @@ export declare function isMarkdownBlockElement(value: unknown, withDeepValidatio
  */
 export declare function isHtmlBlockElement(value: unknown, withDeepValidation?: boolean): value is HtmlBlockElement;
 /**
- * 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 `MultiSlotElement` (type = "multi-slot"), otherwise `false`.
+ */
+export declare function isMultiSlotElement(value: unknown, withDeepValidation?: boolean): value is MultiSlotElement;
+/**
+ * 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 `MultiSlotRowElement` (type = "multi-slot"), otherwise `false`.
+ * @returns `true` if the value is a `FlowingElement` (type = "flowing"), otherwise `false`.
  */
-export declare function isMultiSlotRowElement(value: unknown, withDeepValidation?: boolean): value is MultiSlotRowElement;
+export declare function isFlowingElement(value: unknown, withDeepValidation?: boolean): value is FlowingElement;
 /**
- * Type guard predicate narrowing a value to `LabelValueRowElement`.
+ * 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 declare function isLabelValueRowElement(value: unknown, withDeepValidation?: boolean): value is LabelValueRowElement;
+export declare function isLabelValueElement(value: unknown, withDeepValidation?: boolean): value is LabelValueElement;
 /**
  * Type guard predicate narrowing a value to `TableElement`.
  *