@picteus/extension-sdk 0.14.0 → 0.16.0

package/dist/featureViewGrammar.d.ts

@@ -0,0 +1,2814 @@
+/** Generic base class providing recursive JSON serialization for all model instances. */
+export declare abstract class GrammarNode<T = unknown> {
+    /**
+     * Serializes this model instance into a strongly-typed, JSON-compatible plain object.
+     *
+     * @returns The plain object representation conforming to interface `T`.
+     */
+    toJSON(): T;
+}
+/** Text emphasis and visual weight styling. */
+export declare enum Emphasis {
+    /** Subdued or secondary appearance with lower visual contrast */
+    muted = "muted",
+    /** Standard text weight and contrast */
+    normal = "normal",
+    /** Emphasized / bold text weight for prominence */
+    strong = "strong"
+}
+/** Representation style for short string values. */
+export declare enum StringShortRepresentation {
+    /** Standard plain text rendering */
+    plain = "plain",
+    /** Visual chip / tag pill representation */
+    chip = "chip"
+}
+/** Visual color tone variants for badge pill representations. */
+export declare enum BadgeVariant {
+    /** Neutral gray tone */
+    neutral = "neutral",
+    /** Success green tone */
+    success = "success",
+    /** Warning yellow/orange tone */
+    warning = "warning",
+    /** Danger red tone */
+    danger = "danger"
+}
+/** Presentation format styles for timestamp elements. */
+export declare enum TimestampFormat {
+    /** Complete date and time display */
+    full = "full",
+    /** Date-only display */
+    date = "date",
+    /** Time-only display */
+    time = "time",
+    /** Relative time expression (e.g. "5 minutes ago") */
+    relative = "relative"
+}
+/** Visual style variants for interactive button actions. */
+export declare enum ButtonVariant {
+    /** Primary emphasis button style for default/recommended actions */
+    primary = "primary",
+    /** Secondary standard button style */
+    secondary = "secondary",
+    /** Subtle low-contrast button style */
+    subtle = "subtle",
+    /** Destructive / dangerous action button style */
+    danger = "danger"
+}
+/** Text horizontal alignment options for table columns. */
+export declare enum TableColumnAlign {
+    /** Left-aligned text */
+    left = "left",
+    /** Center-aligned text */
+    center = "center",
+    /** Right-aligned text */
+    right = "right"
+}
+/** Visual styling variants for hairline dividers. */
+export declare enum DividerStyle {
+    /** Subtle thin hairline border */
+    hairline = "hairline",
+    /** Solid standard divider line */
+    solid = "solid",
+    /** Dashed separator line */
+    dashed = "dashed"
+}
+/**
+ * Polymorphic root base model for all visual UI elements in Picteus feature views.
+ * Uses the @discriminator("type") decorator so all child models inheriting from UiElement
+ * are automatically recognized by schema emitters and SDK code generators.
+ */
+export interface UiElementBase {
+    /** The polymorphic discriminator type tag. */
+    readonly type: string;
+}
+/** Abstract base class for all `UiElement` models. */
+export declare abstract class BaseUiElement<T = UiElement> extends GrammarNode<T> implements UiElementBase {
+    abstract readonly type: string;
+}
+/** Polymorphic base model for interactive actions. */
+export interface ActionElementBase {
+    /** The polymorphic discriminator type tag. */
+    readonly type: string;
+    /** Display label for the action */
+    readonly label: string;
+}
+/** Abstract base class for all `ActionElement` models. */
+export declare abstract class BaseActionElement<T = ActionElement> extends GrammarNode<T> implements ActionElementBase {
+    abstract readonly type: string;
+    abstract readonly label: string;
+}
+/** Truncation configuration for long textual content with optional expand affordance. */
+export interface TruncateOptions {
+    /** Maximum number of characters to display before truncating */
+    readonly characterLimit: number;
+    /**
+     * Whether to render a "Show more" / "Show less" toggle affordance
+     *
+     * @defaultValue true
+     */
+    readonly showMore?: boolean;
+}
+/** Common modifier traits that can be attached to primitive elements. */
+export interface PrimitiveModifiers {
+    /** Adds an interactive copy button/action next to the rendered value */
+    readonly copyable?: boolean;
+    /** Configures character truncation threshold with show-more affordance */
+    readonly truncate?: TruncateOptions;
+    /**
+     * Text emphasis level
+     *
+     * @defaultValue Emphasis.normal
+     */
+    readonly emphasis?: Emphasis;
+    /**
+     * Whether to use monospace font rendering (for hashes, IDs, codes)
+     *
+     * @defaultValue false
+     */
+    readonly monospace?: boolean;
+}
+/**
+ * Short string primitive element.
+ * Supports plain text or compact chip pill presentation.
+ */
+export interface StringShortElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "string-short"
+     */
+    readonly type: "string-short";
+    /** Text value */
+    readonly value: string;
+    /**
+     * Display representation mode
+     *
+     * @defaultValue StringShortRepresentation.plain
+     */
+    readonly representation?: StringShortRepresentation;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+}
+/** Multiline text block primitive element for descriptions, comments, or prose. */
+export interface StringLongElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "string-long"
+     */
+    readonly type: "string-long";
+    /** Text value */
+    readonly value: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+}
+/** Monospace code block or formatted code snippet representation. */
+export interface StringCodeElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "string-code"
+     */
+    readonly type: "string-code";
+    /** Text value */
+    readonly value: string;
+    /** Optional syntax highlighting language identifier */
+    readonly language?: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+}
+/** Hyperlink representation for external or internal URL navigation. */
+export interface StringUrlElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "string-url"
+     */
+    readonly type: "string-url";
+    /** Target URL or navigation destination */
+    readonly value: string;
+    /** Optional custom anchor text label */
+    readonly label?: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+}
+/** Monospace semantic identifier representation. */
+export interface IdentifierElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "identifier"
+     */
+    readonly type: "identifier";
+    /** Identifier string value */
+    readonly value: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+}
+/** Aspect ratio representation (e.g. "16:9", "4:3", "1:1"). */
+export interface RatioElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "ratio"
+     */
+    readonly type: "ratio";
+    /** Aspect ratio textual expression */
+    readonly value: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+}
+/** Single color swatch representation with hex value and copy affordance. */
+export interface ColourElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "color-swatch"
+     */
+    readonly type: "color-swatch";
+    /** Hexadecimal color code */
+    readonly value: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+}
+/** Plain unbounded numeric value primitive element. */
+export interface NumberUnboundedElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "number-unbounded"
+     */
+    readonly type: "number-unbounded";
+    /** Numeric value */
+    readonly value: number;
+    /** Optional unit suffix (e.g. "px", "ms", "MB") */
+    readonly unit?: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+}
+/** Bounded numeric rating represented as visual stars. */
+export interface NumberBoundedStarsElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "number-stars"
+     */
+    readonly type: "number-stars";
+    /** Numeric rating score */
+    readonly value: number;
+    /** Maximum rating scale (defaults to 5) */
+    readonly maximum?: number;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+}
+/** Bounded numeric meter representation (read-only progress / score bar). */
+export interface NumberBoundedMeterElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "number-meter"
+     */
+    readonly type: "number-meter";
+    /** Numeric value */
+    readonly value: number;
+    /** Minimum scale bound (defaults to 0) */
+    readonly minimum?: number;
+    /** Maximum scale bound (e.g. 100) */
+    readonly maximum?: number;
+    /** Optional custom text label override (e.g. "68 / 100") */
+    readonly label?: string;
+    /** Optional unit suffix (e.g. "%") */
+    readonly unit?: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+}
+/** Plain boolean value representation (textual "true" / "false"). */
+export interface BooleanPlainElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "boolean-plain"
+     */
+    readonly type: "boolean-plain";
+    /** Boolean state value */
+    readonly value: boolean;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+}
+/** Visual badge pill representation of a boolean state. */
+export interface BooleanBadgeElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "boolean-badge"
+     */
+    readonly type: "boolean-badge";
+    /** Boolean state value */
+    readonly value: boolean;
+    /**
+     * Custom display label when true (defaults to "true")
+     *
+     * @defaultValue "true"
+     */
+    readonly trueLabel?: string;
+    /**
+     * Custom display label when false (defaults to "false")
+     *
+     * @defaultValue "false"
+     */
+    readonly falseLabel?: string;
+    /**
+     * Badge color tone
+     *
+     * @defaultValue BadgeVariant.neutral
+     */
+    readonly variant?: BadgeVariant;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+}
+/** Formatted date and time representation. */
+export interface TimestampElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "timestamp"
+     */
+    readonly type: "timestamp";
+    /** ISO 8601 date string or epoch timestamp in milliseconds */
+    readonly value: string;
+    /**
+     * Presentation date/time format
+     *
+     * @defaultValue TimestampFormat.full
+     */
+    readonly format?: TimestampFormat;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+}
+/** Thumbnail image reference with placeholder fallback handling. */
+export interface ImageReferenceElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "image-ref"
+     */
+    readonly type: "image-ref";
+    /** Image source URI (HTTPS URL, base64 data URI, or asset path) */
+    readonly src: string;
+    /** Accessible alternative description */
+    readonly alt?: string;
+    /**
+     * Aspect ratio of the thumbnail container
+     *
+     * @defaultValue "1:1"
+     */
+    readonly aspectRatio?: string;
+    /** Fallback placeholder image URI */
+    readonly placeholder?: string;
+}
+/** Dominant color set palette rendered in descending dominance order. */
+export interface DominantColourSetElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "color-set"
+     */
+    readonly type: "color-set";
+    /** List of hexadecimal color strings in descending priority */
+    readonly colors: string[];
+}
+/** Interactive button action triggering an extension command. */
+export interface ButtonActionElement extends ActionElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "button"
+     */
+    readonly type: "button";
+    /** Extension identifier owning the target command */
+    readonly extensionId?: string;
+    /** Command identifier to invoke */
+    readonly commandId: string;
+    /** Target entity or context identifier */
+    readonly target?: string;
+    /** Optional arbitrary parameters payload forwarded to the command handler */
+    readonly parameters?: Record<string, unknown>;
+    /**
+     * Whether the button is disabled / unavailable
+     *
+     * @defaultValue false
+     */
+    readonly disabled?: boolean;
+    /**
+     * Button visual style variant
+     *
+     * @defaultValue ButtonVariant.secondary
+     */
+    readonly variant?: ButtonVariant;
+    /** Display label for the action */
+    readonly label: string;
+}
+/** External link action distinct from inline URL text values. */
+export interface ExternalLinkActionElement extends ActionElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "external-link"
+     */
+    readonly type: "external-link";
+    /** Target URL destination */
+    readonly url: string;
+    /** Display label for the action */
+    readonly label: string;
+}
+/** Full Markdown fallback block rendered with core typographic hierarchy, spacing, and styling. */
+export interface MarkdownBlockElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "markdown"
+     */
+    readonly type: "markdown";
+    /** Raw Markdown markup content */
+    readonly content: string;
+}
+/** Sandboxed HTML rendering escape hatch. */
+export interface HtmlBlockElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "html"
+     */
+    readonly type: "html";
+    /** Raw HTML markup content */
+    readonly content: string;
+}
+/** Single slot within a multi-slot horizontal row layout. */
+export interface Slot {
+    /** Optional slot label (e.g. "Slot A") */
+    readonly label?: string;
+    /** Relative or fractional width proportion (e.g. "1/3", "2/3", "100px", "auto") */
+    readonly width?: string;
+    /** Rendered content inside the slot */
+    readonly content: UiElement;
+}
+/**
+ * Multi-slot horizontal row with declared column width proportions.
+ * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
+ */
+export interface MultiSlotRowElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "multi-slot"
+     */
+    readonly type: "multi-slot";
+    /** Proportions descriptor (e.g. "1/3 + 2/3", "equal", "1/4 + 3/4") */
+    readonly proportions?: string;
+    /** List of slots comprising the row */
+    readonly slots: Slot[];
+}
+/**
+ * Standard label and value row.
+ * Displays a muted label on the left and value representation on the right with a vertical dividing line.
+ */
+export interface LabelValueRowElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "label-value"
+     */
+    readonly type: "label-value";
+    /** Key or descriptive label displayed muted on the left */
+    readonly label: string;
+    /** Rendered value element on the right */
+    readonly value: UiElement;
+    /**
+     * Whether to render a bottom border/hairline divider
+     *
+     * @defaultValue false
+     */
+    readonly withDivider?: boolean;
+}
+/** Column definition for structured tables. */
+export interface TableColumn {
+    /** Display header text */
+    readonly header?: string;
+    /**
+     * Text horizontal alignment
+     *
+     * @defaultValue TableColumnAlign.left
+     */
+    readonly align?: TableColumnAlign;
+    /** Optional width constraint */
+    readonly width?: string;
+}
+/** Single table row containing an array of cell values. */
+export interface TableRow {
+    /** Array of cell values corresponding to table columns */
+    readonly cells: (string | UiElement)[];
+}
+/**
+ * Structured tabular data representation.
+ * Supports header/borderless modes, 2-column key-value tables, and 3-column data tables.
+ */
+export interface TableElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "table"
+     */
+    readonly type: "table";
+    /**
+     * Whether to render a column header row
+     *
+     * @defaultValue true
+     */
+    readonly hasHeader?: boolean;
+    /** Optional explicit column definitions */
+    readonly columns?: TableColumn[];
+    /** Tabular data rows */
+    readonly rows: TableRow[];
+    /** Maximum recommended visible columns at 360px panel width */
+    readonly maxColumns?: number;
+}
+/** Single entry within a repeating group. */
+export interface RepeatingGroupEntry {
+    /** Entry label */
+    readonly label: string;
+    /** Primary entry value or nested elements */
+    readonly value?: string | UiElement;
+    /** Nested elements for structured entries */
+    readonly elements?: UiElement[];
+}
+/** Repeating group container where entries share uniform structure and retain per-entry labels. */
+export interface RepeatingGroupElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "repeating-group"
+     */
+    readonly type: "repeating-group";
+    /** Optional section header for the group */
+    readonly title?: string;
+    /** List of repeated entry records */
+    readonly entries: RepeatingGroupEntry[];
+}
+/** Collapsible disclosure container (accordion) with summary badge. */
+export interface CollapsibleGroupElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "collapsible-group"
+     */
+    readonly type: "collapsible-group";
+    /** Group title (e.g. "Show specimen details") */
+    readonly title: string;
+    /** Secondary summary indicator (e.g. "2 neutral values") */
+    readonly summary?: string;
+    /**
+     * Whether the disclosure is open/expanded by default
+     *
+     * @defaultValue false
+     */
+    readonly defaultExpanded?: boolean;
+    /** Nested content elements revealed when expanded */
+    readonly elements: UiElement[];
+}
+/** Visual hairline separator separating sections or element groups. */
+export interface DividerElement extends UiElementBase {
+    /**
+     * Discriminator type
+     *
+     * @defaultValue "divider"
+     */
+    readonly type: "divider";
+    /**
+     * Line styling
+     *
+     * @defaultValue DividerStyle.hairline
+     */
+    readonly style?: DividerStyle;
+}
+/**
+ * Root Feature Block container model.
+ * Represents a complete feature card rendered inside the 360px panel.
+ */
+export interface FeatureBlock {
+    /**
+     * Schema specification version
+     *
+     * @defaultValue "1.0"
+     */
+    readonly schemaVersion: "1.0";
+    /** Human-readable feature title displayed in the card header */
+    readonly title: string;
+    /** Optional neutral subtitle / description for the feature */
+    readonly description?: string;
+    /** Ordered list of visual elements, structures, and content */
+    readonly elements: UiElement[];
+    /** Optional card action buttons rendered at the base of the feature card */
+    readonly actions?: ActionElement[];
+}
+/**
+ * Polymorphic root base model for all visual UI elements in Picteus feature views.
+ * Uses the @discriminator("type") decorator so all child models inheriting from UiElement
+ * are automatically recognized by schema emitters and SDK code generators.
+ */
+export type UiElement = StringShortElement | StringLongElement | StringCodeElement | StringUrlElement | IdentifierElement | RatioElement | ColourElement | NumberUnboundedElement | NumberBoundedStarsElement | NumberBoundedMeterElement | BooleanPlainElement | BooleanBadgeElement | TimestampElement | ImageReferenceElement | DominantColourSetElement | MarkdownBlockElement | HtmlBlockElement | MultiSlotRowElement | LabelValueRowElement | TableElement | RepeatingGroupElement | CollapsibleGroupElement | DividerElement;
+/** Polymorphic base model for interactive actions. */
+export type ActionElement = ButtonActionElement | ExternalLinkActionElement;
+/**
+ * Class implementation of the `TruncateOptions` interface.
+ *
+ * @remarks
+ * Truncation configuration for long textual content with optional expand affordance.
+ */
+export declare class TruncateOptionsClass extends GrammarNode<TruncateOptions> implements TruncateOptions {
+    /** Maximum number of characters to display before truncating */
+    readonly characterLimit: number;
+    /**
+     * Whether to render a "Show more" / "Show less" toggle affordance
+     *
+     * @defaultValue true
+     */
+    readonly showMore?: boolean;
+    /**
+     * Initializes a new `TruncateOptionsClass` instance.
+     *
+     * @param characterLimit - Maximum number of characters to display before truncating
+     * @param options - Optional property overrides.
+     */
+    constructor(characterLimit: number, options?: {
+        showMore?: boolean;
+    });
+}
+/**
+ * Class implementation of the `PrimitiveModifiers` interface.
+ *
+ * @remarks
+ * Common modifier traits that can be attached to primitive elements.
+ */
+export declare class PrimitiveModifiersClass extends GrammarNode<PrimitiveModifiers> implements PrimitiveModifiers {
+    /** Adds an interactive copy button/action next to the rendered value */
+    readonly copyable?: boolean;
+    /** Configures character truncation threshold with show-more affordance */
+    readonly truncate?: TruncateOptions;
+    /**
+     * Text emphasis level
+     *
+     * @defaultValue Emphasis.normal
+     */
+    readonly emphasis?: Emphasis;
+    /**
+     * Whether to use monospace font rendering (for hashes, IDs, codes)
+     *
+     * @defaultValue false
+     */
+    readonly monospace?: boolean;
+    /**
+     * Initializes a new `PrimitiveModifiersClass` instance.
+     *
+     * @param options - Optional property overrides.
+     */
+    constructor(options?: {
+        copyable?: boolean;
+        truncate?: TruncateOptions;
+        emphasis?: Emphasis;
+        monospace?: boolean;
+    });
+}
+/**
+ * Class implementation of the `StringShortElement` interface.
+ *
+ * @remarks
+ * Short string primitive element.
+ * Supports plain text or compact chip pill presentation.
+ */
+export declare class StringShortElementClass extends BaseUiElement<StringShortElement> implements StringShortElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "string-short"
+     */
+    readonly type: "string-short";
+    /** Text value */
+    readonly value: string;
+    /**
+     * Display representation mode
+     *
+     * @defaultValue StringShortRepresentation.plain
+     */
+    readonly representation?: StringShortRepresentation;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+    /**
+     * Initializes a new `StringShortElementClass` instance.
+     *
+     * @param value - Text value
+     * @param options - Optional property overrides.
+     */
+    constructor(value: string, options?: {
+        representation?: StringShortRepresentation;
+        modifiers?: PrimitiveModifiers;
+    });
+}
+/**
+ * Class implementation of the `StringLongElement` interface.
+ *
+ * @remarks
+ * Multiline text block primitive element for descriptions, comments, or prose.
+ */
+export declare class StringLongElementClass extends BaseUiElement<StringLongElement> implements StringLongElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "string-long"
+     */
+    readonly type: "string-long";
+    /** Text value */
+    readonly value: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+    /**
+     * Initializes a new `StringLongElementClass` instance.
+     *
+     * @param value - Text value
+     * @param options - Optional property overrides.
+     */
+    constructor(value: string, options?: {
+        modifiers?: PrimitiveModifiers;
+    });
+}
+/**
+ * Class implementation of the `StringCodeElement` interface.
+ *
+ * @remarks
+ * Monospace code block or formatted code snippet representation.
+ */
+export declare class StringCodeElementClass extends BaseUiElement<StringCodeElement> implements StringCodeElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "string-code"
+     */
+    readonly type: "string-code";
+    /** Text value */
+    readonly value: string;
+    /** Optional syntax highlighting language identifier */
+    readonly language?: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+    /**
+     * Initializes a new `StringCodeElementClass` instance.
+     *
+     * @param value - Text value
+     * @param options - Optional property overrides.
+     */
+    constructor(value: string, options?: {
+        language?: string;
+        modifiers?: PrimitiveModifiers;
+    });
+}
+/**
+ * Class implementation of the `StringUrlElement` interface.
+ *
+ * @remarks
+ * Hyperlink representation for external or internal URL navigation.
+ */
+export declare class StringUrlElementClass extends BaseUiElement<StringUrlElement> implements StringUrlElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "string-url"
+     */
+    readonly type: "string-url";
+    /** Target URL or navigation destination */
+    readonly value: string;
+    /** Optional custom anchor text label */
+    readonly label?: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+    /**
+     * Initializes a new `StringUrlElementClass` instance.
+     *
+     * @param value - Target URL or navigation destination
+     * @param options - Optional property overrides.
+     */
+    constructor(value: string, options?: {
+        label?: string;
+        modifiers?: PrimitiveModifiers;
+    });
+}
+/**
+ * Class implementation of the `IdentifierElement` interface.
+ *
+ * @remarks
+ * Monospace semantic identifier representation.
+ */
+export declare class IdentifierElementClass extends BaseUiElement<IdentifierElement> implements IdentifierElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "identifier"
+     */
+    readonly type: "identifier";
+    /** Identifier string value */
+    readonly value: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+    /**
+     * Initializes a new `IdentifierElementClass` instance.
+     *
+     * @param value - Identifier string value
+     * @param options - Optional property overrides.
+     */
+    constructor(value: string, options?: {
+        modifiers?: PrimitiveModifiers;
+    });
+}
+/**
+ * Class implementation of the `RatioElement` interface.
+ *
+ * @remarks
+ * Aspect ratio representation (e.g. "16:9", "4:3", "1:1").
+ */
+export declare class RatioElementClass extends BaseUiElement<RatioElement> implements RatioElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "ratio"
+     */
+    readonly type: "ratio";
+    /** Aspect ratio textual expression */
+    readonly value: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+    /**
+     * Initializes a new `RatioElementClass` instance.
+     *
+     * @param value - Aspect ratio textual expression
+     * @param options - Optional property overrides.
+     */
+    constructor(value: string, options?: {
+        modifiers?: PrimitiveModifiers;
+    });
+}
+/**
+ * Class implementation of the `ColourElement` interface.
+ *
+ * @remarks
+ * Single color swatch representation with hex value and copy affordance.
+ */
+export declare class ColourElementClass extends BaseUiElement<ColourElement> implements ColourElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "color-swatch"
+     */
+    readonly type: "color-swatch";
+    /** Hexadecimal color code */
+    readonly value: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+    /**
+     * Initializes a new `ColourElementClass` instance.
+     *
+     * @param value - Hexadecimal color code
+     * @param options - Optional property overrides.
+     */
+    constructor(value: string, options?: {
+        modifiers?: PrimitiveModifiers;
+    });
+}
+/**
+ * Class implementation of the `NumberUnboundedElement` interface.
+ *
+ * @remarks
+ * Plain unbounded numeric value primitive element.
+ */
+export declare class NumberUnboundedElementClass extends BaseUiElement<NumberUnboundedElement> implements NumberUnboundedElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "number-unbounded"
+     */
+    readonly type: "number-unbounded";
+    /** Numeric value */
+    readonly value: number;
+    /** Optional unit suffix (e.g. "px", "ms", "MB") */
+    readonly unit?: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+    /**
+     * Initializes a new `NumberUnboundedElementClass` instance.
+     *
+     * @param value - Numeric value
+     * @param options - Optional property overrides.
+     */
+    constructor(value: number, options?: {
+        unit?: string;
+        modifiers?: PrimitiveModifiers;
+    });
+}
+/**
+ * Class implementation of the `NumberBoundedStarsElement` interface.
+ *
+ * @remarks
+ * Bounded numeric rating represented as visual stars.
+ */
+export declare class NumberBoundedStarsElementClass extends BaseUiElement<NumberBoundedStarsElement> implements NumberBoundedStarsElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "number-stars"
+     */
+    readonly type: "number-stars";
+    /** Numeric rating score */
+    readonly value: number;
+    /** Maximum rating scale (defaults to 5) */
+    readonly maximum?: number;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+    /**
+     * Initializes a new `NumberBoundedStarsElementClass` instance.
+     *
+     * @param value - Numeric rating score
+     * @param options - Optional property overrides.
+     */
+    constructor(value: number, options?: {
+        maximum?: number;
+        modifiers?: PrimitiveModifiers;
+    });
+}
+/**
+ * Class implementation of the `NumberBoundedMeterElement` interface.
+ *
+ * @remarks
+ * Bounded numeric meter representation (read-only progress / score bar).
+ */
+export declare class NumberBoundedMeterElementClass extends BaseUiElement<NumberBoundedMeterElement> implements NumberBoundedMeterElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "number-meter"
+     */
+    readonly type: "number-meter";
+    /** Numeric value */
+    readonly value: number;
+    /** Minimum scale bound (defaults to 0) */
+    readonly minimum?: number;
+    /** Maximum scale bound (e.g. 100) */
+    readonly maximum?: number;
+    /** Optional custom text label override (e.g. "68 / 100") */
+    readonly label?: string;
+    /** Optional unit suffix (e.g. "%") */
+    readonly unit?: string;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+    /**
+     * Initializes a new `NumberBoundedMeterElementClass` instance.
+     *
+     * @param value - Numeric value
+     * @param options - Optional property overrides.
+     */
+    constructor(value: number, options?: {
+        minimum?: number;
+        maximum?: number;
+        label?: string;
+        unit?: string;
+        modifiers?: PrimitiveModifiers;
+    });
+}
+/**
+ * Class implementation of the `BooleanPlainElement` interface.
+ *
+ * @remarks
+ * Plain boolean value representation (textual "true" / "false").
+ */
+export declare class BooleanPlainElementClass extends BaseUiElement<BooleanPlainElement> implements BooleanPlainElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "boolean-plain"
+     */
+    readonly type: "boolean-plain";
+    /** Boolean state value */
+    readonly value: boolean;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+    /**
+     * Initializes a new `BooleanPlainElementClass` instance.
+     *
+     * @param value - Boolean state value
+     * @param options - Optional property overrides.
+     */
+    constructor(value: boolean, options?: {
+        modifiers?: PrimitiveModifiers;
+    });
+}
+/**
+ * Class implementation of the `BooleanBadgeElement` interface.
+ *
+ * @remarks
+ * Visual badge pill representation of a boolean state.
+ */
+export declare class BooleanBadgeElementClass extends BaseUiElement<BooleanBadgeElement> implements BooleanBadgeElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "boolean-badge"
+     */
+    readonly type: "boolean-badge";
+    /** Boolean state value */
+    readonly value: boolean;
+    /**
+     * Custom display label when true (defaults to "true")
+     *
+     * @defaultValue "true"
+     */
+    readonly trueLabel?: string;
+    /**
+     * Custom display label when false (defaults to "false")
+     *
+     * @defaultValue "false"
+     */
+    readonly falseLabel?: string;
+    /**
+     * Badge color tone
+     *
+     * @defaultValue BadgeVariant.neutral
+     */
+    readonly variant?: BadgeVariant;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+    /**
+     * Initializes a new `BooleanBadgeElementClass` instance.
+     *
+     * @param value - Boolean state value
+     * @param options - Optional property overrides.
+     */
+    constructor(value: boolean, options?: {
+        trueLabel?: string;
+        falseLabel?: string;
+        variant?: BadgeVariant;
+        modifiers?: PrimitiveModifiers;
+    });
+}
+/**
+ * Class implementation of the `TimestampElement` interface.
+ *
+ * @remarks
+ * Formatted date and time representation.
+ */
+export declare class TimestampElementClass extends BaseUiElement<TimestampElement> implements TimestampElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "timestamp"
+     */
+    readonly type: "timestamp";
+    /** ISO 8601 date string or epoch timestamp in milliseconds */
+    readonly value: string;
+    /**
+     * Presentation date/time format
+     *
+     * @defaultValue TimestampFormat.full
+     */
+    readonly format?: TimestampFormat;
+    /** Optional visual modifiers (copyable, truncate, emphasis, monospace) */
+    readonly modifiers?: PrimitiveModifiers;
+    /**
+     * Initializes a new `TimestampElementClass` instance.
+     *
+     * @param value - ISO 8601 date string or epoch timestamp in milliseconds
+     * @param options - Optional property overrides.
+     */
+    constructor(value: string, options?: {
+        format?: TimestampFormat;
+        modifiers?: PrimitiveModifiers;
+    });
+}
+/**
+ * Class implementation of the `ImageReferenceElement` interface.
+ *
+ * @remarks
+ * Thumbnail image reference with placeholder fallback handling.
+ */
+export declare class ImageReferenceElementClass extends BaseUiElement<ImageReferenceElement> implements ImageReferenceElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "image-ref"
+     */
+    readonly type: "image-ref";
+    /** Image source URI (HTTPS URL, base64 data URI, or asset path) */
+    readonly src: string;
+    /** Accessible alternative description */
+    readonly alt?: string;
+    /**
+     * Aspect ratio of the thumbnail container
+     *
+     * @defaultValue "1:1"
+     */
+    readonly aspectRatio?: string;
+    /** Fallback placeholder image URI */
+    readonly placeholder?: string;
+    /**
+     * 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: string, options?: {
+        alt?: string;
+        aspectRatio?: string;
+        placeholder?: string;
+    });
+}
+/**
+ * Class implementation of the `DominantColourSetElement` interface.
+ *
+ * @remarks
+ * Dominant color set palette rendered in descending dominance order.
+ */
+export declare class DominantColourSetElementClass extends BaseUiElement<DominantColourSetElement> implements DominantColourSetElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "color-set"
+     */
+    readonly type: "color-set";
+    /** List of hexadecimal color strings in descending priority */
+    readonly colors: string[];
+    /**
+     * Initializes a new `DominantColourSetElementClass` instance.
+     *
+     * @param colors - List of hexadecimal color strings in descending priority
+     */
+    constructor(colors: string[]);
+}
+/**
+ * Class implementation of the `ButtonActionElement` interface.
+ *
+ * @remarks
+ * Interactive button action triggering an extension command.
+ */
+export declare class ButtonActionElementClass extends BaseActionElement<ButtonActionElement> implements ButtonActionElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "button"
+     */
+    readonly type: "button";
+    /** Command identifier to invoke */
+    readonly commandId: string;
+    /** Display label for the action */
+    readonly label: string;
+    /** Extension identifier owning the target command */
+    readonly extensionId?: string;
+    /** Target entity or context identifier */
+    readonly target?: string;
+    /** Optional arbitrary parameters payload forwarded to the command handler */
+    readonly parameters?: Record<string, unknown>;
+    /**
+     * Whether the button is disabled / unavailable
+     *
+     * @defaultValue false
+     */
+    readonly disabled?: boolean;
+    /**
+     * Button visual style variant
+     *
+     * @defaultValue ButtonVariant.secondary
+     */
+    readonly variant?: ButtonVariant;
+    /**
+     * 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: string, label: string, options?: {
+        extensionId?: string;
+        target?: string;
+        parameters?: Record<string, unknown>;
+        disabled?: boolean;
+        variant?: ButtonVariant;
+    });
+}
+/**
+ * Class implementation of the `ExternalLinkActionElement` interface.
+ *
+ * @remarks
+ * External link action distinct from inline URL text values.
+ */
+export declare class ExternalLinkActionElementClass extends BaseActionElement<ExternalLinkActionElement> implements ExternalLinkActionElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "external-link"
+     */
+    readonly type: "external-link";
+    /** Target URL destination */
+    readonly url: string;
+    /** Display label for the action */
+    readonly label: string;
+    /**
+     * Initializes a new `ExternalLinkActionElementClass` instance.
+     *
+     * @param url - Target URL destination
+     * @param label - Display label for the action
+     */
+    constructor(url: string, label: string);
+}
+/**
+ * Class implementation of the `MarkdownBlockElement` interface.
+ *
+ * @remarks
+ * Full Markdown fallback block rendered with core typographic hierarchy, spacing, and styling.
+ */
+export declare class MarkdownBlockElementClass extends BaseUiElement<MarkdownBlockElement> implements MarkdownBlockElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "markdown"
+     */
+    readonly type: "markdown";
+    /** Raw Markdown markup content */
+    readonly content: string;
+    /**
+     * Initializes a new `MarkdownBlockElementClass` instance.
+     *
+     * @param content - Raw Markdown markup content
+     */
+    constructor(content: string);
+}
+/**
+ * Class implementation of the `HtmlBlockElement` interface.
+ *
+ * @remarks
+ * Sandboxed HTML rendering escape hatch.
+ */
+export declare class HtmlBlockElementClass extends BaseUiElement<HtmlBlockElement> implements HtmlBlockElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "html"
+     */
+    readonly type: "html";
+    /** Raw HTML markup content */
+    readonly content: string;
+    /**
+     * Initializes a new `HtmlBlockElementClass` instance.
+     *
+     * @param content - Raw HTML markup content
+     */
+    constructor(content: string);
+}
+/**
+ * Class implementation of the `Slot` interface.
+ *
+ * @remarks
+ * Single slot within a multi-slot horizontal row layout.
+ */
+export declare class SlotClass extends GrammarNode<Slot> implements Slot {
+    /** Rendered content inside the slot */
+    readonly content: UiElement;
+    /** Optional slot label (e.g. "Slot A") */
+    readonly label?: string;
+    /** Relative or fractional width proportion (e.g. "1/3", "2/3", "100px", "auto") */
+    readonly width?: string;
+    /**
+     * Initializes a new `SlotClass` instance.
+     *
+     * @param content - Rendered content inside the slot
+     * @param options - Optional property overrides.
+     */
+    constructor(content: UiElement, options?: {
+        label?: string;
+        width?: string;
+    });
+}
+/**
+ * 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 declare class MultiSlotRowElementClass extends BaseUiElement<MultiSlotRowElement> implements MultiSlotRowElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "multi-slot"
+     */
+    readonly type: "multi-slot";
+    /** List of slots comprising the row */
+    readonly slots: Slot[];
+    /** Proportions descriptor (e.g. "1/3 + 2/3", "equal", "1/4 + 3/4") */
+    readonly proportions?: string;
+    /**
+     * Initializes a new `MultiSlotRowElementClass` instance.
+     *
+     * @param slots - List of slots comprising the row
+     * @param options - Optional property overrides.
+     */
+    constructor(slots: Slot[], options?: {
+        proportions?: string;
+    });
+}
+/**
+ * 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 declare class LabelValueRowElementClass extends BaseUiElement<LabelValueRowElement> implements LabelValueRowElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "label-value"
+     */
+    readonly type: "label-value";
+    /** Key or descriptive label displayed muted on the left */
+    readonly label: string;
+    /** Rendered value element on the right */
+    readonly value: UiElement;
+    /**
+     * Whether to render a bottom border/hairline divider
+     *
+     * @defaultValue false
+     */
+    readonly withDivider?: boolean;
+    /**
+     * 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: string, value: UiElement, options?: {
+        withDivider?: boolean;
+    });
+}
+/**
+ * Class implementation of the `TableColumn` interface.
+ *
+ * @remarks
+ * Column definition for structured tables.
+ */
+export declare class TableColumnClass extends GrammarNode<TableColumn> implements TableColumn {
+    /** Display header text */
+    readonly header?: string;
+    /**
+     * Text horizontal alignment
+     *
+     * @defaultValue TableColumnAlign.left
+     */
+    readonly align?: TableColumnAlign;
+    /** Optional width constraint */
+    readonly width?: string;
+    /**
+     * Initializes a new `TableColumnClass` instance.
+     *
+     * @param options - Optional property overrides.
+     */
+    constructor(options?: {
+        header?: string;
+        align?: TableColumnAlign;
+        width?: string;
+    });
+}
+/**
+ * Class implementation of the `TableRow` interface.
+ *
+ * @remarks
+ * Single table row containing an array of cell values.
+ */
+export declare class TableRowClass extends GrammarNode<TableRow> implements TableRow {
+    /** Array of cell values corresponding to table columns */
+    readonly cells: (string | UiElement)[];
+    /**
+     * Initializes a new `TableRowClass` instance.
+     *
+     * @param cells - Array of cell values corresponding to table columns
+     */
+    constructor(cells: (string | UiElement)[]);
+}
+/**
+ * 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 declare class TableElementClass extends BaseUiElement<TableElement> implements TableElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "table"
+     */
+    readonly type: "table";
+    /** Tabular data rows */
+    readonly rows: TableRow[];
+    /**
+     * Whether to render a column header row
+     *
+     * @defaultValue true
+     */
+    readonly hasHeader?: boolean;
+    /** Optional explicit column definitions */
+    readonly columns?: TableColumn[];
+    /** Maximum recommended visible columns at 360px panel width */
+    readonly maxColumns?: number;
+    /**
+     * Initializes a new `TableElementClass` instance.
+     *
+     * @param rows - Tabular data rows
+     * @param options - Optional property overrides.
+     */
+    constructor(rows: TableRow[], options?: {
+        hasHeader?: boolean;
+        columns?: TableColumn[];
+        maxColumns?: number;
+    });
+}
+/**
+ * Class implementation of the `RepeatingGroupEntry` interface.
+ *
+ * @remarks
+ * Single entry within a repeating group.
+ */
+export declare class RepeatingGroupEntryClass extends GrammarNode<RepeatingGroupEntry> implements RepeatingGroupEntry {
+    /** Entry label */
+    readonly label: string;
+    /** Primary entry value or nested elements */
+    readonly value?: string | UiElement;
+    /** Nested elements for structured entries */
+    readonly elements?: UiElement[];
+    /**
+     * Initializes a new `RepeatingGroupEntryClass` instance.
+     *
+     * @param label - Entry label
+     * @param options - Optional property overrides.
+     */
+    constructor(label: string, options?: {
+        value?: string | UiElement;
+        elements?: UiElement[];
+    });
+}
+/**
+ * Class implementation of the `RepeatingGroupElement` interface.
+ *
+ * @remarks
+ * Repeating group container where entries share uniform structure and retain per-entry labels.
+ */
+export declare class RepeatingGroupElementClass extends BaseUiElement<RepeatingGroupElement> implements RepeatingGroupElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "repeating-group"
+     */
+    readonly type: "repeating-group";
+    /** List of repeated entry records */
+    readonly entries: RepeatingGroupEntry[];
+    /** Optional section header for the group */
+    readonly title?: string;
+    /**
+     * Initializes a new `RepeatingGroupElementClass` instance.
+     *
+     * @param entries - List of repeated entry records
+     * @param options - Optional property overrides.
+     */
+    constructor(entries: RepeatingGroupEntry[], options?: {
+        title?: string;
+    });
+}
+/**
+ * Class implementation of the `CollapsibleGroupElement` interface.
+ *
+ * @remarks
+ * Collapsible disclosure container (accordion) with summary badge.
+ */
+export declare class CollapsibleGroupElementClass extends BaseUiElement<CollapsibleGroupElement> implements CollapsibleGroupElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "collapsible-group"
+     */
+    readonly type: "collapsible-group";
+    /** Group title (e.g. "Show specimen details") */
+    readonly title: string;
+    /** Nested content elements revealed when expanded */
+    readonly elements: UiElement[];
+    /** Secondary summary indicator (e.g. "2 neutral values") */
+    readonly summary?: string;
+    /**
+     * Whether the disclosure is open/expanded by default
+     *
+     * @defaultValue false
+     */
+    readonly defaultExpanded?: boolean;
+    /**
+     * 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: string, elements: UiElement[], options?: {
+        summary?: string;
+        defaultExpanded?: boolean;
+    });
+}
+/**
+ * Class implementation of the `DividerElement` interface.
+ *
+ * @remarks
+ * Visual hairline separator separating sections or element groups.
+ */
+export declare class DividerElementClass extends BaseUiElement<DividerElement> implements DividerElement {
+    /**
+     * The discriminator type tag.
+     *
+     * @defaultValue "divider"
+     */
+    readonly type: "divider";
+    /**
+     * Line styling
+     *
+     * @defaultValue DividerStyle.hairline
+     */
+    readonly style?: DividerStyle;
+    /**
+     * Initializes a new `DividerElementClass` instance.
+     *
+     * @param options - Optional property overrides.
+     */
+    constructor(options?: {
+        style?: DividerStyle;
+    });
+}
+/**
+ * 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 declare class FeatureBlockBuilder {
+    private readonly _title;
+    private _description?;
+    private readonly _elements;
+    private readonly _actions;
+    /**
+     * Initializes a new `FeatureBlockBuilder` with mandatory card properties.
+     *
+     * @param title - Human-readable feature title displayed in the card header
+     */
+    constructor(title: string);
+    /**
+     * 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: string): 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: UiElement): this;
+    /**
+     * Appends multiple elements items to the card.
+     *
+     * @param items - The `UiElement` items to add.
+     * @returns This builder instance for method chaining.
+     */
+    addElements(...items: UiElement[]): this;
+    /**
+     * Appends multiple actions items to the card.
+     *
+     * @param items - The `ActionElement` items to add.
+     * @returns This builder instance for method chaining.
+     */
+    addActions(...items: ActionElement[]): this;
+    /**
+     * Appends a single action to the card.
+     *
+     * @param item - The `ActionElement` item to add.
+     * @returns This builder instance for method chaining.
+     */
+    addAction(item: ActionElement): 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: string, options?: {
+        representation?: StringShortRepresentation;
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: string, options?: {
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: string, options?: {
+        language?: string;
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: string, options?: {
+        label?: string;
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: string, options?: {
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: string, options?: {
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: string, options?: {
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: string, options?: {
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: number, options?: {
+        unit?: string;
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: number, options?: {
+        maximum?: number;
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: number, options?: {
+        maximum?: number;
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: number, options?: {
+        minimum?: number;
+        maximum?: number;
+        label?: string;
+        unit?: string;
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: number, options?: {
+        minimum?: number;
+        maximum?: number;
+        label?: string;
+        unit?: string;
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: boolean, options?: {
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: boolean, options?: {
+        trueLabel?: string;
+        falseLabel?: string;
+        variant?: BadgeVariant;
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: string, options?: {
+        format?: TimestampFormat;
+        modifiers?: PrimitiveModifiers;
+    }): this;
+    /**
+     * 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: string, options?: {
+        alt?: string;
+        aspectRatio?: string;
+        placeholder?: string;
+    }): this;
+    /**
+     * 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: string, options?: {
+        alt?: string;
+        aspectRatio?: string;
+        placeholder?: string;
+    }): this;
+    /**
+     * 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: string[]): this;
+    /**
+     * 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: string[]): this;
+    /**
+     * 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: string): this;
+    /**
+     * 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: string): this;
+    /**
+     * 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: string): this;
+    /**
+     * 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: string): this;
+    /**
+     * 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: Slot[], options?: {
+        proportions?: string;
+    }): this;
+    /**
+     * 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: Slot[], options?: {
+        proportions?: string;
+    }): this;
+    /**
+     * 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: string, value: UiElement, options?: {
+        withDivider?: boolean;
+    }): this;
+    /**
+     * 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: string, value: UiElement, options?: {
+        withDivider?: boolean;
+    }): this;
+    /**
+     * 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: TableRow[], options?: {
+        hasHeader?: boolean;
+        columns?: TableColumn[];
+        maxColumns?: number;
+    }): this;
+    /**
+     * 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: RepeatingGroupEntry[], options?: {
+        title?: string;
+    }): this;
+    /**
+     * 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: string, elements: UiElement[], options?: {
+        summary?: string;
+        defaultExpanded?: boolean;
+    }): this;
+    /**
+     * 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?: {
+        style?: DividerStyle;
+    }): this;
+    /**
+     * Finalizes and returns the complete strongly-typed `FeatureBlock` card object.
+     *
+     * @returns The constructed `FeatureBlock` object.
+     */
+    build(): FeatureBlock;
+}
+/** Static helper factory object for `FeatureBlock`. */
+export declare 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: string): FeatureBlockBuilder;
+    /**
+     * Creates a `FeatureBlock` directly from a properties object.
+     *
+     * @param params - Card configuration properties.
+     * @returns A completed `FeatureBlock` object.
+     */
+    create(params: {
+        title: string;
+        description?: string;
+        elements: UiElement[];
+        actions?: ActionElement[];
+    }): FeatureBlock;
+};
+/**
+ * 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 declare function createFeatureBlock(title: string, options?: {
+    description?: string;
+    elements?: UiElement[];
+    actions?: ActionElement[];
+}): FeatureBlock;
+/**
+ * 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 declare function truncateOptions(characterLimit: number, options?: {
+    showMore?: boolean;
+}): TruncateOptions;
+/**
+ * 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 declare function primitiveModifiers(options?: {
+    copyable?: boolean;
+    truncate?: TruncateOptions;
+    emphasis?: Emphasis;
+    monospace?: boolean;
+}): PrimitiveModifiers;
+/**
+ * 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 declare function stringShort(value: string, options?: {
+    representation?: StringShortRepresentation;
+    modifiers?: PrimitiveModifiers;
+}): StringShortElement;
+/**
+ * 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 declare function stringLong(value: string, options?: {
+    modifiers?: PrimitiveModifiers;
+}): StringLongElement;
+/**
+ * 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 declare function stringCode(value: string, options?: {
+    language?: string;
+    modifiers?: PrimitiveModifiers;
+}): StringCodeElement;
+/**
+ * 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 declare function stringUrl(value: string, options?: {
+    label?: string;
+    modifiers?: PrimitiveModifiers;
+}): StringUrlElement;
+/**
+ * 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 declare function identifier(value: string, options?: {
+    modifiers?: PrimitiveModifiers;
+}): IdentifierElement;
+/**
+ * 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 declare function ratio(value: string, options?: {
+    modifiers?: PrimitiveModifiers;
+}): RatioElement;
+/**
+ * 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 declare function colour(value: string, options?: {
+    modifiers?: PrimitiveModifiers;
+}): ColourElement;
+/**
+ * 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 declare function colorSwatch(value: string, options?: {
+    modifiers?: PrimitiveModifiers;
+}): ColourElement;
+/**
+ * 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 declare function numberUnbounded(value: number, options?: {
+    unit?: string;
+    modifiers?: PrimitiveModifiers;
+}): NumberUnboundedElement;
+/**
+ * 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 declare function numberBoundedStars(value: number, options?: {
+    maximum?: number;
+    modifiers?: PrimitiveModifiers;
+}): NumberBoundedStarsElement;
+/**
+ * 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 declare function numberStars(value: number, options?: {
+    maximum?: number;
+    modifiers?: PrimitiveModifiers;
+}): NumberBoundedStarsElement;
+/**
+ * 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 declare function numberBoundedMeter(value: number, options?: {
+    minimum?: number;
+    maximum?: number;
+    label?: string;
+    unit?: string;
+    modifiers?: PrimitiveModifiers;
+}): NumberBoundedMeterElement;
+/**
+ * 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 declare function numberMeter(value: number, options?: {
+    minimum?: number;
+    maximum?: number;
+    label?: string;
+    unit?: string;
+    modifiers?: PrimitiveModifiers;
+}): NumberBoundedMeterElement;
+/**
+ * Creates a `BooleanPlainElement` component instance.
+ *
+ * @remarks
+ * Plain boolean value representation (textual "true" / "false").
+ *
+ * @param value - Boolean state value
+ * @param options - Optional settings (modifiers).
+ * @returns A strongly-typed `BooleanPlainElement` object.
+ */
+export declare function booleanPlain(value: boolean, options?: {
+    modifiers?: PrimitiveModifiers;
+}): BooleanPlainElement;
+/**
+ * Creates a `BooleanBadgeElement` component instance.
+ *
+ * @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 declare function booleanBadge(value: boolean, options?: {
+    trueLabel?: string;
+    falseLabel?: string;
+    variant?: BadgeVariant;
+    modifiers?: PrimitiveModifiers;
+}): BooleanBadgeElement;
+/**
+ * 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 declare function timestamp(value: string, options?: {
+    format?: TimestampFormat;
+    modifiers?: PrimitiveModifiers;
+}): TimestampElement;
+/**
+ * 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 declare function imageReference(src: string, options?: {
+    alt?: string;
+    aspectRatio?: string;
+    placeholder?: string;
+}): ImageReferenceElement;
+/**
+ * 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 declare function imageRef(src: string, options?: {
+    alt?: string;
+    aspectRatio?: string;
+    placeholder?: string;
+}): ImageReferenceElement;
+/**
+ * Creates a `DominantColourSetElement` component instance.
+ *
+ * @remarks
+ * Dominant color set palette rendered in descending dominance order.
+ *
+ * @param colors - List of hexadecimal color strings in descending priority
+ * @returns A strongly-typed `DominantColourSetElement` object.
+ */
+export declare function dominantColourSet(colors: string[]): DominantColourSetElement;
+/**
+ * Creates a `DominantColourSetElement` component instance.
+ *
+ * @remarks
+ * Dominant color set palette rendered in descending dominance order.
+ *
+ * @param colors - List of hexadecimal color strings in descending priority
+ * @returns A strongly-typed `DominantColourSetElement` object.
+ */
+export declare function dominantColors(colors: string[]): DominantColourSetElement;
+/**
+ * Creates a `ButtonActionElement` component instance.
+ *
+ * @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 declare function buttonAction(commandId: string, label: string, options?: {
+    extensionId?: string;
+    target?: string;
+    parameters?: Record<string, unknown>;
+    disabled?: boolean;
+    variant?: ButtonVariant;
+}): ButtonActionElement;
+/**
+ * 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 declare function externalLinkAction(url: string, label: string): ExternalLinkActionElement;
+/**
+ * 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 declare function markdownBlock(content: string): MarkdownBlockElement;
+/**
+ * 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 declare function markdown(content: string): MarkdownBlockElement;
+/**
+ * Creates a `HtmlBlockElement` component instance.
+ *
+ * @remarks
+ * Sandboxed HTML rendering escape hatch.
+ *
+ * @param content - Raw HTML markup content
+ * @returns A strongly-typed `HtmlBlockElement` object.
+ */
+export declare function htmlBlock(content: string): HtmlBlockElement;
+/**
+ * Creates a `HtmlBlockElement` component instance.
+ *
+ * @remarks
+ * Sandboxed HTML rendering escape hatch.
+ *
+ * @param content - Raw HTML markup content
+ * @returns A strongly-typed `HtmlBlockElement` object.
+ */
+export declare function html(content: string): HtmlBlockElement;
+/**
+ * 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 declare function slot(content: UiElement, options?: {
+    label?: string;
+    width?: string;
+}): Slot;
+/**
+ * Creates a `MultiSlotRowElement` component instance.
+ *
+ * @remarks
+ * Multi-slot horizontal row with declared column width proportions.
+ * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
+ *
+ * @param slots - List of slots comprising the row
+ * @param options - Optional settings (proportions).
+ * @returns A strongly-typed `MultiSlotRowElement` object.
+ */
+export declare function multiSlotRow(slots: Slot[], options?: {
+    proportions?: string;
+}): MultiSlotRowElement;
+/**
+ * Creates a `MultiSlotRowElement` component instance.
+ *
+ * @remarks
+ * Multi-slot horizontal row with declared column width proportions.
+ * Examples: "1/3 + 2/3", "equal thirds", "1/4 + 3/4".
+ *
+ * @param slots - List of slots comprising the row
+ * @param options - Optional settings (proportions).
+ * @returns A strongly-typed `MultiSlotRowElement` object.
+ */
+export declare function multiSlot(slots: Slot[], options?: {
+    proportions?: string;
+}): MultiSlotRowElement;
+/**
+ * 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 declare function labelValueRow(label: string, value: UiElement, options?: {
+    withDivider?: boolean;
+}): LabelValueRowElement;
+/**
+ * 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 declare function labelValue(label: string, value: UiElement, options?: {
+    withDivider?: boolean;
+}): LabelValueRowElement;
+/**
+ * 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 declare function tableColumn(options?: {
+    header?: string;
+    align?: TableColumnAlign;
+    width?: string;
+}): TableColumn;
+/**
+ * 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 declare function tableRow(cells: (string | UiElement)[]): TableRow;
+/**
+ * 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 declare function table(rows: TableRow[], options?: {
+    hasHeader?: boolean;
+    columns?: TableColumn[];
+    maxColumns?: number;
+}): TableElement;
+/**
+ * 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 declare function repeatingGroupEntry(label: string, options?: {
+    value?: string | UiElement;
+    elements?: UiElement[];
+}): RepeatingGroupEntry;
+/**
+ * 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 declare function repeatingGroup(entries: RepeatingGroupEntry[], options?: {
+    title?: string;
+}): RepeatingGroupElement;
+/**
+ * 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 declare function collapsibleGroup(title: string, elements: UiElement[], options?: {
+    summary?: string;
+    defaultExpanded?: boolean;
+}): CollapsibleGroupElement;
+/**
+ * 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 declare function divider(options?: {
+    style?: DividerStyle;
+}): DividerElement;
+/**
+ * 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 declare function isUiElement(value: unknown): value is UiElement;
+/**
+ * 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 declare function isStringShortElement(element: UiElement): element is StringShortElement;
+/**
+ * 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 declare function isStringLongElement(element: UiElement): element is StringLongElement;
+/**
+ * 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 declare function isStringCodeElement(element: UiElement): element is StringCodeElement;
+/**
+ * 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 declare function isStringUrlElement(element: UiElement): element is StringUrlElement;
+/**
+ * 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 declare function isIdentifierElement(element: UiElement): element is IdentifierElement;
+/**
+ * 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 declare function isRatioElement(element: UiElement): element is RatioElement;
+/**
+ * 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 declare function isColourElement(element: UiElement): element is ColourElement;
+/**
+ * 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 declare function isNumberUnboundedElement(element: UiElement): element is NumberUnboundedElement;
+/**
+ * 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 declare function isNumberBoundedStarsElement(element: UiElement): element is NumberBoundedStarsElement;
+/**
+ * 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 declare function isNumberBoundedMeterElement(element: UiElement): element is NumberBoundedMeterElement;
+/**
+ * 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 declare function isBooleanPlainElement(element: UiElement): element is BooleanPlainElement;
+/**
+ * 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 declare function isBooleanBadgeElement(element: UiElement): element is BooleanBadgeElement;
+/**
+ * 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 declare function isTimestampElement(element: UiElement): element is TimestampElement;
+/**
+ * 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 declare function isImageReferenceElement(element: UiElement): element is ImageReferenceElement;
+/**
+ * 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 declare function isDominantColourSetElement(element: UiElement): element is DominantColourSetElement;
+/**
+ * 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 declare function isMarkdownBlockElement(element: UiElement): element is MarkdownBlockElement;
+/**
+ * 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 declare function isHtmlBlockElement(element: UiElement): element is HtmlBlockElement;
+/**
+ * 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 declare function isMultiSlotRowElement(element: UiElement): element is MultiSlotRowElement;
+/**
+ * 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 declare function isLabelValueRowElement(element: UiElement): element is LabelValueRowElement;
+/**
+ * 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 declare function isTableElement(element: UiElement): element is TableElement;
+/**
+ * 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 declare function isRepeatingGroupElement(element: UiElement): element is RepeatingGroupElement;
+/**
+ * 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 declare function isCollapsibleGroupElement(element: UiElement): element is CollapsibleGroupElement;
+/**
+ * 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 declare function isDividerElement(element: UiElement): element is DividerElement;
+/**
+ * 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 declare function isActionElement(value: unknown): value is ActionElement;
+/**
+ * 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 declare function isButtonActionElement(element: ActionElement): element is ButtonActionElement;
+/**
+ * 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 declare function isExternalLinkActionElement(element: ActionElement): element is ExternalLinkActionElement;