@node-cli/timer 2.1.2 → 2.2.1

package/README.md

@@ -27,9 +27,37 @@ Start a timer for 1 minute and 42 seconds
 Get help
 
 ```sh
-> search --help
+> timer --help
 ```
 
+## Notifications
+
+When the timer is done it raises a desktop notification. On macOS this is a
+dialog carrying the timer's own icon, which stays on screen until you dismiss
+it — a banner auto-dismisses after a few seconds, so a timer that fires while
+you are away from the keyboard would leave nothing behind. The dialog is
+released detached, so the timer itself exits immediately and never blocks
+whatever you chained behind it.
+
+Prefer the passive banner:
+
+```sh
+> timer 1m42s --banner
+```
+
+Turn notifications off entirely:
+
+```sh
+> timer 1m42s --no-notification
+```
+
+`--banner` is macOS-only; Linux (`notify-send`) and Windows (toast) always use
+their native banner.
+
+Be aware that macOS silently suppresses banners while a Focus mode is on or
+while you are sharing your screen — `--banner` will appear to do nothing. The
+dialog is an ordinary window, so it is not affected by either.
+
 ## License
 
 MIT © Arno Versini

package/assets/hourglass.svg

@@ -0,0 +1,30 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024">
+	<defs>
+		<linearGradient id="bg" x1="0" y1="0" x2="0" y2="1">
+			<stop offset="0" stop-color="#4F8DF7" />
+			<stop offset="1" stop-color="#1D4ED8" />
+		</linearGradient>
+		<linearGradient id="sand" x1="0" y1="0" x2="0" y2="1">
+			<stop offset="0" stop-color="#FDE68A" />
+			<stop offset="1" stop-color="#F59E0B" />
+		</linearGradient>
+	</defs>
+
+	<rect width="1024" height="1024" rx="228" ry="228" fill="url(#bg)" />
+
+	<g fill="none" stroke="#FFFFFF" stroke-width="34" stroke-linejoin="round" stroke-linecap="round">
+		<path d="M330 280 L694 280 L512 512 Z" />
+		<path d="M512 512 L694 744 L330 744 Z" />
+	</g>
+
+	<g fill="url(#sand)">
+		<path d="M448 430 L576 430 L512 512 Z" />
+		<path d="M404 650 L620 650 L694 744 L330 744 Z" />
+		<rect x="500" y="512" width="24" height="140" />
+	</g>
+
+	<g fill="#FFFFFF">
+		<rect x="288" y="232" width="448" height="52" rx="26" ry="26" />
+		<rect x="288" y="740" width="448" height="52" rx="26" ry="26" />
+	</g>
+</svg>

package/dist/defaults.d.ts

@@ -1,4 +1,5 @@
 export declare const defaultFlags: {
+    banner: boolean;
     boring: boolean;
     notification: boolean;
 };

package/dist/defaults.js

@@ -1,4 +1,5 @@
 /* v8 ignore start */ export const defaultFlags = {
+    banner: false,
     boring: false,
     notification: true
 }; /* v8 ignore stop */ 

package/dist/defaults.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/defaults.ts"],"sourcesContent":["/* v8 ignore start */\nexport const defaultFlags = {\n\tboring: false,\n\tnotification: true,\n};\n/* v8 ignore stop */\n"],"names":["defaultFlags","boring","notification"],"mappings":"AAAA,mBAAmB,GACnB,OAAO,MAAMA,eAAe;IAC3BC,QAAQ;IACRC,cAAc;AACf,EAAE,CACF,kBAAkB"}
+{"version":3,"sources":["../src/defaults.ts"],"sourcesContent":["/* v8 ignore start */\nexport const defaultFlags = {\n\tbanner: false,\n\tboring: false,\n\tnotification: true,\n};\n/* v8 ignore stop */\n"],"names":["defaultFlags","banner","boring","notification"],"mappings":"AAAA,mBAAmB,GACnB,OAAO,MAAMA,eAAe;IAC3BC,QAAQ;IACRC,QAAQ;IACRC,cAAc;AACf,EAAE,CACF,kBAAkB"}

package/dist/notify.d.ts

@@ -1,4 +1,5 @@
 export type Notification = {
+    banner?: boolean;
     message: string;
     sound?: string;
     title: string;
@@ -6,6 +7,7 @@ export type Notification = {
 export type NotifyCommand = {
     args: string[];
     command: string;
+    detached: boolean;
 };
 /**
  * Builds the platform-native command used to display a desktop notification.
@@ -14,6 +16,10 @@ export type NotifyCommand = {
  * Every supported platform ships its notifier as part of the OS, so nothing is
  * vendored and nothing has to match the host CPU architecture.
  *
+ * Only macOS distinguishes an alert from a banner: it is the platform whose
+ * banner cannot carry our icon, and the one where the dialog is available for
+ * free. Linux and Windows always get their native banner.
+ *
  */
 export declare const buildNotifyCommand: (platform: string, notification: Notification) => NotifyCommand | null;
 /**

package/dist/notify.js

@@ -1,4 +1,5 @@
-import { execFile } from "node:child_process";
+import { execFile, spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
 import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
 /**
@@ -6,6 +7,11 @@ const execFileAsync = promisify(execFile);
  * it is killed outright rather than merely asked to stop: a wedged child can
  * ignore SIGTERM.
  */ const NOTIFIER_TIMEOUT_MS = 5000;
+/**
+ * Resolved from this module rather than the process, so it survives being
+ * invoked through a symlinked bin. `src` and `dist` sit at the same depth, so
+ * the same relative path works whether the source or the build is running.
+ */ const ALERT_ICON_PATH = fileURLToPath(new URL("../assets/hourglass.png", import.meta.url));
 /**
  * Escapes a value so it can be embedded in an AppleScript double-quoted string
  * literal, where only backslashes and double quotes are special.
@@ -14,7 +20,7 @@ const execFileAsync = promisify(execFile);
  * Escapes a value so it can be embedded in a PowerShell single-quoted string
  * literal, where a single quote is escaped by doubling it.
  */ const escapePowerShell = (value)=>value.replaceAll("'", "''");
-const macCommand = ({ message, sound, title })=>{
+const macBannerCommand = ({ message, sound, title })=>{
     const script = [
         `display notification "${escapeAppleScript(message)}"`,
         `with title "${escapeAppleScript(title)}"`,
@@ -25,7 +31,41 @@ const macCommand = ({ message, sound, title })=>{
             "-e",
             script
         ],
-        command: "osascript"
+        command: "osascript",
+        detached: false
+    };
+};
+/**
+ * A banner auto-dismisses after a few seconds, so a timer that fires while you
+ * are away from the keyboard leaves nothing behind. This dialog waits until it
+ * is acknowledged, which is the behaviour an alarm actually wants.
+ *
+ * `display dialog` takes an arbitrary image, which is the only way to escape
+ * the Script Editor icon macOS otherwise stamps on anything osascript posts.
+ *
+ */ const macAlertCommand = ({ message, sound, title })=>{
+    const dialog = [
+        `display dialog "${escapeAppleScript(message)}"`,
+        `with title "${escapeAppleScript(title)}"`,
+        `with icon (POSIX file "${escapeAppleScript(ALERT_ICON_PATH)}")`,
+        'buttons {"OK"} default button "OK"'
+    ].join(" ");
+    /**
+	 * `display dialog` has no sound parameter, so the alert sound is played
+	 * alongside it. Backgrounded and silenced because a missing sound file must
+	 * not stall or fail the dialog.
+	 */ const play = sound ? [
+        "-e",
+        `do shell script "afplay /System/Library/Sounds/${escapeAppleScript(sound)}.aiff > /dev/null 2>&1 &"`
+    ] : [];
+    return {
+        args: [
+            ...play,
+            "-e",
+            dialog
+        ],
+        command: "osascript",
+        detached: true
     };
 };
 const linuxCommand = ({ message, title })=>({
@@ -33,7 +73,8 @@ const linuxCommand = ({ message, title })=>({
             title,
             message
         ],
-        command: "notify-send"
+        command: "notify-send",
+        detached: false
     });
 const windowsCommand = ({ message, title })=>{
     const script = [
@@ -49,7 +90,8 @@ const windowsCommand = ({ message, title })=>{
             "-Command",
             script
         ],
-        command: "powershell"
+        command: "powershell",
+        detached: false
     };
 };
 /**
@@ -59,11 +101,15 @@ const windowsCommand = ({ message, title })=>{
  * Every supported platform ships its notifier as part of the OS, so nothing is
  * vendored and nothing has to match the host CPU architecture.
  *
+ * Only macOS distinguishes an alert from a banner: it is the platform whose
+ * banner cannot carry our icon, and the one where the dialog is available for
+ * free. Linux and Windows always get their native banner.
+ *
  */ export const buildNotifyCommand = (platform, notification)=>{
     switch(platform){
         case "darwin":
             {
-                return macCommand(notification);
+                return notification.banner ? macBannerCommand(notification) : macAlertCommand(notification);
             }
         case "linux":
             {
@@ -79,6 +125,27 @@ const windowsCommand = ({ message, title })=>{
             }
     }
 };
+/**
+ * Releases a notifier that must outlive the CLI. An alert waits for a human, so
+ * awaiting it would hold the timer open until the dialog is clicked and stall
+ * anything chained behind it.
+ *
+ * Detaching costs the delivery result: spawn reports failure asynchronously,
+ * long after the CLI is gone. The caller is told only that the alert was
+ * released, which is all a best-effort courtesy needs to report.
+ *
+ */ const release = ({ args, command })=>{
+    const child = spawn(command, args, {
+        detached: true,
+        stdio: "ignore"
+    });
+    /**
+	 * An unhandled "error" event on a child process is thrown, so a notifier that
+	 * cannot spawn at all would take the timer down with it.
+	 */ child.on("error", ()=>{});
+    child.unref();
+    return true;
+};
 /**
  * Displays a desktop notification, resolving to true when it was shown.
  *
@@ -92,6 +159,9 @@ const windowsCommand = ({ message, title })=>{
         if (notifyCommand === null) {
             return false;
         }
+        if (notifyCommand.detached) {
+            return release(notifyCommand);
+        }
         await execFileAsync(notifyCommand.command, notifyCommand.args, {
             killSignal: "SIGKILL",
             timeout: NOTIFIER_TIMEOUT_MS

package/dist/notify.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/notify.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\n\nconst execFileAsync = promisify(execFile);\n\n/**\n * A notifier that spawns but never exits would keep the CLI alive forever, so\n * it is killed outright rather than merely asked to stop: a wedged child can\n * ignore SIGTERM.\n */\nconst NOTIFIER_TIMEOUT_MS = 5000;\n\nexport type Notification = {\n\tmessage: string;\n\tsound?: string;\n\ttitle: string;\n};\n\nexport type NotifyCommand = {\n\targs: string[];\n\tcommand: string;\n};\n\n/**\n * Escapes a value so it can be embedded in an AppleScript double-quoted string\n * literal, where only backslashes and double quotes are special.\n */\nconst escapeAppleScript = (value: string): string =>\n\tvalue.replaceAll(\"\\\\\", \"\\\\\\\\\").replaceAll('\"', '\\\\\"');\n\n/**\n * Escapes a value so it can be embedded in a PowerShell single-quoted string\n * literal, where a single quote is escaped by doubling it.\n */\nconst escapePowerShell = (value: string): string => value.replaceAll(\"'\", \"''\");\n\nconst macCommand = ({ message, sound, title }: Notification): NotifyCommand => {\n\tconst script = [\n\t\t`display notification \"${escapeAppleScript(message)}\"`,\n\t\t`with title \"${escapeAppleScript(title)}\"`,\n\t\tsound ? `sound name \"${escapeAppleScript(sound)}\"` : \"\",\n\t]\n\t\t.filter(Boolean)\n\t\t.join(\" \");\n\n\treturn { args: [\"-e\", script], command: \"osascript\" };\n};\n\nconst linuxCommand = ({ message, title }: Notification): NotifyCommand => ({\n\targs: [title, message],\n\tcommand: \"notify-send\",\n});\n\nconst windowsCommand = ({ message, title }: Notification): NotifyCommand => {\n\tconst script = [\n\t\t\"[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] > $null\",\n\t\t\"$xml = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent([Windows.UI.Notifications.ToastTemplateType]::ToastText02)\",\n\t\t`$xml.GetElementsByTagName('text')[0].AppendChild($xml.CreateTextNode('${escapePowerShell(title)}')) > $null`,\n\t\t`$xml.GetElementsByTagName('text')[1].AppendChild($xml.CreateTextNode('${escapePowerShell(message)}')) > $null`,\n\t\t\"[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('@node-cli/timer').Show([Windows.UI.Notifications.ToastNotification]::new($xml))\",\n\t].join(\"; \");\n\n\treturn { args: [\"-NoProfile\", \"-Command\", script], command: \"powershell\" };\n};\n\n/**\n * Builds the platform-native command used to display a desktop notification.\n * Returns null on platforms we do not know how to notify on.\n *\n * Every supported platform ships its notifier as part of the OS, so nothing is\n * vendored and nothing has to match the host CPU architecture.\n *\n */\nexport const buildNotifyCommand = (\n\tplatform: string,\n\tnotification: Notification,\n): NotifyCommand | null => {\n\tswitch (platform) {\n\t\tcase \"darwin\": {\n\t\t\treturn macCommand(notification);\n\t\t}\n\t\tcase \"linux\": {\n\t\t\treturn linuxCommand(notification);\n\t\t}\n\t\tcase \"win32\": {\n\t\t\treturn windowsCommand(notification);\n\t\t}\n\t\tdefault: {\n\t\t\treturn null;\n\t\t}\n\t}\n};\n\n/**\n * Displays a desktop notification, resolving to true when it was shown.\n *\n * A notification is a courtesy, never a reason to fail: an unsupported\n * platform, a missing notifier, or a notifier that refuses to run all resolve\n * to false instead of throwing.\n *\n */\nexport const notify = async (\n\tnotification: Notification,\n\tplatform: string = process.platform,\n): Promise<boolean> => {\n\ttry {\n\t\tconst notifyCommand = buildNotifyCommand(platform, notification);\n\n\t\tif (notifyCommand === null) {\n\t\t\treturn false;\n\t\t}\n\n\t\tawait execFileAsync(notifyCommand.command, notifyCommand.args, {\n\t\t\tkillSignal: \"SIGKILL\",\n\t\t\ttimeout: NOTIFIER_TIMEOUT_MS,\n\t\t});\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n};\n"],"names":["execFile","promisify","execFileAsync","NOTIFIER_TIMEOUT_MS","escapeAppleScript","value","replaceAll","escapePowerShell","macCommand","message","sound","title","script","filter","Boolean","join","args","command","linuxCommand","windowsCommand","buildNotifyCommand","platform","notification","notify","process","notifyCommand","killSignal","timeout"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,qBAAqB;AAC9C,SAASC,SAAS,QAAQ,YAAY;AAEtC,MAAMC,gBAAgBD,UAAUD;AAEhC;;;;CAIC,GACD,MAAMG,sBAAsB;AAa5B;;;CAGC,GACD,MAAMC,oBAAoB,CAACC,QAC1BA,MAAMC,UAAU,CAAC,MAAM,QAAQA,UAAU,CAAC,KAAK;AAEhD;;;CAGC,GACD,MAAMC,mBAAmB,CAACF,QAA0BA,MAAMC,UAAU,CAAC,KAAK;AAE1E,MAAME,aAAa,CAAC,EAAEC,OAAO,EAAEC,KAAK,EAAEC,KAAK,EAAgB;IAC1D,MAAMC,SAAS;QACd,CAAC,sBAAsB,EAAER,kBAAkBK,SAAS,CAAC,CAAC;QACtD,CAAC,YAAY,EAAEL,kBAAkBO,OAAO,CAAC,CAAC;QAC1CD,QAAQ,CAAC,YAAY,EAAEN,kBAAkBM,OAAO,CAAC,CAAC,GAAG;KACrD,CACCG,MAAM,CAACC,SACPC,IAAI,CAAC;IAEP,OAAO;QAAEC,MAAM;YAAC;YAAMJ;SAAO;QAAEK,SAAS;IAAY;AACrD;AAEA,MAAMC,eAAe,CAAC,EAAET,OAAO,EAAEE,KAAK,EAAgB,GAAqB,CAAA;QAC1EK,MAAM;YAACL;YAAOF;SAAQ;QACtBQ,SAAS;IACV,CAAA;AAEA,MAAME,iBAAiB,CAAC,EAAEV,OAAO,EAAEE,KAAK,EAAgB;IACvD,MAAMC,SAAS;QACd;QACA;QACA,CAAC,sEAAsE,EAAEL,iBAAiBI,OAAO,WAAW,CAAC;QAC7G,CAAC,sEAAsE,EAAEJ,iBAAiBE,SAAS,WAAW,CAAC;QAC/G;KACA,CAACM,IAAI,CAAC;IAEP,OAAO;QAAEC,MAAM;YAAC;YAAc;YAAYJ;SAAO;QAAEK,SAAS;IAAa;AAC1E;AAEA;;;;;;;CAOC,GACD,OAAO,MAAMG,qBAAqB,CACjCC,UACAC;IAEA,OAAQD;QACP,KAAK;YAAU;gBACd,OAAOb,WAAWc;YACnB;QACA,KAAK;YAAS;gBACb,OAAOJ,aAAaI;YACrB;QACA,KAAK;YAAS;gBACb,OAAOH,eAAeG;YACvB;QACA;YAAS;gBACR,OAAO;YACR;IACD;AACD,EAAE;AAEF;;;;;;;CAOC,GACD,OAAO,MAAMC,SAAS,OACrBD,cACAD,WAAmBG,QAAQH,QAAQ;IAEnC,IAAI;QACH,MAAMI,gBAAgBL,mBAAmBC,UAAUC;QAEnD,IAAIG,kBAAkB,MAAM;YAC3B,OAAO;QACR;QAEA,MAAMvB,cAAcuB,cAAcR,OAAO,EAAEQ,cAAcT,IAAI,EAAE;YAC9DU,YAAY;YACZC,SAASxB;QACV;QACA,OAAO;IACR,EAAE,OAAM;QACP,OAAO;IACR;AACD,EAAE"}
+{"version":3,"sources":["../src/notify.ts"],"sourcesContent":["import { execFile, spawn } from \"node:child_process\";\nimport { fileURLToPath } from \"node:url\";\nimport { promisify } from \"node:util\";\n\nconst execFileAsync = promisify(execFile);\n\n/**\n * A notifier that spawns but never exits would keep the CLI alive forever, so\n * it is killed outright rather than merely asked to stop: a wedged child can\n * ignore SIGTERM.\n */\nconst NOTIFIER_TIMEOUT_MS = 5000;\n\n/**\n * Resolved from this module rather than the process, so it survives being\n * invoked through a symlinked bin. `src` and `dist` sit at the same depth, so\n * the same relative path works whether the source or the build is running.\n */\nconst ALERT_ICON_PATH = fileURLToPath(\n\tnew URL(\"../assets/hourglass.png\", import.meta.url),\n);\n\nexport type Notification = {\n\tbanner?: boolean;\n\tmessage: string;\n\tsound?: string;\n\ttitle: string;\n};\n\nexport type NotifyCommand = {\n\targs: string[];\n\tcommand: string;\n\tdetached: boolean;\n};\n\n/**\n * Escapes a value so it can be embedded in an AppleScript double-quoted string\n * literal, where only backslashes and double quotes are special.\n */\nconst escapeAppleScript = (value: string): string =>\n\tvalue.replaceAll(\"\\\\\", \"\\\\\\\\\").replaceAll('\"', '\\\\\"');\n\n/**\n * Escapes a value so it can be embedded in a PowerShell single-quoted string\n * literal, where a single quote is escaped by doubling it.\n */\nconst escapePowerShell = (value: string): string => value.replaceAll(\"'\", \"''\");\n\nconst macBannerCommand = ({\n\tmessage,\n\tsound,\n\ttitle,\n}: Notification): NotifyCommand => {\n\tconst script = [\n\t\t`display notification \"${escapeAppleScript(message)}\"`,\n\t\t`with title \"${escapeAppleScript(title)}\"`,\n\t\tsound ? `sound name \"${escapeAppleScript(sound)}\"` : \"\",\n\t]\n\t\t.filter(Boolean)\n\t\t.join(\" \");\n\n\treturn { args: [\"-e\", script], command: \"osascript\", detached: false };\n};\n\n/**\n * A banner auto-dismisses after a few seconds, so a timer that fires while you\n * are away from the keyboard leaves nothing behind. This dialog waits until it\n * is acknowledged, which is the behaviour an alarm actually wants.\n *\n * `display dialog` takes an arbitrary image, which is the only way to escape\n * the Script Editor icon macOS otherwise stamps on anything osascript posts.\n *\n */\nconst macAlertCommand = ({\n\tmessage,\n\tsound,\n\ttitle,\n}: Notification): NotifyCommand => {\n\tconst dialog = [\n\t\t`display dialog \"${escapeAppleScript(message)}\"`,\n\t\t`with title \"${escapeAppleScript(title)}\"`,\n\t\t`with icon (POSIX file \"${escapeAppleScript(ALERT_ICON_PATH)}\")`,\n\t\t'buttons {\"OK\"} default button \"OK\"',\n\t].join(\" \");\n\n\t/**\n\t * `display dialog` has no sound parameter, so the alert sound is played\n\t * alongside it. Backgrounded and silenced because a missing sound file must\n\t * not stall or fail the dialog.\n\t */\n\tconst play = sound\n\t\t? [\n\t\t\t\t\"-e\",\n\t\t\t\t`do shell script \"afplay /System/Library/Sounds/${escapeAppleScript(sound)}.aiff > /dev/null 2>&1 &\"`,\n\t\t\t]\n\t\t: [];\n\n\treturn {\n\t\targs: [...play, \"-e\", dialog],\n\t\tcommand: \"osascript\",\n\t\tdetached: true,\n\t};\n};\n\nconst linuxCommand = ({ message, title }: Notification): NotifyCommand => ({\n\targs: [title, message],\n\tcommand: \"notify-send\",\n\tdetached: false,\n});\n\nconst windowsCommand = ({ message, title }: Notification): NotifyCommand => {\n\tconst script = [\n\t\t\"[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] > $null\",\n\t\t\"$xml = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent([Windows.UI.Notifications.ToastTemplateType]::ToastText02)\",\n\t\t`$xml.GetElementsByTagName('text')[0].AppendChild($xml.CreateTextNode('${escapePowerShell(title)}')) > $null`,\n\t\t`$xml.GetElementsByTagName('text')[1].AppendChild($xml.CreateTextNode('${escapePowerShell(message)}')) > $null`,\n\t\t\"[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('@node-cli/timer').Show([Windows.UI.Notifications.ToastNotification]::new($xml))\",\n\t].join(\"; \");\n\n\treturn {\n\t\targs: [\"-NoProfile\", \"-Command\", script],\n\t\tcommand: \"powershell\",\n\t\tdetached: false,\n\t};\n};\n\n/**\n * Builds the platform-native command used to display a desktop notification.\n * Returns null on platforms we do not know how to notify on.\n *\n * Every supported platform ships its notifier as part of the OS, so nothing is\n * vendored and nothing has to match the host CPU architecture.\n *\n * Only macOS distinguishes an alert from a banner: it is the platform whose\n * banner cannot carry our icon, and the one where the dialog is available for\n * free. Linux and Windows always get their native banner.\n *\n */\nexport const buildNotifyCommand = (\n\tplatform: string,\n\tnotification: Notification,\n): NotifyCommand | null => {\n\tswitch (platform) {\n\t\tcase \"darwin\": {\n\t\t\treturn notification.banner\n\t\t\t\t? macBannerCommand(notification)\n\t\t\t\t: macAlertCommand(notification);\n\t\t}\n\t\tcase \"linux\": {\n\t\t\treturn linuxCommand(notification);\n\t\t}\n\t\tcase \"win32\": {\n\t\t\treturn windowsCommand(notification);\n\t\t}\n\t\tdefault: {\n\t\t\treturn null;\n\t\t}\n\t}\n};\n\n/**\n * Releases a notifier that must outlive the CLI. An alert waits for a human, so\n * awaiting it would hold the timer open until the dialog is clicked and stall\n * anything chained behind it.\n *\n * Detaching costs the delivery result: spawn reports failure asynchronously,\n * long after the CLI is gone. The caller is told only that the alert was\n * released, which is all a best-effort courtesy needs to report.\n *\n */\nconst release = ({ args, command }: NotifyCommand): boolean => {\n\tconst child = spawn(command, args, { detached: true, stdio: \"ignore\" });\n\n\t/**\n\t * An unhandled \"error\" event on a child process is thrown, so a notifier that\n\t * cannot spawn at all would take the timer down with it.\n\t */\n\tchild.on(\"error\", () => {});\n\tchild.unref();\n\treturn true;\n};\n\n/**\n * Displays a desktop notification, resolving to true when it was shown.\n *\n * A notification is a courtesy, never a reason to fail: an unsupported\n * platform, a missing notifier, or a notifier that refuses to run all resolve\n * to false instead of throwing.\n *\n */\nexport const notify = async (\n\tnotification: Notification,\n\tplatform: string = process.platform,\n): Promise<boolean> => {\n\ttry {\n\t\tconst notifyCommand = buildNotifyCommand(platform, notification);\n\n\t\tif (notifyCommand === null) {\n\t\t\treturn false;\n\t\t}\n\n\t\tif (notifyCommand.detached) {\n\t\t\treturn release(notifyCommand);\n\t\t}\n\n\t\tawait execFileAsync(notifyCommand.command, notifyCommand.args, {\n\t\t\tkillSignal: \"SIGKILL\",\n\t\t\ttimeout: NOTIFIER_TIMEOUT_MS,\n\t\t});\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n};\n"],"names":["execFile","spawn","fileURLToPath","promisify","execFileAsync","NOTIFIER_TIMEOUT_MS","ALERT_ICON_PATH","URL","url","escapeAppleScript","value","replaceAll","escapePowerShell","macBannerCommand","message","sound","title","script","filter","Boolean","join","args","command","detached","macAlertCommand","dialog","play","linuxCommand","windowsCommand","buildNotifyCommand","platform","notification","banner","release","child","stdio","on","unref","notify","process","notifyCommand","killSignal","timeout"],"mappings":"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"}

package/dist/parse.js

@@ -13,6 +13,11 @@ import { defaultFlags } from "./defaults.js";
         }
     ],
     flags: {
+        banner: {
+            default: defaultFlags.banner,
+            description: "Show a passive banner instead of a dialog that waits to be dismissed (macOS only)",
+            type: "boolean"
+        },
         boring: {
             shortFlag: "b",
             default: defaultFlags.boring,

package/dist/parse.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/parse.ts"],"sourcesContent":["/* v8 ignore start */\nimport { parser } from \"@node-cli/parser\";\nimport { defaultFlags } from \"./defaults.js\";\n\nexport type Parameters = {\n\t[\"0\"]?: string;\n};\nexport type Configuration = {\n\tflags?: any;\n\tparameters?: Parameters;\n\tshowHelp?: () => void;\n};\n\n/* v8 ignore next 45 */\nexport const config: Configuration = parser({\n\tmeta: import.meta,\n\texamples: [\n\t\t{\n\t\t\tcommand: \"timer 4h2m15s\",\n\t\t\tcomment: \"## Start a timer for 4 hours, 2 minutes and 15 seconds\",\n\t\t},\n\t\t{\n\t\t\tcommand: \"timer 1m42s\",\n\t\t\tcomment: \"## Start a timer for 1 minute and 42 seconds\",\n\t\t},\n\t],\n\tflags: {\n\t\tboring: {\n\t\t\tshortFlag: \"b\",\n\t\t\tdefault: defaultFlags.boring,\n\t\t\tdescription: \"Do not use color output\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t\thelp: {\n\t\t\tshortFlag: \"h\",\n\t\t\tdescription: \"Display help instructions\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t\tnotification: {\n\t\t\tshortFlag: \"n\",\n\t\t\tdefault: defaultFlags.notification,\n\t\t\tdescription: \"Display a notification when the timer is done\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t\tversion: {\n\t\t\tshortFlag: \"v\",\n\t\t\tdescription: \"Output the current version\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t},\n\tparameters: {\n\t\tformattedTime: {\n\t\t\tdescription: \"Formatted time to start the timer\",\n\t\t},\n\t},\n\n\tusage: \"timer [formattedTime]\",\n});\n/* v8 ignore stop */\n"],"names":["parser","defaultFlags","config","meta","examples","command","comment","flags","boring","shortFlag","default","description","type","help","notification","version","parameters","formattedTime","usage"],"mappings":"AAAA,mBAAmB,GACnB,SAASA,MAAM,QAAQ,mBAAmB;AAC1C,SAASC,YAAY,QAAQ,gBAAgB;AAW7C,qBAAqB,GACrB,OAAO,MAAMC,SAAwBF,OAAO;IAC3CG,MAAM;IACNC,UAAU;QACT;YACCC,SAAS;YACTC,SAAS;QACV;QACA;YACCD,SAAS;YACTC,SAAS;QACV;KACA;IACDC,OAAO;QACNC,QAAQ;YACPC,WAAW;YACXC,SAAST,aAAaO,MAAM;YAC5BG,aAAa;YACbC,MAAM;QACP;QACAC,MAAM;YACLJ,WAAW;YACXE,aAAa;YACbC,MAAM;QACP;QACAE,cAAc;YACbL,WAAW;YACXC,SAAST,aAAaa,YAAY;YAClCH,aAAa;YACbC,MAAM;QACP;QACAG,SAAS;YACRN,WAAW;YACXE,aAAa;YACbC,MAAM;QACP;IACD;IACAI,YAAY;QACXC,eAAe;YACdN,aAAa;QACd;IACD;IAEAO,OAAO;AACR,GAAG,CACH,kBAAkB"}
+{"version":3,"sources":["../src/parse.ts"],"sourcesContent":["/* v8 ignore start */\nimport { parser } from \"@node-cli/parser\";\nimport { defaultFlags } from \"./defaults.js\";\n\nexport type Parameters = {\n\t[\"0\"]?: string;\n};\nexport type Configuration = {\n\tflags?: any;\n\tparameters?: Parameters;\n\tshowHelp?: () => void;\n};\n\n/* v8 ignore next 45 */\nexport const config: Configuration = parser({\n\tmeta: import.meta,\n\texamples: [\n\t\t{\n\t\t\tcommand: \"timer 4h2m15s\",\n\t\t\tcomment: \"## Start a timer for 4 hours, 2 minutes and 15 seconds\",\n\t\t},\n\t\t{\n\t\t\tcommand: \"timer 1m42s\",\n\t\t\tcomment: \"## Start a timer for 1 minute and 42 seconds\",\n\t\t},\n\t],\n\tflags: {\n\t\tbanner: {\n\t\t\tdefault: defaultFlags.banner,\n\t\t\tdescription:\n\t\t\t\t\"Show a passive banner instead of a dialog that waits to be dismissed (macOS only)\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t\tboring: {\n\t\t\tshortFlag: \"b\",\n\t\t\tdefault: defaultFlags.boring,\n\t\t\tdescription: \"Do not use color output\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t\thelp: {\n\t\t\tshortFlag: \"h\",\n\t\t\tdescription: \"Display help instructions\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t\tnotification: {\n\t\t\tshortFlag: \"n\",\n\t\t\tdefault: defaultFlags.notification,\n\t\t\tdescription: \"Display a notification when the timer is done\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t\tversion: {\n\t\t\tshortFlag: \"v\",\n\t\t\tdescription: \"Output the current version\",\n\t\t\ttype: \"boolean\",\n\t\t},\n\t},\n\tparameters: {\n\t\tformattedTime: {\n\t\t\tdescription: \"Formatted time to start the timer\",\n\t\t},\n\t},\n\n\tusage: \"timer [formattedTime]\",\n});\n/* v8 ignore stop */\n"],"names":["parser","defaultFlags","config","meta","examples","command","comment","flags","banner","default","description","type","boring","shortFlag","help","notification","version","parameters","formattedTime","usage"],"mappings":"AAAA,mBAAmB,GACnB,SAASA,MAAM,QAAQ,mBAAmB;AAC1C,SAASC,YAAY,QAAQ,gBAAgB;AAW7C,qBAAqB,GACrB,OAAO,MAAMC,SAAwBF,OAAO;IAC3CG,MAAM;IACNC,UAAU;QACT;YACCC,SAAS;YACTC,SAAS;QACV;QACA;YACCD,SAAS;YACTC,SAAS;QACV;KACA;IACDC,OAAO;QACNC,QAAQ;YACPC,SAASR,aAAaO,MAAM;YAC5BE,aACC;YACDC,MAAM;QACP;QACAC,QAAQ;YACPC,WAAW;YACXJ,SAASR,aAAaW,MAAM;YAC5BF,aAAa;YACbC,MAAM;QACP;QACAG,MAAM;YACLD,WAAW;YACXH,aAAa;YACbC,MAAM;QACP;QACAI,cAAc;YACbF,WAAW;YACXJ,SAASR,aAAac,YAAY;YAClCL,aAAa;YACbC,MAAM;QACP;QACAK,SAAS;YACRH,WAAW;YACXH,aAAa;YACbC,MAAM;QACP;IACD;IACAM,YAAY;QACXC,eAAe;YACdR,aAAa;QACd;IACD;IAEAS,OAAO;AACR,GAAG,CACH,kBAAkB"}

package/dist/utilities.js

@@ -81,6 +81,7 @@ export const extractDuration = (config)=>{
 				 */ if (this.config.flags.notification) {
                     try {
                         await notify({
+                            banner: this.config.flags.banner,
                             message,
                             sound: "Funk",
                             title: "Timer Notification"

package/dist/utilities.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utilities.ts"],"sourcesContent":["import { Logger, Spinner } from \"@node-cli/logger\";\nimport moment, { Duration } from \"moment\";\n\nimport { notify } from \"./notify.js\";\nimport { Configuration } from \"./parse.js\";\n\nconst logger = new Logger();\n\n/**\n * discardStdin must stay off. When it is on, ora puts stdin in raw mode, which\n * stops the tty from turning Ctrl+C into SIGINT and delivers a bare 0x03 byte\n * instead. stdin-discarder means to re-send the signal itself, but it attaches\n * its reader with prependListener (which, unlike on(\"data\"), does not start a\n * paused stream flowing) and only calls resume() when stdin.isPaused() was true\n * beforehand. On a fresh process.stdin, flowing is null, so isPaused() is false\n * and the resume never happens: the byte is never read, the signal is never\n * re-sent, and Ctrl+C is swallowed for the life of the spinner.\n */\nconst spinner = new Spinner({ discardStdin: false });\n\nconst UNITS = {\n\tms: 1000,\n\ts: 1000 * 1000,\n\tm: 1000 * 1000 * 60,\n\th: 1000 * 1000 * 60 * 60,\n\td: 1000 * 1000 * 60 * 60 * 24,\n\tw: 1000 * 1000 * 60 * 60 * 24 * 7,\n};\n\nexport const timeToMicroseconds = (value: string, unit: string) => {\n\tconst result = UNITS[unit];\n\treturn result ? Number.parseInt(value, 10) * result : 0;\n};\n\nexport const extractDuration = (config: Configuration): Duration => {\n\tconst { parameters, showHelp } = config;\n\tlet totalMicroseconds = 0;\n\n\t/* v8 ignore next 6 */\n\tif (\n\t\tObject.entries(parameters).length === 0 ||\n\t\tObject.entries(parameters).length > 1\n\t) {\n\t\tshowHelp();\n\t}\n\n\tconst groups = parameters[\"0\"].toLowerCase().match(/[+-]?[\\d.]+[a-z]+/g);\n\n\t/* v8 ignore next 2 */\n\tif (groups === null) {\n\t\tshowHelp();\n\t} else {\n\t\tfor (const g of groups) {\n\t\t\tconst value = g.match(/[\\d.]+/g)[0];\n\t\t\tconst unit = g.match(/[a-z]+/g)[0];\n\t\t\ttotalMicroseconds += timeToMicroseconds(value, unit);\n\t\t}\n\t\treturn moment.duration(totalMicroseconds / UNITS.ms);\n\t}\n};\n\n/* v8 ignore start */\nexport class Timer {\n\tconfig: Configuration;\n\tstartTime: number;\n\ttimerDurationMilliSeconds: number;\n\tintroMessage: string;\n\ttimerDurationSeconds: number;\n\n\tconstructor(config: Configuration) {\n\t\tthis.config = config;\n\t\tconst result: Duration = extractDuration(this.config);\n\t\tthis.timerDurationMilliSeconds = result.asMilliseconds();\n\t\tthis.timerDurationSeconds = result.asSeconds();\n\t\tthis.introMessage = `${result.hours()}h ${result.minutes()}m ${result.seconds()}s`;\n\t}\n\n\tstart = () => {\n\t\tif (this.timerDurationMilliSeconds > 0) {\n\t\t\tlogger.printBox(`${this.introMessage}  `, {\n\t\t\t\tpadding: 0,\n\t\t\t\tborderColor: \"cyan\",\n\t\t\t\ttitle: \"Timer Configuration\",\n\t\t\t});\n\n\t\t\tthis.startTime = Date.now();\n\t\t\tspinner.start(this.introMessage);\n\n\t\t\t// update the spinner every second.\n\t\t\tthis.printRemainingTime();\n\t\t\tconst timer = setInterval(this.printRemainingTime, 1000);\n\n\t\t\t// kill the spinner when the timer is done.\n\t\t\tsetTimeout(async () => {\n\t\t\t\tconst message = \"Time's up!\";\n\t\t\t\tclearInterval(timer);\n\t\t\t\tthis.printRemainingTime(message);\n\t\t\t\tspinner.stop();\n\n\t\t\t\t/**\n\t\t\t\t * notifying last, and never fatally: a desktop notification that cannot be\n\t\t\t\t * displayed must not take the timer down with it.\n\t\t\t\t */\n\t\t\t\tif (this.config.flags.notification) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait notify({\n\t\t\t\t\t\t\tmessage,\n\t\t\t\t\t\t\tsound: \"Funk\",\n\t\t\t\t\t\t\ttitle: \"Timer Notification\",\n\t\t\t\t\t\t});\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t/**\n\t\t\t\t\t\t * notify is already total, so this only ever catches a future regression\n\t\t\t\t\t\t * in it. Rejecting here would be fatal: an async setTimeout callback has\n\t\t\t\t\t\t * nothing to attach a handler to.\n\t\t\t\t\t\t */\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}, this.timerDurationMilliSeconds);\n\t\t}\n\t};\n\n\tprivate printRemainingTime = (message: string | void) => {\n\t\tif (message) {\n\t\t\tspinner.text = message;\n\t\t} else {\n\t\t\tconst elapsed = (Date.now() - this.startTime) / 1000;\n\t\t\tconst duration = moment.duration(\n\t\t\t\t(this.timerDurationSeconds - elapsed) * 1000,\n\t\t\t);\n\t\t\tspinner.text = `${duration.hours()}h ${duration.minutes()}m ${duration.seconds()}s`;\n\t\t}\n\t};\n}\n/* v8 ignore stop */\n"],"names":["Logger","Spinner","moment","notify","logger","spinner","discardStdin","UNITS","ms","s","m","h","d","w","timeToMicroseconds","value","unit","result","Number","parseInt","extractDuration","config","parameters","showHelp","totalMicroseconds","Object","entries","length","groups","toLowerCase","match","g","duration","Timer","startTime","timerDurationMilliSeconds","introMessage","timerDurationSeconds","asMilliseconds","asSeconds","hours","minutes","seconds","start","printBox","padding","borderColor","title","Date","now","printRemainingTime","timer","setInterval","setTimeout","message","clearInterval","stop","flags","notification","sound","text","elapsed"],"mappings":"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"}
+{"version":3,"sources":["../src/utilities.ts"],"sourcesContent":["import { Logger, Spinner } from \"@node-cli/logger\";\nimport moment, { Duration } from \"moment\";\n\nimport { notify } from \"./notify.js\";\nimport { Configuration } from \"./parse.js\";\n\nconst logger = new Logger();\n\n/**\n * discardStdin must stay off. When it is on, ora puts stdin in raw mode, which\n * stops the tty from turning Ctrl+C into SIGINT and delivers a bare 0x03 byte\n * instead. stdin-discarder means to re-send the signal itself, but it attaches\n * its reader with prependListener (which, unlike on(\"data\"), does not start a\n * paused stream flowing) and only calls resume() when stdin.isPaused() was true\n * beforehand. On a fresh process.stdin, flowing is null, so isPaused() is false\n * and the resume never happens: the byte is never read, the signal is never\n * re-sent, and Ctrl+C is swallowed for the life of the spinner.\n */\nconst spinner = new Spinner({ discardStdin: false });\n\nconst UNITS = {\n\tms: 1000,\n\ts: 1000 * 1000,\n\tm: 1000 * 1000 * 60,\n\th: 1000 * 1000 * 60 * 60,\n\td: 1000 * 1000 * 60 * 60 * 24,\n\tw: 1000 * 1000 * 60 * 60 * 24 * 7,\n};\n\nexport const timeToMicroseconds = (value: string, unit: string) => {\n\tconst result = UNITS[unit];\n\treturn result ? Number.parseInt(value, 10) * result : 0;\n};\n\nexport const extractDuration = (config: Configuration): Duration => {\n\tconst { parameters, showHelp } = config;\n\tlet totalMicroseconds = 0;\n\n\t/* v8 ignore next 6 */\n\tif (\n\t\tObject.entries(parameters).length === 0 ||\n\t\tObject.entries(parameters).length > 1\n\t) {\n\t\tshowHelp();\n\t}\n\n\tconst groups = parameters[\"0\"].toLowerCase().match(/[+-]?[\\d.]+[a-z]+/g);\n\n\t/* v8 ignore next 2 */\n\tif (groups === null) {\n\t\tshowHelp();\n\t} else {\n\t\tfor (const g of groups) {\n\t\t\tconst value = g.match(/[\\d.]+/g)[0];\n\t\t\tconst unit = g.match(/[a-z]+/g)[0];\n\t\t\ttotalMicroseconds += timeToMicroseconds(value, unit);\n\t\t}\n\t\treturn moment.duration(totalMicroseconds / UNITS.ms);\n\t}\n};\n\n/* v8 ignore start */\nexport class Timer {\n\tconfig: Configuration;\n\tstartTime: number;\n\ttimerDurationMilliSeconds: number;\n\tintroMessage: string;\n\ttimerDurationSeconds: number;\n\n\tconstructor(config: Configuration) {\n\t\tthis.config = config;\n\t\tconst result: Duration = extractDuration(this.config);\n\t\tthis.timerDurationMilliSeconds = result.asMilliseconds();\n\t\tthis.timerDurationSeconds = result.asSeconds();\n\t\tthis.introMessage = `${result.hours()}h ${result.minutes()}m ${result.seconds()}s`;\n\t}\n\n\tstart = () => {\n\t\tif (this.timerDurationMilliSeconds > 0) {\n\t\t\tlogger.printBox(`${this.introMessage}  `, {\n\t\t\t\tpadding: 0,\n\t\t\t\tborderColor: \"cyan\",\n\t\t\t\ttitle: \"Timer Configuration\",\n\t\t\t});\n\n\t\t\tthis.startTime = Date.now();\n\t\t\tspinner.start(this.introMessage);\n\n\t\t\t// update the spinner every second.\n\t\t\tthis.printRemainingTime();\n\t\t\tconst timer = setInterval(this.printRemainingTime, 1000);\n\n\t\t\t// kill the spinner when the timer is done.\n\t\t\tsetTimeout(async () => {\n\t\t\t\tconst message = \"Time's up!\";\n\t\t\t\tclearInterval(timer);\n\t\t\t\tthis.printRemainingTime(message);\n\t\t\t\tspinner.stop();\n\n\t\t\t\t/**\n\t\t\t\t * notifying last, and never fatally: a desktop notification that cannot be\n\t\t\t\t * displayed must not take the timer down with it.\n\t\t\t\t */\n\t\t\t\tif (this.config.flags.notification) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait notify({\n\t\t\t\t\t\t\tbanner: this.config.flags.banner,\n\t\t\t\t\t\t\tmessage,\n\t\t\t\t\t\t\tsound: \"Funk\",\n\t\t\t\t\t\t\ttitle: \"Timer Notification\",\n\t\t\t\t\t\t});\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t/**\n\t\t\t\t\t\t * notify is already total, so this only ever catches a future regression\n\t\t\t\t\t\t * in it. Rejecting here would be fatal: an async setTimeout callback has\n\t\t\t\t\t\t * nothing to attach a handler to.\n\t\t\t\t\t\t */\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}, this.timerDurationMilliSeconds);\n\t\t}\n\t};\n\n\tprivate printRemainingTime = (message: string | void) => {\n\t\tif (message) {\n\t\t\tspinner.text = message;\n\t\t} else {\n\t\t\tconst elapsed = (Date.now() - this.startTime) / 1000;\n\t\t\tconst duration = moment.duration(\n\t\t\t\t(this.timerDurationSeconds - elapsed) * 1000,\n\t\t\t);\n\t\t\tspinner.text = `${duration.hours()}h ${duration.minutes()}m ${duration.seconds()}s`;\n\t\t}\n\t};\n}\n/* v8 ignore stop */\n"],"names":["Logger","Spinner","moment","notify","logger","spinner","discardStdin","UNITS","ms","s","m","h","d","w","timeToMicroseconds","value","unit","result","Number","parseInt","extractDuration","config","parameters","showHelp","totalMicroseconds","Object","entries","length","groups","toLowerCase","match","g","duration","Timer","startTime","timerDurationMilliSeconds","introMessage","timerDurationSeconds","asMilliseconds","asSeconds","hours","minutes","seconds","start","printBox","padding","borderColor","title","Date","now","printRemainingTime","timer","setInterval","setTimeout","message","clearInterval","stop","flags","notification","banner","sound","text","elapsed"],"mappings":"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"}

package/package.json

@@ -1,50 +1,52 @@
 {
-	"name": "@node-cli/timer",
-	"version": "2.1.2",
-	"license": "MIT",
-	"author": "Arno Versini",
-	"description": "Dead simpler CLI timer",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/versini-org/node-cli.git",
-		"directory": "packages/timer"
-	},
-	"type": "module",
-	"types": "./dist/index.d.ts",
-	"exports": "./dist/timer.js",
-	"bin": "dist/timer.js",
-	"files": [
-		"dist",
-		"README.md"
-	],
-	"engines": {
-		"node": ">=22"
-	},
-	"scripts": {
-		"build": "npm-run-all --serial clean build:types build:js build:barrel",
-		"build:barrel": "barrelsby --delete --directory dist --pattern \"**/*.d.ts\" --name \"index.d\"",
-		"build:js": "swc --strip-leading-paths --source-maps --out-dir dist src",
-		"build:types": "tsc",
-		"clean": "rimraf dist types coverage",
-		"comments:fix": "comments --merge-line-comments 'src/**/*.ts'",
-		"lint": "biome lint src",
-		"lint:fix": "biome check src --write --no-errors-on-unmatched",
-		"test": "vitest run --globals",
-		"test:coverage": "vitest run --coverage --globals",
-		"test:watch": "vitest --globals",
-		"watch": "swc --strip-leading-paths --watch --out-dir dist src"
-	},
-	"dependencies": {
-		"@node-cli/logger": "2.1.0",
-		"@node-cli/parser": "3.1.0",
-		"moment": "2.30.1"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"devDependencies": {
-		"@vitest/coverage-v8": "4.1.10",
-		"vitest": "4.1.10"
-	},
-	"gitHead": "9fdd995083ea81292321f20a3397122a18369b87"
-}
+  "name": "@node-cli/timer",
+  "version": "2.2.1",
+  "license": "MIT",
+  "author": "Arno Versini",
+  "description": "Dead simpler CLI timer",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/versini-org/node-cli.git",
+    "directory": "packages/timer"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": "./dist/timer.js",
+  "files": [
+    "assets",
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "moment": "2.30.1",
+    "@node-cli/logger": "2.1.1",
+    "@node-cli/parser": "3.1.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "4.1.11",
+    "vitest": "4.1.11"
+  },
+  "scripts": {
+    "build": "npm-run-all --serial clean build:types build:js build:barrel",
+    "build:barrel": "barrelsby --delete --directory dist --pattern \"**/*.d.ts\" --name \"index.d\"",
+    "build:js": "swc --strip-leading-paths --source-maps --out-dir dist src",
+    "build:types": "tsc",
+    "clean": "rimraf dist types coverage",
+    "comments:fix": "comments --merge-line-comments 'src/**/*.ts'",
+    "lint": "biome lint src",
+    "lint:fix": "biome check src --write --no-errors-on-unmatched",
+    "test": "vitest run --globals",
+    "test:coverage": "vitest run --coverage --globals",
+    "test:watch": "vitest --globals",
+    "watch": "swc --strip-leading-paths --watch --out-dir dist src"
+  },
+  "bin": {
+    "timer": "dist/timer.js"
+  }
+}