@overcrow/mcp 0.0.0-stage → 0.1.0

package/dist/content/examples/warframe-market/tests/search.scenario.json

@@ -0,0 +1,189 @@
+{
+  "scenarioVersion": 1,
+  "name": "search",
+  "description": "Interactive typing: results as the user types, no match, then Clear; the search is saved a second after the last keystroke.",
+  "host": {
+    "mode": "interactive"
+  },
+  "fixtures": {
+    "http": [
+      {
+        "request": {
+          "method": "GET",
+          "url": "https://api.warframe.market/v2/versions"
+        },
+        "response": {
+          "status": 200,
+          "contentType": "application/json",
+          "body": "{\"apiVersion\":\"0.25.0\",\"data\":{\"id\":\"synthetic\",\"collections\":{\"items\":\"v1\"},\"updatedAt\":\"2026-09-28T16:09:39Z\"},\"error\":null}"
+        }
+      },
+      {
+        "request": {
+          "method": "GET",
+          "url": "https://api.warframe.market/v2/items"
+        },
+        "response": {
+          "status": 200,
+          "contentType": "application/json",
+          "body": "{\"apiVersion\":\"0.25.0\",\"data\":[{\"id\":\"000000000000000000000000\",\"slug\":\"arcane_energize\",\"gameRef\":\"/Lotus/Synthetic/0\",\"tags\":[\"synthetic\"],\"i18n\":{\"en\":{\"name\":\"Arcane Energize\",\"icon\":\"items/images/en/arcane_energize.png\",\"thumb\":\"items/images/en/thumbs/arcane_energize.128x128.png\"}}},{\"id\":\"000000000000000000000001\",\"slug\":\"arcane_grace\",\"gameRef\":\"/Lotus/Synthetic/1\",\"tags\":[\"synthetic\"],\"i18n\":{\"en\":{\"name\":\"Arcane Grace\",\"icon\":\"items/images/en/arcane_grace.png\",\"thumb\":\"items/images/en/thumbs/arcane_grace.128x128.png\"}}},{\"id\":\"000000000000000000000002\",\"slug\":\"arcane_guardian\",\"gameRef\":\"/Lotus/Synthetic/2\",\"tags\":[\"synthetic\"],\"i18n\":{\"en\":{\"name\":\"Arcane Guardian\",\"icon\":\"items/images/en/arcane_guardian.png\",\"thumb\":\"items/images/en/thumbs/arcane_guardian.128x128.png\"}}},{\"id\":\"000000000000000000000003\",\"slug\":\"forma_blueprint\",\"gameRef\":\"/Lotus/Synthetic/3\",\"tags\":[\"synthetic\"],\"i18n\":{\"en\":{\"name\":\"Forma Blueprint\",\"icon\":\"items/images/en/forma_blueprint.png\",\"thumb\":\"items/images/en/thumbs/forma_blueprint.128x128.png\"}}},{\"id\":\"000000000000000000000004\",\"slug\":\"primed_flow\",\"gameRef\":\"/Lotus/Synthetic/4\",\"tags\":[\"synthetic\"],\"i18n\":{\"en\":{\"name\":\"Primed Flow\",\"icon\":\"items/images/en/primed_flow.png\",\"thumb\":\"items/images/en/thumbs/primed_flow.128x128.png\"}}},{\"id\":\"000000000000000000000005\",\"slug\":\"soma_prime_set\",\"gameRef\":\"/Lotus/Synthetic/5\",\"tags\":[\"synthetic\"],\"i18n\":{\"en\":{\"name\":\"Soma Prime Set\",\"icon\":\"items/images/en/soma_prime_set.png\",\"thumb\":\"items/images/en/thumbs/soma_prime_set.128x128.png\"}}},{\"id\":\"000000000000000000000006\",\"slug\":\"hells_chamber\",\"gameRef\":\"/Lotus/Synthetic/6\",\"tags\":[\"synthetic\"],\"i18n\":{\"en\":{\"name\":\"Hell's Chamber\",\"icon\":\"items/images/en/hells_chamber.png\",\"thumb\":\"items/images/en/thumbs/hells_chamber.128x128.png\"}}},{\"id\":\"000000000000000000000007\",\"slug\":\"silva_and_aegis_prime_guard\",\"gameRef\":\"/Lotus/Synthetic/7\",\"tags\":[\"synthetic\"],\"i18n\":{\"en\":{\"name\":\"Silva & Aegis Prime Guard\",\"icon\":\"items/images/en/silva_and_aegis_prime_guard.png\",\"thumb\":\"items/images/en/thumbs/silva_and_aegis_prime_guard.128x128.png\"}}}],\"error\":null}"
+        }
+      }
+    ]
+  },
+  "steps": [
+    {
+      "advance": {
+        "ms": 400
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "Find an item to compare offers and copy a trade whisper.",
+          "Results update as you type"
+        ]
+      }
+    },
+    {
+      "pointer": {
+        "click": {
+          "label": "Item name"
+        }
+      }
+    },
+    {
+      "text": "prime"
+    },
+    {
+      "expect": {
+        "text": [
+          "Primed Flow",
+          "Soma Prime Set",
+          "Silva & Aegis Prime Guard"
+        ],
+        "noText": [
+          "Arcane Grace"
+        ],
+        "image": "prime"
+      }
+    },
+    {
+      "advance": {
+        "ms": 1000
+      }
+    },
+    {
+      "expect": {
+        "calls": [
+          {
+            "service": "storage.get",
+            "outcome": "ok"
+          },
+          {
+            "service": "storage.get",
+            "outcome": "ok"
+          },
+          {
+            "service": "http.fetch",
+            "outcome": "ok"
+          },
+          {
+            "service": "http.fetch",
+            "outcome": "ok"
+          },
+          {
+            "service": "storage.remove",
+            "outcome": "ok"
+          },
+          {
+            "service": "storage.set",
+            "outcome": "ok"
+          },
+          {
+            "service": "storage.remove",
+            "outcome": "ok"
+          },
+          {
+            "service": "storage.remove",
+            "outcome": "ok"
+          },
+          {
+            "service": "storage.set",
+            "outcome": "ok"
+          },
+          {
+            "service": "storage.set",
+            "params": {
+              "key": "state",
+              "value": {
+                "query": "prime"
+              }
+            },
+            "outcome": "ok"
+          }
+        ]
+      }
+    },
+    {
+      "pointer": {
+        "click": {
+          "label": "Clear"
+        }
+      }
+    },
+    {
+      "pointer": {
+        "click": {
+          "label": "Item name"
+        }
+      }
+    },
+    {
+      "text": "hell's"
+    },
+    {
+      "expect": {
+        "text": [
+          "Hell's Chamber"
+        ]
+      }
+    },
+    {
+      "pointer": {
+        "click": {
+          "label": "Clear"
+        }
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "Find an item to compare offers and copy a trade whisper."
+        ],
+        "noText": [
+          "Hell's Chamber"
+        ]
+      }
+    },
+    {
+      "pointer": {
+        "click": {
+          "label": "Item name"
+        }
+      }
+    },
+    {
+      "text": "zzz"
+    },
+    {
+      "expect": {
+        "text": [
+          "No matching items. Try a different name."
+        ],
+        "image": "no-match",
+        "fault": "none"
+      }
+    }
+  ]
+}

package/dist/content/examples/warframe-market/tests/unavailable.scenario.json

@@ -0,0 +1,54 @@
+{
+  "scenarioVersion": 1,
+  "name": "unavailable",
+  "description": "No stored catalog and the download fails: the catalog is unavailable, in both themes.",
+  "fixtures": {
+    "http": [
+      {
+        "request": {
+          "method": "GET",
+          "url": "https://api.warframe.market/v2/versions"
+        },
+        "response": {
+          "status": 200,
+          "contentType": "application/json",
+          "body": "{\"apiVersion\":\"0.25.0\",\"data\":{\"id\":\"synthetic\",\"collections\":{\"items\":\"v1\"},\"updatedAt\":\"2026-09-28T16:09:39Z\"},\"error\":null}"
+        }
+      },
+      {
+        "request": {
+          "method": "GET",
+          "url": "https://api.warframe.market/v2/items"
+        },
+        "error": "transport_failed"
+      }
+    ]
+  },
+  "steps": [
+    {
+      "advance": {
+        "ms": 400
+      }
+    },
+    {
+      "expect": {
+        "text": [
+          "Catalog unavailable",
+          "The item catalog could not be loaded. Reopen the widget later to try again."
+        ],
+        "image": "unavailable-dark"
+      }
+    },
+    {
+      "host": {
+        "theme": "light"
+      }
+    },
+    {
+      "expect": {
+        "image": "unavailable-light",
+        "fault": "none"
+      }
+    }
+  ]
+}

package/dist/content/examples/warframe-market/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/warframe-market/view.ocml

@@ -0,0 +1,116 @@
+<!-- Warframe Market: search the PC item catalog, compare the online offers
+     of one item, sellers and buyers in two tabs, and copy a trade whisper
+     (the Web widget it replaces: widgets/warframe-market before P4.3). -->
+<component name="offers" props="side orders feedback">
+  <if test={orders.length == 0}>
+    <text class="no-offers">{noOffers(side)}</text>
+  </if>
+  <else>
+    <for each={orders} as="order" key={order.id}>
+      <box class="order">
+        <box class="order-line">
+          <text class="order-price">{price(order.platinum)}</text>
+          <box class="order-player">
+            <text class="order-trader" tooltip={order.trader}>{order.trader}</text>
+            <box class={presenceClass(order.presence)} label={presenceLabel(order.presence)} tooltip={presenceLabel(order.presence)}/>
+          </box>
+          <button class={copyClass(feedback, side, order.id)} label={t("copy-to", { name: order.trader })} disabled={copyBusy(feedback)} on:activate={copy(side, order.id)}>
+            <if test={copyClass(feedback, side, order.id) == "copy copied"}>
+              <icon class="copy-icon" name="check"/>
+            </if>
+            <text class="copy-text">{copyLabel(feedback, side, order.id)}</text>
+          </button>
+        </box>
+        <text class="order-detail">{orderDetail(order)}</text>
+      </box>
+    </for>
+  </else>
+</component>
+
+<box class="market">
+  <box class="identity">
+    <box class="identity-text">
+      <text class="eyebrow brand">{t("eyebrow")}</text>
+      <text class="subtitle">{t("subtitle")}</text>
+    </box>
+    <badge class="platform">{t("platform")}</badge>
+  </box>
+  <box class="search">
+    <text class="search-label">{t("search-label")}</text>
+    <box class="search-controls">
+      <field class="query" label={t("search-field")} value={state.query} placeholder={t("placeholder")} max-length="256" on:input={search}/>
+      <button class="clear" label={t("clear")} disabled={state.query == ""} on:activate={clear}>
+        <text class="clear-text">{t("clear")}</text>
+      </button>
+    </box>
+    <text class="hint">{searchHint(state.interactive)}</text>
+  </box>
+  <text class={statusClass(state.error)}>{liveStatus(state.phase, state.count, state.error, state.detail, state.loadingOrders, state.refreshing)}</text>
+  <if test={state.detail}>
+    <scroll class="detail">
+      <box class="item-heading">
+        <box class="item-title">
+          <text class="eyebrow">{t("selected")}</text>
+          <text class="item-name">{state.detail.name}</text>
+        </box>
+        <button class="refresh" label={t("refresh")} tooltip={t("refresh")} disabled={refreshBusy(state.loadingOrders, state.refreshing)} on:activate={refresh}>
+          <icon name="refresh-cw"/>
+        </button>
+        <button class="back" label={t("back")} tooltip={t("back")} on:activate={back}>
+          <icon name="arrow-left"/>
+        </button>
+      </box>
+      <box class="metrics">
+        <box class="metric">
+          <text class="metric-label">{t("min-sell")}</text>
+          <text class="metric-value brand">{unitPrice(state.detail.sells, true)}</text>
+        </box>
+        <box class="metric">
+          <text class="metric-label">{t("max-buy")}</text>
+          <text class="metric-value">{unitPrice(state.detail.buys, false)}</text>
+        </box>
+      </box>
+      <box class="tabs">
+        <button class={tabClass(state.tab, "sell")} label={t("sellers")} on:activate={showTab("sell")}>
+          <text class="tab-text">{t("sellers")}</text>
+          <text class="tab-count">{tabCount(state.detail, "sell")}</text>
+        </button>
+        <button class={tabClass(state.tab, "buy")} label={t("buyers")} on:activate={showTab("buy")}>
+          <text class="tab-text">{t("buyers")}</text>
+          <text class="tab-count">{tabCount(state.detail, "buy")}</text>
+        </button>
+      </box>
+      <offers side={state.tab} orders={tabOrders(state.detail, state.tab)} feedback={state.copy}/>
+      <if test={moreOffers(state.detail, state.tab) != ""}>
+        <text class="more">{moreOffers(state.detail, state.tab)}</text>
+      </if>
+    </scroll>
+  </if>
+  <else-if test={state.results.length > 0}>
+    <list class="results" item-height="32">
+      <for each={state.results} as="item" key={item.slug}>
+        <button class="result" label={item.name} on:activate={select(item.slug)}>
+          <text class="result-name">{item.name}</text>
+          <icon class="result-arrow" name="chevron-right"/>
+        </button>
+      </for>
+    </list>
+  </else-if>
+  <else>
+    <box class="empty">
+      <text class="empty-text">{emptyText(state.query, state.phase)}</text>
+    </box>
+  </else>
+  <if test={state.detail}>
+    <box class="legend">
+      <box class="legend-item">
+        <box class="presence ingame"/>
+        <text class="legend-text">{presenceLabel("ingame")}</text>
+      </box>
+      <box class="legend-item">
+        <box class="presence online"/>
+        <text class="legend-text">{presenceLabel("online")}</text>
+      </box>
+    </box>
+  </if>
+</box>

package/dist/content/examples/weather/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) the authors of Weather
+
+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.

package/dist/content/examples/weather/listing.json

@@ -0,0 +1,10 @@
+{
+  "author": "Example Studio",
+  "spdxLicense": "MIT",
+  "sourceUrl": "https://github.com/example/weather-widget",
+  "defaultLocale": "en",
+  "localizations": [
+    { "locale": "en", "name": "Weather", "description": "The temperature of a city, refreshed every 30 minutes." },
+    { "locale": "fr", "name": "Météo", "description": "La température d’une ville, actualisée toutes les 30 minutes." }
+  ]
+}

package/dist/content/examples/weather/locales/en.json

@@ -0,0 +1,9 @@
+{
+  "paris": "Paris",
+  "tokyo": "Tokyo",
+  "loading": "Loading…",
+  "updated": "Up to date",
+  "unavailable": "Forecast unavailable",
+  "failed": "Something went wrong",
+  "refresh": "Refresh"
+}

package/dist/content/examples/weather/locales/fr.json

@@ -0,0 +1,9 @@
+{
+  "paris": "Paris",
+  "tokyo": "Tokyo",
+  "loading": "Chargement…",
+  "updated": "À jour",
+  "unavailable": "Prévisions indisponibles",
+  "failed": "Une erreur est survenue",
+  "refresh": "Actualiser"
+}

package/dist/content/examples/weather/logic.ts

@@ -0,0 +1,62 @@
+// The temperature of a city from a forecast API. The last answer is kept in
+// the widget's storage, so the widget shows it at once on the next start.
+import { formatNumber, http, initState, onHost, option, ServiceError, storage, timers } from "@overcrow/sdk";
+
+declare module "@overcrow/sdk" {
+  interface WidgetState {
+    city: string;
+    units: string;
+    temperature: number | null;
+    status: string;
+  }
+}
+
+const state = initState({
+  city: option("city", "paris"),
+  units: option("units", "metric"),
+  temperature: null as number | null,
+  status: "loading",
+});
+
+export function temperatureText(value: number | null, units: string): string {
+  if (value === null) {
+    return "–";
+  }
+  const unit = units === "imperial" ? "°F" : "°C";
+  return `${formatNumber(value, { maximumFractionDigits: 1 })} ${unit}`;
+}
+
+async function load(): Promise<void> {
+  const key = `${state.city}:${state.units}`;
+  const cached = await storage.get({ key });
+  state.temperature = typeof cached === "number" ? cached : null;
+  try {
+    const url = `https://api.example.com/v1/forecast/${state.city}?units=${state.units}`;
+    const { status, body } = await http.fetch(url, { as: "json" });
+    const value = (body as { temperature?: unknown } | null)?.temperature;
+    if (status !== 200 || typeof value !== "number") {
+      state.status = "unavailable";
+      return;
+    }
+    state.temperature = value;
+    state.status = "updated";
+    await storage.set({ key, value });
+  } catch (error) {
+    // permission_denied until the user consents, transport_failed offline…
+    state.status = error instanceof ServiceError ? "unavailable" : "failed";
+  }
+}
+
+export function refresh(): void {
+  void load();
+}
+
+onHost((changed) => {
+  if (changed.includes("options")) {
+    state.city = option("city", "paris");
+    state.units = option("units", "metric");
+    void load();
+  }
+});
+timers.every(30 * 60 * 1000, refresh);
+void load();

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

@@ -0,0 +1,51 @@
+{
+  "schemaVersion": 1,
+  "apiVersion": 1,
+  "id": "com.example.weather",
+  "version": "1.0.0",
+  "name": { "en": "Weather", "fr": "Météo" },
+  "sizing": {
+    "fit": "none",
+    "preferred": { "width": 220, "height": 120 },
+    "min": { "width": 160, "height": 96 },
+    "max": { "width": 480, "height": 320 }
+  },
+  "permissions": {
+    "network": [
+      {
+        "origin": "https://api.example.com",
+        "method": "GET",
+        "path": "/v1/forecast/{city}",
+        "pathParams": { "city": { "type": "slug", "maxLength": 32 } },
+        "queryParams": {
+          "units": { "type": "enum", "values": ["metric", "imperial"], "required": true }
+        }
+      }
+    ],
+    "storage": true
+  },
+  "wrapper": {
+    "menu": [
+      {
+        "type": "choice",
+        "id": "city",
+        "label": { "en": "City", "fr": "Ville" },
+        "choices": [
+          { "value": "paris", "label": { "en": "Paris", "fr": "Paris" } },
+          { "value": "tokyo", "label": { "en": "Tokyo", "fr": "Tokyo" } }
+        ],
+        "default": "paris"
+      },
+      {
+        "type": "choice",
+        "id": "units",
+        "label": { "en": "Units", "fr": "Unités" },
+        "choices": [
+          { "value": "metric", "label": { "en": "°C", "fr": "°C" } },
+          { "value": "imperial", "label": { "en": "°F", "fr": "°F" } }
+        ],
+        "default": "metric"
+      }
+    ]
+  }
+}

package/dist/content/examples/weather/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "overcrow-example-weather",
+  "version": "1.0.0",
+  "private": true,
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "check": "overcrow-widget check",
+    "package": "overcrow-widget package"
+  },
+  "devDependencies": {
+    "@overcrow/sdk": "1.0.0",
+    "typescript": "6.0.3"
+  }
+}

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

@@ -0,0 +1,29 @@
+.weather {
+  flex-direction: column;
+  gap: var(--space-1);
+  padding: var(--space-3);
+}
+
+.temperature {
+  font-size: var(--font-size-value);
+  font-variant-numeric: tabular-nums;
+}
+
+.footer {
+  align-items: center;
+  justify-content: space-between;
+}
+
+.status {
+  color: var(--color-text-muted);
+}
+
+.refresh {
+  width: var(--icon-button-size);
+  height: var(--icon-button-size);
+  border-radius: var(--radius-md);
+}
+
+.refresh:hover {
+  background: var(--color-surface-hover);
+}

package/dist/content/examples/weather/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/weather/view.ocml

@@ -0,0 +1,12 @@
+<!-- The forecast of the city chosen in the widget menu, and a button that
+     fetches it again. -->
+<box class="weather">
+  <text class="city">{t(state.city)}</text>
+  <text class="temperature">{temperatureText(state.temperature, state.units)}</text>
+  <box class="footer">
+    <text class="status">{t(state.status)}</text>
+    <button class="refresh" label={t("refresh")} on:activate={refresh}>
+      <icon name="refresh-cw"/>
+    </button>
+  </box>
+</box>