@picteus/extension-sdk 0.17.0 → 0.18.0

package/dist/generated/viewKit.js

@@ -76,14 +76,32 @@ export var Size;
     // Prominent large size
     Size["large"] = "large";
 })(Size || (Size = {}));
-/** Representation style for short string values. */
-export var StringShortRepresentation;
-(function (StringShortRepresentation) {
-    // Standard plain text rendering
-    StringShortRepresentation["plain"] = "plain";
+/** Visual presentation style for string values. */
+export var StringRepresentation;
+(function (StringRepresentation) {
+    // Standard inline text rendering
+    StringRepresentation["plain"] = "plain";
     // Visual chip / tag pill representation
-    StringShortRepresentation["chip"] = "chip";
-})(StringShortRepresentation || (StringShortRepresentation = {}));
+    StringRepresentation["chip"] = "chip";
+    // Multiline text with preserved whitespace and line breaks
+    StringRepresentation["multiline"] = "multiline";
+})(StringRepresentation || (StringRepresentation = {}));
+/** Visual separator rendered between sequential elements or items. */
+export var Separator;
+(function (Separator) {
+    // Vertical dividing bar
+    Separator["bar"] = "bar";
+    // Comma separator
+    Separator["comma"] = "comma";
+    // Bullet dot separator
+    Separator["dot"] = "dot";
+    // Forward slash separator
+    Separator["slash"] = "slash";
+    // Dash separator
+    Separator["dash"] = "dash";
+    // Space separator
+    Separator["space"] = "space";
+})(Separator || (Separator = {}));
 /** Supported syntax highlighting languages for formatted code blocks. */
 export var CodeLanguage;
 (function (CodeLanguage) {
@@ -94,6 +112,14 @@ export var CodeLanguage;
     // YAML format syntax
     CodeLanguage["yaml"] = "yaml";
 })(CodeLanguage || (CodeLanguage = {}));
+/** Visual presentation style for boolean values. */
+export var BooleanRepresentation;
+(function (BooleanRepresentation) {
+    // Standard inline text rendering (e.g. "true" / "false" or custom labels)
+    BooleanRepresentation["plain"] = "plain";
+    // Visual badge pill representation
+    BooleanRepresentation["badge"] = "badge";
+})(BooleanRepresentation || (BooleanRepresentation = {}));
 /** Visual color tone variants for badge pill representations. */
 export var BadgeVariant;
 (function (BadgeVariant) {
@@ -140,6 +166,14 @@ export var TableColumnAlign;
     // Right-aligned text
     TableColumnAlign["right"] = "right";
 })(TableColumnAlign || (TableColumnAlign = {}));
+/** Width mode for table columns. */
+export var TableColumnWidthMode;
+(function (TableColumnWidthMode) {
+    // Fixed width constraint
+    TableColumnWidthMode["fixed"] = "fixed";
+    // Maximum width upper bound constraint
+    TableColumnWidthMode["maximum"] = "maximum";
+})(TableColumnWidthMode || (TableColumnWidthMode = {}));
 /** Visual styling variants for hairline dividers. */
 export var DividerStyle;
 (function (DividerStyle) {
@@ -247,31 +281,31 @@ export class PrimitiveModifiersClass extends ViewKitNode {
     }
 }
 /**
- * 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 class StringShortElementClass extends BaseUiElement {
+export class StringElementClass extends BaseUiElement {
     /**
-     * Discriminator identifier for `StringShortElement`.
+     * Discriminator identifier for `StringElement`.
      *
-     * @defaultValue "string-short"
+     * @defaultValue "string"
      */
-    type = "string-short";
+    type = "string";
     /** Text value */
     value;
     /**
      * Display representation mode
      *
-     * @defaultValue StringShortRepresentation.plain
+     * @defaultValue StringRepresentation.plain
      */
     representation;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     modifiers;
     /**
-     * Constructs a new `StringShortElementClass` instance.
+     * Constructs a new `StringElementClass` instance.
      *
      * @param value - Text value
      * @param options - Optional component settings. (representation (defaults to `plain`), modifiers).
@@ -279,36 +313,47 @@ export class StringShortElementClass extends BaseUiElement {
     constructor(value, options) {
         super();
         this.value = value;
-        this.representation = options?.representation ?? StringShortRepresentation.plain;
+        this.representation = options?.representation ?? StringRepresentation.plain;
         this.modifiers = options?.modifiers;
     }
 }
 /**
- * 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 class StringLongElementClass extends BaseUiElement {
+export class StringsElementClass extends BaseUiElement {
     /**
-     * Discriminator identifier for `StringLongElement`.
+     * Discriminator identifier for `StringsElement`.
      *
-     * @defaultValue "string-long"
+     * @defaultValue "strings"
      */
-    type = "string-long";
-    /** Text value */
-    value;
+    type = "strings";
+    /** Array of string values */
+    values;
+    /**
+     * Display representation mode (plain text or visual chips)
+     *
+     * @defaultValue StringRepresentation.plain
+     */
+    representation;
+    /** Optional visual separator rendered between sequential values */
+    separator;
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     modifiers;
     /**
-     * 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, options) {
+    constructor(values, options) {
         super();
-        this.value = value;
+        this.values = values ? [...values] : [];
+        this.representation = options?.representation ?? StringRepresentation.plain;
+        this.separator = options?.separator;
         this.modifiers = options?.modifiers;
     }
 }
@@ -492,6 +537,39 @@ export class RatioElementClass extends BaseUiElement {
         this.modifiers = options?.modifiers;
     }
 }
+/**
+ * Class implementation of the `DimensionsElement` interface.
+ *
+ * @remarks
+ * Image dimensions representation displaying formatted width and height in pixels.
+ */
+export class DimensionsElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `DimensionsElement`.
+     *
+     * @defaultValue "dimensions"
+     */
+    type = "dimensions";
+    /** Width in pixels */
+    width;
+    /** Height in pixels */
+    height;
+    /** Optional visual modifiers (copyable) */
+    modifiers;
+    /**
+     * Constructs a new `DimensionsElementClass` instance.
+     *
+     * @param width - Width in pixels
+     * @param height - Height in pixels
+     * @param options - Optional component settings. (modifiers).
+     */
+    constructor(width, height, options) {
+        super();
+        this.width = width;
+        this.height = height;
+        this.modifiers = options?.modifiers;
+    }
+}
 /**
  * Class implementation of the `ColourElement` interface.
  *
@@ -651,49 +729,27 @@ export class NumberBoundedMeterElementClass extends BaseUiElement {
     }
 }
 /**
- * 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 class BooleanPlainElementClass extends BaseUiElement {
+export class BooleanElementClass extends BaseUiElement {
     /**
-     * Discriminator identifier for `BooleanPlainElement`.
+     * Discriminator identifier for `BooleanElement`.
      *
-     * @defaultValue "boolean-plain"
+     * @defaultValue "boolean"
      */
-    type = "boolean-plain";
+    type = "boolean";
     /** Boolean state value */
     value;
-    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
-    modifiers;
-    /**
-     * Constructs a new `BooleanPlainElementClass` instance.
-     *
-     * @param value - Boolean state value
-     * @param options - Optional component settings. (modifiers).
-     */
-    constructor(value, options) {
-        super();
-        this.value = value;
-        this.modifiers = options?.modifiers;
-    }
-}
-/**
- * Class implementation of the `BooleanBadgeElement` interface.
- *
- * @remarks
- * Visual badge pill representation of a boolean state.
- */
-export class BooleanBadgeElementClass extends BaseUiElement {
     /**
-     * Discriminator identifier for `BooleanBadgeElement`.
+     * Display representation mode
      *
-     * @defaultValue "boolean-badge"
+     * @defaultValue BooleanRepresentation.plain
      */
-    type = "boolean-badge";
-    /** Boolean state value */
-    value;
+    representation;
     /**
      * Custom display label when true (defaults to "true")
      *
@@ -707,7 +763,7 @@ export class BooleanBadgeElementClass extends BaseUiElement {
      */
     falseLabel;
     /**
-     * Badge color tone
+     * Badge color tone when rendered as badge
      *
      * @defaultValue BadgeVariant.neutral
      */
@@ -715,14 +771,15 @@ export class BooleanBadgeElementClass extends BaseUiElement {
     /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
     modifiers;
     /**
-     * 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, options) {
         super();
         this.value = value;
+        this.representation = options?.representation ?? BooleanRepresentation.plain;
         this.trueLabel = options?.trueLabel ?? "true";
         this.falseLabel = options?.falseLabel ?? "false";
         this.variant = options?.variant ?? BadgeVariant.neutral;
@@ -955,7 +1012,7 @@ export class SlotClass extends ViewKitNode {
     content;
     /** Optional slot label (e.g. "Slot A") */
     label;
-    /** Relative or fractional width proportion (e.g. "1/3", "2/3", "100px", "auto") */
+    /** Width percentage (1-100) */
     width;
     /**
      * Constructs a new `SlotClass` instance.
@@ -974,8 +1031,7 @@ export class SlotClass extends ViewKitNode {
  * 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 class MultiSlotElementClass extends BaseUiElement {
     /**
@@ -986,18 +1042,14 @@ export class MultiSlotElementClass extends BaseUiElement {
     type = "multi-slot";
     /** List of slots comprising the row */
     slots;
-    /** Proportions descriptor (e.g. "1/3 + 2/3", "equal", "1/4 + 3/4") */
-    proportions;
     /**
      * Constructs a new `MultiSlotElementClass` instance.
      *
      * @param slots - List of slots comprising the row
-     * @param options - Optional component settings. (proportions).
      */
-    constructor(slots, options) {
+    constructor(slots) {
         super();
         this.slots = slots ? [...slots] : [];
-        this.proportions = options?.proportions;
     }
 }
 /**
@@ -1016,14 +1068,18 @@ export class FlowingElementClass extends BaseUiElement {
     type = "flowing";
     /** List of child elements rendered sequentially with line wrapping */
     elements;
+    /** Optional visual separator rendered between sequential child elements */
+    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) {
+    constructor(elements, options) {
         super();
         this.elements = elements ? [...elements] : [];
+        this.separator = options?.separator;
     }
 }
 /**
@@ -1079,18 +1135,25 @@ export class TableColumnClass extends ViewKitNode {
      * @defaultValue TableColumnAlign.left
      */
     align;
-    /** Optional width constraint */
+    /** Width percentage (1-100) */
     width;
+    /**
+     * Sizing mode for the provided width
+     *
+     * @defaultValue TableColumnWidthMode.fixed
+     */
+    widthMode;
     /**
      * 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) {
         super();
         this.header = options?.header;
         this.align = options?.align ?? TableColumnAlign.left;
         this.width = options?.width;
+        this.widthMode = options?.widthMode ?? TableColumnWidthMode.fixed;
     }
 }
 /**
@@ -1128,12 +1191,6 @@ export class TableElementClass extends BaseUiElement {
     type = "table";
     /** Tabular data rows */
     rows;
-    /**
-     * Whether to render a column header row
-     *
-     * @defaultValue true
-     */
-    hasHeader;
     /**
      * Whether to render alternating row background colors
      *
@@ -1158,12 +1215,11 @@ export class TableElementClass extends BaseUiElement {
      * 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, options) {
         super();
         this.rows = rows ? [...rows] : [];
-        this.hasHeader = options?.hasHeader ?? true;
         this.isStriped = options?.isStriped ?? false;
         this.withColumnSeparators = options?.withColumnSeparators ?? false;
         this.withRowSeparators = options?.withRowSeparators ?? false;
@@ -1414,31 +1470,32 @@ export class UiContainerBuilder {
         return 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, options) {
-        return this.add(stringShort(value, options));
+    addString(value, options) {
+        return this.add(string(value, options));
     }
     /**
-     * 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, options) {
-        return this.add(stringLong(value, options));
+    addStrings(values, options) {
+        return this.add(strings(values, options));
     }
     /**
      * Appends a `StringCodeElement` component.
@@ -1518,6 +1575,20 @@ export class UiContainerBuilder {
     addRatio(value, options) {
         return this.add(ratio(value, options));
     }
+    /**
+     * 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, height, options) {
+        return this.add(dimensions(width, height, options));
+    }
     /**
      * Appends a `ColourElement` component.
      *
@@ -1610,30 +1681,18 @@ export class UiContainerBuilder {
         return this.add(numberMeter(value, options));
     }
     /**
-     * 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, options) {
-        return this.add(booleanPlain(value, options));
-    }
-    /**
-     * 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, options) {
-        return this.add(booleanBadge(value, options));
+    addBoolean(value, options) {
+        return this.add(boolean(value, options));
     }
     /**
      * Appends a `TimestampElement` component.
@@ -1730,15 +1789,13 @@ export 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, options) {
-        return this.add(multiSlot(slots, options));
+    addMultiSlot(slots) {
+        return this.add(multiSlot(slots));
     }
     /**
      * Appends a `FlowingElement` component.
@@ -1748,10 +1805,11 @@ export 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) {
-        return this.add(flowing(elements));
+    addFlowing(elements, options) {
+        return this.add(flowing(elements, options));
     }
     /**
      * Appends a `LabelValueElement` component.
@@ -1776,7 +1834,7 @@ export 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, options) {
@@ -1979,31 +2037,32 @@ export class UiCardBuilder {
         return 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, options) {
-        return this.add(stringShort(value, options));
+    addString(value, options) {
+        return this.add(string(value, options));
     }
     /**
-     * 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, options) {
-        return this.add(stringLong(value, options));
+    addStrings(values, options) {
+        return this.add(strings(values, options));
     }
     /**
      * Appends a `StringCodeElement` component.
@@ -2083,6 +2142,20 @@ export class UiCardBuilder {
     addRatio(value, options) {
         return this.add(ratio(value, options));
     }
+    /**
+     * 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, height, options) {
+        return this.add(dimensions(width, height, options));
+    }
     /**
      * Appends a `ColourElement` component.
      *
@@ -2175,30 +2248,18 @@ export class UiCardBuilder {
         return this.add(numberMeter(value, options));
     }
     /**
-     * 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, options) {
-        return this.add(booleanPlain(value, options));
-    }
-    /**
-     * 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, options) {
-        return this.add(booleanBadge(value, options));
+    addBoolean(value, options) {
+        return this.add(boolean(value, options));
     }
     /**
      * Appends a `TimestampElement` component.
@@ -2295,15 +2356,13 @@ export 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, options) {
-        return this.add(multiSlot(slots, options));
+    addMultiSlot(slots) {
+        return this.add(multiSlot(slots));
     }
     /**
      * Appends a `FlowingElement` component.
@@ -2313,10 +2372,11 @@ export 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) {
-        return this.add(flowing(elements));
+    addFlowing(elements, options) {
+        return this.add(flowing(elements, options));
     }
     /**
      * Appends a `LabelValueElement` component.
@@ -2341,7 +2401,7 @@ export 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, options) {
@@ -2536,38 +2596,41 @@ export function primitiveModifiers(options) {
     };
 }
 /**
- * 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 function stringShort(value, options) {
+export function string(value, options) {
     return {
-        type: "string-short",
+        type: "string",
         value,
-        representation: options?.representation ?? StringShortRepresentation.plain,
+        representation: options?.representation ?? StringRepresentation.plain,
         modifiers: options?.modifiers
     };
 }
 /**
- * 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 function stringLong(value, options) {
+export function strings(values, options) {
     return {
-        type: "string-long",
-        value,
+        type: "strings",
+        values: [...values],
+        representation: options?.representation ?? StringRepresentation.plain,
+        separator: options?.separator,
         modifiers: options?.modifiers
     };
 }
@@ -2675,6 +2738,25 @@ export function ratio(value, options) {
         modifiers: options?.modifiers
     };
 }
+/**
+ * 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 function dimensions(width, height, options) {
+    return {
+        type: "dimensions",
+        width,
+        height,
+        modifiers: options?.modifiers
+    };
+}
 /**
  * Creates a `ColourElement` component instance.
  *
@@ -2814,36 +2896,21 @@ export function numberMeter(value, options) {
     };
 }
 /**
- * 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 function booleanPlain(value, options) {
-    return {
-        type: "boolean-plain",
-        value,
-        modifiers: options?.modifiers
-    };
-}
-/**
- * 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 function booleanBadge(value, options) {
+export function boolean(value, options) {
     return {
-        type: "boolean-badge",
+        type: "boolean",
         value,
+        representation: options?.representation ?? BooleanRepresentation.plain,
         trueLabel: options?.trueLabel ?? "true",
         falseLabel: options?.falseLabel ?? "false",
         variant: options?.variant ?? BadgeVariant.neutral,
@@ -3035,18 +3102,15 @@ export function slot(content, options) {
  * 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 function multiSlot(slots, options) {
+export function multiSlot(slots) {
     return {
         type: "multi-slot",
-        slots: [...slots],
-        proportions: options?.proportions
+        slots: [...slots]
     };
 }
 /**
@@ -3057,12 +3121,14 @@ export function multiSlot(slots, 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 function flowing(elements) {
+export function flowing(elements, options) {
     return {
         type: "flowing",
-        elements: [...elements]
+        elements: [...elements],
+        separator: options?.separator
     };
 }
 /**
@@ -3091,14 +3157,15 @@ export function labelValue(label, value, 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 function tableColumn(options) {
     return {
         header: options?.header,
         align: options?.align ?? TableColumnAlign.left,
-        width: options?.width
+        width: options?.width,
+        widthMode: options?.widthMode ?? TableColumnWidthMode.fixed
     };
 }
 /**
@@ -3123,14 +3190,13 @@ export function tableRow(cells) {
  * 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 function table(rows, options) {
     return {
         type: "table",
         rows: [...rows],
-        hasHeader: options?.hasHeader ?? true,
         isStriped: options?.isStriped ?? false,
         withColumnSeparators: options?.withColumnSeparators ?? false,
         withRowSeparators: options?.withRowSeparators ?? false,
@@ -3293,7 +3359,7 @@ export function isSlot(value, withDeepValidation = false) {
     }
     const element = value;
     return (element.label === undefined || typeof element.label === "string") &&
-        (element.width === undefined || typeof element.width === "string") &&
+        (element.width === undefined || typeof element.width === "number") &&
         ("content" in value && isUiElement(element.content, true));
 }
 /**
@@ -3313,7 +3379,8 @@ export function isTableColumn(value, withDeepValidation = false) {
     const element = value;
     return (element.header === undefined || typeof element.header === "string") &&
         (element.align === undefined || Object.values(TableColumnAlign).includes(element.align)) &&
-        (element.width === undefined || typeof element.width === "string");
+        (element.width === undefined || typeof element.width === "number") &&
+        (element.widthMode === undefined || Object.values(TableColumnWidthMode).includes(element.widthMode));
 }
 /**
  * Type guard predicate verifying whether an unknown value conforms to `TableRow`.
@@ -3384,10 +3451,10 @@ export function isUiElement(value, withDeepValidation = false) {
     }
     const element = value;
     switch (element.type) {
-        case "string-short":
-            return isStringShortElement(element, true);
-        case "string-long":
-            return isStringLongElement(element, true);
+        case "string":
+            return isStringElement(element, true);
+        case "strings":
+            return isStringsElement(element, true);
         case "string-code":
             return isStringCodeElement(element, true);
         case "xml":
@@ -3400,6 +3467,8 @@ export function isUiElement(value, withDeepValidation = false) {
             return isIdentifierElement(element, true);
         case "ratio":
             return isRatioElement(element, true);
+        case "dimensions":
+            return isDimensionsElement(element, true);
         case "color":
             return isColourElement(element, true);
         case "number-unbounded":
@@ -3408,10 +3477,8 @@ export function isUiElement(value, withDeepValidation = false) {
             return isNumberBoundedStarsElement(element, true);
         case "number-meter":
             return isNumberBoundedMeterElement(element, true);
-        case "boolean-plain":
-            return isBooleanPlainElement(element, true);
-        case "boolean-badge":
-            return isBooleanBadgeElement(element, true);
+        case "boolean":
+            return isBooleanElement(element, true);
         case "timestamp":
             return isTimestampElement(element, true);
         case "image-ref":
@@ -3439,14 +3506,14 @@ export function isUiElement(value, withDeepValidation = false) {
     }
 }
 /**
- * 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 function isStringShortElement(value, withDeepValidation = false) {
-    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "string-short") {
+export function isStringElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "string") {
         return false;
     }
     if (!withDeepValidation) {
@@ -3454,25 +3521,27 @@ export function isStringShortElement(value, withDeepValidation = false) {
     }
     const element = value;
     return ("value" in value && typeof element.value === "string") &&
-        (element.representation === undefined || Object.values(StringShortRepresentation).includes(element.representation)) &&
+        (element.representation === undefined || Object.values(StringRepresentation).includes(element.representation)) &&
         (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
 }
 /**
- * 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 function isStringLongElement(value, withDeepValidation = false) {
-    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "string-long") {
+export function isStringsElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "strings") {
         return false;
     }
     if (!withDeepValidation) {
         return true;
     }
     const element = value;
-    return ("value" in value && typeof element.value === "string") &&
+    return ("values" in value && (Array.isArray(element.values) && element.values.every((item) => typeof item === "string"))) &&
+        (element.representation === undefined || Object.values(StringRepresentation).includes(element.representation)) &&
+        (element.separator === undefined || Object.values(Separator).includes(element.separator)) &&
         (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
 }
 /**
@@ -3585,6 +3654,25 @@ export function isRatioElement(value, withDeepValidation = false) {
     return ("value" in value && typeof element.value === "number") &&
         (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
 }
+/**
+ * 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 function isDimensionsElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "dimensions") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("width" in value && typeof element.width === "number") &&
+        ("height" in value && typeof element.height === "number") &&
+        (element.modifiers === undefined || isBaseModifiers(element.modifiers, true));
+}
 /**
  * Type guard predicate narrowing a value to `ColourElement`.
  *
@@ -3668,32 +3756,14 @@ export function isNumberBoundedMeterElement(value, withDeepValidation = false) {
         (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
 }
 /**
- * Type guard predicate narrowing a value to `BooleanPlainElement`.
+ * 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 `BooleanPlainElement` (type = "boolean-plain"), otherwise `false`.
+ * @returns `true` if the value is a `BooleanElement` (type = "boolean"), otherwise `false`.
  */
-export function isBooleanPlainElement(value, withDeepValidation = false) {
-    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "boolean-plain") {
-        return false;
-    }
-    if (!withDeepValidation) {
-        return true;
-    }
-    const element = value;
-    return ("value" in value && typeof element.value === "boolean") &&
-        (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
-}
-/**
- * Type guard predicate narrowing a value to `BooleanBadgeElement`.
- *
- * @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`.
- */
-export function isBooleanBadgeElement(value, withDeepValidation = false) {
-    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "boolean-badge") {
+export function isBooleanElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "boolean") {
         return false;
     }
     if (!withDeepValidation) {
@@ -3701,6 +3771,7 @@ export function isBooleanBadgeElement(value, withDeepValidation = false) {
     }
     const element = value;
     return ("value" in value && typeof element.value === "boolean") &&
+        (element.representation === undefined || Object.values(BooleanRepresentation).includes(element.representation)) &&
         (element.trueLabel === undefined || typeof element.trueLabel === "string") &&
         (element.falseLabel === undefined || typeof element.falseLabel === "string") &&
         (element.variant === undefined || Object.values(BadgeVariant).includes(element.variant)) &&
@@ -3796,8 +3867,7 @@ export function isMultiSlotElement(value, withDeepValidation = false) {
         return true;
     }
     const element = value;
-    return (element.proportions === undefined || typeof element.proportions === "string") &&
-        ("slots" in value && (Array.isArray(element.slots) && element.slots.every((item) => isSlot(item, true))));
+    return ("slots" in value && (Array.isArray(element.slots) && element.slots.every((item) => isSlot(item, true))));
 }
 /**
  * Type guard predicate narrowing a value to `FlowingElement`.
@@ -3814,7 +3884,8 @@ export function isFlowingElement(value, withDeepValidation = false) {
         return true;
     }
     const element = value;
-    return ("elements" in value && (Array.isArray(element.elements) && element.elements.every((item) => isUiElement(item, true))));
+    return (element.separator === undefined || Object.values(Separator).includes(element.separator)) &&
+        ("elements" in value && (Array.isArray(element.elements) && element.elements.every((item) => isUiElement(item, true))));
 }
 /**
  * Type guard predicate narrowing a value to `LabelValueElement`.
@@ -3850,8 +3921,7 @@ export function isTableElement(value, withDeepValidation = false) {
         return true;
     }
     const element = value;
-    return (element.hasHeader === undefined || typeof element.hasHeader === "boolean") &&
-        (element.isStriped === undefined || typeof element.isStriped === "boolean") &&
+    return (element.isStriped === undefined || typeof element.isStriped === "boolean") &&
         (element.withColumnSeparators === undefined || typeof element.withColumnSeparators === "boolean") &&
         (element.withRowSeparators === undefined || typeof element.withRowSeparators === "boolean") &&
         (element.columns === undefined || (Array.isArray(element.columns) && element.columns.every((item) => isTableColumn(item, true)))) &&