@overcrow/mcp 0.0.0-stage → 0.1.0

package/dist/content/examples/clock/manifest.json

@@ -0,0 +1,44 @@
+{
+  "schemaVersion": 1,
+  "apiVersion": 1,
+  "id": "com.playervox.overcrow.clock",
+  "version": "1.0.2",
+  "name": {
+    "en": "Clock",
+    "fr": "Horloge"
+  },
+  "sizing": {
+    "fit": "both",
+    "preferred": { "width": 110, "height": 60 },
+    "min": { "width": 40, "height": 24 },
+    "max": { "width": 480, "height": 240 }
+  },
+  "wrapper": {
+    "menu": [
+      {
+        "type": "toggle",
+        "id": "show-seconds",
+        "label": { "en": "Show seconds", "fr": "Afficher les secondes" },
+        "default": false
+      },
+      {
+        "type": "toggle",
+        "id": "show-date",
+        "label": { "en": "Show date", "fr": "Afficher la date" },
+        "default": true
+      },
+      {
+        "type": "choice",
+        "id": "date-format",
+        "label": { "en": "Date format", "fr": "Format de date" },
+        "visibleWhen": "show-date",
+        "choices": [
+          { "value": "day-month-year", "label": { "en": "dd/mm/yyyy", "fr": "jj/mm/aaaa" } },
+          { "value": "year-month-day", "label": { "en": "yyyy-mm-dd", "fr": "aaaa-mm-jj" } },
+          { "value": "month-day-year", "label": { "en": "mm/dd/yyyy", "fr": "mm/jj/aaaa" } }
+        ],
+        "default": "day-month-year"
+      }
+    ]
+  }
+}

package/dist/content/examples/clock/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "overcrow-widget-clock",
+  "version": "1.0.2",
+  "private": true,
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "check": "overcrow-widget check",
+    "package": "overcrow-widget package",
+    "test": "node --test tests/*.test.mjs"
+  },
+  "devDependencies": {
+    "@overcrow/sdk": "1.0.0",
+    "typescript": "6.0.3"
+  }
+}

package/dist/content/examples/clock/style.ocss

@@ -0,0 +1,26 @@
+/* One compact column: the time over the date, 1 px apart. The wrapper
+   draws the panel and its 8 px margin; the content adds 2 px on the
+   sides: the built-in's 10 × 8 px margin. */
+.clock {
+  flex-direction: column;
+  align-items: start;
+  row-gap: 1px;
+  padding: 0 2px;
+}
+
+/* Values use the UI font with tabular figures, so they never shift. */
+.time {
+  font-family: var(--font-ui);
+  font-size: var(--font-size-value);
+  font-variant-numeric: tabular-nums;
+  color: var(--color-text);
+  white-space: nowrap;
+}
+
+.date {
+  font-family: var(--font-ui);
+  font-size: var(--font-size-small);
+  font-variant-numeric: tabular-nums;
+  color: var(--color-text-muted);
+  white-space: nowrap;
+}

package/dist/content/examples/clock/tests/hidden.scenario.json

@@ -0,0 +1,68 @@
+{
+  "scenarioVersion": 1,
+  "name": "hidden",
+  "description": "Hidden, the clock gets no tick; shown again, it shows the current time at once.",
+  "host": {
+    "zone": {
+      "offsetMinutes": 120
+    },
+    "startAt": 1784290122000,
+    "options": {
+      "show-seconds": true
+    }
+  },
+  "steps": [
+    {
+      "expect": {
+        "text": [
+          "14:08:42"
+        ]
+      }
+    },
+    {
+      "host": {
+        "visible": false
+      }
+    },
+    {
+      "advance": {
+        "ms": 300000
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "14:08:42"
+        ],
+        "noText": [
+          "14:13:42"
+        ]
+      }
+    },
+    {
+      "host": {
+        "visible": true
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "14:13:42"
+        ]
+      }
+    },
+    {
+      "advance": {
+        "ms": 1000
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "14:13:43"
+        ],
+        "fault": "none"
+      }
+    }
+  ]
+}

package/dist/content/examples/clock/tests/load-logic.mjs

@@ -0,0 +1,22 @@
+// Compiles this widget's logic.ts with the project's TypeScript into
+// dist/ and imports it, after the test installed its runtime
+// (`@overcrow/sdk/testing`), as the VM runs logic.js after its prelude.
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import ts from "typescript";
+
+export async function loadLogic() {
+  const root = new URL("../", import.meta.url);
+  const source = readFileSync(new URL("logic.ts", root), "utf8");
+  const { outputText } = ts.transpileModule(source, {
+    compilerOptions: {
+      module: ts.ModuleKind.ES2022,
+      target: ts.ScriptTarget.ES2023,
+      verbatimModuleSyntax: true,
+    },
+  });
+  mkdirSync(new URL("dist/", root), { recursive: true });
+  // One file per test process: test files run in parallel.
+  const output = new URL(`dist/logic-${process.pid}.mjs`, root);
+  writeFileSync(output, outputText);
+  return import(output.href);
+}

package/dist/content/examples/clock/tests/logic.test.mjs

@@ -0,0 +1,89 @@
+// Unit tests of the Clock's logic on @overcrow/sdk/testing: virtual time,
+// the host's region and menu values, no VM.
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import { installRuntime } from "@overcrow/sdk/testing";
+
+import { loadLogic } from "./load-logic.mjs";
+
+// 14:08:42.250 in UTC+2, 2026-07-17.
+const START = Date.UTC(2026, 6, 17, 12, 8, 42, 250);
+const vm = installRuntime({
+  now: START,
+  host: {
+    region: { numberFormat: "us", dateOrder: "mdy", offsetMinutes: 120 },
+    messages: { label: "Local time {time}", "label-date": "Local time {time}, {date}" },
+  },
+});
+const logic = await loadLogic();
+const { state } = await import("@overcrow/sdk");
+
+test("defaults: date on, day/month/year, no seconds, whatever the region's order", () => {
+  assert.deepEqual(
+    { seconds: state.seconds, showDate: state.showDate, order: state.order },
+    { seconds: false, showDate: true, order: "dmy" },
+  );
+  assert.equal(logic.clockTime(state.now, state.seconds), "14:08");
+  assert.equal(logic.clockDate(state.now, state.order), "17/07/2026");
+  assert.equal(
+    logic.clockLabel(state.now, false, true, "dmy"),
+    "Local time 14:08, 17/07/2026",
+  );
+  assert.equal(logic.clockLabel(state.now, true, false, "dmy"), "Local time 14:08:42");
+});
+
+test("the three date formats and an unknown stored value", () => {
+  const formats = {};
+  for (const [value, order] of Object.entries(logic.DATE_ORDERS)) {
+    formats[value] = logic.clockDate(START, order);
+  }
+  assert.deepEqual(formats, {
+    "day-month-year": "17/07/2026",
+    "year-month-day": "2026-07-17",
+    "month-day-year": "07/17/2026",
+  });
+  vm.setHost({ options: { "date-format": "week-day" } });
+  assert.equal(state.order, "dmy", "an unknown value falls back to the default");
+  vm.setHost({ options: {} });
+});
+
+test("24-hour, zero padded", () => {
+  const night = Date.UTC(2026, 0, 1, 23, 5, 9);
+  assert.equal(logic.clockTime(night, true), "01:05:09");
+  assert.equal(logic.clockTime(Date.UTC(2026, 0, 1, 11, 0, 0), false), "13:00");
+});
+
+test("one timer at the next local minute, then each minute", () => {
+  assert.equal(vm.timers.length, 1);
+  assert.equal(vm.timers[0].dueAt, Date.UTC(2026, 6, 17, 12, 9));
+  vm.advance(Date.UTC(2026, 6, 17, 12, 9) - vm.now);
+  assert.equal(logic.clockTime(state.now, state.seconds), "14:09");
+  assert.deepEqual(
+    vm.timers.map(({ intervalMs, repeat }) => ({ intervalMs, repeat })),
+    [{ intervalMs: 60_000, repeat: true }],
+  );
+  assert.equal(vm.advance(120_000), 2);
+  assert.equal(logic.clockTime(state.now, state.seconds), "14:11");
+});
+
+test("turning seconds on re-arms at once on seconds, and off again on minutes", () => {
+  vm.advance(7_500);
+  vm.setHost({ options: { "show-seconds": true } });
+  assert.equal(state.seconds, true);
+  assert.equal(logic.clockTime(state.now, state.seconds), "14:11:07", "shown at once");
+  assert.equal(vm.timers.length, 1, "the minute timer is gone");
+  vm.advance(500);
+  assert.equal(logic.clockTime(state.now, state.seconds), "14:11:08");
+  vm.advance(1_000);
+  assert.equal(logic.clockTime(state.now, state.seconds), "14:11:09");
+  vm.setHost({ options: { "show-seconds": false, "show-date": false } });
+  assert.equal(state.showDate, false);
+  assert.equal(vm.timers.length, 1);
+  assert.equal(vm.timers[0].dueAt, Date.UTC(2026, 6, 17, 12, 12));
+  vm.setHost({ options: {} });
+});
+
+test("a new UTC offset shows at once", () => {
+  vm.setHost({ region: { numberFormat: "us", dateOrder: "mdy", offsetMinutes: -240 } });
+  assert.equal(logic.clockTime(state.now, state.seconds), "08:11");
+});

package/dist/content/examples/clock/tests/options.scenario.json

@@ -0,0 +1,108 @@
+{
+  "scenarioVersion": 1,
+  "name": "options",
+  "description": "Each menu row, applied from the menu at 14:08:42 local time: seconds, the three date orders, the date hidden.",
+  "host": {
+    "zone": {
+      "offsetMinutes": 120
+    },
+    "startAt": 1784290122000
+  },
+  "steps": [
+    {
+      "menu": {
+        "id": "show-seconds",
+        "value": true
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "14:08:42",
+          "17/07/2026"
+        ],
+        "image": "seconds-dark"
+      }
+    },
+    {
+      "host": {
+        "theme": "light"
+      }
+    },
+    {
+      "expect": {
+        "image": "seconds-light"
+      }
+    },
+    {
+      "host": {
+        "theme": "dark"
+      }
+    },
+    {
+      "menu": {
+        "id": "show-seconds",
+        "value": false
+      }
+    },
+    {
+      "menu": {
+        "id": "date-format",
+        "value": "year-month-day"
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "14:08",
+          "2026-07-17"
+        ],
+        "image": "year-month-day"
+      }
+    },
+    {
+      "menu": {
+        "id": "date-format",
+        "value": "month-day-year"
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "14:08",
+          "07/17/2026"
+        ],
+        "image": "month-day-year"
+      }
+    },
+    {
+      "menu": {
+        "id": "show-date",
+        "value": false
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "14:08"
+        ],
+        "noText": [
+          "07/17/2026"
+        ],
+        "image": "time-only-dark"
+      }
+    },
+    {
+      "host": {
+        "theme": "light",
+        "scale": 1500
+      }
+    },
+    {
+      "expect": {
+        "image": "time-only-light-150",
+        "fault": "none"
+      }
+    }
+  ]
+}

package/dist/content/examples/clock/tests/preview.scenario.json

@@ -0,0 +1,25 @@
+{
+  "scenarioVersion": 1,
+  "name": "preview",
+  "description": "The clock with its default menu values at 14:08 local time. The marketplace preview: dark theme, English, 150 %, on the stage colour; scripts/compose-previews.mjs frames it into assets/preview.png.",
+  "host": {
+    "zone": {
+      "offsetMinutes": 120
+    },
+    "startAt": 1784290122000,
+    "scale": 1500,
+    "background": "#1e242e"
+  },
+  "steps": [
+    {
+      "expect": {
+        "state": "running",
+        "text": [
+          "14:08",
+          "17/07/2026"
+        ],
+        "image": "preview"
+      }
+    }
+  ]
+}

package/dist/content/examples/clock/tests/render.scenario.json

@@ -0,0 +1,94 @@
+{
+  "scenarioVersion": 1,
+  "name": "render",
+  "description": "Default menu values (date on, day/month/year, no seconds) at 14:08:42 local time (UTC+2), in both themes, both languages, at 100 % and 150 %.",
+  "host": {
+    "zone": {
+      "offsetMinutes": 120
+    },
+    "startAt": 1784290122000
+  },
+  "steps": [
+    {
+      "expect": {
+        "state": "running",
+        "text": [
+          "14:08",
+          "17/07/2026"
+        ],
+        "image": "default-dark-en-100"
+      }
+    },
+    {
+      "host": {
+        "theme": "light"
+      }
+    },
+    {
+      "expect": {
+        "image": "default-light-en-100"
+      }
+    },
+    {
+      "host": {
+        "locale": "fr"
+      }
+    },
+    {
+      "expect": {
+        "image": "default-light-fr-100"
+      }
+    },
+    {
+      "host": {
+        "theme": "dark"
+      }
+    },
+    {
+      "expect": {
+        "image": "default-dark-fr-100"
+      }
+    },
+    {
+      "host": {
+        "scale": 1500
+      }
+    },
+    {
+      "expect": {
+        "image": "default-dark-fr-150"
+      }
+    },
+    {
+      "host": {
+        "theme": "light"
+      }
+    },
+    {
+      "expect": {
+        "image": "default-light-fr-150"
+      }
+    },
+    {
+      "host": {
+        "locale": "en"
+      }
+    },
+    {
+      "expect": {
+        "image": "default-light-en-150"
+      }
+    },
+    {
+      "host": {
+        "theme": "dark"
+      }
+    },
+    {
+      "expect": {
+        "image": "default-dark-en-150",
+        "fault": "none"
+      }
+    }
+  ]
+}

package/dist/content/examples/clock/tests/summer-time.scenario.json

@@ -0,0 +1,74 @@
+{
+  "scenarioVersion": 1,
+  "name": "summer-time",
+  "description": "Central European summer time: 01:59 becomes 03:00 at 01:00 UTC on 2026-03-29, and 02:59 becomes 02:00 at 01:00 UTC on 2026-10-25.",
+  "host": {
+    "zone": {
+      "offsetMinutes": 60,
+      "transitions": [
+        {
+          "at": 1774746000000,
+          "offsetMinutes": 120
+        },
+        {
+          "at": 1792890000000,
+          "offsetMinutes": 60
+        }
+      ]
+    },
+    "startAt": 1774745970000
+  },
+  "steps": [
+    {
+      "expect": {
+        "text": [
+          "01:59",
+          "29/03/2026"
+        ]
+      }
+    },
+    {
+      "advance": {
+        "ms": 30000
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "03:00"
+        ],
+        "noText": [
+          "02:00"
+        ]
+      }
+    },
+    {
+      "advance": {
+        "ms": 18143970000,
+        "jump": true
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "02:59",
+          "25/10/2026"
+        ]
+      }
+    },
+    {
+      "advance": {
+        "ms": 30000
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "02:00",
+          "25/10/2026"
+        ],
+        "fault": "none"
+      }
+    }
+  ]
+}

package/dist/content/examples/clock/tests/ticks.scenario.json

@@ -0,0 +1,120 @@
+{
+  "scenarioVersion": 1,
+  "name": "ticks",
+  "description": "The time changes at each local minute, or each second with seconds on, and the date at local midnight; turning seconds on or off applies at once.",
+  "host": {
+    "zone": {
+      "offsetMinutes": 60
+    },
+    "startAt": 1798757998000
+  },
+  "steps": [
+    {
+      "expect": {
+        "text": [
+          "23:59",
+          "31/12/2026"
+        ]
+      }
+    },
+    {
+      "advance": {
+        "ms": 1999
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "23:59"
+        ],
+        "noText": [
+          "00:00"
+        ]
+      }
+    },
+    {
+      "advance": {
+        "ms": 1
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "00:00",
+          "01/01/2027"
+        ]
+      }
+    },
+    {
+      "advance": {
+        "ms": 5000
+      }
+    },
+    {
+      "menu": {
+        "id": "show-seconds",
+        "value": true
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "00:00:05"
+        ]
+      }
+    },
+    {
+      "advance": {
+        "ms": 1000
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "00:00:06"
+        ]
+      }
+    },
+    {
+      "advance": {
+        "ms": 58000
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "00:01:04"
+        ]
+      }
+    },
+    {
+      "menu": {
+        "id": "show-seconds",
+        "value": false
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "00:01"
+        ],
+        "noText": [
+          "00:01:04"
+        ]
+      }
+    },
+    {
+      "advance": {
+        "ms": 56000
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "00:02"
+        ],
+        "fault": "none"
+      }
+    }
+  ]
+}