@nextsparkjs/core 0.1.0-beta.75 → 0.1.0-beta.76

package/dist/lib/entities/registry.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Entity Registry System
+ *
+ * Central registry for managing entity configurations with comprehensive filtering,
+ * permission checking, plan limits validation, and child entity support.
+ *
+ * MIGRATION: Now uses build-time registries (THEME_REGISTRY, PLUGIN_REGISTRY)
+ * for zero runtime I/O and ~17,255x performance improvement
+ *
+ * SERVER-ONLY: This module is server-side only. Client components receive
+ * entity configs as props from server components.
+ */
+import 'server-only';
+import type { EntityConfig, EntityLimits, EntityAccessResult, EntityUsageStats, CRUDOperation, PlanType, UserFlag, ChildEntityConfig, ChildEntityDefinition } from './types';
+import type { UserRole } from '../../types/user.types';
+/**
+ * EntityRegistry - Central management system for all entities
+ *
+ * ARCHITECTURE: This class is now a FACADE that delegates to the singleton
+ * in queries.ts. There is NO internal Map - all data comes from the shared
+ * singleton which is populated by the layout via setEntityRegistry().
+ *
+ * This unification ensures:
+ * - API handlers see the same entities as client components
+ * - Works in both monorepo and npm modes
+ * - No require() calls that fail in pre-compiled npm packages
+ */
+export declare class EntityRegistry {
+    /**
+     * Register a new entity configuration
+     * Adds to the singleton in queries.ts
+     */
+    register(config: EntityConfig): void;
+    /**
+     * Get entity configuration by slug
+     * Delegates to singleton in queries.ts
+     */
+    get(slug: string): EntityConfig | undefined;
+    /**
+     * Get entity configuration by slug (alias for get)
+     */
+    getBySlug(slug: string): EntityConfig | undefined;
+    /**
+     * Get all registered entities
+     * Delegates to singleton in queries.ts
+     */
+    getAll(): EntityConfig[];
+    /**
+     * Get only enabled entities
+     */
+    getEnabled(): EntityConfig[];
+    /**
+     * Get entities that have a specific feature enabled
+     */
+    getByFeature(feature: keyof EntityConfig['ui']['features']): EntityConfig[];
+    /**
+     * Get effective limits for user (returns unlimited for now since plans are not enforced)
+     */
+    getEffectiveLimits(entityName: string, planType: PlanType, userFlags?: UserFlag[]): EntityLimits;
+    /**
+     * Get child entities configuration for a parent entity
+     */
+    getChildEntities(parentEntityName: string): ChildEntityConfig | undefined;
+    /**
+     * Get specific child entity configuration
+     */
+    getChildConfig(parentEntityName: string, childName: string): ChildEntityDefinition | undefined;
+    /**
+     * Check if entity has child entities
+     */
+    hasChildEntities(entityName: string): boolean;
+    /**
+     * Get child entities for API inclusion based on requested children
+     */
+    getChildrenForAPI(parentEntityName: string, includedChildren?: string[]): ChildEntityDefinition[];
+    /**
+     * Validate entity configuration
+     */
+    private validateConfiguration;
+    /**
+     * Get detailed access result for user and entity (excluding plan validation)
+     */
+    getAccessResult(entityName: string, action: CRUDOperation, userRole: UserRole, planType: PlanType, userFlags?: UserFlag[]): EntityAccessResult;
+    /**
+     * Check if user is at or near entity limits
+     */
+    checkLimits(entityName: string, planType: PlanType, currentUsage: EntityUsageStats, userFlags?: UserFlag[]): {
+        withinLimits: boolean;
+        warnings: string[];
+        errors: string[];
+    };
+    /**
+     * Initialize registry
+     *
+     * ARCHITECTURE: This is now a NO-OP for backwards compatibility.
+     * The singleton in queries.ts is populated by:
+     * - Server: The layout imports registry and calls setEntityRegistry()
+     * - Client: DashboardShell calls setServerEntities() during hydration
+     *
+     * The EntityRegistry class is a facade - it doesn't need initialization.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get registry statistics
+     */
+    getStats(): {
+        totalEntities: number;
+        enabledEntities: number;
+        entitiesWithChildren: number;
+        entitiesWithExternalAPI: number;
+    };
+    /**
+     * Update an existing entity configuration
+     * Delegates to singleton in queries.ts
+     */
+    updateEntity(slug: string, updates: Partial<EntityConfig>): void;
+    /**
+     * Remove an entity from the registry
+     * Delegates to singleton in queries.ts
+     */
+    removeEntity(slug: string): void;
+    /**
+     * Export all entity configurations
+     */
+    exportConfigs(): EntityConfig[];
+    /**
+     * Import entity configurations
+     */
+    importConfigs(configs: EntityConfig[]): void;
+    /**
+     * Check if registry is initialized
+     * Delegates to singleton in queries.ts
+     */
+    isInitialized(): boolean;
+    /**
+     * Reset the registry (alias for clear)
+     */
+    reset(): void;
+    /**
+     * Clear all registered entities (mainly for testing)
+     * Delegates to singleton in queries.ts
+     */
+    clear(): void;
+}
+export declare const entityRegistry: EntityRegistry;
+export declare function registerEntity(config: EntityConfig): void;
+export declare function getEntityConfig(name: string): EntityConfig | undefined;
+export declare function getEnabledEntities(): EntityConfig[];
+export declare function getEntityLimits(entityName: string, planType: PlanType, userFlags?: UserFlag[]): EntityLimits;
+/**
+ * Ensure the entity registry is fully initialized
+ * MIGRATION: Now uses build-time registries (zero runtime I/O)
+ */
+export declare function ensureInitialized(): Promise<void>;
+/**
+ * Get all entity configurations (includes theme and plugin entities)
+ */
+export declare function getAllEntityConfigs(): EntityConfig[];
+/**
+ * Get registry statistics
+ * MIGRATION: Now shows entities from theme and plugin registries
+ */
+export declare function getRegistryStats(): {
+    totalEntities: number;
+    enabledEntities: number;
+    initialized: boolean;
+    source: string;
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/lib/entities/registry.d.ts.map

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

package/dist/lib/entities/schema-generator.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Schema Auto-Generation System
+ *
+ * Automatically generates Zod validation schemas from entity field definitions.
+ * Supports create, update, and response schemas with child entities.
+ */
+import { z } from 'zod';
+import type { EntityConfig } from './types';
+export interface SchemaGenerationOptions {
+    includeReadOnly?: boolean;
+    includeChildEntities?: boolean;
+    customValidation?: Record<string, z.ZodSchema>;
+    strict?: boolean;
+}
+export interface GeneratedSchemas {
+    create: z.ZodSchema;
+    update: z.ZodSchema;
+    response: z.ZodSchema;
+    list: z.ZodSchema;
+    childSchemas?: Record<string, z.ZodSchema>;
+}
+/**
+ * Generate all schemas for an entity
+ */
+export declare function generateEntitySchemas(entityConfig: EntityConfig, options?: SchemaGenerationOptions): GeneratedSchemas;
+/**
+ * Generate TypeScript types from schemas
+ */
+export declare function generateTypeScriptTypes(entityConfig: EntityConfig, schemas: GeneratedSchemas): string;
+/**
+ * Validate data against entity schema
+ */
+export declare function validateEntityData(entityConfig: EntityConfig, data: unknown, schemaType?: 'create' | 'update' | 'response', options?: SchemaGenerationOptions): {
+    success: true;
+    data: unknown;
+} | {
+    success: false;
+    errors: z.ZodError;
+};
+/**
+ * Generate schema documentation in markdown format
+ */
+export declare function generateSchemaDocumentation(entityConfig: EntityConfig): string;
+export interface BuilderValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate an EntityConfig that has builder.enabled = true
+ * Ensures required fields exist for page builder functionality
+ */
+export declare function validateBuilderEntityConfig(entityConfig: EntityConfig): BuilderValidationResult;
+/**
+ * Validate TaxonomiesConfig
+ */
+export declare function validateTaxonomiesConfig(entityConfig: EntityConfig): BuilderValidationResult;
+/**
+ * Get all entities with builder.enabled from a registry
+ */
+export declare function getBuilderEntities(registry: Record<string, EntityConfig>): EntityConfig[];
+/**
+ * Get the effective basePath for an entity
+ * Reads from access.basePath (new) with fallback to builder.public.basePath (deprecated)
+ */
+export declare function getEntityBasePath(entity: EntityConfig): string | undefined;
+/**
+ * Match a URL path to an entity based on access.basePath
+ * Uses longest-match strategy to handle nested paths
+ *
+ * @param path - The URL path to match (e.g., '/blog/my-post', '/about')
+ * @param registry - Entity registry to search
+ * @returns Match result with entity, slug, and optional isArchive flag
+ */
+export declare function matchPathToEntity(path: string, registry: Record<string, EntityConfig>): {
+    entity: EntityConfig;
+    slug: string;
+    isArchive?: boolean;
+} | null;
+//# sourceMappingURL=schema-generator.d.ts.map

package/dist/lib/entities/schema-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-generator.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/schema-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,YAAY,EAAsC,MAAM,SAAS,CAAA;AAE/E,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAA;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,CAAC,SAAS,CAAA;IACnB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAA;IACnB,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAA;IACrB,IAAI,EAAE,CAAC,CAAC,SAAS,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAA;CAC3C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CA+FlB;AA2vBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAeR;AASD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,OAAO,EACb,UAAU,GAAE,QAAQ,GAAG,QAAQ,GAAG,UAAqB,EACvD,OAAO,GAAE,uBAA4B,GACpC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,CAW3E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,YAAY,GACzB,MAAM,CAyCR;AAMD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAOD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,YAAY,GAAG,uBAAuB,CAsE/F;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,uBAAuB,CA6C5F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC,YAAY,EAAE,CAIhB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAE1E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAuCpE"}

package/dist/lib/entities/serialization.d.ts

@@ -0,0 +1,18 @@
+import type { EntityConfig, ChildEntityDefinition } from './types';
+export interface SerializableEntityConfig extends Omit<EntityConfig, 'icon' | 'i18n'> {
+    iconName: string;
+    i18nFallbackLocale: string;
+}
+export interface SerializableChildEntityConfig extends Omit<ChildEntityDefinition, 'icon' | 'i18n'> {
+    iconName: string;
+    i18nFallbackLocale: string;
+}
+export type SerializableConfig = SerializableEntityConfig | SerializableChildEntityConfig;
+export declare function serializeEntityConfig(config: EntityConfig): SerializableEntityConfig;
+export declare function serializeChildEntityConfig(config: ChildEntityDefinition): SerializableChildEntityConfig;
+export declare function serializeConfig(config: EntityConfig | ChildEntityDefinition): SerializableConfig;
+export declare function deserializeEntityConfig(config: SerializableEntityConfig): EntityConfig;
+export declare function deserializeChildEntityConfig(config: SerializableChildEntityConfig): ChildEntityDefinition;
+export declare function serializeEntities(entities: (EntityConfig | ChildEntityDefinition)[]): SerializableConfig[];
+export declare function deserializeEntities(entities: SerializableConfig[]): (EntityConfig | ChildEntityDefinition)[];
+//# sourceMappingURL=serialization.d.ts.map

package/dist/lib/entities/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAsC,MAAM,SAAS,CAAA;AAItG,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IACnF,QAAQ,EAAE,MAAM,CAAA;IAChB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,6BAA8B,SAAQ,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,MAAM,CAAC;IACjG,QAAQ,EAAE,MAAM,CAAA;IAChB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG,6BAA6B,CAAA;AAUzF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,wBAAwB,CAYpF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,GAAG,6BAA6B,CAQvG;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,qBAAqB,GAAG,kBAAkB,CAMhG;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,wBAAwB,GAAG,YAAY,CAYtF;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,6BAA6B,GAAG,qBAAqB,CAQzG;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,CAAC,YAAY,GAAG,qBAAqB,CAAC,EAAE,GAAG,kBAAkB,EAAE,CAE1G;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,CAAC,YAAY,GAAG,qBAAqB,CAAC,EAAE,CAQ5G"}

package/dist/lib/entities/system-fields.d.ts

@@ -0,0 +1,56 @@
+/**
+ * System Fields Configuration
+ *
+ * These fields are implicit in ALL entities and should NEVER be declared
+ * in entity field configurations. They are:
+ * - Always present in database tables
+ * - Always returned in API responses
+ * - Always available for sorting
+ * - Shown in metadata sections of detail views
+ * - Never shown in forms (managed by database)
+ */
+import type { EntityField } from './types';
+/**
+ * All system field names that are implicit in every entity
+ */
+export declare const SYSTEM_FIELD_NAMES: readonly ["id", "createdAt", "updatedAt", "userId", "teamId"];
+export type SystemFieldName = (typeof SYSTEM_FIELD_NAMES)[number];
+/**
+ * Fields that are implicitly available for sorting even if not in config
+ */
+export declare const IMPLICIT_SORTABLE_FIELDS: readonly ["createdAt", "updatedAt"];
+export type ImplicitSortableField = (typeof IMPLICIT_SORTABLE_FIELDS)[number];
+/**
+ * Virtual field definitions for createdAt/updatedAt
+ * Used by frontend components to render these fields consistently
+ */
+export declare const SYSTEM_TIMESTAMP_FIELDS: EntityField[];
+/**
+ * Check if a field name is a system field
+ */
+export declare function isSystemField(fieldName: string): boolean;
+/**
+ * Check if a field name is an implicit timestamp field
+ */
+export declare function isImplicitTimestampField(fieldName: string): boolean;
+/**
+ * Get system timestamp field definition by name
+ * Returns the field definition if found, null otherwise
+ */
+export declare function getSystemTimestampField(fieldName: string): EntityField | null;
+/**
+ * Builder-specific system fields (conditional)
+ * These are only valid for entities with builder.enabled = true
+ */
+export declare const BUILDER_SYSTEM_FIELD_NAMES: readonly ["blocks"];
+export type BuilderSystemFieldName = (typeof BUILDER_SYSTEM_FIELD_NAMES)[number];
+/**
+ * Virtual field definition for blocks (builder entities only)
+ * This field is automatically available for entities with builder.enabled = true
+ */
+export declare const BUILDER_BLOCKS_FIELD: EntityField;
+/**
+ * Check if a field is a builder-specific system field
+ */
+export declare function isBuilderSystemField(fieldName: string): boolean;
+//# sourceMappingURL=system-fields.d.ts.map

package/dist/lib/entities/system-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-fields.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/system-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C;;GAEG;AACH,eAAO,MAAM,kBAAkB,+DAAgE,CAAA;AAE/F,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjE;;GAEG;AACH,eAAO,MAAM,wBAAwB,qCAAsC,CAAA;AAE3E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7E;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAAW,EAqChD,CAAA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAE7E;AAMD;;;GAGG;AACH,eAAO,MAAM,0BAA0B,qBAAsB,CAAA;AAE7D,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAkBlC,CAAA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE/D"}

package/dist/lib/entities/testing.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Entity System Testing Utilities
+ *
+ * Comprehensive testing utilities for the WordPress-like Entity System.
+ * Includes mock generators, test helpers, and validation utilities.
+ */
+import type { EntityConfig, EntityField, PlanType, UserFlag } from './types';
+import type { UserRole } from '../../types/user.types';
+/**
+ * Generate mock entity configuration for testing
+ */
+export declare function createMockEntityConfig(overrides?: Partial<EntityConfig>): EntityConfig;
+/**
+ * Generate mock entity data for testing
+ */
+export declare function createMockEntityData(entityConfig: EntityConfig, count?: number): Record<string, unknown>[];
+/**
+ * Generate mock value for a specific field
+ */
+export declare function generateMockFieldValue(field: EntityField): unknown;
+/**
+ * Create mock user for testing permissions
+ */
+export declare function createMockUser(role?: UserRole, plan?: PlanType, flags?: UserFlag[]): {
+    id: string;
+    role: any;
+    plan: PlanType;
+    flags: UserFlag[];
+    email: string;
+};
+/**
+ * Test entity configuration validation
+ */
+export declare function validateEntityConfig(config: EntityConfig): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Test entity access system (permission system removed)
+ */
+export declare function testEntityAccess(entityConfig: EntityConfig): {
+    passed: boolean;
+    results: Array<{
+        test: string;
+        passed: boolean;
+        message: string;
+    }>;
+};
+/**
+ * Performance test for entity operations
+ */
+export declare function performanceTestEntity(entityConfig: EntityConfig, operations?: Array<'create' | 'read' | 'update' | 'delete'>): Promise<{
+    operation: string;
+    averageTime: number;
+    minTime: number;
+    maxTime: number;
+    iterations: number;
+}[]>;
+/**
+ * Integration test for complete entity workflow
+ */
+export declare function integrationTestEntity(entityConfig: EntityConfig): Promise<{
+    passed: boolean;
+    steps: Array<{
+        step: string;
+        passed: boolean;
+        duration: number;
+        error?: string;
+    }>;
+}>;
+/**
+ * Clean up test entities from registry
+ */
+export declare function cleanupTestEntities(): void;
+/**
+ * Generate comprehensive test report
+ */
+export declare function generateTestReport(entityConfig: EntityConfig, validationResults: ReturnType<typeof validateEntityConfig>, accessResults: ReturnType<typeof testEntityAccess>, integrationResults: Awaited<ReturnType<typeof integrationTestEntity>>): string;
+//# sourceMappingURL=testing.d.ts.map

package/dist/lib/entities/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/testing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,QAAQ,EACT,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAKtD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,YAAY,CAwF1F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAkB7G;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAoDlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,GAAE,QAAmB,EACzB,IAAI,GAAE,QAAiB,EACvB,KAAK,GAAE,QAAQ,EAAO;;;;;;EASvB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA8C/F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG;IAC5D,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,OAAO,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;KAChB,CAAC,CAAA;CACH,CAiCA;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,YAAY,EAC1B,UAAU,GAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAA0C,GAClG,OAAO,CAAC;IACT,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB,EAAE,CAAC,CA+CH;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC;IAC/E,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,OAAO,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAC,CAAA;CACH,CAAC,CAqFD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAkB1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,YAAY,EAC1B,iBAAiB,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,EAC1D,aAAa,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAClD,kBAAkB,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,GACpE,MAAM,CA6DR"}