threenative-asset-mcp 0.4.0

package/dist/ambientcg/client.js

@@ -0,0 +1,234 @@
+const API_BASE = "https://ambientcg.com/api/v3";
+const TIMEOUT_MS = 20_000;
+export const AMBIENTCG_TYPES = [
+    "material",
+    "hdri",
+    "substance",
+    "decal",
+    "atlas",
+    "3d-model",
+    "plain-image",
+    "brush",
+    "terrain",
+    "hdri-element",
+];
+export class AmbientCgClientError extends Error {
+    code;
+    retryable;
+    constructor(code, message, retryable = false) {
+        super(message);
+        this.code = code;
+        this.retryable = retryable;
+        this.name = "AmbientCgClientError";
+    }
+}
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function text(value, max = 12_000) {
+    return typeof value === "string" && value.length > 0
+        ? value.slice(0, max)
+        : undefined;
+}
+function number(value) {
+    return typeof value === "number" && Number.isFinite(value)
+        ? value
+        : undefined;
+}
+function isType(value) {
+    return (typeof value === "string" &&
+        AMBIENTCG_TYPES.includes(value));
+}
+function normalizeDownload(value) {
+    const item = record(value);
+    const attributes = text(item?.attributes, 100);
+    const extension = text(item?.extension, 20);
+    const url = text(item?.url, 2_048);
+    const sizeBytes = number(item?.size);
+    if (!attributes || !extension || !url || sizeBytes === undefined)
+        return;
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== "https:" || parsed.hostname !== "ambientcg.com") {
+            return;
+        }
+    }
+    catch {
+        return;
+    }
+    return { attributes, extension, url, sizeBytes };
+}
+function normalizeAsset(value) {
+    const item = record(value);
+    const id = text(item?.id, 200);
+    const type = item?.type;
+    const title = text(item?.title, 500);
+    const url = text(item?.url, 2_048);
+    if (!id || !isType(type) || !title || !url) {
+        throw new AmbientCgClientError("AMBIENTCG_UPSTREAM_CHANGED", "ambientCG returned invalid asset metadata.");
+    }
+    const descriptions = [
+        text(item?.longDescription),
+        text(item?.shortDescription),
+    ];
+    const description = descriptions.find((entry) => entry !== undefined);
+    const statistics = record(item?.downloadStatistics);
+    const dimensions = record(item?.dimensions);
+    const thumbnails = record(item?.thumbnails);
+    const thumbnailUrl = text(thumbnails?.["512-WEBP"], 2_048) ??
+        text(thumbnails?.["512-PNG"], 2_048) ??
+        text(thumbnails?.["256-WEBP"], 2_048);
+    const downloads = Array.isArray(item?.downloads)
+        ? item.downloads
+            .map(normalizeDownload)
+            .filter((entry) => entry !== undefined)
+            .slice(0, 500)
+        : [];
+    return {
+        id,
+        type,
+        title,
+        url,
+        tags: Array.isArray(item?.tags)
+            ? item.tags
+                .filter((entry) => typeof entry === "string")
+                .map((entry) => entry.slice(0, 100))
+                .slice(0, 100)
+            : [],
+        maps: Array.isArray(item?.maps)
+            ? item.maps
+                .filter((entry) => typeof entry === "string")
+                .map((entry) => entry.slice(0, 100))
+                .slice(0, 100)
+            : [],
+        downloads,
+        ...(description ? { description } : {}),
+        ...(text(item?.releaseDate, 20)
+            ? { releaseDate: text(item?.releaseDate, 20) }
+            : {}),
+        ...(text(item?.technique, 100)
+            ? { technique: text(item?.technique, 100) }
+            : {}),
+        ...(number(statistics?.total) !== undefined
+            ? { downloadCount: number(statistics?.total) }
+            : {}),
+        ...(thumbnailUrl ? { thumbnailUrl } : {}),
+        ...(dimensions &&
+            number(dimensions.width) !== undefined &&
+            number(dimensions.height) !== undefined &&
+            number(dimensions.depth) !== undefined
+            ? {
+                dimensions: {
+                    width: number(dimensions.width),
+                    height: number(dimensions.height),
+                    depth: number(dimensions.depth),
+                },
+            }
+            : {}),
+    };
+}
+export class AmbientCgClient {
+    fetchImpl;
+    constructor(fetchImpl = fetch) {
+        this.fetchImpl = fetchImpl;
+    }
+    async request(path) {
+        let response;
+        try {
+            response = await this.fetchImpl(`${API_BASE}${path}`, {
+                headers: {
+                    accept: "application/json",
+                    "user-agent": "threenative-asset-mcp/0.4.0",
+                },
+                signal: AbortSignal.timeout(TIMEOUT_MS),
+            });
+        }
+        catch {
+            throw new AmbientCgClientError("AMBIENTCG_UPSTREAM_UNAVAILABLE", "ambientCG could not be reached.", true);
+        }
+        if (response.status === 429) {
+            throw new AmbientCgClientError("AMBIENTCG_RATE_LIMITED", "ambientCG rate-limited the request.", true);
+        }
+        if (!response.ok) {
+            throw new AmbientCgClientError("AMBIENTCG_UPSTREAM_UNAVAILABLE", `ambientCG returned HTTP ${response.status}.`, response.status >= 500);
+        }
+        try {
+            return (await response.json());
+        }
+        catch {
+            throw new AmbientCgClientError("AMBIENTCG_UPSTREAM_CHANGED", "ambientCG returned invalid JSON.");
+        }
+    }
+    async search(input) {
+        const params = new URLSearchParams({
+            sort: input.sort,
+            limit: String(input.limit),
+            offset: String(input.offset),
+            include: [
+                "type",
+                "releaseDate",
+                "shortDescription",
+                "title",
+                "url",
+                "tags",
+                "dimensions",
+                "downloadStatistics",
+                "technique",
+                "maps",
+                "thumbnails",
+                ...(input.includeDownloads ? ["downloads"] : []),
+            ].join(","),
+        });
+        if (input.query)
+            params.set("q", input.query);
+        if (input.type)
+            params.set("type", input.type);
+        const payload = record(await this.request(`/assets?${params}`));
+        const assets = Array.isArray(payload?.assets)
+            ? payload.assets.map(normalizeAsset)
+            : undefined;
+        const total = number(payload?.totalResults);
+        if (!assets || total === undefined) {
+            throw new AmbientCgClientError("AMBIENTCG_UPSTREAM_CHANGED", "ambientCG returned an invalid search result.");
+        }
+        return {
+            assets,
+            total,
+            ...(input.offset + assets.length < total
+                ? { nextOffset: input.offset + assets.length }
+                : {}),
+        };
+    }
+    async getAsset(id) {
+        const params = new URLSearchParams({
+            id,
+            limit: "1",
+            include: "type,releaseDate,shortDescription,longDescription,title,url,tags,dimensions,downloadStatistics,downloads,technique,maps,thumbnails",
+        });
+        const payload = record(await this.request(`/assets?${params}`));
+        const first = Array.isArray(payload?.assets) ? payload.assets[0] : undefined;
+        if (!first) {
+            throw new AmbientCgClientError("AMBIENTCG_NOT_FOUND", "The ambientCG asset was not found.");
+        }
+        return normalizeAsset(first);
+    }
+    async listCategories() {
+        const payload = await this.request("/categories");
+        if (!Array.isArray(payload)) {
+            throw new AmbientCgClientError("AMBIENTCG_UPSTREAM_CHANGED", "ambientCG returned an invalid category list.");
+        }
+        return payload.flatMap((value) => {
+            const item = record(value);
+            const id = text(item?.id, 200);
+            const title = text(item?.title, 200);
+            const type = item?.type;
+            const assetCount = number(item?.numberOfAssets);
+            return id && title && isType(type) && assetCount !== undefined
+                ? [{ id, title, type, assetCount }]
+                : [];
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/ambientcg/client.js.map

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

package/dist/audio/catalog.d.ts

@@ -0,0 +1,36 @@
+export type AudioSourceId = "sonniss" | "kenney" | "tallbeard" | "scott-buckley" | "itch-io" | "mixkit" | "pixabay" | "freesound" | "opengameart" | "abstraction";
+export type AudioKind = "sfx" | "music" | "mixed";
+export type ProgrammaticDownload = "curated-direct" | "provider-page";
+export interface AudioSource {
+    id: AudioSourceId;
+    name: string;
+    bestFor: string;
+    kinds: AudioKind[];
+    browseUrls: string[];
+    licenseSummary: string;
+    commercialUse: string;
+    attribution: string;
+    programmaticDownload: ProgrammaticDownload;
+    caution?: string;
+}
+export interface AudioCatalogAsset {
+    id: string;
+    sourceId: AudioSourceId;
+    name: string;
+    description: string;
+    kind: AudioKind;
+    tags: string[];
+    license: string;
+    commercialUse: boolean;
+    attributionRequired: boolean;
+    attributionText?: string;
+    sourcePageUrl: string;
+    downloadUrl: string;
+    fileName: string;
+    sizeBytes?: number;
+    directDownload: true;
+    redistributionAllowed: false;
+}
+export declare const AUDIO_SOURCES: readonly AudioSource[];
+export declare const AUDIO_ASSETS: readonly AudioCatalogAsset[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/audio/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/audio/catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,QAAQ,GACR,WAAW,GACX,eAAe,GACf,SAAS,GACT,QAAQ,GACR,SAAS,GACT,WAAW,GACX,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;AAClD,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,aAAa,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,IAAI,CAAC;IACrB,qBAAqB,EAAE,KAAK,CAAC;CAC9B;AAED,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAkHtC,CAAC;AAmBX,eAAO,MAAM,YAAY,EAAE,SAAS,iBAAiB,EAoC3C,CAAC"}

package/dist/audio/catalog.js

@@ -0,0 +1,169 @@
+export const AUDIO_SOURCES = [
+    {
+        id: "sonniss",
+        name: "Sonniss GDC Game Audio Bundles",
+        bestFor: "Professional weapons, impacts, explosions, ambience, vehicles, Foley, and cinematic effects",
+        kinds: ["sfx"],
+        browseUrls: ["https://gdc.sonniss.com/", "https://gdc.sonniss.com/gdc-game-audio-bundle/"],
+        licenseSummary: "Sonniss GDC bundle license; commercial projects allowed, no attribution required",
+        commercialUse: "Allowed in projects; review the current bundle license before use",
+        attribution: "Not required",
+        programmaticDownload: "curated-direct",
+        caution: "Raw files and bundles must not be redistributed as a competing asset library.",
+    },
+    {
+        id: "kenney",
+        name: "Kenney Audio",
+        bestFor: "UI, pickups, impacts, arcade/gameplay sounds, and jingles",
+        kinds: ["sfx", "music"],
+        browseUrls: ["https://kenney.nl/assets/category:Audio"],
+        licenseSummary: "CC0 (verify the individual pack page)",
+        commercialUse: "Allowed for CC0 packs",
+        attribution: "Not required for CC0 packs",
+        programmaticDownload: "curated-direct",
+    },
+    {
+        id: "tallbeard",
+        name: "Tallbeard Studios",
+        bestFor: "Large collections of seamless gameplay music loops",
+        kinds: ["music"],
+        browseUrls: ["https://tallbeard.itch.io/music-loop-bundle"],
+        licenseSummary: "CC0 on the Music Loop Bundle page; verify the selected download",
+        commercialUse: "Allowed for the CC0 bundle",
+        attribution: "Not required for CC0 material",
+        programmaticDownload: "provider-page",
+    },
+    {
+        id: "scott-buckley",
+        name: "Scott Buckley Music Library",
+        bestFor: "Cinematic, orchestral, atmospheric, and emotional music",
+        kinds: ["music"],
+        browseUrls: ["https://www.scottbuckley.com.au/library/"],
+        licenseSummary: "CC BY 4.0 for library tracks unless an individual track says otherwise",
+        commercialUse: "Allowed with license compliance",
+        attribution: "Required; retain track-specific credit details",
+        programmaticDownload: "provider-page",
+    },
+    {
+        id: "itch-io",
+        name: "itch.io Free Audio Assets",
+        bestFor: "Genre-specific FPS, RPG, horror, retro, UI, voice, and music packs",
+        kinds: ["sfx", "music", "mixed"],
+        browseUrls: ["https://itch.io/game-assets/free/tag-music", "https://itch.io/game-assets/free/tag-sound-effects"],
+        licenseSummary: "Per pack; no site-wide license",
+        commercialUse: "Varies per pack",
+        attribution: "Varies per pack",
+        programmaticDownload: "provider-page",
+        caution: "Read and retain the individual pack license before downloading or using it.",
+    },
+    {
+        id: "mixkit",
+        name: "Mixkit",
+        bestFor: "Quick individual sound effects and background tracks",
+        kinds: ["sfx", "music"],
+        browseUrls: ["https://mixkit.co/free-sound-effects/", "https://mixkit.co/free-stock-music/"],
+        licenseSummary: "Mixkit item license; verify the selected item and media type",
+        commercialUse: "Generally allowed under the applicable Mixkit license",
+        attribution: "Generally not required for SFX; verify the item",
+        programmaticDownload: "provider-page",
+    },
+    {
+        id: "pixabay",
+        name: "Pixabay Audio",
+        bestFor: "Fast searchable music and sound effects",
+        kinds: ["sfx", "music"],
+        browseUrls: ["https://pixabay.com/sound-effects/", "https://pixabay.com/music/"],
+        licenseSummary: "Pixabay Content License; verify the selected item",
+        commercialUse: "Allowed as part of a larger creative work, subject to the Content License",
+        attribution: "Generally not required",
+        programmaticDownload: "provider-page",
+        caution: "Some music is Content ID registered; retain download evidence and inspect track warnings.",
+    },
+    {
+        id: "freesound",
+        name: "Freesound",
+        bestFor: "Specific recordings and niche sounds missing from broad libraries",
+        kinds: ["sfx", "music"],
+        browseUrls: ["https://freesound.org/search/"],
+        licenseSummary: "Per asset; prefer CC0 or CC BY and avoid CC BY-NC for commercial use",
+        commercialUse: "Depends on the selected Creative Commons license",
+        attribution: "Required for CC BY; not required for CC0",
+        programmaticDownload: "provider-page",
+    },
+    {
+        id: "opengameart",
+        name: "OpenGameArt",
+        bestFor: "Game-ready loops, chiptunes, RPG music, and unusual effects",
+        kinds: ["sfx", "music", "mixed"],
+        browseUrls: ["https://opengameart.org/art-search?keys=music", "https://opengameart.org/art-search?keys=sound+effects"],
+        licenseSummary: "Per asset; prefer CC0 for the simplest reuse",
+        commercialUse: "Depends on the selected asset license",
+        attribution: "Depends on the selected asset license",
+        programmaticDownload: "provider-page",
+    },
+    {
+        id: "abstraction",
+        name: "Abstraction Music",
+        bestFor: "Loopable game music and free game-jam tracks",
+        kinds: ["music"],
+        browseUrls: ["https://abstractionmusic.com/"],
+        licenseSummary: "Per release; verify the selected track or collection",
+        commercialUse: "Depends on the selected release",
+        attribution: "Depends on the selected release",
+        programmaticDownload: "provider-page",
+    },
+];
+const sonniss2026 = (part) => ({
+    id: `sonniss-gdc-2026-${part}-of-5`,
+    sourceId: "sonniss",
+    name: `Sonniss GDC 2026 Game Audio Bundle ${part} of 5`,
+    description: "One official archive from the five-part professional GDC 2026 sound-effects bundle.",
+    kind: "sfx",
+    tags: ["professional", "foley", "ambience", "weapons", "impacts", "cinematic", "gdc-2026"],
+    license: "Sonniss GDC Game Audio Bundle License",
+    commercialUse: true,
+    attributionRequired: false,
+    sourcePageUrl: "https://gdc.sonniss.com/",
+    downloadUrl: `https://downloads.sonniss.com/Sonniss.com-GDC2026-GameAudioBundle${part}of5.zip`,
+    fileName: `Sonniss.com-GDC2026-GameAudioBundle${part}of5.zip`,
+    directDownload: true,
+    redistributionAllowed: false,
+});
+export const AUDIO_ASSETS = [
+    {
+        id: "kenney-interface-sounds",
+        sourceId: "kenney",
+        name: "Kenney Interface Sounds",
+        description: "100 game interface sounds in a directly downloadable CC0 ZIP archive.",
+        kind: "sfx",
+        tags: ["ui", "interface", "click", "menu", "gameplay", "cc0"],
+        license: "CC0",
+        commercialUse: true,
+        attributionRequired: false,
+        sourcePageUrl: "https://kenney.nl/assets/interface-sounds",
+        downloadUrl: "https://kenney.nl/media/pages/assets/interface-sounds/fa43c1dd4d-1677589452/kenney_interface-sounds.zip",
+        fileName: "kenney_interface-sounds.zip",
+        sizeBytes: 834_536,
+        directDownload: true,
+        redistributionAllowed: false,
+    },
+    {
+        id: "kenney-music-jingles",
+        sourceId: "kenney",
+        name: "Kenney Music Jingles",
+        description: "85 short game music jingles in a directly downloadable CC0 ZIP archive.",
+        kind: "music",
+        tags: ["jingle", "ui", "success", "failure", "gameplay", "cc0"],
+        license: "CC0",
+        commercialUse: true,
+        attributionRequired: false,
+        sourcePageUrl: "https://kenney.nl/assets/music-jingles",
+        downloadUrl: "https://kenney.nl/media/pages/assets/music-jingles/f37e530b9e-1677590399/kenney_music-jingles.zip",
+        fileName: "kenney_music-jingles.zip",
+        sizeBytes: 1_239_525,
+        directDownload: true,
+        redistributionAllowed: false,
+    },
+    ...[1, 2, 3, 4, 5].map(sonniss2026),
+];
+//# sourceMappingURL=catalog.js.map

package/dist/audio/catalog.js.map

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

package/dist/audio/client.d.ts

@@ -0,0 +1,46 @@
+import { type AudioCatalogAsset, type AudioKind, type AudioSource, type AudioSourceId } from "./catalog.js";
+export type AudioErrorCode = "AUDIO_ASSET_NOT_FOUND" | "AUDIO_DOWNLOAD_FAILED" | "AUDIO_DOWNLOAD_TOO_LARGE" | "AUDIO_UPSTREAM_DENIED" | "AUDIO_UNSAFE_REDIRECT";
+export declare class AudioCatalogError extends Error {
+    readonly code: AudioErrorCode;
+    readonly retryable: boolean;
+    constructor(code: AudioErrorCode, message: string, retryable?: boolean);
+}
+export interface AudioDownloadResult {
+    assetId: string;
+    sourceId: AudioSourceId;
+    fileName: string;
+    path: string;
+    sizeBytes: number;
+    sha256: string;
+    alreadyExisted: boolean;
+    license: string;
+    attributionRequired: boolean;
+    attributionText?: string;
+    sourcePageUrl: string;
+}
+export interface AudioCatalogClientOptions {
+    fetch?: typeof globalThis.fetch;
+    downloadDir?: string;
+    maxDownloadBytes?: number;
+    downloadTimeoutMs?: number;
+}
+export declare class AudioCatalogClient {
+    private readonly fetch;
+    private readonly downloadDir;
+    private readonly maxDownloadBytes;
+    private readonly downloadTimeoutMs;
+    private readonly allowedDownloadHosts;
+    constructor(options?: AudioCatalogClientOptions);
+    listSources(): AudioSource[];
+    searchAssets(input: {
+        query?: string;
+        kind?: AudioKind | "all";
+        source?: AudioSourceId | "all";
+    }): AudioCatalogAsset[];
+    getAsset(assetId: string): AudioCatalogAsset;
+    downloadAsset(assetId: string): Promise<AudioDownloadResult>;
+    private ensureDirectory;
+    private fetchDownload;
+    private result;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/audio/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/audio/client.ts"],"names":[],"mappings":"AAeA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,cAAc,GACtB,uBAAuB,GACvB,uBAAuB,GACvB,0BAA0B,GAC1B,uBAAuB,GACvB,uBAAuB,CAAC;AAE5B,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,IAAI,EAAE,cAAc;aAEpB,SAAS;IAH3B,YACkB,IAAI,EAAE,cAAc,EACpC,OAAO,EAAE,MAAM,EACC,SAAS,UAAQ,EAIlC;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AA4CD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAEnC;IAEF,YAAY,OAAO,GAAE,yBAA8B,EAqBlD;IAED,WAAW,IAAI,WAAW,EAAE,CAE3B;IAED,YAAY,CAAC,KAAK,EAAE;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;QACzB,MAAM,CAAC,EAAE,aAAa,GAAG,KAAK,CAAC;KAChC,GAAG,iBAAiB,EAAE,CAYtB;IAED,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAS3C;IAEK,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4EjE;YAEa,eAAe;YAKf,aAAa;IA0C3B,OAAO,CAAC,MAAM;CAqBf"}