@picteus/extension-sdk 0.15.0 → 0.17.0

package/dist/featureViewGrammar.js

@@ -0,0 +1,2612 @@
+// ---------------------------------------------------------------------------
+// Auto-generated by @picteus/feature-view-grammar emitter. Do not edit directly.
+// ---------------------------------------------------------------------------
+/** Generic base class providing recursive JSON serialization for all model instances. */
+export class GrammarNode {
+    /**
+     * 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) => 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;
+    }
+}
+/** Text emphasis and visual weight styling. */
+export var Emphasis;
+(function (Emphasis) {
+    /** Subdued or secondary appearance with lower visual contrast */
+    Emphasis["muted"] = "muted";
+    /** Standard text weight and contrast */
+    Emphasis["normal"] = "normal";
+    /** Emphasized / bold text weight for prominence */
+    Emphasis["strong"] = "strong";
+})(Emphasis || (Emphasis = {}));
+/** 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 = {}));
+/** 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["full"] = "full";
+    /** 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 GrammarNode {
+}
+/** Abstract base class for all `ActionElement` models. */
+export class BaseActionElement extends GrammarNode {
+}
+// --- 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 GrammarNode {
+    /** Maximum number of characters to display before truncating */
+    characterLimit;
+    /**
+     * Whether to render a "Show more" / "Show less" toggle affordance
+     *
+     * @defaultValue true
+     */
+    showMore;
+    /**
+     * Initializes a new `TruncateOptionsClass` instance.
+     *
+     * @param characterLimit - Maximum number of characters to display before truncating
+     * @param options - Optional property overrides.
+     */
+    constructor(characterLimit, options) {
+        super();
+        this.characterLimit = characterLimit;
+        this.showMore = options?.showMore ?? true;
+    }
+}
+/**
+ * Class implementation of the `PrimitiveModifiers` interface.
+ *
+ * @remarks
+ * Common modifier traits that can be attached to primitive elements.
+ */
+export class PrimitiveModifiersClass extends GrammarNode {
+    /** Adds an interactive copy button/action next to the rendered value */
+    copyable;
+    /** Configures character truncation threshold with show-more affordance */
+    truncate;
+    /**
+     * Text emphasis level
+     *
+     * @defaultValue Emphasis.normal
+     */
+    emphasis;
+    /**
+     * Whether to use monospace font rendering (for hashes, IDs, codes)
+     *
+     * @defaultValue false
+     */
+    monospace;
+    /**
+     * Initializes a new `PrimitiveModifiersClass` instance.
+     *
+     * @param options - Optional property overrides.
+     */
+    constructor(options) {
+        super();
+        this.copyable = options?.copyable;
+        this.truncate = options?.truncate;
+        this.emphasis = options?.emphasis ?? Emphasis.normal;
+        this.monospace = options?.monospace ?? false;
+    }
+}
+/**
+ * Class implementation of the `StringShortElement` interface.
+ *
+ * @remarks
+ * Short string primitive element.
+ * Supports plain text or compact chip pill presentation.
+ */
+export class StringShortElementClass extends BaseUiElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "string-short"
+     */
+    type = "string-short";
+    /** Text value */
+    value;
+    /**
+     * Display representation mode
+     *
+     * @defaultValue StringShortRepresentation.plain
+     */
+    representation;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Initializes a new `StringShortElementClass` instance.
+     *
+     * @param value - Text value
+     * @param options - Optional property overrides.
+     */
+    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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "string-long"
+     */
+    type = "string-long";
+    /** Text value */
+    value;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Initializes a new `StringLongElementClass` instance.
+     *
+     * @param value - Text value
+     * @param options - Optional property overrides.
+     */
+    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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "string-code"
+     */
+    type = "string-code";
+    /** Text value */
+    value;
+    /** Optional syntax highlighting language identifier */
+    language;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Initializes a new `StringCodeElementClass` instance.
+     *
+     * @param value - Text value
+     * @param options - Optional property overrides.
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.language = options?.language;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `StringUrlElement` interface.
+ *
+ * @remarks
+ * Hyperlink representation for external or internal URL navigation.
+ */
+export class StringUrlElementClass extends BaseUiElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @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;
+    /**
+     * Initializes a new `StringUrlElementClass` instance.
+     *
+     * @param value - Target URL or navigation destination
+     * @param options - Optional property overrides.
+     */
+    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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "identifier"
+     */
+    type = "identifier";
+    /** Identifier string value */
+    value;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Initializes a new `IdentifierElementClass` instance.
+     *
+     * @param value - Identifier string value
+     * @param options - Optional property overrides.
+     */
+    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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "ratio"
+     */
+    type = "ratio";
+    /** Aspect ratio textual expression */
+    value;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Initializes a new `RatioElementClass` instance.
+     *
+     * @param value - Aspect ratio textual expression
+     * @param options - Optional property overrides.
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `ColourElement` interface.
+ *
+ * @remarks
+ * Single color swatch representation with hex value and copy affordance.
+ */
+export class ColourElementClass extends BaseUiElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "color-swatch"
+     */
+    type = "color-swatch";
+    /** Hexadecimal color code */
+    value;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Initializes a new `ColourElementClass` instance.
+     *
+     * @param value - Hexadecimal color code
+     * @param options - Optional property overrides.
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `NumberUnboundedElement` interface.
+ *
+ * @remarks
+ * Plain unbounded numeric value primitive element.
+ */
+export class NumberUnboundedElementClass extends BaseUiElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @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;
+    /**
+     * Initializes a new `NumberUnboundedElementClass` instance.
+     *
+     * @param value - Numeric value
+     * @param options - Optional property overrides.
+     */
+    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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @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;
+    /**
+     * Initializes a new `NumberBoundedStarsElementClass` instance.
+     *
+     * @param value - Numeric rating score
+     * @param options - Optional property overrides.
+     */
+    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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @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;
+    /**
+     * Initializes a new `NumberBoundedMeterElementClass` instance.
+     *
+     * @param value - Numeric value
+     * @param options - Optional property overrides.
+     */
+    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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "boolean-plain"
+     */
+    type = "boolean-plain";
+    /** Boolean state value */
+    value;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Initializes a new `BooleanPlainElementClass` instance.
+     *
+     * @param value - Boolean state value
+     * @param options - Optional property overrides.
+     */
+    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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @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;
+    /**
+     * Initializes a new `BooleanBadgeElementClass` instance.
+     *
+     * @param value - Boolean state value
+     * @param options - Optional property overrides.
+     */
+    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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "timestamp"
+     */
+    type = "timestamp";
+    /** ISO 8601 date string or epoch timestamp in milliseconds */
+    value;
+    /**
+     * Presentation date/time format
+     *
+     * @defaultValue TimestampFormat.full
+     */
+    format;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    modifiers;
+    /**
+     * Initializes a new `TimestampElementClass` instance.
+     *
+     * @param value - ISO 8601 date string or epoch timestamp in milliseconds
+     * @param options - Optional property overrides.
+     */
+    constructor(value, options) {
+        super();
+        this.value = value;
+        this.format = options?.format ?? TimestampFormat.full;
+        this.modifiers = options?.modifiers;
+    }
+}
+/**
+ * Class implementation of the `ImageReferenceElement` interface.
+ *
+ * @remarks
+ * Thumbnail image reference with placeholder fallback handling.
+ */
+export class ImageReferenceElementClass extends BaseUiElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @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;
+    /**
+     * Initializes a new `ImageReferenceElementClass` instance.
+     *
+     * @param src - Image source URI (HTTPS URL, base64 data URI, or asset path)
+     * @param options - Optional property overrides.
+     */
+    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 `DominantColourSetElement` interface.
+ *
+ * @remarks
+ * Dominant color set palette rendered in descending dominance order.
+ */
+export class DominantColourSetElementClass extends BaseUiElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "color-set"
+     */
+    type = "color-set";
+    /** List of hexadecimal color strings in descending priority */
+    colors;
+    /**
+     * Initializes a new `DominantColourSetElementClass` instance.
+     *
+     * @param colors - List of hexadecimal color strings in descending priority
+     */
+    constructor(colors) {
+        super();
+        this.colors = [...colors];
+    }
+}
+/**
+ * Class implementation of the `ButtonActionElement` interface.
+ *
+ * @remarks
+ * Interactive button action triggering an extension command.
+ */
+export class ButtonActionElementClass extends BaseActionElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @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;
+    /**
+     * Initializes a new `ButtonActionElementClass` instance.
+     *
+     * @param commandId - Command identifier to invoke
+     * @param label - Display label for the action
+     * @param options - Optional property overrides.
+     */
+    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 BaseActionElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "external-link"
+     */
+    type = "external-link";
+    /** Target URL destination */
+    url;
+    /** Display label for the action */
+    label;
+    /**
+     * Initializes 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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "markdown"
+     */
+    type = "markdown";
+    /** Raw Markdown markup content */
+    content;
+    /**
+     * Initializes a new `MarkdownBlockElementClass` instance.
+     *
+     * @param content - Raw Markdown markup content
+     */
+    constructor(content) {
+        super();
+        this.content = content;
+    }
+}
+/**
+ * Class implementation of the `HtmlBlockElement` interface.
+ *
+ * @remarks
+ * Sandboxed HTML rendering escape hatch.
+ */
+export class HtmlBlockElementClass extends BaseUiElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "html"
+     */
+    type = "html";
+    /** Raw HTML markup content */
+    content;
+    /**
+     * Initializes a new `HtmlBlockElementClass` instance.
+     *
+     * @param content - Raw HTML markup content
+     */
+    constructor(content) {
+        super();
+        this.content = content;
+    }
+}
+/**
+ * Class implementation of the `Slot` interface.
+ *
+ * @remarks
+ * Single slot within a multi-slot horizontal row layout.
+ */
+export class SlotClass extends GrammarNode {
+    /** 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;
+    /**
+     * Initializes a new `SlotClass` instance.
+     *
+     * @param content - Rendered content inside the slot
+     * @param options - Optional property overrides.
+     */
+    constructor(content, options) {
+        super();
+        this.content = content;
+        this.label = options?.label;
+        this.width = options?.width;
+    }
+}
+/**
+ * Class implementation of the `MultiSlotRowElement` interface.
+ *
+ * @remarks
+ * Multi-slot horizontal row with declared column width proportions.
+ * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
+ */
+export class MultiSlotRowElementClass extends BaseUiElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @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;
+    /**
+     * Initializes a new `MultiSlotRowElementClass` instance.
+     *
+     * @param slots - List of slots comprising the row
+     * @param options - Optional property overrides.
+     */
+    constructor(slots, options) {
+        super();
+        this.slots = [...slots];
+        this.proportions = options?.proportions;
+    }
+}
+/**
+ * Class implementation of the `LabelValueRowElement` 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 LabelValueRowElementClass extends BaseUiElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @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;
+    /**
+     * Initializes a new `LabelValueRowElementClass` instance.
+     *
+     * @param label - Key or descriptive label displayed muted on the left
+     * @param value - Rendered value element on the right
+     * @param options - Optional property overrides.
+     */
+    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 GrammarNode {
+    /** Display header text */
+    header;
+    /**
+     * Text horizontal alignment
+     *
+     * @defaultValue TableColumnAlign.left
+     */
+    align;
+    /** Optional width constraint */
+    width;
+    /**
+     * Initializes a new `TableColumnClass` instance.
+     *
+     * @param options - Optional property overrides.
+     */
+    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 GrammarNode {
+    /** Array of cell values corresponding to table columns */
+    cells;
+    /**
+     * Initializes a new `TableRowClass` instance.
+     *
+     * @param cells - Array of cell values corresponding to table columns
+     */
+    constructor(cells) {
+        super();
+        this.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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "table"
+     */
+    type = "table";
+    /** Tabular data rows */
+    rows;
+    /**
+     * Whether to render a column header row
+     *
+     * @defaultValue true
+     */
+    hasHeader;
+    /** Optional explicit column definitions */
+    columns;
+    /** Maximum recommended visible columns at 360px panel width */
+    maxColumns;
+    /**
+     * Initializes a new `TableElementClass` instance.
+     *
+     * @param rows - Tabular data rows
+     * @param options - Optional property overrides.
+     */
+    constructor(rows, options) {
+        super();
+        this.rows = [...rows];
+        this.hasHeader = options?.hasHeader ?? true;
+        this.columns = options?.columns ? [...options.columns] : undefined;
+        this.maxColumns = options?.maxColumns;
+    }
+}
+/**
+ * Class implementation of the `RepeatingGroupEntry` interface.
+ *
+ * @remarks
+ * Single entry within a repeating group.
+ */
+export class RepeatingGroupEntryClass extends GrammarNode {
+    /** Entry label */
+    label;
+    /** Primary entry value or nested elements */
+    value;
+    /** Nested elements for structured entries */
+    elements;
+    /**
+     * Initializes a new `RepeatingGroupEntryClass` instance.
+     *
+     * @param label - Entry label
+     * @param options - Optional property overrides.
+     */
+    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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "repeating-group"
+     */
+    type = "repeating-group";
+    /** List of repeated entry records */
+    entries;
+    /** Optional section header for the group */
+    title;
+    /**
+     * Initializes a new `RepeatingGroupElementClass` instance.
+     *
+     * @param entries - List of repeated entry records
+     * @param options - Optional property overrides.
+     */
+    constructor(entries, options) {
+        super();
+        this.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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @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;
+    /**
+     * Initializes a new `CollapsibleGroupElementClass` instance.
+     *
+     * @param title - Group title (e.g. "Show specimen details")
+     * @param elements - Nested content elements revealed when expanded
+     * @param options - Optional property overrides.
+     */
+    constructor(title, elements, options) {
+        super();
+        this.title = title;
+        this.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 {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "divider"
+     */
+    type = "divider";
+    /**
+     * Line styling
+     *
+     * @defaultValue DividerStyle.hairline
+     */
+    style;
+    /**
+     * Initializes a new `DividerElementClass` instance.
+     *
+     * @param options - Optional property overrides.
+     */
+    constructor(options) {
+        super();
+        this.style = options?.style ?? DividerStyle.hairline;
+    }
+}
+/**
+ * Fluent builder for constructing strongly-typed `FeatureBlock` card instances.
+ *
+ * @remarks
+ * Root Feature Block container model.
+ * Represents a complete feature card rendered inside the 360px panel.
+ */
+export class FeatureBlockBuilder {
+    _title;
+    _description;
+    _elements = [];
+    _actions = [];
+    /**
+     * Initializes a new `FeatureBlockBuilder` with mandatory card properties.
+     *
+     * @param title - Human-readable feature title displayed in the card header
+     */
+    constructor(title) {
+        this._title = title;
+    }
+    /**
+     * Sets the `description` property on this card.
+     *
+     * @param description - Optional neutral subtitle / description for the feature
+     * @returns This builder instance for method chaining.
+     */
+    description(description) {
+        this._description = description;
+        return this;
+    }
+    /**
+     * Appends a visual element to the card.
+     *
+     * @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 to the card.
+     *
+     * @param items - The `UiElement` items to add.
+     * @returns This builder instance for method chaining.
+     */
+    addElements(...items) {
+        this._elements.push(...items);
+        return this;
+    }
+    /**
+     * Appends multiple actions items to the card.
+     *
+     * @param items - The `ActionElement` items to add.
+     * @returns This builder instance for method chaining.
+     */
+    addActions(...items) {
+        this._actions.push(...items);
+        return this;
+    }
+    /**
+     * Appends a single action to the card.
+     *
+     * @param item - The `ActionElement` item to add.
+     * @returns This builder instance for method chaining.
+     */
+    addAction(item) {
+        this._actions.push(item);
+        return this;
+    }
+    /**
+     * Appends a `StringShortElement` component to this feature card.
+     *
+     * @remarks
+     * Short string primitive element.
+     * Supports plain text or compact chip pill presentation.
+     *
+     * @param value - Text value
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addStringShort(value, options) {
+        return this.add(stringShort(value, options));
+    }
+    /**
+     * Appends a `StringLongElement` component to this feature card.
+     *
+     * @remarks
+     * Multiline text block primitive element for descriptions, comments, or prose.
+     *
+     * @param value - Text value
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addStringLong(value, options) {
+        return this.add(stringLong(value, options));
+    }
+    /**
+     * Appends a `StringCodeElement` component to this feature card.
+     *
+     * @remarks
+     * Monospace code block or formatted code snippet representation.
+     *
+     * @param value - Text value
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addStringCode(value, options) {
+        return this.add(stringCode(value, options));
+    }
+    /**
+     * Appends a `StringUrlElement` component to this feature card.
+     *
+     * @remarks
+     * Hyperlink representation for external or internal URL navigation.
+     *
+     * @param value - Target URL or navigation destination
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addStringUrl(value, options) {
+        return this.add(stringUrl(value, options));
+    }
+    /**
+     * Appends a `IdentifierElement` component to this feature card.
+     *
+     * @remarks
+     * Monospace semantic identifier representation.
+     *
+     * @param value - Identifier string value
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addIdentifier(value, options) {
+        return this.add(identifier(value, options));
+    }
+    /**
+     * Appends a `RatioElement` component to this feature card.
+     *
+     * @remarks
+     * Aspect ratio representation (e.g. "16:9", "4:3", "1:1").
+     *
+     * @param value - Aspect ratio textual expression
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addRatio(value, options) {
+        return this.add(ratio(value, options));
+    }
+    /**
+     * Appends a `ColourElement` component to this feature card.
+     *
+     * @remarks
+     * Single color swatch representation with hex value and copy affordance.
+     *
+     * @param value - Hexadecimal color code
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addColour(value, options) {
+        return this.add(colour(value, options));
+    }
+    /**
+     * Appends a `ColourElement` component to this feature card.
+     *
+     * @remarks
+     * Single color swatch representation with hex value and copy affordance.
+     *
+     * @param value - Hexadecimal color code
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addColorSwatch(value, options) {
+        return this.add(colorSwatch(value, options));
+    }
+    /**
+     * Appends a `NumberUnboundedElement` component to this feature card.
+     *
+     * @remarks
+     * Plain unbounded numeric value primitive element.
+     *
+     * @param value - Numeric value
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addNumberUnbounded(value, options) {
+        return this.add(numberUnbounded(value, options));
+    }
+    /**
+     * Appends a `NumberBoundedStarsElement` component to this feature card.
+     *
+     * @remarks
+     * Bounded numeric rating represented as visual stars.
+     *
+     * @param value - Numeric rating score
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addNumberBoundedStars(value, options) {
+        return this.add(numberBoundedStars(value, options));
+    }
+    /**
+     * Appends a `NumberBoundedStarsElement` component to this feature card.
+     *
+     * @remarks
+     * Bounded numeric rating represented as visual stars.
+     *
+     * @param value - Numeric rating score
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addNumberStars(value, options) {
+        return this.add(numberStars(value, options));
+    }
+    /**
+     * Appends a `NumberBoundedMeterElement` component to this feature card.
+     *
+     * @remarks
+     * Bounded numeric meter representation (read-only progress / score bar).
+     *
+     * @param value - Numeric value
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addNumberBoundedMeter(value, options) {
+        return this.add(numberBoundedMeter(value, options));
+    }
+    /**
+     * Appends a `NumberBoundedMeterElement` component to this feature card.
+     *
+     * @remarks
+     * Bounded numeric meter representation (read-only progress / score bar).
+     *
+     * @param value - Numeric value
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addNumberMeter(value, options) {
+        return this.add(numberMeter(value, options));
+    }
+    /**
+     * Appends a `BooleanPlainElement` component to this feature card.
+     *
+     * @remarks
+     * Plain boolean value representation (textual "true" / "false").
+     *
+     * @param value - Boolean state value
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addBooleanPlain(value, options) {
+        return this.add(booleanPlain(value, options));
+    }
+    /**
+     * Appends a `BooleanBadgeElement` component to this feature card.
+     *
+     * @remarks
+     * Visual badge pill representation of a boolean state.
+     *
+     * @param value - Boolean state value
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addBooleanBadge(value, options) {
+        return this.add(booleanBadge(value, options));
+    }
+    /**
+     * Appends a `TimestampElement` component to this feature card.
+     *
+     * @remarks
+     * Formatted date and time representation.
+     *
+     * @param value - ISO 8601 date string or epoch timestamp in milliseconds
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addTimestamp(value, options) {
+        return this.add(timestamp(value, options));
+    }
+    /**
+     * Appends a `ImageReferenceElement` component to this feature card.
+     *
+     * @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.
+     * @returns This builder instance for method chaining.
+     */
+    addImageReference(src, options) {
+        return this.add(imageReference(src, options));
+    }
+    /**
+     * Appends a `ImageReferenceElement` component to this feature card.
+     *
+     * @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.
+     * @returns This builder instance for method chaining.
+     */
+    addImageRef(src, options) {
+        return this.add(imageRef(src, options));
+    }
+    /**
+     * Appends a `DominantColourSetElement` component to this feature card.
+     *
+     * @remarks
+     * Dominant color set palette rendered in descending dominance order.
+     *
+     * @param colors - List of hexadecimal color strings in descending priority
+     * @returns This builder instance for method chaining.
+     */
+    addDominantColourSet(colors) {
+        return this.add(dominantColourSet(colors));
+    }
+    /**
+     * Appends a `DominantColourSetElement` component to this feature card.
+     *
+     * @remarks
+     * Dominant color set palette rendered in descending dominance order.
+     *
+     * @param colors - List of hexadecimal color strings in descending priority
+     * @returns This builder instance for method chaining.
+     */
+    addDominantColors(colors) {
+        return this.add(dominantColors(colors));
+    }
+    /**
+     * Appends a `MarkdownBlockElement` component to this feature card.
+     *
+     * @remarks
+     * Full Markdown fallback block rendered with core typographic hierarchy, spacing, and styling.
+     *
+     * @param content - Raw Markdown markup content
+     * @returns This builder instance for method chaining.
+     */
+    addMarkdownBlock(content) {
+        return this.add(markdownBlock(content));
+    }
+    /**
+     * Appends a `MarkdownBlockElement` component to this feature card.
+     *
+     * @remarks
+     * Full Markdown fallback block rendered with core typographic hierarchy, spacing, and styling.
+     *
+     * @param content - Raw Markdown markup content
+     * @returns This builder instance for method chaining.
+     */
+    addMarkdown(content) {
+        return this.add(markdown(content));
+    }
+    /**
+     * Appends a `HtmlBlockElement` component to this feature card.
+     *
+     * @remarks
+     * Sandboxed HTML rendering escape hatch.
+     *
+     * @param content - Raw HTML markup content
+     * @returns This builder instance for method chaining.
+     */
+    addHtmlBlock(content) {
+        return this.add(htmlBlock(content));
+    }
+    /**
+     * Appends a `HtmlBlockElement` component to this feature card.
+     *
+     * @remarks
+     * Sandboxed HTML rendering escape hatch.
+     *
+     * @param content - Raw HTML markup content
+     * @returns This builder instance for method chaining.
+     */
+    addHtml(content) {
+        return this.add(html(content));
+    }
+    /**
+     * Appends a `MultiSlotRowElement` component to this feature card.
+     *
+     * @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.
+     * @returns This builder instance for method chaining.
+     */
+    addMultiSlotRow(slots, options) {
+        return this.add(multiSlotRow(slots, options));
+    }
+    /**
+     * Appends a `MultiSlotRowElement` component to this feature card.
+     *
+     * @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.
+     * @returns This builder instance for method chaining.
+     */
+    addMultiSlot(slots, options) {
+        return this.add(multiSlot(slots, options));
+    }
+    /**
+     * Appends a `LabelValueRowElement` component to this feature card.
+     *
+     * @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.
+     * @returns This builder instance for method chaining.
+     */
+    addLabelValueRow(label, value, options) {
+        return this.add(labelValueRow(label, value, options));
+    }
+    /**
+     * Appends a `LabelValueRowElement` component to this feature card.
+     *
+     * @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.
+     * @returns This builder instance for method chaining.
+     */
+    addLabelValue(label, value, options) {
+        return this.add(labelValue(label, value, options));
+    }
+    /**
+     * Appends a `TableElement` component to this feature card.
+     *
+     * @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.
+     * @returns This builder instance for method chaining.
+     */
+    addTable(rows, options) {
+        return this.add(table(rows, options));
+    }
+    /**
+     * Appends a `RepeatingGroupElement` component to this feature card.
+     *
+     * @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.
+     * @returns This builder instance for method chaining.
+     */
+    addRepeatingGroup(entries, options) {
+        return this.add(repeatingGroup(entries, options));
+    }
+    /**
+     * Appends a `CollapsibleGroupElement` component to this feature card.
+     *
+     * @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.
+     * @returns This builder instance for method chaining.
+     */
+    addCollapsibleGroup(title, elements, options) {
+        return this.add(collapsibleGroup(title, elements, options));
+    }
+    /**
+     * Appends a `DividerElement` component to this feature card.
+     *
+     * @remarks
+     * Visual hairline separator separating sections or element groups.
+     *
+     * @param options - Optional component settings.
+     * @returns This builder instance for method chaining.
+     */
+    addDivider(options) {
+        return this.add(divider(options));
+    }
+    /**
+     * Finalizes and returns the complete strongly-typed `FeatureBlock` card object.
+     *
+     * @returns The constructed `FeatureBlock` object.
+     */
+    build() {
+        return {
+            schemaVersion: "1.0",
+            title: this._title,
+            description: this._description,
+            elements: [...this._elements],
+            actions: this._actions.length > 0 ? [...this._actions] : undefined
+        };
+    }
+}
+/** Static helper factory object for `FeatureBlock`. */
+export const FeatureBlock = {
+    /**
+     * Creates a new fluent builder for constructing a `FeatureBlock`.
+     *
+     * @param title - Human-readable feature title displayed in the card header
+     * @returns A new `FeatureBlockBuilder` instance.
+     */
+    builder(title) {
+        return new FeatureBlockBuilder(title);
+    },
+    /**
+     * Creates a `FeatureBlock` directly from a properties object.
+     *
+     * @param params - Card configuration properties.
+     * @returns A completed `FeatureBlock` object.
+     */
+    create(params) {
+        return {
+            schemaVersion: "1.0",
+            title: params.title,
+            description: params.description,
+            elements: [...params.elements],
+            actions: params.actions ? [...params.actions] : undefined
+        };
+    }
+};
+/**
+ * Functional helper to create a `FeatureBlock` instance directly.
+ *
+ * @remarks
+ * Root Feature Block 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 card configuration (description, attribution, elements, actions).
+ * @returns A strongly-typed `FeatureBlock` card.
+ */
+export function createFeatureBlock(title, options) {
+    return {
+        schemaVersion: "1.0",
+        title,
+        description: options?.description,
+        elements: options?.elements ? [...options.elements] : [],
+        actions: options?.actions ? [...options.actions] : undefined
+    };
+}
+// --- 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 `PrimitiveModifiers` component instance.
+ *
+ * @remarks
+ * Common modifier traits that can be attached to primitive elements.
+ *
+ * @param options - Optional settings (copyable, truncate, emphasis (defaults to `normal`), monospace (defaults to `false`)).
+ * @returns A strongly-typed `PrimitiveModifiers` object.
+ */
+export function primitiveModifiers(options) {
+    return {
+        copyable: options?.copyable,
+        truncate: options?.truncate,
+        emphasis: options?.emphasis ?? Emphasis.normal,
+        monospace: options?.monospace ?? false
+    };
+}
+/**
+ * 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 `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 textual 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 swatch representation with hex value and copy affordance.
+ *
+ * @param value - Hexadecimal color code
+ * @param options - Optional settings (modifiers).
+ * @returns A strongly-typed `ColourElement` object.
+ */
+export function colour(value, options) {
+    return {
+        type: "color-swatch",
+        value,
+        modifiers: options?.modifiers
+    };
+}
+/**
+ * Creates a `ColourElement` component instance.
+ *
+ * @remarks
+ * Single color swatch representation with hex value and copy affordance.
+ *
+ * @param value - Hexadecimal color code
+ * @param options - Optional settings (modifiers).
+ * @returns A strongly-typed `ColourElement` object.
+ */
+export function colorSwatch(value, options) {
+    return {
+        type: "color-swatch",
+        value,
+        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 - ISO 8601 date string or epoch timestamp in milliseconds
+ * @param options - Optional settings (format (defaults to `full`), modifiers).
+ * @returns A strongly-typed `TimestampElement` object.
+ */
+export function timestamp(value, options) {
+    return {
+        type: "timestamp",
+        value,
+        format: options?.format ?? TimestampFormat.full,
+        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 `DominantColourSetElement` component instance.
+ *
+ * @remarks
+ * Dominant color set palette rendered in descending dominance order.
+ *
+ * @param colors - List of hexadecimal color strings in descending priority
+ * @returns A strongly-typed `DominantColourSetElement` object.
+ */
+export function dominantColourSet(colors) {
+    return {
+        type: "color-set",
+        colors: [...colors]
+    };
+}
+/**
+ * Creates a `DominantColourSetElement` component instance.
+ *
+ * @remarks
+ * Dominant color set palette rendered in descending dominance order.
+ *
+ * @param colors - List of hexadecimal color strings in descending priority
+ * @returns A strongly-typed `DominantColourSetElement` object.
+ */
+export function dominantColors(colors) {
+    return {
+        type: "color-set",
+        colors: [...colors]
+    };
+}
+/**
+ * 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
+ * @returns A strongly-typed `MarkdownBlockElement` object.
+ */
+export function markdownBlock(content) {
+    return {
+        type: "markdown",
+        content
+    };
+}
+/**
+ * Creates a `MarkdownBlockElement` component instance.
+ *
+ * @remarks
+ * Full Markdown fallback block rendered with core typographic hierarchy, spacing, and styling.
+ *
+ * @param content - Raw Markdown markup content
+ * @returns A strongly-typed `MarkdownBlockElement` object.
+ */
+export function markdown(content) {
+    return {
+        type: "markdown",
+        content
+    };
+}
+/**
+ * Creates a `HtmlBlockElement` component instance.
+ *
+ * @remarks
+ * Sandboxed HTML rendering escape hatch.
+ *
+ * @param content - Raw HTML markup content
+ * @returns A strongly-typed `HtmlBlockElement` object.
+ */
+export function htmlBlock(content) {
+    return {
+        type: "html",
+        content
+    };
+}
+/**
+ * Creates a `HtmlBlockElement` component instance.
+ *
+ * @remarks
+ * Sandboxed HTML rendering escape hatch.
+ *
+ * @param content - Raw HTML markup content
+ * @returns A strongly-typed `HtmlBlockElement` object.
+ */
+export function html(content) {
+    return {
+        type: "html",
+        content
+    };
+}
+/**
+ * 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 `MultiSlotRowElement` component instance.
+ *
+ * @remarks
+ * Multi-slot horizontal row with declared column width proportions.
+ * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
+ *
+ * @param slots - List of slots comprising the row
+ * @param options - Optional settings (proportions).
+ * @returns A strongly-typed `MultiSlotRowElement` object.
+ */
+export function multiSlotRow(slots, options) {
+    return {
+        type: "multi-slot",
+        slots: [...slots],
+        proportions: options?.proportions
+    };
+}
+/**
+ * Creates a `MultiSlotRowElement` component instance.
+ *
+ * @remarks
+ * Multi-slot horizontal row with declared column width proportions.
+ * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
+ *
+ * @param slots - List of slots comprising the row
+ * @param options - Optional settings (proportions).
+ * @returns A strongly-typed `MultiSlotRowElement` object.
+ */
+export function multiSlot(slots, options) {
+    return {
+        type: "multi-slot",
+        slots: [...slots],
+        proportions: options?.proportions
+    };
+}
+/**
+ * Creates a `LabelValueRowElement` 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 `LabelValueRowElement` object.
+ */
+export function labelValueRow(label, value, options) {
+    return {
+        type: "label-value",
+        label,
+        value,
+        withDivider: options?.withDivider ?? false
+    };
+}
+/**
+ * Creates a `LabelValueRowElement` 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 `LabelValueRowElement` 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`), columns, maxColumns).
+ * @returns A strongly-typed `TableElement` object.
+ */
+export function table(rows, options) {
+    return {
+        type: "table",
+        rows: [...rows],
+        hasHeader: options?.hasHeader ?? true,
+        columns: options?.columns ? [...options.columns] : undefined,
+        maxColumns: options?.maxColumns
+    };
+}
+/**
+ * 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
+    };
+}
+// --- Type Guards ---
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `UiElement`.
+ *
+ * @param value - The value to inspect.
+ * @returns `true` if the value is a valid `UiElement`, otherwise `false`.
+ */
+export function isUiElement(value) {
+    return typeof value === "object" && value !== null && "type" in value && typeof value.type === "string";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `StringShortElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `StringShortElement` (type = "string-short"), otherwise `false`.
+ */
+export function isStringShortElement(element) {
+    return element.type === "string-short";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `StringLongElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `StringLongElement` (type = "string-long"), otherwise `false`.
+ */
+export function isStringLongElement(element) {
+    return element.type === "string-long";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `StringCodeElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `StringCodeElement` (type = "string-code"), otherwise `false`.
+ */
+export function isStringCodeElement(element) {
+    return element.type === "string-code";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `StringUrlElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `StringUrlElement` (type = "string-url"), otherwise `false`.
+ */
+export function isStringUrlElement(element) {
+    return element.type === "string-url";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `IdentifierElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `IdentifierElement` (type = "identifier"), otherwise `false`.
+ */
+export function isIdentifierElement(element) {
+    return element.type === "identifier";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `RatioElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `RatioElement` (type = "ratio"), otherwise `false`.
+ */
+export function isRatioElement(element) {
+    return element.type === "ratio";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `ColourElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `ColourElement` (type = "color-swatch"), otherwise `false`.
+ */
+export function isColourElement(element) {
+    return element.type === "color-swatch";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `NumberUnboundedElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `NumberUnboundedElement` (type = "number-unbounded"), otherwise `false`.
+ */
+export function isNumberUnboundedElement(element) {
+    return element.type === "number-unbounded";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `NumberBoundedStarsElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `NumberBoundedStarsElement` (type = "number-stars"), otherwise `false`.
+ */
+export function isNumberBoundedStarsElement(element) {
+    return element.type === "number-stars";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `NumberBoundedMeterElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `NumberBoundedMeterElement` (type = "number-meter"), otherwise `false`.
+ */
+export function isNumberBoundedMeterElement(element) {
+    return element.type === "number-meter";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `BooleanPlainElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `BooleanPlainElement` (type = "boolean-plain"), otherwise `false`.
+ */
+export function isBooleanPlainElement(element) {
+    return element.type === "boolean-plain";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `BooleanBadgeElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `BooleanBadgeElement` (type = "boolean-badge"), otherwise `false`.
+ */
+export function isBooleanBadgeElement(element) {
+    return element.type === "boolean-badge";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `TimestampElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `TimestampElement` (type = "timestamp"), otherwise `false`.
+ */
+export function isTimestampElement(element) {
+    return element.type === "timestamp";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `ImageReferenceElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `ImageReferenceElement` (type = "image-ref"), otherwise `false`.
+ */
+export function isImageReferenceElement(element) {
+    return element.type === "image-ref";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `DominantColourSetElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `DominantColourSetElement` (type = "color-set"), otherwise `false`.
+ */
+export function isDominantColourSetElement(element) {
+    return element.type === "color-set";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `MarkdownBlockElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `MarkdownBlockElement` (type = "markdown"), otherwise `false`.
+ */
+export function isMarkdownBlockElement(element) {
+    return element.type === "markdown";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `HtmlBlockElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `HtmlBlockElement` (type = "html"), otherwise `false`.
+ */
+export function isHtmlBlockElement(element) {
+    return element.type === "html";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `MultiSlotRowElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `MultiSlotRowElement` (type = "multi-slot"), otherwise `false`.
+ */
+export function isMultiSlotRowElement(element) {
+    return element.type === "multi-slot";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `LabelValueRowElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `LabelValueRowElement` (type = "label-value"), otherwise `false`.
+ */
+export function isLabelValueRowElement(element) {
+    return element.type === "label-value";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `TableElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `TableElement` (type = "table"), otherwise `false`.
+ */
+export function isTableElement(element) {
+    return element.type === "table";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `RepeatingGroupElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `RepeatingGroupElement` (type = "repeating-group"), otherwise `false`.
+ */
+export function isRepeatingGroupElement(element) {
+    return element.type === "repeating-group";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `CollapsibleGroupElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `CollapsibleGroupElement` (type = "collapsible-group"), otherwise `false`.
+ */
+export function isCollapsibleGroupElement(element) {
+    return element.type === "collapsible-group";
+}
+/**
+ * Type guard predicate narrowing a `UiElement` to `DividerElement`.
+ *
+ * @param element - The `UiElement` instance to inspect.
+ * @returns `true` if the element is a `DividerElement` (type = "divider"), otherwise `false`.
+ */
+export function isDividerElement(element) {
+    return element.type === "divider";
+}
+/**
+ * Type guard predicate verifying whether an unknown value conforms to `ActionElement`.
+ *
+ * @param value - The value to inspect.
+ * @returns `true` if the value is a valid `ActionElement`, otherwise `false`.
+ */
+export function isActionElement(value) {
+    return typeof value === "object" && value !== null && "type" in value && typeof value.type === "string";
+}
+/**
+ * Type guard predicate narrowing a `ActionElement` to `ButtonActionElement`.
+ *
+ * @param element - The `ActionElement` instance to inspect.
+ * @returns `true` if the element is a `ButtonActionElement` (type = "button"), otherwise `false`.
+ */
+export function isButtonActionElement(element) {
+    return element.type === "button";
+}
+/**
+ * Type guard predicate narrowing a `ActionElement` to `ExternalLinkActionElement`.
+ *
+ * @param element - The `ActionElement` instance to inspect.
+ * @returns `true` if the element is a `ExternalLinkActionElement` (type = "external-link"), otherwise `false`.
+ */
+export function isExternalLinkActionElement(element) {
+    return element.type === "external-link";
+}