rivet-design 0.9.1 → 0.9.3

package/dist/mcp/agent-variants/createZeroToOneTool.js

@@ -0,0 +1,295 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCreateZeroToOneTool = exports.slugifyPrompt = exports.createZeroToOneInput = void 0;
+const crypto_1 = require("crypto");
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const v3_1 = require("zod/v3");
+const viteReactTs_1 = require("../../services/templates/viteReactTs");
+const contracts_1 = require("./contracts");
+const errors_1 = require("./errors");
+const sourceContext_1 = require("./sourceContext");
+const inspirationDesignContext_1 = require("./inspirationDesignContext");
+const designContextStore_1 = require("./designContextStore");
+const DEFAULT_VARIANT_COUNT = 3;
+const MIN_VARIANT_COUNT = 2;
+const MAX_VARIANT_COUNT = 8;
+const SLUG_SUFFIX_BYTES = 2;
+exports.createZeroToOneInput = {
+    prompt: v3_1.z.string().min(1),
+    count: v3_1.z.number().int().min(MIN_VARIANT_COUNT).max(MAX_VARIANT_COUNT).optional(),
+    destinationParent: v3_1.z.string().optional(),
+    framework: v3_1.z.enum(['vite']).optional(),
+    sourceContext: contracts_1.sourceContextInputSchema.optional(),
+    sessionId: v3_1.z.string().optional(),
+};
+/**
+ * Slugify a prompt into a directory-safe kebab-case name with a short random
+ * suffix so concurrent calls with the same prompt don't collide.
+ */
+const slugifyPrompt = (prompt) => {
+    const base = prompt
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 40);
+    const suffix = (0, crypto_1.randomBytes)(SLUG_SUFFIX_BYTES).toString('hex');
+    return base ? `${base}-${suffix}` : `rivet-app-${suffix}`;
+};
+exports.slugifyPrompt = slugifyPrompt;
+const failed = (code, message) => ({
+    stage: 'failed',
+    errorCode: code,
+    message,
+});
+/**
+ * Register the `create_zero_to_one_project` convenience MCP tool. Normalizes
+ * the variant count, slugifies the prompt to derive a destination directory,
+ * validates the framework, and delegates to `proposeVariantsHandler` with
+ * `projectContext.kind = 'fresh'`.
+ */
+const registerCreateZeroToOneTool = (mcp, deps) => {
+    const homedir = deps.homedir ?? os_1.default.homedir;
+    // Filesystem store is the default for CLI/desktop deployments; the dep
+    // can swap in a hosted/server-backed store or pass `null` to disable
+    // caching entirely. The default store is constructed lazily so we only
+    // touch `os.homedir()` if the flow actually uses it. Memoized so the
+    // first call's `dirReady`/`mkdir` state survives across tool
+    // invocations instead of being thrown away after each request.
+    let defaultDesignContextStore;
+    const resolveDesignContextStore = () => {
+        if (deps.designContextStore === null)
+            return undefined;
+        if (deps.designContextStore !== undefined)
+            return deps.designContextStore;
+        if (!defaultDesignContextStore) {
+            defaultDesignContextStore = new designContextStore_1.FileDesignContextStore();
+        }
+        return defaultDesignContextStore;
+    };
+    mcp.tool('create_zero_to_one_project', 'Convenience entry point for creating a new project from scratch. Slugifies the prompt into a destination directory under the user home and starts an agent-variants session with projectContext.kind=fresh. Returns the same response shape as propose_variants. REQUIRED PROTOCOL: source_research (when requested) -> report_source_context -> briefs -> user confirmation -> approve -> IMMEDIATELY share the visualEditor.url with the user ("Generating variants — watch here: <url>") -> request_work -> generate static_preview HTML/CSS for each work item -> report_variant_complete -> when terminal, share each previewUrl from the response with the user as clickable links -> user picks variant -> commit. static_preview is the final deliverable — no code_gen or Vite scaffold is created. Briefs: label ≤ 4 words, body exactly ONE sentence ≤ 20 words — a single evocative descriptor (no bullets, no lists). MANDATORY USER CONFIRMATION: after report_variant_briefs, show the numbered brief list and wait for feedback before approve_variant_briefs. NEVER auto-approve. For static_preview work items, report_variant_complete output must be {html: string, css?: string, js?: string} — write self-contained HTML with no React/Vite-only imports. After user commit, Rivet writes the HTML to index.html at the destination directory.', exports.createZeroToOneInput, async (args) => {
+        try {
+            const framework = args.framework ?? 'vite';
+            if (framework !== 'vite') {
+                return jsonResponse(failed('UNSUPPORTED_FRAMEWORK', `create_zero_to_one_project only supports framework='vite' in v1; got '${framework}'.`));
+            }
+            const count = clampCount(args.count);
+            const sourceUrls = (0, sourceContext_1.resolveSourceUrls)(args.prompt, args.sourceContext);
+            const sourceArtifacts = (0, sourceContext_1.normalizeSourceArtifacts)(args.sourceContext?.sourceArtifacts);
+            const destinationParent = args.destinationParent ?? homedir();
+            if (!path_1.default.isAbsolute(destinationParent)) {
+                return jsonResponse(failed('SCHEMA_VALIDATION_FAILED', `destinationParent must be absolute; got '${destinationParent}'.`));
+            }
+            const slug = (0, exports.slugifyPrompt)(args.prompt);
+            const destinationPath = path_1.default.join(destinationParent, slug);
+            if (!(0, viteReactTs_1.isDestinationEmpty)(destinationPath)) {
+                return jsonResponse(failed('DESTINATION_NOT_EMPTY', `Destination '${destinationPath}' is not empty.`));
+            }
+            const inspirationOutcome = sourceUrls.length > 0
+                ? await (0, inspirationDesignContext_1.extractInspirationDesignContext)({
+                    urls: sourceUrls,
+                    prompt: args.prompt,
+                    sourceContext: args.sourceContext,
+                    slotCount: count,
+                    fetcher: deps.inspirationFetcher,
+                    store: resolveDesignContextStore(),
+                    forceRefresh: (0, designContextStore_1.promptRequestsFreshExtraction)(args.prompt),
+                })
+                : {
+                    entries: [],
+                    warnings: [],
+                    telemetry: {
+                        inspirationLinkCount: 0,
+                        referenceLinkCount: 0,
+                        successfulExtractions: 0,
+                        lowSignalCount: 0,
+                        fetchFailureCount: 0,
+                        blockedTargetCount: 0,
+                        mergeStrategy: 'none',
+                        cache: {
+                            hitCount: 0,
+                            missCount: 0,
+                            staleCount: 0,
+                            versionMismatchCount: 0,
+                            lowConfidenceCount: 0,
+                            regenerationCount: 0,
+                            forcedRefresh: false,
+                        },
+                    },
+                };
+            const designContextEntries = collapseDesignContextEntries(inspirationOutcome.entries);
+            const projectContext = {
+                kind: 'fresh',
+                workspacePath: destinationPath,
+                framework: 'vite',
+                ...(designContextEntries
+                    ? { designContext: designContextEntries }
+                    : {}),
+                ...(sourceUrls.length > 0 ||
+                    sourceArtifacts.length > 0 ||
+                    args.sourceContext?.preserveBrand !== undefined
+                    ? {
+                        sourceContext: {
+                            ...(sourceUrls.length > 0 ? { sourceUrls } : {}),
+                            ...(sourceArtifacts.length > 0 ? { sourceArtifacts } : {}),
+                            ...(args.sourceContext?.preserveBrand !== undefined
+                                ? { preserveBrand: args.sourceContext.preserveBrand }
+                                : {}),
+                        },
+                    }
+                    : {}),
+            };
+            // Ensure the destination's parent exists so the materialize step at
+            // commit time has a directory to write into. The destination itself
+            // is created during materialize.
+            fs_1.default.mkdirSync(destinationParent, { recursive: true });
+            const proposeInput = {
+                sessionId: args.sessionId,
+                prompt: args.prompt,
+                count,
+                projectContext,
+            };
+            // Validate via the shared schema before delegating, so the proxy and
+            // direct callers see the same rejection shape.
+            const parsed = v3_1.z.object(contracts_1.proposeVariantsInput).safeParse(proposeInput);
+            if (!parsed.success) {
+                return jsonResponse(failed('SCHEMA_VALIDATION_FAILED', parsed.error.message));
+            }
+            const visualEditor = deps.ensureVisualEditorOpen
+                ? await deps.ensureVisualEditorOpen({
+                    projectPath: destinationPath,
+                    framework: 'vite',
+                })
+                : undefined;
+            const result = deps.orchestrator.propose(parsed.data);
+            if (sourceUrls.length > 0 || sourceArtifacts.length > 0) {
+                deps.telemetry?.trackAgentVariantsSourceContextQuality?.({
+                    sessionId: result.sessionId,
+                    sourceUrlCount: sourceUrls.length,
+                    artifactCount: sourceArtifacts.length,
+                    hasScreenshotReferences: sourceArtifacts.some((artifact) => artifact.kind === 'screenshotNotes'),
+                    preserveBrand: Boolean(args.sourceContext?.preserveBrand),
+                });
+            }
+            if (inspirationOutcome.telemetry.inspirationLinkCount > 0 ||
+                inspirationOutcome.telemetry.referenceLinkCount > 0) {
+                const { cache, ...telemetryCounts } = inspirationOutcome.telemetry;
+                deps.telemetry?.trackAgentVariantsInspirationExtraction?.({
+                    sessionId: result.sessionId,
+                    ...telemetryCounts,
+                    cacheHitCount: cache.hitCount,
+                    cacheMissCount: cache.missCount,
+                    cacheStaleCount: cache.staleCount,
+                    cacheVersionMismatchCount: cache.versionMismatchCount,
+                    cacheLowConfidenceCount: cache.lowConfidenceCount,
+                    cacheRegenerationCount: cache.regenerationCount,
+                    cacheForcedRefresh: cache.forcedRefresh,
+                    ...(inspirationOutcome.cacheReuse
+                        ? {
+                            cacheReuseAgeBucket: inspirationOutcome.cacheReuse.ageBucket,
+                            cacheReuseConfidenceBucket: inspirationOutcome.cacheReuse.confidenceBucket,
+                        }
+                        : {}),
+                });
+            }
+            const warningsField = inspirationOutcome.warnings.length > 0
+                ? { inspirationWarnings: inspirationOutcome.warnings }
+                : {};
+            if (result.stage === 'awaiting_source_research') {
+                return jsonResponse({
+                    sessionId: result.sessionId,
+                    stage: 'awaiting_source_research',
+                    sourceResearchWorkItem: {
+                        id: result.sourceResearchWorkItem.id,
+                        kind: 'source_research',
+                        attempt: result.sourceResearchWorkItem.attempt,
+                        input: result.sourceResearchWorkItem.input,
+                        output_schema: {
+                            sourceContext: 'sourceFindings, sectionInventory, visualObservations, sourceRoles, qualityBar, screenshotReferences?',
+                        },
+                    },
+                    nextAction: 'continue_variants',
+                    ...(visualEditor ? { visualEditor } : {}),
+                    ...warningsField,
+                });
+            }
+            return jsonResponse({
+                sessionId: result.sessionId,
+                stage: 'awaiting_briefs',
+                briefWorkItem: {
+                    id: result.briefWorkItem.id,
+                    kind: 'brief',
+                    attempt: result.briefWorkItem.attempt,
+                    input: result.briefWorkItem.input,
+                    output_schema: { briefs: 'Array<{briefId, label, body}>' },
+                },
+                nextAction: 'report_variant_briefs',
+                ...(visualEditor ? { visualEditor } : {}),
+                ...warningsField,
+            });
+        }
+        catch (err) {
+            const code = err instanceof errors_1.AgentVariantsError
+                ? err.code
+                : 'SCHEMA_VALIDATION_FAILED';
+            const message = err instanceof Error
+                ? err.message
+                : 'Unknown error in create_zero_to_one_project';
+            return jsonResponse({
+                stage: 'failed',
+                errorCode: code,
+                message,
+            });
+        }
+    });
+};
+exports.registerCreateZeroToOneTool = registerCreateZeroToOneTool;
+const clampCount = (count) => {
+    if (count === undefined)
+        return DEFAULT_VARIANT_COUNT;
+    if (count < MIN_VARIANT_COUNT)
+        return MIN_VARIANT_COUNT;
+    if (count > MAX_VARIANT_COUNT)
+        return MAX_VARIANT_COUNT;
+    return count;
+};
+/**
+ * Reduce inspiration-extraction output to the shape the project context
+ * accepts: a defined-only `DesignContextEntry[]` of length `entries.length`
+ * when every slot has extraction output, or `undefined` when at least one
+ * slot is missing so downstream slots fall back to prompt direction.
+ *
+ * The producer (`extractInspirationDesignContext`) currently populates the
+ * array all-or-nothing — either every slot gets an entry or every slot is
+ * `undefined`. Downstream consumers index per slot
+ * (`WorktreeManager.createFreshWorktrees` uses `designContext?.[i]`, and
+ * `summarizeDesignContext` tags telemetry with the slot index), so silently
+ * compacting `[A, undefined, B]` to `[A, B]` would shift B from slot 2 to
+ * slot 1 and misassign per-slot guidance. If the producer's invariant ever
+ * softens, fail closed here: drop the partial context rather than emitting
+ * a slot-shifted array.
+ */
+const collapseDesignContextEntries = (entries) => {
+    if (entries.length === 0)
+        return undefined;
+    const populated = [];
+    for (const entry of entries) {
+        if (entry === undefined)
+            return undefined;
+        populated.push(entry);
+    }
+    return populated;
+};
+const jsonResponse = (payload) => ({
+    content: [
+        {
+            type: 'text',
+            text: JSON.stringify(payload),
+        },
+    ],
+});
+//# sourceMappingURL=createZeroToOneTool.js.map

package/dist/mcp/agent-variants/createZeroToOneTool.js.map

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

package/dist/mcp/agent-variants/designContextStore.d.ts

@@ -0,0 +1,160 @@
+import type { InspirationDesignSignals } from './inspirationDesignContext';
+/**
+ * Runtime user cache for inspiration-link design context. Persists generated
+ * designmd markdown plus safe metadata so future MCP
+ * `create_zero_to_one_project` requests with the same web link can reuse
+ * prior extraction by default. Treated as runtime user data — never mutates
+ * the bundled `src/services/templates/designmd` catalog.
+ *
+ * Path layout (local filesystem implementation):
+ *   <directory>/<sha256(normalizedUrl)>.json
+ *
+ * The default <directory> is `~/.rivet/design-context-cache/`. The store
+ * abstraction is interface-first so future hosted/server deployments can
+ * provide a durable backend (HTTPS, KV, SQL) without changing the
+ * extraction or MCP orchestration logic.
+ */
+/**
+ * Output/extractor schema version. Bump when the cache entry shape or the
+ * generated markdown structure changes incompatibly. Cached entries with a
+ * different schema version are not silently reused — they regenerate.
+ */
+export declare const DESIGN_CONTEXT_SCHEMA_VERSION = "2";
+/**
+ * Default freshness window for a cached entry. Entries older than this are
+ * marked `stale` and trigger regeneration by default. Tunable per call so
+ * tests can exercise the stale branch without sleeping.
+ */
+export declare const DEFAULT_FRESHNESS_MS: number;
+/**
+ * Default confidence threshold below which cached entries are considered
+ * low-confidence and trigger regeneration. Mirrors the in-extractor
+ * `LOW_SIGNAL_THRESHOLD` so cached and live signals stay aligned.
+ */
+export declare const DEFAULT_CONFIDENCE_THRESHOLD = 18;
+export type FreshnessState = 'fresh' | 'stale';
+export interface DesignContextCacheMetadata {
+    /** Stable cache key (sha256 hex of normalized URL). */
+    cacheKey: string;
+    /** Extractor/output schema version used to produce this entry. */
+    schemaVersion: string;
+    /** Wall-clock creation time (ms since epoch). */
+    createdAtMs: number;
+    /** Wall-clock last-used time (ms since epoch). */
+    lastUsedAtMs: number;
+    /** Signal density / confidence score (0-100). */
+    confidence: number;
+    /**
+     * Safe outcome metadata only — short non-sensitive warning codes such as
+     * `low_signal` or `partial_meta`. MUST NOT include fetched page content,
+     * full URLs, or extracted text snippets.
+     */
+    warningCodes: string[];
+}
+export interface DesignContextCacheEntry {
+    metadata: DesignContextCacheMetadata;
+    /** Generated single-source designmd markdown (separate-flavor). */
+    markdown: string;
+    /** Short user-visible label (already truncated to fit downstream cap). */
+    label: string;
+    /**
+     * Structured design signals for the source URL. Storing the same derived
+     * design observations the markdown already encodes (palette, families,
+     * sections, components) so merge-strategy callers can re-summarise across
+     * multiple cached entries without re-fetching. Raw HTML, screenshots,
+     * DOM dumps, and full source text MUST NOT be persisted here.
+     */
+    signals: InspirationDesignSignals;
+}
+export interface DesignContextStore {
+    get(cacheKey: string): Promise<DesignContextCacheEntry | undefined>;
+    put(entry: DesignContextCacheEntry): Promise<void>;
+}
+/**
+ * Normalize an HTTP/HTTPS URL for cache keying. Lowercases scheme and host,
+ * strips default ports and fragments, and preserves meaningful path/query
+ * so two pages with the same host but different paths or query strings
+ * keep separate cache entries. Returns `undefined` for inputs that are not
+ * parseable HTTP/HTTPS URLs.
+ */
+export declare const normalizeCacheUrl: (rawUrl: string) => string | undefined;
+/**
+ * Compute a stable cache key from a normalized URL. SHA-256 hashed to hex
+ * so the resulting key is filesystem-safe and does not embed proprietary
+ * URL content in the filename layer.
+ */
+export declare const cacheKeyForUrl: (rawUrl: string) => string | undefined;
+/**
+ * Coarse age bucket for safe telemetry. Maps a wall-clock age in
+ * milliseconds onto a small fixed bucket name so analytics never receive
+ * exact timestamps.
+ */
+export declare const ageBucketFor: (ageMs: number) => "lt_1h" | "1h_24h" | "1d_7d" | "7d_30d" | "gt_30d";
+/**
+ * Coarse confidence bucket for safe telemetry. Three buckets keyed off the
+ * extractor signal density score so reuse outcomes can be aggregated
+ * without leaking specific confidence values.
+ */
+export declare const confidenceBucketFor: (confidence: number) => "low" | "medium" | "high";
+/**
+ * Return true when the user prompt explicitly asks for fresh/latest/
+ * current design context. Used by the MCP flow to bypass cache reuse even
+ * when a compatible entry exists.
+ */
+export declare const promptRequestsFreshExtraction: (prompt: string) => boolean;
+export type CacheReuseDecision = {
+    reuse: true;
+    freshness: FreshnessState;
+    ageMs: number;
+} | {
+    reuse: false;
+    reason: 'version_mismatch' | 'stale' | 'low_confidence' | 'forced_refresh' | 'corrupt';
+    freshness: FreshnessState;
+    ageMs: number;
+};
+interface CanReuseOptions {
+    forceRefresh: boolean;
+    schemaVersion?: string;
+    confidenceThreshold?: number;
+    freshnessMs?: number;
+    now?: number;
+}
+/**
+ * Decide whether a cached entry is reusable for a request, factoring in
+ * extractor/schema version, freshness window, confidence threshold, and
+ * any explicit user request for fresh extraction. Callers MUST honour the
+ * decision — the store itself never silently reuses incompatible entries.
+ */
+export declare const canReuseCacheEntry: (entry: DesignContextCacheEntry, options: CanReuseOptions) => CacheReuseDecision;
+interface FileDesignContextStoreOptions {
+    /**
+     * Override the cache directory. Defaults to `~/.rivet/design-context-cache`
+     * via `os.homedir()`. Tests use a tmpdir override so the suite never
+     * touches the real user cache.
+     */
+    directory?: string;
+}
+/**
+ * Filesystem-backed `DesignContextStore`. One JSON file per cache key under
+ * a per-user cache directory. Safe to delete the entire directory without
+ * affecting bundled catalog data or compiled application code.
+ *
+ * Read/write failures degrade gracefully — get returns undefined on any
+ * parse/IO error so the MCP flow falls through to a fresh extraction
+ * instead of crashing the user request.
+ */
+export declare class FileDesignContextStore implements DesignContextStore {
+    private readonly directory;
+    private dirReady;
+    constructor(options?: FileDesignContextStoreOptions);
+    /**
+     * Resolve a cache key to its on-disk file path. Rejects keys that do not
+     * match the expected sha256 hex shape so a malformed key cannot escape
+     * the cache directory.
+     */
+    resolvePath(cacheKey: string): string | undefined;
+    get(cacheKey: string): Promise<DesignContextCacheEntry | undefined>;
+    put(entry: DesignContextCacheEntry): Promise<void>;
+}
+export {};
+//# sourceMappingURL=designContextStore.d.ts.map

package/dist/mcp/agent-variants/designContextStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"designContextStore.d.ts","sourceRoot":"","sources":["../../../src/mcp/agent-variants/designContextStore.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAI3E;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAA2B,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAC;AA8B/C,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/C,MAAM,WAAW,0BAA0B;IACzC,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,OAAO,EAAE,wBAAwB,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAAC;IACpE,GAAG,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAqB3D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAIxD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,KACZ,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAM5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAY,MAAM,KACjB,KAAK,GAAG,QAAQ,GAAG,MAIrB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ,MAAM,KAAG,OACA,CAAC;AAEhE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzD;IACE,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EACF,kBAAkB,GAClB,OAAO,GACP,gBAAgB,GAChB,gBAAgB,GAChB,SAAS,CAAC;IACd,SAAS,EAAE,cAAc,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,UAAU,eAAe;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,uBAAuB,EAC9B,SAAS,eAAe,KACvB,kBAsBF,CAAC;AAEF,UAAU,6BAA6B;IACrC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,GAAE,6BAAkC;IAKvD;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK3C,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAyBnE,GAAG,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;CA6BzD"}