// 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;