@compass-ai/nova 1.0.73 → 1.0.74

package/dist/constants/token-limits.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Unified token limit constants — single source of truth.
+ *
+ * These limits are enforced as immutable system policy. They cannot be
+ * overridden by user configuration files, environment variables, or API
+ * responses.
+ *
+ * Limit hierarchy:
+ *   1. Model disabled for plan status → blocked before any token check
+ *   2. Per-model window limit → checked per model
+ *   3. General (aggregate) window limit → checked across all models
+ *
+ * Window reset: all limits use a 6-hour window. When the window expires
+ * (Date.now() − windowStart ≥ ROLLING_WINDOW_MS), the entire state is
+ * atomically reset — all counters zeroed, windowStart set to now.
+ */
+import type { PlanStatus } from '../types/index.js';
+import type { PlanType } from '../types/index.js';
+import type { PlanTokenLimits, DisabledModelRule } from '../types/token.js';
+/**
+ * Window duration in milliseconds (6 hours).
+ * When elapsed since windowStart, the entire usage state is reset.
+ */
+export declare const ROLLING_WINDOW_MS: number;
+/**
+ * Window duration in hours (for display purposes).
+ */
+export declare const ROLLING_WINDOW_HOURS = 6;
+/**
+ * Percentage of a limit at which a warning is emitted (0–100).
+ * When usage / limit >= this value, a warning is logged.
+ */
+export declare const TOKEN_LIMIT_WARNING_THRESHOLD_PERCENT = 90;
+/**
+ * Filename for the unified usage persistence file, stored in the global
+ * Compass data directory (~/.compass/).
+ */
+export declare const TOKEN_LIMITS_STORE_FILENAME = "token-limits-usage.json";
+/**
+ * File format version stored in the persistence file.
+ * Version 1 = flat counters with windowStart + atomic reset.
+ * Bump this when the on-disk schema shape changes.
+ */
+export declare const TOKEN_LIMITS_STORE_VERSION = 1;
+/**
+ * Per-plan-type limits for active subscribers.
+ * Keyed by PlanType, frozen at module load time.
+ */
+export declare const ACTIVE_PLAN_TYPE_LIMITS: Readonly<Record<PlanType, PlanTokenLimits>>;
+/**
+ * Master lookup: plan status → token limits.
+ * For non-active statuses, limits are flat. For 'active', this returns
+ * the DEFAULT_PLAN_TYPE (BASIC) limits. Use `resolvePlanLimits()` for
+ * plan-type-aware resolution.
+ *
+ * Frozen at module load time to prevent accidental mutation.
+ */
+export declare const PLAN_LIMITS: Readonly<Record<PlanStatus, PlanTokenLimits>>;
+/**
+ * Resolves token limits for a given plan status and optional plan type.
+ *
+ * - For trial / no_subscription / expired: returns the flat limits
+ *   (planType is ignored).
+ * - For active: returns the tier-specific limits from
+ *   ACTIVE_PLAN_TYPE_LIMITS, falling back to DEFAULT_PLAN_TYPE when
+ *   planType is null/undefined.
+ *
+ * @param planStatus - The user's current plan status
+ * @param planType   - The subscription tier (only used when planStatus === 'active')
+ */
+export declare function resolvePlanLimits(planStatus: PlanStatus, planType?: PlanType | null): PlanTokenLimits;
+/**
+ * Models disabled per plan status.
+ *
+ * For no_subscription and expired: all Anthropic models (claude-*) are
+ * disabled EXCEPT haiku. Active and trial users have no restrictions.
+ *
+ * A null entry means no models are disabled for that plan status.
+ */
+export declare const DISABLED_MODELS: Readonly<Record<PlanStatus, DisabledModelRule | null>>;
+/**
+ * Error message templates for limit-exceeded scenarios.
+ * Use these to build user-facing messages consistently.
+ */
+export declare const TOKEN_LIMIT_MESSAGES: {
+    /**
+     * Shown when a model-level rolling window limit is exceeded.
+     * Placeholders: {model}, {used}, {limit}, {freeAt}
+     */
+    readonly MODEL_LIMIT_EXCEEDED: string;
+    /**
+     * Shown when the general (aggregate) rolling window limit is exceeded.
+     * Placeholders: {used}, {limit}, {freeAt}
+     */
+    readonly GENERAL_LIMIT_EXCEEDED: string;
+    /**
+     * Shown when a model is disabled for the current plan status.
+     * Placeholders: {model}
+     */
+    readonly MODEL_DISABLED: string;
+};
+//# sourceMappingURL=token-limits.d.ts.map

package/dist/constants/token-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-limits.d.ts","sourceRoot":"","sources":["../../src/constants/token-limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAM5E;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAqB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC;;;GAGG;AACH,eAAO,MAAM,qCAAqC,KAAK,CAAC;AAMxD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,4BAA4B,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AA2J5C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,CAM9E,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,CAKpE,CAAC;AAMH;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,GACzB,eAAe,CAMjB;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC,CAWjF,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;OAGG;;IAMH;;;OAGG;;IAMH;;;OAGG;;CAIK,CAAC"}

package/dist/constants/token-limits.js

@@ -0,0 +1,286 @@
+/**
+ * Unified token limit constants — single source of truth.
+ *
+ * These limits are enforced as immutable system policy. They cannot be
+ * overridden by user configuration files, environment variables, or API
+ * responses.
+ *
+ * Limit hierarchy:
+ *   1. Model disabled for plan status → blocked before any token check
+ *   2. Per-model window limit → checked per model
+ *   3. General (aggregate) window limit → checked across all models
+ *
+ * Window reset: all limits use a 6-hour window. When the window expires
+ * (Date.now() − windowStart ≥ ROLLING_WINDOW_MS), the entire state is
+ * atomically reset — all counters zeroed, windowStart set to now.
+ */
+import { DEFAULT_PLAN_TYPE } from '../types/index.js';
+// =============================================================================
+// Rolling window constants
+// =============================================================================
+/**
+ * Window duration in milliseconds (6 hours).
+ * When elapsed since windowStart, the entire usage state is reset.
+ */
+export const ROLLING_WINDOW_MS = 6 * 60 * 60 * 1000;
+/**
+ * Window duration in hours (for display purposes).
+ */
+export const ROLLING_WINDOW_HOURS = 6;
+/**
+ * Percentage of a limit at which a warning is emitted (0–100).
+ * When usage / limit >= this value, a warning is logged.
+ */
+export const TOKEN_LIMIT_WARNING_THRESHOLD_PERCENT = 90;
+// =============================================================================
+// Persistence constants
+// =============================================================================
+/**
+ * Filename for the unified usage persistence file, stored in the global
+ * Compass data directory (~/.compass/).
+ */
+export const TOKEN_LIMITS_STORE_FILENAME = 'token-limits-usage.json';
+/**
+ * File format version stored in the persistence file.
+ * Version 1 = flat counters with windowStart + atomic reset.
+ * Bump this when the on-disk schema shape changes.
+ */
+export const TOKEN_LIMITS_STORE_VERSION = 1;
+// =============================================================================
+// Per-plan token limits
+// =============================================================================
+/**
+ * Token limits for trial users.
+ * General limit: 1,000,000 tokens per rolling window.
+ * Anthropic models: 300,000 per model.
+ * Haiku: 300,000 per model.
+ * Ollama models: 700,000 per model.
+ */
+const TRIAL_LIMITS = {
+    generalLimit: 1_000_000,
+    defaultPerModelLimit: 300_000,
+    perModelLimits: {
+        // Anthropic models — 300K each (covered by defaultPerModelLimit)
+        'claude-opus-4-6': 300_000,
+        'claude-opus-4-5-20251101': 300_000,
+        'claude-sonnet-4-6': 300_000,
+        'claude-sonnet-4-5-20250929': 300_000,
+        'claude-haiku-4-5-20251001': 300_000,
+        // Ollama models — 700K each
+        'glm-5:cloud': 700_000,
+        'glm-4.7:cloud': 700_000,
+        'minimax-m2.5:cloud': 700_000,
+        'kimi-k2.5:cloud': 700_000,
+        'gemini-3-pro-preview': 700_000,
+    },
+};
+/**
+ * Token limits for users without a subscription.
+ * General limit: 150,000 tokens per rolling window.
+ * Most Anthropic models are disabled (see DISABLED_MODELS below).
+ */
+const NO_SUBSCRIPTION_LIMITS = {
+    generalLimit: 150_000,
+    defaultPerModelLimit: 150_000,
+    perModelLimits: {},
+};
+/**
+ * Token limits for users with an expired subscription.
+ * Same as no_subscription.
+ */
+const EXPIRED_LIMITS = {
+    generalLimit: 150_000,
+    defaultPerModelLimit: 150_000,
+    perModelLimits: {},
+};
+// =============================================================================
+// Per-plan-type limits for active subscribers
+// =============================================================================
+/**
+ * BASIC tier — entry-level paid plan.
+ * Opus/Sonnet 40K, Haiku 80K, others 80K.
+ */
+const ACTIVE_BASIC_LIMITS = {
+    generalLimit: Infinity,
+    defaultPerModelLimit: 80_000,
+    perModelLimits: {
+        'claude-opus-4-6': 40_000,
+        'claude-opus-4-5-20251101': 40_000,
+        'claude-sonnet-4-6': 40_000,
+        'claude-sonnet-4-5-20250929': 40_000,
+        'claude-haiku-4-5-20251001': 80_000,
+        'glm-5:cloud': 80_000,
+        'glm-4.7:cloud': 80_000,
+        'minimax-m2.5:cloud': 80_000,
+        'kimi-k2.5:cloud': 80_000,
+        'gemini-3-pro-preview': 80_000,
+    },
+};
+/**
+ * PRO tier — professional plan.
+ * Opus/Sonnet 80K, Haiku 200K, others 500K.
+ */
+const ACTIVE_PRO_LIMITS = {
+    generalLimit: Infinity,
+    defaultPerModelLimit: 500_000,
+    perModelLimits: {
+        'claude-opus-4-6': 80_000,
+        'claude-opus-4-5-20251101': 80_000,
+        'claude-sonnet-4-6': 80_000,
+        'claude-sonnet-4-5-20250929': 80_000,
+        'claude-haiku-4-5-20251001': 200_000,
+        'glm-5:cloud': 500_000,
+        'glm-4.7:cloud': 500_000,
+        'minimax-m2.5:cloud': 500_000,
+        'kimi-k2.5:cloud': 500_000,
+        'gemini-3-pro-preview': 500_000,
+    },
+};
+/**
+ * MAX tier — maximum individual plan.
+ * Opus/Sonnet 200K, Haiku 1M, others 1M.
+ */
+const ACTIVE_MAX_LIMITS = {
+    generalLimit: Infinity,
+    defaultPerModelLimit: 1_000_000,
+    perModelLimits: {
+        'claude-opus-4-6': 200_000,
+        'claude-opus-4-5-20251101': 200_000,
+        'claude-sonnet-4-6': 200_000,
+        'claude-sonnet-4-5-20250929': 200_000,
+        'claude-haiku-4-5-20251001': 1_000_000,
+        'glm-5:cloud': 1_000_000,
+        'glm-4.7:cloud': 1_000_000,
+        'minimax-m2.5:cloud': 1_000_000,
+        'kimi-k2.5:cloud': 1_000_000,
+        'gemini-3-pro-preview': 1_000_000,
+    },
+};
+/**
+ * ENTERPRISE tier — enterprise-grade limits.
+ * Opus/Sonnet 2.5M, Haiku 5M, others 5M.
+ */
+const ACTIVE_ENTERPRISE_LIMITS = {
+    generalLimit: Infinity,
+    defaultPerModelLimit: 5_000_000,
+    perModelLimits: {
+        'claude-opus-4-6': 2_500_000,
+        'claude-opus-4-5-20251101': 2_500_000,
+        'claude-sonnet-4-6': 2_500_000,
+        'claude-sonnet-4-5-20250929': 2_500_000,
+        'claude-haiku-4-5-20251001': 5_000_000,
+        'glm-5:cloud': 5_000_000,
+        'glm-4.7:cloud': 5_000_000,
+        'minimax-m2.5:cloud': 5_000_000,
+        'kimi-k2.5:cloud': 5_000_000,
+        'gemini-3-pro-preview': 5_000_000,
+    },
+};
+/**
+ * UNLIMITED tier — no token limits enforced.
+ */
+const ACTIVE_UNLIMITED_LIMITS = {
+    generalLimit: Infinity,
+    defaultPerModelLimit: Infinity,
+    perModelLimits: {},
+};
+/**
+ * Per-plan-type limits for active subscribers.
+ * Keyed by PlanType, frozen at module load time.
+ */
+export const ACTIVE_PLAN_TYPE_LIMITS = Object.freeze({
+    BASIC: Object.freeze(ACTIVE_BASIC_LIMITS),
+    PRO: Object.freeze(ACTIVE_PRO_LIMITS),
+    MAX: Object.freeze(ACTIVE_MAX_LIMITS),
+    ENTERPRISE: Object.freeze(ACTIVE_ENTERPRISE_LIMITS),
+    UNLIMITED: Object.freeze(ACTIVE_UNLIMITED_LIMITS),
+});
+/**
+ * Master lookup: plan status → token limits.
+ * For non-active statuses, limits are flat. For 'active', this returns
+ * the DEFAULT_PLAN_TYPE (BASIC) limits. Use `resolvePlanLimits()` for
+ * plan-type-aware resolution.
+ *
+ * Frozen at module load time to prevent accidental mutation.
+ */
+export const PLAN_LIMITS = Object.freeze({
+    trial: Object.freeze(TRIAL_LIMITS),
+    no_subscription: Object.freeze(NO_SUBSCRIPTION_LIMITS),
+    expired: Object.freeze(EXPIRED_LIMITS),
+    active: Object.freeze(ACTIVE_PLAN_TYPE_LIMITS[DEFAULT_PLAN_TYPE]),
+});
+// =============================================================================
+// Plan limit resolver
+// =============================================================================
+/**
+ * Resolves token limits for a given plan status and optional plan type.
+ *
+ * - For trial / no_subscription / expired: returns the flat limits
+ *   (planType is ignored).
+ * - For active: returns the tier-specific limits from
+ *   ACTIVE_PLAN_TYPE_LIMITS, falling back to DEFAULT_PLAN_TYPE when
+ *   planType is null/undefined.
+ *
+ * @param planStatus - The user's current plan status
+ * @param planType   - The subscription tier (only used when planStatus === 'active')
+ */
+export function resolvePlanLimits(planStatus, planType) {
+    if (planStatus !== 'active') {
+        return PLAN_LIMITS[planStatus];
+    }
+    const tier = planType ?? DEFAULT_PLAN_TYPE;
+    return ACTIVE_PLAN_TYPE_LIMITS[tier] ?? ACTIVE_PLAN_TYPE_LIMITS[DEFAULT_PLAN_TYPE];
+}
+// =============================================================================
+// Model disabling rules
+// =============================================================================
+/**
+ * Models disabled per plan status.
+ *
+ * For no_subscription and expired: all Anthropic models (claude-*) are
+ * disabled EXCEPT haiku. Active and trial users have no restrictions.
+ *
+ * A null entry means no models are disabled for that plan status.
+ */
+export const DISABLED_MODELS = Object.freeze({
+    trial: null,
+    active: null,
+    no_subscription: Object.freeze({
+        pattern: /^claude-/,
+        exceptions: [/haiku/],
+    }),
+    expired: Object.freeze({
+        pattern: /^claude-/,
+        exceptions: [/haiku/],
+    }),
+});
+// =============================================================================
+// Error message templates
+// =============================================================================
+/**
+ * Error message templates for limit-exceeded scenarios.
+ * Use these to build user-facing messages consistently.
+ */
+export const TOKEN_LIMIT_MESSAGES = {
+    /**
+     * Shown when a model-level rolling window limit is exceeded.
+     * Placeholders: {model}, {used}, {limit}, {freeAt}
+     */
+    MODEL_LIMIT_EXCEEDED: 'Token limit exceeded for model "{model}". ' +
+        'Used {used} / {limit} tokens in the last {window}. ' +
+        'Some quota frees up at {freeAt}.',
+    /**
+     * Shown when the general (aggregate) rolling window limit is exceeded.
+     * Placeholders: {used}, {limit}, {freeAt}
+     */
+    GENERAL_LIMIT_EXCEEDED: 'Aggregate token limit exceeded. ' +
+        'Used {used} / {limit} tokens in the last {window}. ' +
+        'Some quota frees up at {freeAt}.',
+    /**
+     * Shown when a model is disabled for the current plan status.
+     * Placeholders: {model}
+     */
+    MODEL_DISABLED: 'Model "{model}" is not available on your current plan. ' +
+        'Haiku and Ollama models are available. Upgrade for full access.',
+};
+//# sourceMappingURL=token-limits.js.map

package/dist/constants/token-limits.js.map

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

package/dist/core/autocomplete.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Auto-completion logic for slash commands, file paths, and context-aware parameter suggestions.
+ * This module provides intelligent completions for the interactive CLI experience.
+ */
+import type { AutocompleteSelectionMetadata } from '../types/autocomplete.js';
+/**
+ * Represents a single completion suggestion
+ */
+export interface CompletionResult {
+    /** The value to insert when this completion is selected */
+    value: string;
+    /** The display text shown in the completion menu */
+    display: string;
+    /** Optional description providing additional context */
+    description?: string;
+    /** The type of completion for styling/categorization */
+    type: 'command' | 'file' | 'directory' | 'option' | 'value' | 'model' | 'mode';
+    /** Whether to execute immediately when selected (for commands) */
+    executeOnComplete?: boolean;
+    /** Whether this completion item is disabled and cannot be selected */
+    disabled?: boolean;
+    /** Reason why this item is disabled (shown as tooltip/hint) */
+    disabledReason?: string;
+    /** Metadata about autocomplete selection state */
+    metadata?: AutocompleteSelectionMetadata;
+}
+/**
+ * Options for completion generation
+ */
+export interface CompletionOptions {
+    /** Maximum number of completions to return */
+    maxResults?: number;
+    /** Whether to include hidden files in file completions */
+    includeHidden?: boolean;
+    /** File patterns to exclude from completions */
+    excludePatterns?: string[];
+}
+/**
+ * Gets completions for the current input at the cursor position.
+ * Intelligently determines the completion context and returns appropriate suggestions.
+ *
+ * @param input - The current input string
+ * @param cursorPosition - The cursor position within the input
+ * @param projectRoot - The project root directory for file completions
+ * @param options - Optional completion configuration
+ * @returns A promise resolving to an array of completion suggestions
+ *
+ * @example
+ * ```typescript
+ * // Slash command completion
+ * await getCompletions('/he', 3, process.cwd());
+ * // Returns: [{ value: '/help', display: '/help', description: 'Show help menu', type: 'command' }]
+ *
+ * // File path completion
+ * await getCompletions('@src/', 5, process.cwd());
+ * // Returns file completions for the src directory
+ * ```
+ */
+export declare function getCompletions(input: string, cursorPosition: number, projectRoot?: string, options?: CompletionOptions): Promise<CompletionResult[]>;
+/**
+ * Applies a completion to the input string.
+ * Replaces the appropriate portion of the input with the completion value.
+ *
+ * @param input - The current input string
+ * @param cursorPosition - The cursor position within the input
+ * @param completion - The completion to apply
+ * @returns An object containing the new input and cursor position
+ *
+ * @example
+ * ```typescript
+ * applyCompletion('/he', 3, { value: '/help', display: '/help', type: 'command' });
+ * // Returns: { newInput: '/help', newCursorPosition: 5 }
+ *
+ * applyCompletion('@src/in', 7, { value: '@src/index.ts', display: 'index.ts', type: 'file' });
+ * // Returns: { newInput: '@src/index.ts', newCursorPosition: 13 }
+ * ```
+ */
+export declare function applyCompletion(input: string, cursorPosition: number, completion: CompletionResult): {
+    newInput: string;
+    newCursorPosition: number;
+};
+/**
+ * Gets the completion prefix from the input at the cursor position.
+ * Useful for highlighting the matching portion in completion displays.
+ *
+ * @param input - The current input string
+ * @param cursorPosition - The cursor position within the input
+ * @returns The prefix string being completed
+ */
+export declare function getCompletionPrefix(input: string, cursorPosition: number): string;
+/**
+ * Determines if completions should be shown for the current input.
+ *
+ * @param input - The current input string
+ * @param cursorPosition - The cursor position within the input
+ * @returns True if completions should be displayed
+ */
+export declare function shouldShowCompletions(input: string, cursorPosition: number): boolean;
+/**
+ * Sorts completions by relevance to the input.
+ * Exact prefix matches are ranked higher than partial matches.
+ *
+ * @param completions - The completions to sort
+ * @param input - The input to match against
+ * @returns Sorted completions array
+ */
+export declare function sortCompletionsByRelevance(completions: CompletionResult[], input: string): CompletionResult[];
+/**
+ * Gets all available slash commands for completion.
+ * Useful for displaying a full command list.
+ *
+ * @returns An array of all command completions
+ */
+export declare function getAllCommandCompletions(): CompletionResult[];
+/**
+ * Creates a completion result from basic parameters.
+ * Utility function for creating custom completions.
+ *
+ * @param value - The completion value
+ * @param description - Optional description
+ * @param type - The completion type
+ * @returns A CompletionResult object
+ */
+export declare function createCompletion(value: string, description?: string, type?: CompletionResult['type']): CompletionResult;
+/**
+ * Merges multiple completion arrays, removing duplicates.
+ *
+ * @param completionArrays - Arrays of completions to merge
+ * @returns Merged completions without duplicates
+ */
+export declare function mergeCompletions(...completionArrays: CompletionResult[][]): CompletionResult[];
+//# sourceMappingURL=autocomplete.d.ts.map

package/dist/core/autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.d.ts","sourceRoot":"","sources":["../../src/core/autocomplete.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IAC/E,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,6BAA6B,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AA6FD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,WAAW,GAAE,MAAsB,EACnC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAkB7B;AA6YD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,gBAAgB,GAC3B;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAiDjD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAsBjF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAiBpF;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,gBAAgB,EAAE,EAC/B,KAAK,EAAE,MAAM,GACZ,gBAAgB,EAAE,CAoBpB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,gBAAgB,EAAE,CAa7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,GAAE,gBAAgB,CAAC,MAAM,CAAW,GACvC,gBAAgB,CAOlB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,gBAAgB,EAAE,gBAAgB,EAAE,EAAE,GAAG,gBAAgB,EAAE,CAc9F"}