busybar-kit 0.1.0

package/dist/ticker/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/ticker/text.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAI5C,eAAO,MAAM,OAAO,OAAO,CAAC;AAE5B,eAAO,MAAM,OAAO,OAAO,CAAC;AAE5B,eAAO,MAAM,OAAO,MAAM,CAAC;AAE3B,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YA4CtD;AAgBD,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,aAAkB,UAU5B;AAED,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,aAAkB,UAkB5B;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,aAAkB,UAK5B;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,UAY5B"}

package/dist/ticker/text.js

@@ -0,0 +1,97 @@
+const GAP = '   ';
+export const PAGE_MS = 2200;
+export const HOLD_MS = 1200;
+export const STEP_MS = 400;
+export function paginate(text, maxChars) {
+    if (maxChars <= 0) {
+        return [];
+    }
+    const trimmed = text.trim();
+    if (trimmed.length <= maxChars) {
+        return [trimmed];
+    }
+    const pages = [];
+    let line = '';
+    const words = joinNumbers(trimmed.split(/\s+/));
+    const flush = () => {
+        if (line) {
+            pages.push(line);
+            line = '';
+        }
+    };
+    for (const word of words) {
+        let rest = word;
+        while (rest.length > maxChars) {
+            flush();
+            pages.push(rest.slice(0, maxChars));
+            rest = rest.slice(maxChars);
+        }
+        if (!rest) {
+            continue;
+        }
+        if (!line) {
+            line = rest;
+        }
+        else if (line.length + 1 + rest.length <= maxChars) {
+            line = `${line} ${rest}`;
+        }
+        else {
+            flush();
+            line = rest;
+        }
+    }
+    flush();
+    return pages.length > 0 ? pages : [''];
+}
+function joinNumbers(words) {
+    const joined = [];
+    for (const word of words) {
+        const previous = joined.at(-1);
+        if (previous !== undefined && /^\d+[.,:;]?$/.test(word)) {
+            joined[joined.length - 1] = `${previous} ${word}`;
+            continue;
+        }
+        joined.push(word);
+    }
+    return joined;
+}
+export function pageAt(text, maxChars, elapsedMs, options = {}) {
+    const pages = paginate(text, maxChars);
+    if (pages.length <= 1) {
+        return pages[0] ?? '';
+    }
+    const pageMs = options.pageMs ?? PAGE_MS;
+    const index = Math.floor(Math.max(0, elapsedMs) / pageMs) % pages.length;
+    return pages[index] ?? '';
+}
+export function scrollAt(text, maxChars, elapsedMs, options = {}) {
+    if (maxChars <= 0) {
+        return '';
+    }
+    if (text.length <= maxChars) {
+        return text;
+    }
+    const holdMs = options.holdMs ?? HOLD_MS;
+    const stepMs = options.stepMs ?? STEP_MS;
+    const moving = Math.max(0, elapsedMs - holdMs);
+    const loop = text + GAP;
+    const offset = Math.floor(moving / stepMs) % loop.length;
+    // Wrap by reading past the end of a doubled string rather than stitching slices.
+    return (loop + loop).slice(offset, offset + maxChars);
+}
+export function tickerLine(style, text, maxChars, elapsedMs, options = {}) {
+    return style === 'scroll'
+        ? scrollAt(text, maxChars, elapsedMs, options)
+        : pageAt(text, maxChars, elapsedMs, options);
+}
+export function tickerLineLooping(style, text, maxChars, nowMs, options = {}) {
+    if (text.length <= maxChars) {
+        return text;
+    }
+    const cycleMs = style === 'scroll'
+        ? (options.holdMs ?? HOLD_MS) +
+            (text.length + GAP.length) * (options.stepMs ?? STEP_MS)
+        : paginate(text, maxChars).length * (options.pageMs ?? PAGE_MS);
+    return tickerLine(style, text, maxChars, nowMs % cycleMs, options);
+}
+//# sourceMappingURL=text.js.map

package/dist/ticker/text.js.map

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

package/dist/ticker/ticker.d.ts

@@ -0,0 +1,22 @@
+export declare const TICKER_MS = 7000;
+/** The only thing the ticker needs to know about an app's events. */
+export type Prioritised = {
+    priority: number;
+};
+export type ActiveTicker<TEvent extends Prioritised> = {
+    event: TEvent;
+    elapsedMs: number;
+};
+/**
+ * Holds one event on screen for a while, and lets a more important one cut in.
+ */
+export declare class EventTicker<TEvent extends Prioritised> {
+    private readonly durationMs;
+    private event;
+    private startedAt;
+    private until;
+    constructor(durationMs?: number);
+    push(event: TEvent | null, nowMs: number): boolean;
+    active(nowMs: number): ActiveTicker<TEvent> | null;
+}
+//# sourceMappingURL=ticker.d.ts.map

package/dist/ticker/ticker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticker.d.ts","sourceRoot":"","sources":["../../src/ticker/ticker.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,OAAO,CAAC;AAE9B,qEAAqE;AACrE,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,MAAM,MAAM,YAAY,CAAC,MAAM,SAAS,WAAW,IAAI;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,qBAAa,WAAW,CAAC,MAAM,SAAS,WAAW;IAKrC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJvC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,KAAK,CAAK;gBAEW,UAAU,SAAY;IAEnD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM;IAcxC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,IAAI;CAOnD"}

package/dist/ticker/ticker.js

@@ -0,0 +1,33 @@
+export const TICKER_MS = 7000;
+/**
+ * Holds one event on screen for a while, and lets a more important one cut in.
+ */
+export class EventTicker {
+    durationMs;
+    event = null;
+    startedAt = 0;
+    until = 0;
+    constructor(durationMs = TICKER_MS) {
+        this.durationMs = durationMs;
+    }
+    push(event, nowMs) {
+        if (!event) {
+            return false;
+        }
+        const showing = this.active(nowMs);
+        if (showing && event.priority <= showing.event.priority) {
+            return false;
+        }
+        this.event = event;
+        this.startedAt = nowMs;
+        this.until = nowMs + this.durationMs;
+        return true;
+    }
+    active(nowMs) {
+        if (nowMs >= this.until || !this.event) {
+            return null;
+        }
+        return { event: this.event, elapsedMs: nowMs - this.startedAt };
+    }
+}
+//# sourceMappingURL=ticker.js.map

package/dist/ticker/ticker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticker.js","sourceRoot":"","sources":["../../src/ticker/ticker.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;AAU9B;;GAEG;AACH,MAAM,OAAO,WAAW;IAKO;IAJrB,KAAK,GAAkB,IAAI,CAAC;IAC5B,SAAS,GAAG,CAAC,CAAC;IACd,KAAK,GAAG,CAAC,CAAC;IAElB,YAA6B,aAAa,SAAS;QAAtB,eAAU,GAAV,UAAU,CAAY;IAAG,CAAC;IAEvD,IAAI,CAAC,KAAoB,EAAE,KAAa;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,OAAO,IAAI,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAClE,CAAC;CACF"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "busybar-kit",
+  "version": "0.1.0",
+  "description": "Shared building blocks for BUSY Bar apps: device geometry, colours, formatters, ticker text, error taxonomy and an offline PNG preview renderer",
+  "author": "viirtualp1",
+  "license": "MIT",
+  "type": "module",
+  "repository": { 
+    "type": "git", 
+    "url": "git+https://github.com/viirtualp1/busybar-kit.git" 
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./colors": "./dist/colors.js",
+    "./config": "./dist/config/index.js",
+    "./device": "./dist/device.js",
+    "./elements": "./dist/elements.js",
+    "./errors": "./dist/errors.js",
+    "./format": "./dist/format.js",
+    "./preview": "./dist/preview/index.js",
+    "./ticker": "./dist/ticker/index.js",
+    "./tsconfig.json": "./configs/tsconfig.base.json",
+    "./eslint": "./configs/eslint.config.js",
+    "./prettier": "./configs/prettier.json",
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "busybar-fix-esm": "scripts/fix-esm-extensions.mjs"
+  },
+  "files": [
+    "dist",
+    "configs",
+    "scripts",
+    "README.md"
+  ],
+  "keywords": [
+    "busy-bar",
+    "busybar",
+    "led",
+    "pixel",
+    "preview"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json && node scripts/fix-esm-extensions.mjs",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "node --import tsx --test \"test/**/*.test.ts\"",
+    "check": "npm run lint && npm run typecheck && npm test",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run check && npm run build"
+  },
+  "peerDependencies": {
+    "@busy-app/busy-lib": "^0.18.0"
+  },
+  "devDependencies": {
+    "@busy-app/busy-lib": "^0.18.0",
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^24.13.3",
+    "eslint": "^10.8.1",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.9.6",
+    "tsx": "^4.23.12",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.67.0"
+  }
+}

package/scripts/fix-esm-extensions.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+
+// Node's ESM loader wants a real file name; tsc leaves extensionless specifiers.
+const argument = process.argv[2] ?? 'dist';
+const dist = isAbsolute(argument) ? argument : resolve(process.cwd(), argument);
+const EXTENSIONS = /\.(?:js|json|mjs|cjs|node)$/;
+
+function walk(dir) {
+  for (const name of readdirSync(dir)) {
+    const path = join(dir, name);
+    if (statSync(path).isDirectory()) {
+      walk(path);
+      continue;
+    }
+    if (!/\.(?:js|d\.ts)$/.test(name)) {
+      continue;
+    }
+
+    const source = readFileSync(path, 'utf8');
+    const next = source.replace(
+      /(from\s+|import\s*\()(['"])(\.[^'"]+)\2/g,
+      (match, prefix, quote, spec) =>
+        EXTENSIONS.test(spec) ? match : `${prefix}${quote}${spec}.js${quote}`,
+    );
+    if (next !== source) {
+      writeFileSync(path, next);
+    }
+  }
+}
+
+walk(dist);