@overcrow/mcp 0.0.0 → 0.1.0

package/dist/content/examples/media/tests/read-only.scenario.json

@@ -0,0 +1,53 @@
+{
+  "scenarioVersion": 1,
+  "name": "read-only",
+  "description": "With media.read alone the track shows without buttons, even in Interactive mode.",
+  "host": {
+    "grants": [
+      "media.read"
+    ],
+    "mode": "interactive"
+  },
+  "assets": {
+    "aurora": "tests/assets/aurora.png",
+    "horizon": "tests/assets/horizon.png",
+    "tiles": "tests/assets/tiles.png"
+  },
+  "fixtures": {
+    "subscriptions": {
+      "media.subscribe": {
+        "player": "p1",
+        "title": "Beyond the northern lights",
+        "artists": [
+          "The Quiet Expedition"
+        ],
+        "playing": true,
+        "canPrevious": true,
+        "canPlayPause": true,
+        "canNext": true,
+        "cover": "fixture:aurora"
+      }
+    }
+  },
+  "steps": [
+    {
+      "expect": {
+        "state": "running",
+        "text": [
+          "Beyond the northern lights"
+        ],
+        "calls": [
+          {
+            "service": "media.subscribe",
+            "params": {
+              "cover": true
+            },
+            "outcome": "ok"
+          }
+        ],
+        "image": "read-only",
+        "fault": "none"
+      }
+    }
+  ]
+}

package/dist/content/examples/media/tests/refused.scenario.json

@@ -0,0 +1,22 @@
+{
+  "scenarioVersion": 1,
+  "name": "refused",
+  "description": "Without its grants the widget asks nothing: no player, the cover placeholder, no button.",
+  "host": {
+    "grants": [],
+    "mode": "interactive"
+  },
+  "steps": [
+    {
+      "expect": {
+        "state": "running",
+        "text": [
+          "No active media"
+        ],
+        "calls": [],
+        "image": "refused",
+        "fault": "none"
+      }
+    }
+  ]
+}

package/dist/content/examples/media/tests/refused.test.mjs

@@ -0,0 +1,31 @@
+// Without its grants the logic asks the host nothing and shows no buttons;
+// with media.read alone it shows the track without buttons.
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import { installRuntime } from "@overcrow/sdk/testing";
+
+import { loadLogic } from "./load-logic.mjs";
+
+const vm = installRuntime({ host: { grants: [], mode: "interactive" } });
+const logic = await loadLogic();
+const { state } = await import("@overcrow/sdk");
+
+test("no grant: no subscription, no player, no buttons", () => {
+  assert.equal(vm.subscriptions.length, 0);
+  assert.equal(vm.calls.length, 0);
+  assert.equal(state.media, null);
+  assert.equal(state.unavailable, false);
+  const known = {
+    player: "p1",
+    title: "T",
+    artists: [],
+    playing: false,
+    canPrevious: true,
+    canPlayPause: true,
+    canNext: true,
+    cover: null,
+  };
+  assert.deepEqual(logic.controls(known, true), [], "no media.control");
+  vm.setHost({ options: { "show-cover": false } });
+  assert.equal(vm.subscriptions.length, 0, "the cover option asks nothing without the grant");
+});

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

@@ -0,0 +1,136 @@
+{
+  "scenarioVersion": 1,
+  "name": "render",
+  "description": "A playing track with its cover, in Interactive mode with its three buttons, in both themes and languages at 100 and 150 %; Passive shows no button.",
+  "host": {
+    "mode": "interactive"
+  },
+  "assets": {
+    "aurora": "tests/assets/aurora.png",
+    "horizon": "tests/assets/horizon.png",
+    "tiles": "tests/assets/tiles.png"
+  },
+  "fixtures": {
+    "subscriptions": {
+      "media.subscribe": {
+        "player": "p1",
+        "title": "Beyond the northern lights",
+        "artists": [
+          "The Quiet Expedition"
+        ],
+        "playing": true,
+        "canPrevious": true,
+        "canPlayPause": true,
+        "canNext": true,
+        "cover": "fixture:aurora"
+      }
+    }
+  },
+  "steps": [
+    {
+      "expect": {
+        "state": "running",
+        "text": [
+          "Beyond the northern lights",
+          "The Quiet Expedition"
+        ],
+        "calls": [
+          {
+            "service": "media.subscribe",
+            "params": {
+              "cover": true
+            },
+            "outcome": "ok"
+          }
+        ],
+        "image": "playing-dark-en-100"
+      }
+    },
+    {
+      "host": {
+        "theme": "light"
+      }
+    },
+    {
+      "expect": {
+        "image": "playing-light-en-100"
+      }
+    },
+    {
+      "host": {
+        "locale": "fr"
+      }
+    },
+    {
+      "expect": {
+        "image": "playing-light-fr-100"
+      }
+    },
+    {
+      "host": {
+        "theme": "dark"
+      }
+    },
+    {
+      "expect": {
+        "image": "playing-dark-fr-100"
+      }
+    },
+    {
+      "host": {
+        "scale": 1500
+      }
+    },
+    {
+      "expect": {
+        "image": "playing-dark-fr-150"
+      }
+    },
+    {
+      "host": {
+        "theme": "light",
+        "locale": "en"
+      }
+    },
+    {
+      "expect": {
+        "image": "playing-light-en-150"
+      }
+    },
+    {
+      "host": {
+        "theme": "dark"
+      }
+    },
+    {
+      "expect": {
+        "image": "playing-dark-en-150"
+      }
+    },
+    {
+      "host": {
+        "locale": "fr",
+        "theme": "light"
+      }
+    },
+    {
+      "expect": {
+        "image": "playing-light-fr-150"
+      }
+    },
+    {
+      "host": {
+        "mode": "passive",
+        "scale": 1000,
+        "theme": "dark",
+        "locale": "en"
+      }
+    },
+    {
+      "expect": {
+        "image": "passive-dark-en-100",
+        "fault": "none"
+      }
+    }
+  ]
+}

package/dist/content/examples/media/tests/states.scenario.json

@@ -0,0 +1,257 @@
+{
+  "scenarioVersion": 1,
+  "name": "states",
+  "description": "No player, then a paused track (play button), a track without artist (one-row cover), an unknown title, a player with only play/pause, a track without cover (placeholder), then the player gone.",
+  "host": {
+    "mode": "interactive"
+  },
+  "assets": {
+    "aurora": "tests/assets/aurora.png",
+    "horizon": "tests/assets/horizon.png",
+    "tiles": "tests/assets/tiles.png"
+  },
+  "fixtures": {
+    "subscriptions": {
+      "media.subscribe": null
+    }
+  },
+  "steps": [
+    {
+      "expect": {
+        "state": "running",
+        "text": [
+          "No active media"
+        ],
+        "noText": [
+          "Media is temporarily unavailable."
+        ],
+        "image": "no-player-dark-en"
+      }
+    },
+    {
+      "host": {
+        "locale": "fr",
+        "theme": "light"
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "Aucun média actif"
+        ],
+        "image": "no-player-light-fr"
+      }
+    },
+    {
+      "host": {
+        "locale": "en",
+        "theme": "dark"
+      }
+    },
+    {
+      "publish": {
+        "service": "media.subscribe",
+        "value": {
+          "player": "p1",
+          "title": "Beyond the northern lights",
+          "artists": [
+            "The Quiet Expedition"
+          ],
+          "playing": false,
+          "canPrevious": true,
+          "canPlayPause": true,
+          "canNext": true,
+          "cover": "fixture:aurora"
+        }
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "Beyond the northern lights"
+        ],
+        "image": "paused-dark-en"
+      }
+    },
+    {
+      "host": {
+        "locale": "fr"
+      }
+    },
+    {
+      "expect": {
+        "image": "paused-dark-fr"
+      }
+    },
+    {
+      "host": {
+        "locale": "en"
+      }
+    },
+    {
+      "publish": {
+        "service": "media.subscribe",
+        "value": {
+          "player": "p1",
+          "title": "Beyond the northern lights",
+          "artists": [],
+          "playing": true,
+          "canPrevious": true,
+          "canPlayPause": true,
+          "canNext": true,
+          "cover": "fixture:aurora"
+        }
+      }
+    },
+    {
+      "expect": {
+        "noText": [
+          "The Quiet Expedition"
+        ],
+        "image": "no-artist"
+      }
+    },
+    {
+      "publish": {
+        "service": "media.subscribe",
+        "value": {
+          "player": "p1",
+          "title": null,
+          "artists": [
+            "The Quiet Expedition"
+          ],
+          "playing": true,
+          "canPrevious": true,
+          "canPlayPause": true,
+          "canNext": true,
+          "cover": "fixture:aurora"
+        }
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "Unknown title"
+        ],
+        "image": "unknown-title-en"
+      }
+    },
+    {
+      "host": {
+        "locale": "fr"
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "Titre inconnu"
+        ],
+        "image": "unknown-title-fr"
+      }
+    },
+    {
+      "host": {
+        "locale": "en"
+      }
+    },
+    {
+      "publish": {
+        "service": "media.subscribe",
+        "value": {
+          "player": "p1",
+          "title": "Beyond the northern lights",
+          "artists": [
+            "The Quiet Expedition"
+          ],
+          "playing": false,
+          "canPrevious": false,
+          "canPlayPause": true,
+          "canNext": false,
+          "cover": "fixture:aurora"
+        }
+      }
+    },
+    {
+      "expect": {
+        "image": "only-play"
+      }
+    },
+    {
+      "publish": {
+        "service": "media.subscribe",
+        "value": {
+          "player": "p1",
+          "title": "Beyond the northern lights",
+          "artists": [
+            "The Quiet Expedition"
+          ],
+          "playing": true,
+          "canPrevious": false,
+          "canPlayPause": false,
+          "canNext": false,
+          "cover": "fixture:aurora"
+        }
+      }
+    },
+    {
+      "expect": {
+        "image": "no-control"
+      }
+    },
+    {
+      "publish": {
+        "service": "media.subscribe",
+        "value": {
+          "player": "p1",
+          "title": "Beyond the northern lights",
+          "artists": [
+            "The Quiet Expedition"
+          ],
+          "playing": true,
+          "canPrevious": true,
+          "canPlayPause": true,
+          "canNext": true,
+          "cover": null
+        }
+      }
+    },
+    {
+      "expect": {
+        "image": "no-cover-dark"
+      }
+    },
+    {
+      "host": {
+        "theme": "light"
+      }
+    },
+    {
+      "expect": {
+        "image": "no-cover-light"
+      }
+    },
+    {
+      "host": {
+        "theme": "dark"
+      }
+    },
+    {
+      "publish": {
+        "service": "media.subscribe",
+        "value": null
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "No active media"
+        ],
+        "noText": [
+          "Beyond the northern lights"
+        ],
+        "image": "player-gone",
+        "fault": "none"
+      }
+    }
+  ]
+}

package/dist/content/examples/media/tests/unavailable.scenario.json

@@ -0,0 +1,120 @@
+{
+  "scenarioVersion": 1,
+  "name": "unavailable",
+  "description": "The host's media source fails: the subscription ends with unavailable, the widget shows it, subscribes again 5 s later and shows the player the restarted source reports.",
+  "host": {
+    "mode": "interactive"
+  },
+  "assets": {
+    "aurora": "tests/assets/aurora.png",
+    "horizon": "tests/assets/horizon.png",
+    "tiles": "tests/assets/tiles.png"
+  },
+  "fixtures": {
+    "subscriptions": {
+      "media.subscribe": {
+        "player": "p1",
+        "title": "Beyond the northern lights",
+        "artists": [
+          "The Quiet Expedition"
+        ],
+        "playing": true,
+        "canPrevious": true,
+        "canPlayPause": true,
+        "canNext": true,
+        "cover": "fixture:aurora"
+      }
+    }
+  },
+  "steps": [
+    {
+      "expect": {
+        "state": "running",
+        "calls": [
+          {
+            "service": "media.subscribe",
+            "params": {
+              "cover": true
+            },
+            "outcome": "ok"
+          }
+        ]
+      }
+    },
+    {
+      "publish": {
+        "service": "media.subscribe",
+        "error": "unavailable"
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "No active media",
+          "Media is temporarily unavailable."
+        ],
+        "noText": [
+          "Beyond the northern lights"
+        ],
+        "image": "unavailable-dark-en"
+      }
+    },
+    {
+      "host": {
+        "locale": "fr",
+        "theme": "light"
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "Aucun média actif",
+          "Le média est temporairement indisponible."
+        ],
+        "image": "unavailable-light-fr"
+      }
+    },
+    {
+      "host": {
+        "locale": "en",
+        "theme": "dark"
+      }
+    },
+    {
+      "advance": {
+        "ms": 4999
+      }
+    },
+    {
+      "expect": {
+        "calls": []
+      }
+    },
+    {
+      "advance": {
+        "ms": 1
+      }
+    },
+    {
+      "expect": {
+        "calls": [
+          {
+            "service": "media.subscribe",
+            "params": {
+              "cover": true
+            },
+            "outcome": "ok"
+          }
+        ],
+        "text": [
+          "Beyond the northern lights"
+        ],
+        "noText": [
+          "Media is temporarily unavailable."
+        ],
+        "image": "recovered",
+        "fault": "none"
+      }
+    }
+  ]
+}

package/dist/content/examples/media/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "lib": ["ES2023"],
+    "types": [],
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true
+  },
+  "include": ["logic.ts"]
+}

package/dist/content/examples/media/view.ocml

@@ -0,0 +1,41 @@
+<!-- Media: the cover, the title and artists, and the transport buttons in
+     Interactive mode (parity sheet: playervox-overcrow
+     docs/builtin-parity/media.md). The cover is a host asset; the host
+     scrolls an overflowing title. -->
+<box class={rootClass(state.showCover)} label={t("label")}>
+  <if test={state.showCover}>
+    <if test={state.media && state.media.cover}>
+      <image class={coverClass(state.media, state.media.cover)} src={state.media.cover} label={t("cover")}/>
+    </if>
+    <else>
+      <box class={coverClass(state.media, null)} label={t("cover")}>
+        <icon class="cover-icon" name="music"/>
+      </box>
+    </else>
+  </if>
+  <if test={state.media}>
+    <box class="meta">
+      <text class={titleClass(state.scrollTitle)} label={title(state.media)} tooltip={title(state.media)}>{title(state.media)}</text>
+      <if test={artists(state.media) != ""}>
+        <text class="artist" tooltip={artists(state.media)}>{artists(state.media)}</text>
+      </if>
+    </box>
+    <if test={controls(state.media, state.interactive).length > 0}>
+      <box class="controls">
+        <for each={controls(state.media, state.interactive)} as="control" key={control.key}>
+          <button class="control" label={control.label} tooltip={control.label} on:activate={activate(control.key)}>
+            <icon name={control.icon}/>
+          </button>
+        </for>
+      </box>
+    </if>
+  </if>
+  <else>
+    <box class="meta">
+      <text class="empty">{t("no-media")}</text>
+    </box>
+    <if test={state.unavailable}>
+      <text class="message" tooltip={t("unavailable")}>{t("unavailable")}</text>
+    </if>
+  </else>
+</box>

package/dist/content/examples/notes/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Valhallab SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.