@mikitasazan/notify 1.5.0 → 1.6.1

package/dist/index.d.ts

@@ -2,4 +2,5 @@ export type { EventType, NotifyEvent, Project } from './events.ts';
 export { severity } from './events.ts';
 export { notify, sendReport } from './send.ts';
 export { render } from './render.ts';
+export { trend } from './trend.ts';
 export type { SendResult } from './send.ts';

package/dist/index.js

@@ -1,6 +1,10 @@
 export { severity } from "./events.js";
 export { notify, sendReport } from "./send.js";
-// `render` наружу — чтобы отправитель мог положить на диск РОВНО ту карточку,
-// которая уехала, а не свою вторую версию текста. Сборка копии вручную уже
-// расходилась с отправленным.
+// `render` is exported so a sender can put on disk EXACTLY the card that was
+// sent rather than its own second version of the text. A hand-built copy had
+// already drifted from what went out.
 export { render } from "./render.js";
+// `trend` is exported for the same reason one floor down: the shape of a
+// number is the package's, not each sender's. Two report senders had grown two
+// dialects for one thing.
+export { trend } from "./trend.js";

package/dist/render.js

@@ -199,7 +199,14 @@ const note = (text) => {
  * стоит отдельной строкой, потому что сам текст в поле не помещается: поле
  * держит одну строку и обрезает.
  */
-const quoted = (label, text) => text ? `<b>${esc(cap(label))}</b>\n${note(text)}` : null;
+/**
+ * A quote that needs saying what it is. The heading is a GROUP heading — the
+ * same italic-underline every other card uses over a block — not a bold field
+ * label: a bold label means `label: value` on one line, and using it here made
+ * the session card the only one whose block was titled a third way. The owner
+ * read the card and asked where its group was.
+ */
+const quoted = (label, text) => text ? `${group(label)}\n${note(text)}` : null;
 /**
  * Склейка карточки. Пустая строка здесь — знак смены блока, а не отступ:
  * две подряд означают пустой блок, ведущая — блок, которого нет. Обе
@@ -525,7 +532,9 @@ const renderIncident = (e) => join([
 // one place it is of any use.
 const renderSession = (e) => join([
     typeLine(iconFor(e), 'Session', e.action),
-    '',
+    // No blank line under the type line: a blank means a new block, and here it
+    // opened a block that had no heading. Facts about the session touch the
+    // line that names it, the way they do on every job card.
     field('Project', e.workdir),
     field('Reason', e.reason),
     e.opened ? '' : null,

package/dist/trend.d.ts

@@ -0,0 +1,23 @@
+/**
+ * One number, written the one way every card writes a number.
+ *
+ * Two report senders each grew their own dialect: one printed `485 ▲207` and
+ * `0 =`, the other printed `210 +3` for a real comparison and `+37` for a
+ * plain count of what happened today — a plus sign in front of a number that
+ * was never compared to anything. Inside a single group `Removed: 3` stood
+ * next to `Added: +6`, the same kind of fact in two shapes.
+ *
+ * So the shape is not a sender's business any more. It lives here, one
+ * implementation, and every report calls it:
+ *
+ *   trend(210, 207)        → '210 ▲3'
+ *   trend(202, 207)        → '202 ▼5'
+ *   trend(0, 0)            → '0 ='
+ *   trend(37)              → '37'          nothing to compare to, so no mark
+ *   trend(4.4, 3.6, '%')   → '4.4% ▲0.8'   the mark is in the unit left of it
+ *
+ * The rule the owner asked for, in one line: where there is data to compare
+ * against, the arrow is printed; where there is none, nothing is printed —
+ * never a sign that only looks like a comparison.
+ */
+export declare const trend: (now: number, was?: number, unit?: string) => string;

package/dist/trend.js

@@ -0,0 +1,39 @@
+/**
+ * One number, written the one way every card writes a number.
+ *
+ * Two report senders each grew their own dialect: one printed `485 ▲207` and
+ * `0 =`, the other printed `210 +3` for a real comparison and `+37` for a
+ * plain count of what happened today — a plus sign in front of a number that
+ * was never compared to anything. Inside a single group `Removed: 3` stood
+ * next to `Added: +6`, the same kind of fact in two shapes.
+ *
+ * So the shape is not a sender's business any more. It lives here, one
+ * implementation, and every report calls it:
+ *
+ *   trend(210, 207)        → '210 ▲3'
+ *   trend(202, 207)        → '202 ▼5'
+ *   trend(0, 0)            → '0 ='
+ *   trend(37)              → '37'          nothing to compare to, so no mark
+ *   trend(4.4, 3.6, '%')   → '4.4% ▲0.8'   the mark is in the unit left of it
+ *
+ * The rule the owner asked for, in one line: where there is data to compare
+ * against, the arrow is printed; where there is none, nothing is printed —
+ * never a sign that only looks like a comparison.
+ */
+/** Integers stay integers; anything else keeps one decimal. */
+const fmt = (n) => (Number.isInteger(n) ? String(n) : n.toFixed(1));
+/**
+ * Two values that round to the same first decimal are equal: `4.42%` against
+ * `4.44%` is not movement, it is noise, and `▲0.0` reads as a lie.
+ */
+const same = (a, b) => Math.abs(a - b) < 0.05;
+export const trend = (now, was, unit = '') => {
+    const head = `${fmt(now)}${unit}`;
+    if (was === undefined || !Number.isFinite(was)) {
+        return head;
+    }
+    if (same(now, was)) {
+        return `${head} =`;
+    }
+    return now > was ? `${head} ▲${fmt(now - was)}` : `${head} ▼${fmt(was - now)}`;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikitasazan/notify",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "Единая типизированная отправка Telegram-уведомлений (форум-темы, маршрутизация, ретраи) для всех проектов",
   "type": "module",
   "license": "MIT",