@pisell/materials 1.8.17 → 1.8.19

package/lib/components/pisellTimeNavigator/components/NowButton.js

@@ -0,0 +1,81 @@
+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/pisellTimeNavigator/components/NowButton.tsx
+var NowButton_exports = {};
+__export(NowButton_exports, {
+  NowButton: () => NowButton
+});
+module.exports = __toCommonJS(NowButton_exports);
+var import_react = __toESM(require("react"));
+var import_utils = require("@pisell/utils");
+var import_classnames = __toESM(require("classnames"));
+var I18N_NOW = "pisell-time-navigator.now";
+function NowButton({
+  orientation,
+  onClick,
+  style,
+  className,
+  renderCustom
+}) {
+  const raw = import_utils.locales.getText(I18N_NOW);
+  const label = raw && raw !== I18N_NOW ? raw : "Now";
+  if (renderCustom) {
+    return /* @__PURE__ */ import_react.default.createElement(
+      "button",
+      {
+        type: "button",
+        className: (0, import_classnames.default)("pisell-time-navigator-now", className),
+        onClick,
+        style,
+        "aria-label": label
+      },
+      renderCustom()
+    );
+  }
+  return /* @__PURE__ */ import_react.default.createElement(
+    "button",
+    {
+      type: "button",
+      className: (0, import_classnames.default)(
+        "pisell-time-navigator-now",
+        `pisell-time-navigator-now--${orientation}`,
+        className
+      ),
+      onClick,
+      style,
+      "aria-label": label
+    },
+    /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-time-navigator-now-icon", "aria-hidden": true }),
+    /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-time-navigator-now-label" }, label)
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NowButton
+});

package/lib/components/pisellTimeNavigator/components/ScaleLayer.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { Dayjs } from 'dayjs';
+export interface ScaleLayerProps {
+    orientation: 'horizontal' | 'vertical';
+    ticks: Dayjs[];
+    stepMinutes: number;
+    majorStepMinutes: number;
+    timeFormat: string;
+    locale?: string;
+    style?: React.CSSProperties;
+    className?: string;
+}
+/**
+ * 刻度层：渲染时间刻度与标签
+ * 横向：整点数字 + 小圆点；竖向：整点/半点数字 + 分割线
+ */
+export declare function ScaleLayer({ orientation, ticks, stepMinutes, majorStepMinutes, timeFormat, locale, style, className, }: ScaleLayerProps): JSX.Element;

package/lib/components/pisellTimeNavigator/components/ScaleLayer.js

@@ -0,0 +1,95 @@
+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/pisellTimeNavigator/components/ScaleLayer.tsx
+var ScaleLayer_exports = {};
+__export(ScaleLayer_exports, {
+  ScaleLayer: () => ScaleLayer
+});
+module.exports = __toCommonJS(ScaleLayer_exports);
+var import_react = __toESM(require("react"));
+var import_classnames = __toESM(require("classnames"));
+function ScaleLayer({
+  orientation,
+  ticks,
+  stepMinutes,
+  majorStepMinutes,
+  timeFormat,
+  locale,
+  style,
+  className
+}) {
+  const isHorizontal = orientation === "horizontal";
+  return /* @__PURE__ */ import_react.default.createElement(
+    "div",
+    {
+      className: (0, import_classnames.default)(
+        "pisell-time-navigator-scale",
+        `pisell-time-navigator-scale--${orientation}`,
+        className
+      ),
+      style
+    },
+    ticks.map((tick, i) => {
+      const isMajor = tick.minute() % majorStepMinutes === 0;
+      const label = isHorizontal && isMajor ? locale ? tick.locale(locale).format("H") : tick.format("H") : locale ? tick.locale(locale).format(timeFormat) : tick.format(timeFormat);
+      if (isHorizontal) {
+        return /* @__PURE__ */ import_react.default.createElement(
+          "div",
+          {
+            key: i,
+            className: (0, import_classnames.default)(
+              "pisell-time-navigator-scale-cell",
+              "pisell-time-navigator-scale-cell--h",
+              { "pisell-time-navigator-scale-cell--major": isMajor }
+            )
+          },
+          isMajor && /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-time-navigator-scale-label" }, label),
+          !isMajor && /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-time-navigator-scale-dot", "aria-hidden": true })
+        );
+      }
+      return /* @__PURE__ */ import_react.default.createElement(
+        "div",
+        {
+          key: i,
+          className: (0, import_classnames.default)(
+            "pisell-time-navigator-scale-cell",
+            "pisell-time-navigator-scale-cell--v",
+            { "pisell-time-navigator-scale-cell--major": isMajor }
+          )
+        },
+        /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-time-navigator-scale-divider", "aria-hidden": true }),
+        isMajor && /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-time-navigator-scale-label" }, label)
+      );
+    })
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ScaleLayer
+});

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

@@ -0,0 +1,5 @@
+export { BackgroundLayer } from './BackgroundLayer';
+export { CursorLayer } from './CursorLayer';
+export { GestureLayer } from './GestureLayer';
+export { NowButton } from './NowButton';
+export { ScaleLayer } from './ScaleLayer';

package/lib/components/pisellTimeNavigator/components/index.js

@@ -0,0 +1,41 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellTimeNavigator/components/index.tsx
+var components_exports = {};
+__export(components_exports, {
+  BackgroundLayer: () => import_BackgroundLayer.BackgroundLayer,
+  CursorLayer: () => import_CursorLayer.CursorLayer,
+  GestureLayer: () => import_GestureLayer.GestureLayer,
+  NowButton: () => import_NowButton.NowButton,
+  ScaleLayer: () => import_ScaleLayer.ScaleLayer
+});
+module.exports = __toCommonJS(components_exports);
+var import_BackgroundLayer = require("./BackgroundLayer");
+var import_CursorLayer = require("./CursorLayer");
+var import_GestureLayer = require("./GestureLayer");
+var import_NowButton = require("./NowButton");
+var import_ScaleLayer = require("./ScaleLayer");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BackgroundLayer,
+  CursorLayer,
+  GestureLayer,
+  NowButton,
+  ScaleLayer
+});

package/lib/components/pisellTimeNavigator/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export { useTimeAxis } from './useTimeAxis';
+export type { UseTimeAxisOptions, TimeAxisState } from './useTimeAxis';
+export { useRealtime } from './useRealtime';
+export { useDragInertia } from './useDragInertia';
+export type { UseDragInertiaOptions } from './useDragInertia';

package/lib/components/pisellTimeNavigator/hooks/index.js

@@ -0,0 +1,35 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellTimeNavigator/hooks/index.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  useDragInertia: () => import_useDragInertia.useDragInertia,
+  useRealtime: () => import_useRealtime.useRealtime,
+  useTimeAxis: () => import_useTimeAxis.useTimeAxis
+});
+module.exports = __toCommonJS(hooks_exports);
+var import_useTimeAxis = require("./useTimeAxis");
+var import_useRealtime = require("./useRealtime");
+var import_useDragInertia = require("./useDragInertia");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useDragInertia,
+  useRealtime,
+  useTimeAxis
+});

package/lib/components/pisellTimeNavigator/hooks/useDragInertia.d.ts

@@ -0,0 +1,14 @@
+export interface UseDragInertiaOptions {
+    enabled: boolean;
+    orientation: 'horizontal' | 'vertical';
+    getScrollContainer: () => HTMLElement | null;
+}
+/**
+ * 惯性滚动：根据拖动末段速度在松手后继续滚动并衰减
+ */
+export declare function useDragInertia(options: UseDragInertiaOptions): {
+    onPointerDown: (e: React.PointerEvent) => void;
+    onPointerMove: (e: React.PointerEvent) => void;
+    onPointerUp: (e: React.PointerEvent) => void;
+    stopInertia: () => void;
+};

package/lib/components/pisellTimeNavigator/hooks/useDragInertia.js

@@ -0,0 +1,136 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellTimeNavigator/hooks/useDragInertia.ts
+var useDragInertia_exports = {};
+__export(useDragInertia_exports, {
+  useDragInertia: () => useDragInertia
+});
+module.exports = __toCommonJS(useDragInertia_exports);
+var import_react = require("react");
+var DECAY = 0.95;
+var MIN_VELOCITY = 0.5;
+var SAMPLE_MS = 50;
+function useDragInertia(options) {
+  const { enabled, orientation, getScrollContainer } = options;
+  const rafId = (0, import_react.useRef)(null);
+  const lastPos = (0, import_react.useRef)(0);
+  const lastTime = (0, import_react.useRef)(0);
+  const velocity = (0, import_react.useRef)(0);
+  const samples = (0, import_react.useRef)([]);
+  const applyScroll = (0, import_react.useCallback)(
+    (delta) => {
+      const el = getScrollContainer();
+      if (!el) return;
+      if (orientation === "horizontal") {
+        el.scrollLeft = Math.max(0, el.scrollLeft + delta);
+      } else {
+        el.scrollTop = Math.max(0, el.scrollTop + delta);
+      }
+    },
+    [getScrollContainer, orientation]
+  );
+  const lastTickTime = (0, import_react.useRef)(0);
+  const tick = (0, import_react.useCallback)(
+    (now) => {
+      const t = now ?? performance.now();
+      const dt = lastTickTime.current ? (t - lastTickTime.current) / 1e3 : 0.016;
+      lastTickTime.current = t;
+      const v = velocity.current;
+      if (Math.abs(v) < MIN_VELOCITY) {
+        velocity.current = 0;
+        lastTickTime.current = 0;
+        return;
+      }
+      applyScroll(v * dt);
+      velocity.current = v * DECAY;
+      rafId.current = requestAnimationFrame(tick);
+    },
+    [applyScroll]
+  );
+  const stopInertia = (0, import_react.useCallback)(() => {
+    if (rafId.current != null) {
+      cancelAnimationFrame(rafId.current);
+      rafId.current = null;
+    }
+    velocity.current = 0;
+    samples.current = [];
+  }, []);
+  const onPointerDown = (0, import_react.useCallback)(
+    (e) => {
+      if (!enabled) return;
+      stopInertia();
+      const pos = orientation === "horizontal" ? e.clientX : e.clientY;
+      lastPos.current = pos;
+      lastTime.current = Date.now();
+      samples.current = [{ pos, t: lastTime.current }];
+    },
+    [enabled, orientation, stopInertia]
+  );
+  const onPointerMove = (0, import_react.useCallback)(
+    (e) => {
+      if (!enabled) return;
+      const pos = orientation === "horizontal" ? e.clientX : e.clientY;
+      const t = Date.now();
+      const el = getScrollContainer();
+      if (el) {
+        const scroll = orientation === "horizontal" ? el.scrollLeft : el.scrollTop;
+        const delta = pos - lastPos.current;
+        const maxScroll = orientation === "horizontal" ? el.scrollWidth - el.clientWidth : el.scrollHeight - el.clientHeight;
+        const next = Math.max(0, Math.min(maxScroll, scroll + delta));
+        if (orientation === "horizontal") {
+          el.scrollLeft = next;
+        } else {
+          el.scrollTop = next;
+        }
+      }
+      lastPos.current = pos;
+      lastTime.current = t;
+      samples.current.push({ pos, t });
+      const cutoff = t - SAMPLE_MS;
+      while (samples.current.length > 1 && samples.current[0].t < cutoff) {
+        samples.current.shift();
+      }
+    },
+    [enabled, orientation, getScrollContainer]
+  );
+  const onPointerUp = (0, import_react.useCallback)(
+    (e) => {
+      if (!enabled) return;
+      const arr = samples.current;
+      if (arr.length < 2) return;
+      const first = arr[0];
+      const last = arr[arr.length - 1];
+      const dt = (last.t - first.t) / 1e3;
+      if (dt <= 0) return;
+      const scrollEl = getScrollContainer();
+      if (!scrollEl) return;
+      const scroll = orientation === "horizontal" ? scrollEl.scrollLeft : scrollEl.scrollTop;
+      const totalDelta = last.pos - first.pos;
+      velocity.current = totalDelta / dt;
+      stopInertia();
+      rafId.current = requestAnimationFrame(tick);
+    },
+    [enabled, orientation, getScrollContainer, stopInertia, tick]
+  );
+  return { onPointerDown, onPointerMove, onPointerUp, stopInertia };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useDragInertia
+});

package/lib/components/pisellTimeNavigator/hooks/useRealtime.d.ts

@@ -0,0 +1,5 @@
+import type { Dayjs } from 'dayjs';
+/**
+ * Realtime 模式：每秒将当前系统时间通过 onTick 回传
+ */
+export declare function useRealtime(enabled: boolean, onTick: (now: Dayjs) => void): void;

package/lib/components/pisellTimeNavigator/hooks/useRealtime.js

@@ -0,0 +1,49 @@
+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/pisellTimeNavigator/hooks/useRealtime.ts
+var useRealtime_exports = {};
+__export(useRealtime_exports, {
+  useRealtime: () => useRealtime
+});
+module.exports = __toCommonJS(useRealtime_exports);
+var import_react = require("react");
+var import_dayjs = __toESM(require("dayjs"));
+function useRealtime(enabled, onTick) {
+  (0, import_react.useEffect)(() => {
+    if (!enabled) return;
+    const id = setInterval(() => {
+      onTick((0, import_dayjs.default)());
+    }, 1e3);
+    return () => clearInterval(id);
+  }, [enabled, onTick]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useRealtime
+});

package/lib/components/pisellTimeNavigator/hooks/useTimeAxis.d.ts

@@ -0,0 +1,27 @@
+import type { Dayjs } from 'dayjs';
+import type { TimeRangeOption } from '../types';
+export interface UseTimeAxisOptions {
+    range?: TimeRangeOption;
+    stepMinutes: number;
+    referenceDate: Dayjs;
+    orientation: 'horizontal' | 'vertical';
+    /** 横向时每格宽度（px），竖向时每格高度（px） */
+    cellSizePx: number;
+}
+export interface TimeAxisState {
+    rangeStart: Dayjs;
+    rangeEnd: Dayjs;
+    ticks: Dayjs[];
+    /** 时间转主轴偏移（px） */
+    timeToOffset: (t: Dayjs) => number;
+    /** 主轴偏移（px）转时间（最近刻度，用于刻度对齐） */
+    offsetToTime: (offset: number) => Dayjs | null;
+    /** 主轴偏移（px）转时间（连续插值，用于拖动时按分钟步长显示） */
+    offsetToTimeContinuous: (offset: number) => Dayjs | null;
+    /** 主轴总长度（px） */
+    totalLengthPx: number;
+}
+/**
+ * 时间轴刻度与时间↔像素换算
+ */
+export declare function useTimeAxis(options: UseTimeAxisOptions): TimeAxisState;

package/lib/components/pisellTimeNavigator/hooks/useTimeAxis.js

@@ -0,0 +1,87 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellTimeNavigator/hooks/useTimeAxis.ts
+var useTimeAxis_exports = {};
+__export(useTimeAxis_exports, {
+  useTimeAxis: () => useTimeAxis
+});
+module.exports = __toCommonJS(useTimeAxis_exports);
+var import_react = require("react");
+var import_utils = require("../utils");
+function useTimeAxis(options) {
+  const {
+    range,
+    stepMinutes,
+    referenceDate,
+    orientation,
+    cellSizePx
+  } = options;
+  return (0, import_react.useMemo)(() => {
+    const [rangeStart, rangeEnd] = (0, import_utils.getRangeBounds)(range, referenceDate);
+    const ticks = (0, import_utils.getTicks)(rangeStart, rangeEnd, stepMinutes);
+    const lastTick = ticks.length > 0 ? ticks[ticks.length - 1] : null;
+    const needTailCell = orientation === "horizontal" && lastTick != null && rangeEnd.isAfter(lastTick);
+    const noTailVertical = orientation === "vertical" && lastTick != null && !rangeEnd.isAfter(lastTick);
+    const effectiveTicks = noTailVertical && ticks.length > 0 ? ticks.slice(0, -1) : ticks;
+    const rawTotalPx = orientation === "vertical" ? effectiveTicks.length * cellSizePx : (ticks.length + (needTailCell ? 1 : 0)) * cellSizePx;
+    const totalLengthPx = Math.min(rawTotalPx, 5e5);
+    const dotOffsetPx = orientation === "vertical" ? 0 : cellSizePx / 2;
+    const maxOffsetPx = orientation === "vertical" ? totalLengthPx : dotOffsetPx + (needTailCell ? ticks.length : Math.max(0, ticks.length - 1)) * cellSizePx;
+    const timeToOffset = (t) => {
+      const diffMs = t.diff(rangeStart);
+      const diffMin = diffMs / (60 * 1e3);
+      const index = diffMin / stepMinutes;
+      const px = dotOffsetPx + index * cellSizePx;
+      return Math.max(dotOffsetPx, Math.min(px, maxOffsetPx));
+    };
+    const offsetToTime = (offset) => {
+      const index = Math.round((offset - dotOffsetPx) / cellSizePx);
+      const tick = effectiveTicks[index];
+      return tick ?? null;
+    };
+    const offsetToTimeContinuous = (offset) => {
+      const index = (offset - dotOffsetPx) / cellSizePx;
+      const minutesFromStart = index * stepMinutes;
+      let t = rangeStart.add(minutesFromStart, "minute");
+      if (t.isBefore(rangeStart)) return rangeStart;
+      if (t.isAfter(rangeEnd)) return rangeEnd;
+      return t;
+    };
+    return {
+      rangeStart,
+      rangeEnd,
+      ticks: effectiveTicks,
+      timeToOffset,
+      offsetToTime,
+      offsetToTimeContinuous,
+      totalLengthPx
+    };
+  }, [
+    range == null ? void 0 : range.start,
+    range == null ? void 0 : range.end,
+    stepMinutes,
+    referenceDate.valueOf(),
+    orientation,
+    cellSizePx
+  ]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useTimeAxis
+});

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

@@ -0,0 +1,4 @@
+export { PisellTimeNavigator } from './PisellTimeNavigator';
+export type { PisellTimeNavigatorProps, TimeNavigatorValue, TimeRangeOption, CursorMode, TimeNavigatorOrientation, } from './types';
+/** 多语言文案（en / zh-CN / zh-HK / ja / pt），使用前请在应用内通过 locales.init(pisellTimeNavigatorLocales, lang) 合并 */
+export { default as pisellTimeNavigatorLocales } from './locales';

package/lib/components/pisellTimeNavigator/index.js

@@ -0,0 +1,42 @@
+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/pisellTimeNavigator/index.tsx
+var pisellTimeNavigator_exports = {};
+__export(pisellTimeNavigator_exports, {
+  PisellTimeNavigator: () => import_PisellTimeNavigator.PisellTimeNavigator,
+  pisellTimeNavigatorLocales: () => import_locales.default
+});
+module.exports = __toCommonJS(pisellTimeNavigator_exports);
+var import_PisellTimeNavigator = require("./PisellTimeNavigator");
+var import_locales = __toESM(require("./locales"));
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PisellTimeNavigator,
+  pisellTimeNavigatorLocales
+});