@wyndlass/app-sdk 0.0.0-stage → 1.0.0

package/dist/contract/data-calendar.d.ts

@@ -0,0 +1,57 @@
+/**
+ * An instant in UTC (2026-10-14T14:00:00Z); a date (2026-10-14) for a whole-day event; a local time (2026-10-14T09:00:00) for a floating one.
+ */
+export type Time = string;
+/**
+ * The data service's calendar from an iCalendar, jCal or xCal feed (ADR 0069, WP-0111): the occurrences in the window asked for, repeats and time zones worked out, in time order. Attendees, organizers, alarms and attachments are never carried; a private event has no title, place or description.
+ */
+export interface Calendar {
+    calendar: {
+        /**
+         * X-WR-CALNAME, or NAME (RFC 7986).
+         */
+        name?: string;
+        /**
+         * X-WR-TIMEZONE, as the calendar gives it.
+         */
+        timeZone?: string;
+    };
+    /**
+     * @maxItems 1000
+     */
+    events: {
+        /**
+         * The event's UID; for a repeat or a changed occurrence, the UID and the occurrence's start (20261014T140000Z).
+         */
+        id: string;
+        title?: string;
+        location?: string;
+        /**
+         * Plain text: markup stripped.
+         */
+        description?: string;
+        start: Time;
+        end: Time;
+        /**
+         * A whole-day event: start and end are dates, the end exclusive.
+         */
+        allDay?: true;
+        /**
+         * A floating event: start and end are local times with no zone, read in the screen's time zone.
+         */
+        floating?: true;
+        tentative?: true;
+        /**
+         * TRANSP:TRANSPARENT: the event does not make its calendar busy.
+         */
+        free?: true;
+        /**
+         * CLASS:PRIVATE or CONFIDENTIAL: its title, place and description are left out.
+         */
+        private?: true;
+    }[];
+    /**
+     * The window held more than 1,000 occurrences: the ones nearest the time asked are kept.
+     */
+    truncated?: true;
+}

package/dist/contract/data-calendar.js

@@ -0,0 +1,3 @@
+// Copied from protocol/generated/ts/data-calendar.d.ts by app-sdk/scripts/copy-protocol.mjs: edit the source, then run `pnpm --filter @wyndlass/app-sdk copy-protocol`.
+/* Generated from protocol/schemas by scripts/generate.mjs. Do not edit. */
+export {};

package/dist/contract/data-news.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The data service's news from an RSS 2.0 or Atom 1.0 feed (ADR 0069), each item's image its own or its page's Open Graph image.
+ */
+export interface News {
+    feed: {
+        title: string;
+        url: string;
+        link?: string;
+        image?: string;
+    };
+    /**
+     * @maxItems 50
+     */
+    items: {
+        id?: string;
+        title: string;
+        /**
+         * Plain text: markup stripped.
+         */
+        summary?: string;
+        link: string;
+        published?: string;
+        author?: string;
+        /**
+         * The item's image through the data service's image proxy (a path from the service's root), so screens load only from Wyndlass.
+         */
+        image?: string;
+    }[];
+}

package/dist/contract/data-news.js

@@ -0,0 +1,3 @@
+// Copied from protocol/generated/ts/data-news.d.ts by app-sdk/scripts/copy-protocol.mjs: edit the source, then run `pnpm --filter @wyndlass/app-sdk copy-protocol`.
+/* Generated from protocol/schemas by scripts/generate.mjs. Do not edit. */
+export {};

package/dist/contract/data-quotes.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Why a symbol has no answer: the provider does not know it, the plan does not cover it, or there is no answer and no earlier one.
+ */
+export type Reason = "unknown-symbol" | "not-in-plan" | "unavailable";
+/**
+ * The data service's quotes from Twelve Data (ADR 0069, decision 9; WP-0103): each symbol asked for, in the order asked, or why it is missing. A value the provider does not give is left out.
+ */
+export interface Quotes {
+    /**
+     * @maxItems 30
+     */
+    quotes: {
+        /**
+         * The symbol as asked, upper-cased: AAPL, EUR/USD, or with its exchange after a colon (TRP:TSX).
+         */
+        symbol: string;
+        name?: string;
+        exchange?: string;
+        /**
+         * The exchange's market identifier code (ISO 10383).
+         */
+        mic?: string;
+        /**
+         * The price's currency, where the provider gives one (not for currency pairs or crypto).
+         */
+        currency?: string;
+        /**
+         * The latest price.
+         */
+        price: number;
+        /**
+         * The price less the previous close.
+         */
+        change?: number;
+        /**
+         * The change as a percentage of the previous close.
+         */
+        percentChange?: number;
+        open?: number;
+        high?: number;
+        low?: number;
+        previousClose?: number;
+        /**
+         * Shares traded today, where there are shares.
+         */
+        volume?: number;
+        averageVolume?: number;
+        fiftyTwoWeek?: {
+            low: number;
+            high: number;
+        };
+        /**
+         * Whether its market is open now.
+         */
+        marketOpen: boolean;
+        /**
+         * When the price was quoted.
+         */
+        time: string;
+        /**
+         * True when the provider failed and this is the symbol's last quote, kept for up to a day.
+         */
+        stale: boolean;
+    }[];
+    /**
+     * @maxItems 30
+     */
+    missing: {
+        /**
+         * The symbol as asked, upper-cased: AAPL, EUR/USD, or with its exchange after a colon (TRP:TSX).
+         */
+        symbol: string;
+        reason: Reason;
+    }[];
+}

package/dist/contract/data-quotes.js

@@ -0,0 +1,3 @@
+// Copied from protocol/generated/ts/data-quotes.d.ts by app-sdk/scripts/copy-protocol.mjs: edit the source, then run `pnpm --filter @wyndlass/app-sdk copy-protocol`.
+/* Generated from protocol/schemas by scripts/generate.mjs. Do not edit. */
+export {};

package/dist/contract/data-series.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The data service's prices for one symbol over a range, from Twelve Data (ADR 0069, decision 9; WP-0103), for charts: the bars oldest first, or why the symbol is missing. A value the provider does not give is left out.
+ */
+export interface Series {
+    /**
+     * The symbol as asked, upper-cased: AAPL, EUR/USD, or with its exchange after a colon (TRP:TSX).
+     */
+    symbol: string;
+    /**
+     * 1d: the latest trading day in 5-minute bars (the last 24 hours where a market never closes); 5d: 30-minute bars; 1m, 6m and 1y: days; 5y: weeks.
+     */
+    range: "1d" | "5d" | "1m" | "6m" | "1y" | "5y";
+    interval?: "5min" | "30min" | "1day" | "1week";
+    exchange?: string;
+    mic?: string;
+    currency?: string;
+    /**
+     * The provider's kind of instrument: Common Stock, ETF, Physical Currency, Digital Currency.
+     */
+    type?: string;
+    /**
+     * The exchange's time zone (IANA), which a trading day is counted in.
+     */
+    timeZone?: string;
+    /**
+     * For 1d and 5d: whether the market is open now, as its last bar is recent.
+     */
+    marketOpen?: boolean;
+    /**
+     * For 1d: the close before the day's first bar, which the day's change is measured from.
+     */
+    previousClose?: number;
+    /**
+     * @maxItems 400
+     */
+    points?: {
+        /**
+         * The bar's start.
+         */
+        time: string;
+        open: number;
+        high: number;
+        low: number;
+        close: number;
+        volume?: number;
+    }[];
+    /**
+     * Why a symbol has no answer: the provider does not know it, the plan does not cover it, or there is no answer and no earlier one.
+     */
+    missing?: "unknown-symbol" | "not-in-plan" | "unavailable";
+}

package/dist/contract/data-series.js

@@ -0,0 +1,3 @@
+// Copied from protocol/generated/ts/data-series.d.ts by app-sdk/scripts/copy-protocol.mjs: edit the source, then run `pnpm --filter @wyndlass/app-sdk copy-protocol`.
+/* Generated from protocol/schemas by scripts/generate.mjs. Do not edit. */
+export {};

package/dist/contract/data-snapshot.d.ts

@@ -0,0 +1,30 @@
+/**
+ * A column's key: set when the column is added and never changed, so a binding to it survives a relabel.
+ */
+export type Key = string;
+/**
+ * One version of a data table as screens read it (WP-0072, ADR 0072; ADR 0053 decision 7): a content-addressed JSON blob the manifest's dataSnapshots name. Bindings address a cell by its row's position in rows and its column's key. Values are typed: numbers as numbers, booleans as booleans, dates and date-times as ISO text; an empty cell is left out.
+ */
+export interface DataTableSnapshot {
+    /**
+     * The table's id, as the manifest's dataSnapshots names it.
+     */
+    table: string;
+    version: number;
+    /**
+     * @minItems 1
+     * @maxItems 50
+     */
+    columns: [Column, ...Column[]];
+    /**
+     * @maxItems 5000
+     */
+    rows: {
+        [k: string]: (string | number | boolean) | undefined;
+    }[];
+}
+export interface Column {
+    key: Key;
+    label: string;
+    type: "text" | "number" | "currency" | "date" | "datetime" | "url" | "boolean";
+}

package/dist/contract/data-snapshot.js

@@ -0,0 +1,3 @@
+// Copied from protocol/generated/ts/data-snapshot.d.ts by app-sdk/scripts/copy-protocol.mjs: edit the source, then run `pnpm --filter @wyndlass/app-sdk copy-protocol`.
+/* Generated from protocol/schemas by scripts/generate.mjs. Do not edit. */
+export {};

package/dist/contract/data-weather.d.ts

@@ -0,0 +1,421 @@
+/**
+ * A WMO weather code in Wyndlass's words; the weather condition leaf compares against these.
+ */
+export type Condition = "clear" | "mostly-clear" | "partly-cloudy" | "cloudy" | "fog" | "drizzle" | "freezing-drizzle" | "rain" | "freezing-rain" | "snow" | "snow-grains" | "showers" | "snow-showers" | "thunderstorm" | "hail-thunderstorm" | "unknown";
+/**
+ * The data service's weather for a place (ADR 0069): now and the days ahead, in the units asked, and the facts the weather condition leaf reads, always metric. A value the provider does not give is left out.
+ */
+export interface Weather {
+    place: {
+        lat: number;
+        lon: number;
+    };
+    /**
+     * metric: °C and km/h; imperial: °F and mph.
+     */
+    units: "metric" | "imperial";
+    /**
+     * The place's IANA time zone.
+     */
+    timeZone: string;
+    current: {
+        at: string;
+        temperature: number;
+        apparentTemperature?: number;
+        condition: Condition;
+        code: number;
+        isDay: boolean;
+        humidity?: number;
+        windSpeed?: number;
+        windDirection?: number;
+        precipitationProbability?: number;
+    };
+    /**
+     * @maxItems 7
+     */
+    daily: [] | [
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        }
+    ] | [
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        }
+    ] | [
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        }
+    ] | [
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        }
+    ] | [
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        }
+    ] | [
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        }
+    ] | [
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        },
+        {
+            date: string;
+            high: number;
+            low: number;
+            condition: Condition;
+            /**
+             * The WMO weather code.
+             */
+            code: number;
+            precipitationProbability?: number;
+            sunrise?: string;
+            sunset?: string;
+        }
+    ];
+    /**
+     * What the weather condition leaf (condition.schema.json) reads.
+     */
+    facts: {
+        temperatureC: number;
+        condition: Condition;
+        precipitationProbability?: number;
+        windKph: number;
+        /**
+         * False until a source of alerts is added.
+         */
+        alertActive: boolean;
+    };
+}

package/dist/contract/data-weather.js

@@ -0,0 +1,3 @@
+// Copied from protocol/generated/ts/data-weather.d.ts by app-sdk/scripts/copy-protocol.mjs: edit the source, then run `pnpm --filter @wyndlass/app-sdk copy-protocol`.
+/* Generated from protocol/schemas by scripts/generate.mjs. Do not edit. */
+export {};