@pisell/materials 1.0.1085 → 1.0.1086

package/lib/components/PisellCards/components/TextCard/types.d.ts

@@ -1,277 +0,0 @@
-import { CSSProperties, ReactNode } from 'react';
-import { PisellBasicCardProps } from '../../types';
-/**
- * 样式变体类型
- */
-export declare type TextCardVariant = 'text' | 'filled' | 'outlined' | 'light' | 'gradient' | 'dashed';
-/**
- * 尺寸类型
- */
-export declare type TextCardSize = 'small' | 'default' | 'large';
-/**
- * 宽度模式
- */
-export declare type TextCardWidthMode = 'auto' | 'fixed' | 'full';
-/**
- * 图标配置
- */
-export interface IconConfig {
-    /**
-     * 图标大小（单位：px）
-     */
-    size?: number;
-    /**
-     * 图标颜色
-     */
-    color?: string;
-}
-/**
- * 标签配置
- */
-export interface TagConfig {
-    /**
-     * 标签颜色
-     */
-    color?: string;
-    /**
-     * 标签自定义样式
-     */
-    style?: CSSProperties;
-}
-/**
- * 角标类型
- */
-export declare type BadgeType = 'dot' | 'number' | 'text';
-/**
- * 角标大小
- */
-export declare type BadgeSize = 'small' | 'default';
-/**
- * 角标配置
- */
-export interface BadgeConfig {
-    /**
-     * 角标类型
-     * @default 'dot'
-     */
-    type?: BadgeType;
-    /**
-     * 角标内容（数字或文本）
-     * 当 type 为 'number' 或 'text' 时有效
-     */
-    content?: ReactNode;
-    /**
-     * 角标偏移量 [x, y]
-     * 正数向右/下偏移，负数向左/上偏移
-     */
-    offset?: [number, number];
-    /**
-     * 角标颜色
-     */
-    color?: string;
-    /**
-     * 角标自定义样式
-     */
-    style?: CSSProperties;
-    /**
-     * 角标大小
-     */
-    size?: BadgeSize;
-    /**
-     * 角标是否显示零值
-     */
-    showZero?: boolean;
-    /**
-     * 角标其他属性
-     */
-    [key: string]: any;
-}
-/**
- * 文本配置
- */
-export interface TextConfig {
-    /**
-     * 字体大小（单位：px）
-     */
-    fontSize?: number;
-    /**
-     * 字体粗细
-     */
-    fontWeight?: string | number;
-    /**
-     * 文本颜色
-     */
-    color?: string;
-    /**
-     * 最大显示行数
-     * @default 1
-     */
-    maxLines?: number;
-    /**
-     * 是否显示省略号
-     * @default true
-     */
-    ellipsis?: boolean;
-    /**
-     * 文本对齐方式
-     * @default 'left'
-     */
-    textAlign?: 'left' | 'center' | 'right';
-    flex?: string;
-}
-/**
- * TextCard 组件 Props
- * 基于 PisellBasicCardProps 扩展
- * 注意：重写 onClick 为可选属性
- */
-export interface TextCardProps extends Omit<PisellBasicCardProps, 'onClick'> {
-    /**
-     * 卡片显示的文本内容（必填）
-     */
-    text: ReactNode;
-    /**
-     * 卡片样式变体
-     * @default 'text'
-     */
-    variant?: TextCardVariant;
-    /**
-     * 卡片尺寸
-     * @default 'default'
-     */
-    size?: TextCardSize;
-    /**
-     * 是否可点击
-     * @default true
-     */
-    clickable?: boolean;
-    /**
-     * 前置图标
-     * 支持 ReactNode（如 antd Icon、svg 等）
-     */
-    prefixIcon?: ReactNode;
-    /**
-     * 后置图标
-     * 支持 ReactNode（如 antd Icon、svg 等）
-     */
-    suffixIcon?: ReactNode;
-    /**
-     * 图标配置
-     * 统一配置前置和后置图标的大小和颜色
-     */
-    iconConfig?: IconConfig;
-    /**
-     * 后置标签
-     * 支持 ReactNode（如 antd Tag、Badge 等）
-     */
-    tag?: ReactNode;
-    /**
-     * 标签配置
-     */
-    tagConfig?: TagConfig;
-    /**
-     * 角标配置
-     * 用于显示红点、数字或文本提示
-     */
-    badge?: BadgeConfig;
-    /**
-     * 前置插槽
-     * 用于替换前置图标，优先级高于 prefixIcon
-     */
-    prefixSlot?: ReactNode;
-    /**
-     * 后置插槽
-     * 用于替换后置图标和标签，优先级高于 suffixIcon 和 tag
-     */
-    suffixSlot?: ReactNode;
-    /**
-     * 文本配置
-     * 用于自定义文本样式和显示行为
-     */
-    textConfig?: TextConfig;
-    /**
-     * 宽度模式
-     * - auto: 内容撑满，最大宽度 maxWidth
-     * - fixed: 固定宽度 width
-     * - full: 撑满父容器，最小宽度 28px
-     * @default 'auto'
-     */
-    widthMode?: TextCardWidthMode;
-    /**
-     * 固定宽度值
-     * 当 widthMode='fixed' 时有效
-     */
-    width?: number | string;
-    /**
-     * 最大宽度
-     * 当 widthMode='auto' 时有效
-     * @default 400
-     */
-    maxWidth?: number | string;
-    /**
-     * 点击事件
-     * 当 clickable=true 且不在 disabled/loading 状态时触发
-     * 注意：PisellBasicCardProps 中的 onClick 是必填的，这里重新定义为可选
-     */
-    onClick?: (event: React.MouseEvent<HTMLDivElement>) => void;
-    /**
-     * 自定义渲染函数
-     * 完全自定义组件的渲染内容
-     * 当提供此函数时，组件内置的渲染逻辑将被忽略
-     */
-    render?: (props: TextCardProps) => ReactNode;
-}
-/**
- * TextContent 组件 Props
- * 文本内容子组件
- */
-export interface TextContentProps {
-    /**
-     * 文本内容
-     */
-    text: ReactNode;
-    /**
-     * 文本配置
-     */
-    textConfig?: TextConfig;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-    active?: PisellBasicCardProps['active'];
-}
-/**
- * IconWrapper 组件 Props
- * 图标包装子组件
- */
-export interface IconWrapperProps {
-    /**
-     * 图标内容
-     */
-    icon: ReactNode;
-    /**
-     * 图标配置
-     */
-    config?: IconConfig;
-    /**
-     * 图标位置
-     */
-    position: 'prefix' | 'suffix';
-    /**
-     * 自定义类名
-     */
-    className?: string;
-}
-/**
- * BadgeWrapper 组件 Props
- * 角标包装子组件
- */
-export interface BadgeWrapperProps {
-    /**
-     * 角标配置
-     */
-    badge?: BadgeConfig;
-    /**
-     * 子元素
-     */
-    children: ReactNode;
-}

package/lib/components/PisellCards/index.d.ts

@@ -1,18 +0,0 @@
-/// <reference types="react" />
-import { PisellEntityCard } from '../pisellEntityCard';
-declare const PisellCards: {
-    TabCard: (props: any) => JSX.Element;
-    TextCard: (props: any) => JSX.Element;
-    GraphicTextCard: (props: import("./components/GraphicTextCard").GraphicTextCardProps) => JSX.Element;
-    MultilevelCard: (props: any) => JSX.Element;
-    PisellImageCard: (props: import("./components/PisellImageCard").PisellImageCardProps) => JSX.Element;
-    PisellEntityCard: typeof PisellEntityCard;
-};
-export default PisellCards;
-export type { PisellBasicCardProps } from './types';
-export type { TabCardProps, BadgeConfig } from './components/TabCard/types';
-export type { TextCardProps } from './components/TextCard/types';
-export type { GraphicTextCardProps, GraphicTextCardVariant, GraphicTextCardSize, GraphicConfig, } from './components/GraphicTextCard/types';
-export type { MultilevelCardProps } from './components/MultilevelCard/types';
-export type { PisellImageCardProps, ImageDataSource, ImageFillMode, } from './components/PisellImageCard/types';
-export type { PisellEntityCardProps, EntityCardDensity, EntityCardLayout, EntityCardWidth, EntityCardMediaType, EntityCardMediaConfig, EntityCardSecondaryItem, EntityCardTagItem, EntityCardActionItem, EntityCardTagPosition, } from '../pisellEntityCard';

package/lib/components/PisellContactBrief/PisellContactBrief.d.ts

@@ -1,13 +0,0 @@
-/// <reference types="react" />
-import type { PisellContactBriefCreateButtonProps, PisellContactBriefProps } from './types';
-import './PisellContactBrief.less';
-/**
- * PisellContactBrief 联系人简要卡片
- * 基于 PisellEntityCard 展示姓名、电话、邮箱及扩展字段，右侧编辑图标调起编辑弹窗
- */
-export declare function PisellContactBrief({ name, phone, email, avatar, extraData, extraFields, onSubmit, onDelete, swipeToDelete, layout, showAvatar, showPhone, showEmail, primaryLineClamp, secondaryLineClamp, className, style, hoverStyle, activeStyle, disabledStyle, clickable, disabled, onClick, }: PisellContactBriefProps): JSX.Element;
-/**
- * 新建联系人入口按钮
- * 展示「Add Contact」+ 占位头像 + plus 图标，点击打开新建弹窗
- */
-export declare function PisellContactBriefCreateButton({ extraFields, onCreate, onClick: onClickProp, className, style, }: PisellContactBriefCreateButtonProps): JSX.Element;

package/lib/components/PisellContactBrief/PisellContactBrief.stories.d.ts

@@ -1,31 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import { PisellContactBrief } from './PisellContactBrief';
-declare const meta: Meta<typeof PisellContactBrief>;
-export default meta;
-declare type Story = StoryObj<typeof PisellContactBrief>;
-/** 默认：姓名 + 电话 + 邮箱，横向，有编辑图标 */
-export declare const Default: Story;
-/** 无头像（占位） */
-export declare const NoAvatar: Story;
-/** 有头像 */
-export declare const WithAvatar: Story;
-/** 竖向布局 */
-export declare const Vertical: Story;
-/** 仅姓名 + 电话（无邮箱） */
-export declare const NoEmail: Story;
-/** 仅姓名 + 邮箱（无电话） */
-export declare const NoPhone: Story;
-/** 扩展字段：生日、地址 */
-export declare const WithExtraFields: Story;
-/** 左滑删除 */
-export declare const SwipeToDelete: Story;
-/** 编辑提交回调（仅日志） */
-export declare const WithEditSubmit: Story;
-/** 禁用态 */
-export declare const Disabled: Story;
-/** 主文案行数限制为 1 */
-export declare const PrimaryLineClamp: Story;
-/** 新建联系人按钮（CreateButton） */
-export declare const CreateButtonOnly: Story;
-/** 卡片 + 新建按钮（列表场景） */
-export declare const ListWithCreateButton: Story;

package/lib/components/PisellContactBrief/components/ContactFormModal.d.ts

@@ -1,23 +0,0 @@
-/// <reference types="react" />
-import type { ContactFormValues } from '../types';
-import type { ContactBriefExtraField } from '../types';
-export declare type ContactFormModalMode = 'create' | 'edit';
-export interface ContactFormModalProps {
-    /** 显隐 */
-    visible: boolean;
-    /** 关闭回调 */
-    onCancel: () => void;
-    /** 提交回调（新建时即 onCreate，编辑时即 onSubmit） */
-    onSubmit: (values: ContactFormValues) => void;
-    /** 新建 / 编辑 */
-    mode: ContactFormModalMode;
-    /** 初始值（编辑时传入） */
-    initialValues?: Partial<ContactFormValues>;
-    /** 可增加字段配置，顺序即表单项顺序 */
-    extraFields?: ContactBriefExtraField[];
-}
-/**
- * 联系人新建/编辑弹窗
- * 表单含 Firstname、Lastname、Phone、Email + extraFields，与 Figma 新建/编辑弹窗一致
- */
-export declare function ContactFormModal({ visible, onCancel, onSubmit, mode, initialValues, extraFields, }: ContactFormModalProps): JSX.Element;

package/lib/components/PisellContactBrief/components/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * PisellContactBrief 子组件导出
- */
-export { ContactFormModal } from './ContactFormModal';
-export type { ContactFormModalProps, ContactFormModalMode } from './ContactFormModal';

package/lib/components/PisellContactBrief/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * PisellContactBrief 组件导出
- * 联系人简要卡片 + CreateButton（PisellContactBrief.CreateButton）
- */
-export { PisellContactBrief } from './PisellContactBrief';
-export type { PisellContactBriefProps, PisellContactBriefCreateButtonProps, PisellContactBriefComponent, ContactFormValues, ContactBriefExtraField, } from './types';

package/lib/components/PisellContactBrief/locales.d.ts

@@ -1,55 +0,0 @@
-/**
- * PisellContactBrief 多语言文案
- * 中、英、繁；由业务 locales.init 合并或组件内 init 后使用 locales.getText(key)
- */
-declare const _default: {
-    en: {
-        'pisell.contact.brief.addContact': string;
-        'pisell.contact.brief.edit': string;
-        'pisell.contact.brief.delete': string;
-        'pisell.contact.brief.modal.title.create': string;
-        'pisell.contact.brief.modal.title.edit': string;
-        'pisell.contact.brief.modal.cancel': string;
-        'pisell.contact.brief.modal.save': string;
-        'pisell.contact.brief.modal.field.firstname': string;
-        'pisell.contact.brief.modal.field.lastname': string;
-        'pisell.contact.brief.modal.field.phone': string;
-        'pisell.contact.brief.modal.field.email': string;
-        'pisell.contact.brief.modal.field.phone.placeholder': string;
-        'pisell.contact.brief.modal.field.email.placeholder': string;
-        'pisell.contact.brief.modal.field.required': string;
-    };
-    'zh-CN': {
-        'pisell.contact.brief.addContact': string;
-        'pisell.contact.brief.edit': string;
-        'pisell.contact.brief.delete': string;
-        'pisell.contact.brief.modal.title.create': string;
-        'pisell.contact.brief.modal.title.edit': string;
-        'pisell.contact.brief.modal.cancel': string;
-        'pisell.contact.brief.modal.save': string;
-        'pisell.contact.brief.modal.field.firstname': string;
-        'pisell.contact.brief.modal.field.lastname': string;
-        'pisell.contact.brief.modal.field.phone': string;
-        'pisell.contact.brief.modal.field.email': string;
-        'pisell.contact.brief.modal.field.phone.placeholder': string;
-        'pisell.contact.brief.modal.field.email.placeholder': string;
-        'pisell.contact.brief.modal.field.required': string;
-    };
-    'zh-HK': {
-        'pisell.contact.brief.addContact': string;
-        'pisell.contact.brief.edit': string;
-        'pisell.contact.brief.delete': string;
-        'pisell.contact.brief.modal.title.create': string;
-        'pisell.contact.brief.modal.title.edit': string;
-        'pisell.contact.brief.modal.cancel': string;
-        'pisell.contact.brief.modal.save': string;
-        'pisell.contact.brief.modal.field.firstname': string;
-        'pisell.contact.brief.modal.field.lastname': string;
-        'pisell.contact.brief.modal.field.phone': string;
-        'pisell.contact.brief.modal.field.email': string;
-        'pisell.contact.brief.modal.field.phone.placeholder': string;
-        'pisell.contact.brief.modal.field.email.placeholder': string;
-        'pisell.contact.brief.modal.field.required': string;
-    };
-};
-export default _default;

package/lib/components/PisellContactBrief/types.d.ts

@@ -1,82 +0,0 @@
-import type React from 'react';
-import type { PisellBaseCardProps } from '../pisellBaseCard/types';
-import type { EntityCardLayout } from '../pisellEntityCard/types';
-/**
- * 联系人表单值（新建/编辑弹窗提交结构）
- * 基础字段 name、phone、email + 扩展字段（与 extraFields[].key 对应）扁平在同一对象
- */
-export interface ContactFormValues {
-    /** 姓名 */
-    name: string;
-    /** 电话 */
-    phone?: string;
-    /** 邮箱 */
-    email?: string;
-    /** 扩展字段及任意表单项，key 与 extraFields 配置对应 */
-    [key: string]: string | undefined;
-}
-/**
- * 可增加字段配置项
- * 顺序即卡片展示与弹窗表单项顺序
- */
-export interface ContactBriefExtraField {
-    /** 字段 key，与 extraData / ContactFormValues 对应 */
-    key: string;
-    /** 展示与表单项 label（可配合多语言） */
-    label: string;
-}
-/**
- * PisellContactBrief 组件 Props
- * 基于 PisellEntityCard 展示联系人简要信息，内置编辑弹窗
- */
-export interface PisellContactBriefProps extends Pick<PisellBaseCardProps, 'className' | 'style' | 'hoverStyle' | 'activeStyle' | 'disabledStyle' | 'clickable' | 'disabled' | 'onClick'> {
-    /** 联系人姓名（主文案） */
-    name: string;
-    /** 电话（副标题，与姓名同行） */
-    phone?: string;
-    /** 邮箱（次级文案） */
-    email?: string;
-    /** 头像图片地址，不传则显示默认占位 */
-    avatar?: string;
-    /** 扩展字段值，key 与 extraFields 配置对应 */
-    extraData?: Record<string, string>;
-    /** 可增加字段配置，顺序即展示与表单顺序 */
-    extraFields?: ContactBriefExtraField[];
-    /** 编辑弹窗提交回调 */
-    onSubmit?: (values: ContactFormValues) => void;
-    /** 左滑删除回调（透传 Entity Card） */
-    onDelete?: () => void;
-    /** 是否开启左滑删除 @default false */
-    swipeToDelete?: boolean;
-    /** 布局方向 @default 'horizontal' */
-    layout?: EntityCardLayout;
-    /** 是否显示头像 @default true */
-    showAvatar?: boolean;
-    /** 是否显示电话 @default true */
-    showPhone?: boolean;
-    /** 是否显示邮箱 @default true */
-    showEmail?: boolean;
-    /** 主文案行数限制 */
-    primaryLineClamp?: number;
-    /** 次级文案行数限制 */
-    secondaryLineClamp?: number;
-}
-/**
- * PisellContactBrief.CreateButton 组件 Props
- * 点击后打开新建联系人弹窗
- */
-export interface PisellContactBriefCreateButtonProps extends Pick<PisellBaseCardProps, 'className' | 'style'> {
-    /** 可增加字段配置，与卡片一致，弹窗内表单项与之对应 */
-    extraFields?: ContactBriefExtraField[];
-    /** 新建弹窗提交回调，调用方保存数据后可更新列表 */
-    onCreate?: (values: ContactFormValues) => void;
-    /** 自定义点击行为；不传则使用内置打开新建弹窗 */
-    onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;
-}
-/**
- * 复合组件类型：PisellContactBrief + CreateButton
- */
-export interface PisellContactBriefComponent {
-    (props: PisellContactBriefProps): React.ReactElement;
-    CreateButton: React.ComponentType<PisellContactBriefCreateButtonProps>;
-}

package/lib/components/PisellLayouts/index.d.ts

@@ -1,38 +0,0 @@
-/**
- * PisellLayouts 命名空间
- * 布局组件集合
- *
- * @example
- * import { PisellLayouts } from '@pisell/materials';
- *
- * <PisellLayouts.BasicGrid columns={3} gap={16}>
- *   {items.map(item => <Card key={item.id} {...item} />)}
- * </PisellLayouts.BasicGrid>
- *
- * <PisellLayouts.ScrollView direction="horizontal">
- *   <Content />
- * </PisellLayouts.ScrollView>
- */
-/// <reference types="react" />
-declare const PisellLayouts: {
-    BasicGrid: <T>(props: import("../PisellBasicGrid").PisellBasicGridProps<T>) => JSX.Element;
-    ScrollView: import("react").ForwardRefExoticComponent<Omit<import("../PisellScrollView").PisellScrollViewProps, "ref"> & import("react").RefAttributes<import("../PisellScrollView").PisellScrollViewRef>>;
-    FloorMapLayout: <T_1 extends import("../pisellFloorMapLayout").FloorMapItemBase = import("../pisellFloorMapLayout").FloorMapItemBase>(props: import("../pisellFloorMapLayout").PisellFloorMapLayoutProps<T_1> & {
-        ref?: import("react").Ref<import("../pisellFloorMapLayout").PisellFloorMapLayoutRef> | undefined;
-    }) => import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>>;
-    Layout: import("../pisellLayout").CompoundedComponent;
-    Content: import("react").FC<import("../pisellLayout/content").PisellContentProps>;
-    Footer: import("react").FC<import("../pisellLayout/footer").PisellFooterProps>;
-    Header: import("react").FC<import("../pisellLayout/header").PisellHeaderProps>;
-    Sider: import("react").FC<import("../pisellLayout/sider").PisellSiderProps>;
-    Container: <T_2 extends import("../pisellContainer").RenderType>(props: import("../pisellContainer").PisellContainerProps<T_2>) => any;
-    Row: (props: import("../pisellRow").PisellRowProps) => JSX.Element;
-    ViewGrid: import("react").FC<import("../pisellViewGrid").PisellViewGridProps>;
-};
-export default PisellLayouts;
-export type { PisellBasicGridProps } from '../PisellBasicGrid';
-export type { PisellScrollViewProps } from '../PisellScrollView';
-export type { PisellFloorMapLayoutProps, PisellFloorMapLayoutRef, FloorMapFullscreenMode, FloorMapLayoutContextValue, FloorMapLayoutProviderProps, } from '../pisellFloorMapLayout';
-export { FloorMapLayoutProvider, useFloorMapLayoutContext, EMPTY_FLOOR_MAP_LAYOUT_CONTEXT, mergeFloorMapLayoutPropsFromContext, } from '../pisellFloorMapLayout';
-export type { PisellLayoutProps, CompoundedComponent } from '../pisellLayout';
-export type { PisellRowProps } from '../pisellRow';

package/lib/components/PisellSuperTabs/PisellSuperTabs.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-import './PisellSuperTabs.less';
-import type { PisellSuperTabsProps } from './types';
-interface PisellSuperTabsRef {
-    scrollItemByRowKey: (key: string) => void;
-}
-declare const _default: React.ForwardRefExoticComponent<PisellSuperTabsProps<unknown> & React.RefAttributes<PisellSuperTabsRef>>;
-export default _default;

package/lib/components/PisellSuperTabs/hooks/useTabsState.d.ts

@@ -1,7 +0,0 @@
-import { UseTabsStateParams, UseTabsStateReturn } from '../types';
-/**
- * Tabs 状态管理 Hook
- * @description 处理受控/非受控模式的状态管理
- * @template T - 数据项类型
- */
-export declare const useTabsState: <T = any>(params: UseTabsStateParams<T>) => UseTabsStateReturn<T>;