@doubao-dev/template 0.0.42 → 0.1.0

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` 是业务展示组件，不包含卡片外壳。
@@ -121,7 +184,7 @@ import { Price } from '@doubao-dev/template/primitives';
 
 ## 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.0/assets/content-card.png" alt="ContentCard 示例" width="400" />
 
 通用列表卡，由标题栏、列表内容和底部操作区组成，适合商品、服务、内容入口等可重复条目。
 
@@ -163,7 +226,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.0/assets/price-action-card.png" alt="PriceActionCard 示例" width="400" />
 
 价格操作卡，由多条"价格 + 信息 + 右侧按钮"组成，适合报价、权益、服务方案等结果列表。
 
@@ -196,7 +259,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.0/assets/checkout-card.png" alt="CheckoutCard 示例" width="400" />
 
 通用提单卡，由商品摘要、提单信息、费用汇总和底部操作区组成，适合下单确认、支付确认等场景。
 
@@ -247,7 +310,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.0/assets/ticket-checkout-card.png" alt="TicketOrderCard 示例" width="400" />
 
 > **已废弃：** 请使用 `CheckoutCard`。`TicketOrderCard` 仅为兼容现有代码保留。
 
@@ -294,7 +357,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.0/assets/transit-card.png" alt="TransitCard 示例" width="400" />
 
 交通票务列表卡，由多条出发、中转、到达和价格信息组成，适合展示机票、火车票、大巴等推荐列表。
 
@@ -342,7 +405,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.0/assets/ask-human-card.png" alt="AskHumanCard 示例" width="400" />
 
 人工确认选项卡，由一组选项组成，适合让用户在多个候选项中确认选择。
 

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.0",
   "type": "module",
   "exports": {
     ".": {