@antglobal/copilot-cards-web 1.0.5 → 1.0.7

package/dist/index.d.ts

@@ -29,6 +29,33 @@ interface WebActionContextOptions {
  */
 declare function createWebActionContext(options?: WebActionContextOptions): ActionRunnerContext;
 
+interface CardNodeHandle {
+    /** Stable schema/runtime node id represented by this logical handle. */
+    readonly id: string;
+    /** Current rendered node type, or null while the node is unavailable. */
+    readonly type: string | null;
+    /**
+     * Current custom-element host. This is a transient snapshot and may change
+     * after any render; consumers should keep the handle instead of this value.
+     */
+    readonly current: HTMLElement | null;
+    /** Measure the current custom-element host. */
+    getRect(): DOMRectReadOnly | null;
+    /** Focus the component's logical control. */
+    focus(options?: FocusOptions): boolean;
+    /** Blur the component's logical control. */
+    blur(): boolean;
+    /** Scroll the current custom-element host into view. */
+    scrollIntoView(options?: ScrollIntoViewOptions): boolean;
+}
+interface CardFocusChangeEvent {
+    /** Currently focused logical card node, or null after focus leaves the card. */
+    node: CardNodeHandle | null;
+    /** Previously focused logical card node, if any. */
+    previousNode: CardNodeHandle | null;
+}
+type CardFocusChangeListener = (event: CardFocusChangeEvent) => void;
+
 interface ResponsiveMobileOptions {
     readonly unit: 'rem';
     readonly rootValue: number;
@@ -77,6 +104,10 @@ interface CardInstance {
     dispose: () => void;
     /** Update variables and re-render. */
     updateVariables: (variables: Record<string, any>) => void;
+    /** Get a stable logical handle that resolves the current host lazily. */
+    getNode: (id: string) => CardNodeHandle;
+    /** Observe logical focus changes within this card. */
+    onFocusChange: (listener: CardFocusChangeListener) => () => void;
 }
 /**
  * Render a card schema into a container element.
@@ -470,6 +501,18 @@ declare abstract class BaseElement extends HTMLElement {
     protected toCSS(value: string | number): string;
     /** Assign component markup and convert only its CSS declarations. */
     protected setShadowHTML(html: string): void;
+    /**
+     * Patch freshly rendered markup around an existing interactive element.
+     *
+     * Replacing a focused native control through `shadowRoot.innerHTML` resets
+     * its selection and, on mobile WebViews, can also recreate the soft
+     * keyboard with a different layout. This helper keeps the selected element
+     * connected while reconciling its surrounding markup.
+     */
+    protected patchShadowHTMLPreservingElement(html: string, preserved: Element, selector: string): boolean;
+    private reconcilePreservedTree;
+    private patchPreservedElement;
+    private reconcileKey;
     /**
      * Escape a value before interpolating it into a double-quoted HTML
      * attribute. Browsers decode the entities before parsing inline CSS, so
@@ -620,9 +663,14 @@ declare class CardButton extends BaseElement {
 
 declare class CardInput extends BaseElement {
     static readonly is = "ai-card-input";
+    private readonly wiredInputs;
+    private readonly wiredNumberInputs;
     protected render(): void;
-    private getAutoFocusControl;
-    private isFirstAvailableAutoFocusInput;
+    /**
+     * Consume an interaction-driven focus request from the card renderer.
+     * Mounts and ordinary updates never call this method.
+     */
+    requestAutoFocus(): boolean;
     /** Escape HTML entities for safe insertion. */
     private escapeHtml;
     /** Escape attribute values for safe insertion. */
@@ -660,6 +708,8 @@ declare class CardImage extends BaseElement {
     static readonly is = "ai-card-image";
     private _lightbox;
     protected render(): void;
+    private applyHostDimension;
+    private resolveDeclaredDimension;
     private bindEvents;
     private openLightbox;
     private closeLightbox;
@@ -1020,10 +1070,12 @@ type InputAffix = string | InputAffixConfig;
 interface InputProps {
     /** Placeholder text */
     placeholder?: string;
-    /** Focus the native input after the component is mounted (default false) */
+    /** Focus an empty input when a card interaction reveals it (default false) */
     autoFocus?: boolean;
     /** HTML input type: text / textarea / password / number etc. */
     inputType?: 'text' | 'textarea' | 'password' | (string & {});
+    /** Mobile soft-keyboard hint; does not change validation or step controls. */
+    inputMode?: 'none' | 'text' | 'tel' | 'url' | 'email' | 'numeric' | 'decimal' | 'search';
     /** Label text displayed above the input */
     label?: string;
     /** Initial value */
@@ -1061,9 +1113,9 @@ interface ImageProps {
     /** Alt text for accessibility */
     alt?: string;
     /** Image width (CSS value) */
-    width?: string;
+    width?: string | number;
     /** Image height (CSS value) */
-    height?: string;
+    height?: string | number;
     /** CSS object-fit mode (default 'cover') */
     objectFit?: 'cover' | 'contain' | 'fill' | 'none' | 'scale-down';
     /** Whether lightbox preview is enabled (default true) */
@@ -1295,7 +1347,7 @@ interface ChoiceListProps {
     indicatorStyle?: Record<string, any>;
     /** Style merged into selected indicators */
     selectedIndicatorStyle?: Record<string, any>;
-    /** Checked mark used by multiple mode; defaults to built-in `check_bold` */
+    /** Selected mark override; single mode keeps its radio dot when omitted, while multiple mode defaults to `check_bold` */
     checkedIcon?: ChoiceIndicatorIcon;
 }
 interface ChoiceIndicatorIcon {
@@ -1323,7 +1375,7 @@ interface ChoiceItemProps {
     indicatorStyle?: Record<string, any>;
     /** Per-item selected indicator style */
     selectedIndicatorStyle?: Record<string, any>;
-    /** Per-item checked mark override */
+    /** Per-item selected mark override; also replaces the single-select radio dot */
     checkedIcon?: ChoiceIndicatorIcon;
 }
 interface PasscodeInputProps {
@@ -1785,4 +1837,4 @@ declare const componentRenderers: Record<string, ComponentRenderer>;
 declare function registerComponent(type: string, renderer: ComponentRenderer): void;
 
 export { BaseElement, BotSDK, CardButton, CardChoiceItem, CardChoiceList, CardCollapse, CardCounter, CardDivider, CardForm, CardHtml, CardIcon, CardImage, CardInput, CardLoading, CardPasscodeInput, CardProgress, CardRate, CardSelect, CardSteps, CardSwitch, CardTag, CardText, DEFAULT_MOBILE_RESPONSIVE, LocalActionConfigProvider, RemoteActionConfigProvider, buildStyleString, componentRenderers, connectSSE, connectStreaming, convertPixelTokens, createResponsiveContext, createWebActionContext, isMobileViewport, onViewportChange, pxToRem, pxToVw, registerComponent, renderCard, renderStreamingCard, resolveSize, sanitizeHtml, trimIncompleteTag };
-export type { A2UIActionPayload, BotSDKOptions, ButtonProps, CardInstance, ChoiceIndicatorIcon, ChoiceItemProps, ChoiceListProps, ChoiceListValue, CollapseProps, ComponentRenderer, ConnectorConfig, CounterIcon, CounterProps, DividerProps, FormField, FormProps, FormRule, HtmlProps, IconProps, ImageProps, InputAffix, InputAffixConfig, InputProps, LoadingProps, PartialFinalizeResult, PasscodeInputProps, ProgressProps, ProgressSegment, RateProps, RenderCardOptions, ResponsiveContext, ResponsiveMobileOptions, ResponsiveOptions, SSEConnectOptions, SelectOption, SelectProps, SelectSize, SelectStyles, SelectVariant, StepIcon, StepItem, StepsProps, StreamingCardInstance, StreamingCardOptions, StreamingConnectOptions, StreamingConnection, SwitchProps, TagProps, TextProps, WebActionContextOptions };
+export type { A2UIActionPayload, BotSDKOptions, ButtonProps, CardFocusChangeEvent, CardFocusChangeListener, CardInstance, CardNodeHandle, ChoiceIndicatorIcon, ChoiceItemProps, ChoiceListProps, ChoiceListValue, CollapseProps, ComponentRenderer, ConnectorConfig, CounterIcon, CounterProps, DividerProps, FormField, FormProps, FormRule, HtmlProps, IconProps, ImageProps, InputAffix, InputAffixConfig, InputProps, LoadingProps, PartialFinalizeResult, PasscodeInputProps, ProgressProps, ProgressSegment, RateProps, RenderCardOptions, ResponsiveContext, ResponsiveMobileOptions, ResponsiveOptions, SSEConnectOptions, SelectOption, SelectProps, SelectSize, SelectStyles, SelectVariant, StepIcon, StepItem, StepsProps, StreamingCardInstance, StreamingCardOptions, StreamingConnectOptions, StreamingConnection, SwitchProps, TagProps, TextProps, WebActionContextOptions };