@dsh-workbench/shared 0.3.7 → 0.3.8

package/dist/api/long-task.d.ts

@@ -58,6 +58,14 @@ export declare function longTaskRunsOf<T>(state: {
  * @returns ongoing / done / error / idle；needs-login 也算进行中；`stopped` 落进 idle —— 灰点：不是成功、不是出错，是用户自己按停的。
  */
 export declare function longTaskDot(status: LongTaskStatus): 'ongoing' | 'done' | 'error' | 'idle';
+/**
+ * 这一趟还在不在跑（`running` 与 `needs-login` 都算）。
+ * 卡片要判"这一行要不要摆停止钮""这套环境里有没有活着的跑"时用这个 —— **不是** `longTaskDot`：
+ * 那一件是状态点的**长相**（四档），归 `LongTaskRow` 自己用，不该被调用点拿去当判据。
+ * @param status 长任务的五种态。
+ * @returns 在跑 `true`；成功 / 失败 / 用户按停都是 `false`。
+ */
+export declare function longTaskIsLive(status: LongTaskStatus): boolean;
 /**
  * 停止钮的三档：没上膛 / 上了膛 / 请求在飞。
  */

package/dist/api/long-task.js

@@ -55,6 +55,16 @@ export function longTaskDot(status) {
         return 'ongoing';
     return 'idle';
 }
+/**
+ * 这一趟还在不在跑（`running` 与 `needs-login` 都算）。
+ * 卡片要判"这一行要不要摆停止钮""这套环境里有没有活着的跑"时用这个 —— **不是** `longTaskDot`：
+ * 那一件是状态点的**长相**（四档），归 `LongTaskRow` 自己用，不该被调用点拿去当判据。
+ * @param status 长任务的五种态。
+ * @returns 在跑 `true`；成功 / 失败 / 用户按停都是 `false`。
+ */
+export function longTaskIsLive(status) {
+    return status === 'running' || status === 'needs-login';
+}
 /**
  * 算停止钮现在在哪一档。
  * @param state armed = 已经按过第一下、在等第二下；busy = 停止请求已经在飞。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/shared",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "工作台与模块共享的纯代码与契约类型：类型、纯逻辑、哑组件、平台解析。宿主侧的东西从 /host 进（不影响浏览器产物）。",
   "license": "MIT",
   "type": "module",

package/src/api/__tests__/long-task.test.ts

@@ -1,6 +1,7 @@
 import { describe, expect, it } from 'vitest';
 import {
   longTaskDot,
+  longTaskIsLive,
   longTaskPollMs,
   longTaskRunsOf,
   longTaskStopPress,
@@ -38,6 +39,20 @@ describe('longTaskDot', () => {
   });
 });
 
+describe('longTaskIsLive（调用点判「还在跑」用的那个谓词）', () => {
+  it('★ 只认 running 与 needs-login —— 与 longTaskDot 的 ongoing 同一口径', () => {
+    for (const status of ['running', 'needs-login', 'ok', 'failed', 'stopped'] as const) {
+      expect(longTaskIsLive(status)).toBe(longTaskDot(status) === 'ongoing');
+    }
+  });
+
+  it('★ 结束的三态（成功 / 失败 / 用户按停）都不是"在跑"', () => {
+    expect(longTaskIsLive('ok')).toBe(false);
+    expect(longTaskIsLive('failed')).toBe(false);
+    expect(longTaskIsLive('stopped')).toBe(false);
+  });
+});
+
 describe('longTaskStopStage / longTaskStopPress（两按：第一次上膛，第二次才真发）', () => {
   it('★ 三档：没上膛 / 上了膛 / 请求在飞；在飞压过一切', () => {
     expect(longTaskStopStage({ armed: false, busy: false })).toBe('idle');

package/src/api/long-task.ts

@@ -82,6 +82,17 @@ export function longTaskDot(status: LongTaskStatus): 'ongoing' | 'done' | 'error
   return 'idle';
 }
 
+/**
+ * 这一趟还在不在跑（`running` 与 `needs-login` 都算）。
+ * 卡片要判"这一行要不要摆停止钮""这套环境里有没有活着的跑"时用这个 —— **不是** `longTaskDot`：
+ * 那一件是状态点的**长相**（四档），归 `LongTaskRow` 自己用，不该被调用点拿去当判据。
+ * @param status 长任务的五种态。
+ * @returns 在跑 `true`；成功 / 失败 / 用户按停都是 `false`。
+ */
+export function longTaskIsLive(status: LongTaskStatus): boolean {
+  return status === 'running' || status === 'needs-login';
+}
+
 /**
  * 停止钮的三档：没上膛 / 上了膛 / 请求在飞。
  */