@maka/maka-cli 5.63.0 → 5.64.0

package/bundle/typescript/src/commands/game/sideQuest/utilities/world-clock.js

@@ -0,0 +1,106 @@
+/**
+ * THE WORLD CLOCK (backlog wave 2, item B: "Mr. Moss said 'after
+ * midnight', let's implement a world clock -- it should be the same
+ * timezone as the server").
+ *
+ * WHY REAL TIME, AND WHY EXACTLY ONE OF IT. The second clause is the
+ * whole design. A purely fictional clock has no timezone -- you only
+ * say "timezone" about real time -- and a deadline like "after
+ * midnight" is only a deadline if every runner at the table agrees on
+ * when it falls.
+ *
+ * The first cut said "the wall clock of the machine the ENGINE is on"
+ * and called the solo case degenerate. That was wrong, and it is worth
+ * keeping the error visible: in a shared run the engine host is the
+ * server, but in a SOLO run it is the player's own laptop. So solo read
+ * one zone and shared read another, which is the precise divergence
+ * this file was written to prevent, reintroduced by the sentence that
+ * claimed to prevent it. See the UTC ruling below.
+ *
+ * What holds regardless of zone: nothing outside the engine may format
+ * world time. A client rendering `new Date()` for itself is how a table
+ * ends up disagreeing about what day it is; ask here instead.
+ *
+ * WHAT THIS DELIBERATELY DOES NOT TOUCH. The game already has a clock,
+ * and it is not this one: the JOB CYCLE. Lifestyle upkeep, DocWagon
+ * ticks, procurement deliveries, rest, the edge refresh and the hunger
+ * and sleep needs all advance at homecoming and departure, in discrete
+ * steps (Game.applyDepartureNeeds, returnToHub). That is an economy,
+ * balanced in cycles, and re-plumbing it onto real seconds would change
+ * every one of those numbers. The two stay separate on purpose: the job
+ * cycle is how the WORLD advances, and the world clock is what the
+ * clock on the wall says while it does. This module is a READ surface
+ * and a gate for fiction ("after midnight"), not a second economy.
+ *
+ * `now` is injectable throughout so the behaviour is testable without
+ * waiting for actual midnight.
+ */
+/**
+ * THE WORLD KEEPS UTC. THE ENGINE HOST'S LOCAL TIME IS NEVER THE
+ * WORLD'S TIME (ruling 2026-08-27).
+ *
+ * This module originally read the wall clock of "the machine the engine
+ * is on", which is right for a shared run -- the server -- and wrong for
+ * a solo one, where the engine host is the PLAYER'S OWN LAPTOP. So solo
+ * showed the player's zone, shared showed the server's, and the two
+ * silently disagreed. The item that asked for this clock asked for "the
+ * same timezone as the server", and reading local time never delivered
+ * it; two players at one table in different zones read different clocks,
+ * which is exactly the case a world clock exists to prevent. "After
+ * midnight" cannot gate anything until every seat agrees when midnight
+ * is.
+ *
+ * UTC is that agreement, and it is the one zone no machine has to be
+ * configured for. Every reader below therefore uses the getUTC*
+ * accessors -- getHours() and friends would reintroduce the bug one
+ * function at a time.
+ */
+export function worldNow(now = new Date()) {
+    return now;
+}
+/** Named plainly rather than resolved: there is nothing to resolve, and
+ *  a runner in Seattle should be told which clock they are reading
+ *  rather than left to assume it is theirs. */
+export function worldZone(_now = new Date()) {
+    return 'UTC';
+}
+/**
+ * Which stretch of the day it is, in the words the street uses. The
+ * boundaries are drawn for a game about night work: midnight to five is
+ * its own country ("the small hours") rather than a wing of night,
+ * because that is the window jobs keep getting set in.
+ */
+export function partOfDay(now = new Date()) {
+    const h = now.getUTCHours();
+    if (h < 5)
+        return 'small hours';
+    if (h < 12)
+        return 'morning';
+    if (h < 17)
+        return 'afternoon';
+    if (h < 21)
+        return 'evening';
+    return 'night';
+}
+/**
+ * AFTER MIDNIGHT, as a runner means it (the item's own example). Not
+ * "the calendar date rolled over" -- a job that says after midnight
+ * means the small hours, the dead stretch before the city wakes. 00:00
+ * to 04:59 is inside it; 23:59 and 05:00 are not.
+ */
+export function isAfterMidnight(now = new Date()) {
+    return now.getUTCHours() < 5;
+}
+/** 24-hour, zero-padded -- the way a runner's display would show it. */
+export function clockTime(now = new Date()) {
+    return `${String(now.getUTCHours()).padStart(2, '0')}:${String(now.getUTCMinutes()).padStart(2, '0')}`;
+}
+/** Weekday and date, for the times the day itself matters. */
+export function clockDate(now = new Date()) {
+    return now.toLocaleDateString('en-US', { weekday: 'long', month: 'short', day: 'numeric', timeZone: 'UTC' });
+}
+/** The full read, as the `time` command and the HUD both want it. */
+export function worldTimeLabel(now = new Date()) {
+    return `${clockTime(now)} -- ${partOfDay(now)}`;
+}
+//# sourceMappingURL=world-clock.js.map

package/bundle/typescript/src/commands/game/sideQuest/utilities/world-clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-clock.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/world-clock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAIH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAY,IAAI,IAAI,EAAE;IAC7C,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;+CAE+C;AAC/C,MAAM,UAAU,SAAS,CAAC,OAAa,IAAI,IAAI,EAAE;IAC/C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,MAAY,IAAI,IAAI,EAAE;IAC9C,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,aAAa,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,WAAW,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAY,IAAI,IAAI,EAAE;IACpD,OAAO,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,SAAS,CAAC,MAAY,IAAI,IAAI,EAAE;IAC9C,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACzG,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,MAAY,IAAI,IAAI,EAAE;IAC9C,OAAO,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/G,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,cAAc,CAAC,MAAY,IAAI,IAAI,EAAE;IACnD,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;AAClD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maka/maka-cli",
-  "version": "5.63.0",
+  "version": "5.64.0",
   "type": "module",
   "summary": "A command line tool for scaffolding Meteor 2.x applications using either React.",
   "description": "A command line tool for scaffolding Meteor 2.x applications using React.",