learngraph 0.1.1 → 0.2.0

package/dist/cjs/parsers/samples.js

@@ -0,0 +1,139 @@
+"use strict";
+/**
+ * Sample syllabi for testing and demonstration
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SAMPLE_SYLLABI = exports.PROGRAMMING_101_SYLLABUS = exports.KINDERGARTEN_MATH_SYLLABUS = exports.PHYSICS_101_SYLLABUS = void 0;
+/**
+ * Sample physics syllabus (university level)
+ */
+exports.PHYSICS_101_SYLLABUS = `# Introduction to Physics
+
+## Course Information
+PHYS 101 - Introduction to Physics
+Fall Semester
+
+## Week 1: Motion and Kinematics
+
+### Learning Objectives
+- Define position, displacement, velocity, and acceleration
+- Calculate average and instantaneous velocity from position data
+- Apply kinematic equations to solve motion problems in one dimension
+- Analyze position-time and velocity-time graphs
+
+## Week 2: Forces and Newton's Laws
+
+### Learning Objectives
+- Identify all forces acting on an object using free-body diagrams
+- Apply Newton's First Law to explain equilibrium conditions
+- Calculate net force and acceleration using Newton's Second Law
+- Analyze action-reaction pairs using Newton's Third Law
+
+## Week 3: Work and Energy
+
+### Learning Objectives
+- Calculate work done by constant and variable forces
+- Apply the work-energy theorem to solve problems
+- Distinguish between kinetic and potential energy
+- Analyze systems using conservation of energy
+
+## Week 4: Momentum and Collisions
+
+### Learning Objectives
+- Calculate linear momentum of objects and systems
+- Apply impulse-momentum theorem to analyze collisions
+- Distinguish between elastic and inelastic collisions
+- Solve collision problems using conservation of momentum
+`;
+/**
+ * Sample kindergarten math syllabus
+ */
+exports.KINDERGARTEN_MATH_SYLLABUS = `# Kindergarten Mathematics
+
+## Course Information
+Grade: Kindergarten
+Subject: Mathematics
+
+## Unit 1: Counting and Cardinality
+
+### Learning Objectives
+- Count objects from 1 to 20
+- Recognize and write number symbols 0-20
+- Compare groups using words: more, less, same
+- Understand that the last number counted tells how many
+
+## Unit 2: Number Operations
+
+### Learning Objectives
+- Understand addition as putting together
+- Understand subtraction as taking apart
+- Represent addition and subtraction with objects
+- Solve simple addition problems within 10
+
+## Unit 3: Shapes and Geometry
+
+### Learning Objectives
+- Identify circles, squares, triangles, and rectangles
+- Describe shapes using words like sides and corners
+- Compare shapes by size and orientation
+- Create pictures using basic shapes
+
+## Unit 4: Measurement
+
+### Learning Objectives
+- Compare objects by length (longer, shorter)
+- Compare objects by weight (heavier, lighter)
+- Sort objects by size, color, or shape
+- Describe position using words: above, below, beside
+`;
+/**
+ * Sample programming course syllabus
+ */
+exports.PROGRAMMING_101_SYLLABUS = `# Introduction to Programming
+
+## Course Information
+CS 101 - Introduction to Programming with Python
+
+## Module 1: Getting Started
+
+### Learning Objectives
+- Install and configure Python development environment
+- Write and execute a simple Python program
+- Identify syntax errors in Python code
+- Use print statements to display output
+
+## Module 2: Variables and Data Types
+
+### Learning Objectives
+- Define variables and assign values
+- Distinguish between integers, floats, and strings
+- Apply type conversion between data types
+- Calculate results using arithmetic operators
+
+## Module 3: Control Flow
+
+### Learning Objectives
+- Write conditional statements using if-else
+- Evaluate boolean expressions
+- Create loops using for and while statements
+- Design nested control structures
+
+## Module 4: Functions
+
+### Learning Objectives
+- Define functions with parameters
+- Apply return values from functions
+- Design functions that call other functions
+- Analyze scope and local variables
+`;
+/**
+ * All sample syllabi
+ */
+exports.SAMPLE_SYLLABI = {
+    physics: exports.PHYSICS_101_SYLLABUS,
+    kindergarten: exports.KINDERGARTEN_MATH_SYLLABUS,
+    programming: exports.PROGRAMMING_101_SYLLABUS,
+};
+//# sourceMappingURL=samples.js.map

package/dist/cjs/parsers/samples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"samples.js","sourceRoot":"","sources":["../../../src/parsers/samples.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH;;GAEG;AACU,QAAA,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCnC,CAAC;AAEF;;GAEG;AACU,QAAA,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCzC,CAAC;AAEF;;GAEG;AACU,QAAA,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCvC,CAAC;AAEF;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,OAAO,EAAE,4BAAoB;IAC7B,YAAY,EAAE,kCAA0B;IACxC,WAAW,EAAE,gCAAwB;CAC7B,CAAC"}

package/dist/cjs/storage/base.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * Base class and utilities for storage adapters
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateId = generateId;
+exports.nowISO = nowISO;
+exports.inputToSkillNode = inputToSkillNode;
+exports.inputToEdge = inputToEdge;
+exports.validateSkillInput = validateSkillInput;
+exports.validateEdgeInput = validateEdgeInput;
+exports.requireConnection = requireConnection;
+exports.calculateStats = calculateStats;
+const index_js_1 = require("../types/index.js");
+const errors_js_1 = require("./errors.js");
+/**
+ * Generate a unique ID with optional prefix
+ */
+function generateId(prefix = '') {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 10);
+    return prefix ? `${prefix}_${timestamp}${random}` : `${timestamp}${random}`;
+}
+/**
+ * Get current ISO timestamp
+ */
+function nowISO() {
+    return new Date().toISOString();
+}
+/**
+ * Convert SkillNodeInput to full SkillNode with generated fields
+ */
+function inputToSkillNode(input) {
+    const now = nowISO();
+    const node = {
+        id: input.id ?? (0, index_js_1.createSkillId)(generateId('skill')),
+        name: input.name,
+        description: input.description,
+        bloomLevel: input.bloomLevel,
+        difficulty: input.difficulty,
+        isThresholdConcept: input.isThresholdConcept,
+        masteryThreshold: input.masteryThreshold,
+        estimatedMinutes: input.estimatedMinutes,
+        tags: input.tags,
+        metadata: input.metadata,
+        createdAt: now,
+        updatedAt: now,
+    };
+    // Only add optional fields if they have values
+    if (input.standardAlignment !== undefined) {
+        node.standardAlignment = input.standardAlignment;
+    }
+    if (input.domain !== undefined) {
+        node.domain = input.domain;
+    }
+    if (input.gradeLevel !== undefined) {
+        node.gradeLevel = input.gradeLevel;
+    }
+    return node;
+}
+/**
+ * Convert PrerequisiteEdgeInput to full PrerequisiteEdge with generated fields
+ */
+function inputToEdge(input) {
+    const edge = {
+        id: input.id ?? (0, index_js_1.createEdgeId)(generateId('edge')),
+        sourceId: input.sourceId,
+        targetId: input.targetId,
+        strength: input.strength,
+        type: input.type,
+        metadata: input.metadata,
+        createdAt: nowISO(),
+    };
+    // Only add optional fields if they have values
+    if (input.reasoning !== undefined) {
+        edge.reasoning = input.reasoning;
+    }
+    return edge;
+}
+/**
+ * Validate skill input data
+ */
+function validateSkillInput(input) {
+    if (!input.name || input.name.trim().length === 0) {
+        throw new errors_js_1.ValidationError('Skill name is required', 'name');
+    }
+    if (input.difficulty < 0 || input.difficulty > 1) {
+        throw new errors_js_1.ValidationError('Difficulty must be between 0 and 1', 'difficulty', input.difficulty);
+    }
+    if (input.masteryThreshold < 0 || input.masteryThreshold > 1) {
+        throw new errors_js_1.ValidationError('Mastery threshold must be between 0 and 1', 'masteryThreshold', input.masteryThreshold);
+    }
+    if (input.estimatedMinutes < 0) {
+        throw new errors_js_1.ValidationError('Estimated minutes cannot be negative', 'estimatedMinutes', input.estimatedMinutes);
+    }
+}
+/**
+ * Validate edge input data
+ */
+function validateEdgeInput(input) {
+    if (!input.sourceId) {
+        throw new errors_js_1.ValidationError('Source skill ID is required', 'sourceId');
+    }
+    if (!input.targetId) {
+        throw new errors_js_1.ValidationError('Target skill ID is required', 'targetId');
+    }
+    if (input.sourceId === input.targetId) {
+        throw new errors_js_1.ValidationError('Edge cannot reference the same skill as source and target', 'sourceId', input.sourceId);
+    }
+    if (input.strength < 0 || input.strength > 1) {
+        throw new errors_js_1.ValidationError('Edge strength must be between 0 and 1', 'strength', input.strength);
+    }
+}
+/**
+ * Ensure adapter is connected before operations
+ */
+function requireConnection(connected) {
+    if (!connected) {
+        throw new errors_js_1.NotConnectedError();
+    }
+}
+/**
+ * Calculate graph statistics from nodes and edges
+ */
+function calculateStats(nodes, edges) {
+    const inDegree = new Map();
+    const outDegree = new Map();
+    // Initialize degree maps
+    for (const node of nodes) {
+        inDegree.set(node.id, 0);
+        outDegree.set(node.id, 0);
+    }
+    // Count degrees
+    for (const edge of edges) {
+        const source = edge.sourceId;
+        const target = edge.targetId;
+        outDegree.set(source, (outDegree.get(source) || 0) + 1);
+        inDegree.set(target, (inDegree.get(target) || 0) + 1);
+    }
+    // Count roots (no prerequisites / in-degree 0)
+    let rootCount = 0;
+    let leafCount = 0;
+    for (const node of nodes) {
+        if (inDegree.get(node.id) === 0)
+            rootCount++;
+        if (outDegree.get(node.id) === 0)
+            leafCount++;
+    }
+    // Calculate bloom distribution
+    const bloomDistribution = {
+        remember: 0,
+        understand: 0,
+        apply: 0,
+        analyze: 0,
+        evaluate: 0,
+        create: 0,
+    };
+    for (const node of nodes) {
+        bloomDistribution[node.bloomLevel] =
+            (bloomDistribution[node.bloomLevel] || 0) + 1;
+    }
+    // Calculate difficulty distribution
+    const difficultyDistribution = {
+        foundational: 0,
+        basic: 0,
+        intermediate: 0,
+        advanced: 0,
+        expert: 0,
+    };
+    for (const node of nodes) {
+        if (node.difficulty <= 0.2)
+            difficultyDistribution.foundational++;
+        else if (node.difficulty <= 0.4)
+            difficultyDistribution.basic++;
+        else if (node.difficulty <= 0.6)
+            difficultyDistribution.intermediate++;
+        else if (node.difficulty <= 0.8)
+            difficultyDistribution.advanced++;
+        else
+            difficultyDistribution.expert++;
+    }
+    // Calculate max depth via BFS from all roots
+    let maxDepth = 0;
+    const adjacency = new Map();
+    for (const edge of edges) {
+        const source = edge.sourceId;
+        const target = edge.targetId;
+        if (!adjacency.has(source))
+            adjacency.set(source, []);
+        adjacency.get(source).push(target);
+    }
+    function bfsMaxDepth(startId) {
+        const queue = [
+            { id: startId, depth: 0 },
+        ];
+        let max = 0;
+        while (queue.length > 0) {
+            const { id, depth } = queue.shift();
+            max = Math.max(max, depth);
+            const neighbors = adjacency.get(id) || [];
+            for (const neighbor of neighbors) {
+                queue.push({ id: neighbor, depth: depth + 1 });
+            }
+        }
+        return max;
+    }
+    // Find max depth from all root nodes
+    for (const node of nodes) {
+        if (inDegree.get(node.id) === 0) {
+            maxDepth = Math.max(maxDepth, bfsMaxDepth(node.id));
+        }
+    }
+    // Calculate averages
+    const totalInDegree = Array.from(inDegree.values()).reduce((a, b) => a + b, 0);
+    const totalOutDegree = Array.from(outDegree.values()).reduce((a, b) => a + b, 0);
+    return {
+        nodeCount: nodes.length,
+        edgeCount: edges.length,
+        thresholdConceptCount: nodes.filter((n) => n.isThresholdConcept).length,
+        rootNodeCount: rootCount,
+        leafNodeCount: leafCount,
+        maxDepth,
+        avgPrerequisites: nodes.length > 0 ? totalInDegree / nodes.length : 0,
+        avgDependents: nodes.length > 0 ? totalOutDegree / nodes.length : 0,
+        bloomDistribution,
+        difficultyDistribution,
+    };
+}
+//# sourceMappingURL=base.js.map

package/dist/cjs/storage/base.js.map

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

package/dist/cjs/storage/errors.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * Storage-specific errors for LearnGraph
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CycleDetectedError = exports.TimeoutError = exports.ValidationError = exports.ReferenceError = exports.DuplicateError = exports.NotFoundError = exports.NotConnectedError = exports.ConnectionError = exports.StorageError = void 0;
+/**
+ * Base error class for storage operations
+ */
+class StorageError extends Error {
+    code;
+    cause;
+    constructor(message, code, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'StorageError';
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+}
+exports.StorageError = StorageError;
+/**
+ * Thrown when connection to storage backend fails
+ */
+class ConnectionError extends StorageError {
+    constructor(message, cause) {
+        super(message, 'CONNECTION_ERROR', cause);
+        this.name = 'ConnectionError';
+    }
+}
+exports.ConnectionError = ConnectionError;
+/**
+ * Thrown when attempting operation without active connection
+ */
+class NotConnectedError extends StorageError {
+    constructor() {
+        super('Not connected to storage backend', 'NOT_CONNECTED');
+        this.name = 'NotConnectedError';
+    }
+}
+exports.NotConnectedError = NotConnectedError;
+/**
+ * Thrown when a skill or edge is not found
+ */
+class NotFoundError extends StorageError {
+    entityType;
+    entityId;
+    constructor(entityType, entityId) {
+        super(`${entityType} not found: ${entityId}`, 'NOT_FOUND');
+        this.entityType = entityType;
+        this.entityId = entityId;
+        this.name = 'NotFoundError';
+    }
+}
+exports.NotFoundError = NotFoundError;
+/**
+ * Thrown when attempting to create a duplicate entity
+ */
+class DuplicateError extends StorageError {
+    entityType;
+    entityId;
+    constructor(entityType, entityId) {
+        super(`${entityType} already exists: ${entityId}`, 'DUPLICATE');
+        this.entityType = entityType;
+        this.entityId = entityId;
+        this.name = 'DuplicateError';
+    }
+}
+exports.DuplicateError = DuplicateError;
+/**
+ * Thrown when edge references non-existent skill
+ */
+class ReferenceError extends StorageError {
+    edgeId;
+    missingSkillId;
+    role;
+    constructor(edgeId, missingSkillId, role) {
+        super(`Edge ${edgeId} references non-existent ${role} skill: ${missingSkillId}`, 'REFERENCE_ERROR');
+        this.edgeId = edgeId;
+        this.missingSkillId = missingSkillId;
+        this.role = role;
+        this.name = 'ReferenceError';
+    }
+}
+exports.ReferenceError = ReferenceError;
+/**
+ * Thrown when data validation fails
+ */
+class ValidationError extends StorageError {
+    field;
+    value;
+    constructor(message, field, value) {
+        super(message, 'VALIDATION_ERROR');
+        this.field = field;
+        this.value = value;
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Thrown when a query times out
+ */
+class TimeoutError extends StorageError {
+    operation;
+    timeoutMs;
+    constructor(operation, timeoutMs) {
+        super(`Operation "${operation}" timed out after ${timeoutMs}ms`, 'TIMEOUT');
+        this.operation = operation;
+        this.timeoutMs = timeoutMs;
+        this.name = 'TimeoutError';
+    }
+}
+exports.TimeoutError = TimeoutError;
+/**
+ * Thrown when a cycle is detected in the graph
+ */
+class CycleDetectedError extends StorageError {
+    path;
+    constructor(path) {
+        super(`Cycle detected in graph: ${path.join(' -> ')}`, 'CYCLE_DETECTED');
+        this.path = path;
+        this.name = 'CycleDetectedError';
+    }
+}
+exports.CycleDetectedError = CycleDetectedError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/storage/errors.js.map

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

package/dist/cjs/storage/index.js

@@ -1,12 +1,99 @@
 "use strict";
 /**
- * Graph storage adapters
+ * Graph storage adapters for LearnGraph
+ *
+ * Provides a unified interface for storing skill graphs with multiple
+ * backend options:
+ * - **MemoryStorage**: In-memory storage for testing
+ * - **LevelGraphStorage**: Browser/local storage using triples
+ * - **Neo4jStorage**: Production graph database
+ *
+ * @example
+ * ```typescript
+ * import { MemoryStorage, Neo4jStorage, LevelGraphStorage } from 'learngraph/storage';
+ *
+ * // For testing
+ * const testStorage = new MemoryStorage();
+ * await testStorage.connect({ backend: 'memory' });
+ *
+ * // For browser/local development
+ * const localStorage = new LevelGraphStorage();
+ * await localStorage.connect({ backend: 'levelgraph', path: './my-graph' });
+ *
+ * // For production
+ * const prodStorage = new Neo4jStorage();
+ * await prodStorage.connect({
+ *   backend: 'neo4j',
+ *   uri: 'bolt://localhost:7687',
+ *   username: 'neo4j',
+ *   password: 'password',
+ * });
+ *
+ * // Same API for all!
+ * const skill = await storage.createSkill({ ... });
+ * const prereqs = await storage.getPrerequisitesOf(skill.id);
+ * ```
  *
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-// Storage adapters will be implemented in Phase 2
-// export { Neo4jStorage } from './neo4j.js';
-// export { LevelGraphStorage } from './levelgraph.js';
-// export { MemoryStorage } from './memory.js';
+exports.Neo4jStorage = exports.LevelGraphStorage = exports.MemoryStorage = exports.calculateStats = exports.validateEdgeInput = exports.validateSkillInput = exports.inputToEdge = exports.inputToSkillNode = exports.nowISO = exports.generateId = exports.CycleDetectedError = exports.TimeoutError = exports.ValidationError = exports.ReferenceError = exports.DuplicateError = exports.NotFoundError = exports.NotConnectedError = exports.ConnectionError = exports.StorageError = void 0;
+exports.createStorage = createStorage;
+// ─────────────────────────────────────────────────────────────────────────────
+// Storage Errors
+// ─────────────────────────────────────────────────────────────────────────────
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "StorageError", { enumerable: true, get: function () { return errors_js_1.StorageError; } });
+Object.defineProperty(exports, "ConnectionError", { enumerable: true, get: function () { return errors_js_1.ConnectionError; } });
+Object.defineProperty(exports, "NotConnectedError", { enumerable: true, get: function () { return errors_js_1.NotConnectedError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return errors_js_1.NotFoundError; } });
+Object.defineProperty(exports, "DuplicateError", { enumerable: true, get: function () { return errors_js_1.DuplicateError; } });
+Object.defineProperty(exports, "ReferenceError", { enumerable: true, get: function () { return errors_js_1.ReferenceError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_js_1.ValidationError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_js_1.TimeoutError; } });
+Object.defineProperty(exports, "CycleDetectedError", { enumerable: true, get: function () { return errors_js_1.CycleDetectedError; } });
+// ─────────────────────────────────────────────────────────────────────────────
+// Base Utilities
+// ─────────────────────────────────────────────────────────────────────────────
+var base_js_1 = require("./base.js");
+Object.defineProperty(exports, "generateId", { enumerable: true, get: function () { return base_js_1.generateId; } });
+Object.defineProperty(exports, "nowISO", { enumerable: true, get: function () { return base_js_1.nowISO; } });
+Object.defineProperty(exports, "inputToSkillNode", { enumerable: true, get: function () { return base_js_1.inputToSkillNode; } });
+Object.defineProperty(exports, "inputToEdge", { enumerable: true, get: function () { return base_js_1.inputToEdge; } });
+Object.defineProperty(exports, "validateSkillInput", { enumerable: true, get: function () { return base_js_1.validateSkillInput; } });
+Object.defineProperty(exports, "validateEdgeInput", { enumerable: true, get: function () { return base_js_1.validateEdgeInput; } });
+Object.defineProperty(exports, "calculateStats", { enumerable: true, get: function () { return base_js_1.calculateStats; } });
+// ─────────────────────────────────────────────────────────────────────────────
+// Storage Adapters
+// ─────────────────────────────────────────────────────────────────────────────
+var memory_js_1 = require("./memory.js");
+Object.defineProperty(exports, "MemoryStorage", { enumerable: true, get: function () { return memory_js_1.MemoryStorage; } });
+var levelgraph_js_1 = require("./levelgraph.js");
+Object.defineProperty(exports, "LevelGraphStorage", { enumerable: true, get: function () { return levelgraph_js_1.LevelGraphStorage; } });
+var neo4j_js_1 = require("./neo4j.js");
+Object.defineProperty(exports, "Neo4jStorage", { enumerable: true, get: function () { return neo4j_js_1.Neo4jStorage; } });
+const memory_js_2 = require("./memory.js");
+const levelgraph_js_2 = require("./levelgraph.js");
+const neo4j_js_2 = require("./neo4j.js");
+/**
+ * Create a storage adapter based on configuration.
+ *
+ * @example
+ * ```typescript
+ * const storage = createStorage({ backend: 'memory' });
+ * await storage.connect({ backend: 'memory' });
+ * ```
+ */
+function createStorage(config) {
+    switch (config.backend) {
+        case 'memory':
+            return new memory_js_2.MemoryStorage();
+        case 'levelgraph':
+            return new levelgraph_js_2.LevelGraphStorage();
+        case 'neo4j':
+            return new neo4j_js_2.Neo4jStorage();
+        default:
+            throw new Error(`Unknown storage backend: ${config.backend}`);
+    }
+}
 //# sourceMappingURL=index.js.map

package/dist/cjs/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAeH,kDAAkD;AAClD,6CAA6C;AAC7C,uDAAuD;AACvD,+CAA+C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;;;AAsEH,sCAWC;AA/DD,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAChF,yCAUqB;AATnB,yGAAA,YAAY,OAAA;AACZ,4GAAA,eAAe,OAAA;AACf,8GAAA,iBAAiB,OAAA;AACjB,0GAAA,aAAa,OAAA;AACb,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,4GAAA,eAAe,OAAA;AACf,yGAAA,YAAY,OAAA;AACZ,+GAAA,kBAAkB,OAAA;AAGpB,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAChF,qCAQmB;AAPjB,qGAAA,UAAU,OAAA;AACV,iGAAA,MAAM,OAAA;AACN,2GAAA,gBAAgB,OAAA;AAChB,sGAAA,WAAW,OAAA;AACX,6GAAA,kBAAkB,OAAA;AAClB,4GAAA,iBAAiB,OAAA;AACjB,yGAAA,cAAc,OAAA;AAGhB,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAChF,yCAA4C;AAAnC,0GAAA,aAAa,OAAA;AACtB,iDAAoD;AAA3C,kHAAA,iBAAiB,OAAA;AAC1B,uCAA0C;AAAjC,wGAAA,YAAY,OAAA;AAMrB,2CAA4C;AAC5C,mDAAoD;AACpD,yCAA0C;AAE1C;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAAC,MAAqB;IACjD,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO,IAAI,yBAAa,EAAE,CAAC;QAC7B,KAAK,YAAY;YACf,OAAO,IAAI,iCAAiB,EAAE,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,IAAI,uBAAY,EAAE,CAAC;QAC5B;YACE,MAAM,IAAI,KAAK,CAAC,4BAA6B,MAAwB,CAAC,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC"}