@doubao-dev/template 0.0.42 → 0.1.1

package/README.md

@@ -51,7 +51,7 @@ export default function ProductCard() {
 
 ## Primitives
 
-`primitives` 是模板体系中的可组合业务单元，不包含完整卡片外壳。`Title`、`Tag`、`Price`、后续的 `Play` 等单元统一通过该子入口导入。
+`primitives` 是模板体系中的可组合业务单元，不包含完整卡片外壳。`Title`、`Tag`、`Icon`、`OptionGroup`、`Price`、后续的 `Play` 等单元统一通过该子入口导入。
 
 ### Title
 
@@ -96,6 +96,69 @@ import { Tag } from '@doubao-dev/template/primitives';
 - 标签内容不会收缩或截断；业务容器负责测量或通过换行裁切隐藏放不下的整枚标签，不能只裁切标签文字。
 - `className` 和 `style` 可用于样式定制。
 
+### Icon
+
+图标组件，通过名称选择模板体系提供的图标。
+
+```tsx
+import { Icon } from '@doubao-dev/template/primitives';
+
+<Icon name="add" />
+```
+
+说明：
+
+- `name` 当前仅支持 `add`。
+- 默认尺寸为 14px × 14px。
+- `className` 和 `style` 可用于调整图标尺寸和布局；当前 `add` 图标使用 `neutral-50` 并自动适配主题。
+
+### OptionGroup
+
+选项集合组件，用于座席、乘车人等选择场景，统一管理选项布局、换行和选择状态。
+
+```tsx
+import { useState } from '@byted-lynx/react';
+import { OptionGroup } from '@doubao-dev/template/primitives';
+
+const [seatValue, setSeatValue] = useState<string | number>('second');
+
+<OptionGroup
+  size="lg"
+  columns={3}
+  items={[
+    { value: 'second', title: '二等座', subtitle: '¥38.5 有票' },
+    { value: 'first', title: '一等座', subtitle: '¥60 有票' },
+    { value: 'business', title: '商务座', subtitle: '¥130 16张' },
+    { value: 'standing', title: '无座', subtitle: '¥38.5 有票' }
+  ]}
+  value={seatValue}
+  onChange={(nextValue) => setSeatValue(nextValue)}
+/>
+
+const [passengerValues, setPassengerValues] = useState<Array<string | number>>(['wang']);
+
+<OptionGroup
+  selectionMode="multiple"
+  maxSelected={2}
+  items={[
+    { value: 'wang', title: '王一山' },
+    { value: 'zheng', title: '郑天' },
+    { value: 'add', title: '添加', icon: 'add' }
+  ]}
+  value={passengerValues}
+  onChange={(nextValues) => setPassengerValues(nextValues)}
+/>
+```
+
+说明：
+
+- `items` 是唯一的选项内容入口，不支持 `children`；每项使用唯一的 `value` 标识，并可配置 `title`、`disabled` 和独立 `onClick`。
+- `size` 支持 `md | lg`，默认是 `md`；`md` 高 44px、由内容撑开并自动换行，支持 `icon`；`lg` 高 62px、按栏等分并自动换行，支持 `subtitle`。
+- `columns` 仅用于 `lg`，默认每行 3 栏，选项间距固定为 8px；最后一行的选项保持单栏宽度。
+- `selectionMode` 默认是 `single`，此时 `value` 和 `onChange` 使用单个值；传 `multiple` 时使用值数组，并可通过 `maxSelected={2}` 限制为双选；达到上限后点击未选项不会触发 `onChange`，但仍会触发该 item 的 `onClick`，已选项仍可取消。
+- 用户点击选项时，组件先计算新选择并触发 `onChange`，再触发该 item 的 `onClick`；禁用项不触发事件。
+- `className` 和 `style` 只作用于集合根节点，单项样式由模板统一管理。
+
 ### Price
 
 价格展示组件，用于卡片内容中的金额、币种、前后缀、辅助信息和原价排版。`Price` 是业务展示组件，不包含卡片外壳。
@@ -119,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.0.42/assets/content-card.png" alt="ContentCard 示例" width="400" />
+<img src="https://unpkg.com/@doubao-dev/template@0.1.1/assets/content-card.png" alt="ContentCard 示例" width="400" />
 
 通用列表卡，由标题栏、列表内容和底部操作区组成，适合商品、服务、内容入口等可重复条目。
 
@@ -163,7 +268,7 @@ import { ContentCard } from '@doubao-dev/template';
 
 ## PriceActionCard
 
-<img src="https://unpkg.com/@doubao-dev/template@0.0.42/assets/price-action-card.png" alt="PriceActionCard 示例" width="400" />
+<img src="https://unpkg.com/@doubao-dev/template@0.1.1/assets/price-action-card.png" alt="PriceActionCard 示例" width="400" />
 
 价格操作卡，由多条"价格 + 信息 + 右侧按钮"组成，适合报价、权益、服务方案等结果列表。
 
@@ -196,7 +301,7 @@ import { PriceActionCard } from '@doubao-dev/template';
 
 ## CheckoutCard
 
-<img src="https://unpkg.com/@doubao-dev/template@0.0.42/assets/checkout-card.png" alt="CheckoutCard 示例" width="400" />
+<img src="https://unpkg.com/@doubao-dev/template@0.1.1/assets/checkout-card.png" alt="CheckoutCard 示例" width="400" />
 
 通用提单卡，由商品摘要、提单信息、费用汇总和底部操作区组成，适合下单确认、支付确认等场景。
 
@@ -247,7 +352,7 @@ import { CheckoutCard } from '@doubao-dev/template';
 
 ## TicketOrderCard
 
-<img src="https://unpkg.com/@doubao-dev/template@0.0.42/assets/ticket-checkout-card.png" alt="TicketOrderCard 示例" width="400" />
+<img src="https://unpkg.com/@doubao-dev/template@0.1.1/assets/ticket-checkout-card.png" alt="TicketOrderCard 示例" width="400" />
 
 > **已废弃：** 请使用 `CheckoutCard`。`TicketOrderCard` 仅为兼容现有代码保留。
 
@@ -294,7 +399,7 @@ import { TicketOrderCard } from '@doubao-dev/template';
 
 ## TransitCard
 
-<img src="https://unpkg.com/@doubao-dev/template@0.0.42/assets/transit-card.png" alt="TransitCard 示例" width="400" />
+<img src="https://unpkg.com/@doubao-dev/template@0.1.1/assets/transit-card.png" alt="TransitCard 示例" width="400" />
 
 交通票务列表卡，由多条出发、中转、到达和价格信息组成，适合展示机票、火车票、大巴等推荐列表。
 
@@ -342,7 +447,7 @@ import { TransitCard } from '@doubao-dev/template';
 
 ## AskHumanCard
 
-<img src="https://unpkg.com/@doubao-dev/template@0.0.42/assets/ask-human-card.png" alt="AskHumanCard 示例" width="400" />
+<img src="https://unpkg.com/@doubao-dev/template@0.1.1/assets/ask-human-card.png" alt="AskHumanCard 示例" width="400" />
 
 人工确认选项卡，由一组选项组成，适合让用户在多个候选项中确认选择。
 

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/dist/primitives/icon/index.d.ts

@@ -0,0 +1,6 @@
+import type { IconName, IconProps } from './types.js';
+import './styles.scss';
+export type { IconName, IconProps } from './types.js';
+export declare function isIconSupported(name: string): name is IconName;
+export declare function Icon({ name, className, style }: IconProps): any;
+//# sourceMappingURL=index.d.ts.map

package/dist/primitives/icon/index.js

@@ -0,0 +1,25 @@
+import { useTheme } from "@byted-doubao-apps/components";
+import { clsx } from "clsx";
+import "./styles.css";
+function getAddIconContent(color) {
+    return `<svg width="14" height="14" viewBox="0 0 14 14" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g transform="translate(1.16667 1.10835)">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M5.83333 2.80481e-08C6.18771 4.35387e-08 6.475 0.287284 6.475 0.641667L6.475 11.1417C6.475 11.496 6.18771 11.7833 5.83333 11.7833C5.47895 11.7833 5.19166 11.496 5.19166 11.1417L5.19166 0.641667C5.19166 0.287284 5.47895 1.25576e-08 5.83333 2.80481e-08Z" fill="${color}"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M11.7833 5.95C11.7833 6.30439 11.496 6.59167 11.1417 6.59167L0.641665 6.59167C0.287284 6.59167 -3.68276e-07 6.30439 -3.37294e-07 5.95C-3.06313e-07 5.59562 0.287284 5.30834 0.641665 5.30834L11.1417 5.30834C11.496 5.30834 11.7833 5.59562 11.7833 5.95Z" fill="${color}"/>
+</g>
+</svg>`;
+}
+const ICON_CONTENT_GETTERS = {
+    add: getAddIconContent
+};
+function isIconSupported(name) {
+    return Object.prototype.hasOwnProperty.call(ICON_CONTENT_GETTERS, name);
+}
+function Icon({ name, className, style }) {
+    const theme = useTheme();
+    const getContent = ICON_CONTENT_GETTERS[name];
+    if (!getContent) return null;
+    const color = 'dark' === theme ? '#777777' : '#999999';
+    return <svg className={clsx('doubao-icon', className)} style={style} content={getContent(color)}/>;
+}
+export { Icon, isIconSupported };

package/dist/primitives/icon/styles.css

@@ -0,0 +1,7 @@
+.doubao-icon {
+  flex-shrink: 0;
+  width: 14px;
+  height: 14px;
+  display: block;
+}
+

package/dist/primitives/icon/types.d.ts

@@ -0,0 +1,11 @@
+import type { CSSProperties } from '@lynx-js/types';
+export type IconName = 'add';
+export interface IconProps {
+    /** 图标名称。 */
+    name: IconName;
+    /** 组件类名。 */
+    className?: string;
+    /** 组件样式。 */
+    style?: CSSProperties;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/primitives/index.d.ts

@@ -1,3 +1,5 @@
+export { Icon, type IconName, type IconProps } from './icon/index.js';
+export { OptionGroup, type OptionGroupItem, type OptionGroupLargeItem, type OptionGroupMediumItem, type OptionGroupProps, type OptionGroupSize, type OptionGroupText, type OptionGroupValue } from './option-group/index.js';
 export { Price, type PricePrefixTone, type PriceProps, type PriceTone, type PriceValue } from './price/index.js';
 export { Tag, type TagProps, type TagTone, type TagValue } from './tag/index.js';
 export { Title, type TitleMaxLines, type TitleProps, type TitleValue } from './title/index.js';

package/dist/primitives/index.js

@@ -1,3 +1,5 @@
+export { Icon } from "./icon/index.js";
+export { OptionGroup } from "./option-group/index.js";
 export { Price } from "./price/index.js";
 export { Tag } from "./tag/index.js";
 export { Title } from "./title/index.js";

package/dist/primitives/option-group/index.d.ts

@@ -0,0 +1,5 @@
+import type { OptionGroupProps } from './types.js';
+import './styles.scss';
+export type { OptionGroupItem, OptionGroupLargeItem, OptionGroupMediumItem, OptionGroupProps, OptionGroupSize, OptionGroupText, OptionGroupValue } from './types.js';
+export declare function OptionGroup(props: OptionGroupProps): any;
+//# sourceMappingURL=index.d.ts.map

package/dist/primitives/option-group/index.js

@@ -0,0 +1,90 @@
+import { useThemeClassName } from "@byted-doubao-apps/components";
+import { clsx } from "clsx";
+import { Icon, isIconSupported } from "../icon/index.js";
+import "./styles.css";
+const OPTION_GAP = 8;
+const DEFAULT_COLUMNS = 3;
+const COLUMN_ROUNDING_TOLERANCE = 0.5;
+function resolveColumns(columns) {
+    return null != columns && Number.isFinite(columns) && columns >= 1 ? Math.floor(columns) : DEFAULT_COLUMNS;
+}
+function getLargeOptionStyle(columns) {
+    const reservedWidth = (columns - 1) * OPTION_GAP + COLUMN_ROUNDING_TOLERANCE;
+    const width = `calc((100% - ${reservedWidth}px) / ${columns})`;
+    return {
+        width,
+        flexBasis: width
+    };
+}
+function isSelected(props, value) {
+    if ('multiple' === props.selectionMode) return props.value?.includes(value) ?? false;
+    return props.value === value;
+}
+function handleOptionClick(props, item, event) {
+    if ('multiple' === props.selectionMode) {
+        const currentValue = props.value ?? [];
+        const selected = currentValue.includes(item.value);
+        const maxSelected = null != props.maxSelected && Number.isFinite(props.maxSelected) && props.maxSelected >= 1 ? Math.floor(props.maxSelected) : void 0;
+        if (selected) props.onChange?.(currentValue.filter((value)=>value !== item.value), item, event);
+        else if (null == maxSelected || currentValue.length < maxSelected) props.onChange?.([
+            ...currentValue,
+            item.value
+        ], item, event);
+    } else if (props.value !== item.value) props.onChange?.(item.value, item, event);
+    item.onClick?.(event);
+}
+function MediumOptionItemView({ item, selected, onClick }) {
+    const hasIcon = Boolean(item.icon) && isIconSupported(item.icon ?? '');
+    return <view className={clsx('doubao-option-group__item', 'doubao-option-group__item--size-md', {
+        'doubao-option-group__item--selected': selected,
+        'doubao-option-group__item--disabled': item.disabled,
+        'doubao-option-group__item--with-icon': hasIcon
+    })} bindtap={item.disabled ? void 0 : onClick}>
+      {hasIcon && item.icon ? <Icon className="doubao-option-group__icon" name={item.icon}/> : null}
+      <view className="doubao-option-group__content">
+        <text className="doubao-option-group__title" text-maxline="1">
+          {item.title}
+        </text>
+      </view>
+    </view>;
+}
+function LargeOptionItemView({ item, selected, style, onClick }) {
+    return <view className={clsx('doubao-option-group__item', 'doubao-option-group__item--size-lg', {
+        'doubao-option-group__item--selected': selected,
+        'doubao-option-group__item--disabled': item.disabled
+    })} style={style} bindtap={item.disabled ? void 0 : onClick}>
+      <view className="doubao-option-group__content">
+        <text className="doubao-option-group__title" text-maxline="1">
+          {item.title}
+        </text>
+        {void 0 !== item.subtitle ? <text className="doubao-option-group__subtitle" text-maxline="1">
+            {item.subtitle}
+          </text> : null}
+      </view>
+    </view>;
+}
+function renderOptionViews(props) {
+    if ('lg' === props.size) {
+        const optionStyle = getLargeOptionStyle(resolveColumns(props.columns));
+        return props.items.map((item)=>{
+            const selected = isSelected(props, item.value);
+            const onClick = (event)=>handleOptionClick(props, item, event);
+            return <LargeOptionItemView key={item.value} item={item} selected={selected} style={optionStyle} onClick={onClick}/>;
+        });
+    }
+    return props.items.map((item)=>{
+        const selected = isSelected(props, item.value);
+        const onClick = (event)=>handleOptionClick(props, item, event);
+        return <MediumOptionItemView key={item.value} item={item} selected={selected} onClick={onClick}/>;
+    });
+}
+function OptionGroup(props) {
+    const { className, style } = props;
+    const size = props.size ?? 'md';
+    const themedClassName = useThemeClassName(clsx('doubao-option-group', `doubao-option-group--size-${size}`, className));
+    const optionViews = renderOptionViews(props);
+    return <view className={themedClassName} style={style}>
+      {optionViews}
+    </view>;
+}
+export { OptionGroup };

package/dist/primitives/option-group/styles.css

@@ -0,0 +1,98 @@
+.doubao-option-group {
+  box-sizing: border-box;
+  flex-flow: wrap;
+  align-items: center;
+  gap: 8px;
+  width: 100%;
+  min-width: 0;
+  display: flex;
+}
+
+.doubao-option-group--size-lg {
+  align-items: flex-start;
+}
+
+.doubao-option-group__item {
+  box-sizing: border-box;
+  background-color: var(--bg-base-2-overlay);
+  border: .5px solid #0000;
+  border-radius: 8px;
+  justify-content: center;
+  align-items: center;
+  min-width: 0;
+  display: flex;
+  overflow: hidden;
+}
+
+.doubao-option-group__item--size-md {
+  width: max-content;
+  max-width: 100%;
+  height: 44px;
+  padding: 12px 16px;
+}
+
+.doubao-option-group__item--size-lg {
+  border-width: 1px;
+  flex-grow: 0;
+  flex-shrink: 0;
+  height: 62px;
+  padding: 12px 4px;
+}
+
+.doubao-option-group__item--with-icon {
+  gap: 4px;
+  padding-left: 12px;
+}
+
+.doubao-option-group__item--selected {
+  background-color: var(--bg-base-1);
+  border-color: var(--primary-50);
+  background-image: linear-gradient(#0066ff0f, #0066ff0f);
+}
+
+.doubao-option-group__item--disabled {
+  opacity: .3;
+}
+
+.doubao-option-group__icon {
+  width: 14px;
+  height: 14px;
+}
+
+.doubao-option-group__content {
+  flex-direction: column;
+  align-items: center;
+  gap: 2px;
+  min-width: 0;
+  max-width: 100%;
+  display: flex;
+}
+
+.doubao-option-group__title, .doubao-option-group__subtitle {
+  text-align: center;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  min-width: 0;
+  max-width: 100%;
+  font-family: PingFang SC, -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Helvetica Neue, sans-serif;
+  font-size: 13px;
+  font-style: normal;
+  line-height: 18px;
+  display: block;
+  overflow: hidden;
+}
+
+.doubao-option-group__title {
+  color: var(--neutral-100);
+  font-weight: 500;
+}
+
+.doubao-option-group__subtitle {
+  color: var(--neutral-70);
+  font-weight: 400;
+}
+
+.doubao-option-group__item--size-lg .doubao-option-group__content, .doubao-option-group__item--size-lg .doubao-option-group__title, .doubao-option-group__item--size-lg .doubao-option-group__subtitle {
+  width: 100%;
+}
+

package/dist/primitives/option-group/types.d.ts

@@ -0,0 +1,71 @@
+import type { CSSProperties, TouchEvent } from '@lynx-js/types';
+import type { IconName } from '../icon/index.js';
+export type OptionGroupValue = string | number;
+export type OptionGroupText = string | number;
+export type OptionGroupSize = 'md' | 'lg';
+interface OptionGroupItemCommon {
+    /** 选项唯一值。 */
+    value: OptionGroupValue;
+    /** 选项标题。 */
+    title: OptionGroupText;
+    /** 是否禁用。@defaultValue false */
+    disabled?: boolean;
+    /** 点击当前选项时触发。 */
+    onClick?: (event: TouchEvent) => void;
+}
+export interface OptionGroupMediumItem extends OptionGroupItemCommon {
+    /** 标题前图标名称，由 Icon Primitive 解析。 */
+    icon?: IconName;
+    subtitle?: never;
+}
+export interface OptionGroupLargeItem extends OptionGroupItemCommon {
+    /** 第二行辅助信息。 */
+    subtitle?: OptionGroupText;
+    icon?: never;
+}
+export type OptionGroupItem = OptionGroupMediumItem | OptionGroupLargeItem;
+interface OptionGroupCommonProps {
+    /** 组件类名。 */
+    className?: string;
+    /** 组件样式。 */
+    style?: CSSProperties;
+}
+interface OptionGroupMediumLayoutProps extends OptionGroupCommonProps {
+    /** 选项尺寸。@defaultValue 'md' */
+    size?: 'md';
+    /** 中尺寸选项数据。 */
+    items: OptionGroupMediumItem[];
+    columns?: never;
+}
+interface OptionGroupLargeLayoutProps extends OptionGroupCommonProps {
+    /** 选项尺寸。 */
+    size: 'lg';
+    /** 大尺寸选项数据。 */
+    items: OptionGroupLargeItem[];
+    /** 每行展示栏数。@defaultValue 3 */
+    columns?: number;
+}
+interface OptionGroupSingleSelectionProps {
+    /** 选择模式。@defaultValue 'single' */
+    selectionMode?: 'single';
+    /** 当前选中的选项值。 */
+    value?: OptionGroupValue;
+    maxSelected?: never;
+    /** 选中项变化时触发。 */
+    onChange?: (value: OptionGroupValue, item: OptionGroupItem, event: TouchEvent) => void;
+}
+interface OptionGroupMultipleSelectionProps {
+    /** 多选模式。 */
+    selectionMode: 'multiple';
+    /** 当前选中的选项值。 */
+    value?: OptionGroupValue[];
+    /** 最大选择数量；双选时传 2。 */
+    maxSelected?: number;
+    /** 选中项变化时触发。 */
+    onChange?: (value: OptionGroupValue[], item: OptionGroupItem, event: TouchEvent) => void;
+}
+type OptionGroupLayoutProps = OptionGroupMediumLayoutProps | OptionGroupLargeLayoutProps;
+type OptionGroupSelectionProps = OptionGroupSingleSelectionProps | OptionGroupMultipleSelectionProps;
+export type OptionGroupProps = OptionGroupLayoutProps & OptionGroupSelectionProps;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/package.json

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