@picteus/extension-sdk 0.17.0 → 0.18.0

package/dist/generated/viewKit.d.ts

@@ -36,10 +36,20 @@ export declare enum Size {
     medium = "medium",
     large = "large"
 }
-/** Representation style for short string values. */
-export declare enum StringShortRepresentation {
+/** 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 {
@@ -47,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",
@@ -74,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",
@@ -145,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;
 }
@@ -261,6 +292,21 @@ export interface RatioElement extends UiElementBase {
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     readonly modifiers?: PrimitiveModifiers;
 }
+/** 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 {
     /**
@@ -345,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")
      *
@@ -381,7 +423,7 @@ export interface BooleanBadgeElement extends UiElementBase {
      */
     readonly falseLabel?: string;
     /**
-     * Badge color tone
+     * Badge color tone when rendered as badge
      *
      * @defaultValue BadgeVariant.neutral
      */
@@ -499,15 +541,12 @@ 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".
- */
+/** Multi-slot horizontal row layout comprising slots with individual widths. */
 export interface MultiSlotElement extends UiElementBase {
     /**
      * Discriminator type
@@ -515,8 +554,6 @@ export interface MultiSlotElement extends UiElementBase {
      * @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[];
 }
@@ -531,6 +568,8 @@ export interface FlowingElement extends UiElementBase {
      * @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[];
 }
@@ -566,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 {
@@ -585,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
      *
@@ -703,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 | MarkdownBlockElement | HtmlBlockElement | MultiSlotElement | FlowingElement | LabelValueElement | 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;
 /**
@@ -792,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;
     });
 }
@@ -1021,6 +1071,36 @@ export declare class RatioElementClass extends BaseUiElement<RatioElement> imple
         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.
  *
@@ -1172,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.
-     *
-     * @param value - Boolean state value
-     * @param options - Optional component settings. (modifiers).
-     */
-    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`.
+     * 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")
      *
@@ -1226,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
      */
@@ -1234,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;
@@ -1457,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.
      *
@@ -1467,15 +1528,14 @@ export declare class SlotClass extends ViewKitNode<Slot> implements Slot {
      */
     constructor(content: UiElement, options?: {
         label?: string;
-        width?: string;
+        width?: number;
     });
 }
 /**
  * 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 MultiSlotElementClass extends BaseUiElement<MultiSlotElement> implements MultiSlotElement {
     /**
@@ -1486,17 +1546,12 @@ export declare class MultiSlotElementClass extends BaseUiElement<MultiSlotElemen
     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 `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.
@@ -1514,12 +1569,17 @@ export declare class FlowingElementClass extends BaseUiElement<FlowingElement> i
     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[]);
+    constructor(elements: UiElement[], options?: {
+        separator?: Separator;
+    });
 }
 /**
  * Class implementation of the `LabelValueElement` interface.
@@ -1571,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;
     });
 }
 /**
@@ -1616,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
      *
@@ -1646,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;
@@ -1879,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;
     /**
@@ -1986,6 +2049,20 @@ export declare class UiContainerBuilder {
     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.
      *
@@ -2097,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;
@@ -2225,16 +2291,12 @@ export declare class UiContainerBuilder {
      * 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 `FlowingElement` component.
      *
@@ -2243,9 +2305,12 @@ export declare class UiContainerBuilder {
      * Renders child elements horizontally in sequence, automatically wrapping to the next line when space runs out.
      *
      * @param elements - List of child elements rendered sequentially with line wrapping
+     * @param options - Optional component settings (separator).
      * @returns This builder instance for method chaining.
      */
-    addFlowing(elements: UiElement[]): this;
+    addFlowing(elements: UiElement[], options?: {
+        separator?: Separator;
+    }): this;
     /**
      * Appends a `LabelValueElement` component.
      *
@@ -2269,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;
@@ -2444,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;
     /**
@@ -2551,6 +2618,20 @@ export declare class UiCardBuilder {
     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.
      *
@@ -2662,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;
@@ -2790,16 +2860,12 @@ export declare class UiCardBuilder {
      * 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 `FlowingElement` component.
      *
@@ -2808,9 +2874,12 @@ export declare class UiCardBuilder {
      * Renders child elements horizontally in sequence, automatically wrapping to the next line when space runs out.
      *
      * @param elements - List of child elements rendered sequentially with line wrapping
+     * @param options - Optional component settings (separator).
      * @returns This builder instance for method chaining.
      */
-    addFlowing(elements: UiElement[]): this;
+    addFlowing(elements: UiElement[], options?: {
+        separator?: Separator;
+    }): this;
     /**
      * Appends a `LabelValueElement` component.
      *
@@ -2834,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;
@@ -3006,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.
  *
@@ -3113,6 +3184,20 @@ export declare function identifier(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.
  *
@@ -3224,34 +3309,23 @@ export declare function numberMeter(value: number, options?: {
     modifiers?: PrimitiveModifiers;
 }): NumberBoundedMeterElement;
 /**
- * Creates a `BooleanPlainElement` component instance.
- *
- * @remarks
- * Plain boolean value representation (textual "true" / "false").
- *
- * @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.
+ * Creates a `BooleanElement` component instance.
  *
  * @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 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.
  *
@@ -3389,22 +3463,18 @@ export declare function html(content: string, options?: {
  */
 export declare function slot(content: UiElement, options?: {
     label?: string;
-    width?: string;
+    width?: number;
 }): Slot;
 /**
  * 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 `MultiSlotElement` object.
  */
-export declare function multiSlot(slots: Slot[], options?: {
-    proportions?: string;
-}): MultiSlotElement;
+export declare function multiSlot(slots: Slot[]): MultiSlotElement;
 /**
  * Creates a `FlowingElement` component instance.
  *
@@ -3413,9 +3483,12 @@ export declare function multiSlot(slots: Slot[], options?: {
  * Renders child elements horizontally in sequence, automatically wrapping to the next line when space runs out.
  *
  * @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 flowing(elements: UiElement[]): FlowingElement;
+export declare function flowing(elements: UiElement[], options?: {
+    separator?: Separator;
+}): FlowingElement;
 /**
  * Creates a `LabelValueElement` component instance.
  *
@@ -3437,13 +3510,14 @@ export declare function labelValue(label: string, value: UiElement, options?: {
  * @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.
@@ -3463,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;
@@ -3612,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`.
  *
@@ -3675,6 +3748,14 @@ 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`.
  *
@@ -3708,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`.
  *