@514sid/signagekit 0.0.0-stage → 0.0.1

package/examples/sales-today/layout.json

@@ -0,0 +1,62 @@
+{
+  "colors": { "scheme": "light", "background": "#ffffff", "accent": "#1d4ed8" },
+  "layout": {
+    "design": "landscape",
+    "flow": [
+      { "zone": "head", "span": 5, "height": "150px" },
+      { "zone": "revenue", "span": 4, "height": "150px" },
+      { "zone": "target", "span": 3, "height": "150px" },
+      { "zone": "hourly", "span": 8, "height": 3 },
+      { "zone": "reps", "span": 4, "height": 3 },
+      { "zone": "regions", "span": 12, "height": 2 }
+    ]
+  },
+  "zones": {
+    "head": { "type": "heading", "text": "Sales today" },
+    "revenue": {
+      "type": "stat",
+      "surface": "raised",
+      "title": "Revenue",
+      "value": { "bind": "/kpi/revenue" },
+      "label": "Since midnight",
+      "format": "compact"
+    },
+    "target": {
+      "type": "stat",
+      "surface": "raised",
+      "title": "Against target",
+      "value": { "bind": "/kpi/vs_target" },
+      "unit": "%",
+      "label": { "bind": "/kpi/target_label" },
+      "state": { "bind": "/kpi/state", "fallback": "neutral" },
+      "trend": { "bind": "/kpi/trend" },
+      "delta": { "bind": "/kpi/delta" },
+      "good_when": "up"
+    },
+    "hourly": {
+      "type": "chart",
+      "kind": "column",
+      "title": "Revenue by hour, thousands",
+      "labels": { "bind": "/hourly/labels" },
+      "series": [
+        { "name": "Revenue", "values": { "bind": "/hourly/revenue" } }
+      ],
+      "target": 15,
+      "target_label": "Hourly target 15K"
+    },
+    "reps": {
+      "type": "bars",
+      "title": "Top reps, $K",
+      "items": { "bind": "/reps" },
+      "limit": 6
+    },
+    "regions": {
+      "type": "meters",
+      "title": "Quota attainment by region",
+      "items": { "bind": "/regions" },
+      "max": 120,
+      "unit": "%",
+      "thresholds": { "warning": 85, "danger": 70 }
+    }
+  }
+}

package/examples/snow-closure/data.yml

@@ -0,0 +1,28 @@
+lunch:
+  - [Monday, Pasta bake]
+  - [Tuesday, Chicken wrap]
+  - [Wednesday, Veggie chili]
+  - [Thursday, Fish fingers]
+  - [Friday, Pizza]
+week:
+  - Picture day is Wednesday
+  - Library books due Thursday
+  - Parent evening Friday at 18:00
+messages:
+  - Please sign the field trip form
+  - Lost property is by the gym
+  - Bake sale on Friday
+
+alert:
+  level: warning
+  icon: snow
+  title: School closed tomorrow
+  message: 'Heavy snow is forecast overnight. Maple Ridge Elementary is closed on Tuesday.'
+  steps:
+    - School buses will not run
+    - Online lessons start at 9:00
+    - After-school club is cancelled
+    - Check the district app for updates
+  footer: 'Office 555-0178. Posted Monday at 15:10'
+  mode: takeover
+  until: '2026-11-15T00:00:00Z'

package/examples/snow-closure/layout.json

@@ -0,0 +1,35 @@
+{
+  "version": 1,
+  "colors": { "scheme": "light", "accent": "#0f766e" },
+  "layout": {
+    "design": "landscape",
+    "flow": [
+      { "zone": "head", "span": 9, "height": "170px" },
+      { "zone": "clock", "span": 3, "height": "170px" },
+      { "zone": "lunch", "span": 6, "height": 2 },
+      { "zone": "info", "span": 6, "height": 2 },
+      { "zone": "news", "height": "110px" }
+    ]
+  },
+  "zones": {
+    "head": { "type": "heading", "text": "Maple Ridge Elementary" },
+    "clock": { "type": "clock", "surface": "raised", "show_date": true },
+    "lunch": {
+      "type": "table",
+      "title": "Lunch menu",
+      "columns": ["Day", "Main"],
+      "rows": { "bind": "/lunch" }
+    },
+    "info": {
+      "type": "list",
+      "title": "This week",
+      "items": { "bind": "/week" }
+    },
+    "news": {
+      "type": "cycle",
+      "surface": "raised",
+      "items": { "bind": "/messages" }
+    }
+  },
+  "alert": { "bind": "/alert" }
+}

package/examples/station-departures/data.json

@@ -0,0 +1,24 @@
+{
+  "alert": {
+    "level": "warning",
+    "icon": "delay",
+    "title": "Delays to Amsterdam",
+    "message": "Signal fault near Breukelen. Allow 15 minutes extra.",
+    "mode": "banner"
+  },
+  "departures": [
+    ["14:08", "Amsterdam Centraal", 5, "+12 min"],
+    ["14:12", "Rotterdam Centraal", 6, "On time"],
+    ["14:17", "Arnhem Centraal", 4, "On time"],
+    ["14:20", "Den Haag Centraal", 7, "Cancelled"],
+    ["14:23", "Schiphol Airport", 5, "+12 min"],
+    ["14:28", "Eindhoven Centraal", 6, "On time"],
+    ["14:34", "Amersfoort Centraal", 4, "On time"],
+    ["14:38", "Amsterdam Centraal", 5, "+8 min"]
+  ],
+  "messages": [
+    "Lift to platform 6 out of service",
+    "Mind the gap",
+    "Lost property at the service desk, hall 2"
+  ]
+}

package/examples/station-departures/layout.json

@@ -0,0 +1,34 @@
+{
+  "version": 1,
+  "colors": { "scheme": "dark", "accent": "#facc15", "on_accent": "#111827" },
+  "alert": { "bind": "/alert" },
+  "layout": {
+    "design": "landscape",
+    "gap": 2,
+    "flow": [
+      { "zone": "head", "span": 8, "height": "160px" },
+      { "zone": "clock", "span": 4, "height": "160px" },
+      { "zone": "board", "height": 6 },
+      { "zone": "foot", "height": "110px" }
+    ]
+  },
+  "zones": {
+    "head": { "type": "heading", "text": "Departures, platforms 4 to 7", "icon": "location" },
+    "clock": { "type": "clock", "surface": "accent", "hour12": false },
+    "board": {
+      "type": "table",
+      "columns": ["Time", "To", "Plat.", "Status"],
+      "align": ["start", "start", "end", "end"],
+      "widths": [1.2, 4, 1, 2.2],
+      "page_rows": 8,
+      "seconds": 10,
+      "rows": { "bind": "/departures" }
+    },
+    "foot": {
+      "type": "cycle",
+      "surface": "raised",
+      "seconds": 8,
+      "items": { "bind": "/messages" }
+    }
+  }
+}

package/examples/store-promo/data.yml

@@ -0,0 +1,18 @@
+offer:
+  headline: Buy any two Northfield own-label snack multipacks and take the canvas tote home free while stocks last
+  ends: '2026-11-22T21:00:00Z'
+promo:
+  images:
+    - /examples/images/snacks.svg
+    - /examples/images/tote.svg
+    - /examples/images/hamper.svg
+featured:
+  src: /examples/images/kettle.svg
+join:
+  url: https://example.com/club
+ticker:
+  - Loyalty points are doubled every Thursday
+  - Returns accepted for 60 days with a receipt
+  - The bakery counter opens at 06:30 on weekdays
+  - ''
+  - Parking after 16:00 is free for members

package/examples/store-promo/layout.yml

@@ -0,0 +1,54 @@
+colors:
+  scheme: dark
+  accent: '#f97316'
+
+layout:
+  design: landscape
+  gap: 2
+  flow:
+    - { zone: hero, span: 8, height: 3 }
+    - { zone: clock, span: 4, height: 1 }
+    - { zone: offer, span: 4, height: 2 }
+    - { zone: featured, span: 4, height: 2 }
+    - { zone: join, span: 4, height: 2 }
+    - { zone: ticker, span: 12, height: 70px }
+
+zones:
+  hero:
+    type: slideshow
+    images: { bind: /promo/images }
+    seconds: 8
+    fit: contain
+  clock:
+    type: clock
+    title: Store time
+    show_date: true
+    hour12: false
+  offer:
+    type: stack
+    title: This week
+    direction: column
+    items:
+      - type: text
+        text: { bind: /offer/headline }
+        fit: true
+        align: start
+      - type: countdown
+        to: { bind: /offer/ends }
+        label: Ends
+  featured:
+    type: image
+    title: Staff pick
+    src: { bind: /featured/src }
+    fit: contain
+    alt: Staff pick of the week
+  join:
+    type: qr
+    title: Join the club
+    value: { bind: /join/url }
+    label: Scan for double points
+  ticker:
+    type: cycle
+    items: { bind: /ticker }
+    seconds: 9
+    align: center

package/examples/storm-banner/data.json

@@ -0,0 +1,20 @@
+{
+  "alert": {
+    "level": "warning",
+    "icon": "storm",
+    "title": "Storm warning",
+    "message": "Gusts up to 90 km/h until 18:00. Routes 14 and 22 may not run.",
+    "footer": "Check the operator app before you travel.",
+    "mode": "banner",
+    "until": "2026-11-14T18:00:00Z"
+  },
+  "departures": [
+    ["09:40", "14", "Harbour Quay", "Late 10 min"],
+    ["09:45", "22", "Ferndale", "Cancelled"],
+    ["09:55", "7", "Canal Street", "On time"],
+    ["10:05", "31", "Airport", "On time"],
+    ["10:15", "9", "Westgate", "Cancelled"]
+  ],
+  "running": 38,
+  "cancelled": 3
+}

package/examples/storm-banner/layout.json

@@ -0,0 +1,33 @@
+{
+  "version": 1,
+  "colors": { "scheme": "dark" },
+  "layout": {
+    "design": "landscape",
+    "flow": [
+      { "zone": "head", "span": 9, "height": "130px" },
+      { "zone": "clock", "span": 3, "height": "130px" },
+      { "zone": "departures", "span": 9, "height": 1 },
+      { "zone": "stats", "span": 3, "height": 1 }
+    ]
+  },
+  "zones": {
+    "head": { "type": "heading", "text": "Eastbridge interchange" },
+    "clock": { "type": "clock", "surface": "raised" },
+    "departures": {
+      "type": "table",
+      "title": "Next departures",
+      "columns": ["Time", "Route", "Destination", "Status"],
+      "align": ["start", "start", "start", "start"],
+      "rows": { "bind": "/departures" }
+    },
+    "stats": {
+      "type": "stack",
+      "direction": "column",
+      "items": [
+        { "type": "stat", "title": "Buses running", "value": { "bind": "/running" }, "state": "good" },
+        { "type": "stat", "title": "Cancelled today", "value": { "bind": "/cancelled" }, "state": "warning" }
+      ]
+    }
+  },
+  "alert": { "bind": "/alert" }
+}

package/examples/trading-floor/data.json

@@ -0,0 +1,23 @@
+{
+  "idx": {
+    "ftse": { "value": 8342.17, "trend": "up", "delta": "+0.42%", "spark": [8290, 8301, 8288, 8310, 8325, 8338, 8342] },
+    "spx": { "value": 6104.55, "trend": "down", "delta": "-0.18%", "spark": [6130, 6125, 6118, 6110, 6112, 6107, 6104] }
+  },
+  "chart": {
+    "labels": ["08:00", "09:00", "10:00", "11:00", "12:00", "13:00", "14:00", "15:00"],
+    "ftse": [0, 0.1, 0.3, 0.2, 0.35, 0.4, 0.38, 0.42],
+    "spx": [0, -0.05, -0.1, 0.05, -0.12, -0.2, -0.15, -0.18]
+  },
+  "movers": [
+    ["Rolls-Royce", "612.40", "+4.8"],
+    ["Anglo American", "2,481.00", "-3.9"],
+    ["Hargreaves Lansdown", "1,102.50", "+2.2"],
+    ["BP", "421.15", "-1.4"],
+    ["Scottish Mortgage", "892.00", "+1.1"]
+  ],
+  "messages": [
+    "ECB rate decision 13:15 CET",
+    "Pre-trade compliance sign-off for orders above 10M",
+    "BoE governor speaks at 15:30"
+  ]
+}

package/examples/trading-floor/layout.json

@@ -0,0 +1,65 @@
+{
+  "version": 1,
+  "colors": { "scheme": "dark" },
+  "layout": {
+    "design": "landscape",
+    "flow": [
+      { "zone": "head", "span": 4, "height": "130px" },
+      { "zone": "clocks", "span": 8, "height": "130px" },
+      { "zone": "idx_ftse", "span": 6, "height": 2 },
+      { "zone": "idx_spx", "span": 6, "height": 2 },
+      { "zone": "chart", "span": 6, "height": 4 },
+      { "zone": "movers", "span": 6, "height": 4 },
+      { "zone": "news", "height": "100px" }
+    ]
+  },
+  "zones": {
+    "head": { "type": "heading", "text": "Equities desk" },
+    "clocks": {
+      "type": "clocks",
+      "zones": [
+        { "label": "London", "zone": "Europe/London" },
+        { "label": "New York", "zone": "America/New_York" },
+        { "label": "Tokyo", "zone": "Asia/Tokyo" }
+      ]
+    },
+    "idx_ftse": {
+      "type": "stat",
+      "title": "FTSE 100",
+      "value": { "bind": "/idx/ftse/value" },
+      "trend": { "bind": "/idx/ftse/trend" },
+      "delta": { "bind": "/idx/ftse/delta" },
+      "good_when": "up",
+      "spark": { "bind": "/idx/ftse/spark" }
+    },
+    "idx_spx": {
+      "type": "stat",
+      "title": "S&P 500",
+      "value": { "bind": "/idx/spx/value" },
+      "trend": { "bind": "/idx/spx/trend" },
+      "delta": { "bind": "/idx/spx/delta" },
+      "good_when": "up",
+      "spark": { "bind": "/idx/spx/spark" }
+    },
+    "chart": {
+      "type": "chart",
+      "kind": "line",
+      "title": "Intraday index, % change",
+      "labels": { "bind": "/chart/labels" },
+      "series": [
+        { "name": "FTSE 100", "values": { "bind": "/chart/ftse" } },
+        { "name": "S&P 500", "values": { "bind": "/chart/spx" } }
+      ]
+    },
+    "movers": {
+      "type": "table",
+      "title": "Biggest movers",
+      "columns": ["Name", "Last", "Chg %"],
+      "align": ["start", "end", "end"],
+      "rows": { "bind": "/movers" },
+      "page_rows": 5,
+      "seconds": 8
+    },
+    "news": { "type": "cycle", "surface": "raised", "seconds": 6, "items": { "bind": "/messages" } }
+  }
+}

package/examples/warehouse/data.json

@@ -0,0 +1,20 @@
+{
+  "site": "Waalhaven DC, building 3",
+  "picks": 12907,
+  "dock": {
+    "current": "T-2291",
+    "recent": ["T-2290", "T-2289", "T-2288"]
+  },
+  "trucks": [
+    ["DHL Freight", "Hamburg", "4", "14:10"],
+    ["Van der Berg", "Antwerp", "7", "14:25"],
+    ["DB Schenker", "Lyon", "2", "14:40"],
+    ["Kuehne + Nagel", "Paris", "5", "15:05"],
+    ["GEODIS", "Madrid", "6", "15:20"]
+  ],
+  "forklifts": [
+    { "label": "FLT-07", "value": 12 },
+    { "label": "FLT-03", "value": 28 },
+    { "label": "FLT-11", "value": 64 }
+  ]
+}

package/examples/warehouse/layout.json

@@ -0,0 +1,50 @@
+{
+  "colors": { "scheme": "dark", "accent": "#a3e635", "on_accent": "#111827" },
+  "layout": {
+    "design": "landscape",
+    "flow": [
+      { "zone": "head", "span": 9, "height": "120px" },
+      { "zone": "clock", "span": 3, "height": "120px" },
+      { "zone": "dock", "span": 4, "height": 3 },
+      { "zone": "shipments", "span": 8, "height": 3 },
+      { "zone": "picks", "span": 5, "height": 2 },
+      { "zone": "forklifts", "span": 7, "height": 2 }
+    ]
+  },
+  "zones": {
+    "head": { "type": "heading", "text": { "bind": "/site" } },
+    "clock": { "type": "clock", "surface": "raised" },
+    "dock": {
+      "type": "queue",
+      "title": "Dock call-up",
+      "label": "Door 4 loading",
+      "current": { "bind": "/dock/current" },
+      "recent": { "bind": "/dock/recent" }
+    },
+    "shipments": {
+      "type": "table",
+      "title": "Outbound trucks",
+      "columns": ["Carrier", "Destination", "Door", "ETD"],
+      "align": ["start", "start", "center", "end"],
+      "rows": { "bind": "/trucks" },
+      "page_rows": 5,
+      "seconds": 8
+    },
+    "picks": {
+      "type": "stat",
+      "title": "Picks today",
+      "value": { "bind": "/picks" },
+      "format": "full",
+      "trend": "up",
+      "delta": "+9%",
+      "good_when": "up"
+    },
+    "forklifts": {
+      "type": "meters",
+      "title": "Forklift battery",
+      "unit": "%",
+      "thresholds": { "warning": 30, "danger": 15 },
+      "items": { "bind": "/forklifts" }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,102 @@
 {
   "name": "@514sid/signagekit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "A toolkit for AI agents that build digital signage screens: dashboards, menus, schedules and alerts as JSON or YAML templates, laid out for any display.",
+  "keywords": [
+    "ai",
+    "ai-agents",
+    "dashboard",
+    "declarative",
+    "digital-signage",
+    "display",
+    "layout",
+    "llm",
+    "preact",
+    "signage",
+    "templates",
+    "yaml"
+  ],
+  "license": "MIT",
+  "author": "514sid",
+  "homepage": "https://signagekit.514sid.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/514sid/signagekit.git"
+  },
+  "bugs": "https://github.com/514sid/signagekit/issues",
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./style.css": "./dist/style.css",
+    "./schema.json": "./schema.json",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "bin": {
+    "signagekit": "./bin/signagekit.js"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "bin",
+    "schema.json",
+    "docs",
+    "examples",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "prepublishOnly": "bun run check-all && bun run build",
+    "check-all": "bun run type-check && bun run lint && bun run format:check && bun test",
+    "test": "bun test",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint .",
+    "format": "prettier --write src stories scripts bin .storybook docs site README.md",
+    "format:check": "prettier --check src stories scripts bin .storybook docs site README.md",
+    "check": "bun run build && node bin/signagekit.js check",
+    "preview": "bun scripts/preview.ts",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build",
+    "site:build": "cd site && astro build",
+    "site:dev": "cd site && astro dev"
+  },
+  "dependencies": {
+    "preact": "10.27.2",
+    "uplot": "1.6.32",
+    "uqr": "0.1.3",
+    "yaml": "2.9.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "10.0.1",
+    "@playwright/test": "1.65.1",
+    "@storybook/preact-vite": "10.6.5",
+    "@tailwindcss/typography": "0.5.20",
+    "@tailwindcss/vite": "4.3.3",
+    "@types/bun": "1.3.13",
+    "@types/jsdom": "28.0.3",
+    "astro": "7.4.4",
+    "eslint": "10.15.0",
+    "jsdom": "28.1.0",
+    "marked": "18.1.2",
+    "prettier": "3.10.1",
+    "storybook": "10.6.5",
+    "tailwindcss": "4.3.3",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.72.2",
+    "vite": "8.3.8"
+  },
+  "prettier": "./.prettierrc.json",
+  "publishConfig": {
+    "access": "public"
+  }
+}