@antglobal/copilot-cards-web 1.0.3 → 1.0.4

package/dist/index.d.ts

@@ -29,6 +29,24 @@ interface WebActionContextOptions {
  */
 declare function createWebActionContext(options?: WebActionContextOptions): ActionRunnerContext;
 
+interface ResponsiveMobileOptions {
+    readonly unit: 'rem';
+    readonly rootValue: number;
+}
+interface ResponsiveOptions {
+    readonly mobile?: ResponsiveMobileOptions;
+}
+interface ResponsiveContext {
+    readonly active: boolean;
+    readonly rootValue: number;
+    resolveLength(value: string | number): string;
+    convertCSS(value: string): string;
+}
+declare const DEFAULT_MOBILE_RESPONSIVE: ResponsiveMobileOptions;
+/** Convert CSS px lengths while preserving strings, comments, and URLs. */
+declare function convertPixelTokens(value: string, rootValue: number): string;
+declare function createResponsiveContext(isMobile: boolean, responsive?: ResponsiveOptions): ResponsiveContext;
+
 /**
  * renderCard — the primary public API for @antglobal/copilot-cards-web.
  *
@@ -46,6 +64,8 @@ declare function createWebActionContext(options?: WebActionContextOptions): Acti
 interface RenderCardOptions extends WebActionContextOptions {
     /** Force mobile mode; auto-detected from viewport if omitted */
     isMobile?: boolean;
+    /** Mobile sizing conversion. `isMobile: true` defaults to rem/rootValue 100. */
+    responsive?: ResponsiveOptions;
     /** External variables to merge into schema.variables (overrides schema defaults) */
     variables?: Record<string, any>;
     /** Bot ID — used to look up bot-scoped action handlers */
@@ -422,16 +442,18 @@ declare abstract class BaseElement extends HTMLElement {
     protected _node: RenderTreeNode | null;
     protected _props: Record<string, any>;
     protected _isMobile: boolean;
+    protected _responsiveOptions?: ResponsiveOptions;
+    protected _responsive: ResponsiveContext;
     constructor();
     /**
      * Set component data and trigger render.
      * Called by the component renderer (from `renderCard` pipeline).
      */
-    setData(node: RenderTreeNode, props: Record<string, any>, isMobile: boolean): void;
+    setData(node: RenderTreeNode, props: Record<string, any>, isMobile: boolean, responsive?: ResponsiveOptions): void;
     /**
      * Update props only (e.g. on variable change + re-render).
      */
-    updateProps(props: Record<string, any>, isMobile?: boolean): void;
+    updateProps(props: Record<string, any>, isMobile?: boolean, responsive?: ResponsiveOptions): void;
     /**
      * Subclasses must implement this to render their UI into `this.shadowRoot`.
      */
@@ -445,6 +467,8 @@ declare abstract class BaseElement extends HTMLElement {
     protected buildInlineStyle(style?: Record<string, any>, isExpressionResult?: boolean): string;
     /** Resolve a single size value (number → px). */
     protected toCSS(value: string | number): string;
+    /** Assign component markup and convert only its CSS declarations. */
+    protected setShadowHTML(html: string): void;
     /**
      * Escape a value before interpolating it into a double-quoted HTML
      * attribute. Browsers decode the entities before parsing inline CSS, so
@@ -472,7 +496,7 @@ declare class CardText extends BaseElement {
     private _mdPendingUpdate;
     private _tooltipEl;
     private _tooltipTimer;
-    setData(node: RenderTreeNode, props: Record<string, any>, isMobile: boolean): void;
+    setData(node: RenderTreeNode, props: Record<string, any>, isMobile: boolean, responsive?: ResponsiveOptions): void;
     protected render(): void;
     /**
      * Handle incremental content update in streaming mode.
@@ -500,7 +524,7 @@ declare class CardText extends BaseElement {
      * Remove cursor when streaming ends.
      * Called externally when streaming prop changes to false.
      */
-    updateProps(props: Record<string, any>, isMobile?: boolean): void;
+    updateProps(props: Record<string, any>, isMobile?: boolean, responsive?: ResponsiveOptions): void;
     /**
      * Parse markdown to HTML using marked.
      */
@@ -789,30 +813,6 @@ declare class CardTag extends BaseElement {
     protected render(): void;
 }
 
-/**
- * CardSelect — Custom Element for a dropdown selector.
- *
- * Schema example:
- * ```json
- * {
- *   "type": "Select",
- *   "props": {
- *     "placeholder": "请选择",
- *     "options": [
- *       { "label": "选项一", "value": "1" },
- *       { "label": "选项二", "value": "2" }
- *     ],
- *     "value": ""
- *   }
- * }
- * ```
- *
- * The value is semi-controlled: a user-picked option shows on the trigger
- * immediately even when no `onChange` action is wired, while any external
- * `props.value` change (e.g. a variable update re-render) overrides the
- * local pick.
- */
-
 declare class CardSelect extends BaseElement {
     private _open;
     private _activeIndex;
@@ -824,7 +824,7 @@ declare class CardSelect extends BaseElement {
     static readonly is = "ai-card-select";
     protected render(): void;
     disconnectedCallback(): void;
-    updateProps(props: Record<string, any>, isMobile?: boolean): void;
+    updateProps(props: Record<string, any>, isMobile?: boolean, responsive?: ResponsiveOptions): void;
     private _setOpen;
     private openWithCurrentOption;
     private handleKeydown;
@@ -1191,6 +1191,8 @@ interface SelectStyles {
     option?: Record<string, any>;
     /** Style merged into the selected option */
     selectedOption?: Record<string, any>;
+    /** Arrow wrapper style; overrides arrowSize for declared dimensions */
+    arrow?: Record<string, any>;
 }
 interface SelectProps {
     /** Dropdown options list */
@@ -1217,6 +1219,8 @@ interface SelectProps {
     variant?: SelectVariant;
     /** Accent used for focus and selection states */
     accentColor?: string;
+    /** Dropdown arrow size in px or as a CSS length */
+    arrowSize?: number | string;
     /** Advanced semantic styles for internal parts */
     styles?: SelectStyles;
 }
@@ -1758,7 +1762,7 @@ declare class CardChoiceItem extends BaseElement {
  * for the `renderCard` pipeline to attach events and children.
  */
 
-type ComponentRenderer = (node: RenderTreeNode, props: Record<string, any>, isMobile: boolean) => HTMLElement;
+type ComponentRenderer = (node: RenderTreeNode, props: Record<string, any>, isMobile: boolean, responsive?: ResponsiveOptions) => HTMLElement;
 declare const componentRenderers: Record<string, ComponentRenderer>;
 /**
  * Register a custom component renderer.
@@ -1775,5 +1779,5 @@ 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, LocalActionConfigProvider, RemoteActionConfigProvider, buildStyleString, componentRenderers, connectSSE, connectStreaming, 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, SSEConnectOptions, SelectOption, SelectProps, SelectSize, SelectStyles, SelectVariant, StepIcon, StepItem, StepsProps, StreamingCardInstance, StreamingCardOptions, StreamingConnectOptions, StreamingConnection, SwitchProps, TagProps, TextProps, WebActionContextOptions };
+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 };