@davidwoods/skylight-mcp 0.0.0-stage → 1.7.0

package/dist/api/endpoints/lists.js

@@ -0,0 +1,125 @@
+import { getClient } from "../client.js";
+/**
+ * Get all lists
+ */
+export async function getLists() {
+    const client = getClient();
+    const response = await client.get("/api/frames/{frameId}/lists");
+    return response.data;
+}
+/**
+ * Get a specific list with its items
+ */
+export async function getListWithItems(listId) {
+    const client = getClient();
+    const response = await client.get(`/api/frames/{frameId}/lists/${listId}`);
+    return {
+        list: response.data,
+        items: response.included ?? [],
+        sections: response.meta?.sections,
+    };
+}
+/**
+ * Find a list by name (case-insensitive)
+ */
+export async function findListByName(name) {
+    const lists = await getLists();
+    const lowerName = name.toLowerCase();
+    return lists.find((list) => list.attributes.label.toLowerCase().includes(lowerName));
+}
+/**
+ * Find a list by type (shopping or to_do)
+ */
+export async function findListByType(kind, preferDefault = true) {
+    const lists = await getLists();
+    const filtered = lists.filter((list) => list.attributes.kind === kind);
+    if (preferDefault && kind === "shopping") {
+        const defaultList = filtered.find((list) => list.attributes.default_grocery_list);
+        if (defaultList)
+            return defaultList;
+    }
+    return filtered[0];
+}
+/**
+ * Create a new list
+ */
+export async function createList(label, kind, color) {
+    const client = getClient();
+    const request = {
+        data: {
+            type: "list",
+            attributes: {
+                label,
+                kind,
+                color: color ?? null,
+            },
+        },
+    };
+    const response = await client.post("/api/frames/{frameId}/lists", request);
+    return response.data;
+}
+/**
+ * Update an existing list
+ */
+export async function updateList(listId, updates) {
+    const client = getClient();
+    const request = {
+        data: {
+            type: "list",
+            attributes: updates,
+        },
+    };
+    const response = await client.request(`/api/frames/{frameId}/lists/${listId}`, {
+        method: "PUT",
+        body: request,
+    });
+    return response.data;
+}
+/**
+ * Delete a list
+ */
+export async function deleteList(listId) {
+    const client = getClient();
+    await client.request(`/api/frames/{frameId}/lists/${listId}`, { method: "DELETE" });
+}
+/**
+ * Create a new list item
+ */
+export async function createListItem(listId, label, section) {
+    const client = getClient();
+    const request = {
+        data: {
+            type: "list_item",
+            attributes: {
+                label,
+                section: section ?? null,
+            },
+        },
+    };
+    const response = await client.post(`/api/frames/{frameId}/lists/${listId}/list_items`, request);
+    return response.data;
+}
+/**
+ * Update a list item
+ */
+export async function updateListItem(listId, itemId, updates) {
+    const client = getClient();
+    const request = {
+        data: {
+            type: "list_item",
+            attributes: updates,
+        },
+    };
+    const response = await client.request(`/api/frames/{frameId}/lists/${listId}/list_items/${itemId}`, { method: "PUT", body: request });
+    return response.data;
+}
+/**
+ * Delete a list item
+ */
+export async function deleteListItem(listId, itemId) {
+    const client = getClient();
+    await client.request(`/api/frames/{frameId}/lists/${listId}/list_items/${itemId}`, {
+        method: "DELETE",
+    });
+}
+//# sourceMappingURL=lists.js.map

package/dist/api/endpoints/lists.js.map

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

package/dist/api/endpoints/meals.d.ts

@@ -0,0 +1,154 @@
+export interface MealCategoryResource {
+    type: "meal_category";
+    id: string;
+    attributes: {
+        /** Skylight calls the display name `label`; older code assumed `name`. */
+        label?: string;
+        name?: string;
+        color?: string;
+        position?: number;
+        [key: string]: unknown;
+    };
+}
+/** Display name of a meal category, whichever field the API used. */
+export declare function mealCategoryName(category: MealCategoryResource): string;
+export interface MealRecipeResource {
+    type: "meal_recipe";
+    id: string;
+    attributes: {
+        summary?: string;
+        description?: string | null;
+        [key: string]: unknown;
+    };
+    relationships?: {
+        meal_category?: {
+            data: {
+                type: string;
+                id: string;
+            } | null;
+        };
+    };
+}
+export interface MealSittingResource {
+    type: "meal_sitting";
+    id: string;
+    attributes: {
+        /** Free-text meal name, e.g. "Thai green curry". May be empty when a recipe is linked. */
+        summary?: string | null;
+        /** Dates (YYYY-MM-DD) this sitting appears on. */
+        instances?: string[];
+        date?: string;
+        meal_time?: string;
+        [key: string]: unknown;
+    };
+    relationships?: {
+        meal_recipe?: {
+            data: {
+                type: string;
+                id: string;
+            } | null;
+        };
+        meal_category?: {
+            data: {
+                type: string;
+                id: string;
+            } | null;
+        };
+    };
+}
+/**
+ * Get meal categories (Breakfast, Lunch, Dinner, etc.)
+ */
+export declare function getMealCategories(): Promise<MealCategoryResource[]>;
+export interface GetRecipesOptions {
+    include?: string;
+}
+/**
+ * Get all recipes
+ */
+export declare function getRecipes(options?: GetRecipesOptions): Promise<MealRecipeResource[]>;
+/**
+ * Get a specific recipe
+ */
+export declare function getRecipe(recipeId: string): Promise<MealRecipeResource>;
+export interface CreateRecipeOptions {
+    summary: string;
+    description?: string;
+    mealCategoryId?: string;
+}
+/**
+ * Create a new recipe
+ */
+export declare function createRecipe(options: CreateRecipeOptions): Promise<MealRecipeResource>;
+export interface UpdateRecipeOptions {
+    summary?: string;
+    description?: string | null;
+    mealCategoryId?: string | null;
+}
+/**
+ * Update a recipe
+ */
+export declare function updateRecipe(recipeId: string, options: UpdateRecipeOptions): Promise<MealRecipeResource>;
+/**
+ * Delete a recipe
+ */
+export declare function deleteRecipe(recipeId: string): Promise<void>;
+/**
+ * Add recipe ingredients to grocery list
+ */
+export declare function addRecipeToGroceryList(recipeId: string): Promise<void>;
+export interface GetMealSittingsOptions {
+    dateMin?: string;
+    dateMax?: string;
+}
+/**
+ * Get meal sittings (scheduled meals)
+ */
+export declare function getMealSittings(options?: GetMealSittingsOptions): Promise<MealSittingResource[]>;
+export interface CreateMealSittingOptions {
+    date: string;
+    mealCategoryId: string;
+    /** Free-text meal name. Either this or recipeId should be given. */
+    summary?: string;
+    recipeId?: string;
+}
+/**
+ * Create a meal sitting (schedule a meal)
+ */
+export declare function createMealSitting(options: CreateMealSittingOptions): Promise<MealSittingResource>;
+/**
+ * Editing and deleting a sitting use the API version the web app sends; the
+ * captures behind them were made with it. Create and list keep the repo default.
+ */
+export declare const MEAL_EDIT_API_VERSION = "2026-10-15";
+/** Sitting ids are numeric. Validate before one ever reaches a URL path. */
+export declare function assertSittingId(id: string): string;
+/** A real calendar date as YYYY-MM-DD, validated before it reaches a URL path. */
+export declare function assertIsoDate(date: string): string;
+/**
+ * Find the sitting that has an occurrence on `date`. Read under the edit API
+ * version so recurring/rrule fields are present for the one-off guard.
+ */
+export declare function findMealSitting(sittingId: string, date: string): Promise<MealSittingResource | null>;
+export interface UpdateMealSittingOptions {
+    existing: MealSittingResource;
+    /** The occurrence being edited (its current date). */
+    date: string;
+    /** Move the meal to this date. */
+    newDate?: string;
+    summary?: string;
+    note?: string;
+    mealCategoryId?: string;
+}
+/**
+ * Edit a one-off sitting the way the web app does: PATCH the whole form to
+ * /meals/sittings/{id}/instances/{currentDate}. Fields not being changed are
+ * sent back as they are, because the API takes the full form.
+ */
+export declare function updateMealSitting(options: UpdateMealSittingOptions): Promise<void>;
+/**
+ * Delete a one-off sitting: DELETE /meals/sittings/{id}/instances/{date}, no
+ * body. Returns whether Skylight confirmed the removal in meta.deleted_sitting_ids.
+ */
+export declare function deleteMealSitting(existing: MealSittingResource, date: string): Promise<boolean>;
+//# sourceMappingURL=meals.d.ts.map

package/dist/api/endpoints/meals.d.ts.map

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

package/dist/api/endpoints/meals.js

@@ -0,0 +1,194 @@
+import { getClient } from "../client.js";
+import { addDays } from "../../utils/schedule.js";
+/** Display name of a meal category, whichever field the API used. */
+export function mealCategoryName(category) {
+    return category.attributes.label ?? category.attributes.name ?? "Unnamed";
+}
+/**
+ * Get meal categories (Breakfast, Lunch, Dinner, etc.)
+ */
+export async function getMealCategories() {
+    const client = getClient();
+    const response = await client.get("/api/frames/{frameId}/meals/categories");
+    return response.data;
+}
+/**
+ * Get all recipes
+ */
+export async function getRecipes(options = {}) {
+    const client = getClient();
+    const response = await client.get("/api/frames/{frameId}/meals/recipes", { include: options.include ?? "meal_category" });
+    return response.data;
+}
+/**
+ * Get a specific recipe
+ */
+export async function getRecipe(recipeId) {
+    const client = getClient();
+    const response = await client.get(`/api/frames/{frameId}/meals/recipes/${recipeId}`, { include: "meal_category" });
+    return response.data;
+}
+/**
+ * Create a new recipe
+ */
+export async function createRecipe(options) {
+    const client = getClient();
+    const body = {
+        summary: options.summary,
+        description: options.description ?? null,
+    };
+    if (options.mealCategoryId) {
+        body.meal_category_id = options.mealCategoryId;
+    }
+    const response = await client.post("/api/frames/{frameId}/meals/recipes", body);
+    return response.data;
+}
+/**
+ * Update a recipe
+ */
+export async function updateRecipe(recipeId, options) {
+    const client = getClient();
+    const body = {};
+    if (options.summary !== undefined)
+        body.summary = options.summary;
+    if (options.description !== undefined)
+        body.description = options.description;
+    if (options.mealCategoryId !== undefined)
+        body.meal_category_id = options.mealCategoryId;
+    const response = await client.request(`/api/frames/{frameId}/meals/recipes/${recipeId}`, { method: "PATCH", body });
+    return response.data;
+}
+/**
+ * Delete a recipe
+ */
+export async function deleteRecipe(recipeId) {
+    const client = getClient();
+    await client.request(`/api/frames/{frameId}/meals/recipes/${recipeId}`, {
+        method: "DELETE",
+    });
+}
+/**
+ * Add recipe ingredients to grocery list
+ */
+export async function addRecipeToGroceryList(recipeId) {
+    const client = getClient();
+    await client.post(`/api/frames/{frameId}/meals/recipes/${recipeId}/add_to_grocery_list`, {});
+}
+/**
+ * Get meal sittings (scheduled meals)
+ */
+export async function getMealSittings(options = {}) {
+    const client = getClient();
+    const params = {};
+    if (options.dateMin)
+        params.date_min = options.dateMin;
+    if (options.dateMax)
+        params.date_max = options.dateMax;
+    const response = await client.get("/api/frames/{frameId}/meals/sittings", params);
+    return response.data;
+}
+/**
+ * Create a meal sitting (schedule a meal)
+ */
+export async function createMealSitting(options) {
+    const client = getClient();
+    const body = {
+        date: options.date,
+        meal_category_id: options.mealCategoryId,
+    };
+    if (options.summary) {
+        body.summary = options.summary;
+    }
+    if (options.recipeId) {
+        body.meal_recipe_id = options.recipeId;
+    }
+    // The API answers a create with a list envelope (one element), unlike GET by id.
+    const response = await client.post("/api/frames/{frameId}/meals/sittings", body);
+    const data = Array.isArray(response.data) ? response.data[0] : response.data;
+    if (!data)
+        throw new Error("Skylight returned an empty response when creating the meal sitting");
+    return data;
+}
+/**
+ * Editing and deleting a sitting use the API version the web app sends; the
+ * captures behind them were made with it. Create and list keep the repo default.
+ */
+export const MEAL_EDIT_API_VERSION = "2026-10-15";
+/** Sitting ids are numeric. Validate before one ever reaches a URL path. */
+export function assertSittingId(id) {
+    if (!/^\d{1,12}$/.test(id))
+        throw new Error("Sitting ID must be numeric (see get_meal_sittings).");
+    return id;
+}
+/** A real calendar date as YYYY-MM-DD, validated before it reaches a URL path. */
+export function assertIsoDate(date) {
+    const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(date);
+    const valid = m && new Date(Date.UTC(+m[1], +m[2] - 1, +m[3])).toISOString().slice(0, 10) === date;
+    if (!valid)
+        throw new Error("Date must be a real calendar date in YYYY-MM-DD form.");
+    return date;
+}
+function instanceQuery(date) {
+    return {
+        date_min: date,
+        date_max: addDays(date, 1),
+        include: "meal_category,meal_recipe,profiles",
+    };
+}
+/**
+ * Find the sitting that has an occurrence on `date`. Read under the edit API
+ * version so recurring/rrule fields are present for the one-off guard.
+ */
+export async function findMealSitting(sittingId, date) {
+    assertSittingId(sittingId);
+    assertIsoDate(date);
+    const response = await getClient().request("/api/frames/{frameId}/meals/sittings", {
+        method: "GET",
+        params: instanceQuery(date),
+        apiVersion: MEAL_EDIT_API_VERSION,
+    });
+    return (response.data ?? []).find((s) => s.id === sittingId && s.attributes.instances?.includes(date)) ?? null;
+}
+/** Only one-off sittings were captured. Repeating ones are edited in the app. */
+function assertOneOff(sitting) {
+    const a = sitting.attributes;
+    if (a.recurring === true || a.rrule) {
+        throw new Error("This meal repeats. Editing or deleting one occurrence of a repeating meal is not supported here; use the Skylight app.");
+    }
+}
+/**
+ * Edit a one-off sitting the way the web app does: PATCH the whole form to
+ * /meals/sittings/{id}/instances/{currentDate}. Fields not being changed are
+ * sent back as they are, because the API takes the full form.
+ */
+export async function updateMealSitting(options) {
+    const { existing } = options;
+    assertOneOff(existing);
+    const date = assertIsoDate(options.date);
+    const target = assertIsoDate(options.newDate ?? date);
+    const a = existing.attributes;
+    const payload = {
+        date: target,
+        note: options.note ?? (typeof a.note === "string" ? a.note : ""),
+        rrule: null,
+        summary: options.summary ?? a.summary ?? "",
+        description: typeof a.description === "string" ? a.description : "",
+        meal_category_id: options.mealCategoryId ?? existing.relationships?.meal_category?.data?.id ?? null,
+        meal_recipe_id: existing.relationships?.meal_recipe?.data?.id ?? null,
+        profile_ids: (existing.relationships?.profiles?.data ?? []).map((p) => p.id),
+        saveToRecipeBox: false,
+    };
+    await getClient().request(`/api/frames/{frameId}/meals/sittings/${assertSittingId(existing.id)}/instances/${date}`, { method: "PATCH", body: payload, params: instanceQuery(date), apiVersion: MEAL_EDIT_API_VERSION });
+}
+/**
+ * Delete a one-off sitting: DELETE /meals/sittings/{id}/instances/{date}, no
+ * body. Returns whether Skylight confirmed the removal in meta.deleted_sitting_ids.
+ */
+export async function deleteMealSitting(existing, date) {
+    assertOneOff(existing);
+    assertIsoDate(date);
+    const id = assertSittingId(existing.id);
+    const response = await getClient().request(`/api/frames/{frameId}/meals/sittings/${id}/instances/${date}`, { method: "DELETE", params: instanceQuery(date), apiVersion: MEAL_EDIT_API_VERSION });
+    return (response?.meta?.deleted_sitting_ids ?? []).map(String).includes(id);
+}
+//# sourceMappingURL=meals.js.map

package/dist/api/endpoints/meals.js.map

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

package/dist/api/endpoints/messages.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Messages need the API version the web app sends. Under the repo-wide older
+ * version the responses omit all_profiles / all_devices / voice_kind, which
+ * made get_messages misreport recipients and the edit guard refuse everything.
+ */
+export declare const NUDGES_API_VERSION = "2026-10-15";
+/**
+ * Skylight calls frame messages "nudges". Shape taken from the web app's
+ * list call: GET /api/frames/{frameId}/nudges?after=<ISO>&before=<ISO>.
+ */
+export interface NudgeResource {
+    type: "nudge";
+    id: string;
+    attributes: {
+        body?: string | null;
+        /** ISO instant the message is (or was) delivered to the frame. */
+        deliver_at?: string;
+        rrule?: string | null;
+        recurring_until?: string | null;
+        voice_kind?: string | null;
+        recurring?: boolean;
+        all_profiles?: boolean;
+        all_devices?: boolean;
+        /** Short-lived presigned storage URL. Never surfaced by this server. */
+        audio_url?: string | null;
+        [key: string]: unknown;
+    };
+    relationships?: {
+        /** Recipient profiles. */
+        categories?: {
+            data: Array<{
+                type: string;
+                id: string;
+            }>;
+        };
+        /** The optional "From" profile. */
+        sender_category?: {
+            data: {
+                type: string;
+                id: string;
+            } | null;
+        };
+        devices?: {
+            data: Array<{
+                type: string;
+                id: string;
+            }>;
+        };
+    };
+}
+/** ISO-8601 with the zone's numeric offset, e.g. 2026-10-01T00:00:00.000-07:00. */
+export declare function isoWithOffset(epochMs: number, timeZone: string): string;
+/** Messages delivered between two local dates, inclusive. */
+export declare function getNudges(startDate: string, endDate: string, timeZone: string): Promise<NudgeResource[]>;
+export interface CreateNudgeOptions {
+    body: string;
+    /** Read aloud on the frame when delivered. Off by default. */
+    readAloud?: boolean;
+    /** Profile (category) id shown as the sender. Omitted when not given. */
+    senderCategoryId?: string;
+    /** Send only to these profile (category) ids. Omitted means everyone. */
+    recipientCategoryIds?: string[];
+    timeZone: string;
+}
+/**
+ * Send a message to every profile and every device, delivered now.
+ * Payload shape is from the web app's "Send Now" call. Targeting specific
+ * profiles is inferred from how Skylight stores a message sent to one profile
+ * (all_profiles false plus that profile in categories) and from another open
+ * source client that sends category_ids; the POST itself has not been captured.
+ * Targeting devices and scheduling are not offered.
+ */
+export declare function createNudge(options: CreateNudgeOptions): Promise<NudgeResource | null>;
+/** Message ids are numeric. Validate before one ever reaches a URL path. */
+export declare function assertNudgeId(id: string): string;
+/** Find one message by id within +/- 31 days of today. */
+export declare function findNudge(id: string, timeZone: string): Promise<NudgeResource | null>;
+export interface UpdateNudgeOptions {
+    existing: NudgeResource;
+    body: string;
+    /** Replace the sender profile id. Keeps the current sender when undefined. */
+    senderCategoryId?: string;
+    timeZone: string;
+}
+/**
+ * Edit a message the way the web app does: PATCH with the whole form.
+ * Only messages sent to everyone on all devices and not repeating are
+ * supported, because those are the only shapes captured.
+ */
+export declare function updateNudge(options: UpdateNudgeOptions): Promise<void>;
+/**
+ * Delete a message: DELETE /nudges/{id}. The Skylight web app offers no delete
+ * button, so this call is taken from two other open-source clients and has not
+ * been confirmed against this account's API version until a live run says so.
+ * Returns the HTTP outcome only; callers must read back to confirm removal.
+ */
+export declare function deleteNudge(existing: NudgeResource): Promise<void>;
+//# sourceMappingURL=messages.d.ts.map

package/dist/api/endpoints/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/api/endpoints/messages.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE;QACV,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,kEAAkE;QAClE,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,wEAAwE;QACxE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,aAAa,CAAC,EAAE;QACd,0BAA0B;QAC1B,UAAU,CAAC,EAAE;YAAE,IAAI,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;QAC3D,mCAAmC;QACnC,eAAe,CAAC,EAAE;YAAE,IAAI,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAA;SAAE,CAAC;QAChE,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;KACzD,CAAC;CACH;AAMD,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQvE;AAED,6DAA6D;AAC7D,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAS9G;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAiB5F;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,0DAA0D;AAC1D,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQ3F;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB5E;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxE"}