@hazeljs/rag 0.2.0-beta.1

package/dist/agentic/decorators/query-planner.decorator.js

@@ -0,0 +1,227 @@
+"use strict";
+/**
+ * Query Planner Decorator
+ * Automatically decomposes complex queries into sub-queries
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryPlanner = QueryPlanner;
+exports.getQueryPlan = getQueryPlan;
+require("reflect-metadata");
+const QUERY_PLANNER_METADATA_KEY = Symbol('queryPlanner');
+function QueryPlanner(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const query = args[0];
+            if (!config.decompose) {
+                return originalMethod.apply(this, args);
+            }
+            // Decompose query into sub-queries
+            const plan = await decomposeQuery(query, config);
+            // Store plan in metadata
+            Reflect.defineMetadata(QUERY_PLANNER_METADATA_KEY, plan, target, propertyKey);
+            // Execute based on strategy
+            if (plan.strategy === 'parallel' && config.parallel) {
+                return executeParallel.call(this, plan, originalMethod, args);
+            }
+            else {
+                return executeSequential.call(this, plan, originalMethod, args);
+            }
+        };
+        return descriptor;
+    };
+}
+/**
+ * Decompose query into sub-queries
+ */
+async function decomposeQuery(query, config) {
+    // Check if query is complex enough to decompose
+    const complexity = estimateComplexity(query);
+    if (complexity < 3) {
+        return {
+            originalQuery: query,
+            subQueries: [
+                {
+                    id: '1',
+                    query,
+                    type: 'factual',
+                    dependencies: [],
+                    priority: 1,
+                },
+            ],
+            strategy: 'sequential',
+            estimatedComplexity: complexity,
+        };
+    }
+    // Use LLM to decompose if available
+    if (config.llmProvider) {
+        return decomposeWithLLM(query, config);
+    }
+    // Fallback to rule-based decomposition
+    return decomposeRuleBased(query, config);
+}
+/**
+ * LLM-based query decomposition
+ */
+async function decomposeWithLLM(query, config) {
+    const prompt = `Decompose the following complex query into simpler sub-queries.
+Each sub-query should be independent and focused on a specific aspect.
+
+Query: ${query}
+
+Provide the decomposition in the following JSON format:
+{
+  "subQueries": [
+    {
+      "id": "1",
+      "query": "sub-query text",
+      "type": "factual|analytical|comparative|temporal",
+      "dependencies": [],
+      "priority": 1
+    }
+  ],
+  "strategy": "sequential|parallel"
+}`;
+    try {
+        const result = await config.llmProvider.generateStructured(prompt, {});
+        return {
+            originalQuery: query,
+            subQueries: result.subQueries.slice(0, config.maxSubQueries || 5),
+            strategy: result.strategy,
+            estimatedComplexity: result.subQueries.length,
+        };
+    }
+    catch {
+        return decomposeRuleBased(query, config);
+    }
+}
+/**
+ * Rule-based query decomposition
+ */
+function decomposeRuleBased(query, config) {
+    const subQueries = [];
+    // Split by conjunctions
+    const parts = query.split(/\band\b|\bor\b|\bthen\b/i);
+    parts.forEach((part, index) => {
+        const trimmed = part.trim();
+        if (trimmed.length > 10) {
+            subQueries.push({
+                id: String(index + 1),
+                query: trimmed,
+                type: detectQueryType(trimmed),
+                dependencies: index > 0 ? [String(index)] : [],
+                priority: index + 1,
+            });
+        }
+    });
+    if (subQueries.length === 0) {
+        subQueries.push({
+            id: '1',
+            query,
+            type: 'factual',
+            dependencies: [],
+            priority: 1,
+        });
+    }
+    return {
+        originalQuery: query,
+        subQueries: subQueries.slice(0, config.maxSubQueries || 5),
+        strategy: subQueries.length > 1 ? 'parallel' : 'sequential',
+        estimatedComplexity: subQueries.length,
+    };
+}
+/**
+ * Detect query type
+ */
+function detectQueryType(query) {
+    const lowerQuery = query.toLowerCase();
+    if (lowerQuery.includes('compare') || lowerQuery.includes('difference')) {
+        return 'comparative';
+    }
+    if (lowerQuery.includes('when') || lowerQuery.includes('timeline')) {
+        return 'temporal';
+    }
+    if (lowerQuery.includes('why') || lowerQuery.includes('how') || lowerQuery.includes('analyze')) {
+        return 'analytical';
+    }
+    return 'factual';
+}
+/**
+ * Estimate query complexity
+ */
+function estimateComplexity(query) {
+    let score = 1;
+    // Length factor
+    if (query.length > 100)
+        score += 1;
+    if (query.length > 200)
+        score += 1;
+    // Multiple questions
+    const questionMarks = (query.match(/\?/g) || []).length;
+    score += questionMarks;
+    // Conjunctions
+    const conjunctions = (query.match(/\band\b|\bor\b|\bthen\b/gi) || []).length;
+    score += conjunctions;
+    // Complex words
+    const complexWords = ['compare', 'analyze', 'evaluate', 'synthesize'];
+    complexWords.forEach((word) => {
+        if (query.toLowerCase().includes(word))
+            score += 1;
+    });
+    return Math.min(score, 10);
+}
+/**
+ * Execute sub-queries in parallel
+ */
+async function executeParallel(plan, 
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+originalMethod, args) {
+    const results = await Promise.all(plan.subQueries.map((subQuery) => originalMethod.apply(this, [subQuery.query, ...args.slice(1)])));
+    // Merge results
+    return mergeResults(results, plan);
+}
+/**
+ * Execute sub-queries sequentially
+ */
+async function executeSequential(plan, 
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+originalMethod, args) {
+    const results = [];
+    for (const subQuery of plan.subQueries) {
+        const result = await originalMethod.apply(this, [subQuery.query, ...args.slice(1)]);
+        results.push(result);
+    }
+    return mergeResults(results, plan);
+}
+/**
+ * Merge results from sub-queries
+ */
+function mergeResults(results, _plan) {
+    if (!Array.isArray(results[0])) {
+        return results;
+    }
+    // Flatten and deduplicate search results
+    const allResults = results.flat();
+    const seen = new Set();
+    const merged = [];
+    for (const result of allResults) {
+        if (typeof result === 'object' &&
+            result !== null &&
+            'id' in result &&
+            typeof result.id === 'string') {
+            const id = result.id;
+            if (!seen.has(id)) {
+                seen.add(id);
+                merged.push(result);
+            }
+        }
+    }
+    return merged;
+}
+/**
+ * Get query plan metadata
+ */
+function getQueryPlan(target, propertyKey) {
+    return Reflect.getMetadata(QUERY_PLANNER_METADATA_KEY, target, propertyKey);
+}
+//# sourceMappingURL=query-planner.decorator.js.map

package/dist/agentic/decorators/query-planner.decorator.js.map

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

package/dist/agentic/decorators/query-rewriter.decorator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Query Rewriter Decorator
+ * Rewrites and expands queries for better retrieval
+ */
+import 'reflect-metadata';
+import { AgenticLLMProvider } from '../types';
+export interface QueryRewriterConfig {
+    techniques?: ('expansion' | 'clarification' | 'synonym' | 'decomposition')[];
+    llmBased?: boolean;
+    llmProvider?: AgenticLLMProvider;
+    maxVariations?: number;
+}
+export declare function QueryRewriter(config?: QueryRewriterConfig): MethodDecorator;
+export declare function getQueryVariations(target: object, propertyKey: string | symbol): string[];
+//# sourceMappingURL=query-rewriter.decorator.d.ts.map

package/dist/agentic/decorators/query-rewriter.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-rewriter.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/query-rewriter.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,CAAC,WAAW,GAAG,eAAe,GAAG,SAAS,GAAG,eAAe,CAAC,EAAE,CAAC;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,wBAAgB,aAAa,CAAC,MAAM,GAAE,mBAAwB,GAAG,eAAe,CAqC/E;AA+HD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAEzF"}

package/dist/agentic/decorators/query-rewriter.decorator.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * Query Rewriter Decorator
+ * Rewrites and expands queries for better retrieval
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryRewriter = QueryRewriter;
+exports.getQueryVariations = getQueryVariations;
+require("reflect-metadata");
+const REWRITER_METADATA_KEY = Symbol('queryRewriter');
+function QueryRewriter(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const query = args[0];
+            // Generate query variations
+            const variations = await generateQueryVariations(query, config);
+            // Execute search with all variations
+            const allResults = [];
+            const seenIds = new Set();
+            for (const variation of variations) {
+                const results = await originalMethod.apply(this, [variation, ...args.slice(1)]);
+                if (Array.isArray(results)) {
+                    for (const result of results) {
+                        if (result.id && !seenIds.has(result.id)) {
+                            seenIds.add(result.id);
+                            allResults.push(result);
+                        }
+                    }
+                }
+            }
+            // Re-rank by frequency across variations
+            const ranked = rerankByFrequency(allResults, variations.length);
+            Reflect.defineMetadata(REWRITER_METADATA_KEY, variations, target, propertyKey);
+            return ranked;
+        };
+        return descriptor;
+    };
+}
+async function generateQueryVariations(query, config) {
+    const variations = [query]; // Always include original
+    const techniques = config.techniques || ['expansion', 'synonym'];
+    const maxVariations = config.maxVariations || 3;
+    if (config.llmBased && config.llmProvider) {
+        return generateWithLLM(query, techniques, config.llmProvider, maxVariations);
+    }
+    // Rule-based variations
+    for (const technique of techniques) {
+        switch (technique) {
+            case 'expansion':
+                variations.push(...expandQuery(query));
+                break;
+            case 'synonym':
+                variations.push(...addSynonyms(query));
+                break;
+            case 'clarification':
+                variations.push(...clarifyQuery(query));
+                break;
+        }
+    }
+    return [...new Set(variations)].slice(0, maxVariations + 1);
+}
+async function generateWithLLM(query, techniques, llmProvider, maxVariations) {
+    const prompt = `Generate ${maxVariations} variations of this query using these techniques: ${techniques.join(', ')}
+
+Original Query: ${query}
+
+Generate ${maxVariations} query variations (one per line):`;
+    try {
+        const response = await llmProvider.generate(prompt, { temperature: 0.7 });
+        const variations = response
+            .split('\n')
+            .map((line) => line.replace(/^\d+\.\s*/, '').trim())
+            .filter((line) => line.length > 5)
+            .slice(0, maxVariations);
+        return [query, ...variations];
+    }
+    catch {
+        return [query];
+    }
+}
+function expandQuery(query) {
+    const expansions = [];
+    // Add question words if not present
+    if (!query.match(/^(what|who|where|when|why|how)/i)) {
+        expansions.push(`What is ${query}?`);
+        expansions.push(`How does ${query} work?`);
+    }
+    // Add context
+    expansions.push(`${query} explanation`);
+    expansions.push(`${query} details`);
+    return expansions;
+}
+function addSynonyms(query) {
+    const synonymMap = {
+        find: ['search', 'locate', 'discover'],
+        show: ['display', 'present', 'demonstrate'],
+        explain: ['describe', 'clarify', 'elaborate'],
+        compare: ['contrast', 'differentiate', 'analyze'],
+    };
+    const variations = [];
+    const words = query.split(/\s+/);
+    words.forEach((word, index) => {
+        const lowerWord = word.toLowerCase();
+        if (synonymMap[lowerWord]) {
+            synonymMap[lowerWord].forEach((synonym) => {
+                const newWords = [...words];
+                newWords[index] = synonym;
+                variations.push(newWords.join(' '));
+            });
+        }
+    });
+    return variations;
+}
+function clarifyQuery(query) {
+    const clarifications = [];
+    // Add specificity
+    if (query.length < 50) {
+        clarifications.push(`${query} with examples`);
+        clarifications.push(`${query} in detail`);
+    }
+    return clarifications;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function rerankByFrequency(results, variationCount) {
+    const frequency = new Map();
+    results.forEach((result) => {
+        frequency.set(result.id, (frequency.get(result.id) || 0) + 1);
+    });
+    return results
+        .map((result) => ({
+        ...result,
+        score: (result.score || 0) * (1 + (frequency.get(result.id) || 0) / variationCount),
+    }))
+        .sort((a, b) => (b.score || 0) - (a.score || 0));
+}
+function getQueryVariations(target, propertyKey) {
+    return Reflect.getMetadata(REWRITER_METADATA_KEY, target, propertyKey) || [];
+}
+//# sourceMappingURL=query-rewriter.decorator.js.map

package/dist/agentic/decorators/query-rewriter.decorator.js.map

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

package/dist/agentic/decorators/self-reflective.decorator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Self-Reflective Decorator
+ * Evaluates and iteratively improves retrieval results
+ */
+import 'reflect-metadata';
+import { ReflectionResult, AgenticLLMProvider } from '../types';
+export interface SelfReflectiveConfig {
+    maxIterations?: number;
+    qualityThreshold?: number;
+    llmProvider?: AgenticLLMProvider;
+    enableAutoImprovement?: boolean;
+}
+export declare function SelfReflective(config?: SelfReflectiveConfig): MethodDecorator;
+/**
+ * Get reflection metadata
+ */
+export declare function getReflections(target: object, propertyKey: string | symbol): ReflectionResult[];
+//# sourceMappingURL=self-reflective.decorator.d.ts.map

package/dist/agentic/decorators/self-reflective.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-reflective.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/self-reflective.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAqB,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAID,wBAAgB,cAAc,CAAC,MAAM,GAAE,oBAAyB,GAAG,eAAe,CA8DjF;AAqLD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,EAAE,CAE/F"}

package/dist/agentic/decorators/self-reflective.decorator.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * Self-Reflective Decorator
+ * Evaluates and iteratively improves retrieval results
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SelfReflective = SelfReflective;
+exports.getReflections = getReflections;
+require("reflect-metadata");
+const REFLECTION_METADATA_KEY = Symbol('reflection');
+function SelfReflective(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const maxIterations = config.maxIterations || 3;
+            const threshold = config.qualityThreshold || 0.8;
+            let iteration = 0;
+            let currentResult = await originalMethod.apply(this, args);
+            let bestResult = currentResult;
+            let bestQuality = 0;
+            const reflections = [];
+            while (iteration < maxIterations) {
+                iteration++;
+                // Assess quality
+                const query = args[0];
+                const quality = await assessQuality(currentResult, query, config);
+                reflections.push({
+                    originalResponse: JSON.stringify(currentResult),
+                    quality,
+                    improvements: quality.issues,
+                    iterations: iteration,
+                });
+                // Track best result
+                if (quality.score > bestQuality) {
+                    bestQuality = quality.score;
+                    bestResult = currentResult;
+                }
+                // Check if quality threshold met
+                if (quality.score >= threshold) {
+                    break;
+                }
+                // Attempt improvement
+                if (config.enableAutoImprovement && config.llmProvider) {
+                    const improved = await improveResults(currentResult, quality, query, config);
+                    if (improved) {
+                        currentResult = improved;
+                    }
+                    else {
+                        break;
+                    }
+                }
+                else {
+                    break;
+                }
+            }
+            // Store reflection metadata
+            Reflect.defineMetadata(REFLECTION_METADATA_KEY, reflections, target, propertyKey);
+            return bestResult;
+        };
+        return descriptor;
+    };
+}
+/**
+ * Assess quality of results
+ */
+async function assessQuality(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+results, query, config) {
+    if (config.llmProvider) {
+        return assessQualityWithLLM(results, query, config);
+    }
+    return assessQualityHeuristic(results, query);
+}
+/**
+ * LLM-based quality assessment
+ */
+async function assessQualityWithLLM(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+results, query, config) {
+    const resultsStr = JSON.stringify(results, null, 2);
+    const prompt = `Evaluate the quality of these search results for the given query.
+
+Query: ${query}
+
+Results: ${resultsStr.slice(0, 2000)}
+
+Assess the following aspects (0-1 scale):
+1. Relevance: How relevant are the results to the query?
+2. Completeness: Do the results fully answer the query?
+3. Accuracy: Are the results factually accurate?
+4. Clarity: Are the results clear and well-structured?
+
+Provide assessment in JSON format:
+{
+  "relevance": 0.0-1.0,
+  "completeness": 0.0-1.0,
+  "accuracy": 0.0-1.0,
+  "clarity": 0.0-1.0,
+  "issues": ["issue1", "issue2"]
+}`;
+    try {
+        const assessment = await config.llmProvider.generateStructured(prompt, {});
+        const score = (assessment.relevance + assessment.completeness + assessment.accuracy + assessment.clarity) /
+            4;
+        return {
+            score,
+            ...assessment,
+        };
+    }
+    catch {
+        return assessQualityHeuristic(results, query);
+    }
+}
+/**
+ * Heuristic-based quality assessment
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function assessQualityHeuristic(results, query) {
+    const issues = [];
+    let relevance = 0.5;
+    let completeness = 0.5;
+    const accuracy = 0.8;
+    let clarity = 0.7;
+    // Check if results exist
+    if (!results || (Array.isArray(results) && results.length === 0)) {
+        issues.push('No results returned');
+        relevance = 0;
+        completeness = 0;
+        return { score: 0, relevance, completeness, accuracy, clarity, issues };
+    }
+    // Check result count
+    const resultCount = Array.isArray(results) ? results.length : 1;
+    if (resultCount < 3) {
+        issues.push('Few results returned');
+        completeness = 0.5;
+    }
+    else if (resultCount >= 5) {
+        completeness = 0.9;
+    }
+    // Check for query terms in results
+    const queryTerms = query.toLowerCase().split(/\s+/);
+    let matchCount = 0;
+    if (Array.isArray(results)) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        results.forEach((result) => {
+            const content = (result.content || '').toLowerCase();
+            queryTerms.forEach((term) => {
+                if (content.includes(term))
+                    matchCount++;
+            });
+        });
+        relevance = Math.min(matchCount / (queryTerms.length * resultCount), 1);
+    }
+    if (relevance < 0.3) {
+        issues.push('Low relevance to query');
+    }
+    // Check for diversity
+    if (Array.isArray(results) && results.length > 1) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const uniqueContent = new Set(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        results.map((r) => r.content?.slice(0, 100)));
+        if (uniqueContent.size < results.length * 0.7) {
+            issues.push('Low diversity in results');
+            clarity = 0.6;
+        }
+    }
+    const score = (relevance + completeness + accuracy + clarity) / 4;
+    return { score, relevance, completeness, accuracy, clarity, issues };
+}
+/**
+ * Improve results based on quality assessment
+ */
+async function improveResults(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+results, quality, query, config
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+    if (!config.llmProvider) {
+        return null;
+    }
+    const prompt = `The following search results have quality issues. Suggest an improved query or retrieval strategy.
+
+Original Query: ${query}
+Quality Issues: ${quality.issues.join(', ')}
+Current Results: ${JSON.stringify(results, null, 2).slice(0, 1000)}
+
+Suggest improvements in JSON format:
+{
+  "improvedQuery": "better query",
+  "strategy": "similarity|hybrid|mmr",
+  "reasoning": "why this would be better"
+}`;
+    try {
+        await config.llmProvider.generateStructured(prompt, {});
+        // Return null to indicate we should re-query with improvements
+        // The calling code would need to handle this
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get reflection metadata
+ */
+function getReflections(target, propertyKey) {
+    return Reflect.getMetadata(REFLECTION_METADATA_KEY, target, propertyKey) || [];
+}
+//# sourceMappingURL=self-reflective.decorator.js.map

package/dist/agentic/decorators/self-reflective.decorator.js.map

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

package/dist/agentic/decorators/source-verification.decorator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Source Verification Decorator
+ * Verifies source quality and generates citations
+ */
+import 'reflect-metadata';
+import { VerifiedResponse } from '../types';
+export interface SourceVerificationConfig {
+    checkFreshness?: boolean;
+    verifyAuthority?: boolean;
+    requireCitations?: boolean;
+    freshnessThresholdDays?: number;
+}
+export declare function SourceVerification(config?: SourceVerificationConfig): MethodDecorator;
+export declare function getVerifiedResponse(target: object, propertyKey: string | symbol): VerifiedResponse | undefined;
+//# sourceMappingURL=source-verification.decorator.d.ts.map