@pisell/materials 6.3.25 → 6.3.27

package/lib/components/pisellSingleSelect/components/ReadOnlyView.js

@@ -0,0 +1,74 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellSingleSelect/components/ReadOnlyView.tsx
+var ReadOnlyView_exports = {};
+__export(ReadOnlyView_exports, {
+  default: () => ReadOnlyView_default
+});
+module.exports = __toCommonJS(ReadOnlyView_exports);
+var import_react = __toESM(require("react"));
+var import_classnames = __toESM(require("classnames"));
+var import_utils = require("@pisell/utils");
+var ReadOnlyView = (props) => {
+  const {
+    value,
+    options,
+    label,
+    required,
+    className,
+    style
+  } = props;
+  const selectedOption = (0, import_react.useMemo)(
+    () => value !== null && value !== void 0 ? (0, import_utils.findOptionByValue)(value, options) : void 0,
+    [value, options]
+  );
+  return /* @__PURE__ */ import_react.default.createElement(
+    "div",
+    {
+      className: (0, import_classnames.default)(
+        "pisell-single-select-wrapper",
+        "pisell-single-select-readonly",
+        className
+      ),
+      style
+    },
+    label && /* @__PURE__ */ import_react.default.createElement(
+      "label",
+      {
+        className: (0, import_classnames.default)("pisell-single-select-label", {
+          "pisell-single-select-label-required": required
+        })
+      },
+      label
+    ),
+    /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-single-select-readonly-display" }, selectedOption ? /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, selectedOption.icon && /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-single-select-readonly-icon" }, selectedOption.icon), /* @__PURE__ */ import_react.default.createElement("span", null, selectedOption.label)) : /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-single-select-readonly-empty" }, "-"))
+  );
+};
+ReadOnlyView.displayName = "PisellSingleSelectReadOnlyView";
+var ReadOnlyView_default = ReadOnlyView;

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

@@ -0,0 +1,6 @@
+/**
+ * PisellSingleSelect 组件导出
+ */
+export { default as PisellSingleSelect } from './PisellSingleSelect';
+export type { PisellSingleSelectProps, SingleSelectRef, EditViewProps, DisabledViewProps, ReadOnlyViewProps, } from './types';
+export type { SelectOption, FilterOptionFunc, SortDirection, SelectState, } from './types';

package/lib/components/pisellSingleSelect/index.js

@@ -0,0 +1,39 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellSingleSelect/index.tsx
+var pisellSingleSelect_exports = {};
+__export(pisellSingleSelect_exports, {
+  PisellSingleSelect: () => import_PisellSingleSelect.default
+});
+module.exports = __toCommonJS(pisellSingleSelect_exports);
+var import_PisellSingleSelect = __toESM(require("./PisellSingleSelect"));
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PisellSingleSelect
+});

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

@@ -0,0 +1,92 @@
+import type { BaseSelectProps, SelectOption } from '@pisell/utils';
+/**
+ * PisellSingleSelect 组件 Props 类型定义
+ *
+ * 继承 BaseSelectProps，添加单选特有的配置
+ * @template T 选项值的类型，默认为 string | number
+ */
+export interface PisellSingleSelectProps<T = string | number> extends BaseSelectProps<T> {
+    /**
+     * 受控模式：当前选中值
+     */
+    value?: T | null;
+    /**
+     * 非受控模式：默认选中值
+     */
+    defaultValue?: T;
+    /**
+     * 值变化回调
+     * @param value 新的选中值
+     * @param option 选中的选项对象（如果值为 null 则 option 也为 null）
+     */
+    onChange?: (value: T | null, option: SelectOption<T> | null) => void;
+    /**
+     * ARIA 标签
+     */
+    'aria-label'?: string;
+    /**
+     * ARIA 是否必填
+     */
+    'aria-required'?: boolean;
+    /**
+     * ARIA 是否无效
+     */
+    'aria-invalid'?: boolean;
+    /**
+     * ARIA 描述关联 ID
+     */
+    'aria-describedby'?: string;
+}
+/**
+ * PisellSingleSelect 组件 Ref 方法
+ * @template T 选项值的类型
+ */
+export interface SingleSelectRef<T = string | number> {
+    /**
+     * 聚焦到组件
+     */
+    focus: () => void;
+    /**
+     * 失焦
+     */
+    blur: () => void;
+    /**
+     * 获取当前选中值
+     */
+    getValue: () => T | null;
+    /**
+     * 设置选中值
+     */
+    setValue: (value: T | null) => void;
+    /**
+     * 清空选中值
+     */
+    clearValue: () => void;
+}
+/**
+ * EditView 组件 Props
+ * @template T 选项值的类型
+ */
+export interface EditViewProps<T = string | number> extends PisellSingleSelectProps<T> {
+    /**
+     * 内部状态管理对象（从 useSelectState Hook 传入）
+     */
+    state?: {
+        value: T | null | undefined;
+        setValue: (value: T | null) => void;
+        clearValue: () => void;
+    };
+}
+/**
+ * DisabledView 组件 Props
+ * @template T 选项值的类型
+ */
+export interface DisabledViewProps<T = string | number> extends PisellSingleSelectProps<T> {
+}
+/**
+ * ReadOnlyView 组件 Props
+ * @template T 选项值的类型
+ */
+export interface ReadOnlyViewProps<T = string | number> extends PisellSingleSelectProps<T> {
+}
+export type { SelectOption, FilterOptionFunc, SortDirection, SelectState, } from '@pisell/utils';

package/lib/components/pisellSingleSelect/types.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellSingleSelect/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/lib/components/pisellText/components/Editable/index.d.ts

@@ -4,6 +4,9 @@ export declare type MultiLanguageValue = {
     en: string;
     'zh-CN': string;
     'zh-HK': string;
+    'ja': string;
+    'pt': string;
+    original: string;
 };
 export interface EditableConfig {
     /** 是否禁用编辑 */

package/lib/components/pisellTimeRangeDisplay/PisellTimeRangeDisplay.d.ts

@@ -0,0 +1,32 @@
+import React from 'react';
+import 'dayjs/locale/zh-cn';
+import 'dayjs/locale/en';
+import type { PisellTimeRangeDisplayProps } from './types';
+import './PisellTimeRangeDisplay.less';
+/**
+ * PisellTimeRangeDisplay 组件
+ *
+ * @description
+ * 纯展示型时间区间组件，将 startAt / endAt 格式化为「时间区间 + 持续时间」。
+ * - 同一天：HH:mm-HH:mm，可选显示日期/星期
+ * - 跨天：起止日期时间
+ * - 持续时间：d h m s 格式
+ * - 字段顺序由 fieldOrder 控制，可将 duration 放在中间
+ *
+ * @example
+ * <PisellTimeRangeDisplay
+ *   startAt="2026-02-04 09:00"
+ *   endAt="2026-02-04 18:00"
+ * />
+ * // => "09:00-18:00" + "9h"
+ *
+ * <PisellTimeRangeDisplay
+ *   startAt={start}
+ *   endAt={end}
+ *   fields={{ fieldOrder: ['time', 'duration', 'date', 'weekday'] }}
+ *   showDateForSameDay
+ * />
+ */
+export declare const PisellTimeRangeDisplay: React.FC<PisellTimeRangeDisplayProps>;
+declare const _default: React.NamedExoticComponent<PisellTimeRangeDisplayProps>;
+export default _default;

package/lib/components/pisellTimeRangeDisplay/PisellTimeRangeDisplay.js

@@ -0,0 +1,193 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellTimeRangeDisplay/PisellTimeRangeDisplay.tsx
+var PisellTimeRangeDisplay_exports = {};
+__export(PisellTimeRangeDisplay_exports, {
+  PisellTimeRangeDisplay: () => PisellTimeRangeDisplay,
+  default: () => PisellTimeRangeDisplay_default
+});
+module.exports = __toCommonJS(PisellTimeRangeDisplay_exports);
+var import_react = __toESM(require("react"));
+var import_dayjs = __toESM(require("dayjs"));
+var import_zh_cn = require("dayjs/locale/zh-cn");
+var import_en = require("dayjs/locale/en");
+var import_utils = require("./utils");
+var import_components = require("./components");
+var import_PisellTimeRangeDisplay = require("./PisellTimeRangeDisplay.less");
+var PisellTimeRangeDisplay = (props) => {
+  const {
+    startAt,
+    endAt,
+    textAlign = "center",
+    fields,
+    showDateForSameDay = true,
+    timeFormat,
+    dateFormat,
+    weekdayFormat,
+    durationFormat,
+    containerStyle,
+    timeStyle,
+    dateStyle,
+    weekdayStyle,
+    durationStyle,
+    locale: localeProp,
+    className,
+    style,
+    onClick
+  } = props;
+  const effectiveLocale = (0, import_react.useMemo)(
+    () => localeProp ?? (0, import_utils.getDayjsLocale)(),
+    [localeProp]
+  );
+  const { start, end, isSameDay } = (0, import_react.useMemo)(
+    () => (0, import_utils.parseTimeRange)(startAt, endAt, effectiveLocale),
+    [startAt, endAt, effectiveLocale]
+  );
+  const durationMs = (0, import_react.useMemo)(() => end.diff(start), [start, end]);
+  const {
+    showTimeRange = true,
+    showDate = true,
+    showWeekday = true,
+    showDuration = true,
+    fieldOrder = ["weekday", "date", "time", "duration"]
+  } = fields || {};
+  const showSeconds = (durationFormat == null ? void 0 : durationFormat.showSeconds) ?? false;
+  const effectiveDateFormat = (0, import_react.useMemo)(
+    () => ({ showRelativeDay: false, ...dateFormat }),
+    [dateFormat]
+  );
+  const referenceDate = (0, import_dayjs.default)();
+  const relativeDay = (effectiveDateFormat == null ? void 0 : effectiveDateFormat.showRelativeDay) ? (0, import_utils.getRelativeDay)(start, referenceDate) : null;
+  const hideWeekdayWhenDateRelative = showDate && relativeDay !== null;
+  const justifyContent = textAlign === "right" ? "flex-end" : textAlign === "left" ? "flex-start" : "center";
+  const containerInlineStyle = {
+    background: containerStyle == null ? void 0 : containerStyle.background,
+    borderRadius: containerStyle == null ? void 0 : containerStyle.borderRadius,
+    border: containerStyle == null ? void 0 : containerStyle.border,
+    boxShadow: containerStyle == null ? void 0 : containerStyle.boxShadow,
+    padding: containerStyle == null ? void 0 : containerStyle.padding,
+    gap: containerStyle == null ? void 0 : containerStyle.gap,
+    textAlign,
+    justifyContent,
+    ...style
+  };
+  const renderField = (fieldType) => {
+    switch (fieldType) {
+      case "time":
+        return showTimeRange ? /* @__PURE__ */ import_react.default.createElement(
+          import_components.TimeRangeBlock,
+          {
+            key: "time",
+            start,
+            end,
+            isSameDay,
+            timeFormat,
+            dateFormat: effectiveDateFormat,
+            weekdayFormat,
+            referenceDate: (0, import_dayjs.default)(),
+            style: timeStyle
+          }
+        ) : null;
+      case "date":
+        if (!showDate) return null;
+        if (!isSameDay) return null;
+        if (!showDateForSameDay) return null;
+        return /* @__PURE__ */ import_react.default.createElement(
+          import_components.DateBlock,
+          {
+            key: "date",
+            date: start,
+            format: effectiveDateFormat,
+            referenceDate: (0, import_dayjs.default)(),
+            style: dateStyle
+          }
+        );
+      case "weekday":
+        if (!showWeekday) return null;
+        if (!isSameDay) return null;
+        if (!showDateForSameDay) return null;
+        if (hideWeekdayWhenDateRelative) return null;
+        return /* @__PURE__ */ import_react.default.createElement(
+          import_components.WeekdayBlock,
+          {
+            key: "weekday",
+            weekday: start,
+            format: weekdayFormat,
+            style: weekdayStyle
+          }
+        );
+      case "duration":
+        return showDuration ? /* @__PURE__ */ import_react.default.createElement(
+          import_components.DurationBlock,
+          {
+            key: "duration",
+            durationMs,
+            showSeconds,
+            locale: effectiveLocale,
+            style: durationStyle
+          }
+        ) : null;
+      default:
+        return null;
+    }
+  };
+  const items = [];
+  fieldOrder.forEach((fieldType) => {
+    const node = renderField(fieldType);
+    if (node != null) {
+      items.push({ type: fieldType, node });
+    }
+  });
+  if (items.length === 0) {
+    return null;
+  }
+  const renderedWithSeparator = items.flatMap(({ type, node }, index) => {
+    const needDotBefore = type === "duration" && index > 0;
+    const needDotAfter = type === "duration" && index < items.length - 1;
+    const sep = /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-time-range-display-sep", "aria-hidden": true }, " · ");
+    const el = import_react.default.cloneElement(node, { key: type });
+    if (needDotBefore) return [sep, el];
+    if (needDotAfter) return [el, sep];
+    return [el];
+  });
+  return /* @__PURE__ */ import_react.default.createElement(
+    "div",
+    {
+      className: `pisell-time-range-display ${className || ""}`.trim(),
+      style: containerInlineStyle,
+      onClick
+    },
+    renderedWithSeparator
+  );
+};
+var PisellTimeRangeDisplay_default = import_react.default.memo(PisellTimeRangeDisplay);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PisellTimeRangeDisplay
+});

package/lib/components/pisellTimeRangeDisplay/PisellTimeRangeDisplay.less

@@ -0,0 +1,49 @@
+/**
+ * Time Range Display 样式
+ * 无 layout 配置：一行放不下时按块换行，块内不换行，换行后每行居中
+ */
+.pisell-time-range-display {
+  display: flex;
+  flex-direction: row;
+  flex-wrap: wrap;
+  align-items: baseline;
+  justify-content: center;
+  gap: 0 4px;
+  box-sizing: border-box;
+  color: rgba(0, 0, 0, 0.88);
+
+  .pisell-time-range-display-time,
+  .pisell-time-range-display-date,
+  .pisell-time-range-display-weekday,
+  .pisell-time-range-display-duration {
+    font-size: 14px;
+    font-weight: 400;
+    line-height: 1.5;
+  }
+
+  .pisell-time-range-display-sep {
+    font-size: 14px;
+    font-weight: 400;
+    margin: 0 2px;
+    user-select: none;
+  }
+
+  // 各块内不换行，换行时以块为单位
+  &-time,
+  &-date,
+  &-weekday,
+  &-duration {
+    //display: inline-block;
+    //white-space: nowrap;
+  }
+
+  &-sep {
+    //display: inline-block;
+    //white-space: nowrap;
+  }
+
+  // 同天小宽度：「 - 结束时间」不拆开
+  &-time-end-wrap {
+    //white-space: nowrap;
+  }
+}

package/lib/components/pisellTimeRangeDisplay/PisellTimeRangeDisplay.stories.d.ts

@@ -0,0 +1,61 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellTimeRangeDisplay } from './PisellTimeRangeDisplay';
+/**
+ * PisellTimeRangeDisplay 组件 Storybook
+ * 用于时间区间 + 持续时长的展示（同一天 / 跨天）
+ */
+declare const meta: Meta<typeof PisellTimeRangeDisplay>;
+export default meta;
+declare type Story = StoryObj<typeof PisellTimeRangeDisplay>;
+/**
+ * 默认：同一天时间区间 + 持续时长
+ */
+export declare const Default: Story;
+/**
+ * 同一天 + 显示日期与星期
+ */
+export declare const SameDayWithDate: Story;
+/**
+ * 跨天时间区间
+ */
+export declare const CrossDay: Story;
+/**
+ * 跨年
+ */
+export declare const CrossYear: Story;
+/**
+ * 持续时间在中间（默认 fieldOrder）
+ */
+export declare const DurationInMiddle: Story;
+/**
+ * 持续时长在前
+ */
+export declare const DurationFirst: Story;
+/**
+ * 持续时长显示秒
+ */
+export declare const DurationWithSeconds: Story;
+/**
+ * 仅时间区间 + 持续时长（不显示日期星期）
+ */
+export declare const TimeAndDurationOnly: Story;
+/**
+ * 12 小时制
+ */
+export declare const Time12Hour: Story;
+/**
+ * 中文（日期 + 持续时长「天/时/分/秒」i18n）
+ */
+export declare const LocaleZhCN: Story;
+/**
+ * 英文（日期 + 持续时长 d/h/m/s）
+ */
+export declare const LocaleEn: Story;
+/**
+ * 小宽度：容器较窄时按块换行
+ */
+export declare const NarrowWidth: Story;
+/**
+ * 自定义容器样式
+ */
+export declare const CustomContainerStyle: Story;