@doubao-dev/template 0.1.0 → 0.2.0

package/README.md

@@ -182,9 +182,51 @@ import { Price } from '@doubao-dev/template/primitives';
 - `loading` 展示最大宽度为 60% 的扫光占位。
 - `className` 和 `style` 可用于样式定制。
 
+## MapCard
+
+地图卡模板，由固定高度地图、可选信息区和操作区组成，适合路线预估、叫车状态、位置详情等场景。
+
+```tsx
+import { MapCard } from '@doubao-dev/template';
+
+<MapCard
+  mapProps={{
+    center: { latitude: 39.9087, longitude: 116.3975 },
+    scale: 14,
+    polyline: [
+      {
+        id: 'route',
+        points: [
+          { latitude: 39.9151, longitude: 116.4039 },
+          { latitude: 39.9042, longitude: 116.3925 }
+        ],
+        width: 5
+      }
+    ]
+  }}
+  title="预估 29 元"
+  metaItems={[
+    { text: '最高优惠 6 元', tone: 'highlight' },
+    { text: '已选 4 种车型' }
+  ]}
+  inlineActions={[{ text: '确认叫车', onClick: () => console.log('confirm') }]}
+/>
+```
+
+说明：
+
+- `mapProps` 透传地图能力，但卡片统一管理地图的 `className`、`style` 和 168px 高度；可通过 `mapProps.children` 传入 `MapMarker` 等地图覆盖物。
+- `ref` 会直接绑定到内部 Map，可通过 `MapRef` 调用 `getCenter`、`setCenter` 等实例方法。
+- MapCard 不渲染地图左上角来源标题，小程序标题由客户端的 `titleType` 控制。
+- `title` 使用单行 `Title` primitive，`showArrow` 默认是 `true`。
+- `metaItems` 最多展示前 2 项，`tone="highlight"` 使用强调色；多项之间由模板补充分隔点。
+- `inlineActions` 复用 `TemplateCardFooterActionButton`；单按钮按主按钮渲染，双按钮依次按次按钮、主按钮渲染。
+- `footer` 使用通用底部操作区。信息区和 footer 可单独使用，也可组合使用。
+- MapCard 不支持 `children`，地图配置、信息和操作均使用对应的结构化字段。
+
 ## ContentCard
 
-<img src="https://unpkg.com/@doubao-dev/template@0.1.0/assets/content-card.png" alt="ContentCard 示例" width="400" />
+<img src="https://unpkg.com/@doubao-dev/template@0.2.0/assets/content-card.png" alt="ContentCard 示例" width="400" />
 
 通用列表卡，由标题栏、列表内容和底部操作区组成，适合商品、服务、内容入口等可重复条目。
 
@@ -226,7 +268,7 @@ import { ContentCard } from '@doubao-dev/template';
 
 ## PriceActionCard
 
-<img src="https://unpkg.com/@doubao-dev/template@0.1.0/assets/price-action-card.png" alt="PriceActionCard 示例" width="400" />
+<img src="https://unpkg.com/@doubao-dev/template@0.2.0/assets/price-action-card.png" alt="PriceActionCard 示例" width="400" />
 
 价格操作卡，由多条"价格 + 信息 + 右侧按钮"组成，适合报价、权益、服务方案等结果列表。
 
@@ -259,7 +301,7 @@ import { PriceActionCard } from '@doubao-dev/template';
 
 ## CheckoutCard
 
-<img src="https://unpkg.com/@doubao-dev/template@0.1.0/assets/checkout-card.png" alt="CheckoutCard 示例" width="400" />
+<img src="https://unpkg.com/@doubao-dev/template@0.2.0/assets/checkout-card.png" alt="CheckoutCard 示例" width="400" />
 
 通用提单卡，由商品摘要、提单信息、费用汇总和底部操作区组成，适合下单确认、支付确认等场景。
 
@@ -310,7 +352,7 @@ import { CheckoutCard } from '@doubao-dev/template';
 
 ## TicketOrderCard
 
-<img src="https://unpkg.com/@doubao-dev/template@0.1.0/assets/ticket-checkout-card.png" alt="TicketOrderCard 示例" width="400" />
+<img src="https://unpkg.com/@doubao-dev/template@0.2.0/assets/ticket-checkout-card.png" alt="TicketOrderCard 示例" width="400" />
 
 > **已废弃：** 请使用 `CheckoutCard`。`TicketOrderCard` 仅为兼容现有代码保留。
 
@@ -357,7 +399,7 @@ import { TicketOrderCard } from '@doubao-dev/template';
 
 ## TransitCard
 
-<img src="https://unpkg.com/@doubao-dev/template@0.1.0/assets/transit-card.png" alt="TransitCard 示例" width="400" />
+<img src="https://unpkg.com/@doubao-dev/template@0.2.0/assets/transit-card.png" alt="TransitCard 示例" width="400" />
 
 交通票务列表卡，由多条出发、中转、到达和价格信息组成，适合展示机票、火车票、大巴等推荐列表。
 
@@ -405,7 +447,7 @@ import { TransitCard } from '@doubao-dev/template';
 
 ## AskHumanCard
 
-<img src="https://unpkg.com/@doubao-dev/template@0.1.0/assets/ask-human-card.png" alt="AskHumanCard 示例" width="400" />
+<img src="https://unpkg.com/@doubao-dev/template@0.2.0/assets/ask-human-card.png" alt="AskHumanCard 示例" width="400" />
 
 人工确认选项卡，由一组选项组成，适合让用户在多个候选项中确认选择。
 
@@ -421,6 +463,14 @@ import { AskHumanCard } from '@doubao-dev/template';
       text: '都不是',
       showArrow: 'right',
       onClick: () => console.log('skip')
+    },
+    {
+      text: '打开外部应用',
+      showArrow: 'right',
+      openType: 'launchApp',
+      launchAppUrl: 'your-app://path',
+      onLaunchApp: (result) => console.log('launch app success', result),
+      onLaunchAppError: (error) => console.error('launch app failed', error)
     }
   ]}
 />
@@ -430,3 +480,4 @@ import { AskHumanCard } from '@doubao-dev/template';
 
 - `items` 配置选项列表，选项文案通过 `text` 设置。
 - `items[].showArrow` 支持 `'left'`、`'right'`、`'none'`，默认不展示；跳过、固定跳转等入口也通过 `items` 表达。
+- 设置 `items[].openType` 为 `'launchApp'` 并传入 `launchAppUrl`，可以通过 deeplink 跳转外部应用；跳转结果分别通过 `onLaunchApp` 和 `onLaunchAppError` 回调。

package/dist/ask-human-card/index.d.ts

@@ -1,3 +1,4 @@
+import { type LaunchAppResult } from '@byted-doubao-apps/components';
 import type { CSSProperties, TouchEvent } from '@lynx-js/types';
 import { type ReactElement } from 'react';
 import type { TemplateKey, TemplateText } from '../types.js';
@@ -29,6 +30,10 @@ export interface AskHumanCardItem {
     text?: TemplateText;
     /** 是否显示加载状态；为 true 时选项内展示 loading 动画并禁用点击。 */
     loading?: boolean;
+    /** 开放能力类型；`'launchApp'` 用于跳转外部应用。 */
+    openType?: 'launchApp';
+    /** 跳转外部应用的 deeplink URL，只在 `openType="launchApp"` 时有效。 */
+    launchAppUrl?: string;
     /** 箭头展示位置；默认 `'none'` 不展示。 */
     showArrow?: AskHumanCardArrowPosition;
     /** 选项根节点自定义类名。 */
@@ -37,6 +42,10 @@ export interface AskHumanCardItem {
     style?: CSSProperties;
     /** 点击选项时触发。 */
     onClick?: (event?: TouchEvent) => void;
+    /** 跳转外部应用成功时触发，只在 `openType="launchApp"` 时有效。 */
+    onLaunchApp?: (result: LaunchAppResult) => void;
+    /** 跳转外部应用失败时触发，只在 `openType="launchApp"` 时有效。 */
+    onLaunchAppError?: (error: unknown) => void;
 }
 export declare function AskHumanCard(props: AskHumanCardProps): ReactElement;
 //# sourceMappingURL=index.d.ts.map

package/dist/ask-human-card/index.js

@@ -23,7 +23,7 @@ function renderAskHumanCardItem({ item, index, optionBg, arrowColor }) {
     }, item.className)} style={{
         backgroundColor: optionBg,
         ...item.style
-    }} type="default" loading={isLoading} onClick={(event)=>{
+    }} type="default" loading={isLoading} openType={item.openType} launchAppUrl={item.launchAppUrl} onLaunchApp={item.onLaunchApp} onLaunchAppError={item.onLaunchAppError} onClick={(event)=>{
         reportAskHumanCardClick();
         item.onClick?.(event);
     }}>

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export type { TemplateExtraAction, TemplateExtraActionButton, TemplateExtraActio
 export { AskHumanCard, type AskHumanCardArrowPosition, type AskHumanCardItem, type AskHumanCardProps } from './ask-human-card/index.js';
 export { CheckoutCard, type CheckoutCardFeeItem, type CheckoutCardInfoItem, type CheckoutCardProductItem, type CheckoutCardProps } from './checkout-card/index.js';
 export { PriceActionCard, type PriceActionCardInfoRow, type PriceActionCardItem, type PriceActionCardProps } from './price-action-card/index.js';
+export { MapCard, type MapCardMapProps, type MapCardMetaItem, type MapCardMetaTone, type MapCardProps } from './map-card/index.js';
 export { TransitCard, type TransitCardItem, type TransitCardPrice, type TransitCardProps, type TransitCardTag } from './transit-card/index.js';
 export type { TemplateKey, TemplateTagTone, TemplateText } from './types.js';
 export { TicketOrderCard, type TicketOrderCardFeeItem, type TicketOrderCardInfoItem, type TicketOrderCardProps, type TicketOrderCardRouteItem } from './ticket-order-card/index.js';

package/dist/index.js

@@ -2,5 +2,6 @@ export { ContentCard } from "./content-card/index.js";
 export { AskHumanCard } from "./ask-human-card/index.js";
 export { CheckoutCard } from "./checkout-card/index.js";
 export { PriceActionCard } from "./price-action-card/index.js";
+export { MapCard } from "./map-card/index.js";
 export { TransitCard } from "./transit-card/index.js";
 export { TicketOrderCard } from "./ticket-order-card/index.js";

package/dist/map-card/index.d.ts

@@ -0,0 +1,37 @@
+import { type MapProps, type MapRef } from '@byted-doubao-apps/components';
+import type { CSSProperties, TouchEvent } from '@lynx-js/types';
+import { type TemplateCardFooterActionButton, type TemplateCardFooterProps } from '../components/footer/index.js';
+import type { TemplateKey, TemplateText } from '../types.js';
+import './styles.scss';
+export type MapCardMapProps = Omit<MapProps, 'className' | 'style'>;
+export type MapCardMetaTone = 'default' | 'highlight';
+export interface MapCardMetaItem {
+    /** 唯一标识；不传时使用数组下标。 */
+    key?: TemplateKey;
+    /** 辅助信息文案。 */
+    text: TemplateText;
+    /** 文案色调。@defaultValue default */
+    tone?: MapCardMetaTone;
+}
+export interface MapCardProps {
+    /** 地图配置。卡片统一管理地图的宽高和类名。 */
+    mapProps: MapCardMapProps;
+    /** 信息区标题。 */
+    title?: TemplateText;
+    /** 是否展示标题右侧箭头。@defaultValue true */
+    showArrow?: boolean;
+    /** 标题下方的辅助信息，最多展示前两项。 */
+    metaItems?: MapCardMetaItem[];
+    /** 信息区右侧操作，最多展示前两个；双按钮时依次按次按钮、主按钮渲染。 */
+    inlineActions?: TemplateCardFooterActionButton[];
+    /** 底部操作区配置。 */
+    footer?: TemplateCardFooterProps;
+    /** 卡片根节点自定义类名。 */
+    className?: string;
+    /** 卡片根节点自定义样式。 */
+    style?: CSSProperties;
+    /** 点击卡片根节点时触发。 */
+    onClick?: (event: TouchEvent) => void;
+}
+export declare const MapCard: (props: MapCardProps & import("react").RefAttributes<MapRef>) => React.ReactElement | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/map-card/index.js

@@ -0,0 +1,43 @@
+import { Button, Map, useThemeClassName } from "@byted-doubao-apps/components";
+import { clsx } from "clsx";
+import { forwardRef } from "react";
+import { TemplateCardFooter } from "../components/footer/index.js";
+import { Title } from "../primitives/title/index.js";
+import "./styles.css";
+function hasTemplateText(value) {
+    return void 0 !== value && '' !== value;
+}
+function MapCardImpl(props, ref) {
+    const { mapProps, title, showArrow = true, metaItems = [], inlineActions = [], footer, className, style, onClick } = props;
+    const visibleMetaItems = metaItems.filter((item)=>hasTemplateText(item.text)).slice(0, 2);
+    const visibleInlineActions = inlineActions.filter((action)=>null != action.text && action.text.length > 0).slice(0, 2);
+    const hasTitle = hasTemplateText(title);
+    const hasContent = hasTitle || visibleMetaItems.length > 0 || visibleInlineActions.length > 0;
+    return <view className={useThemeClassName(clsx('doubao-map-card', className))} style={style} bindtap={onClick} clip-radius="true">
+      <view className="doubao-map-card__viewport">
+        <Map {...mapProps} ref={ref} className="doubao-map-card__map"/>
+      </view>
+
+      {hasContent ? <view className="doubao-map-card__content">
+          <view className="doubao-map-card__text-content">
+            {hasTitle ? <Title text={title} showArrow={showArrow}/> : null}
+            {visibleMetaItems.length > 0 ? <view className="doubao-map-card__meta">
+                {visibleMetaItems.map((item, index)=><view className="doubao-map-card__meta-entry" key={item.key ?? index}>
+                    {index > 0 ? <text className="doubao-map-card__meta-separator">·</text> : null}
+                    <text className={clsx('doubao-map-card__meta-text', 'highlight' === item.tone && 'doubao-map-card__meta-text--highlight')} text-maxline="1">
+                      {item.text}
+                    </text>
+                  </view>)}
+              </view> : null}
+          </view>
+
+          {visibleInlineActions.length > 0 ? <view className="doubao-map-card__inline-actions">
+              {visibleInlineActions.map((action, index)=><Button className="doubao-map-card__inline-action" key={index} size="mini" type={visibleInlineActions.length > 1 && 0 === index ? 'default' : 'primary'} text={action.text ?? ''} disabled={action.disabled} loading={action.loading} throttle={action.throttle} onClick={action.onClick}/>)}
+            </view> : null}
+        </view> : null}
+
+      <TemplateCardFooter primaryActionButton={footer?.primaryActionButton} secondaryActionButton={footer?.secondaryActionButton}/>
+    </view>;
+}
+const MapCard = forwardRef(MapCardImpl);
+export { MapCard };

package/dist/map-card/styles.css

@@ -0,0 +1,110 @@
+.doubao-map-card {
+  box-sizing: border-box;
+  background-color: var(--bg-base-1);
+  border: 1px solid var(--bg-base-2-overlay);
+  border-radius: 8px;
+  flex-direction: column;
+  align-items: stretch;
+  width: 100%;
+  display: flex;
+  overflow: hidden;
+}
+
+.doubao-map-card__viewport {
+  box-sizing: border-box;
+  border: 1px solid var(--bg-base-2-overlay);
+  flex-shrink: 0;
+  width: 100%;
+  height: 168px;
+  position: relative;
+  overflow: hidden;
+}
+
+.doubao-map-card__map {
+  width: 100%;
+  height: 100%;
+}
+
+.doubao-map-card__content {
+  box-sizing: border-box;
+  background-color: var(--bg-base-1);
+  border-radius: 8px;
+  flex-direction: row;
+  align-items: center;
+  gap: 12px;
+  width: 100%;
+  padding: 12px;
+  display: flex;
+}
+
+.doubao-map-card__text-content {
+  flex-direction: column;
+  flex: 1 1 0;
+  align-items: flex-start;
+  gap: 2px;
+  min-width: 0;
+  display: flex;
+  overflow: hidden;
+}
+
+.doubao-map-card__meta {
+  flex-direction: row;
+  flex-shrink: 0;
+  align-items: center;
+  width: 100%;
+  min-width: 0;
+  height: 22px;
+  display: flex;
+  overflow: hidden;
+}
+
+.doubao-map-card__meta-entry {
+  flex-direction: row;
+  flex: 0 auto;
+  align-items: center;
+  min-width: 0;
+  display: flex;
+  overflow: hidden;
+}
+
+.doubao-map-card__meta-separator {
+  color: var(--neutral-70);
+  flex-shrink: 0;
+  margin: 0 4px;
+  font-family: PingFang SC, sans-serif;
+  font-size: 13px;
+  font-weight: 400;
+  line-height: 1.5;
+}
+
+.doubao-map-card__meta-text {
+  min-width: 0;
+  color: var(--neutral-70);
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-family: PingFang SC, sans-serif;
+  font-size: 13px;
+  font-style: normal;
+  font-weight: 400;
+  line-height: 1.5;
+  overflow: hidden;
+}
+
+.doubao-map-card__meta-text--highlight {
+  color: #ff375f;
+}
+
+.doubao-map-card__inline-actions {
+  flex-direction: row;
+  flex-shrink: 0;
+  align-items: center;
+  gap: 8px;
+  display: flex;
+}
+
+.doubao-map-card__inline-action {
+  width: auto;
+  min-width: 60px;
+  max-width: 100px;
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doubao-dev/template",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "exports": {
     ".": {