@openbrf/display 0.0.0-stage → 0.1.1

package/dist/time.js

@@ -0,0 +1,94 @@
+const MINUTE = 60 * 1000;
+const DAY = 24 * 60 * MINUTE;
+const partFormatters = new Map();
+function partFormatter(timeZone) {
+    let formatter = partFormatters.get(timeZone);
+    if (formatter === undefined) {
+        formatter = new Intl.DateTimeFormat("en-US", {
+            timeZone,
+            hourCycle: "h23",
+            year: "numeric",
+            month: "numeric",
+            day: "numeric",
+            hour: "numeric",
+            minute: "numeric",
+            second: "numeric",
+        });
+        partFormatters.set(timeZone, formatter);
+    }
+    return formatter;
+}
+/** Whether `Intl` knows the zone. */
+export function isTimeZone(timeZone) {
+    try {
+        partFormatter(timeZone);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** The wall clock of `timeZone` at an instant. */
+export function zonedParts(time, timeZone) {
+    const values = {};
+    for (const part of partFormatter(timeZone).formatToParts(time)) {
+        if (part.type !== "literal") {
+            values[part.type] = Number(part.value);
+        }
+    }
+    const year = values["year"] ?? 1970;
+    const month = values["month"] ?? 1;
+    const day = values["day"] ?? 1;
+    return {
+        year,
+        month,
+        day,
+        hour: (values["hour"] ?? 0) % 24,
+        minute: values["minute"] ?? 0,
+        second: values["second"] ?? 0,
+        weekday: isoWeekday(year, month, day),
+    };
+}
+function isoWeekday(year, month, day) {
+    const weekday = new Date(Date.UTC(year, month - 1, day)).getUTCDay();
+    return (weekday === 0 ? 7 : weekday);
+}
+/** How far the zone's wall clock is ahead of UTC at an instant, in ms. */
+function offset(time, timeZone) {
+    const parts = zonedParts(time, timeZone);
+    const wall = Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second);
+    return wall - Math.floor(time / 1000) * 1000;
+}
+/**
+ * The first instant of a calendar date in `timeZone`: its midnight, or, in a
+ * zone that skips midnight on the day the clocks go forward, the moment the
+ * day begins.
+ */
+export function zonedDayStart(year, month, day, timeZone) {
+    const wall = Date.UTC(year, month - 1, day);
+    const first = wall - offset(wall, timeZone);
+    const second = wall - offset(first, timeZone);
+    const onTheDay = [first, second]
+        .filter((candidate) => {
+        const parts = zonedParts(candidate, timeZone);
+        return parts.year === year && parts.month === month && parts.day === day;
+    })
+        .sort((a, b) => a - b);
+    return onTheDay[0] ?? Math.max(first, second);
+}
+/** The first instant of the calendar day `days` after the one `time` falls on. */
+export function zonedDayStartAfter(time, days, timeZone) {
+    const today = zonedParts(time, timeZone);
+    const date = new Date(Date.UTC(today.year, today.month - 1, today.day + days));
+    return zonedDayStart(date.getUTCFullYear(), date.getUTCMonth() + 1, date.getUTCDate(), timeZone);
+}
+/** An instant floored to its minute. */
+export function floorToMinute(time) {
+    return Math.floor(time / MINUTE) * MINUTE;
+}
+/** An instant as the contract writes one: UTC, whole seconds, "Z". */
+export function toInstant(time) {
+    return `${new Date(Math.floor(time / 1000) * 1000).toISOString().slice(0, 19)}Z`;
+}
+export { DAY, MINUTE };
+//# sourceMappingURL=time.js.map

package/dist/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"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"}

package/dist/translate.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The renderer's words in a screen's locale, with i18next's interpolation and
+ * plural keys, so the translations read the same here as in packages/i18n.
+ */
+import type { ScreenLocale } from "./contract.ts";
+import { type WordKey } from "./words.ts";
+type PluralCategory = "zero" | "one" | "two" | "few" | "many" | "other";
+type PluralBase<Key> = Key extends `${infer Base}_other` ? Base : never;
+/** A word to look up: a key, or the base of a plural key such as `placesLeft`. */
+export type Phrase = Exclude<WordKey, `${string}_${PluralCategory}`> | PluralBase<WordKey>;
+/**
+ * The word for `phrase` in `locale`, its `{{name}}` placeholders filled from
+ * `values`. A numeric `count` picks the plural form, `<phrase>_one` or
+ * `<phrase>_other`, by the locale's plural rules.
+ */
+export declare function translate(locale: ScreenLocale, phrase: Phrase, values?: Readonly<Record<string, string | number>>): string;
+export {};
+//# sourceMappingURL=translate.d.ts.map

package/dist/translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAS,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEjD,KAAK,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAExE,KAAK,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,IAAI,QAAQ,GAAG,IAAI,GAAG,KAAK,CAAC;AAExE,kFAAkF;AAClF,MAAM,MAAM,MAAM,GAChB,OAAO,CAAC,OAAO,EAAE,GAAG,MAAM,IAAI,cAAc,EAAE,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;AAoBxE;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAM,GACrD,MAAM,CAaR"}

package/dist/translate.js

@@ -0,0 +1,35 @@
+import { WORDS } from "./words.js";
+const pluralRules = new Map();
+function pluralCategory(locale, count) {
+    let rules = pluralRules.get(locale);
+    if (rules === undefined) {
+        rules = new Intl.PluralRules(locale);
+        pluralRules.set(locale, rules);
+    }
+    return rules.select(count);
+}
+function lookup(locale, key) {
+    const words = WORDS[locale];
+    return Object.prototype.hasOwnProperty.call(words, key)
+        ? words[key]
+        : undefined;
+}
+/**
+ * The word for `phrase` in `locale`, its `{{name}}` placeholders filled from
+ * `values`. A numeric `count` picks the plural form, `<phrase>_one` or
+ * `<phrase>_other`, by the locale's plural rules.
+ */
+export function translate(locale, phrase, values = {}) {
+    const count = values["count"];
+    const text = (typeof count === "number"
+        ? (lookup(locale, `${phrase}_${pluralCategory(locale, count)}`) ??
+            lookup(locale, `${phrase}_other`))
+        : undefined) ??
+        lookup(locale, phrase) ??
+        phrase;
+    return text.replace(/\{\{\s*(\w+)\s*\}\}/g, (placeholder, name) => {
+        const value = values[name];
+        return value === undefined ? placeholder : String(value);
+    });
+}
+//# sourceMappingURL=translate.js.map

package/dist/translate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAgB,MAAM,YAAY,CAAC;AAUjD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkC,CAAC;AAE9D,SAAS,cAAc,CAAC,MAAoB,EAAE,KAAa;IACzD,IAAI,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,KAAK,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACrC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,MAAM,CAAC,MAAoB,EAAE,GAAW;IAC/C,MAAM,KAAK,GAAqC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC;QACrD,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;QACZ,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,MAAoB,EACpB,MAAc,EACd,MAAM,GAA8C,EAAE;IAEtD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,IAAI,GACR,CAAC,OAAO,KAAK,KAAK,QAAQ;QACxB,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,IAAI,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC;IACT,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC,WAAW,EAAE,IAAY,EAAE,EAAE;QACxE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/words.d.ts

@@ -0,0 +1,41 @@
+import type { ScreenLocale } from "./contract.ts";
+declare const en: {
+    readonly loading: "Loading";
+    readonly comingEvents: "Coming events";
+    readonly calledOff: "Called off";
+    readonly placesLeft_one: "{{count}} place left";
+    readonly placesLeft_other: "{{count}} places left";
+    readonly fullyBooked: "Fully booked";
+    readonly ordinaryMeeting: "Ordinary general meeting";
+    readonly extraordinaryMeeting: "Extraordinary general meeting";
+    readonly meetingWhen: "When";
+    readonly meetingWhere: "Where";
+    readonly digitalParticipation: "Taking part digitally";
+    readonly agenda: "Agenda";
+    readonly freeAndBusy: "Free and busy";
+    readonly today: "Today";
+    readonly tomorrow: "Tomorrow";
+    readonly busy: "Busy";
+    readonly busyAllDay: "Busy all day";
+    readonly freeAllDay: "Free all day";
+    readonly freeRestOfDay: "Free for the rest of the day";
+    readonly freeBetween: "Free {{from}}–{{to}}";
+    readonly timeRange: "{{from}}–{{to}}";
+    readonly floor: "Floor {{floor}}";
+    readonly nothingToShow: "Nothing to show right now";
+    readonly lastUpdated: "Last updated {{time}}";
+    readonly notConnected: "Not connected";
+    readonly notConnectedDetail: "The screen has no connection just now. It keeps trying by itself.";
+    readonly linkInvalid: "This display link is no longer valid";
+    readonly linkInvalidDetail: "Ask the board for a new display link and open it on this screen.";
+    readonly linkMissing: "The display link is not complete";
+    readonly linkMissingDetail: "Open the whole display link from the board on this screen, everything after the # sign included.";
+    readonly paused: "The screen is paused";
+    readonly pausedDetail: "Screen content is switched off for now. The screen starts again by itself when it is switched back on.";
+};
+/** A word the renderer shows that is not in the document. */
+export type WordKey = keyof typeof en;
+/** The renderer's own words in every screen language, English the canonical one. */
+export declare const WORDS: Readonly<Record<ScreenLocale, Readonly<Record<WordKey, string>>>>;
+export {};
+//# sourceMappingURL=words.d.ts.map

package/dist/words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.d.ts","sourceRoot":"","sources":["../src/words.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,QAAA,MAAM,EAAE;aACN,OAAO,EAAE,SAAS;aAClB,YAAY,EAAE,eAAe;aAC7B,SAAS,EAAE,YAAY;aACvB,cAAc,EAAE,sBAAsB;aACtC,gBAAgB,EAAE,uBAAuB;aACzC,WAAW,EAAE,cAAc;aAC3B,eAAe,EAAE,0BAA0B;aAC3C,oBAAoB,EAAE,+BAA+B;aACrD,WAAW,EAAE,MAAM;aACnB,YAAY,EAAE,OAAO;aACrB,oBAAoB,EAAE,uBAAuB;aAC7C,MAAM,EAAE,QAAQ;aAChB,WAAW,EAAE,eAAe;aAC5B,KAAK,EAAE,OAAO;aACd,QAAQ,EAAE,UAAU;aACpB,IAAI,EAAE,MAAM;aACZ,UAAU,EAAE,cAAc;aAC1B,UAAU,EAAE,cAAc;aAC1B,aAAa,EAAE,8BAA8B;aAC7C,WAAW,EAAE,sBAAsB;aACnC,SAAS,EAAE,iBAAiB;aAC5B,KAAK,EAAE,iBAAiB;aACxB,aAAa,EAAE,2BAA2B;aAC1C,WAAW,EAAE,uBAAuB;aACpC,YAAY,EAAE,eAAe;aAC7B,kBAAkB,EAChB,mEAAmE;aACrE,WAAW,EAAE,sCAAsC;aACnD,iBAAiB,EACf,kEAAkE;aACpE,WAAW,EAAE,kCAAkC;aAC/C,iBAAiB,EACf,kGAAkG;aACpG,MAAM,EAAE,sBAAsB;aAC9B,YAAY,EACV,wGAAwG;CAClG,CAAC;AAEX,6DAA6D;AAC7D,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,EAAE,CAAC;AAEtC,oFAAoF;AACpF,eAAO,MAAM,KAAK,EAAE,QAAQ,CAC1B,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAyCxD,CAAC"}

package/dist/words.js

@@ -0,0 +1,73 @@
+const en = {
+    loading: "Loading",
+    comingEvents: "Coming events",
+    calledOff: "Called off",
+    placesLeft_one: "{{count}} place left",
+    placesLeft_other: "{{count}} places left",
+    fullyBooked: "Fully booked",
+    ordinaryMeeting: "Ordinary general meeting",
+    extraordinaryMeeting: "Extraordinary general meeting",
+    meetingWhen: "When",
+    meetingWhere: "Where",
+    digitalParticipation: "Taking part digitally",
+    agenda: "Agenda",
+    freeAndBusy: "Free and busy",
+    today: "Today",
+    tomorrow: "Tomorrow",
+    busy: "Busy",
+    busyAllDay: "Busy all day",
+    freeAllDay: "Free all day",
+    freeRestOfDay: "Free for the rest of the day",
+    freeBetween: "Free {{from}}–{{to}}",
+    timeRange: "{{from}}–{{to}}",
+    floor: "Floor {{floor}}",
+    nothingToShow: "Nothing to show right now",
+    lastUpdated: "Last updated {{time}}",
+    notConnected: "Not connected",
+    notConnectedDetail: "The screen has no connection just now. It keeps trying by itself.",
+    linkInvalid: "This display link is no longer valid",
+    linkInvalidDetail: "Ask the board for a new display link and open it on this screen.",
+    linkMissing: "The display link is not complete",
+    linkMissingDetail: "Open the whole display link from the board on this screen, everything after the # sign included.",
+    paused: "The screen is paused",
+    pausedDetail: "Screen content is switched off for now. The screen starts again by itself when it is switched back on.",
+};
+/** The renderer's own words in every screen language, English the canonical one. */
+export const WORDS = {
+    en,
+    sv: {
+        loading: "Laddar",
+        comingEvents: "Kommande evenemang",
+        calledOff: "Inställt",
+        placesLeft_one: "{{count}} plats kvar",
+        placesLeft_other: "{{count}} platser kvar",
+        fullyBooked: "Fullbokat",
+        ordinaryMeeting: "Ordinarie föreningsstämma",
+        extraordinaryMeeting: "Extra föreningsstämma",
+        meetingWhen: "När",
+        meetingWhere: "Var",
+        digitalParticipation: "Delta digitalt",
+        agenda: "Dagordning",
+        freeAndBusy: "Ledigt och bokat",
+        today: "I dag",
+        tomorrow: "I morgon",
+        busy: "Bokat",
+        busyAllDay: "Bokat hela dagen",
+        freeAllDay: "Ledigt hela dagen",
+        freeRestOfDay: "Ledigt resten av dagen",
+        freeBetween: "Ledigt {{from}}–{{to}}",
+        timeRange: "{{from}}–{{to}}",
+        floor: "Våning {{floor}}",
+        nothingToShow: "Inget att visa just nu",
+        lastUpdated: "Senast uppdaterad {{time}}",
+        notConnected: "Inte ansluten",
+        notConnectedDetail: "Skärmen har ingen anslutning just nu. Den fortsätter att försöka av sig själv.",
+        linkInvalid: "Visningslänken gäller inte längre",
+        linkInvalidDetail: "Be styrelsen om en ny visningslänk och öppna den på den här skärmen.",
+        linkMissing: "Visningslänken är inte hel",
+        linkMissingDetail: "Öppna hela visningslänken från styrelsen på den här skärmen, även allt efter tecknet #.",
+        paused: "Skärmen är pausad",
+        pausedDetail: "Skärminnehållet är avstängt just nu. Skärmen startar igen av sig själv när det slås på.",
+    },
+};
+//# sourceMappingURL=words.js.map

package/dist/words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.js","sourceRoot":"","sources":["../src/words.ts"],"names":[],"mappings":"AAKA,MAAM,EAAE,GAAG;IACT,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,eAAe;IAC7B,SAAS,EAAE,YAAY;IACvB,cAAc,EAAE,sBAAsB;IACtC,gBAAgB,EAAE,uBAAuB;IACzC,WAAW,EAAE,cAAc;IAC3B,eAAe,EAAE,0BAA0B;IAC3C,oBAAoB,EAAE,+BAA+B;IACrD,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,OAAO;IACrB,oBAAoB,EAAE,uBAAuB;IAC7C,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,eAAe;IAC5B,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE,cAAc;IAC1B,aAAa,EAAE,8BAA8B;IAC7C,WAAW,EAAE,sBAAsB;IACnC,SAAS,EAAE,iBAAiB;IAC5B,KAAK,EAAE,iBAAiB;IACxB,aAAa,EAAE,2BAA2B;IAC1C,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,eAAe;IAC7B,kBAAkB,EAChB,mEAAmE;IACrE,WAAW,EAAE,sCAAsC;IACnD,iBAAiB,EACf,kEAAkE;IACpE,WAAW,EAAE,kCAAkC;IAC/C,iBAAiB,EACf,kGAAkG;IACpG,MAAM,EAAE,sBAAsB;IAC9B,YAAY,EACV,wGAAwG;CAClG,CAAC;AAKX,oFAAoF;AACpF,MAAM,CAAC,MAAM,KAAK,GAEd;IACF,EAAE;IACF,EAAE,EAAE;QACF,OAAO,EAAE,QAAQ;QACjB,YAAY,EAAE,oBAAoB;QAClC,SAAS,EAAE,UAAU;QACrB,cAAc,EAAE,sBAAsB;QACtC,gBAAgB,EAAE,wBAAwB;QAC1C,WAAW,EAAE,WAAW;QACxB,eAAe,EAAE,2BAA2B;QAC5C,oBAAoB,EAAE,uBAAuB;QAC7C,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,KAAK;QACnB,oBAAoB,EAAE,gBAAgB;QACtC,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,kBAAkB;QAC/B,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,UAAU;QACpB,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,kBAAkB;QAC9B,UAAU,EAAE,mBAAmB;QAC/B,aAAa,EAAE,wBAAwB;QACvC,WAAW,EAAE,wBAAwB;QACrC,SAAS,EAAE,iBAAiB;QAC5B,KAAK,EAAE,kBAAkB;QACzB,aAAa,EAAE,wBAAwB;QACvC,WAAW,EAAE,4BAA4B;QACzC,YAAY,EAAE,eAAe;QAC7B,kBAAkB,EAChB,gFAAgF;QAClF,WAAW,EAAE,mCAAmC;QAChD,iBAAiB,EACf,sEAAsE;QACxE,WAAW,EAAE,4BAA4B;QACzC,iBAAiB,EACf,yFAAyF;QAC3F,MAAM,EAAE,mBAAmB;QAC3B,YAAY,EACV,yFAAyF;KAC5F;CACF,CAAC"}

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@openbrf/display",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "The Open BRF screen content contract, the rotation builder, the renderer and the fetch loop that every screen showing an association's content is built from.",
+  "keywords": [
+    "openbrf",
+    "brf",
+    "housing-cooperative",
+    "digital-signage",
+    "screen",
+    "renderer"
+  ],
+  "license": "AGPL-3.0-only",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@openbrf/tokens": "^1.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "jsdom": "^30.1.3",
+    "typescript": "^7.0.2",
+    "vite-plus": "1.3.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.spec.ts",
+    "LICENSE",
+    "LICENSE-EXCEPTION.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
+  },
+  "homepage": "https://github.com/openbrf/openbrf/tree/main/packages/display#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/openbrf/openbrf.git",
+    "directory": "packages/display"
+  },
+  "bugs": {
+    "url": "https://github.com/openbrf/openbrf/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "vp lint .",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vp test run",
+    "words": "node scripts/words.mjs"
+  }
 }

package/src/contract.ts

@@ -0,0 +1,279 @@
+/**
+ * The screen content contract, version 1: the document a screen fetches and
+ * shows, as ADR 0034 defined it and ADR 0050 made the core's.
+ *
+ * The text of record is docs/screen-content-contract.md. These types and
+ * limits are that text in code, and a change to either is a change to the
+ * contract under its version rules: a field or a body kind may be added within
+ * version 1, because an older player ignores what it does not know, and a
+ * change an older player would misread raises the version.
+ *
+ * "Characters" in a limit are Unicode code points. A server that measures in
+ * UTF-16 code units, as JavaScript's `length` does, never exceeds a limit
+ * measured in code points, so the builder in this package measures in code
+ * units and the parser in code points.
+ */
+
+/** The version of the document this package reads and builds. */
+export const SCREEN_CONTENT_VERSION = 1;
+
+/** An instant: RFC 3339 in UTC, whole seconds, with "Z": "2026-12-01T09:00:00Z". */
+export type Instant = string;
+
+/** A time of day, "HH:MM" from "00:00" to "24:00", in the document's `timeZone`. */
+export type LocalTime = string;
+
+/** The languages a screen speaks. */
+export type ScreenLocale = "sv" | "en";
+
+/** An ISO weekday: 1 is Monday and 7 is Sunday. */
+export type IsoWeekday = 1 | 2 | 3 | 4 | 5 | 6 | 7;
+
+/** How the screen lays out its canvas. */
+export interface ScreenLayout {
+  /** Degrees clockwise the player turns its canvas. */
+  orientation: 0 | 90 | 180 | 270;
+  /** A band above the slides with the date and the time, or none. */
+  header: "none" | "clock";
+  theme: "light" | "dark";
+}
+
+/** One window in which the screen shows the rotation. */
+export interface ScreenScheduleWindow {
+  days: IsoWeekday[];
+  /** Inclusive. */
+  from: LocalTime;
+  /** Exclusive, and after `from`. A window over midnight is two windows. */
+  to: LocalTime;
+}
+
+/**
+ * When the screen shows the rotation. Outside every window it shows black;
+ * with no window at all it shows the rotation always.
+ */
+export interface ScreenSchedule {
+  /** At most 14. */
+  on: ScreenScheduleWindow[];
+}
+
+/** One kind of thing in a screen's rotation (GLOSSARY.md, "source"). */
+export type SlideSource =
+  "news" | "events" | "meeting" | "availability" | "picture" | "addon";
+
+/** A picture the screen may show, fetched by its `mediaFileId`. */
+export interface PictureRef {
+  mediaFileId: string;
+  /** The image type the core identified from the bytes. */
+  contentType: string;
+  byteSize: number;
+  /** Opaque, and changes when the file does: the picture's ETag. */
+  version: string;
+  /** At most 300 characters. */
+  alt: string;
+}
+
+/** A published news item. */
+export interface NewsBody {
+  kind: "news";
+  /** At most 200 characters. */
+  title: string;
+  /** At most 2 000 characters together. */
+  paragraphs: string[];
+  picture: PictureRef | null;
+  publishedAt: Instant;
+}
+
+/** One occurrence of a published event, as an events slide lists it. */
+export interface EventsOccurrence {
+  /** At most 200 characters. */
+  title: string;
+  /** At most 500 characters. */
+  description: string | null;
+  /** At most 200 characters. */
+  location: string | null;
+  startsAt: Instant;
+  endsAt: Instant;
+  calledOff: boolean;
+  placesLeft: number | null;
+}
+
+/** The coming occurrences of published events. */
+export interface EventsBody {
+  kind: "events";
+  /** 1 to 8, soonest first. */
+  occurrences: EventsOccurrence[];
+}
+
+/** One matter on a general meeting's agenda. */
+export interface AgendaItem {
+  position: number;
+  /** At most 200 characters. */
+  title: string;
+}
+
+/** The notice of a general meeting the board has called. */
+export interface MeetingBody {
+  kind: "meeting";
+  meetingKind: "ordinary" | "extraordinary";
+  startsAt: Instant;
+  /** At most 200 characters. */
+  place: string;
+  /** At most 500 characters. */
+  digitalParticipation: string | null;
+  /** At most 40. */
+  agenda: AgendaItem[];
+}
+
+/** A period a bookable resource is taken. Never by whom. */
+export interface BusyInterval {
+  start: Instant;
+  end: Instant;
+}
+
+/** One bookable resource on an availability slide. */
+export interface AvailabilityResource {
+  /** At most 80 characters. */
+  name: string;
+  mode: "timeSlots" | "wholeDay" | "dateRange";
+  slotMinutes: number | null;
+  /** Minutes after midnight in the document's `timeZone`. */
+  opensAtMinute: number | null;
+  closesAtMinute: number | null;
+  /** Merged, sorted, and inside [from, to). */
+  busy: BusyInterval[];
+}
+
+/** When the house's bookable resources are free and busy. */
+export interface AvailabilityBody {
+  kind: "availability";
+  /** The fetch, to the minute; never earlier. */
+  from: Instant;
+  /** At most 7 days after `from`. */
+  to: Instant;
+  /** 1 to 12. */
+  resources: AvailabilityResource[];
+}
+
+/** A picture the board chose for the screen. */
+export interface PictureBody {
+  kind: "picture";
+  picture: PictureRef;
+  /** At most 200 characters. */
+  caption: string | null;
+}
+
+/** An addon's text slide. */
+export interface AddonTextBody {
+  kind: "text";
+  heading: string;
+  /** At most 2 000 characters together. */
+  body: string[];
+}
+
+/** An addon's table slide. */
+export interface AddonTableBody {
+  kind: "table";
+  heading: string;
+  /** At most 4. */
+  columns: string[];
+  /** At most 60, each as long as `columns`. */
+  rows: string[][];
+}
+
+/** One door on an addon's doors slide. */
+export interface AddonDoor {
+  floor: number | null;
+  apartment: string;
+  names: string[];
+}
+
+/** An addon's doors slide: the names on the doors of one entrance. */
+export interface AddonDoorsBody {
+  kind: "doors";
+  heading: string;
+  /** At most 120. */
+  doors: AddonDoor[];
+}
+
+/** One slide of an addon's output at the `source` extension point. */
+export type AddonBody = AddonTextBody | AddonTableBody | AddonDoorsBody;
+
+/** What a slide shows. Its `kind` matches the slide's `source`. */
+export type SlideBody =
+  | NewsBody
+  | EventsBody
+  | MeetingBody
+  | AvailabilityBody
+  | PictureBody
+  | AddonBody;
+
+/** One slide of the rotation. */
+export interface Slide {
+  /** 1 to 64 of A-Z a-z 0-9 . _ : -, the same on every fetch while the slide shows the same thing. */
+  id: string;
+  /** Integer, 5 to 120: how long it stays. */
+  seconds: number;
+  /** The player skips the slide from this instant, without waiting for a fetch. */
+  until: Instant | null;
+  source: SlideSource;
+  /** The addon's plugin id when `source` is "addon", otherwise null. */
+  addon: string | null;
+  body: SlideBody;
+}
+
+/** The screen content document, version 1. */
+export interface ScreenContent {
+  version: 1;
+  /** The device token's subject: the screen's id. */
+  screenId: string;
+  generatedAt: Instant;
+  /** Integer, 30 to 60. */
+  refreshSeconds: number;
+  locale: ScreenLocale;
+  /** IANA zone of the association's calendar day: "Europe/Stockholm". */
+  timeZone: string;
+  /** The only channel a paired screen's shell takes player releases from. */
+  releaseChannel: "stable" | "beta";
+  layout: ScreenLayout;
+  schedule: ScreenSchedule;
+  /** In order, at most 100; the player loops through them. */
+  rotation: Slide[];
+}
+
+/** The contract's limits, by what they bound. */
+export const SCREEN_CONTENT_LIMITS = {
+  /** The document's size, in bytes of its UTF-8 JSON. */
+  documentBytes: 1024 * 1024,
+  rotation: 100,
+  slideSecondsMin: 5,
+  slideSecondsMax: 120,
+  refreshSecondsMin: 30,
+  refreshSecondsMax: 60,
+  scheduleWindows: 14,
+  title: 200,
+  /** All of a news item's paragraphs together. */
+  paragraphs: 2000,
+  description: 500,
+  location: 200,
+  place: 200,
+  digitalParticipation: 500,
+  agendaItems: 40,
+  agendaTitle: 200,
+  occurrencesMin: 1,
+  occurrencesMax: 8,
+  resourcesMin: 1,
+  resourcesMax: 12,
+  resourceName: 80,
+  /** How far an availability slide's `to` may be after its `from`, in days. */
+  availabilityDays: 7,
+  alt: 300,
+  caption: 200,
+  /** All of an addon text slide's paragraphs together. */
+  addonTextBody: 2000,
+  tableColumns: 4,
+  tableRows: 60,
+  doors: 120,
+} as const;
+
+/** What a slide's `id` is made of. */
+export const SLIDE_ID_PATTERN = /^[A-Za-z0-9._:-]{1,64}$/;