@picteus/extension-sdk 0.15.0 → 0.17.0

package/dist/generated/viewKit.js

@@ -0,0 +1,4022 @@
+// ---------------------------------------------------------------------------
+// Auto-generated by @picteus/specification-factory emitter. Do not edit directly.
+// ---------------------------------------------------------------------------
+/** Generic base class providing recursive JSON serialization for all model instances. */
+export class ViewKitNode {
+    /**
+     * Serializes this model instance into a strongly-typed, JSON-compatible plain object.
+     *
+     * @returns The plain object representation conforming to interface `T`.
+     */
+    toJSON() {
+        const result = {};
+        for (const [key, value] of Object.entries(this)) {
+            if (value !== undefined) {
+                if (Array.isArray(value)) {
+                    result[key] = value.map((item) => {
+                        return item && typeof item === "object" && typeof item.toJSON === "function"
+                            ? item.toJSON()
+                            : item;
+                    });
+                }
+                else if (value && typeof value === "object" && typeof value.toJSON === "function") {
+                    result[key] = value.toJSON();
+                }
+                else {
+                    result[key] = value;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Returns the compact JSON string representation of this model instance with no indentation.
+     *
+     * @returns Compact JSON string without indentation.
+     */
+    toString() {
+        return JSON.stringify(this.toJSON());
+    }
+}
+/** Typographic stroke weight styling. */
+export var TextWeight;
+(function (TextWeight) {
+    // Thin / light text weight
+    TextWeight["thin"] = "thin";
+    // Standard text weight
+    TextWeight["normal"] = "normal";
+    // Heavy / bold text weight
+    TextWeight["heavy"] = "heavy";
+})(TextWeight || (TextWeight = {}));
+/** Visual text color intensity and contrast. */
+export var TextIntensity;
+(function (TextIntensity) {
+    // Low visual contrast / subdued text color
+    TextIntensity["low"] = "low";
+    // Standard text color
+    TextIntensity["medium"] = "medium";
+    // High visual contrast / intense text color
+    TextIntensity["high"] = "high";
+})(TextIntensity || (TextIntensity = {}));
+/** Geometric shape representation for visual containers and indicators. */
+export var Shape;
+(function (Shape) {
+    // Circular container shape
+    Shape["circle"] = "circle";
+    // Square container shape
+    Shape["square"] = "square";
+})(Shape || (Shape = {}));
+/** Relative sizing scale for visual elements and indicators. */
+export var Size;
+(function (Size) {
+    // Compact small size
+    Size["small"] = "small";
+    // Standard medium size
+    Size["medium"] = "medium";
+    // Prominent large size
+    Size["large"] = "large";
+})(Size || (Size = {}));
+/** Representation style for short string values. */
+export var StringShortRepresentation;
+(function (StringShortRepresentation) {
+    // Standard plain text rendering
+    StringShortRepresentation["plain"] = "plain";
+    // Visual chip / tag pill representation
+    StringShortRepresentation["chip"] = "chip";
+})(StringShortRepresentation || (StringShortRepresentation = {}));
+/** Supported syntax highlighting languages for formatted code blocks. */
+export var CodeLanguage;
+(function (CodeLanguage) {
+    // XML markup syntax
+    CodeLanguage["xml"] = "xml";
+    // JSON format syntax
+    CodeLanguage["json"] = "json";
+    // YAML format syntax
+    CodeLanguage["yaml"] = "yaml";
+})(CodeLanguage || (CodeLanguage = {}));
+/** Visual color tone variants for badge pill representations. */
+export var BadgeVariant;
+(function (BadgeVariant) {
+    // Neutral gray tone
+    BadgeVariant["neutral"] = "neutral";
+    // Success green tone
+    BadgeVariant["success"] = "success";
+    // Warning yellow/orange tone
+    BadgeVariant["warning"] = "warning";
+    // Danger red tone
+    BadgeVariant["danger"] = "danger";
+})(BadgeVariant || (BadgeVariant = {}));
+/** Presentation format styles for timestamp elements. */
+export var TimestampFormat;
+(function (TimestampFormat) {
+    // Complete date and time display
+    TimestampFormat["datetime"] = "datetime";
+    // Date-only display
+    TimestampFormat["date"] = "date";
+    // Time-only display
+    TimestampFormat["time"] = "time";
+    // Relative time expression (e.g. "5 minutes ago")
+    TimestampFormat["relative"] = "relative";
+})(TimestampFormat || (TimestampFormat = {}));
+/** Visual style variants for interactive button actions. */
+export var ButtonVariant;
+(function (ButtonVariant) {
+    // Primary emphasis button style for default/recommended actions
+    ButtonVariant["primary"] = "primary";
+    // Secondary standard button style
+    ButtonVariant["secondary"] = "secondary";
+    // Subtle low-contrast button style
+    ButtonVariant["subtle"] = "subtle";
+    // Destructive / dangerous action button style
+    ButtonVariant["danger"] = "danger";
+})(ButtonVariant || (ButtonVariant = {}));
+/** Text horizontal alignment options for table columns. */
+export var TableColumnAlign;
+(function (TableColumnAlign) {
+    // Left-aligned text
+    TableColumnAlign["left"] = "left";
+    // Center-aligned text
+    TableColumnAlign["center"] = "center";
+    // Right-aligned text
+    TableColumnAlign["right"] = "right";
+})(TableColumnAlign || (TableColumnAlign = {}));
+/** Visual styling variants for hairline dividers. */
+export var DividerStyle;
+(function (DividerStyle) {
+    // Subtle thin hairline border
+    DividerStyle["hairline"] = "hairline";
+    // Solid standard divider line
+    DividerStyle["solid"] = "solid";
+    // Dashed separator line
+    DividerStyle["dashed"] = "dashed";
+})(DividerStyle || (DividerStyle = {}));
+/** Abstract base class for all `UiElement` models. */
+export class BaseUiElement extends ViewKitNode {
+}
+/** Abstract base class for all `UiAction` models. */
+export class BaseUiAction extends ViewKitNode {
+}
+// --- Concrete Model Classes Implementing Interfaces ---
+/**
+ * Class implementation of the `TruncateOptions` interface.
+ *
+ * @remarks
+ * Truncation configuration for long textual content with optional expand affordance.
+ */
+export class TruncateOptionsClass extends ViewKitNode {
+    /** Maximum number of characters to display before truncating */
+    characterLimit;
+    /**
+     * Whether to render a "Show more" / "Show less" toggle affordance
+     *
+     * @defaultValue true
+     */
+    showMore;
+    /**
+     * Constructs a new `TruncateOptionsClass` instance.
+     *
+     * @param characterLimit - Maximum number of characters to display before truncating
+     * @param options - Optional component settings. (showMore (defaults to `true`)).
+     */
+    constructor(characterLimit, options) {
+        super();
+        this.characterLimit = characterLimit;
+        this.showMore = options?.showMore ?? true;
+    }
+}
+/**
+ * Class implementation of the `BaseModifiers` interface.
+ *
+ * @remarks
+ * Base modifier traits for elements that support copy affordance.
+ */
+export class BaseModifiersClass extends ViewKitNode {
+    /** Adds an interactive copy button/action next to the rendered value */
+    copyable;
+    /**
+     * Constructs a new `BaseModifiersClass` instance.
+     *
+     * @param options - Optional component settings. (copyable).
+     */
+    constructor(options) {
+        super();
+        this.copyable = options?.copyable;
+    }
+}
+/**
+ * Class implementation of the `PrimitiveModifiers` interface.
+ *
+ * @remarks
+ * Common modifier traits that can be attached to primitive elements.
+ */
+export class PrimitiveModifiersClass extends ViewKitNode {
+    /** Configures character truncation threshold with show-more affordance */
+    truncate;
+    /**
+     * Typographic text weight
+     *
+     * @defaultValue TextWeight.normal
+     */
+    weight;
+    /**
+     * Visual text color intensity
+     *
+     * @defaultValue TextIntensity.medium
+     */
+    intensity;
+    /**
+     * Whether to use monospace font rendering (for hashes, IDs, codes)
+     *
+     * @defaultValue false
+     */
+    monospace;
+    /** Adds an interactive copy button/action next to the rendered value */
+    copyable;
+    /**
+     * Constructs a new `PrimitiveModifiersClass` instance.
+     *
+     * @param options - Optional component settings. (truncate, weight (defaults to `normal`), intensity (defaults to `medium`), monospace (defaults to `false`), copyable).
+     */
+    constructor(options) {
+        super();
+        this.truncate = options?.truncate;
+        this.weight = options?.weight ?? TextWeight.normal;
+        this.intensity = options?.intensity ?? TextIntensity.medium;
+        this.monospace = options?.monospace ?? false;
+        this.copyable = options?.copyable;
+    }
+}
+/**
+ * Class implementation of the `StringShortElement` interface.
+ *
+ * @remarks
+ * Short string primitive element.
+ * Supports plain text or compact chip pill presentation.
+ */
+export class StringShortElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `StringShortElement`.
+     *
+     * @defaultValue "string-short"
+     */
+    type = "string-short";
+    /** Text value */
+    value;
+    /**
+     * Display representation mode
+     *
+     * @defaultValue StringShortRepresentation.plain
+     */
+    representation;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Constructs a new `StringShortElementClass` instance.
+     *
+     * @param value - Text value
+     * @param options - Optional component settings. (representation (defaults to `plain`), modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.representation = options?.representation ?? StringShortRepresentation.plain;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `StringLongElement` interface.
+ *
+ * @remarks
+ * Multiline text block primitive element for descriptions, comments, or prose.
+ */
+export class StringLongElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `StringLongElement`.
+     *
+     * @defaultValue "string-long"
+     */
+    type = "string-long";
+    /** Text value */
+    value;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Constructs a new `StringLongElementClass` instance.
+     *
+     * @param value - Text value
+     * @param options - Optional component settings. (modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `StringCodeElement` interface.
+ *
+ * @remarks
+ * Monospace code block or formatted code snippet representation.
+ */
+export class StringCodeElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `StringCodeElement`.
+     *
+     * @defaultValue "string-code"
+     */
+    type = "string-code";
+    /** Text value */
+    value;
+    /** Optional syntax highlighting language identifier */
+    language;
+    /** Optional visual modifiers (copyable) */
+    modifiers;
+    /**
+     * Constructs a new `StringCodeElementClass` instance.
+     *
+     * @param value - Text value
+     * @param options - Optional component settings. (language, modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.language = options?.language;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `XmlElement` interface.
+ *
+ * @remarks
+ * XML markup code block element.
+ */
+export class XmlElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `XmlElement`.
+     *
+     * @defaultValue "xml"
+     */
+    type = "xml";
+    /** XML content value */
+    value;
+    /** Optional visual modifiers (copyable) */
+    modifiers;
+    /**
+     * Constructs a new `XmlElementClass` instance.
+     *
+     * @param value - XML content value
+     * @param options - Optional component settings. (modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `JsonElement` interface.
+ *
+ * @remarks
+ * JSON data or structure representation element.
+ */
+export class JsonElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `JsonElement`.
+     *
+     * @defaultValue "json"
+     */
+    type = "json";
+    /** JSON content value */
+    value;
+    /** Optional visual modifiers (copyable) */
+    modifiers;
+    /**
+     * Constructs a new `JsonElementClass` instance.
+     *
+     * @param value - JSON content value
+     * @param options - Optional component settings. (modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `StringUrlElement` interface.
+ *
+ * @remarks
+ * Hyperlink representation for external or internal URL navigation.
+ */
+export class StringUrlElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `StringUrlElement`.
+     *
+     * @defaultValue "string-url"
+     */
+    type = "string-url";
+    /** Target URL or navigation destination */
+    value;
+    /** Optional custom anchor text label */
+    label;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Constructs a new `StringUrlElementClass` instance.
+     *
+     * @param value - Target URL or navigation destination
+     * @param options - Optional component settings. (label, modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.label = options?.label;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `IdentifierElement` interface.
+ *
+ * @remarks
+ * Monospace semantic identifier representation.
+ */
+export class IdentifierElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `IdentifierElement`.
+     *
+     * @defaultValue "identifier"
+     */
+    type = "identifier";
+    /** Identifier string value */
+    value;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Constructs a new `IdentifierElementClass` instance.
+     *
+     * @param value - Identifier string value
+     * @param options - Optional component settings. (modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `RatioElement` interface.
+ *
+ * @remarks
+ * Aspect ratio representation (e.g. "16:9", "4:3", "1:1").
+ */
+export class RatioElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `RatioElement`.
+     *
+     * @defaultValue "ratio"
+     */
+    type = "ratio";
+    /** Aspect ratio numerical expression */
+    value;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Constructs a new `RatioElementClass` instance.
+     *
+     * @param value - Aspect ratio numerical expression
+     * @param options - Optional component settings. (modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `ColourElement` interface.
+ *
+ * @remarks
+ * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
+ */
+export class ColourElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `ColourElement`.
+     *
+     * @defaultValue "color"
+     */
+    type = "color";
+    /** Hexadecimal color code */
+    value;
+    /** Optional descriptive color name label */
+    label;
+    /**
+     * Whether to display the textual color code or label next to the swatch
+     *
+     * @defaultValue true
+     */
+    showText;
+    /**
+     * Visual shape of the color indicator
+     *
+     * @defaultValue Shape.circle
+     */
+    shape;
+    /**
+     * Visual size of the color indicator
+     *
+     * @defaultValue Size.medium
+     */
+    size;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Constructs a new `ColourElementClass` instance.
+     *
+     * @param value - Hexadecimal color code
+     * @param options - Optional component settings. (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.label = options?.label;
+        this.showText = options?.showText ?? true;
+        this.shape = options?.shape ?? Shape.circle;
+        this.size = options?.size ?? Size.medium;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `NumberUnboundedElement` interface.
+ *
+ * @remarks
+ * Plain unbounded numeric value primitive element.
+ */
+export class NumberUnboundedElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `NumberUnboundedElement`.
+     *
+     * @defaultValue "number-unbounded"
+     */
+    type = "number-unbounded";
+    /** Numeric value */
+    value;
+    /** Optional unit suffix (e.g. "px", "ms", "MB") */
+    unit;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Constructs a new `NumberUnboundedElementClass` instance.
+     *
+     * @param value - Numeric value
+     * @param options - Optional component settings. (unit, modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.unit = options?.unit;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `NumberBoundedStarsElement` interface.
+ *
+ * @remarks
+ * Bounded numeric rating represented as visual stars.
+ */
+export class NumberBoundedStarsElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `NumberBoundedStarsElement`.
+     *
+     * @defaultValue "number-stars"
+     */
+    type = "number-stars";
+    /** Numeric rating score */
+    value;
+    /** Maximum rating scale (defaults to 5) */
+    maximum;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Constructs a new `NumberBoundedStarsElementClass` instance.
+     *
+     * @param value - Numeric rating score
+     * @param options - Optional component settings. (maximum, modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.maximum = options?.maximum;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `NumberBoundedMeterElement` interface.
+ *
+ * @remarks
+ * Bounded numeric meter representation (read-only progress / score bar).
+ */
+export class NumberBoundedMeterElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `NumberBoundedMeterElement`.
+     *
+     * @defaultValue "number-meter"
+     */
+    type = "number-meter";
+    /** Numeric value */
+    value;
+    /** Minimum scale bound (defaults to 0) */
+    minimum;
+    /** Maximum scale bound (e.g. 100) */
+    maximum;
+    /** Optional custom text label override (e.g. "68 / 100") */
+    label;
+    /** Optional unit suffix (e.g. "%") */
+    unit;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Constructs a new `NumberBoundedMeterElementClass` instance.
+     *
+     * @param value - Numeric value
+     * @param options - Optional component settings. (minimum, maximum, label, unit, modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.minimum = options?.minimum;
+        this.maximum = options?.maximum;
+        this.label = options?.label;
+        this.unit = options?.unit;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `BooleanPlainElement` interface.
+ *
+ * @remarks
+ * Plain boolean value representation (textual "true" / "false").
+ */
+export class BooleanPlainElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `BooleanPlainElement`.
+     *
+     * @defaultValue "boolean-plain"
+     */
+    type = "boolean-plain";
+    /** 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`.
+     *
+     * @defaultValue "boolean-badge"
+     */
+    type = "boolean-badge";
+    /** Boolean state value */
+    value;
+    /**
+     * Custom display label when true (defaults to "true")
+     *
+     * @defaultValue "true"
+     */
+    trueLabel;
+    /**
+     * Custom display label when false (defaults to "false")
+     *
+     * @defaultValue "false"
+     */
+    falseLabel;
+    /**
+     * Badge color tone
+     *
+     * @defaultValue BadgeVariant.neutral
+     */
+    variant;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Constructs a new `BooleanBadgeElementClass` instance.
+     *
+     * @param value - Boolean state value
+     * @param options - Optional component settings. (trueLabel (defaults to `true`), falseLabel (defaults to `false`), variant (defaults to `neutral`), modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.trueLabel = options?.trueLabel ?? "true";
+        this.falseLabel = options?.falseLabel ?? "false";
+        this.variant = options?.variant ?? BadgeVariant.neutral;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `TimestampElement` interface.
+ *
+ * @remarks
+ * Formatted date and time representation.
+ */
+export class TimestampElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `TimestampElement`.
+     *
+     * @defaultValue "timestamp"
+     */
+    type = "timestamp";
+    /** The timestamp in milliseconds */
+    value;
+    /**
+     * Presentation date/time format
+     *
+     * @defaultValue TimestampFormat.datetime
+     */
+    format;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Constructs a new `TimestampElementClass` instance.
+     *
+     * @param value - The timestamp in milliseconds
+     * @param options - Optional component settings. (format (defaults to `datetime`), modifiers).
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.format = options?.format ?? TimestampFormat.datetime;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `ImageReferenceElement` interface.
+ *
+ * @remarks
+ * Thumbnail image reference with placeholder fallback handling.
+ */
+export class ImageReferenceElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `ImageReferenceElement`.
+     *
+     * @defaultValue "image-ref"
+     */
+    type = "image-ref";
+    /** Image source URI (HTTPS URL, base64 data URI, or asset path) */
+    src;
+    /** Accessible alternative description */
+    alt;
+    /**
+     * Aspect ratio of the thumbnail container
+     *
+     * @defaultValue "1:1"
+     */
+    aspectRatio;
+    /** Fallback placeholder image URI */
+    placeholder;
+    /**
+     * Constructs a new `ImageReferenceElementClass` instance.
+     *
+     * @param src - Image source URI (HTTPS URL, base64 data URI, or asset path)
+     * @param options - Optional component settings. (alt, aspectRatio (defaults to `1:1`), placeholder).
+     */
+    constructor(src, options) {
+        super();
+        this.src = src;
+        this.alt = options?.alt;
+        this.aspectRatio = options?.aspectRatio ?? "1:1";
+        this.placeholder = options?.placeholder;
+    }
+}
+/**
+ * Class implementation of the `ButtonActionElement` interface.
+ *
+ * @remarks
+ * Interactive button action triggering an extension command.
+ */
+export class ButtonActionElementClass extends BaseUiAction {
+    /**
+     * Discriminator identifier for `ButtonActionElement`.
+     *
+     * @defaultValue "button"
+     */
+    type = "button";
+    /** Command identifier to invoke */
+    commandId;
+    /** Display label for the action */
+    label;
+    /** Extension identifier owning the target command */
+    extensionId;
+    /** Target entity or context identifier */
+    target;
+    /** Optional arbitrary parameters payload forwarded to the command handler */
+    parameters;
+    /**
+     * Whether the button is disabled / unavailable
+     *
+     * @defaultValue false
+     */
+    disabled;
+    /**
+     * Button visual style variant
+     *
+     * @defaultValue ButtonVariant.secondary
+     */
+    variant;
+    /**
+     * Constructs a new `ButtonActionElementClass` instance.
+     *
+     * @param commandId - Command identifier to invoke
+     * @param label - Display label for the action
+     * @param options - Optional component settings. (extensionId, target, parameters, disabled (defaults to `false`), variant (defaults to `secondary`)).
+     */
+    constructor(commandId, label, options) {
+        super();
+        this.commandId = commandId;
+        this.label = label;
+        this.extensionId = options?.extensionId;
+        this.target = options?.target;
+        this.parameters = options?.parameters;
+        this.disabled = options?.disabled ?? false;
+        this.variant = options?.variant ?? ButtonVariant.secondary;
+    }
+}
+/**
+ * Class implementation of the `ExternalLinkActionElement` interface.
+ *
+ * @remarks
+ * External link action distinct from inline URL text values.
+ */
+export class ExternalLinkActionElementClass extends BaseUiAction {
+    /**
+     * Discriminator identifier for `ExternalLinkActionElement`.
+     *
+     * @defaultValue "external-link"
+     */
+    type = "external-link";
+    /** Target URL destination */
+    url;
+    /** Display label for the action */
+    label;
+    /**
+     * Constructs a new `ExternalLinkActionElementClass` instance.
+     *
+     * @param url - Target URL destination
+     * @param label - Display label for the action
+     */
+    constructor(url, label) {
+        super();
+        this.url = url;
+        this.label = label;
+    }
+}
+/**
+ * Class implementation of the `MarkdownBlockElement` interface.
+ *
+ * @remarks
+ * Full Markdown fallback block rendered with core typographic hierarchy, spacing, and styling.
+ */
+export class MarkdownBlockElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `MarkdownBlockElement`.
+     *
+     * @defaultValue "markdown"
+     */
+    type = "markdown";
+    /** Raw Markdown markup content */
+    content;
+    /** Optional visual modifiers (copyable) */
+    modifiers;
+    /**
+     * Constructs a new `MarkdownBlockElementClass` instance.
+     *
+     * @param content - Raw Markdown markup content
+     * @param options - Optional component settings. (modifiers).
+     */
+    constructor(content, options) {
+        super();
+        this.content = content;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `HtmlBlockElement` interface.
+ *
+ * @remarks
+ * Sandboxed HTML rendering escape hatch.
+ */
+export class HtmlBlockElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `HtmlBlockElement`.
+     *
+     * @defaultValue "html"
+     */
+    type = "html";
+    /** Raw HTML markup content */
+    content;
+    /** Optional visual modifiers (copyable) */
+    modifiers;
+    /**
+     * Constructs a new `HtmlBlockElementClass` instance.
+     *
+     * @param content - Raw HTML markup content
+     * @param options - Optional component settings. (modifiers).
+     */
+    constructor(content, options) {
+        super();
+        this.content = content;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `Slot` interface.
+ *
+ * @remarks
+ * Single slot within a multi-slot horizontal row layout.
+ */
+export class SlotClass extends ViewKitNode {
+    /** Rendered content inside the slot */
+    content;
+    /** Optional slot label (e.g. "Slot A") */
+    label;
+    /** Relative or fractional width proportion (e.g. "1/3", "2/3", "100px", "auto") */
+    width;
+    /**
+     * Constructs a new `SlotClass` instance.
+     *
+     * @param content - Rendered content inside the slot
+     * @param options - Optional component settings. (label, width).
+     */
+    constructor(content, options) {
+        super();
+        this.content = content;
+        this.label = options?.label;
+        this.width = options?.width;
+    }
+}
+/**
+ * Class implementation of the `MultiSlotElement` interface.
+ *
+ * @remarks
+ * Multi-slot horizontal row with declared column width proportions.
+ * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
+ */
+export class MultiSlotElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `MultiSlotElement`.
+     *
+     * @defaultValue "multi-slot"
+     */
+    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) {
+        super();
+        this.slots = slots ? [...slots] : [];
+        this.proportions = options?.proportions;
+    }
+}
+/**
+ * Class implementation of the `FlowingElement` interface.
+ *
+ * @remarks
+ * Flowing inline layout container with automatic line wrapping.
+ * Renders child elements horizontally in sequence, automatically wrapping to the next line when space runs out.
+ */
+export class FlowingElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `FlowingElement`.
+     *
+     * @defaultValue "flowing"
+     */
+    type = "flowing";
+    /** List of child elements rendered sequentially with line wrapping */
+    elements;
+    /**
+     * Constructs a new `FlowingElementClass` instance.
+     *
+     * @param elements - List of child elements rendered sequentially with line wrapping
+     */
+    constructor(elements) {
+        super();
+        this.elements = elements ? [...elements] : [];
+    }
+}
+/**
+ * Class implementation of the `LabelValueElement` interface.
+ *
+ * @remarks
+ * Standard label and value row.
+ * Displays a muted label on the left and value representation on the right with a vertical dividing line.
+ */
+export class LabelValueElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `LabelValueElement`.
+     *
+     * @defaultValue "label-value"
+     */
+    type = "label-value";
+    /** Key or descriptive label displayed muted on the left */
+    label;
+    /** Rendered value element on the right */
+    value;
+    /**
+     * Whether to render a bottom border/hairline divider
+     *
+     * @defaultValue false
+     */
+    withDivider;
+    /**
+     * Constructs a new `LabelValueElementClass` instance.
+     *
+     * @param label - Key or descriptive label displayed muted on the left
+     * @param value - Rendered value element on the right
+     * @param options - Optional component settings. (withDivider (defaults to `false`)).
+     */
+    constructor(label, value, options) {
+        super();
+        this.label = label;
+        this.value = value;
+        this.withDivider = options?.withDivider ?? false;
+    }
+}
+/**
+ * Class implementation of the `TableColumn` interface.
+ *
+ * @remarks
+ * Column definition for structured tables.
+ */
+export class TableColumnClass extends ViewKitNode {
+    /** Display header text */
+    header;
+    /**
+     * Text horizontal alignment
+     *
+     * @defaultValue TableColumnAlign.left
+     */
+    align;
+    /** Optional width constraint */
+    width;
+    /**
+     * Constructs a new `TableColumnClass` instance.
+     *
+     * @param options - Optional component settings. (header, align (defaults to `left`), width).
+     */
+    constructor(options) {
+        super();
+        this.header = options?.header;
+        this.align = options?.align ?? TableColumnAlign.left;
+        this.width = options?.width;
+    }
+}
+/**
+ * Class implementation of the `TableRow` interface.
+ *
+ * @remarks
+ * Single table row containing an array of cell values.
+ */
+export class TableRowClass extends ViewKitNode {
+    /** Array of cell values corresponding to table columns */
+    cells;
+    /**
+     * Constructs a new `TableRowClass` instance.
+     *
+     * @param cells - Array of cell values corresponding to table columns
+     */
+    constructor(cells) {
+        super();
+        this.cells = cells ? [...cells] : [];
+    }
+}
+/**
+ * Class implementation of the `TableElement` interface.
+ *
+ * @remarks
+ * Structured tabular data representation.
+ * Supports header/borderless modes, 2-column key-value tables, and 3-column data tables.
+ */
+export class TableElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `TableElement`.
+     *
+     * @defaultValue "table"
+     */
+    type = "table";
+    /** Tabular data rows */
+    rows;
+    /**
+     * Whether to render a column header row
+     *
+     * @defaultValue true
+     */
+    hasHeader;
+    /**
+     * Whether to render alternating row background colors
+     *
+     * @defaultValue false
+     */
+    isStriped;
+    /**
+     * Whether to render vertical column separators
+     *
+     * @defaultValue false
+     */
+    withColumnSeparators;
+    /**
+     * Whether to render horizontal row separators
+     *
+     * @defaultValue false
+     */
+    withRowSeparators;
+    /** Optional explicit column definitions */
+    columns;
+    /**
+     * 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).
+     */
+    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;
+        this.columns = options?.columns ? [...options.columns] : undefined;
+    }
+}
+/**
+ * Class implementation of the `RepeatingGroupEntry` interface.
+ *
+ * @remarks
+ * Single entry within a repeating group.
+ */
+export class RepeatingGroupEntryClass extends ViewKitNode {
+    /** Entry label */
+    label;
+    /** Primary entry value or nested elements */
+    value;
+    /** Nested elements for structured entries */
+    elements;
+    /**
+     * Constructs a new `RepeatingGroupEntryClass` instance.
+     *
+     * @param label - Entry label
+     * @param options - Optional component settings. (value, elements).
+     */
+    constructor(label, options) {
+        super();
+        this.label = label;
+        this.value = options?.value;
+        this.elements = options?.elements ? [...options.elements] : undefined;
+    }
+}
+/**
+ * Class implementation of the `RepeatingGroupElement` interface.
+ *
+ * @remarks
+ * Repeating group container where entries share uniform structure and retain per-entry labels.
+ */
+export class RepeatingGroupElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `RepeatingGroupElement`.
+     *
+     * @defaultValue "repeating-group"
+     */
+    type = "repeating-group";
+    /** List of repeated entry records */
+    entries;
+    /** Optional section header for the group */
+    title;
+    /**
+     * Constructs a new `RepeatingGroupElementClass` instance.
+     *
+     * @param entries - List of repeated entry records
+     * @param options - Optional component settings. (title).
+     */
+    constructor(entries, options) {
+        super();
+        this.entries = entries ? [...entries] : [];
+        this.title = options?.title;
+    }
+}
+/**
+ * Class implementation of the `CollapsibleGroupElement` interface.
+ *
+ * @remarks
+ * Collapsible disclosure container (accordion) with summary badge.
+ */
+export class CollapsibleGroupElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `CollapsibleGroupElement`.
+     *
+     * @defaultValue "collapsible-group"
+     */
+    type = "collapsible-group";
+    /** Group title (e.g. "Show specimen details") */
+    title;
+    /** Nested content elements revealed when expanded */
+    elements;
+    /** Secondary summary indicator (e.g. "2 neutral values") */
+    summary;
+    /**
+     * Whether the disclosure is open/expanded by default
+     *
+     * @defaultValue false
+     */
+    defaultExpanded;
+    /**
+     * Constructs a new `CollapsibleGroupElementClass` instance.
+     *
+     * @param title - Group title (e.g. "Show specimen details")
+     * @param elements - Nested content elements revealed when expanded
+     * @param options - Optional component settings. (summary, defaultExpanded (defaults to `false`)).
+     */
+    constructor(title, elements, options) {
+        super();
+        this.title = title;
+        this.elements = elements ? [...elements] : [];
+        this.summary = options?.summary;
+        this.defaultExpanded = options?.defaultExpanded ?? false;
+    }
+}
+/**
+ * Class implementation of the `DividerElement` interface.
+ *
+ * @remarks
+ * Visual hairline separator separating sections or element groups.
+ */
+export class DividerElementClass extends BaseUiElement {
+    /**
+     * Discriminator identifier for `DividerElement`.
+     *
+     * @defaultValue "divider"
+     */
+    type = "divider";
+    /**
+     * Line styling
+     *
+     * @defaultValue DividerStyle.hairline
+     */
+    style;
+    /**
+     * Constructs a new `DividerElementClass` instance.
+     *
+     * @param options - Optional component settings. (style (defaults to `hairline`)).
+     */
+    constructor(options) {
+        super();
+        this.style = options?.style ?? DividerStyle.hairline;
+    }
+}
+/**
+ * Class implementation of the `Envelop` interface.
+ *
+ * @remarks
+ * Base envelope container model holding the schema version attribute.
+ */
+export class EnvelopClass extends ViewKitNode {
+    /**
+     * Schema specification version
+     *
+     * @defaultValue "1.0"
+     */
+    schemaVersion;
+    /**
+     * Constructs a new `EnvelopClass` instance.
+     *
+     * @param options - Optional component settings. (schemaVersion (defaults to `1.0`)).
+     */
+    constructor(options) {
+        super();
+        this.schemaVersion = options?.schemaVersion ?? "1.0";
+    }
+}
+/**
+ * Class implementation of the `UiContainer` interface.
+ *
+ * @remarks
+ * Container model representing an ordered list of visual elements.
+ */
+export class UiContainerClass extends ViewKitNode {
+    /** Ordered list of visual elements, structures, and content */
+    elements;
+    /**
+     * Schema specification version
+     *
+     * @defaultValue "1.0"
+     */
+    schemaVersion;
+    /**
+     * Constructs a new `UiContainerClass` instance.
+     *
+     * @param elements - Ordered list of visual elements, structures, and content
+     * @param options - Optional component settings. (schemaVersion (defaults to `1.0`)).
+     */
+    constructor(elements, options) {
+        super();
+        this.elements = elements ? [...elements] : [];
+        this.schemaVersion = options?.schemaVersion ?? "1.0";
+    }
+}
+/**
+ * Class implementation of the `UiCard` interface.
+ *
+ * @remarks
+ * Root Card container model.
+ * Represents a complete feature card rendered inside the 360px panel.
+ */
+export class UiCardClass extends ViewKitNode {
+    /** Human-readable feature title displayed in the card header */
+    title;
+    /** Ordered list of visual elements, structures, and content */
+    elements;
+    /** Optional neutral subtitle / description for the feature */
+    description;
+    /** Optional card action buttons rendered at the base of the feature card */
+    actions;
+    /**
+     * Schema specification version
+     *
+     * @defaultValue "1.0"
+     */
+    schemaVersion;
+    /**
+     * Constructs a new `UiCardClass` instance.
+     *
+     * @param title - Human-readable feature title displayed in the card header
+     * @param elements - Ordered list of visual elements, structures, and content
+     * @param options - Optional component settings. (description, actions, schemaVersion (defaults to `1.0`)).
+     */
+    constructor(title, elements, options) {
+        super();
+        this.title = title;
+        this.elements = elements ? [...elements] : [];
+        this.description = options?.description;
+        this.actions = options?.actions ? [...options.actions] : undefined;
+        this.schemaVersion = options?.schemaVersion ?? "1.0";
+    }
+}
+/**
+ * Fluent builder for constructing strongly-typed `UiContainer` instances.
+ *
+ * @remarks
+ * Container model representing an ordered list of visual elements.
+ */
+export class UiContainerBuilder {
+    _elements = [];
+    /** Initializes a new `UiContainerBuilder`. */
+    constructor() {
+    }
+    /**
+     * Appends a visual element.
+     *
+     * @param element - The visual UI element component to add.
+     * @returns This builder instance for method chaining.
+     */
+    add(element) {
+        this._elements.push(element);
+        return this;
+    }
+    /**
+     * Appends multiple elements items.
+     *
+     * @param items - The `UiElement` items to add.
+     * @returns This builder instance for method chaining.
+     */
+    addElements(...items) {
+        this._elements.push(...items);
+        return this;
+    }
+    /**
+     * Appends a `StringShortElement` component.
+     *
+     * @remarks
+     * Short string primitive element.
+     * Supports plain text or compact chip pill 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));
+    }
+    /**
+     * Appends a `StringLongElement` component.
+     *
+     * @remarks
+     * Multiline text block primitive element for descriptions, comments, or prose.
+     *
+     * @param value - Text value
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addStringLong(value, options) {
+        return this.add(stringLong(value, options));
+    }
+    /**
+     * Appends a `StringCodeElement` component.
+     *
+     * @remarks
+     * Monospace code block or formatted code snippet representation.
+     *
+     * @param value - Text value
+     * @param options - Optional component settings (language, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addStringCode(value, options) {
+        return this.add(stringCode(value, options));
+    }
+    /**
+     * Appends a `XmlElement` component.
+     *
+     * @remarks
+     * XML markup code block element.
+     *
+     * @param value - XML content value
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addXml(value, options) {
+        return this.add(xml(value, options));
+    }
+    /**
+     * Appends a `JsonElement` component.
+     *
+     * @remarks
+     * JSON data or structure representation element.
+     *
+     * @param value - JSON content value
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addJson(value, options) {
+        return this.add(json(value, options));
+    }
+    /**
+     * Appends a `StringUrlElement` component.
+     *
+     * @remarks
+     * Hyperlink representation for external or internal URL navigation.
+     *
+     * @param value - Target URL or navigation destination
+     * @param options - Optional component settings (label, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addStringUrl(value, options) {
+        return this.add(stringUrl(value, options));
+    }
+    /**
+     * Appends a `IdentifierElement` component.
+     *
+     * @remarks
+     * Monospace semantic identifier representation.
+     *
+     * @param value - Identifier string value
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addIdentifier(value, options) {
+        return this.add(identifier(value, options));
+    }
+    /**
+     * Appends a `RatioElement` component.
+     *
+     * @remarks
+     * Aspect ratio representation (e.g. "16:9", "4:3", "1:1").
+     *
+     * @param value - Aspect ratio numerical expression
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addRatio(value, options) {
+        return this.add(ratio(value, options));
+    }
+    /**
+     * Appends a `ColourElement` component.
+     *
+     * @remarks
+     * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
+     *
+     * @param value - Hexadecimal color code
+     * @param options - Optional component settings (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addColour(value, options) {
+        return this.add(colour(value, options));
+    }
+    /**
+     * Appends a `ColourElement` component.
+     *
+     * @remarks
+     * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
+     *
+     * @param value - Hexadecimal color code
+     * @param options - Optional component settings (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addColor(value, options) {
+        return this.add(color(value, options));
+    }
+    /**
+     * Appends a `NumberUnboundedElement` component.
+     *
+     * @remarks
+     * Plain unbounded numeric value primitive element.
+     *
+     * @param value - Numeric value
+     * @param options - Optional component settings (unit, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addNumberUnbounded(value, options) {
+        return this.add(numberUnbounded(value, options));
+    }
+    /**
+     * Appends a `NumberBoundedStarsElement` component.
+     *
+     * @remarks
+     * Bounded numeric rating represented as visual stars.
+     *
+     * @param value - Numeric rating score
+     * @param options - Optional component settings (maximum, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addNumberBoundedStars(value, options) {
+        return this.add(numberBoundedStars(value, options));
+    }
+    /**
+     * Appends a `NumberBoundedStarsElement` component.
+     *
+     * @remarks
+     * Bounded numeric rating represented as visual stars.
+     *
+     * @param value - Numeric rating score
+     * @param options - Optional component settings (maximum, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addNumberStars(value, options) {
+        return this.add(numberStars(value, options));
+    }
+    /**
+     * Appends a `NumberBoundedMeterElement` component.
+     *
+     * @remarks
+     * Bounded numeric meter representation (read-only progress / score bar).
+     *
+     * @param value - Numeric value
+     * @param options - Optional component settings (minimum, maximum, label, unit, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addNumberBoundedMeter(value, options) {
+        return this.add(numberBoundedMeter(value, options));
+    }
+    /**
+     * Appends a `NumberBoundedMeterElement` component.
+     *
+     * @remarks
+     * Bounded numeric meter representation (read-only progress / score bar).
+     *
+     * @param value - Numeric value
+     * @param options - Optional component settings (minimum, maximum, label, unit, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addNumberMeter(value, options) {
+        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.
+     *
+     * @remarks
+     * Visual badge pill representation of a boolean state.
+     *
+     * @param value - Boolean state value
+     * @param options - Optional component settings (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));
+    }
+    /**
+     * Appends a `TimestampElement` component.
+     *
+     * @remarks
+     * Formatted date and time representation.
+     *
+     * @param value - The timestamp in milliseconds
+     * @param options - Optional component settings (format (defaults to `datetime`), modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addTimestamp(value, options) {
+        return this.add(timestamp(value, options));
+    }
+    /**
+     * Appends a `ImageReferenceElement` component.
+     *
+     * @remarks
+     * Thumbnail image reference with placeholder fallback handling.
+     *
+     * @param src - Image source URI (HTTPS URL, base64 data URI, or asset path)
+     * @param options - Optional component settings (alt, aspectRatio (defaults to `1:1`), placeholder).
+     * @returns This builder instance for method chaining.
+     */
+    addImageReference(src, options) {
+        return this.add(imageReference(src, options));
+    }
+    /**
+     * Appends a `ImageReferenceElement` component.
+     *
+     * @remarks
+     * Thumbnail image reference with placeholder fallback handling.
+     *
+     * @param src - Image source URI (HTTPS URL, base64 data URI, or asset path)
+     * @param options - Optional component settings (alt, aspectRatio (defaults to `1:1`), placeholder).
+     * @returns This builder instance for method chaining.
+     */
+    addImageRef(src, options) {
+        return this.add(imageRef(src, options));
+    }
+    /**
+     * Appends a `MarkdownBlockElement` component.
+     *
+     * @remarks
+     * Full Markdown fallback block rendered with core typographic hierarchy, spacing, and styling.
+     *
+     * @param content - Raw Markdown markup content
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addMarkdownBlock(content, options) {
+        return this.add(markdownBlock(content, options));
+    }
+    /**
+     * Appends a `MarkdownBlockElement` component.
+     *
+     * @remarks
+     * Full Markdown fallback block rendered with core typographic hierarchy, spacing, and styling.
+     *
+     * @param content - Raw Markdown markup content
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addMarkdown(content, options) {
+        return this.add(markdown(content, options));
+    }
+    /**
+     * Appends a `HtmlBlockElement` component.
+     *
+     * @remarks
+     * Sandboxed HTML rendering escape hatch.
+     *
+     * @param content - Raw HTML markup content
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addHtmlBlock(content, options) {
+        return this.add(htmlBlock(content, options));
+    }
+    /**
+     * Appends a `HtmlBlockElement` component.
+     *
+     * @remarks
+     * Sandboxed HTML rendering escape hatch.
+     *
+     * @param content - Raw HTML markup content
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addHtml(content, options) {
+        return this.add(html(content, options));
+    }
+    /**
+     * 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".
+     *
+     * @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));
+    }
+    /**
+     * Appends a `FlowingElement` component.
+     *
+     * @remarks
+     * Flowing inline layout container with automatic line wrapping.
+     * Renders child elements horizontally in sequence, automatically wrapping to the next line when space runs out.
+     *
+     * @param elements - List of child elements rendered sequentially with line wrapping
+     * @returns This builder instance for method chaining.
+     */
+    addFlowing(elements) {
+        return this.add(flowing(elements));
+    }
+    /**
+     * Appends a `LabelValueElement` component.
+     *
+     * @remarks
+     * Standard label and value row.
+     * Displays a muted label on the left and value representation on the right with a vertical dividing line.
+     *
+     * @param label - Key or descriptive label displayed muted on the left
+     * @param value - Rendered value element on the right
+     * @param options - Optional component settings (withDivider (defaults to `false`)).
+     * @returns This builder instance for method chaining.
+     */
+    addLabelValue(label, value, options) {
+        return this.add(labelValue(label, value, options));
+    }
+    /**
+     * Appends a `TableElement` component.
+     *
+     * @remarks
+     * Structured tabular data representation.
+     * 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).
+     * @returns This builder instance for method chaining.
+     */
+    addTable(rows, options) {
+        return this.add(table(rows, options));
+    }
+    /**
+     * Appends a `RepeatingGroupElement` component.
+     *
+     * @remarks
+     * Repeating group container where entries share uniform structure and retain per-entry labels.
+     *
+     * @param entries - List of repeated entry records
+     * @param options - Optional component settings (title).
+     * @returns This builder instance for method chaining.
+     */
+    addRepeatingGroup(entries, options) {
+        return this.add(repeatingGroup(entries, options));
+    }
+    /**
+     * Appends a `CollapsibleGroupElement` component.
+     *
+     * @remarks
+     * Collapsible disclosure container (accordion) with summary badge.
+     *
+     * @param title - Group title (e.g. "Show specimen details")
+     * @param elements - Nested content elements revealed when expanded
+     * @param options - Optional component settings (summary, defaultExpanded (defaults to `false`)).
+     * @returns This builder instance for method chaining.
+     */
+    addCollapsibleGroup(title, elements, options) {
+        return this.add(collapsibleGroup(title, elements, options));
+    }
+    /**
+     * Appends a `DividerElement` component.
+     *
+     * @remarks
+     * Visual hairline separator separating sections or element groups.
+     *
+     * @param options - Optional component settings (style (defaults to `hairline`)).
+     * @returns This builder instance for method chaining.
+     */
+    addDivider(options) {
+        return this.add(divider(options));
+    }
+    /**
+     * Finalizes and returns the complete strongly-typed `UiContainerClass` instance.
+     *
+     * @returns The constructed `UiContainerClass` instance.
+     */
+    build() {
+        return new UiContainerClass(this._elements);
+    }
+    /**
+     * Serializes this builder into a strongly-typed, JSON-compatible plain object conforming to interface `UiContainer`.
+     *
+     * @returns The plain object representation conforming to interface `UiContainer`.
+     */
+    toJSON() {
+        return this.build().toJSON();
+    }
+    /**
+     * Returns the compact JSON string representation of the built `UiContainerClass` instance with no indentation.
+     *
+     * @returns Compact JSON string without indentation.
+     */
+    toString() {
+        return this.build().toString();
+    }
+}
+/** Static helper factory object for `UiContainer`. */
+export const UiContainer = {
+    /**
+     * Creates a new fluent builder for constructing a `UiContainer`.
+     *
+     * @returns A new `UiContainerBuilder` instance.
+     */
+    builder() {
+        return new UiContainerBuilder();
+    },
+    /**
+     * Creates a `UiContainerClass` directly from a properties object.
+     *
+     * @param params - Configuration properties.
+     * @returns A completed `UiContainerClass` instance.
+     */
+    create(params) {
+        return new UiContainerClass(params.elements);
+    },
+    /**
+     * Parses a JSON string or raw object into a validated `UiContainerClass` instance.
+     *
+     * @remarks
+     * Throws an `Error` if the input does not conform to the `UiContainer` schema.
+     *
+     * @param json - JSON string or parsed JavaScript object to validate and hydrate.
+     * @param withDeepValidation - Whether to recursively validate all nested child entities.
+     * @returns A strongly-typed `UiContainerClass` instance.
+     */
+    parse(json, withDeepValidation = true) {
+        const data = typeof json === "string" ? JSON.parse(json) : json;
+        if (!isUiContainer(data, withDeepValidation)) {
+            throw new Error("Invalid JSON: value does not match the `UiContainer` schema.");
+        }
+        return UiContainer.create(data);
+    }
+};
+/**
+ * Functional helper to create a `UiContainerClass` instance directly.
+ *
+ * @remarks
+ * Container model representing an ordered list of visual elements.
+ *
+ * @param options - Optional configuration properties.
+ * @returns A strongly-typed `UiContainerClass` instance.
+ */
+export function createUiContainer(options) {
+    return new UiContainerClass(options?.elements ?? []);
+}
+/**
+ * Parses a JSON string or raw object into a validated `UiContainerClass` instance.
+ *
+ * @remarks
+ * Container model representing an ordered list of visual elements.
+ *
+ * @param json - JSON string or parsed JavaScript object to validate and hydrate.
+ * @param withDeepValidation - Whether to recursively validate all nested child entities.
+ * @returns A strongly-typed `UiContainerClass` instance.
+ */
+export function parseUiContainer(json, withDeepValidation = true) {
+    return UiContainer.parse(json, withDeepValidation);
+}
+/**
+ * Fluent builder for constructing strongly-typed `UiCard` instances.
+ *
+ * @remarks
+ * Root Card container model.
+ * Represents a complete feature card rendered inside the 360px panel.
+ */
+export class UiCardBuilder {
+    _title;
+    _description;
+    _actions = [];
+    _elements = [];
+    /**
+     * Initializes a new `UiCardBuilder`.
+     *
+     * @param title - Human-readable feature title displayed in the card header
+     */
+    constructor(title) {
+        this._title = title;
+    }
+    /**
+     * Sets the `description` property on this builder.
+     *
+     * @param description - Optional neutral subtitle / description for the feature
+     * @returns This builder instance for method chaining.
+     */
+    description(description) {
+        this._description = description;
+        return this;
+    }
+    /**
+     * Appends multiple actions items.
+     *
+     * @param items - The `UiAction` items to add.
+     * @returns This builder instance for method chaining.
+     */
+    addActions(...items) {
+        this._actions.push(...items);
+        return this;
+    }
+    /**
+     * Appends a single action.
+     *
+     * @param item - The `UiAction` item to add.
+     * @returns This builder instance for method chaining.
+     */
+    addAction(item) {
+        this._actions.push(item);
+        return this;
+    }
+    /**
+     * Appends a visual element.
+     *
+     * @param element - The visual UI element component to add.
+     * @returns This builder instance for method chaining.
+     */
+    add(element) {
+        this._elements.push(element);
+        return this;
+    }
+    /**
+     * Appends multiple elements items.
+     *
+     * @param items - The `UiElement` items to add.
+     * @returns This builder instance for method chaining.
+     */
+    addElements(...items) {
+        this._elements.push(...items);
+        return this;
+    }
+    /**
+     * Appends a `StringShortElement` component.
+     *
+     * @remarks
+     * Short string primitive element.
+     * Supports plain text or compact chip pill 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));
+    }
+    /**
+     * Appends a `StringLongElement` component.
+     *
+     * @remarks
+     * Multiline text block primitive element for descriptions, comments, or prose.
+     *
+     * @param value - Text value
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addStringLong(value, options) {
+        return this.add(stringLong(value, options));
+    }
+    /**
+     * Appends a `StringCodeElement` component.
+     *
+     * @remarks
+     * Monospace code block or formatted code snippet representation.
+     *
+     * @param value - Text value
+     * @param options - Optional component settings (language, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addStringCode(value, options) {
+        return this.add(stringCode(value, options));
+    }
+    /**
+     * Appends a `XmlElement` component.
+     *
+     * @remarks
+     * XML markup code block element.
+     *
+     * @param value - XML content value
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addXml(value, options) {
+        return this.add(xml(value, options));
+    }
+    /**
+     * Appends a `JsonElement` component.
+     *
+     * @remarks
+     * JSON data or structure representation element.
+     *
+     * @param value - JSON content value
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addJson(value, options) {
+        return this.add(json(value, options));
+    }
+    /**
+     * Appends a `StringUrlElement` component.
+     *
+     * @remarks
+     * Hyperlink representation for external or internal URL navigation.
+     *
+     * @param value - Target URL or navigation destination
+     * @param options - Optional component settings (label, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addStringUrl(value, options) {
+        return this.add(stringUrl(value, options));
+    }
+    /**
+     * Appends a `IdentifierElement` component.
+     *
+     * @remarks
+     * Monospace semantic identifier representation.
+     *
+     * @param value - Identifier string value
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addIdentifier(value, options) {
+        return this.add(identifier(value, options));
+    }
+    /**
+     * Appends a `RatioElement` component.
+     *
+     * @remarks
+     * Aspect ratio representation (e.g. "16:9", "4:3", "1:1").
+     *
+     * @param value - Aspect ratio numerical expression
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addRatio(value, options) {
+        return this.add(ratio(value, options));
+    }
+    /**
+     * Appends a `ColourElement` component.
+     *
+     * @remarks
+     * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
+     *
+     * @param value - Hexadecimal color code
+     * @param options - Optional component settings (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addColour(value, options) {
+        return this.add(colour(value, options));
+    }
+    /**
+     * Appends a `ColourElement` component.
+     *
+     * @remarks
+     * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
+     *
+     * @param value - Hexadecimal color code
+     * @param options - Optional component settings (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addColor(value, options) {
+        return this.add(color(value, options));
+    }
+    /**
+     * Appends a `NumberUnboundedElement` component.
+     *
+     * @remarks
+     * Plain unbounded numeric value primitive element.
+     *
+     * @param value - Numeric value
+     * @param options - Optional component settings (unit, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addNumberUnbounded(value, options) {
+        return this.add(numberUnbounded(value, options));
+    }
+    /**
+     * Appends a `NumberBoundedStarsElement` component.
+     *
+     * @remarks
+     * Bounded numeric rating represented as visual stars.
+     *
+     * @param value - Numeric rating score
+     * @param options - Optional component settings (maximum, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addNumberBoundedStars(value, options) {
+        return this.add(numberBoundedStars(value, options));
+    }
+    /**
+     * Appends a `NumberBoundedStarsElement` component.
+     *
+     * @remarks
+     * Bounded numeric rating represented as visual stars.
+     *
+     * @param value - Numeric rating score
+     * @param options - Optional component settings (maximum, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addNumberStars(value, options) {
+        return this.add(numberStars(value, options));
+    }
+    /**
+     * Appends a `NumberBoundedMeterElement` component.
+     *
+     * @remarks
+     * Bounded numeric meter representation (read-only progress / score bar).
+     *
+     * @param value - Numeric value
+     * @param options - Optional component settings (minimum, maximum, label, unit, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addNumberBoundedMeter(value, options) {
+        return this.add(numberBoundedMeter(value, options));
+    }
+    /**
+     * Appends a `NumberBoundedMeterElement` component.
+     *
+     * @remarks
+     * Bounded numeric meter representation (read-only progress / score bar).
+     *
+     * @param value - Numeric value
+     * @param options - Optional component settings (minimum, maximum, label, unit, modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addNumberMeter(value, options) {
+        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.
+     *
+     * @remarks
+     * Visual badge pill representation of a boolean state.
+     *
+     * @param value - Boolean state value
+     * @param options - Optional component settings (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));
+    }
+    /**
+     * Appends a `TimestampElement` component.
+     *
+     * @remarks
+     * Formatted date and time representation.
+     *
+     * @param value - The timestamp in milliseconds
+     * @param options - Optional component settings (format (defaults to `datetime`), modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addTimestamp(value, options) {
+        return this.add(timestamp(value, options));
+    }
+    /**
+     * Appends a `ImageReferenceElement` component.
+     *
+     * @remarks
+     * Thumbnail image reference with placeholder fallback handling.
+     *
+     * @param src - Image source URI (HTTPS URL, base64 data URI, or asset path)
+     * @param options - Optional component settings (alt, aspectRatio (defaults to `1:1`), placeholder).
+     * @returns This builder instance for method chaining.
+     */
+    addImageReference(src, options) {
+        return this.add(imageReference(src, options));
+    }
+    /**
+     * Appends a `ImageReferenceElement` component.
+     *
+     * @remarks
+     * Thumbnail image reference with placeholder fallback handling.
+     *
+     * @param src - Image source URI (HTTPS URL, base64 data URI, or asset path)
+     * @param options - Optional component settings (alt, aspectRatio (defaults to `1:1`), placeholder).
+     * @returns This builder instance for method chaining.
+     */
+    addImageRef(src, options) {
+        return this.add(imageRef(src, options));
+    }
+    /**
+     * Appends a `MarkdownBlockElement` component.
+     *
+     * @remarks
+     * Full Markdown fallback block rendered with core typographic hierarchy, spacing, and styling.
+     *
+     * @param content - Raw Markdown markup content
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addMarkdownBlock(content, options) {
+        return this.add(markdownBlock(content, options));
+    }
+    /**
+     * Appends a `MarkdownBlockElement` component.
+     *
+     * @remarks
+     * Full Markdown fallback block rendered with core typographic hierarchy, spacing, and styling.
+     *
+     * @param content - Raw Markdown markup content
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addMarkdown(content, options) {
+        return this.add(markdown(content, options));
+    }
+    /**
+     * Appends a `HtmlBlockElement` component.
+     *
+     * @remarks
+     * Sandboxed HTML rendering escape hatch.
+     *
+     * @param content - Raw HTML markup content
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addHtmlBlock(content, options) {
+        return this.add(htmlBlock(content, options));
+    }
+    /**
+     * Appends a `HtmlBlockElement` component.
+     *
+     * @remarks
+     * Sandboxed HTML rendering escape hatch.
+     *
+     * @param content - Raw HTML markup content
+     * @param options - Optional component settings (modifiers).
+     * @returns This builder instance for method chaining.
+     */
+    addHtml(content, options) {
+        return this.add(html(content, options));
+    }
+    /**
+     * 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".
+     *
+     * @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));
+    }
+    /**
+     * Appends a `FlowingElement` component.
+     *
+     * @remarks
+     * Flowing inline layout container with automatic line wrapping.
+     * Renders child elements horizontally in sequence, automatically wrapping to the next line when space runs out.
+     *
+     * @param elements - List of child elements rendered sequentially with line wrapping
+     * @returns This builder instance for method chaining.
+     */
+    addFlowing(elements) {
+        return this.add(flowing(elements));
+    }
+    /**
+     * Appends a `LabelValueElement` component.
+     *
+     * @remarks
+     * Standard label and value row.
+     * Displays a muted label on the left and value representation on the right with a vertical dividing line.
+     *
+     * @param label - Key or descriptive label displayed muted on the left
+     * @param value - Rendered value element on the right
+     * @param options - Optional component settings (withDivider (defaults to `false`)).
+     * @returns This builder instance for method chaining.
+     */
+    addLabelValue(label, value, options) {
+        return this.add(labelValue(label, value, options));
+    }
+    /**
+     * Appends a `TableElement` component.
+     *
+     * @remarks
+     * Structured tabular data representation.
+     * 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).
+     * @returns This builder instance for method chaining.
+     */
+    addTable(rows, options) {
+        return this.add(table(rows, options));
+    }
+    /**
+     * Appends a `RepeatingGroupElement` component.
+     *
+     * @remarks
+     * Repeating group container where entries share uniform structure and retain per-entry labels.
+     *
+     * @param entries - List of repeated entry records
+     * @param options - Optional component settings (title).
+     * @returns This builder instance for method chaining.
+     */
+    addRepeatingGroup(entries, options) {
+        return this.add(repeatingGroup(entries, options));
+    }
+    /**
+     * Appends a `CollapsibleGroupElement` component.
+     *
+     * @remarks
+     * Collapsible disclosure container (accordion) with summary badge.
+     *
+     * @param title - Group title (e.g. "Show specimen details")
+     * @param elements - Nested content elements revealed when expanded
+     * @param options - Optional component settings (summary, defaultExpanded (defaults to `false`)).
+     * @returns This builder instance for method chaining.
+     */
+    addCollapsibleGroup(title, elements, options) {
+        return this.add(collapsibleGroup(title, elements, options));
+    }
+    /**
+     * Appends a `DividerElement` component.
+     *
+     * @remarks
+     * Visual hairline separator separating sections or element groups.
+     *
+     * @param options - Optional component settings (style (defaults to `hairline`)).
+     * @returns This builder instance for method chaining.
+     */
+    addDivider(options) {
+        return this.add(divider(options));
+    }
+    /**
+     * Finalizes and returns the complete strongly-typed `UiCardClass` instance.
+     *
+     * @returns The constructed `UiCardClass` instance.
+     */
+    build() {
+        return new UiCardClass(this._title, this._elements, {
+            description: this._description,
+            actions: this._actions.length > 0 ? this._actions : undefined
+        });
+    }
+    /**
+     * Serializes this builder into a strongly-typed, JSON-compatible plain object conforming to interface `UiCard`.
+     *
+     * @returns The plain object representation conforming to interface `UiCard`.
+     */
+    toJSON() {
+        return this.build().toJSON();
+    }
+    /**
+     * Returns the compact JSON string representation of the built `UiCardClass` instance with no indentation.
+     *
+     * @returns Compact JSON string without indentation.
+     */
+    toString() {
+        return this.build().toString();
+    }
+}
+/** Static helper factory object for `UiCard`. */
+export const UiCard = {
+    /**
+     * Creates a new fluent builder for constructing a `UiCard`.
+     *
+     * @param title - Human-readable feature title displayed in the card header
+     * @returns A new `UiCardBuilder` instance.
+     */
+    builder(title) {
+        return new UiCardBuilder(title);
+    },
+    /**
+     * Creates a `UiCardClass` directly from a properties object.
+     *
+     * @param params - Configuration properties.
+     * @returns A completed `UiCardClass` instance.
+     */
+    create(params) {
+        return new UiCardClass(params.title, params.elements, {
+            description: params.description,
+            actions: params.actions
+        });
+    },
+    /**
+     * Parses a JSON string or raw object into a validated `UiCardClass` instance.
+     *
+     * @remarks
+     * Throws an `Error` if the input does not conform to the `UiCard` schema.
+     *
+     * @param json - JSON string or parsed JavaScript object to validate and hydrate.
+     * @param withDeepValidation - Whether to recursively validate all nested child entities.
+     * @returns A strongly-typed `UiCardClass` instance.
+     */
+    parse(json, withDeepValidation = true) {
+        const data = typeof json === "string" ? JSON.parse(json) : json;
+        if (!isUiCard(data, withDeepValidation)) {
+            throw new Error("Invalid JSON: value does not match the `UiCard` schema.");
+        }
+        return UiCard.create(data);
+    }
+};
+/**
+ * Functional helper to create a `UiCardClass` instance directly.
+ *
+ * @remarks
+ * Root Card container model.
+ * Represents a complete feature card rendered inside the 360px panel.
+ *
+ * @param title - Human-readable feature title displayed in the card header
+ * @param options - Optional configuration properties.
+ * @returns A strongly-typed `UiCardClass` instance.
+ */
+export function createUiCard(title, options) {
+    return new UiCardClass(title, options?.elements ?? [], {
+        description: options?.description,
+        actions: options?.actions
+    });
+}
+/**
+ * Parses a JSON string or raw object into a validated `UiCardClass` instance.
+ *
+ * @remarks
+ * Root Card container model.
+ * Represents a complete feature card rendered inside the 360px panel.
+ *
+ * @param json - JSON string or parsed JavaScript object to validate and hydrate.
+ * @param withDeepValidation - Whether to recursively validate all nested child entities.
+ * @returns A strongly-typed `UiCardClass` instance.
+ */
+export function parseUiCard(json, withDeepValidation = true) {
+    return UiCard.parse(json, withDeepValidation);
+}
+// --- Functional DSL Factory Helpers ---
+/**
+ * Creates a `TruncateOptions` component instance.
+ *
+ * @remarks
+ * Truncation configuration for long textual content with optional expand affordance.
+ *
+ * @param characterLimit - Maximum number of characters to display before truncating
+ * @param options - Optional settings (showMore (defaults to `true`)).
+ * @returns A strongly-typed `TruncateOptions` object.
+ */
+export function truncateOptions(characterLimit, options) {
+    return {
+        characterLimit,
+        showMore: options?.showMore ?? true
+    };
+}
+/**
+ * Creates a `BaseModifiers` component instance.
+ *
+ * @remarks
+ * Base modifier traits for elements that support copy affordance.
+ *
+ * @param options - Optional settings (copyable).
+ * @returns A strongly-typed `BaseModifiers` object.
+ */
+export function baseModifiers(options) {
+    return {
+        copyable: options?.copyable
+    };
+}
+/**
+ * Creates a `PrimitiveModifiers` component instance.
+ *
+ * @remarks
+ * Common modifier traits that can be attached to primitive elements.
+ *
+ * @param options - Optional settings (truncate, weight (defaults to `normal`), intensity (defaults to `medium`), monospace (defaults to `false`), copyable).
+ * @returns A strongly-typed `PrimitiveModifiers` object.
+ */
+export function primitiveModifiers(options) {
+    return {
+        truncate: options?.truncate,
+        weight: options?.weight ?? TextWeight.normal,
+        intensity: options?.intensity ?? TextIntensity.medium,
+        monospace: options?.monospace ?? false,
+        copyable: options?.copyable
+    };
+}
+/**
+ * Creates a `StringShortElement` component instance.
+ *
+ * @remarks
+ * Short string primitive element.
+ * Supports plain text or compact chip pill presentation.
+ *
+ * @param value - Text value
+ * @param options - Optional settings (representation (defaults to `plain`), modifiers).
+ * @returns A strongly-typed `StringShortElement` object.
+ */
+export function stringShort(value, options) {
+    return {
+        type: "string-short",
+        value,
+        representation: options?.representation ?? StringShortRepresentation.plain,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `StringLongElement` component instance.
+ *
+ * @remarks
+ * Multiline text block primitive element for descriptions, comments, or prose.
+ *
+ * @param value - Text value
+ * @param options - Optional settings (modifiers).
+ * @returns A strongly-typed `StringLongElement` object.
+ */
+export function stringLong(value, options) {
+    return {
+        type: "string-long",
+        value,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `StringCodeElement` component instance.
+ *
+ * @remarks
+ * Monospace code block or formatted code snippet representation.
+ *
+ * @param value - Text value
+ * @param options - Optional settings (language, modifiers).
+ * @returns A strongly-typed `StringCodeElement` object.
+ */
+export function stringCode(value, options) {
+    return {
+        type: "string-code",
+        value,
+        language: options?.language,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `XmlElement` component instance.
+ *
+ * @remarks
+ * XML markup code block element.
+ *
+ * @param value - XML content value
+ * @param options - Optional settings (modifiers).
+ * @returns A strongly-typed `XmlElement` object.
+ */
+export function xml(value, options) {
+    return {
+        type: "xml",
+        value,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `JsonElement` component instance.
+ *
+ * @remarks
+ * JSON data or structure representation element.
+ *
+ * @param value - JSON content value
+ * @param options - Optional settings (modifiers).
+ * @returns A strongly-typed `JsonElement` object.
+ */
+export function json(value, options) {
+    return {
+        type: "json",
+        value,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `StringUrlElement` component instance.
+ *
+ * @remarks
+ * Hyperlink representation for external or internal URL navigation.
+ *
+ * @param value - Target URL or navigation destination
+ * @param options - Optional settings (label, modifiers).
+ * @returns A strongly-typed `StringUrlElement` object.
+ */
+export function stringUrl(value, options) {
+    return {
+        type: "string-url",
+        value,
+        label: options?.label,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `IdentifierElement` component instance.
+ *
+ * @remarks
+ * Monospace semantic identifier representation.
+ *
+ * @param value - Identifier string value
+ * @param options - Optional settings (modifiers).
+ * @returns A strongly-typed `IdentifierElement` object.
+ */
+export function identifier(value, options) {
+    return {
+        type: "identifier",
+        value,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `RatioElement` component instance.
+ *
+ * @remarks
+ * Aspect ratio representation (e.g. "16:9", "4:3", "1:1").
+ *
+ * @param value - Aspect ratio numerical expression
+ * @param options - Optional settings (modifiers).
+ * @returns A strongly-typed `RatioElement` object.
+ */
+export function ratio(value, options) {
+    return {
+        type: "ratio",
+        value,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `ColourElement` component instance.
+ *
+ * @remarks
+ * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
+ *
+ * @param value - Hexadecimal color code
+ * @param options - Optional settings (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
+ * @returns A strongly-typed `ColourElement` object.
+ */
+export function colour(value, options) {
+    return {
+        type: "color",
+        value,
+        label: options?.label,
+        showText: options?.showText ?? true,
+        shape: options?.shape ?? Shape.circle,
+        size: options?.size ?? Size.medium,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `ColourElement` component instance.
+ *
+ * @remarks
+ * Single color representation with hex value, shape/size styling, text display toggle, and copy affordance.
+ *
+ * @param value - Hexadecimal color code
+ * @param options - Optional settings (label, showText (defaults to `true`), shape (defaults to `circle`), size (defaults to `medium`), modifiers).
+ * @returns A strongly-typed `ColourElement` object.
+ */
+export function color(value, options) {
+    return {
+        type: "color",
+        value,
+        label: options?.label,
+        showText: options?.showText ?? true,
+        shape: options?.shape ?? Shape.circle,
+        size: options?.size ?? Size.medium,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `NumberUnboundedElement` component instance.
+ *
+ * @remarks
+ * Plain unbounded numeric value primitive element.
+ *
+ * @param value - Numeric value
+ * @param options - Optional settings (unit, modifiers).
+ * @returns A strongly-typed `NumberUnboundedElement` object.
+ */
+export function numberUnbounded(value, options) {
+    return {
+        type: "number-unbounded",
+        value,
+        unit: options?.unit,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `NumberBoundedStarsElement` component instance.
+ *
+ * @remarks
+ * Bounded numeric rating represented as visual stars.
+ *
+ * @param value - Numeric rating score
+ * @param options - Optional settings (maximum, modifiers).
+ * @returns A strongly-typed `NumberBoundedStarsElement` object.
+ */
+export function numberBoundedStars(value, options) {
+    return {
+        type: "number-stars",
+        value,
+        maximum: options?.maximum,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `NumberBoundedStarsElement` component instance.
+ *
+ * @remarks
+ * Bounded numeric rating represented as visual stars.
+ *
+ * @param value - Numeric rating score
+ * @param options - Optional settings (maximum, modifiers).
+ * @returns A strongly-typed `NumberBoundedStarsElement` object.
+ */
+export function numberStars(value, options) {
+    return {
+        type: "number-stars",
+        value,
+        maximum: options?.maximum,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `NumberBoundedMeterElement` component instance.
+ *
+ * @remarks
+ * Bounded numeric meter representation (read-only progress / score bar).
+ *
+ * @param value - Numeric value
+ * @param options - Optional settings (minimum, maximum, label, unit, modifiers).
+ * @returns A strongly-typed `NumberBoundedMeterElement` object.
+ */
+export function numberBoundedMeter(value, options) {
+    return {
+        type: "number-meter",
+        value,
+        minimum: options?.minimum,
+        maximum: options?.maximum,
+        label: options?.label,
+        unit: options?.unit,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `NumberBoundedMeterElement` component instance.
+ *
+ * @remarks
+ * Bounded numeric meter representation (read-only progress / score bar).
+ *
+ * @param value - Numeric value
+ * @param options - Optional settings (minimum, maximum, label, unit, modifiers).
+ * @returns A strongly-typed `NumberBoundedMeterElement` object.
+ */
+export function numberMeter(value, options) {
+    return {
+        type: "number-meter",
+        value,
+        minimum: options?.minimum,
+        maximum: options?.maximum,
+        label: options?.label,
+        unit: options?.unit,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * 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.
+ *
+ * @remarks
+ * Visual badge pill representation of a boolean state.
+ *
+ * @param value - Boolean state value
+ * @param options - Optional settings (trueLabel (defaults to `true`), falseLabel (defaults to `false`), variant (defaults to `neutral`), modifiers).
+ * @returns A strongly-typed `BooleanBadgeElement` object.
+ */
+export function booleanBadge(value, options) {
+    return {
+        type: "boolean-badge",
+        value,
+        trueLabel: options?.trueLabel ?? "true",
+        falseLabel: options?.falseLabel ?? "false",
+        variant: options?.variant ?? BadgeVariant.neutral,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `TimestampElement` component instance.
+ *
+ * @remarks
+ * Formatted date and time representation.
+ *
+ * @param value - The timestamp in milliseconds
+ * @param options - Optional settings (format (defaults to `datetime`), modifiers).
+ * @returns A strongly-typed `TimestampElement` object.
+ */
+export function timestamp(value, options) {
+    return {
+        type: "timestamp",
+        value,
+        format: options?.format ?? TimestampFormat.datetime,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `ImageReferenceElement` component instance.
+ *
+ * @remarks
+ * Thumbnail image reference with placeholder fallback handling.
+ *
+ * @param src - Image source URI (HTTPS URL, base64 data URI, or asset path)
+ * @param options - Optional settings (alt, aspectRatio (defaults to `1:1`), placeholder).
+ * @returns A strongly-typed `ImageReferenceElement` object.
+ */
+export function imageReference(src, options) {
+    return {
+        type: "image-ref",
+        src,
+        alt: options?.alt,
+        aspectRatio: options?.aspectRatio ?? "1:1",
+        placeholder: options?.placeholder
+    };
+}
+/**
+ * Creates a `ImageReferenceElement` component instance.
+ *
+ * @remarks
+ * Thumbnail image reference with placeholder fallback handling.
+ *
+ * @param src - Image source URI (HTTPS URL, base64 data URI, or asset path)
+ * @param options - Optional settings (alt, aspectRatio (defaults to `1:1`), placeholder).
+ * @returns A strongly-typed `ImageReferenceElement` object.
+ */
+export function imageRef(src, options) {
+    return {
+        type: "image-ref",
+        src,
+        alt: options?.alt,
+        aspectRatio: options?.aspectRatio ?? "1:1",
+        placeholder: options?.placeholder
+    };
+}
+/**
+ * Creates a `ButtonActionElement` component instance.
+ *
+ * @remarks
+ * Interactive button action triggering an extension command.
+ *
+ * @param commandId - Command identifier to invoke
+ * @param label - Display label for the action
+ * @param options - Optional settings (extensionId, target, parameters, disabled (defaults to `false`), variant (defaults to `secondary`)).
+ * @returns A strongly-typed `ButtonActionElement` object.
+ */
+export function buttonAction(commandId, label, options) {
+    return {
+        type: "button",
+        commandId,
+        label,
+        extensionId: options?.extensionId,
+        target: options?.target,
+        parameters: options?.parameters,
+        disabled: options?.disabled ?? false,
+        variant: options?.variant ?? ButtonVariant.secondary
+    };
+}
+/**
+ * Creates a `ExternalLinkActionElement` component instance.
+ *
+ * @remarks
+ * External link action distinct from inline URL text values.
+ *
+ * @param url - Target URL destination
+ * @param label - Display label for the action
+ * @returns A strongly-typed `ExternalLinkActionElement` object.
+ */
+export function externalLinkAction(url, label) {
+    return {
+        type: "external-link",
+        url,
+        label
+    };
+}
+/**
+ * Creates a `MarkdownBlockElement` component instance.
+ *
+ * @remarks
+ * Full Markdown fallback block rendered with core typographic hierarchy, spacing, and styling.
+ *
+ * @param content - Raw Markdown markup content
+ * @param options - Optional settings (modifiers).
+ * @returns A strongly-typed `MarkdownBlockElement` object.
+ */
+export function markdownBlock(content, options) {
+    return {
+        type: "markdown",
+        content,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `MarkdownBlockElement` component instance.
+ *
+ * @remarks
+ * Full Markdown fallback block rendered with core typographic hierarchy, spacing, and styling.
+ *
+ * @param content - Raw Markdown markup content
+ * @param options - Optional settings (modifiers).
+ * @returns A strongly-typed `MarkdownBlockElement` object.
+ */
+export function markdown(content, options) {
+    return {
+        type: "markdown",
+        content,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `HtmlBlockElement` component instance.
+ *
+ * @remarks
+ * Sandboxed HTML rendering escape hatch.
+ *
+ * @param content - Raw HTML markup content
+ * @param options - Optional settings (modifiers).
+ * @returns A strongly-typed `HtmlBlockElement` object.
+ */
+export function htmlBlock(content, options) {
+    return {
+        type: "html",
+        content,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `HtmlBlockElement` component instance.
+ *
+ * @remarks
+ * Sandboxed HTML rendering escape hatch.
+ *
+ * @param content - Raw HTML markup content
+ * @param options - Optional settings (modifiers).
+ * @returns A strongly-typed `HtmlBlockElement` object.
+ */
+export function html(content, options) {
+    return {
+        type: "html",
+        content,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `Slot` component instance.
+ *
+ * @remarks
+ * Single slot within a multi-slot horizontal row layout.
+ *
+ * @param content - Rendered content inside the slot
+ * @param options - Optional settings (label, width).
+ * @returns A strongly-typed `Slot` object.
+ */
+export function slot(content, options) {
+    return {
+        content,
+        label: options?.label,
+        width: options?.width
+    };
+}
+/**
+ * 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".
+ *
+ * @param slots - List of slots comprising the row
+ * @param options - Optional settings (proportions).
+ * @returns A strongly-typed `MultiSlotElement` object.
+ */
+export function multiSlot(slots, options) {
+    return {
+        type: "multi-slot",
+        slots: [...slots],
+        proportions: options?.proportions
+    };
+}
+/**
+ * Creates a `FlowingElement` component instance.
+ *
+ * @remarks
+ * Flowing inline layout container with automatic line wrapping.
+ * Renders child elements horizontally in sequence, automatically wrapping to the next line when space runs out.
+ *
+ * @param elements - List of child elements rendered sequentially with line wrapping
+ * @returns A strongly-typed `FlowingElement` object.
+ */
+export function flowing(elements) {
+    return {
+        type: "flowing",
+        elements: [...elements]
+    };
+}
+/**
+ * Creates a `LabelValueElement` component instance.
+ *
+ * @remarks
+ * Standard label and value row.
+ * Displays a muted label on the left and value representation on the right with a vertical dividing line.
+ *
+ * @param label - Key or descriptive label displayed muted on the left
+ * @param value - Rendered value element on the right
+ * @param options - Optional settings (withDivider (defaults to `false`)).
+ * @returns A strongly-typed `LabelValueElement` object.
+ */
+export function labelValue(label, value, options) {
+    return {
+        type: "label-value",
+        label,
+        value,
+        withDivider: options?.withDivider ?? false
+    };
+}
+/**
+ * Creates a `TableColumn` component instance.
+ *
+ * @remarks
+ * Column definition for structured tables.
+ *
+ * @param options - Optional settings (header, align (defaults to `left`), width).
+ * @returns A strongly-typed `TableColumn` object.
+ */
+export function tableColumn(options) {
+    return {
+        header: options?.header,
+        align: options?.align ?? TableColumnAlign.left,
+        width: options?.width
+    };
+}
+/**
+ * Creates a `TableRow` component instance.
+ *
+ * @remarks
+ * Single table row containing an array of cell values.
+ *
+ * @param cells - Array of cell values corresponding to table columns
+ * @returns A strongly-typed `TableRow` object.
+ */
+export function tableRow(cells) {
+    return {
+        cells: [...cells]
+    };
+}
+/**
+ * Creates a `TableElement` component instance.
+ *
+ * @remarks
+ * Structured tabular data representation.
+ * 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).
+ * @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,
+        columns: options?.columns ? [...options.columns] : undefined
+    };
+}
+/**
+ * Creates a `RepeatingGroupEntry` component instance.
+ *
+ * @remarks
+ * Single entry within a repeating group.
+ *
+ * @param label - Entry label
+ * @param options - Optional settings (value, elements).
+ * @returns A strongly-typed `RepeatingGroupEntry` object.
+ */
+export function repeatingGroupEntry(label, options) {
+    return {
+        label,
+        value: options?.value,
+        elements: options?.elements ? [...options.elements] : undefined
+    };
+}
+/**
+ * Creates a `RepeatingGroupElement` component instance.
+ *
+ * @remarks
+ * Repeating group container where entries share uniform structure and retain per-entry labels.
+ *
+ * @param entries - List of repeated entry records
+ * @param options - Optional settings (title).
+ * @returns A strongly-typed `RepeatingGroupElement` object.
+ */
+export function repeatingGroup(entries, options) {
+    return {
+        type: "repeating-group",
+        entries: [...entries],
+        title: options?.title
+    };
+}
+/**
+ * Creates a `CollapsibleGroupElement` component instance.
+ *
+ * @remarks
+ * Collapsible disclosure container (accordion) with summary badge.
+ *
+ * @param title - Group title (e.g. "Show specimen details")
+ * @param elements - Nested content elements revealed when expanded
+ * @param options - Optional settings (summary, defaultExpanded (defaults to `false`)).
+ * @returns A strongly-typed `CollapsibleGroupElement` object.
+ */
+export function collapsibleGroup(title, elements, options) {
+    return {
+        type: "collapsible-group",
+        title,
+        elements: [...elements],
+        summary: options?.summary,
+        defaultExpanded: options?.defaultExpanded ?? false
+    };
+}
+/**
+ * Creates a `DividerElement` component instance.
+ *
+ * @remarks
+ * Visual hairline separator separating sections or element groups.
+ *
+ * @param options - Optional settings (style (defaults to `hairline`)).
+ * @returns A strongly-typed `DividerElement` object.
+ */
+export function divider(options) {
+    return {
+        type: "divider",
+        style: options?.style ?? DividerStyle.hairline
+    };
+}
+/**
+ * Creates a `Envelop` component instance.
+ *
+ * @remarks
+ * Base envelope container model holding the schema version attribute.
+ *
+ * @param options - Optional settings (schemaVersion (defaults to `1.0`)).
+ * @returns A strongly-typed `Envelop` object.
+ */
+export function envelop(options) {
+    return {
+        schemaVersion: options?.schemaVersion ?? "1.0"
+    };
+}
+// --- Type Guards ---
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `TruncateOptions`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value conforms to `TruncateOptions`, otherwise `false`.
+ */
+export function isTruncateOptions(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("characterLimit" in value && typeof element.characterLimit === "number") &&
+        (element.showMore === undefined || typeof element.showMore === "boolean");
+}
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `BaseModifiers`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value conforms to `BaseModifiers`, otherwise `false`.
+ */
+export function isBaseModifiers(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return (element.copyable === undefined || typeof element.copyable === "boolean");
+}
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `PrimitiveModifiers`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value conforms to `PrimitiveModifiers`, otherwise `false`.
+ */
+export function isPrimitiveModifiers(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return (element.truncate === undefined || isTruncateOptions(element.truncate, true)) &&
+        (element.weight === undefined || Object.values(TextWeight).includes(element.weight)) &&
+        (element.intensity === undefined || Object.values(TextIntensity).includes(element.intensity)) &&
+        (element.monospace === undefined || typeof element.monospace === "boolean") &&
+        (element.copyable === undefined || typeof element.copyable === "boolean");
+}
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `Slot`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value conforms to `Slot`, otherwise `false`.
+ */
+export function isSlot(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return (element.label === undefined || typeof element.label === "string") &&
+        (element.width === undefined || typeof element.width === "string") &&
+        ("content" in value && isUiElement(element.content, true));
+}
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `TableColumn`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value conforms to `TableColumn`, otherwise `false`.
+ */
+export function isTableColumn(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    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");
+}
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `TableRow`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value conforms to `TableRow`, otherwise `false`.
+ */
+export function isTableRow(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("cells" in value && (Array.isArray(element.cells) && element.cells.every((item) => isUiElement(item, true))));
+}
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `RepeatingGroupEntry`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value conforms to `RepeatingGroupEntry`, otherwise `false`.
+ */
+export function isRepeatingGroupEntry(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("label" in value && typeof element.label === "string") &&
+        (element.value === undefined || isUiElement(element.value, true)) &&
+        (element.elements === undefined || (Array.isArray(element.elements) && element.elements.every((item) => isUiElement(item, true))));
+}
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `Envelop`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value conforms to `Envelop`, otherwise `false`.
+ */
+export function isEnvelop(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return true;
+}
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `UiElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a valid `UiElement`, otherwise `false`.
+ */
+export function isUiElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || typeof value.type !== "string") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    switch (element.type) {
+        case "string-short":
+            return isStringShortElement(element, true);
+        case "string-long":
+            return isStringLongElement(element, true);
+        case "string-code":
+            return isStringCodeElement(element, true);
+        case "xml":
+            return isXmlElement(element, true);
+        case "json":
+            return isJsonElement(element, true);
+        case "string-url":
+            return isStringUrlElement(element, true);
+        case "identifier":
+            return isIdentifierElement(element, true);
+        case "ratio":
+            return isRatioElement(element, true);
+        case "color":
+            return isColourElement(element, true);
+        case "number-unbounded":
+            return isNumberUnboundedElement(element, true);
+        case "number-stars":
+            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 "timestamp":
+            return isTimestampElement(element, true);
+        case "image-ref":
+            return isImageReferenceElement(element, true);
+        case "markdown":
+            return isMarkdownBlockElement(element, true);
+        case "html":
+            return isHtmlBlockElement(element, true);
+        case "multi-slot":
+            return isMultiSlotElement(element, true);
+        case "flowing":
+            return isFlowingElement(element, true);
+        case "label-value":
+            return isLabelValueElement(element, true);
+        case "table":
+            return isTableElement(element, true);
+        case "repeating-group":
+            return isRepeatingGroupElement(element, true);
+        case "collapsible-group":
+            return isCollapsibleGroupElement(element, true);
+        case "divider":
+            return isDividerElement(element, true);
+        default:
+            return false;
+    }
+}
+/**
+ * Type guard predicate narrowing a value to `StringShortElement`.
+ *
+ * @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`.
+ */
+export function isStringShortElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "string-short") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "string") &&
+        (element.representation === undefined || Object.values(StringShortRepresentation).includes(element.representation)) &&
+        (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `StringLongElement`.
+ *
+ * @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`.
+ */
+export function isStringLongElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "string-long") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "string") &&
+        (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `StringCodeElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `StringCodeElement` (type = "string-code"), otherwise `false`.
+ */
+export function isStringCodeElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "string-code") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "string") &&
+        (element.language === undefined || Object.values(CodeLanguage).includes(element.language)) &&
+        (element.modifiers === undefined || isBaseModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `XmlElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `XmlElement` (type = "xml"), otherwise `false`.
+ */
+export function isXmlElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "xml") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "string") &&
+        (element.modifiers === undefined || isBaseModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `JsonElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `JsonElement` (type = "json"), otherwise `false`.
+ */
+export function isJsonElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "json") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "string") &&
+        (element.modifiers === undefined || isBaseModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `StringUrlElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `StringUrlElement` (type = "string-url"), otherwise `false`.
+ */
+export function isStringUrlElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "string-url") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "string") &&
+        (element.label === undefined || typeof element.label === "string") &&
+        (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `IdentifierElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `IdentifierElement` (type = "identifier"), otherwise `false`.
+ */
+export function isIdentifierElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "identifier") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "string") &&
+        (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `RatioElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `RatioElement` (type = "ratio"), otherwise `false`.
+ */
+export function isRatioElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "ratio") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "number") &&
+        (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `ColourElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `ColourElement` (type = "color"), otherwise `false`.
+ */
+export function isColourElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "color") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "string") &&
+        (element.label === undefined || typeof element.label === "string") &&
+        (element.showText === undefined || typeof element.showText === "boolean") &&
+        (element.shape === undefined || Object.values(Shape).includes(element.shape)) &&
+        (element.size === undefined || Object.values(Size).includes(element.size)) &&
+        (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `NumberUnboundedElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `NumberUnboundedElement` (type = "number-unbounded"), otherwise `false`.
+ */
+export function isNumberUnboundedElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "number-unbounded") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "number") &&
+        (element.unit === undefined || typeof element.unit === "string") &&
+        (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `NumberBoundedStarsElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `NumberBoundedStarsElement` (type = "number-stars"), otherwise `false`.
+ */
+export function isNumberBoundedStarsElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "number-stars") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "number") &&
+        (element.maximum === undefined || typeof element.maximum === "number") &&
+        (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `NumberBoundedMeterElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `NumberBoundedMeterElement` (type = "number-meter"), otherwise `false`.
+ */
+export function isNumberBoundedMeterElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "number-meter") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "number") &&
+        (element.minimum === undefined || typeof element.minimum === "number") &&
+        (element.maximum === undefined || typeof element.maximum === "number") &&
+        (element.label === undefined || typeof element.label === "string") &&
+        (element.unit === undefined || typeof element.unit === "string") &&
+        (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
+}
+/**
+ * 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 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") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "boolean") &&
+        (element.trueLabel === undefined || typeof element.trueLabel === "string") &&
+        (element.falseLabel === undefined || typeof element.falseLabel === "string") &&
+        (element.variant === undefined || Object.values(BadgeVariant).includes(element.variant)) &&
+        (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `TimestampElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `TimestampElement` (type = "timestamp"), otherwise `false`.
+ */
+export function isTimestampElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "timestamp") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("value" in value && typeof element.value === "number") &&
+        (element.format === undefined || Object.values(TimestampFormat).includes(element.format)) &&
+        (element.modifiers === undefined || isPrimitiveModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `ImageReferenceElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `ImageReferenceElement` (type = "image-ref"), otherwise `false`.
+ */
+export function isImageReferenceElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "image-ref") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("src" in value && typeof element.src === "string") &&
+        (element.alt === undefined || typeof element.alt === "string") &&
+        (element.aspectRatio === undefined || typeof element.aspectRatio === "string") &&
+        (element.placeholder === undefined || typeof element.placeholder === "string");
+}
+/**
+ * Type guard predicate narrowing a value to `MarkdownBlockElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `MarkdownBlockElement` (type = "markdown"), otherwise `false`.
+ */
+export function isMarkdownBlockElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "markdown") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("content" in value && typeof element.content === "string") &&
+        (element.modifiers === undefined || isBaseModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `HtmlBlockElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `HtmlBlockElement` (type = "html"), otherwise `false`.
+ */
+export function isHtmlBlockElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "html") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("content" in value && typeof element.content === "string") &&
+        (element.modifiers === undefined || isBaseModifiers(element.modifiers, true));
+}
+/**
+ * Type guard predicate narrowing a value to `MultiSlotElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `MultiSlotElement` (type = "multi-slot"), otherwise `false`.
+ */
+export function isMultiSlotElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "multi-slot") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        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))));
+}
+/**
+ * Type guard predicate narrowing a value to `FlowingElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `FlowingElement` (type = "flowing"), otherwise `false`.
+ */
+export function isFlowingElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "flowing") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("elements" in value && (Array.isArray(element.elements) && element.elements.every((item) => isUiElement(item, true))));
+}
+/**
+ * Type guard predicate narrowing a value to `LabelValueElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `LabelValueElement` (type = "label-value"), otherwise `false`.
+ */
+export function isLabelValueElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "label-value") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("label" in value && typeof element.label === "string") &&
+        ("value" in value && isUiElement(element.value, true)) &&
+        (element.withDivider === undefined || typeof element.withDivider === "boolean");
+}
+/**
+ * Type guard predicate narrowing a value to `TableElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `TableElement` (type = "table"), otherwise `false`.
+ */
+export function isTableElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "table") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return (element.hasHeader === undefined || typeof element.hasHeader === "boolean") &&
+        (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)))) &&
+        ("rows" in value && (Array.isArray(element.rows) && element.rows.every((item) => isTableRow(item, true))));
+}
+/**
+ * Type guard predicate narrowing a value to `RepeatingGroupElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `RepeatingGroupElement` (type = "repeating-group"), otherwise `false`.
+ */
+export function isRepeatingGroupElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "repeating-group") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return (element.title === undefined || typeof element.title === "string") &&
+        ("entries" in value && (Array.isArray(element.entries) && element.entries.every((item) => isRepeatingGroupEntry(item, true))));
+}
+/**
+ * Type guard predicate narrowing a value to `CollapsibleGroupElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `CollapsibleGroupElement` (type = "collapsible-group"), otherwise `false`.
+ */
+export function isCollapsibleGroupElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "collapsible-group") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("title" in value && typeof element.title === "string") &&
+        (element.summary === undefined || typeof element.summary === "string") &&
+        (element.defaultExpanded === undefined || typeof element.defaultExpanded === "boolean") &&
+        ("elements" in value && (Array.isArray(element.elements) && element.elements.every((item) => isUiElement(item, true))));
+}
+/**
+ * Type guard predicate narrowing a value to `DividerElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `DividerElement` (type = "divider"), otherwise `false`.
+ */
+export function isDividerElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "divider") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return (element.style === undefined || Object.values(DividerStyle).includes(element.style));
+}
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `UiAction`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a valid `UiAction`, otherwise `false`.
+ */
+export function isUiAction(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || typeof value.type !== "string") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    switch (element.type) {
+        case "button":
+            return isButtonActionElement(element, true);
+        case "external-link":
+            return isExternalLinkActionElement(element, true);
+        default:
+            return false;
+    }
+}
+/**
+ * Type guard predicate narrowing a value to `ButtonActionElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `ButtonActionElement` (type = "button"), otherwise `false`.
+ */
+export function isButtonActionElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "button") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return (element.extensionId === undefined || typeof element.extensionId === "string") &&
+        ("commandId" in value && typeof element.commandId === "string") &&
+        (element.target === undefined || typeof element.target === "string") &&
+        (element.parameters === undefined || (typeof element.parameters === "object" && element.parameters !== null)) &&
+        (element.disabled === undefined || typeof element.disabled === "boolean") &&
+        (element.variant === undefined || Object.values(ButtonVariant).includes(element.variant)) &&
+        ("label" in value && typeof element.label === "string");
+}
+/**
+ * Type guard predicate narrowing a value to `ExternalLinkActionElement`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a `ExternalLinkActionElement` (type = "external-link"), otherwise `false`.
+ */
+export function isExternalLinkActionElement(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null || !("type" in value) || value.type !== "external-link") {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("url" in value && typeof element.url === "string") &&
+        ("label" in value && typeof element.label === "string");
+}
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `UiContainer`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a valid `UiContainer`, otherwise `false`.
+ */
+export function isUiContainer(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    if (!("schemaVersion" in value) || value.schemaVersion !== "1.0" || !("elements" in value)) {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("elements" in value && (Array.isArray(element.elements) && element.elements.every((item) => isUiElement(item, true))));
+}
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `UiCard`.
+ *
+ * @param value - The value to inspect.
+ * @param withDeepValidation - Whether to recursively validate all properties.
+ * @returns `true` if the value is a valid `UiCard`, otherwise `false`.
+ */
+export function isUiCard(value, withDeepValidation = false) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    if (!("schemaVersion" in value) || value.schemaVersion !== "1.0" || !("title" in value) || !("elements" in value)) {
+        return false;
+    }
+    if (!withDeepValidation) {
+        return true;
+    }
+    const element = value;
+    return ("title" in value && typeof element.title === "string") &&
+        (element.description === undefined || typeof element.description === "string") &&
+        (element.actions === undefined || (Array.isArray(element.actions) && element.actions.every((item) => isUiAction(item, true)))) &&
+        ("elements" in value && (Array.isArray(element.elements) && element.elements.every((item) => isUiElement(item, true))));
+}