@sudosandwich/limps-radix 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Paul Breuler
+
+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/README.md

@@ -0,0 +1,255 @@
+# @sudosandwich/limps-radix
+
+limps extension for Radix UI contract extraction, semantic analysis, and drift detection.
+
+## Installation
+
+```bash
+npm install @sudosandwich/limps-radix
+```
+
+**Peer Dependencies**: Requires `@sudosandwich/limps@^2.0.0`.
+
+## Quick Start
+
+1. Add the extension to your limps config (see below).
+2. Restart your limps MCP server.
+3. Use the MCP tools from your client (Cursor, Claude Desktop, etc.).
+
+Example `limps.config.json`:
+
+```json
+{
+  "extensions": ["@sudosandwich/limps-radix"]
+}
+```
+
+## MCP Tools
+
+### `radix_list_primitives`
+
+List all available Radix UI primitives with package names and descriptions.
+
+**Input**
+
+```json
+{
+  "version": "latest"
+}
+```
+
+**Output**
+
+```json
+{
+  "version": "1.1.2",
+  "primitives": [
+    {
+      "name": "dialog",
+      "package": "@radix-ui/react-dialog",
+      "description": "A modal dialog overlay"
+    },
+    {
+      "name": "popover",
+      "package": "@radix-ui/react-popover",
+      "description": "A popup that appears from a trigger"
+    }
+  ]
+}
+```
+
+### `radix_extract_primitive`
+
+Extract the behavioral contract for a single Radix primitive, including sub-components, prop metadata, and semantic classification.
+
+**Input**
+
+```json
+{
+  "primitive": "dialog",
+  "version": "latest"
+}
+```
+
+**Output**
+
+```json
+{
+  "primitive": "Dialog",
+  "package": "@radix-ui/react-dialog",
+  "version": "1.1.2",
+  "behavior": {
+    "statePattern": "binary",
+    "compositionPattern": "compound",
+    "renderingPattern": "portal-conditional"
+  },
+  "subComponents": [
+    {
+      "name": "Root",
+      "props": [
+        {
+          "name": "open",
+          "type": "boolean",
+          "required": false,
+          "category": "state"
+        },
+        {
+          "name": "onOpenChange",
+          "type": "(open: boolean) => void",
+          "required": false,
+          "category": "event"
+        }
+      ]
+    },
+    {
+      "name": "Trigger",
+      "props": [
+        {
+          "name": "asChild",
+          "type": "boolean",
+          "required": false,
+          "category": "composition"
+        }
+      ]
+    }
+  ],
+  "similarTo": ["AlertDialog", "Popover"],
+  "disambiguationRule": "Dialog has modal=true by default; AlertDialog requires action confirmation"
+}
+```
+
+## API Reference
+
+This package re-exports its core types, signatures, cache helpers, and tool definitions from `src/index.ts`.
+
+### Types
+
+- `ExtractedPrimitive` — Raw extraction from Radix `.d.ts` files.
+- `BehaviorSignature` — Semantic behavioral contract used for comparisons.
+- `PropDefinition` — Prop metadata with semantic classification flags.
+- `SubComponentDefinition` — Sub-component structure and prop list.
+- `RawProp` — Raw prop before classification.
+- `PrimitiveInfo` — Info used by primitive listings.
+- `PackageInfo` — npm registry package metadata.
+- `StatePattern` / `CompositionPattern` / `RenderingPattern` — Behavioral pattern enums.
+
+### Modules
+
+- `cache` — File-based cache helpers for extracted data and signatures.
+- `signatures` — Behavior signature generation utilities.
+- `tools` — MCP tool definitions (`radix_list_primitives`, `radix_extract_primitive`).
+
+## Configuration
+
+limps supports extension-specific config via a top-level key in `limps.config.json`.
+
+```json
+{
+  "extensions": ["@sudosandwich/limps-radix"],
+  "radix": {
+    "cacheDir": "~/Library/Application Support/limps-radix"
+  }
+}
+```
+
+**Options**
+
+- `cacheDir` (optional): Base directory for the Radix cache. Defaults to `~/.limps-radix/cache`.
+
+## Examples
+
+### List primitives for a specific version
+
+**Input**
+
+```json
+{
+  "version": "1.1.2"
+}
+```
+
+**Output**
+
+```json
+{
+  "version": "1.1.2",
+  "primitives": [
+    {
+      "name": "dialog",
+      "package": "@radix-ui/react-dialog",
+      "description": "A modal dialog overlay"
+    },
+    {
+      "name": "popover",
+      "package": "@radix-ui/react-popover",
+      "description": "A popup that appears from a trigger"
+    }
+  ]
+}
+```
+
+### Extract a primitive contract
+
+**Input**
+
+```json
+{
+  "primitive": "dialog"
+}
+```
+
+**Output**
+
+```json
+{
+  "primitive": "Dialog",
+  "package": "@radix-ui/react-dialog",
+  "version": "1.1.2",
+  "behavior": {
+    "statePattern": "binary",
+    "compositionPattern": "compound",
+    "renderingPattern": "portal-conditional"
+  },
+  "subComponents": [
+    {
+      "name": "Root",
+      "props": [
+        {
+          "name": "open",
+          "type": "boolean",
+          "required": false,
+          "category": "state"
+        },
+        {
+          "name": "onOpenChange",
+          "type": "(open: boolean) => void",
+          "required": false,
+          "category": "event"
+        }
+      ]
+    },
+    {
+      "name": "Trigger",
+      "props": [
+        {
+          "name": "asChild",
+          "type": "boolean",
+          "required": false,
+          "category": "composition"
+        }
+      ]
+    }
+  ],
+  "similarTo": ["AlertDialog", "Popover"],
+  "disambiguationRule": "Dialog has modal=true by default; AlertDialog requires action confirmation"
+}
+```
+
+## Notes
+
+- If the unified `radix-ui` package is available for a version, the tools may return `radix-ui` as the package name instead of individual `@radix-ui/react-*` packages.
+- Cache entries are stored by version and primitive name to speed up repeated tool calls.
+
+## License
+
+MIT

package/dist/cache/index.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Cache module for Radix primitive data.
+ *
+ * Provides version-aware caching with TTL for:
+ * - ExtractedPrimitive data
+ * - BehaviorSignature data
+ * - "Latest" version resolution
+ */
+import type { ExtractedPrimitive, BehaviorSignature } from '../types/index.js';
+export * from './storage.js';
+export * from './ttl.js';
+/**
+ * Latest version resolution cache entry.
+ */
+export interface LatestResolution {
+    version: string;
+    resolvedAt: string;
+}
+/**
+ * Latest resolution cache file content.
+ */
+export interface LatestResolutionCache {
+    [primitive: string]: LatestResolution;
+}
+/**
+ * Cache options for get operations.
+ */
+export interface CacheGetOptions {
+    /**
+     * Skip TTL check and return cached data even if expired.
+     */
+    ignoreExpired?: boolean;
+    /**
+     * Base directory for cache (for testing).
+     */
+    baseDir?: string;
+}
+/**
+ * Cache options for save operations.
+ */
+export interface CacheSaveOptions {
+    /**
+     * Base directory for cache (for testing).
+     */
+    baseDir?: string;
+}
+/**
+ * Get cached ExtractedPrimitive data.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param options - Cache options
+ * @returns Cached data or null if not found or expired
+ */
+export declare function getFromCache(primitive: string, version: string, options?: CacheGetOptions): Promise<ExtractedPrimitive | null>;
+/**
+ * Save ExtractedPrimitive data to cache.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param data - Data to cache
+ * @param options - Cache options
+ */
+export declare function saveToCache(primitive: string, version: string, data: ExtractedPrimitive, options?: CacheSaveOptions): Promise<void>;
+/**
+ * Get cached BehaviorSignature data.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param options - Cache options
+ * @returns Cached signature or null if not found or expired
+ */
+export declare function getSignatureFromCache(primitive: string, version: string, options?: CacheGetOptions): Promise<BehaviorSignature | null>;
+/**
+ * Save BehaviorSignature data to cache.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param signature - Signature to cache
+ * @param options - Cache options
+ */
+export declare function saveSignatureToCache(primitive: string, version: string, signature: BehaviorSignature, options?: CacheSaveOptions): Promise<void>;
+/**
+ * Get the "latest" version resolution for a primitive.
+ * @param primitive - Primitive name
+ * @param options - Cache options
+ * @returns Latest resolution or null if not found or expired
+ */
+export declare function getLatestResolution(primitive: string, options?: CacheGetOptions): Promise<LatestResolution | null>;
+/**
+ * Save a "latest" version resolution.
+ * @param primitive - Primitive name
+ * @param version - Resolved version string
+ * @param options - Cache options
+ */
+export declare function saveLatestResolution(primitive: string, version: string, options?: CacheSaveOptions): Promise<void>;
+/**
+ * Clear cache for a specific primitive and version, or all cache.
+ * @param primitive - Optional primitive name (clears all if not provided)
+ * @param version - Optional version (clears all versions of primitive if not provided)
+ * @param options - Cache options
+ */
+export declare function clearCache(primitive?: string, version?: string, options?: CacheSaveOptions): Promise<void>;
+/**
+ * Get cache statistics.
+ * @param options - Cache options
+ * @returns Cache statistics
+ */
+export declare function getCacheStats(options?: CacheGetOptions): Promise<{
+    versions: string[];
+    primitiveCount: number;
+    signatureCount: number;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAe/E,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAcpC;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAkBnC;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAqBlC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC;IAC1E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAyBD"}

package/dist/cache/index.js

@@ -0,0 +1,176 @@
+/**
+ * Cache module for Radix primitive data.
+ *
+ * Provides version-aware caching with TTL for:
+ * - ExtractedPrimitive data
+ * - BehaviorSignature data
+ * - "Latest" version resolution
+ */
+import { getCacheDir, getCachePath, readFromFile, writeToFile, deleteFile, deleteDir, listCachedVersions, listCachedPrimitives, } from './storage.js';
+import { isVersionDataExpired, isSignatureExpired, TTL } from './ttl.js';
+import * as path from 'node:path';
+// Re-export storage and TTL utilities
+export * from './storage.js';
+export * from './ttl.js';
+/**
+ * Get cached ExtractedPrimitive data.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param options - Cache options
+ * @returns Cached data or null if not found or expired
+ */
+export async function getFromCache(primitive, version, options = {}) {
+    const cachePath = getCachePath(primitive, version, 'data', options.baseDir);
+    const data = await readFromFile(cachePath);
+    if (!data) {
+        return null;
+    }
+    // Check expiration unless ignored
+    if (!options.ignoreExpired && isVersionDataExpired(data.extractedAt)) {
+        return null;
+    }
+    return data;
+}
+/**
+ * Save ExtractedPrimitive data to cache.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param data - Data to cache
+ * @param options - Cache options
+ */
+export async function saveToCache(primitive, version, data, options = {}) {
+    const cachePath = getCachePath(primitive, version, 'data', options.baseDir);
+    await writeToFile(cachePath, data);
+}
+/**
+ * Get cached BehaviorSignature data.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param options - Cache options
+ * @returns Cached signature or null if not found or expired
+ */
+export async function getSignatureFromCache(primitive, version, options = {}) {
+    const cachePath = getCachePath(primitive, version, 'sig', options.baseDir);
+    // BehaviorSignature doesn't have a timestamp, so we check the ExtractedPrimitive
+    const extractedPath = getCachePath(primitive, version, 'data', options.baseDir);
+    const extracted = await readFromFile(extractedPath);
+    // If no extracted data exists, signature is orphaned
+    if (!extracted && !options.ignoreExpired) {
+        return null;
+    }
+    // Check expiration based on extracted data timestamp
+    if (extracted && !options.ignoreExpired && isSignatureExpired(extracted.extractedAt)) {
+        return null;
+    }
+    return readFromFile(cachePath);
+}
+/**
+ * Save BehaviorSignature data to cache.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param signature - Signature to cache
+ * @param options - Cache options
+ */
+export async function saveSignatureToCache(primitive, version, signature, options = {}) {
+    const cachePath = getCachePath(primitive, version, 'sig', options.baseDir);
+    await writeToFile(cachePath, signature);
+}
+/**
+ * Get the "latest" version resolution for a primitive.
+ * @param primitive - Primitive name
+ * @param options - Cache options
+ * @returns Latest resolution or null if not found or expired
+ */
+export async function getLatestResolution(primitive, options = {}) {
+    const cacheDir = getCacheDir(options.baseDir);
+    const latestPath = path.join(cacheDir, 'latest-resolved.json');
+    const cache = await readFromFile(latestPath);
+    if (!cache || !cache[primitive]) {
+        return null;
+    }
+    const resolution = cache[primitive];
+    // Check expiration
+    if (!options.ignoreExpired) {
+        const resolvedTime = new Date(resolution.resolvedAt).getTime();
+        const now = Date.now();
+        if (now - resolvedTime >= TTL.LATEST_RESOLUTION) {
+            return null;
+        }
+    }
+    return resolution;
+}
+/**
+ * Save a "latest" version resolution.
+ * @param primitive - Primitive name
+ * @param version - Resolved version string
+ * @param options - Cache options
+ */
+export async function saveLatestResolution(primitive, version, options = {}) {
+    const cacheDir = getCacheDir(options.baseDir);
+    const latestPath = path.join(cacheDir, 'latest-resolved.json');
+    // Read existing cache
+    let cache = await readFromFile(latestPath);
+    if (!cache) {
+        cache = {};
+    }
+    // Update entry
+    cache[primitive] = {
+        version,
+        resolvedAt: new Date().toISOString(),
+    };
+    await writeToFile(latestPath, cache);
+}
+/**
+ * Clear cache for a specific primitive and version, or all cache.
+ * @param primitive - Optional primitive name (clears all if not provided)
+ * @param version - Optional version (clears all versions of primitive if not provided)
+ * @param options - Cache options
+ */
+export async function clearCache(primitive, version, options = {}) {
+    const cacheDir = getCacheDir(options.baseDir);
+    // Clear everything
+    if (!primitive) {
+        await deleteDir(cacheDir);
+        return;
+    }
+    // Clear specific primitive in specific version
+    if (version) {
+        await deleteFile(getCachePath(primitive, version, 'data', options.baseDir));
+        await deleteFile(getCachePath(primitive, version, 'sig', options.baseDir));
+        return;
+    }
+    // Clear specific primitive in all versions
+    const versions = await listCachedVersions(options.baseDir);
+    for (const v of versions) {
+        await deleteFile(getCachePath(primitive, v, 'data', options.baseDir));
+        await deleteFile(getCachePath(primitive, v, 'sig', options.baseDir));
+    }
+}
+/**
+ * Get cache statistics.
+ * @param options - Cache options
+ * @returns Cache statistics
+ */
+export async function getCacheStats(options = {}) {
+    const versions = await listCachedVersions(options.baseDir);
+    let primitiveCount = 0;
+    let signatureCount = 0;
+    for (const version of versions) {
+        const primitives = await listCachedPrimitives(version, options.baseDir);
+        primitiveCount += primitives.length;
+        // Count signatures (files ending in .sig.json)
+        for (const primitive of primitives) {
+            const sigPath = getCachePath(primitive, version, 'sig', options.baseDir);
+            const sig = await readFromFile(sigPath);
+            if (sig) {
+                signatureCount++;
+            }
+        }
+    }
+    return {
+        versions,
+        primitiveCount,
+        signatureCount,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

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

package/dist/cache/storage.d.ts

@@ -0,0 +1,73 @@
+/**
+ * File-based cache storage for Radix primitive data.
+ *
+ * Cache structure:
+ * ~/.limps-radix/
+ *   cache/
+ *     1.0.5/
+ *       dialog.json          # ExtractedPrimitive
+ *       dialog.sig.json      # BehaviorSignature
+ *     1.1.0/
+ *       ...
+ *     latest-resolved.json   # { primitive: { version: "1.1.2", resolvedAt: "..." } }
+ */
+/**
+ * Get the cache directory path.
+ * @param baseDir - Optional base directory (defaults to home directory)
+ * @returns Absolute path to the cache directory
+ */
+export declare function getCacheDir(baseDir?: string): string;
+/**
+ * Get the versioned cache directory path.
+ * @param version - The Radix version
+ * @param baseDir - Optional base directory
+ * @returns Absolute path to the versioned cache directory
+ */
+export declare function getVersionedCacheDir(version: string, baseDir?: string): string;
+/**
+ * Get the path for a cached primitive file.
+ * @param primitive - Primitive name (e.g., "Dialog")
+ * @param version - Version string
+ * @param type - Type of cache ('data' for ExtractedPrimitive, 'sig' for BehaviorSignature)
+ * @param baseDir - Optional base directory
+ * @returns Absolute file path
+ */
+export declare function getCachePath(primitive: string, version: string, type: 'data' | 'sig', baseDir?: string): string;
+/**
+ * Read data from a cache file.
+ * @param cachePath - Full path to the cache file
+ * @returns Parsed JSON data or null if file doesn't exist or is invalid
+ */
+export declare function readFromFile<T>(cachePath: string): Promise<T | null>;
+/**
+ * Write data to a cache file.
+ * @param cachePath - Full path to the cache file
+ * @param data - Data to write
+ */
+export declare function writeToFile<T>(cachePath: string, data: T): Promise<void>;
+/**
+ * Delete a cache file.
+ * @param cachePath - Full path to the cache file
+ * @returns True if file was deleted, false if it didn't exist
+ */
+export declare function deleteFile(cachePath: string): Promise<boolean>;
+/**
+ * Delete a directory and all its contents.
+ * @param dirPath - Directory path to delete
+ * @returns True if directory was deleted, false if it didn't exist
+ */
+export declare function deleteDir(dirPath: string): Promise<boolean>;
+/**
+ * List all versioned cache directories.
+ * @param baseDir - Optional base directory
+ * @returns Array of version strings that have cached data
+ */
+export declare function listCachedVersions(baseDir?: string): Promise<string[]>;
+/**
+ * List all cached primitives for a version.
+ * @param version - Version string
+ * @param baseDir - Optional base directory
+ * @returns Array of primitive names that have cached data
+ */
+export declare function listCachedPrimitives(version: string, baseDir?: string): Promise<string[]>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/cache/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/cache/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgBH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GAAG,KAAK,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAOR;AAUD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAa1E;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9E;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpE;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUjE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAc5E;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB"}