@littlebearapps/australian-history-mcp 0.6.0

package/dist/sources/ala/tools/search-occurrences.js

@@ -0,0 +1,134 @@
+/**
+ * ALA Search Occurrences Tool - Search species occurrence records
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { alaClient } from '../client.js';
+export const alaSearchOccurrencesTool = {
+    schema: {
+        name: 'ala_search_occurrences',
+        description: 'Search Atlas of Living Australia for species occurrence records. Returns sightings, specimens, and observations across Australia.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query (taxon name, location, or keyword)',
+                },
+                scientificName: {
+                    type: 'string',
+                    description: 'Filter by scientific name',
+                },
+                vernacularName: {
+                    type: 'string',
+                    description: 'Filter by common name',
+                },
+                kingdom: {
+                    type: 'string',
+                    enum: ['Animalia', 'Plantae', 'Fungi', 'Chromista', 'Protozoa', 'Bacteria', 'Archaea', 'Viruses'],
+                    description: 'Filter by kingdom',
+                },
+                family: {
+                    type: 'string',
+                    description: 'Filter by taxonomic family',
+                },
+                genus: {
+                    type: 'string',
+                    description: 'Filter by genus',
+                },
+                stateProvince: {
+                    type: 'string',
+                    enum: ['New South Wales', 'Victoria', 'Queensland', 'Western Australia', 'South Australia', 'Tasmania', 'Northern Territory', 'Australian Capital Territory'],
+                    description: 'Filter by state/territory',
+                },
+                startYear: {
+                    type: 'number',
+                    description: 'Filter by start year (e.g., 2020)',
+                },
+                endYear: {
+                    type: 'number',
+                    description: 'Filter by end year (e.g., 2024)',
+                },
+                hasImages: {
+                    type: 'boolean',
+                    description: 'Only return records with images',
+                },
+                spatiallyValid: {
+                    type: 'boolean',
+                    description: 'Only return records with valid coordinates',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum results to return (1-100)',
+                    default: 20,
+                },
+            },
+            required: [],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        // Validate at least one search criterion
+        const hasFilter = input.query || input.scientificName || input.vernacularName ||
+            input.kingdom || input.family || input.genus || input.stateProvince;
+        if (!hasFilter) {
+            return errorResponse('At least one search parameter is required (query, scientificName, vernacularName, kingdom, family, genus, or stateProvince)');
+        }
+        try {
+            const params = {
+                q: input.query,
+                scientificName: input.scientificName,
+                vernacularName: input.vernacularName,
+                kingdom: input.kingdom,
+                family: input.family,
+                genus: input.genus,
+                stateProvince: input.stateProvince,
+                startYear: input.startYear,
+                endYear: input.endYear,
+                hasImages: input.hasImages,
+                spatiallyValid: input.spatiallyValid,
+                pageSize: Math.min(input.limit ?? 20, 100),
+            };
+            const result = await alaClient.searchOccurrences(params);
+            return successResponse({
+                source: 'ala',
+                totalRecords: result.totalRecords,
+                returned: result.occurrences.length,
+                startIndex: result.startIndex,
+                pageSize: result.pageSize,
+                records: result.occurrences.map((occ) => formatOccurrenceSummary(occ)),
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+/**
+ * Format an occurrence for search results (summary view)
+ */
+function formatOccurrenceSummary(occ) {
+    return {
+        uuid: occ.uuid,
+        scientificName: occ.scientificName,
+        vernacularName: occ.vernacularName,
+        kingdom: occ.kingdom,
+        family: occ.family,
+        genus: occ.genus,
+        location: {
+            state: occ.stateProvince,
+            country: occ.country,
+            latitude: occ.decimalLatitude,
+            longitude: occ.decimalLongitude,
+        },
+        date: occ.year ? {
+            year: occ.year,
+            month: occ.month,
+        } : undefined,
+        basisOfRecord: occ.basisOfRecord,
+        dataSource: occ.dataResourceName,
+        hasImage: !!occ.imageUrl,
+        thumbnailUrl: occ.thumbnailUrl,
+        license: occ.license,
+    };
+}
+//# sourceMappingURL=search-occurrences.js.map

package/dist/sources/ala/tools/search-occurrences.js.map

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

package/dist/sources/ala/tools/search-species.d.ts

@@ -0,0 +1,6 @@
+/**
+ * ALA Search Species Tool - Search for species by name
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const alaSearchSpeciesTool: SourceTool;
+//# sourceMappingURL=search-species.d.ts.map

package/dist/sources/ala/tools/search-species.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-species.d.ts","sourceRoot":"","sources":["../../../../src/sources/ala/tools/search-species.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAK/D,eAAO,MAAM,oBAAoB,EAAE,UAoElC,CAAC"}

package/dist/sources/ala/tools/search-species.js

@@ -0,0 +1,68 @@
+/**
+ * ALA Search Species Tool - Search for species by name
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { alaClient } from '../client.js';
+export const alaSearchSpeciesTool = {
+    schema: {
+        name: 'ala_search_species',
+        description: 'Search Atlas of Living Australia for species by scientific or common name. Returns species taxonomy and occurrence counts.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Species name to search for (scientific or common name)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum results to return (1-100)',
+                    default: 20,
+                },
+            },
+            required: ['query'],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        if (!input.query) {
+            return errorResponse('query is required');
+        }
+        try {
+            const params = {
+                q: input.query,
+                max: Math.min(input.limit ?? 20, 100),
+            };
+            const result = await alaClient.searchSpecies(params);
+            return successResponse({
+                source: 'ala',
+                totalRecords: result.searchResults.totalRecords,
+                returned: result.searchResults.results.length,
+                startIndex: result.searchResults.startIndex,
+                species: result.searchResults.results.map((s) => ({
+                    guid: s.guid,
+                    scientificName: s.scientificName,
+                    commonName: s.commonName,
+                    author: s.author,
+                    rank: s.rank,
+                    taxonomicStatus: s.taxonomicStatus,
+                    taxonomy: {
+                        kingdom: s.kingdom,
+                        phylum: s.phylum,
+                        class: s.classs,
+                        order: s.order,
+                        family: s.family,
+                        genus: s.genus,
+                    },
+                    occurrenceCount: s.occurrenceCount,
+                    hasImage: !!s.imageUrl,
+                    thumbnailUrl: s.thumbnailUrl,
+                })),
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+//# sourceMappingURL=search-species.js.map

package/dist/sources/ala/tools/search-species.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-species.js","sourceRoot":"","sources":["../../../../src/sources/ala/tools/search-species.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,MAAM,CAAC,MAAM,oBAAoB,GAAe;IAC9C,MAAM,EAAE;QACN,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,4HAA4H;QACzI,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wDAAwD;iBACtE;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAmC;oBAChD,OAAO,EAAE,EAAE;iBACZ;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,KAAK,GAAG,IAGb,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,aAAa,CAAC,mBAAmB,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B;gBACrC,CAAC,EAAE,KAAK,CAAC,KAAK;gBACd,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC;aACtC,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAErD,OAAO,eAAe,CAAC;gBACrB,MAAM,EAAE,KAAK;gBACb,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC,YAAY;gBAC/C,QAAQ,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM;gBAC7C,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,UAAU;gBAC3C,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAChD,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,cAAc,EAAE,CAAC,CAAC,cAAc;oBAChC,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,eAAe,EAAE,CAAC,CAAC,eAAe;oBAClC,QAAQ,EAAE;wBACR,OAAO,EAAE,CAAC,CAAC,OAAO;wBAClB,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,KAAK,EAAE,CAAC,CAAC,MAAM;wBACf,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;qBACf;oBACD,eAAe,EAAE,CAAC,CAAC,eAAe;oBAClC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ;oBACtB,YAAY,EAAE,CAAC,CAAC,YAAY;iBAC7B,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/sources/ala/types.d.ts

@@ -0,0 +1,255 @@
+/**
+ * Atlas of Living Australia (ALA) API Type Definitions
+ *
+ * ALA provides access to 165M+ species occurrence records across Australia.
+ */
+export interface ALAOccurrenceSearchParams {
+    /** Search query (taxon name, location, etc.) */
+    q?: string;
+    /** Filter by scientific name */
+    scientificName?: string;
+    /** Filter by common name */
+    vernacularName?: string;
+    /** Filter by kingdom (Animalia, Plantae, etc.) */
+    kingdom?: string;
+    /** Filter by family */
+    family?: string;
+    /** Filter by genus */
+    genus?: string;
+    /** Filter by species */
+    species?: string;
+    /** Filter by state/territory */
+    stateProvince?: string;
+    /** Filter by data resource */
+    dataResourceUid?: string;
+    /** Start year */
+    startYear?: number;
+    /** End year */
+    endYear?: number;
+    /** Only records with images */
+    hasImages?: boolean;
+    /** Only spatially valid records */
+    spatiallyValid?: boolean;
+    /** Page size (max 100) */
+    pageSize?: number;
+    /** Start index for pagination */
+    startIndex?: number;
+    /** Sort field */
+    sort?: 'score' | 'taxon_name' | 'event_date';
+    /** Sort direction */
+    dir?: 'asc' | 'desc';
+}
+export interface ALASpeciesSearchParams {
+    /** Search query */
+    q: string;
+    /** Filter by ID list */
+    idxtype?: 'TAXON' | 'COMMON' | 'IDENTIFIER';
+    /** Maximum results */
+    max?: number;
+    /** Start offset */
+    start?: number;
+}
+export interface ALAOccurrence {
+    uuid: string;
+    occurrenceID?: string;
+    scientificName: string;
+    vernacularName?: string;
+    taxonRank?: string;
+    kingdom?: string;
+    phylum?: string;
+    classs?: string;
+    order?: string;
+    family?: string;
+    genus?: string;
+    species?: string;
+    stateProvince?: string;
+    country?: string;
+    decimalLatitude?: number;
+    decimalLongitude?: number;
+    coordinateUncertaintyInMeters?: number;
+    eventDate?: number;
+    year?: number;
+    month?: string;
+    basisOfRecord?: string;
+    dataResourceName?: string;
+    dataResourceUid?: string;
+    dataProviderName?: string;
+    license?: string;
+    imageUrl?: string;
+    thumbnailUrl?: string;
+    images?: string[];
+    spatiallyValid?: boolean;
+    assertions?: string[];
+    recordedBy?: string[];
+    collectors?: string[];
+}
+export interface ALAOccurrenceSearchResult {
+    totalRecords: number;
+    pageSize: number;
+    startIndex: number;
+    status: string;
+    sort: string;
+    dir: string;
+    occurrences: ALAOccurrence[];
+}
+export interface ALASpecies {
+    guid: string;
+    name: string;
+    scientificName: string;
+    author?: string;
+    rank?: string;
+    rankId?: number;
+    commonName?: string;
+    commonNames?: string[];
+    kingdom?: string;
+    phylum?: string;
+    classs?: string;
+    order?: string;
+    family?: string;
+    genus?: string;
+    nameComplete?: string;
+    acceptedConceptGuid?: string;
+    acceptedConceptName?: string;
+    taxonomicStatus?: string;
+    imageUrl?: string;
+    thumbnailUrl?: string;
+    occurrenceCount?: number;
+}
+export interface ALASpeciesProfile {
+    taxonConcept: ALASpecies;
+    commonNames?: Array<{
+        nameString: string;
+        status?: string;
+        priority?: number;
+    }>;
+    synonyms?: Array<{
+        nameString: string;
+        author?: string;
+    }>;
+    imageIdentifier?: string;
+    images?: Array<{
+        imageId: string;
+        title?: string;
+        creator?: string;
+        license?: string;
+        thumbnailUrl?: string;
+        largeImageUrl?: string;
+    }>;
+    conservationStatuses?: Array<{
+        status: string;
+        region?: string;
+        system?: string;
+    }>;
+    habitats?: string[];
+}
+export interface ALASpeciesSearchResult {
+    searchResults: {
+        totalRecords: number;
+        startIndex: number;
+        pageSize: number;
+        results: ALASpecies[];
+    };
+}
+export interface ALAAutoCompleteResult {
+    guid: string;
+    name: string;
+    commonName?: string;
+    matchedNames?: string[];
+    kingdom?: string;
+    rankId?: number;
+    rankString?: string;
+}
+export interface ALAImageSearchParams {
+    /** Search query */
+    q: string;
+    /** Maximum results (default 20) */
+    pageSize?: number;
+    /** Start offset */
+    offset?: number;
+}
+export interface ALAImage {
+    imageId: string;
+    imageUrl: string;
+    thumbnailUrl?: string;
+    largeImageUrl?: string;
+    title?: string;
+    creator?: string;
+    license?: string;
+    dataResourceName?: string;
+    occurrenceId?: string;
+    scientificName?: string;
+    vernacularName?: string;
+    recognisedLicence?: string;
+}
+export interface ALAImageSearchResult {
+    totalRecords: number;
+    pageSize: number;
+    startIndex: number;
+    images: ALAImage[];
+}
+export interface ALANameMatchResult {
+    success: boolean;
+    scientificName?: string;
+    scientificNameAuthorship?: string;
+    taxonConceptID?: string;
+    rank?: string;
+    rankId?: number;
+    lft?: number;
+    rgt?: number;
+    matchType?: string;
+    nameType?: string;
+    synonymType?: string;
+    kingdom?: string;
+    kingdomID?: string;
+    phylum?: string;
+    phylumID?: string;
+    classs?: string;
+    classID?: string;
+    order?: string;
+    orderID?: string;
+    family?: string;
+    familyID?: string;
+    genus?: string;
+    genusID?: string;
+    species?: string;
+    speciesID?: string;
+    vernacularName?: string;
+    issues?: string[];
+}
+export interface ALASpeciesList {
+    dataResourceUid: string;
+    listName: string;
+    listType?: string;
+    dateCreated?: string;
+    lastUpdated?: string;
+    itemCount: number;
+    isAuthoritative?: boolean;
+    isPrivate?: boolean;
+    region?: string;
+    description?: string;
+}
+export interface ALASpeciesListSearchResult {
+    lists: ALASpeciesList[];
+    listCount: number;
+    max: number;
+    offset: number;
+}
+export interface ALASpeciesListItem {
+    id: number;
+    lsid?: string;
+    name: string;
+    commonName?: string;
+    scientificName?: string;
+    kvpValues?: Record<string, string>[];
+}
+export interface ALASpeciesListDetail {
+    dataResourceUid: string;
+    listName: string;
+    listType?: string;
+    description?: string;
+    dateCreated?: string;
+    lastUpdated?: string;
+    itemCount: number;
+    items: ALASpeciesListItem[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sources/ala/types.d.ts.map

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

package/dist/sources/ala/types.js

@@ -0,0 +1,7 @@
+/**
+ * Atlas of Living Australia (ALA) API Type Definitions
+ *
+ * ALA provides access to 165M+ species occurrence records across Australia.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sources/ala/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/sources/ala/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/sources/datagovau/client.d.ts

@@ -0,0 +1,68 @@
+/**
+ * data.gov.au (CKAN) API Client
+ *
+ * data.gov.au is Australia's national open data portal, powered by CKAN.
+ * It aggregates datasets from federal, state, and local government agencies.
+ * No API key is required for read-only access.
+ *
+ * API Documentation: https://docs.ckan.org/en/latest/api/
+ * Portal: https://data.gov.au/
+ */
+import { BaseClient } from '../../core/base-client.js';
+import type { DataGovAUSearchParams, DataGovAUSearchResult, DataGovAUDataset, DataGovAUResource, DataGovAUOrganization, DataGovAUGroup, DataGovAUDatastoreParams, DataGovAUDatastoreResult } from './types.js';
+export declare class DataGovAUClient extends BaseClient {
+    constructor();
+    /**
+     * Search datasets (packages) in data.gov.au
+     */
+    search(params: DataGovAUSearchParams): Promise<DataGovAUSearchResult>;
+    /**
+     * Get a specific dataset by ID or name
+     */
+    getDataset(idOrName: string): Promise<DataGovAUDataset | null>;
+    /**
+     * List all dataset names (for discovery)
+     */
+    listDatasets(limit?: number, offset?: number): Promise<string[]>;
+    /**
+     * Get a specific resource by ID
+     */
+    getResource(resourceId: string): Promise<DataGovAUResource | null>;
+    /**
+     * Search the datastore (tabular data) for a resource
+     */
+    datastoreSearch(params: DataGovAUDatastoreParams): Promise<DataGovAUDatastoreResult | null>;
+    /**
+     * List all organizations
+     */
+    listOrganizations(allFields?: boolean, limit?: number): Promise<DataGovAUOrganization[]>;
+    /**
+     * Get organization details
+     */
+    getOrganization(idOrName: string, includeDatasets?: boolean): Promise<DataGovAUOrganization | null>;
+    /**
+     * List all groups (categories)
+     */
+    listGroups(allFields?: boolean): Promise<DataGovAUGroup[]>;
+    /**
+     * Get group details
+     */
+    getGroup(idOrName: string, includeDatasets?: boolean): Promise<DataGovAUGroup | null>;
+    /**
+     * List all tags
+     */
+    listTags(query?: string): Promise<string[]>;
+    /**
+     * Autocomplete dataset names and titles
+     */
+    autocomplete(query: string, limit?: number): Promise<{
+        name: string;
+        title: string;
+    }[]>;
+    private parseDataset;
+    private parseResource;
+    private parseOrganization;
+    private parseGroup;
+}
+export declare const dataGovAUClient: DataGovAUClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/sources/datagovau/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/sources/datagovau/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAIpB,qBAAa,eAAgB,SAAQ,UAAU;;IAS7C;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAyD3E;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAuBpE;;OAEG;IACG,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAetE;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAsBxE;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAwDjG;;OAEG;IACG,iBAAiB,CAAC,SAAS,UAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IA2B3F;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,UAAQ,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IA6BvG;;OAEG;IACG,UAAU,CAAC,SAAS,UAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAsB7D;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,UAAQ,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA6BzF;;OAEG;IACG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAejD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAqB7F,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,UAAU;CAWnB;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC"}