@4fu/arbor-prompt 0.0.0-stage → 0.1.0

package/time.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The one time format every block carries (docs/prompting.md#deliveries).
+ *
+ * A block's time is the instant it was written, formatted once here so no
+ * component writes its own. The format is fixed and UTC, so the same block
+ * always renders to the same bytes.
+ */
+/** `2026-11-05 07:42:35`, always UTC. */
+export declare function formatTime(time: number): string;

package/time.js

@@ -0,0 +1,17 @@
+/**
+ * The one time format every block carries (docs/prompting.md#deliveries).
+ *
+ * A block's time is the instant it was written, formatted once here so no
+ * component writes its own. The format is fixed and UTC, so the same block
+ * always renders to the same bytes.
+ */
+const PAD = 2;
+function two(value) {
+    return String(value).padStart(PAD, "0");
+}
+/** `2026-11-05 07:42:35`, always UTC. */
+export function formatTime(time) {
+    const date = new Date(time);
+    return (`${date.getUTCFullYear()}-${two(date.getUTCMonth() + 1)}-${two(date.getUTCDate())} ` +
+        `${two(date.getUTCHours())}:${two(date.getUTCMinutes())}:${two(date.getUTCSeconds())}`);
+}