@picteus/extension-sdk 0.16.0 → 0.18.0

package/dist/generated/viewKit.d.ts

@@ -25,10 +25,31 @@ export declare enum TextIntensity {
     medium = "medium",
     high = "high"
 }
-/** Representation style for short string values. */
-export declare enum StringShortRepresentation {
+/** 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"
+}
+/** Visual presentation style for string values. */
+export declare enum StringRepresentation {
     plain = "plain",
-    chip = "chip"
+    chip = "chip",
+    multiline = "multiline"
+}
+/** Visual separator rendered between sequential elements or items. */
+export declare enum Separator {
+    bar = "bar",
+    comma = "comma",
+    dot = "dot",
+    slash = "slash",
+    dash = "dash",
+    space = "space"
 }
 /** Supported syntax highlighting languages for formatted code blocks. */
 export declare enum CodeLanguage {
@@ -36,6 +57,11 @@ export declare enum CodeLanguage {
     json = "json",
     yaml = "yaml"
 }
+/** Visual presentation style for boolean values. */
+export declare enum BooleanRepresentation {
+    plain = "plain",
+    badge = "badge"
+}
 /** Visual color tone variants for badge pill representations. */
 export declare enum BadgeVariant {
     neutral = "neutral",
@@ -45,7 +71,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"
@@ -63,6 +89,11 @@ export declare enum TableColumnAlign {
     center = "center",
     right = "right"
 }
+/** Width mode for table columns. */
+export declare enum TableColumnWidthMode {
+    fixed = "fixed",
+    maximum = "maximum"
+}
 /** Visual styling variants for hairline dividers. */
 export declare enum DividerStyle {
     hairline = "hairline",
@@ -134,37 +165,48 @@ export interface PrimitiveModifiers extends BaseModifiers {
     readonly monospace?: boolean;
 }
 /**
- * Short string primitive element.
- * Supports plain text or compact chip pill presentation.
+ * Universal textual string primitive element.
+ * Supports plain text, compact chip pill, or multiline pre-wrapped presentation.
  */
-export interface StringShortElement extends UiElementBase {
+export interface StringElement extends UiElementBase {
     /**
      * Discriminator type
      *
-     * @defaultValue "string-short"
+     * @defaultValue "string"
      */
-    readonly type: "string-short";
+    readonly type: "string";
     /** Text value */
     readonly value: string;
     /**
      * Display representation mode
      *
-     * @defaultValue StringShortRepresentation.plain
+     * @defaultValue StringRepresentation.plain
      */
-    readonly representation?: StringShortRepresentation;
+    readonly representation?: StringRepresentation;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     readonly modifiers?: PrimitiveModifiers;
 }
-/** Multiline text block primitive element for descriptions, comments, or prose. */
-export interface StringLongElement extends UiElementBase {
+/**
+ * Collection of textual string values rendered as a sequence of inline items or chips.
+ * Supports visual separators (comma, dot, slash, bar, dash, space) and copyable affordance.
+ */
+export interface StringsElement extends UiElementBase {
     /**
      * Discriminator type
      *
-     * @defaultValue "string-long"
+     * @defaultValue "strings"
      */
-    readonly type: "string-long";
-    /** Text value */
-    readonly value: string;
+    readonly type: "strings";
+    /** Array of string values */
+    readonly values: string[];
+    /**
+     * Display representation mode (plain text or visual chips)
+     *
+     * @defaultValue StringRepresentation.plain
+     */
+    readonly representation?: StringRepresentation;
+    /** Optional visual separator rendered between sequential values */
+    readonly separator?: Separator;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     readonly modifiers?: PrimitiveModifiers;
 }
@@ -245,21 +287,56 @@ 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. */
+/** Image dimensions representation displaying formatted width and height in pixels. */
+export interface DimensionsElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "dimensions"
+     */
+    readonly type: "dimensions";
+    /** Width in pixels */
+    readonly width: number;
+    /** Height in pixels */
+    readonly height: number;
+    /** Optional visual modifiers (copyable) */
+    readonly modifiers?: BaseModifiers;
+}
+/** 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;
 }
@@ -314,29 +391,25 @@ export interface NumberBoundedMeterElement extends UiElementBase {
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     readonly modifiers?: PrimitiveModifiers;
 }
-/** Plain boolean value representation (textual "true" / "false"). */
-export interface BooleanPlainElement extends UiElementBase {
+/**
+ * Universal boolean primitive element.
+ * Supports standard plain text or badge pill presentation with customizable labels and variants.
+ */
+export interface BooleanElement extends UiElementBase {
     /**
      * Discriminator type
      *
-     * @defaultValue "boolean-plain"
+     * @defaultValue "boolean"
      */
-    readonly type: "boolean-plain";
+    readonly type: "boolean";
     /** Boolean state value */
     readonly value: boolean;
-    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
-    readonly modifiers?: PrimitiveModifiers;
-}
-/** Visual badge pill representation of a boolean state. */
-export interface BooleanBadgeElement extends UiElementBase {
     /**
-     * Discriminator type
+     * Display representation mode
      *
-     * @defaultValue "boolean-badge"
+     * @defaultValue BooleanRepresentation.plain
      */
-    readonly type: "boolean-badge";
-    /** Boolean state value */
-    readonly value: boolean;
+    readonly representation?: BooleanRepresentation;
     /**
      * Custom display label when true (defaults to "true")
      *
@@ -350,7 +423,7 @@ export interface BooleanBadgeElement extends UiElementBase {
      */
     readonly falseLabel?: string;
     /**
-     * Badge color tone
+     * Badge color tone when rendered as badge
      *
      * @defaultValue BadgeVariant.neutral
      */
@@ -366,12 +439,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 +471,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 {
     /**
@@ -479,32 +541,43 @@ export interface HtmlBlockElement extends UiElementBase {
 export interface Slot {
     /** Optional slot label (e.g. "Slot A") */
     readonly label?: string;
-    /** Relative or fractional width proportion (e.g. "1/3", "2/3", "100px", "auto") */
-    readonly width?: string;
+    /** Width percentage (1-100) */
+    readonly width?: number;
     /** Rendered content inside the slot */
     readonly content: UiElement;
 }
-/**
- * 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 {
+/** Multi-slot horizontal row layout comprising slots with individual widths. */
+export interface MultiSlotElement extends UiElementBase {
     /**
      * Discriminator type
      *
      * @defaultValue "multi-slot"
      */
     readonly type: "multi-slot";
-    /** Proportions descriptor (e.g. "1/3 + 2/3", "equal", "1/4 + 3/4") */
-    readonly proportions?: string;
     /** 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";
+    /** Optional visual separator rendered between sequential child elements */
+    readonly separator?: Separator;
+    /** 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
      *
@@ -532,8 +605,14 @@ export interface TableColumn {
      * @defaultValue TableColumnAlign.left
      */
     readonly align?: TableColumnAlign;
-    /** Optional width constraint */
-    readonly width?: string;
+    /** Width percentage (1-100) */
+    readonly width?: number;
+    /**
+     * Sizing mode for the provided width
+     *
+     * @defaultValue TableColumnWidthMode.fixed
+     */
+    readonly widthMode?: TableColumnWidthMode;
 }
 /** Single table row containing an array of cell values. */
 export interface TableRow {
@@ -551,12 +630,6 @@ export interface TableElement extends UiElementBase {
      * @defaultValue "table"
      */
     readonly type: "table";
-    /**
-     * Whether to render a column header row
-     *
-     * @defaultValue true
-     */
-    readonly hasHeader?: boolean;
     /**
      * Whether to render alternating row background colors
      *
@@ -669,7 +742,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 = StringElement | StringsElement | StringCodeElement | XmlElement | JsonElement | StringUrlElement | IdentifierElement | RatioElement | DimensionsElement | ColourElement | NumberUnboundedElement | NumberBoundedStarsElement | NumberBoundedMeterElement | BooleanElement | TimestampElement | ImageReferenceElement | MarkdownBlockElement | HtmlBlockElement | MultiSlotElement | FlowingElement | LabelValueElement | TableElement | RepeatingGroupElement | CollapsibleGroupElement | DividerElement;
 /** Polymorphic base model for interactive actions. */
 export type UiAction = ButtonActionElement | ExternalLinkActionElement;
 /**
@@ -758,64 +831,75 @@ export declare class PrimitiveModifiersClass extends ViewKitNode<PrimitiveModifi
     });
 }
 /**
- * Class implementation of the `StringShortElement` interface.
+ * Class implementation of the `StringElement` interface.
  *
  * @remarks
- * Short string primitive element.
- * Supports plain text or compact chip pill presentation.
+ * Universal textual string primitive element.
+ * Supports plain text, compact chip pill, or multiline pre-wrapped presentation.
  */
-export declare class StringShortElementClass extends BaseUiElement<StringShortElement> implements StringShortElement {
+export declare class StringElementClass extends BaseUiElement<StringElement> implements StringElement {
     /**
-     * Discriminator identifier for `StringShortElement`.
+     * Discriminator identifier for `StringElement`.
      *
-     * @defaultValue "string-short"
+     * @defaultValue "string"
      */
-    readonly type = "string-short";
+    readonly type = "string";
     /** Text value */
     readonly value: string;
     /**
      * Display representation mode
      *
-     * @defaultValue StringShortRepresentation.plain
+     * @defaultValue StringRepresentation.plain
      */
-    readonly representation?: StringShortRepresentation;
+    readonly representation?: StringRepresentation;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     readonly modifiers?: PrimitiveModifiers;
     /**
-     * Constructs a new `StringShortElementClass` instance.
+     * Constructs a new `StringElementClass` instance.
      *
      * @param value - Text value
      * @param options - Optional component settings. (representation (defaults to `plain`), modifiers).
      */
     constructor(value: string, options?: {
-        representation?: StringShortRepresentation;
+        representation?: StringRepresentation;
         modifiers?: PrimitiveModifiers;
     });
 }
 /**
- * Class implementation of the `StringLongElement` interface.
+ * Class implementation of the `StringsElement` interface.
  *
  * @remarks
- * Multiline text block primitive element for descriptions, comments, or prose.
+ * Collection of textual string values rendered as a sequence of inline items or chips.
+ * Supports visual separators (comma, dot, slash, bar, dash, space) and copyable affordance.
  */
-export declare class StringLongElementClass extends BaseUiElement<StringLongElement> implements StringLongElement {
+export declare class StringsElementClass extends BaseUiElement<StringsElement> implements StringsElement {
     /**
-     * Discriminator identifier for `StringLongElement`.
+     * Discriminator identifier for `StringsElement`.
      *
-     * @defaultValue "string-long"
+     * @defaultValue "strings"
      */
-    readonly type = "string-long";
-    /** Text value */
-    readonly value: string;
+    readonly type = "strings";
+    /** Array of string values */
+    readonly values: string[];
+    /**
+     * Display representation mode (plain text or visual chips)
+     *
+     * @defaultValue StringRepresentation.plain
+     */
+    readonly representation?: StringRepresentation;
+    /** Optional visual separator rendered between sequential values */
+    readonly separator?: Separator;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     readonly modifiers?: PrimitiveModifiers;
     /**
-     * Constructs a new `StringLongElementClass` instance.
+     * Constructs a new `StringsElementClass` instance.
      *
-     * @param value - Text value
-     * @param options - Optional component settings. (modifiers).
+     * @param values - Array of string values
+     * @param options - Optional component settings. (representation (defaults to `plain`), separator, modifiers).
      */
-    constructor(value: string, options?: {
+    constructor(values: string[], options?: {
+        representation?: StringRepresentation;
+        separator?: Separator;
         modifiers?: PrimitiveModifiers;
     });
 }
@@ -973,44 +1057,98 @@ 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;
     });
 }
+/**
+ * Class implementation of the `DimensionsElement` interface.
+ *
+ * @remarks
+ * Image dimensions representation displaying formatted width and height in pixels.
+ */
+export declare class DimensionsElementClass extends BaseUiElement<DimensionsElement> implements DimensionsElement {
+    /**
+     * Discriminator identifier for `DimensionsElement`.
+     *
+     * @defaultValue "dimensions"
+     */
+    readonly type = "dimensions";
+    /** Width in pixels */
+    readonly width: number;
+    /** Height in pixels */
+    readonly height: number;
+    /** Optional visual modifiers (copyable) */
+    readonly modifiers?: BaseModifiers;
+    /**
+     * Constructs a new `DimensionsElementClass` instance.
+     *
+     * @param width - Width in pixels
+     * @param height - Height in pixels
+     * @param options - Optional component settings. (modifiers).
+     */
+    constructor(width: number, height: number, options?: {
+        modifiers?: BaseModifiers;
+    });
+}
 /**
  * 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;
     });
 }
@@ -1114,47 +1252,27 @@ export declare class NumberBoundedMeterElementClass extends BaseUiElement<Number
     });
 }
 /**
- * Class implementation of the `BooleanPlainElement` interface.
+ * Class implementation of the `BooleanElement` interface.
  *
  * @remarks
- * Plain boolean value representation (textual "true" / "false").
+ * Universal boolean primitive element.
+ * Supports standard plain text or badge pill presentation with customizable labels and variants.
  */
-export declare class BooleanPlainElementClass extends BaseUiElement<BooleanPlainElement> implements BooleanPlainElement {
+export declare class BooleanElementClass extends BaseUiElement<BooleanElement> implements BooleanElement {
     /**
-     * Discriminator identifier for `BooleanPlainElement`.
+     * Discriminator identifier for `BooleanElement`.
      *
-     * @defaultValue "boolean-plain"
+     * @defaultValue "boolean"
      */
-    readonly type = "boolean-plain";
+    readonly type = "boolean";
     /** Boolean state value */
     readonly value: boolean;
-    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
-    readonly modifiers?: PrimitiveModifiers;
     /**
-     * Constructs a new `BooleanPlainElementClass` instance.
+     * Display representation mode
      *
-     * @param value - Boolean state value
-     * @param options - Optional component settings. (modifiers).
+     * @defaultValue BooleanRepresentation.plain
      */
-    constructor(value: boolean, options?: {
-        modifiers?: PrimitiveModifiers;
-    });
-}
-/**
- * Class implementation of the `BooleanBadgeElement` interface.
- *
- * @remarks
- * Visual badge pill representation of a boolean state.
- */
-export declare class BooleanBadgeElementClass extends BaseUiElement<BooleanBadgeElement> implements BooleanBadgeElement {
-    /**
-     * Discriminator identifier for `BooleanBadgeElement`.
-     *
-     * @defaultValue "boolean-badge"
-     */
-    readonly type = "boolean-badge";
-    /** Boolean state value */
-    readonly value: boolean;
+    readonly representation?: BooleanRepresentation;
     /**
      * Custom display label when true (defaults to "true")
      *
@@ -1168,7 +1286,7 @@ export declare class BooleanBadgeElementClass extends BaseUiElement<BooleanBadge
      */
     readonly falseLabel?: string;
     /**
-     * Badge color tone
+     * Badge color tone when rendered as badge
      *
      * @defaultValue BadgeVariant.neutral
      */
@@ -1176,12 +1294,13 @@ export declare class BooleanBadgeElementClass extends BaseUiElement<BooleanBadge
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     readonly modifiers?: PrimitiveModifiers;
     /**
-     * Constructs a new `BooleanBadgeElementClass` instance.
+     * Constructs a new `BooleanElementClass` instance.
      *
      * @param value - Boolean state value
-     * @param options - Optional component settings. (trueLabel (defaults to `true`), falseLabel (defaults to `false`), variant (defaults to `neutral`), modifiers).
+     * @param options - Optional component settings. (representation (defaults to `plain`), trueLabel (defaults to `true`), falseLabel (defaults to `false`), variant (defaults to `neutral`), modifiers).
      */
     constructor(value: boolean, options?: {
+        representation?: BooleanRepresentation;
         trueLabel?: string;
         falseLabel?: string;
         variant?: BadgeVariant;
@@ -1201,12 +1320,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 +1333,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 +1378,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.
  *
@@ -1421,8 +1518,8 @@ export declare class SlotClass extends ViewKitNode<Slot> implements Slot {
     readonly content: UiElement;
     /** Optional slot label (e.g. "Slot A") */
     readonly label?: string;
-    /** Relative or fractional width proportion (e.g. "1/3", "2/3", "100px", "auto") */
-    readonly width?: string;
+    /** Width percentage (1-100) */
+    readonly width?: number;
     /**
      * Constructs a new `SlotClass` instance.
      *
@@ -1431,47 +1528,69 @@ export declare class SlotClass extends ViewKitNode<Slot> implements Slot {
      */
     constructor(content: UiElement, options?: {
         label?: string;
-        width?: string;
+        width?: number;
     });
 }
 /**
- * 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".
+ * Multi-slot horizontal row layout comprising slots with individual widths.
  */
-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"
      */
     readonly type = "multi-slot";
     /** List of slots comprising the row */
     readonly slots: Slot[];
-    /** 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).
      */
-    constructor(slots: Slot[], options?: {
-        proportions?: string;
+    constructor(slots: Slot[]);
+}
+/**
+ * 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[];
+    /** Optional visual separator rendered between sequential child elements */
+    readonly separator?: Separator;
+    /**
+     * Constructs a new `FlowingElementClass` instance.
+     *
+     * @param elements - List of child elements rendered sequentially with line wrapping
+     * @param options - Optional component settings. (separator).
+     */
+    constructor(elements: UiElement[], options?: {
+        separator?: Separator;
     });
 }
 /**
- * Class implementation of the `LabelValueRowElement` interface.
+ * 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 +1606,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
@@ -1512,17 +1631,24 @@ export declare class TableColumnClass extends ViewKitNode<TableColumn> implement
      * @defaultValue TableColumnAlign.left
      */
     readonly align?: TableColumnAlign;
-    /** Optional width constraint */
-    readonly width?: string;
+    /** Width percentage (1-100) */
+    readonly width?: number;
+    /**
+     * Sizing mode for the provided width
+     *
+     * @defaultValue TableColumnWidthMode.fixed
+     */
+    readonly widthMode?: TableColumnWidthMode;
     /**
      * Constructs a new `TableColumnClass` instance.
      *
-     * @param options - Optional component settings. (header, align (defaults to `left`), width).
+     * @param options - Optional component settings. (header, align (defaults to `left`), width, widthMode (defaults to `fixed`)).
      */
     constructor(options?: {
         header?: string;
         align?: TableColumnAlign;
-        width?: string;
+        width?: number;
+        widthMode?: TableColumnWidthMode;
     });
 }
 /**
@@ -1557,12 +1683,6 @@ export declare class TableElementClass extends BaseUiElement<TableElement> imple
     readonly type = "table";
     /** Tabular data rows */
     readonly rows: TableRow[];
-    /**
-     * Whether to render a column header row
-     *
-     * @defaultValue true
-     */
-    readonly hasHeader?: boolean;
     /**
      * Whether to render alternating row background colors
      *
@@ -1587,10 +1707,9 @@ export declare class TableElementClass extends BaseUiElement<TableElement> imple
      * Constructs a new `TableElementClass` instance.
      *
      * @param rows - Tabular data rows
-     * @param options - Optional component settings. (hasHeader (defaults to `true`), isStriped (defaults to `false`), withColumnSeparators (defaults to `false`), withRowSeparators (defaults to `false`), columns).
+     * @param options - Optional component settings. (isStriped (defaults to `false`), withColumnSeparators (defaults to `false`), withRowSeparators (defaults to `false`), columns).
      */
     constructor(rows: TableRow[], options?: {
-        hasHeader?: boolean;
         isStriped?: boolean;
         withColumnSeparators?: boolean;
         withRowSeparators?: boolean;
@@ -1820,31 +1939,34 @@ export declare class UiContainerBuilder {
      */
     addElements(...items: UiElement[]): this;
     /**
-     * Appends a `StringShortElement` component.
+     * Appends a `StringElement` component.
      *
      * @remarks
-     * Short string primitive element.
-     * Supports plain text or compact chip pill presentation.
+     * Universal textual string primitive element.
+     * Supports plain text, compact chip pill, or multiline pre-wrapped presentation.
      *
      * @param value - Text value
      * @param options - Optional component settings (representation (defaults to `plain`), modifiers).
      * @returns This builder instance for method chaining.
      */
-    addStringShort(value: string, options?: {
-        representation?: StringShortRepresentation;
+    addString(value: string, options?: {
+        representation?: StringRepresentation;
         modifiers?: PrimitiveModifiers;
     }): this;
     /**
-     * Appends a `StringLongElement` component.
+     * Appends a `StringsElement` component.
      *
      * @remarks
-     * Multiline text block primitive element for descriptions, comments, or prose.
+     * Collection of textual string values rendered as a sequence of inline items or chips.
+     * Supports visual separators (comma, dot, slash, bar, dash, space) and copyable affordance.
      *
-     * @param value - Text value
-     * @param options - Optional component settings (modifiers).
+     * @param values - Array of string values
+     * @param options - Optional component settings (representation (defaults to `plain`), separator, modifiers).
      * @returns This builder instance for method chaining.
      */
-    addStringLong(value: string, options?: {
+    addStrings(values: string[], options?: {
+        representation?: StringRepresentation;
+        separator?: Separator;
         modifiers?: PrimitiveModifiers;
     }): this;
     /**
@@ -1920,37 +2042,59 @@ 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 `DimensionsElement` component.
+     *
+     * @remarks
+     * Image dimensions representation displaying formatted width and height in pixels.
+     *
+     * @param width - Width in pixels
+     * @param height - Height in pixels
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addDimensions(width: number, height: number, options?: {
+        modifiers?: BaseModifiers;
+    }): 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;
     /**
@@ -2030,29 +2174,18 @@ export declare class UiContainerBuilder {
         modifiers?: PrimitiveModifiers;
     }): this;
     /**
-     * Appends a `BooleanPlainElement` component.
-     *
-     * @remarks
-     * Plain boolean value representation (textual "true" / "false").
-     *
-     * @param value - Boolean state value
-     * @param options - Optional component settings (modifiers).
-     * @returns This builder instance for method chaining.
-     */
-    addBooleanPlain(value: boolean, options?: {
-        modifiers?: PrimitiveModifiers;
-    }): this;
-    /**
-     * Appends a `BooleanBadgeElement` component.
+     * Appends a `BooleanElement` component.
      *
      * @remarks
-     * Visual badge pill representation of a boolean state.
+     * Universal boolean primitive element.
+     * Supports standard plain text or badge pill presentation with customizable labels and variants.
      *
      * @param value - Boolean state value
-     * @param options - Optional component settings (trueLabel (defaults to `true`), falseLabel (defaults to `false`), variant (defaults to `neutral`), modifiers).
+     * @param options - Optional component settings (representation (defaults to `plain`), trueLabel (defaults to `true`), falseLabel (defaults to `false`), variant (defaults to `neutral`), modifiers).
      * @returns This builder instance for method chaining.
      */
-    addBooleanBadge(value: boolean, options?: {
+    addBoolean(value: boolean, options?: {
+        representation?: BooleanRepresentation;
         trueLabel?: string;
         falseLabel?: string;
         variant?: BadgeVariant;
@@ -2064,11 +2197,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 +2235,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,50 +2288,31 @@ 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.
-     * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
+     * Multi-slot horizontal row layout comprising slots with individual widths.
      *
      * @param slots - List of slots comprising the row
-     * @param options - Optional component settings (proportions).
      * @returns This builder instance for method chaining.
      */
-    addMultiSlot(slots: Slot[], options?: {
-        proportions?: string;
-    }): this;
+    addMultiSlot(slots: Slot[]): 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
+     * @param options - Optional component settings (separator).
      * @returns This builder instance for method chaining.
      */
-    addLabelValueRow(label: string, value: UiElement, options?: {
-        withDivider?: boolean;
+    addFlowing(elements: UiElement[], options?: {
+        separator?: Separator;
     }): this;
     /**
-     * Appends a `LabelValueRowElement` component.
+     * Appends a `LabelValueElement` component.
      *
      * @remarks
      * Standard label and value row.
@@ -2240,11 +2334,10 @@ export declare class UiContainerBuilder {
      * Supports header/borderless modes, 2-column key-value tables, and 3-column data tables.
      *
      * @param rows - Tabular data rows
-     * @param options - Optional component settings (hasHeader (defaults to `true`), isStriped (defaults to `false`), withColumnSeparators (defaults to `false`), withRowSeparators (defaults to `false`), columns).
+     * @param options - Optional component settings (isStriped (defaults to `false`), withColumnSeparators (defaults to `false`), withRowSeparators (defaults to `false`), columns).
      * @returns This builder instance for method chaining.
      */
     addTable(rows: TableRow[], options?: {
-        hasHeader?: boolean;
         isStriped?: boolean;
         withColumnSeparators?: boolean;
         withRowSeparators?: boolean;
@@ -2415,31 +2508,34 @@ export declare class UiCardBuilder {
      */
     addElements(...items: UiElement[]): this;
     /**
-     * Appends a `StringShortElement` component.
+     * Appends a `StringElement` component.
      *
      * @remarks
-     * Short string primitive element.
-     * Supports plain text or compact chip pill presentation.
+     * Universal textual string primitive element.
+     * Supports plain text, compact chip pill, or multiline pre-wrapped presentation.
      *
      * @param value - Text value
      * @param options - Optional component settings (representation (defaults to `plain`), modifiers).
      * @returns This builder instance for method chaining.
      */
-    addStringShort(value: string, options?: {
-        representation?: StringShortRepresentation;
+    addString(value: string, options?: {
+        representation?: StringRepresentation;
         modifiers?: PrimitiveModifiers;
     }): this;
     /**
-     * Appends a `StringLongElement` component.
+     * Appends a `StringsElement` component.
      *
      * @remarks
-     * Multiline text block primitive element for descriptions, comments, or prose.
+     * Collection of textual string values rendered as a sequence of inline items or chips.
+     * Supports visual separators (comma, dot, slash, bar, dash, space) and copyable affordance.
      *
-     * @param value - Text value
-     * @param options - Optional component settings (modifiers).
+     * @param values - Array of string values
+     * @param options - Optional component settings (representation (defaults to `plain`), separator, modifiers).
      * @returns This builder instance for method chaining.
      */
-    addStringLong(value: string, options?: {
+    addStrings(values: string[], options?: {
+        representation?: StringRepresentation;
+        separator?: Separator;
         modifiers?: PrimitiveModifiers;
     }): this;
     /**
@@ -2515,37 +2611,59 @@ 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 `DimensionsElement` component.
+     *
+     * @remarks
+     * Image dimensions representation displaying formatted width and height in pixels.
+     *
+     * @param width - Width in pixels
+     * @param height - Height in pixels
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addDimensions(width: number, height: number, options?: {
+        modifiers?: BaseModifiers;
+    }): 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;
     /**
@@ -2625,29 +2743,18 @@ export declare class UiCardBuilder {
         modifiers?: PrimitiveModifiers;
     }): this;
     /**
-     * Appends a `BooleanPlainElement` component.
-     *
-     * @remarks
-     * Plain boolean value representation (textual "true" / "false").
-     *
-     * @param value - Boolean state value
-     * @param options - Optional component settings (modifiers).
-     * @returns This builder instance for method chaining.
-     */
-    addBooleanPlain(value: boolean, options?: {
-        modifiers?: PrimitiveModifiers;
-    }): this;
-    /**
-     * Appends a `BooleanBadgeElement` component.
+     * Appends a `BooleanElement` component.
      *
      * @remarks
-     * Visual badge pill representation of a boolean state.
+     * Universal boolean primitive element.
+     * Supports standard plain text or badge pill presentation with customizable labels and variants.
      *
      * @param value - Boolean state value
-     * @param options - Optional component settings (trueLabel (defaults to `true`), falseLabel (defaults to `false`), variant (defaults to `neutral`), modifiers).
+     * @param options - Optional component settings (representation (defaults to `plain`), trueLabel (defaults to `true`), falseLabel (defaults to `false`), variant (defaults to `neutral`), modifiers).
      * @returns This builder instance for method chaining.
      */
-    addBooleanBadge(value: boolean, options?: {
+    addBoolean(value: boolean, options?: {
+        representation?: BooleanRepresentation;
         trueLabel?: string;
         falseLabel?: string;
         variant?: BadgeVariant;
@@ -2659,11 +2766,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 +2804,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,50 +2857,31 @@ export declare class UiCardBuilder {
         modifiers?: BaseModifiers;
     }): this;
     /**
-     * Appends a `MultiSlotRowElement` component.
+     * Appends a `MultiSlotElement` component.
      *
      * @remarks
-     * Multi-slot horizontal row with declared column width proportions.
-     * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
+     * Multi-slot horizontal row layout comprising slots with individual widths.
      *
      * @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;
+    addMultiSlot(slots: Slot[]): this;
     /**
-     * Appends a `MultiSlotRowElement` component.
+     * Appends a `FlowingElement` component.
      *
      * @remarks
-     * Multi-slot horizontal row with declared column width proportions.
-     * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
+     * 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 slots - List of slots comprising the row
-     * @param options - Optional component settings (proportions).
+     * @param elements - List of child elements rendered sequentially with line wrapping
+     * @param options - Optional component settings (separator).
      * @returns This builder instance for method chaining.
      */
-    addMultiSlot(slots: Slot[], options?: {
-        proportions?: string;
+    addFlowing(elements: UiElement[], options?: {
+        separator?: Separator;
     }): this;
     /**
-     * Appends a `LabelValueRowElement` 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.
-     *
-     * @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`)).
-     * @returns This builder instance for method chaining.
-     */
-    addLabelValueRow(label: string, value: UiElement, options?: {
-        withDivider?: boolean;
-    }): this;
-    /**
-     * Appends a `LabelValueRowElement` component.
+     * Appends a `LabelValueElement` component.
      *
      * @remarks
      * Standard label and value row.
@@ -2835,11 +2903,10 @@ export declare class UiCardBuilder {
      * Supports header/borderless modes, 2-column key-value tables, and 3-column data tables.
      *
      * @param rows - Tabular data rows
-     * @param options - Optional component settings (hasHeader (defaults to `true`), isStriped (defaults to `false`), withColumnSeparators (defaults to `false`), withRowSeparators (defaults to `false`), columns).
+     * @param options - Optional component settings (isStriped (defaults to `false`), withColumnSeparators (defaults to `false`), withRowSeparators (defaults to `false`), columns).
      * @returns This builder instance for method chaining.
      */
     addTable(rows: TableRow[], options?: {
-        hasHeader?: boolean;
         isStriped?: boolean;
         withColumnSeparators?: boolean;
         withRowSeparators?: boolean;
@@ -3007,33 +3074,36 @@ export declare function primitiveModifiers(options?: {
     copyable?: boolean;
 }): PrimitiveModifiers;
 /**
- * Creates a `StringShortElement` component instance.
+ * Creates a `StringElement` component instance.
  *
  * @remarks
- * Short string primitive element.
- * Supports plain text or compact chip pill presentation.
+ * Universal textual string primitive element.
+ * Supports plain text, compact chip pill, or multiline pre-wrapped presentation.
  *
  * @param value - Text value
  * @param options - Optional settings (representation (defaults to `plain`), modifiers).
- * @returns A strongly-typed `StringShortElement` object.
+ * @returns A strongly-typed `StringElement` object.
  */
-export declare function stringShort(value: string, options?: {
-    representation?: StringShortRepresentation;
+export declare function string(value: string, options?: {
+    representation?: StringRepresentation;
     modifiers?: PrimitiveModifiers;
-}): StringShortElement;
+}): StringElement;
 /**
- * Creates a `StringLongElement` component instance.
+ * Creates a `StringsElement` component instance.
  *
  * @remarks
- * Multiline text block primitive element for descriptions, comments, or prose.
+ * Collection of textual string values rendered as a sequence of inline items or chips.
+ * Supports visual separators (comma, dot, slash, bar, dash, space) and copyable affordance.
  *
- * @param value - Text value
- * @param options - Optional settings (modifiers).
- * @returns A strongly-typed `StringLongElement` object.
+ * @param values - Array of string values
+ * @param options - Optional settings (representation (defaults to `plain`), separator, modifiers).
+ * @returns A strongly-typed `StringsElement` object.
  */
-export declare function stringLong(value: string, options?: {
+export declare function strings(values: string[], options?: {
+    representation?: StringRepresentation;
+    separator?: Separator;
     modifiers?: PrimitiveModifiers;
-}): StringLongElement;
+}): StringsElement;
 /**
  * Creates a `StringCodeElement` component instance.
  *
@@ -3107,37 +3177,59 @@ 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 `DimensionsElement` component instance.
+ *
+ * @remarks
+ * Image dimensions representation displaying formatted width and height in pixels.
+ *
+ * @param width - Width in pixels
+ * @param height - Height in pixels
+ * @param options - Optional settings (modifiers).
+ * @returns A strongly-typed `DimensionsElement` object.
+ */
+export declare function dimensions(width: number, height: number, options?: {
+    modifiers?: BaseModifiers;
+}): DimensionsElement;
 /**
  * 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;
 /**
@@ -3217,45 +3309,34 @@ export declare function numberMeter(value: number, options?: {
     modifiers?: PrimitiveModifiers;
 }): NumberBoundedMeterElement;
 /**
- * Creates a `BooleanPlainElement` component instance.
+ * Creates a `BooleanElement` component instance.
  *
  * @remarks
- * Plain boolean value representation (textual "true" / "false").
+ * Universal boolean primitive element.
+ * Supports standard plain text or badge pill presentation with customizable labels and variants.
  *
  * @param value - Boolean state value
- * @param options - Optional settings (modifiers).
- * @returns A strongly-typed `BooleanPlainElement` object.
- */
-export declare function booleanPlain(value: boolean, options?: {
-    modifiers?: PrimitiveModifiers;
-}): BooleanPlainElement;
-/**
- * Creates a `BooleanBadgeElement` component instance.
- *
- * @remarks
- * Visual badge pill representation of a boolean state.
- *
- * @param value - Boolean state value
- * @param options - Optional settings (trueLabel (defaults to `true`), falseLabel (defaults to `false`), variant (defaults to `neutral`), modifiers).
- * @returns A strongly-typed `BooleanBadgeElement` object.
+ * @param options - Optional settings (representation (defaults to `plain`), trueLabel (defaults to `true`), falseLabel (defaults to `false`), variant (defaults to `neutral`), modifiers).
+ * @returns A strongly-typed `BooleanElement` object.
  */
-export declare function booleanBadge(value: boolean, options?: {
+export declare function boolean(value: boolean, options?: {
+    representation?: BooleanRepresentation;
     trueLabel?: string;
     falseLabel?: string;
     variant?: BadgeVariant;
     modifiers?: PrimitiveModifiers;
-}): BooleanBadgeElement;
+}): BooleanElement;
 /**
  * Creates a `TimestampElement` component instance.
  *
  * @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 +3370,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.
  *
@@ -3402,53 +3463,34 @@ export declare function html(content: string, options?: {
  */
 export declare function slot(content: UiElement, options?: {
     label?: string;
-    width?: string;
+    width?: number;
 }): 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.
- * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
+ * Multi-slot horizontal row layout comprising slots with individual widths.
  *
  * @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;
+export declare function multiSlot(slots: Slot[]): 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
+ * @param options - Optional settings (separator).
+ * @returns A strongly-typed `FlowingElement` object.
  */
-export declare function labelValueRow(label: string, value: UiElement, options?: {
-    withDivider?: boolean;
-}): LabelValueRowElement;
+export declare function flowing(elements: UiElement[], options?: {
+    separator?: Separator;
+}): FlowingElement;
 /**
- * Creates a `LabelValueRowElement` component instance.
+ * Creates a `LabelValueElement` component instance.
  *
  * @remarks
  * Standard label and value row.
@@ -3457,24 +3499,25 @@ 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.
  *
  * @remarks
  * Column definition for structured tables.
  *
- * @param options - Optional settings (header, align (defaults to `left`), width).
+ * @param options - Optional settings (header, align (defaults to `left`), width, widthMode (defaults to `fixed`)).
  * @returns A strongly-typed `TableColumn` object.
  */
 export declare function tableColumn(options?: {
     header?: string;
     align?: TableColumnAlign;
-    width?: string;
+    width?: number;
+    widthMode?: TableColumnWidthMode;
 }): TableColumn;
 /**
  * Creates a `TableRow` component instance.
@@ -3494,11 +3537,10 @@ export declare function tableRow(cells: UiElement[]): TableRow;
  * Supports header/borderless modes, 2-column key-value tables, and 3-column data tables.
  *
  * @param rows - Tabular data rows
- * @param options - Optional settings (hasHeader (defaults to `true`), isStriped (defaults to `false`), withColumnSeparators (defaults to `false`), withRowSeparators (defaults to `false`), columns).
+ * @param options - Optional settings (isStriped (defaults to `false`), withColumnSeparators (defaults to `false`), withRowSeparators (defaults to `false`), columns).
  * @returns A strongly-typed `TableElement` object.
  */
 export declare function table(rows: TableRow[], options?: {
-    hasHeader?: boolean;
     isStriped?: boolean;
     withColumnSeparators?: boolean;
     withRowSeparators?: boolean;
@@ -3643,21 +3685,21 @@ export declare function isEnvelop(value: unknown, withDeepValidation?: boolean):
  */
 export declare function isUiElement(value: unknown, withDeepValidation?: boolean): value is UiElement;
 /**
- * Type guard predicate narrowing a value to `StringShortElement`.
+ * Type guard predicate narrowing a value to `StringElement`.
  *
  * @param value - The value to inspect.
  * @param withDeepValidation - Whether to recursively validate all properties.
- * @returns `true` if the value is a `StringShortElement` (type = "string-short"), otherwise `false`.
+ * @returns `true` if the value is a `StringElement` (type = "string"), otherwise `false`.
  */
-export declare function isStringShortElement(value: unknown, withDeepValidation?: boolean): value is StringShortElement;
+export declare function isStringElement(value: unknown, withDeepValidation?: boolean): value is StringElement;
 /**
- * Type guard predicate narrowing a value to `StringLongElement`.
+ * Type guard predicate narrowing a value to `StringsElement`.
  *
  * @param value - The value to inspect.
  * @param withDeepValidation - Whether to recursively validate all properties.
- * @returns `true` if the value is a `StringLongElement` (type = "string-long"), otherwise `false`.
+ * @returns `true` if the value is a `StringsElement` (type = "strings"), otherwise `false`.
  */
-export declare function isStringLongElement(value: unknown, withDeepValidation?: boolean): value is StringLongElement;
+export declare function isStringsElement(value: unknown, withDeepValidation?: boolean): value is StringsElement;
 /**
  * Type guard predicate narrowing a value to `StringCodeElement`.
  *
@@ -3706,12 +3748,20 @@ export declare function isIdentifierElement(value: unknown, withDeepValidation?:
  * @returns `true` if the value is a `RatioElement` (type = "ratio"), otherwise `false`.
  */
 export declare function isRatioElement(value: unknown, withDeepValidation?: boolean): value is RatioElement;
+/**
+ * Type guard predicate narrowing a value to `DimensionsElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `DimensionsElement` (type = "dimensions"), otherwise `false`.
+ */
+export declare function isDimensionsElement(value: unknown, withDeepValidation?: boolean): value is DimensionsElement;
 /**
  * Type guard predicate narrowing a value to `ColourElement`.
  *
  * @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;
 /**
@@ -3739,21 +3789,13 @@ export declare function isNumberBoundedStarsElement(value: unknown, withDeepVali
  */
 export declare function isNumberBoundedMeterElement(value: unknown, withDeepValidation?: boolean): value is NumberBoundedMeterElement;
 /**
- * Type guard predicate narrowing a value to `BooleanPlainElement`.
- *
- * @param value - The value to inspect.
- * @param withDeepValidation - Whether to recursively validate all properties.
- * @returns `true` if the value is a `BooleanPlainElement` (type = "boolean-plain"), otherwise `false`.
- */
-export declare function isBooleanPlainElement(value: unknown, withDeepValidation?: boolean): value is BooleanPlainElement;
-/**
- * Type guard predicate narrowing a value to `BooleanBadgeElement`.
+ * Type guard predicate narrowing a value to `BooleanElement`.
  *
  * @param value - The value to inspect.
  * @param withDeepValidation - Whether to recursively validate all properties.
- * @returns `true` if the value is a `BooleanBadgeElement` (type = "boolean-badge"), otherwise `false`.
+ * @returns `true` if the value is a `BooleanElement` (type = "boolean"), otherwise `false`.
  */
-export declare function isBooleanBadgeElement(value: unknown, withDeepValidation?: boolean): value is BooleanBadgeElement;
+export declare function isBooleanElement(value: unknown, withDeepValidation?: boolean): value is BooleanElement;
 /**
  * Type guard predicate narrowing a value to `TimestampElement`.
  *
@@ -3770,14 +3812,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 +3829,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`.
  *