// Built-in JSX views and host helpers. Editor metadata only. /** JSX 绘图节点。 */ interface View {} /** 视图属性。 */ type ViewContent = View | string | number | boolean | null | undefined | ViewContent[]; /** 视图属性。 */ type TextContent = string | number | bigint | boolean | symbol | { toString(): string } | null | undefined; /** 可用于颜色和渐变的 HDR 颜色数据。 */ type HDRColor = { readonly $type: "CapDrive.HDR"; readonly color: string }; /** 视图属性。 */ type RGBColor = { space?: "srgb" | "displayP3"; r: number; g: number; b: number; a?: number }; /** 视图属性。 */ type Color = string | RGBColor | HDRColor; /** 视图属性。 */ type ViewPoint = { x: number; y: number }; /** 视图属性。 */ type ChartDataPoint = { value: { x: number; y: number | null }; label: { x: string; y: string } }; /** 视图属性。 */ type ChartRange = readonly [min: number, max: number]; /** 视图属性。 */ type MapCoordinate = { latitude: number; longitude: number }; /** 视图属性。 */ type MapPathStyle = { stroke?: Color; lineWidth?: number; lineCap?: "round" | "butt" | "square"; lineJoin?: "round" | "miter" | "bevel"; dash?: readonly number[]; dashPhase?: number; outlineStroke?: Color; outlineWidth?: number; showEndpoints?: boolean }; /** 视图属性。 */ type ChartAxisStyle = { stroke?: Paint; lineWidth?: number; lineCap?: "round" | "butt" | "square"; dash?: readonly number[]; dashPhase?: number }; /** 视图属性。 */ type BarChartDataPoint = { value: number; label?: string }; /** 视图属性。 */ type PathCommand = { op: "move"; x: number; y: number } | { op: "line"; x: number; y: number } | { op: "quad"; x: number; y: number; cx: number; cy: number } | { op: "cubic"; x: number; y: number; c1x: number; c1y: number; c2x: number; c2y: number } | { op: "arc"; x: number; y: number; radius: number; startAngle: number; sweepAngle: number } | { op: "close" }; /** 视图属性。 */ type GradientStop = Color | { color: Color; location: number }; /** 视图属性。 */ type GradientColors = ReadonlyArray; /** 视图属性。 */ type LinearGradientOptions = { angle?: number; center?: ViewPoint }; /** 视图属性。 */ type RadialGradientOptions = { startRadius?: number; endRadius?: number; center?: ViewPoint }; /** 视图属性。 */ type AngularGradientOptions = { angle?: number; center?: ViewPoint }; /** 视图属性。 */ type Gradient = { readonly type: "linear" | "radial" | "angular"; readonly angle?: number; readonly startRadius?: number; readonly endRadius?: number; readonly center?: ViewPoint; readonly colors: GradientColors }; /** 视图属性。 */ type Paint = Color | Gradient; /** 视图属性。 */ type DrawingEffect = { color?: Color; opacity?: number; radius?: number; x?: number; y?: number }; /** 视图属性。 */ type ViewTransform = { translateX?: number; translateY?: number; scaleX?: number; scaleY?: number; rotation?: number; skewX?: number; skewY?: number; anchorX?: number; anchorY?: number }; /** 视图属性。 */ type RepeatAxisValue = number | { x?: number; y?: number }; /** 视图属性。 */ type AnimationProperty = "width" | "height" | "padding" | "x" | "y" | "opacity" | "cornerRadius" | "blur" | "shadowOpacity" | "shadowRadius" | "shadowX" | "shadowY" | "fontSize" | "letterSpacing" | "minimumScaleFactor" | "spacing" | "radius" | "radiusX" | "radiusY" | "startAngle" | "sweepAngle" | "lineWidth" | "dashPhase" | "trimStart" | "trimEnd" | "barThickness" | "value" | "offset" | "anchor" | "period" | "minLength" | "color" | "stroke" | "background" | "shadowColor" | "transform.translateX" | "transform.translateY" | "transform.scaleX" | "transform.scaleY" | "transform.rotation" | "transform.skewX" | "transform.skewY" | "transform.anchorX" | "transform.anchorY" | "period.x" | "period.y" | "value.x" | "value.y" | "anchor.x" | "anchor.y" | "offset.x" | "offset.y" | "start.x" | "start.y" | "end.x" | "end.y" | "rangeX.0" | "rangeX.1" | "rangeY.0" | "rangeY.1" | "xAxis.lineWidth" | "xAxis.dashPhase" | "yAxis.lineWidth" | "yAxis.dashPhase" | "xAxis.stroke" | "yAxis.stroke" | "regionOffset.x" | "regionOffset.y" | "pathStyle.lineWidth" | "pathStyle.outlineWidth" | "pathStyle.dashPhase" | "pathStyle.stroke" | "pathStyle.outlineStroke"; /** 视图属性。 */ type Animation = { property: AnimationProperty; duration?: number; delay?: number; curve?: string; from?: number | Color; to?: number | Color; repeat?: number | "forever"; autoreverse?: boolean; wrap?: number }; /** 视图属性。 */ type CircleAnimation = (Omit & { property: "width" | "height" | "x" | "y" | "opacity" | "background" | "blur" | "shadowColor" | "shadowOpacity" | "shadowRadius" | "shadowX" | "shadowY" | "dashPhase" | "stroke" | "lineWidth" | "startAngle" | "transform.translateX" | "transform.translateY" | "transform.scaleX" | "transform.scaleY" | "transform.rotation" | "transform.skewX" | "transform.skewY" | "transform.anchorX" | "transform.anchorY" }) | (Omit & { property: "sweepAngle"; from?: number; to?: number; wrap?: never }); /** 视图属性。 */ type EllipseAnimation = (Omit & { property: "width" | "height" | "x" | "y" | "opacity" | "background" | "blur" | "shadowColor" | "shadowOpacity" | "shadowRadius" | "shadowX" | "shadowY" | "dashPhase" | "stroke" | "lineWidth" | "startAngle" | "transform.translateX" | "transform.translateY" | "transform.scaleX" | "transform.scaleY" | "transform.rotation" | "transform.skewX" | "transform.skewY" | "transform.anchorX" | "transform.anchorY" }) | (Omit & { property: "sweepAngle"; from?: number; to?: number; wrap?: never }); /** 视图属性。 */ type ArcAnimation = (Omit & { property: "width" | "height" | "x" | "y" | "opacity" | "background" | "blur" | "shadowColor" | "shadowOpacity" | "shadowRadius" | "shadowX" | "shadowY" | "dashPhase" | "stroke" | "lineWidth" | "startAngle" | "transform.translateX" | "transform.translateY" | "transform.scaleX" | "transform.scaleY" | "transform.rotation" | "transform.skewX" | "transform.skewY" | "transform.anchorX" | "transform.anchorY" }) | (Omit & { property: "sweepAngle"; from?: number; to?: number; wrap?: never }); /** 视图属性。 */ type MapAnimation = (Omit & { property: "width" | "height" | "x" | "y" | "opacity" | "cornerRadius" | "transform.translateX" | "transform.translateY" | "transform.scaleX" | "transform.scaleY" | "transform.rotation" | "transform.skewX" | "transform.skewY" | "transform.anchorX" | "transform.anchorY" | "regionOffset.x" | "regionOffset.y" | "pathStyle.lineWidth" | "pathStyle.outlineWidth" | "pathStyle.dashPhase"; from?: number; to?: number }) | (Omit & { property: "pathStyle.stroke" | "pathStyle.outlineStroke"; from?: Color; to?: Color; wrap?: never }); /** 视图属性。 */ type LineChartAnimation = (Omit & { property: "width" | "height" | "x" | "y" | "opacity" | "blur" | "shadowColor" | "shadowOpacity" | "shadowRadius" | "shadowX" | "shadowY" | "stroke" | "lineWidth" | "dashPhase" | "transform.translateX" | "transform.translateY" | "transform.scaleX" | "transform.scaleY" | "transform.rotation" | "transform.skewX" | "transform.skewY" | "transform.anchorX" | "transform.anchorY" }) | (Omit & { property: "rangeX.0" | "rangeX.1" | "rangeY.0" | "rangeY.1"; from?: number; to?: number; wrap?: never }) | (Omit & { property: "xAxis.lineWidth" | "xAxis.dashPhase" | "yAxis.lineWidth" | "yAxis.dashPhase"; from?: number; to?: number }) | (Omit & { property: "xAxis.stroke" | "yAxis.stroke"; from?: Color; to?: Color; wrap?: never }); /** 视图属性。 */ type BarChartAnimation = (Omit & { property: "width" | "height" | "x" | "y" | "opacity" | "background" | "cornerRadius" | "blur" | "shadowColor" | "shadowOpacity" | "shadowRadius" | "shadowX" | "shadowY" | "barThickness" | "stroke" | "lineWidth" | "dashPhase" | "transform.translateX" | "transform.translateY" | "transform.scaleX" | "transform.scaleY" | "transform.rotation" | "transform.skewX" | "transform.skewY" | "transform.anchorX" | "transform.anchorY" }) | (Omit & { property: "rangeY.0" | "rangeY.1"; from?: number; to?: number; wrap?: never }) | (Omit & { property: "xAxis.lineWidth" | "xAxis.dashPhase" | "yAxis.lineWidth" | "yAxis.dashPhase"; from?: number; to?: number }) | (Omit & { property: "xAxis.stroke" | "yAxis.stroke"; from?: Color; to?: Color; wrap?: never }); /** 视图属性。 */ type RadialLayoutAnimation = (Omit & { property: "width" | "height" | "padding" | "x" | "y" | "opacity" | "background" | "cornerRadius" | "blur" | "shadowColor" | "shadowOpacity" | "shadowRadius" | "shadowX" | "shadowY" | "radius" | "radiusX" | "radiusY" | "startAngle" | "transform.translateX" | "transform.translateY" | "transform.scaleX" | "transform.scaleY" | "transform.rotation" | "transform.skewX" | "transform.skewY" | "transform.anchorX" | "transform.anchorY" }) | (Omit & { property: "sweepAngle"; from?: number; to?: number; wrap?: never }); /** 视图属性。 */ type SpacerAnimation = { property: "width" | "height" | "minLength"; duration?: number; delay?: number; curve?: string; from?: number; to?: number; repeat?: number | "forever"; autoreverse?: boolean; wrap?: number }; /** 视图属性。 */ type ContentAnimation = { type: "fade" | "slide" | "scale" | "numericText" | "interpolate"; duration?: number; delay?: number; curve?: string; direction?: string; distance?: number; scale?: number }; /** 视图属性。 */ type ViewSize = { width: number; height: number }; /** 视图属性。 */ type ViewInsets = { top: number; leading: number; bottom: number; trailing: number }; /** 视图属性。 */ type CardContentMetrics = { size: ViewSize; contentSize: ViewSize; headerSize: ViewSize; safeInsets: ViewInsets }; interface CommonViewProps { /** 兄弟节点中的稳定标识。 */ key?: string | number; /** 子视图内容。 */ children?: ViewContent; /** 宽度:点数、自动测量或填满父区域。 */ width?: number | "auto" | "fill"; /** 高度:点数、自动测量或填满父区域。 */ height?: number | "auto" | "fill"; /** 内容内边距,单位为点。 */ padding?: number; /** 视图属性。 */ x?: number; /** 视图属性。 */ y?: number; /** 视图属性。 */ opacity?: number; /** 视图属性。 */ background?: Paint; /** 视图属性。 */ cornerRadius?: number; /** 视图属性。 */ clipped?: boolean; /** 视图属性。 */ clip?: "rectangle" | "ellipse"; /** 视图属性。 */ blur?: number; /** 视图属性。 */ zIndex?: number; /** 视图属性。 */ innerShadow?: DrawingEffect; /** 视图属性。 */ glow?: DrawingEffect; /** 视图属性。 */ shadowColor?: Color; /** 视图属性。 */ shadowOpacity?: number; /** 视图属性。 */ shadowRadius?: number; /** 视图属性。 */ shadowX?: number; /** 视图属性。 */ shadowY?: number; /** 透明度遮罩 View,居中显示且不影响布局;null 表示不使用遮罩。 */ mask?: View | null; /** 视图属性。 */ transform?: ViewTransform; /** 视图属性。 */ animations?: Animation[]; } interface TextProps extends CommonViewProps { /** 子视图内容。 */ children?: TextContent | TextContent[]; /** 字号,单位为点。 */ fontSize?: number; /** 视图属性。 */ fontWeight?: "ultraLight" | "thin" | "light" | "regular" | "medium" | "semibold" | "bold" | "heavy" | "black"; /** 视图属性。 */ font?: "default" | "rounded" | "monospaced" | "serif"; /** 视图属性。 */ monospacedDigits?: boolean; /** 视图属性。 */ letterSpacing?: number; /** 视图属性。 */ minimumScaleFactor?: number; /** 视图属性。 */ lineLimit?: number | null; /** 视图属性。 */ truncationMode?: "head" | "middle" | "tail"; /** 绘图颜色,支持 HDR 颜色。 */ color?: Paint; /** 视图属性。 */ alignment?: "leading" | "center" | "trailing"; /** 视图属性。 */ contentAnimation?: ContentAnimation; } interface ImageProps extends CommonViewProps { children?: never; /** 视图属性。 */ source: string; /** 视图属性。 */ contentMode?: "fit" | "fill" | "stretch"; /** 视图属性。 */ repeatMode?: "none" | "repeat" | "repeatX" | "repeatY"; /** 视图属性。 */ renderingMode?: "original" | "template"; /** 绘图颜色,支持 HDR 颜色。 */ color?: Paint; /** 视图属性。 */ contentAnimation?: ContentAnimation; } interface GroupProps { /** 兄弟节点中的稳定标识。 */ key?: string | number; /** 子视图内容。 */ children?: ViewContent; /** 视图属性。 */ opacity?: number; /** 视图属性。 */ background?: Paint; /** 视图属性。 */ cornerRadius?: number; /** 视图属性。 */ clipped?: boolean; /** 视图属性。 */ clip?: "rectangle" | "ellipse"; /** 视图属性。 */ blur?: number; /** 视图属性。 */ zIndex?: number; /** 视图属性。 */ innerShadow?: DrawingEffect; /** 视图属性。 */ glow?: DrawingEffect; /** 视图属性。 */ shadowColor?: Color; /** 视图属性。 */ shadowOpacity?: number; /** 视图属性。 */ shadowRadius?: number; /** 视图属性。 */ shadowX?: number; /** 视图属性。 */ shadowY?: number; /** 透明度遮罩 View,居中显示且不影响布局;null 表示不使用遮罩。 */ mask?: View | null; /** 视图属性。 */ transform?: ViewTransform; /** 视图属性。 */ animations?: Animation[]; } interface SpacerProps { children?: never; /** 兄弟节点中的稳定标识。 */ key?: string | number; /** 宽度:点数、自动测量或填满父区域。 */ width?: number | "auto" | "fill"; /** 高度:点数、自动测量或填满父区域。 */ height?: number | "auto" | "fill"; /** 视图属性。 */ minLength?: number; /** 视图属性。 */ animations?: SpacerAnimation[]; } interface VStackProps extends CommonViewProps { /** 子视图间距,单位为点。 */ spacing?: number; /** 视图属性。 */ alignment?: "leading" | "center" | "trailing"; } interface HStackProps extends CommonViewProps { /** 子视图间距,单位为点。 */ spacing?: number; /** 视图属性。 */ alignment?: "top" | "center" | "bottom" | "firstTextBaseline" | "lastTextBaseline"; } interface ZStackProps extends CommonViewProps { /** 视图属性。 */ alignment?: "topLeading" | "top" | "topTrailing" | "leading" | "center" | "trailing" | "bottomLeading" | "bottom" | "bottomTrailing"; } interface MaterialProps { children?: never; /** 兄弟节点中的稳定标识。 */ key?: string | number; /** 宽度:点数、自动测量或填满父区域。 */ width?: number | "auto" | "fill"; /** 高度:点数、自动测量或填满父区域。 */ height?: number | "auto" | "fill"; /** 视图属性。 */ x?: number; /** 视图属性。 */ y?: number; /** 视图属性。 */ opacity?: number; /** 视图属性。 */ background?: Paint; /** 视图属性。 */ cornerRadius?: number; /** 视图属性。 */ clipped?: boolean; /** 视图属性。 */ clip?: boolean | "rectangle" | "ellipse"; /** 视图属性。 */ blur?: number; /** 视图属性。 */ zIndex?: number; /** 视图属性。 */ innerShadow?: DrawingEffect; /** 视图属性。 */ glow?: DrawingEffect; /** 视图属性。 */ shadowColor?: Color; /** 视图属性。 */ shadowOpacity?: number; /** 视图属性。 */ shadowRadius?: number; /** 视图属性。 */ shadowX?: number; /** 视图属性。 */ shadowY?: number; /** 透明度遮罩 View,居中显示且不影响布局;null 表示不使用遮罩。 */ mask?: View | null; /** 视图属性。 */ transform?: ViewTransform; /** 视图属性。 */ animations?: Animation[]; /** 视图属性。 */ type: "frosted"; /** 视图属性。 */ style?: "ultraThin" | "thin" | "regular" | "thick" | "ultraThick" | "bar"; } interface CardContentBase extends Omit { /** 标题文字或 View。 */ title?: string | View | null; /** 标题右侧的文字或 View。 */ trailing?: string | View | null; /** 视图属性。 */ contentMode?: "inset" | "full"; /** 视图属性。 */ headerBackground?: View | null; } interface SymbolProps extends CommonViewProps { children?: never; /** 视图属性。 */ name: string; /** 字号,单位为点。 */ fontSize?: number; /** 视图属性。 */ fontWeight?: "ultraLight" | "thin" | "light" | "regular" | "medium" | "semibold" | "bold" | "heavy" | "black"; /** 视图属性。 */ imageScale?: "small" | "medium" | "large"; /** 视图属性。 */ renderingMode?: "monochrome" | "hierarchical" | "palette" | "multicolor"; /** 视图属性。 */ paletteColors?: [Color] | [Color, Color] | [Color, Color, Color]; /** 绘图颜色,支持 HDR 颜色。 */ color?: Paint; /** 视图属性。 */ contentAnimation?: ContentAnimation; } interface RepeatedLayoutProps extends Omit { /** 视图属性。 */ axis?: "horizontal" | "vertical" | "both"; /** 视图属性。 */ period?: RepeatAxisValue; /** 视图属性。 */ value?: RepeatAxisValue; /** 视图属性。 */ anchor?: RepeatAxisValue; /** 视图属性。 */ offset?: RepeatAxisValue; /** 视图属性。 */ alignment?: "topLeading" | "top" | "topTrailing" | "leading" | "center" | "trailing" | "bottomLeading" | "bottom" | "bottomTrailing"; } interface RadialLayoutProps extends CommonViewProps { /** 视图属性。 */ animations?: RadialLayoutAnimation[]; /** 视图属性。 */ radius?: number; /** 视图属性。 */ radiusX?: number; /** 视图属性。 */ radiusY?: number; /** 起始角度,单位为度;采样时按 360° 取模。 */ startAngle?: number; /** 扫角,单位为度;采样时限制在 -360…360。正值为顺时针,不支持 wrap。 */ sweepAngle?: number; /** 视图属性。 */ includeEnd?: boolean; /** 视图属性。 */ childRotation?: "none" | "radial" | "tangent"; } interface CircleProps extends Omit { children?: never; /** 视图属性。 */ animations?: CircleAnimation[]; /** 视图属性。 */ lineCap?: "round" | "butt" | "square"; /** 视图属性。 */ dashPhase?: number; /** 形状描边色。 */ stroke?: Paint; /** 视图属性。 */ lineWidth?: number; /** 视图属性。 */ dash?: number[]; /** 起始角度,单位为度;采样时按 360° 取模。 */ startAngle?: number; /** 扫角,单位为度;采样时限制在 -360…360。正值为顺时针,不支持 wrap。 */ sweepAngle?: number; /** 描边相对于完整圆或椭圆轮廓的位置,默认为 inside。 */ strokePosition?: "inside" | "center" | "outside"; } interface EllipseProps extends Omit { children?: never; /** 视图属性。 */ animations?: EllipseAnimation[]; /** 视图属性。 */ lineCap?: "round" | "butt" | "square"; /** 视图属性。 */ dashPhase?: number; /** 形状描边色。 */ stroke?: Paint; /** 视图属性。 */ lineWidth?: number; /** 视图属性。 */ dash?: number[]; /** 起始角度,单位为度;采样时按 360° 取模。 */ startAngle?: number; /** 扫角,单位为度;采样时限制在 -360…360。正值为顺时针,不支持 wrap。 */ sweepAngle?: number; /** 描边相对于完整圆或椭圆轮廓的位置,默认为 inside。 */ strokePosition?: "inside" | "center" | "outside"; } interface RectangleProps extends Omit { children?: never; /** 视图属性。 */ trimStart?: number; /** 视图属性。 */ trimEnd?: number; /** 视图属性。 */ lineCap?: "round" | "butt" | "square"; /** 视图属性。 */ lineJoin?: "round" | "miter" | "bevel"; /** 视图属性。 */ dashPhase?: number; /** 形状描边色。 */ stroke?: Paint; /** 视图属性。 */ lineWidth?: number; /** 视图属性。 */ dash?: number[]; /** 视图属性。 */ strokePosition?: "inside" | "center" | "outside"; } interface LineProps extends Omit { children?: never; /** 视图属性。 */ trimStart?: number; /** 视图属性。 */ trimEnd?: number; /** 视图属性。 */ lineCap?: "round" | "butt" | "square"; /** 视图属性。 */ dashPhase?: number; /** 形状描边色。 */ stroke?: Paint; /** 视图属性。 */ lineWidth?: number; /** 视图属性。 */ dash?: number[]; /** 视图属性。 */ start?: ViewPoint; /** 视图属性。 */ end?: ViewPoint; } interface ArcProps extends Omit { children?: never; /** 视图属性。 */ animations?: ArcAnimation[]; /** 视图属性。 */ lineCap?: "round" | "butt" | "square"; /** 视图属性。 */ dashPhase?: number; /** 形状描边色。 */ stroke?: Paint; /** 视图属性。 */ lineWidth?: number; /** 视图属性。 */ dash?: number[]; /** 起始角度,单位为度;采样时按 360° 取模。 */ startAngle?: number; /** 扫角,单位为度;采样时限制在 -360…360。正值为顺时针,不支持 wrap。 */ sweepAngle?: number; /** 描边相对于完整圆或椭圆轮廓的位置,默认为 inside。 */ strokePosition?: "inside" | "center" | "outside"; } interface PolylineProps extends Omit { children?: never; /** 视图属性。 */ trimStart?: number; /** 视图属性。 */ trimEnd?: number; /** 视图属性。 */ lineCap?: "round" | "butt" | "square"; /** 视图属性。 */ lineJoin?: "round" | "miter" | "bevel"; /** 视图属性。 */ dashPhase?: number; /** 形状描边色。 */ stroke?: Paint; /** 视图属性。 */ lineWidth?: number; /** 视图属性。 */ dash?: number[]; /** 局部点坐标,单位为 pt。少于两个点时不绘制。 */ points: ReadonlyArray; /** 视图属性。 */ closed?: boolean; /** 可选内容过渡。interpolate 要求点数和闭合状态相同,否则直接更新。 */ contentAnimation?: ContentAnimation; } interface MapProps extends Omit { children?: never; /** 视图属性。 */ animations?: MapAnimation[]; /** 视图属性。 */ showUserLocation?: boolean; /** 相机中心来源:原生定位、仪表当前定位或固定经纬度。默认为 userLocation。 */ center?: "userLocation" | "dataLocation" | MapCoordinate; /** 取景偏移,单位为屏幕点。正 x/y 将取景范围向右/下移动,地图内容相应向左/上移动。 */ regionOffset?: ViewPoint; /** 按顺序排列的轨迹经纬度。null 中断一段轨迹;空数组不绘制轨迹。 */ path?: ReadonlyArray; /** 原生轨迹样式:Color 颜色、线宽、端点、连接、虚线、外描边及可选起终点标记。不支持渐变。 */ pathStyle?: MapPathStyle; /** 相机朝向:northUp、vehicle、path 或按 360 取模的角度。轨迹朝向不会跨越断点。 */ heading?: "northUp" | "vehicle" | "path" | number; /** 启用原生相机过渡,默认开启。首帧和系统减少动态效果时不播放。 */ cameraAnimation?: boolean; /** 视图属性。 */ appearance?: "automatic" | "light" | "dark"; /** 视图属性。 */ mapStyle?: "standard" | "satellite" | "hybrid"; /** 视图属性。 */ pitch?: number; } interface PathProps extends Omit { children?: never; /** 视图属性。 */ trimStart?: number; /** 视图属性。 */ trimEnd?: number; /** 视图属性。 */ lineCap?: "round" | "butt" | "square"; /** 视图属性。 */ lineJoin?: "round" | "miter" | "bevel"; /** 视图属性。 */ dashPhase?: number; /** 形状描边色。 */ stroke?: Paint; /** 视图属性。 */ lineWidth?: number; /** 视图属性。 */ dash?: number[]; /** 路径填充规则:nonZero 或 evenOdd。 */ fillRule?: "nonZero" | "evenOdd"; /** 局部路径命令,单位为 pt。空数组不绘制。 */ commands: ReadonlyArray; /** 可选内容过渡。interpolate 要求命令数量和操作顺序相同,否则直接更新。 */ contentAnimation?: ContentAnimation; } interface BarChartProps extends Omit { children?: never; /** 每根柱体的填充,默认为主题前景色。 */ background?: Paint; /** 每根柱体的圆角半径,自动限制在其尺寸内。 */ cornerRadius?: number; /** 视图属性。 */ animations?: BarChartAnimation[]; /** 绘图区底部的水平轴线。默认使用前景色、1pt 线宽;stroke 设为 clear 可隐藏。 */ xAxis?: ChartAxisStyle; /** 绘图区左侧的垂直轴线。默认使用前景色、1pt 线宽;stroke 设为 clear 可隐藏。 */ yAxis?: ChartAxisStyle; /** 按数组顺序排列的分类数据。每项包含数值 value 和可选标签 label。 */ data: ReadonlyArray; /** 柱体方向:vertical 从左到右排列,horizontal 从上到下排列。 */ axis?: "horizontal" | "vertical"; /** 可见数值范围 [min, max]。省略时自动适配数据并包含零。 */ rangeY?: ChartRange; /** 显示分类标签。缺少标签时留空,原生布局自动避免重叠。 */ showLabels?: boolean; /** 显示自动生成的数值轴刻度。 */ showValueLabels?: boolean; /** 柱体粗细,单位为点;auto 根据分类间距自动计算。 */ barThickness?: number | "auto"; /** 形状描边色。 */ stroke?: Paint; /** 视图属性。 */ lineWidth?: number; /** 相对每根柱体的描边位置,默认为 inside。 */ strokePosition?: "inside" | "center" | "outside"; /** 视图属性。 */ dash?: number[]; /** 视图属性。 */ dashPhase?: number; /** 可选内容过渡。interpolate 要求分类数量和方向相同,否则直接更新。 */ contentAnimation?: ContentAnimation; } interface LineChartProps extends Omit { children?: never; /** 视图属性。 */ animations?: LineChartAnimation[]; /** 绘图区底部的水平轴线。默认使用前景色、1pt 线宽;stroke 设为 clear 可隐藏。 */ xAxis?: ChartAxisStyle; /** 绘图区左侧的垂直轴线。默认使用前景色、1pt 线宽;stroke 设为 clear 可隐藏。 */ yAxis?: ChartAxisStyle; /** 图表数据。value.x/y 设置坐标,label.x/y 设置文字;y 为 null 时断开折线。 */ data: ReadonlyArray; /** 可见数值范围 [min, max]。省略时自动适配数据。 */ rangeX?: ChartRange; /** 可见数值范围 [min, max]。省略时自动适配数据。 */ rangeY?: ChartRange; /** 显示坐标轴标签。原生布局会选择不重叠的标签子集。 */ showXLabels?: boolean; /** 显示坐标轴标签。原生布局会选择不重叠的标签子集。 */ showYLabels?: boolean; /** 形状描边色。 */ stroke?: Paint; /** 视图属性。 */ lineWidth?: number; /** 视图属性。 */ lineCap?: "round" | "butt" | "square"; /** 视图属性。 */ lineJoin?: "round" | "miter" | "bevel"; /** 视图属性。 */ dash?: number[]; /** 视图属性。 */ dashPhase?: number; /** 可选内容过渡。interpolate 要求数据数量和缺失值位置相同,否则直接更新。 */ contentAnimation?: ContentAnimation; } type CardContentProps = CardContentBase & ({ children?: ViewContent; renderer?: never } | { children?: never; renderer: (metrics: CardContentMetrics) => ViewContent }); declare namespace CapDriveJSX { /** * 绘制文字。 * @param {TextProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Text(props: TextProps): View; /** * 显示已导入的图片素材。 * @param {ImageProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Image(props: ImageProps): View; /** * 将多个子视图作为整体应用变换和特效。 * @param {GroupProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Group(props: GroupProps): View; /** * 留出弹性空间。 * @param {SpacerProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Spacer(props: SpacerProps): View; /** * 纵向排列子视图。 * @param {VStackProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function VStack(props: VStackProps): View; /** * 横向排列子视图。 * @param {HStackProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function HStack(props: HStackProps): View; /** * 从后向前叠放子视图。 * @param {ZStackProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function ZStack(props: ZStackProps): View; /** * 绘制原生背景材质。 * @param {MaterialProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Material(props: MaterialProps): View; /** * 布局仪表标题与正文。 * @param {CardContentProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function CardContent(props: CardContentProps): View; /** * 绘制 SF Symbols 图标。 * @param {SymbolProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Symbol(props: SymbolProps): View; /** * 围绕当前值重复周期性绘图。 * @param {RepeatedLayoutProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function RepeatedLayout(props: RepeatedLayoutProps): View; /** * 沿圆周或椭圆排列子视图。 * @param {RadialLayoutProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function RadialLayout(props: RadialLayoutProps): View; /** * 绘制圆形。 * @param {CircleProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Circle(props: CircleProps): View; /** * 绘制椭圆。 * @param {EllipseProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Ellipse(props: EllipseProps): View; /** * 绘制矩形。 * @param {RectangleProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Rectangle(props: RectangleProps): View; /** * 绘制直线。 * @param {LineProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Line(props: LineProps): View; /** * 绘制圆弧或椭圆弧。 * @param {ArcProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Arc(props: ArcProps): View; /** * 连接多个点绘制折线。 * @param {PolylineProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Polyline(props: PolylineProps): View; /** * 显示原生地图。 * @param {MapProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Map(props: MapProps): View; /** * 绘制路径。 * @param {PathProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function Path(props: PathProps): View; /** * 绘制柱状图。 * @param {BarChartProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function BarChart(props: BarChartProps): View; /** * 绘制折线图。 * @param {LineChartProps} props 视图属性。 * @returns {View} JSX 绘图节点。 */ function LineChart(props: LineChartProps): View; } declare function CardContent(props: CardContentProps): View; /** * 标记需要 HDR 增强的颜色,保留原始 SDR 颜色。 * @param {string} color 颜色名称或十六进制颜色。 * @returns {HDRColor} 可用于颜色和渐变的 HDR 颜色数据。 */ interface HDRFactory { (color: string): HDRColor; new(color: string): HDRColor; } declare const HDR: HDRFactory; interface LinearGradientFactory { (colors: GradientColors, options?: LinearGradientOptions): Gradient; new(colors: GradientColors, options?: LinearGradientOptions): Gradient; } declare const LinearGradient: LinearGradientFactory; interface RadialGradientFactory { (colors: GradientColors, options?: RadialGradientOptions): Gradient; new(colors: GradientColors, options?: RadialGradientOptions): Gradient; } declare const RadialGradient: RadialGradientFactory; interface AngularGradientFactory { (colors: GradientColors, options?: AngularGradientOptions): Gradient; new(colors: GradientColors, options?: AngularGradientOptions): Gradient; } declare const AngularGradient: AngularGradientFactory;