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

package/dist/types/api-presets.d.ts

@@ -0,0 +1,138 @@
+/**
+ * API Presets Type Definitions
+ *
+ * Types for the API preset system in DevTools.
+ * Presets are pre-configured request examples for API endpoints.
+ *
+ * Sources (by priority):
+ * 1. Theme custom routes: {theme}/app/api/**\/presets.ts and docs.md
+ * 2. Entity folders: {theme}/entities/*\/api/presets.ts and docs.md
+ * 3. Core routes: packages/core/templates/app/api/**\/presets.ts and docs.md
+ *
+ * Registry generates:
+ * - api-presets-registry.ts - Presets organized by endpoint
+ * - api-docs-registry.ts - Documentation paths by endpoint
+ */
+import type { HttpMethod, AuthType } from '../components/devtools/api-tester/types';
+/**
+ * Session configuration for a preset
+ */
+export interface PresetSessionConfig {
+    /** Enable cross-team access (admin bypass) */
+    crossTeam?: boolean;
+    /** Team ID to use (supports placeholders like {{FIRST_TEAM_ID}}) */
+    teamId?: string;
+    /** Auth type override */
+    authType?: AuthType;
+}
+/**
+ * Individual preset definition
+ */
+export interface ApiPreset {
+    /** Unique ID within the endpoint */
+    id: string;
+    /** Display title */
+    title: string;
+    /** Optional description */
+    description?: string;
+    /** HTTP method for this preset */
+    method: HttpMethod;
+    /** Path suffix for sub-routes (e.g., '/{id}', '/{id}/child/{childType}') */
+    path?: string;
+    /** Path parameters (for dynamic segments like [id]) */
+    pathParams?: Record<string, string>;
+    /** Query parameters */
+    params?: Record<string, string | number | boolean>;
+    /** Query parameters (alias for params) */
+    queryParams?: Record<string, string | number | boolean>;
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** Request body (for POST/PATCH/PUT) */
+    payload?: Record<string, unknown>;
+    /** Session/auth configuration */
+    sessionConfig?: PresetSessionConfig;
+    /** Tags for filtering/grouping */
+    tags?: string[];
+}
+/** Source of presets/docs: entity folder, theme route, or core route */
+export type ApiPresetSource = 'entity' | 'route' | 'core';
+/**
+ * Endpoint preset configuration (exported from .presets.ts files)
+ */
+export interface ApiEndpointPresets {
+    /** Endpoint path or glob pattern (optional for entity presets - derived from folder name) */
+    endpoint?: string;
+    /** Short summary of the endpoint */
+    summary?: string;
+    /** Array of presets for this endpoint */
+    presets: ApiPreset[];
+    /** Source file path (added by discovery) */
+    sourcePath?: string;
+    /** Source type: 'entity' | 'route' | 'core' (added by discovery) */
+    source?: ApiPresetSource;
+}
+/**
+ * Registry structure for API presets
+ */
+export interface ApiPresetsRegistryStructure {
+    /** Map of endpoint path to presets config */
+    endpoints: Record<string, ApiEndpointPresets>;
+    /** Metadata */
+    meta: {
+        totalEndpoints: number;
+        totalPresets: number;
+        generatedAt: string;
+        themeName: string;
+    };
+}
+/**
+ * Single documentation entry
+ */
+export interface ApiDocEntry {
+    /** Import path to the markdown file */
+    path: string;
+    /** Document title (extracted from markdown) */
+    title: string;
+    /** Associated endpoint */
+    endpoint: string;
+    /** Source type: 'entity' | 'route' | 'core' (added by discovery) */
+    source?: ApiPresetSource;
+}
+/**
+ * Registry structure for API documentation
+ */
+export interface ApiDocsRegistryStructure {
+    /** Map of endpoint path to doc entry */
+    docs: Record<string, ApiDocEntry>;
+    /** Metadata */
+    meta: {
+        totalDocs: number;
+        generatedAt: string;
+        themeName: string;
+    };
+}
+/**
+ * Helper function to define API endpoint presets with full type safety.
+ * Use this in your .presets.ts files.
+ *
+ * @example
+ * ```typescript
+ * // contents/themes/default/devtools/api/customers.presets.ts
+ * import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+ *
+ * export default defineApiEndpoint({
+ *   endpoint: '/api/v1/customers',
+ *   summary: 'Customer management endpoints',
+ *   presets: [
+ *     {
+ *       id: 'list-active',
+ *       title: 'List Active Customers',
+ *       method: 'GET',
+ *       params: { status: 'active' }
+ *     }
+ *   ]
+ * })
+ * ```
+ */
+export declare function defineApiEndpoint(config: Omit<ApiEndpointPresets, 'sourcePath'>): Omit<ApiEndpointPresets, 'sourcePath'>;
+//# sourceMappingURL=api-presets.d.ts.map

package/dist/types/api-presets.d.ts.map

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

package/dist/types/auth.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Authentication provider types
+ */
+export type AuthProvider = 'email' | 'google';
+export type AuthProviderWithNull = AuthProvider | null;
+/**
+ * Error code mapping for authentication errors
+ */
+export type AuthErrorCode = 'INVALID_CREDENTIALS' | 'USER_NOT_FOUND' | 'EMAIL_NOT_VERIFIED' | 'ACCOUNT_LOCKED' | 'RATE_LIMITED' | 'OAUTH_ERROR' | 'NETWORK_ERROR' | 'SERVER_ERROR' | 'UNKNOWN_ERROR';
+/**
+ * Authentication error with code mapping
+ */
+export interface AuthError extends Error {
+    code?: AuthErrorCode;
+}
+/**
+ * Authentication method type (alias for AuthProviderWithNull for backward compatibility)
+ */
+export type AuthMethod = AuthProviderWithNull;
+//# sourceMappingURL=auth.d.ts.map

package/dist/types/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/types/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAA;AAC7C,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,IAAI,CAAA;AAEtD;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,qBAAqB,GACrB,gBAAgB,GAChB,oBAAoB,GACpB,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,eAAe,GACf,cAAc,GACd,eAAe,CAAA;AAEnB;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,KAAK;IACtC,IAAI,CAAC,EAAE,aAAa,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,oBAAoB,CAAA"}

package/dist/types/blocks.d.ts

@@ -0,0 +1,396 @@
+/**
+ * Block System Types
+ *
+ * Type definitions for the dynamic block editor system.
+ * Supports WordPress/Webflow-style page building with reusable blocks.
+ */
+import { z } from 'zod';
+/**
+ * CTA (Call-to-Action) Schema
+ * Used for buttons/links in Content tab
+ */
+export declare const ctaSchema: z.ZodObject<{
+    text: z.ZodString;
+    link: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    target: z.ZodDefault<z.ZodEnum<{
+        _self: "_self";
+        _blank: "_blank";
+    }>>;
+}, z.core.$strip>;
+export type CTAConfig = z.infer<typeof ctaSchema>;
+/**
+ * Base Content Schema
+ * Tab 1: Content - Common content fields for all blocks
+ * All fields are optional to allow flexibility
+ *
+ * Note: `content` is the unified field for descriptive text
+ * (replaces previous description/subtitle fields)
+ */
+export declare const baseContentSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    cta: z.ZodOptional<z.ZodObject<{
+        text: z.ZodString;
+        link: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        target: z.ZodDefault<z.ZodEnum<{
+            _self: "_self";
+            _blank: "_blank";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BaseContentProps = z.infer<typeof baseContentSchema>;
+/**
+ * Background Color Options
+ * Predefined theme-aware color options
+ */
+export declare const backgroundColorOptions: readonly ["transparent", "white", "gray-50", "gray-100", "gray-900", "primary", "primary-light", "primary-dark", "secondary", "accent"];
+export type BackgroundColor = (typeof backgroundColorOptions)[number];
+/**
+ * Base Design Schema
+ * Tab 2: Design - Visual/styling options
+ */
+export declare const baseDesignSchema: z.ZodObject<{
+    backgroundColor: z.ZodDefault<z.ZodEnum<{
+        primary: "primary";
+        secondary: "secondary";
+        accent: "accent";
+        transparent: "transparent";
+        white: "white";
+        "gray-50": "gray-50";
+        "gray-100": "gray-100";
+        "gray-900": "gray-900";
+        "primary-light": "primary-light";
+        "primary-dark": "primary-dark";
+    }>>;
+}, z.core.$strip>;
+export type BaseDesignProps = z.infer<typeof baseDesignSchema>;
+/**
+ * Base Advanced Schema
+ * Tab 3: Advanced - Technical/developer options
+ */
+export declare const baseAdvancedSchema: z.ZodObject<{
+    className: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BaseAdvancedProps = z.infer<typeof baseAdvancedSchema>;
+/**
+ * Combined Base Block Schema
+ * Merges all three tab schemas for complete block props
+ */
+export declare const baseBlockSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    cta: z.ZodOptional<z.ZodObject<{
+        text: z.ZodString;
+        link: z.ZodUnion<[z.ZodString, z.ZodString]>;
+        target: z.ZodDefault<z.ZodEnum<{
+            _self: "_self";
+            _blank: "_blank";
+        }>>;
+    }, z.core.$strip>>;
+    backgroundColor: z.ZodDefault<z.ZodEnum<{
+        primary: "primary";
+        secondary: "secondary";
+        accent: "accent";
+        transparent: "transparent";
+        white: "white";
+        "gray-50": "gray-50";
+        "gray-100": "gray-100";
+        "gray-900": "gray-900";
+        "primary-light": "primary-light";
+        "primary-dark": "primary-dark";
+    }>>;
+    className: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BaseBlockProps = z.infer<typeof baseBlockSchema>;
+/**
+ * Get CSS classes for background color
+ * Maps backgroundColor prop to Tailwind classes
+ */
+export declare function getBackgroundClasses(backgroundColor?: BackgroundColor): string;
+/**
+ * Get section attributes from advanced props
+ * Returns object for spreading onto section element
+ */
+export declare function getSectionAttributes(props: BaseAdvancedProps): {
+    id?: string;
+    className?: string;
+};
+/**
+ * Build complete section class string
+ * Combines background classes, custom className, and base section styles
+ */
+export declare function buildSectionClasses(baseClasses: string, props: Partial<BaseDesignProps & BaseAdvancedProps>): string;
+/**
+ * Field tab identifier
+ */
+export type FieldTab = 'content' | 'design' | 'advanced';
+/**
+ * Base field definitions for Content tab
+ * These can be spread into any block's fieldDefinitions array
+ *
+ * Note: `content` is the unified rich-text field for descriptive text
+ * (replaces previous description/subtitle fields)
+ */
+export declare const baseContentFields: FieldDefinition[];
+/**
+ * Base field definitions for Design tab
+ */
+export declare const baseDesignFields: FieldDefinition[];
+/**
+ * Base field definitions for Advanced tab
+ */
+export declare const baseAdvancedFields: FieldDefinition[];
+/**
+ * All base fields combined
+ * Includes Content + Design + Advanced fields
+ */
+export declare const allBaseFields: FieldDefinition[];
+/**
+ * Helper to create block field definitions
+ * Combines base fields with block-specific fields
+ */
+export declare function createBlockFieldDefinitions(blockSpecificFields: FieldDefinition[]): FieldDefinition[];
+/**
+ * Field types supported by the dynamic form generator
+ */
+export type FieldType = 'text' | 'textarea' | 'url' | 'email' | 'number' | 'color' | 'image' | 'select' | 'checkbox' | 'radio' | 'rich-text' | 'array' | 'date' | 'time' | 'datetime';
+/**
+ * Field definition for dynamic form generation
+ * Describes a single configurable property of a block
+ */
+export interface FieldDefinition {
+    name: string;
+    label: string;
+    type: FieldType;
+    tab: FieldTab;
+    required?: boolean;
+    default?: unknown;
+    placeholder?: string;
+    description?: string;
+    helpText?: string;
+    minLength?: number;
+    maxLength?: number;
+    rows?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    checkboxLabel?: string;
+    accept?: string;
+    maxSize?: number;
+    aspectRatio?: string;
+    itemType?: FieldType;
+    itemFields?: FieldDefinition[];
+    minItems?: number;
+    maxItems?: number;
+    condition?: {
+        field: string;
+        operator: 'equals' | 'notEquals' | 'contains' | 'greaterThan' | 'lessThan';
+        value: unknown;
+    };
+    group?: string;
+    groupLabel?: string;
+}
+/**
+ * Block category for organization
+ */
+export type BlockCategory = 'hero' | 'content' | 'features' | 'cta' | 'testimonials' | 'media' | 'forms' | 'navigation' | 'footer' | 'pricing' | 'team' | 'stats' | 'faq' | 'newsletter' | 'other';
+/**
+ * Block example instance for DevTools preview
+ */
+export interface BlockExample {
+    /** Display name for the example (e.g., "Default", "Dark Background") */
+    name: string;
+    /** Optional description of what this example demonstrates */
+    description?: string;
+    /** Complete props to render this example */
+    props: Record<string, unknown>;
+}
+/**
+ * Block configuration (metadata about a block type)
+ */
+export interface BlockConfig {
+    slug: string;
+    name: string;
+    description: string;
+    category: BlockCategory;
+    icon?: string;
+    componentPath?: string;
+    schemaPath?: string;
+    fieldsPath?: string;
+    thumbnail?: string;
+    fieldDefinitions: FieldDefinition[];
+    examples: BlockExample[];
+    scope?: Array<'pages' | 'posts' | string>;
+    /**
+     * Whether this block can be used inside patterns.
+     * Default: true (blocks are allowed in patterns by default)
+     * Set to false for blocks that should not be included in patterns.
+     */
+    allowInPatterns?: boolean;
+    schemaType?: string;
+    tags?: string[];
+    isCore?: boolean;
+    source?: 'core' | 'theme' | 'plugin';
+    sourceId?: string;
+    version?: string;
+    deprecated?: boolean;
+    replacedBy?: string;
+}
+/**
+ * Block instance (actual block used in a page)
+ */
+export interface BlockInstance<TProps = Record<string, unknown>> {
+    id: string;
+    blockSlug: string;
+    props: TProps;
+    order?: number;
+}
+/**
+ * Page status for publication workflow
+ * Extensible: can add 'scheduled', 'archived', 'pending_review' etc.
+ */
+export type PageStatus = 'draft' | 'published' | 'scheduled' | 'archived' | string;
+/**
+ * Page metadata
+ */
+export interface PageMetadata {
+    title: string;
+    slug: string;
+    locale: string;
+    /** Publication status (replaces published boolean) */
+    status: PageStatus;
+    createdAt?: Date | string;
+    updatedAt?: Date | string;
+    authorId?: string;
+}
+/**
+ * Page SEO configuration
+ */
+export interface PageSEO {
+    title?: string;
+    description?: string;
+    keywords?: string;
+    ogImage?: string;
+    ogType?: 'website' | 'article' | 'product';
+    canonical?: string;
+    noindex?: boolean;
+    nofollow?: boolean;
+}
+/**
+ * Complete page configuration
+ */
+export interface PageConfig {
+    id: string;
+    slug: string;
+    title: string;
+    blocks: BlockInstance[];
+    locale: string;
+    /** Publication status (replaces published boolean) */
+    status: PageStatus;
+    seo?: PageSEO;
+    createdAt: Date | string;
+    updatedAt: Date | string;
+    authorId?: string;
+    themeSource?: string;
+    templateId?: string;
+    templateName?: string;
+}
+/**
+ * Page template for quick page creation
+ */
+export interface PageTemplate {
+    id: string;
+    name: string;
+    description?: string;
+    blocks: Omit<BlockInstance, 'id'>[];
+    thumbnail?: string;
+    category?: 'basic' | 'company' | 'marketing' | 'ecommerce' | 'other';
+    tags?: string[];
+}
+/**
+ * Validation result for block props
+ */
+export interface BlockValidationResult {
+    valid: boolean;
+    errors?: Array<{
+        field: string;
+        message: string;
+    }>;
+}
+/**
+ * Block registry entry (used by build-registry.mjs)
+ */
+export type BlockRegistry = Record<string, BlockConfig>;
+/**
+ * API response types
+ */
+export interface BlocksListResponse {
+    blocks: BlockConfig[];
+    categories: BlockCategory[];
+    total: number;
+}
+export interface BlockDetailResponse {
+    block: BlockConfig;
+}
+export interface BlockValidateRequest {
+    blockSlug: string;
+    props: Record<string, unknown>;
+}
+export interface BlockValidateResponse {
+    valid: boolean;
+    errors?: Record<string, string[]>;
+}
+export interface PagesListResponse {
+    pages: PageConfig[];
+    total: number;
+    page: number;
+    limit: number;
+    hasMore: boolean;
+}
+export interface PageDetailResponse {
+    page: PageConfig;
+}
+export interface CreatePageRequest {
+    slug: string;
+    title: string;
+    blocks?: BlockInstance[];
+    locale?: string;
+    /** Publication status (default: 'draft') */
+    status?: PageStatus;
+    seo?: PageSEO;
+    templateId?: string;
+}
+export interface UpdatePageRequest {
+    slug?: string;
+    title?: string;
+    blocks?: BlockInstance[];
+    /** Publication status */
+    status?: PageStatus;
+    seo?: PageSEO;
+}
+export interface ValidateSlugRequest {
+    slug: string;
+    locale?: string;
+    currentPageId?: string;
+}
+export interface ValidateSlugResponse {
+    valid: boolean;
+    available: boolean;
+    error?: string;
+    suggestions?: string[];
+}
+/**
+ * Type guard to check if a value is a valid BlockInstance
+ */
+export declare function isBlockInstance(value: unknown): value is BlockInstance;
+/**
+ * Type guard to check if a value is a valid BlockConfig
+ */
+export declare function isBlockConfig(value: unknown): value is BlockConfig;
+//# sourceMappingURL=blocks.d.ts.map

package/dist/types/blocks.d.ts.map

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

package/dist/types/docs.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Documentation Registry Types
+ *
+ * Type definitions for the documentation registry system.
+ * Used by the auto-generated docs-registry.ts file.
+ *
+ * Structure:
+ * - public: User-facing documentation → /docs
+ * - superadmin: Admin documentation → /superadmin/docs
+ *
+ * NOTE: Plugin docs are NOT included in the registry - they are for developer
+ * reference only (IDE/LLM). End users see public documentation at /docs routes.
+ */
+export interface DocPageMeta {
+    slug: string;
+    title: string;
+    order: number;
+    path: string;
+    source: 'public' | 'superadmin';
+}
+export interface DocSectionMeta {
+    title: string;
+    slug: string;
+    order: number;
+    pages: DocPageMeta[];
+    source: 'public' | 'superadmin';
+}
+export interface DocsRegistryStructure {
+    public: DocSectionMeta[];
+    superadmin: DocSectionMeta[];
+    all: DocSectionMeta[];
+}
+//# sourceMappingURL=docs.d.ts.map

package/dist/types/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/types/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,QAAQ,GAAG,YAAY,CAAA;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,MAAM,EAAE,QAAQ,GAAG,YAAY,CAAA;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,GAAG,EAAE,cAAc,EAAE,CAAA;CACtB"}

package/dist/types/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Centralized type exports
+ * Barrel file for easy importing across the application
+ */
+export type { Task, SearchableTask, TaskPriority, TaskCategory, TaskCategoryType, TaskUpdatePayload, TaskCreatePayload } from './task.types';
+export { TASK_PRIORITIES, TASK_CATEGORIES } from './task.types';
+export type { TestingProps, AccessibilityProps, ComponentTestingProps, KeyboardNavigationProps, FocusManagementProps, FullAccessibilityProps, TaskTestingProps, NavigationTestingProps, FormTestingProps, TestIdPattern, CypressIdPattern } from './testing.types';
+export type { UserRole, User } from './user.types';
+export { USER_ROLES, ROLE_HIERARCHY, roleHelpers } from './user.types';
+export type { EntityType, MetaDataType, EntityConfig, EntityMeta, EntityWithMeta, CreateMetaPayload, UpdateMetaPayload, BulkMetaPayload, EntityResponse, MetaValue, KnownUserMetaKeys, UserResponse, DynamicEntityResponse, } from './meta.types';
+export { CORE_ENTITY_CONFIGS, getEntityMetaConfig, getMetaValue } from './meta.types';
+export type { FieldType, FieldDefinition, BlockCategory, BlockConfig, BlockInstance, PageMetadata, PageSEO, PageConfig, PageTemplate, BlockValidationResult, BlockRegistry, BlocksListResponse, BlockDetailResponse, BlockValidateRequest, BlockValidateResponse, PagesListResponse, PageDetailResponse, CreatePageRequest, UpdatePageRequest, ValidateSlugRequest, ValidateSlugResponse } from './blocks';
+export { isBlockInstance, isBlockConfig } from './blocks';
+export type { DocPageMeta, DocSectionMeta, DocsRegistryStructure } from './docs';
+export type { PresetSessionConfig, ApiPreset, ApiEndpointPresets, ApiPresetsRegistryStructure, ApiDocEntry, ApiDocsRegistryStructure } from './api-presets';
+export { defineApiEndpoint } from './api-presets';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,IAAI,EACJ,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,eAAe,EACf,eAAe,EAChB,MAAM,cAAc,CAAA;AAGrB,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EACjB,MAAM,iBAAiB,CAAA;AAGxB,YAAY,EACV,QAAQ,EACR,IAAI,EACL,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACZ,MAAM,cAAc,CAAA;AAGrB,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGtF,YAAY,EACV,SAAS,EACT,eAAe,EACf,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,OAAO,EACP,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAGzD,YAAY,EACV,WAAW,EACX,cAAc,EACd,qBAAqB,EACtB,MAAM,QAAQ,CAAA;AAGf,YAAY,EACV,mBAAmB,EACnB,SAAS,EACT,kBAAkB,EAClB,2BAA2B,EAC3B,WAAW,EACX,wBAAwB,EACzB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}