@pisell/materials 6.11.17 → 6.11.18

package/lib/components/pisellTimeNavigator/components/GestureLayer.js

@@ -0,0 +1,170 @@
+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/GestureLayer.tsx
+var GestureLayer_exports = {};
+__export(GestureLayer_exports, {
+  GestureLayer: () => GestureLayer
+});
+module.exports = __toCommonJS(GestureLayer_exports);
+var import_react = __toESM(require("react"));
+function GestureLayer({
+  orientation,
+  cellSizePx,
+  axisStartMarginPx,
+  offsetToTime,
+  onSelectTime,
+  isInDisabledRanges,
+  snapToStep,
+  stepMinutes,
+  snapFn,
+  scrollPosition,
+  viewportSize,
+  onPointerDown,
+  onPointerMove,
+  onPointerUp,
+  onPointerLeave,
+  onUserInteraction,
+  children
+}) {
+  const isHorizontal = orientation === "horizontal";
+  const handleClick = (0, import_react.useCallback)(
+    (e) => {
+      onUserInteraction == null ? void 0 : onUserInteraction();
+      const viewport = e.currentTarget.parentElement;
+      if (!viewport) return;
+      const vRect = viewport.getBoundingClientRect();
+      const scroll = isHorizontal ? viewport.scrollLeft : viewport.scrollTop;
+      const scrollContentPos = isHorizontal ? scroll + (e.clientX - vRect.left) : scroll + (e.clientY - vRect.top);
+      const offset = Math.max(0, scrollContentPos - axisStartMarginPx);
+      const t = offsetToTime(offset);
+      if (t == null) return;
+      const candidate = snapToStep ? snapFn(t) : t;
+      if (isInDisabledRanges(candidate)) return;
+      onSelectTime(candidate);
+    },
+    [
+      isHorizontal,
+      axisStartMarginPx,
+      offsetToTime,
+      onSelectTime,
+      isInDisabledRanges,
+      snapToStep,
+      snapFn,
+      onUserInteraction
+    ]
+  );
+  const handleKeyDown = (0, import_react.useCallback)(
+    (e) => {
+      const scrollContentCenter = orientation === "horizontal" ? scrollPosition.scrollLeft + viewportSize.w / 2 : scrollPosition.scrollTop + viewportSize.h / 2;
+      const centerOffset = Math.max(0, scrollContentCenter - axisStartMarginPx);
+      const currentTime = offsetToTime(centerOffset);
+      if (currentTime == null) return;
+      if (e.key === "Enter") {
+        const candidate = snapToStep ? snapFn(currentTime) : currentTime;
+        if (!isInDisabledRanges(candidate)) {
+          onUserInteraction == null ? void 0 : onUserInteraction();
+          onSelectTime(candidate);
+        }
+        e.preventDefault();
+        return;
+      }
+      const step = stepMinutes * 60 * 1e3;
+      let next;
+      if (orientation === "horizontal") {
+        if (e.key === "ArrowLeft") next = currentTime.subtract(step, "ms");
+        else if (e.key === "ArrowRight") next = currentTime.add(step, "ms");
+        else return;
+      } else {
+        if (e.key === "ArrowUp") next = currentTime.subtract(step, "ms");
+        else if (e.key === "ArrowDown") next = currentTime.add(step, "ms");
+        else return;
+      }
+      e.preventDefault();
+      const snapped = snapToStep ? snapFn(next) : next;
+      if (!isInDisabledRanges(snapped)) {
+        onUserInteraction == null ? void 0 : onUserInteraction();
+        onSelectTime(snapped);
+      }
+    },
+    [
+      orientation,
+      axisStartMarginPx,
+      offsetToTime,
+      onSelectTime,
+      isInDisabledRanges,
+      snapToStep,
+      snapFn,
+      stepMinutes,
+      scrollPosition.scrollLeft,
+      scrollPosition.scrollTop,
+      viewportSize.w,
+      viewportSize.h,
+      onUserInteraction
+    ]
+  );
+  const handlePointerDown = (0, import_react.useCallback)(
+    (e) => {
+      onUserInteraction == null ? void 0 : onUserInteraction();
+      if (onPointerDown) {
+        e.currentTarget.setPointerCapture(e.pointerId);
+        onPointerDown(e);
+      }
+    },
+    [onPointerDown, onUserInteraction]
+  );
+  const handlePointerUp = (0, import_react.useCallback)(
+    (e) => {
+      if (onPointerUp) {
+        e.currentTarget.releasePointerCapture(e.pointerId);
+        onPointerUp(e);
+      }
+    },
+    [onPointerUp]
+  );
+  return /* @__PURE__ */ import_react.default.createElement(
+    "div",
+    {
+      className: `pisell-time-navigator-gesture pisell-time-navigator-gesture--${orientation}`,
+      onClick: handleClick,
+      onKeyDown: handleKeyDown,
+      onPointerDown: handlePointerDown,
+      onPointerMove,
+      onPointerUp: handlePointerUp,
+      onPointerLeave,
+      role: "slider",
+      tabIndex: 0,
+      "aria-label": "Time"
+    },
+    children
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GestureLayer
+});

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

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { CSSProperties } from 'react';
+export interface NowButtonProps {
+    orientation: 'horizontal' | 'vertical';
+    onClick: () => void;
+    style?: CSSProperties;
+    className?: string;
+    renderCustom?: () => React.ReactNode;
+}
+/**
+ * Now 按钮：固定入口，点击跳回当前时间并进入 Realtime
+ * 横向：右侧，左箭头；竖向：底部，上箭头
+ */
+export declare function NowButton({ orientation, onClick, style, className, renderCustom, }: NowButtonProps): React.JSX.Element;

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,22 @@
+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;
+    /**
+     * 横向每格宽度（px），须与 useTimeAxis 的 cellSizePx 一致；
+     * 不传时样式表默认 82（axis-moves）；cursor-moves 压缩比例时必传
+     */
+    horizontalCellSizePx?: number;
+}
+/**
+ * 刻度层：渲染时间刻度与标签
+ * 横向：整点数字 + 小圆点；竖向：整点/半点数字 + 分割线
+ */
+export declare function ScaleLayer({ orientation, ticks, stepMinutes, majorStepMinutes, timeFormat, locale, style, className, horizontalCellSizePx, }: ScaleLayerProps): React.JSX.Element;

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

@@ -0,0 +1,116 @@
+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,
+  horizontalCellSizePx
+}) {
+  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) {
+        const cw = horizontalCellSizePx != null && horizontalCellSizePx > 0 ? horizontalCellSizePx : void 0;
+        const compactPad = cw != null ? cw < 36 ? 2 : cw < 52 ? 6 : 10 : void 0;
+        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 }
+            ),
+            style: cw != null ? {
+              width: cw,
+              minWidth: cw,
+              maxWidth: cw,
+              flex: "0 0 auto",
+              boxSizing: "border-box",
+              ...compactPad != null ? { padding: compactPad } : {}
+            } : void 0
+          },
+          isMajor && /* @__PURE__ */ import_react.default.createElement(
+            "span",
+            {
+              className: "pisell-time-navigator-scale-label",
+              style: cw != null && cw < 48 ? {
+                fontSize: Math.max(10, Math.round(cw * 0.32)),
+                lineHeight: 1.15
+              } : void 0
+            },
+            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;