@datalayer/jupyter-lexical 1.0.7 → 1.0.9

package/lib/autoindent/AutoIndentEngine.d.ts

@@ -0,0 +1,111 @@
+/**
+ * AutoIndent Engine
+ *
+ * Core logic for calculating language-aware code indentation.
+ * Processes indent/dedent rules and applies them based on line content.
+ *
+ * @module autoindent/AutoIndentEngine
+ */
+import type { IndentContext, IndentResult } from './types';
+import { LanguageIndentRegistry } from './LanguageIndentRegistry';
+/**
+ * Engine for calculating intelligent code indentation
+ *
+ * Uses language-specific rules to determine appropriate indentation
+ * based on line content and context.
+ *
+ * @example
+ * ```typescript
+ * const registry = new LanguageIndentRegistry();
+ * const engine = new AutoIndentEngine(registry);
+ *
+ * const result = engine.calculateIndent({
+ *   currentLine: 'if x > 0:',
+ *   language: 'python',
+ *   currentIndent: 0,
+ * });
+ *
+ * console.log(result.spaces); // 4
+ * console.log(result.shouldIndent); // true
+ * ```
+ */
+export declare class AutoIndentEngine {
+    private registry;
+    private _debug;
+    /**
+     * Create a new autoindent engine
+     *
+     * @param registry - Language configuration registry
+     * @param debug - Enable debug logging (currently unused - logging disabled)
+     */
+    constructor(registry: LanguageIndentRegistry, debug?: boolean);
+    /**
+     * Calculate indentation for a new line based on current line context
+     *
+     * @param context - Indentation context
+     * @returns Indent result with spaces and indent/dedent flags
+     */
+    calculateIndent(context: IndentContext): IndentResult;
+    /**
+     * Get tab string for a language (either spaces or actual tab character)
+     *
+     * @param language - Language identifier
+     * @returns String to insert for one tab press
+     */
+    getTabString(language: string | null | undefined): string;
+    /**
+     * Get tab size (number of spaces) for a language
+     *
+     * @param language - Language identifier
+     * @returns Number of spaces per indentation level
+     */
+    getTabSize(language: string | null | undefined): number;
+    /**
+     * Calculate indentation for outdenting (Shift+Tab or dedent)
+     *
+     * @param currentIndent - Current indentation in spaces
+     * @param language - Language identifier
+     * @returns New indentation level after outdent
+     */
+    calculateOutdent(currentIndent: number, language: string | null | undefined): number;
+    /**
+     * Get leading whitespace count from a line
+     *
+     * @param line - Line of text
+     * @returns Number of leading whitespace characters (spaces and tabs)
+     */
+    private getLeadingWhitespaceCount;
+    /**
+     * Get leading whitespace string from a line
+     *
+     * @param line - Line of text
+     * @returns Leading whitespace characters
+     */
+    getLeadingWhitespace(line: string): string;
+    /**
+     * Check if a line matches an indent rule
+     *
+     * @param line - Line of text
+     * @param rule - Indent rule to check
+     * @returns True if line matches the rule
+     */
+    private matchesIndentRule;
+    /**
+     * Check if a line matches a dedent rule
+     *
+     * @param line - Line of text
+     * @param rule - Dedent rule to check
+     * @returns True if line matches the rule
+     */
+    private matchesDedentRule;
+    /**
+     * Normalize indentation to use consistent spacing
+     * Converts tabs to spaces based on language config
+     *
+     * @param line - Line of text
+     * @param language - Language identifier
+     * @returns Line with normalized indentation
+     */
+    normalizeIndentation(line: string, language: string | null | undefined): string;
+}
+export default AutoIndentEngine;

package/lib/autoindent/AutoIndentEngine.js

@@ -0,0 +1,234 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+/**
+ * Engine for calculating intelligent code indentation
+ *
+ * Uses language-specific rules to determine appropriate indentation
+ * based on line content and context.
+ *
+ * @example
+ * ```typescript
+ * const registry = new LanguageIndentRegistry();
+ * const engine = new AutoIndentEngine(registry);
+ *
+ * const result = engine.calculateIndent({
+ *   currentLine: 'if x > 0:',
+ *   language: 'python',
+ *   currentIndent: 0,
+ * });
+ *
+ * console.log(result.spaces); // 4
+ * console.log(result.shouldIndent); // true
+ * ```
+ */
+export class AutoIndentEngine {
+    registry;
+    // @ts-expect-error - Debug field preserved for future use, logging currently disabled
+    _debug;
+    /**
+     * Create a new autoindent engine
+     *
+     * @param registry - Language configuration registry
+     * @param debug - Enable debug logging (currently unused - logging disabled)
+     */
+    constructor(registry, debug = false) {
+        this.registry = registry;
+        this._debug = debug;
+    }
+    /**
+     * Calculate indentation for a new line based on current line context
+     *
+     * @param context - Indentation context
+     * @returns Indent result with spaces and indent/dedent flags
+     */
+    calculateIndent(context) {
+        const config = this.registry.getConfigOrDefault(context.language);
+        // Get base indentation from current line
+        const currentLineIndent = this.getLeadingWhitespaceCount(context.currentLine);
+        // Start with current indentation
+        let resultSpaces = currentLineIndent;
+        let shouldIndent = false;
+        let shouldDedent = false;
+        let triggeredRule;
+        // Check indent triggers
+        for (const rule of config.indentTriggers) {
+            if (this.matchesIndentRule(context.currentLine, rule)) {
+                resultSpaces = currentLineIndent + rule.indentAmount;
+                shouldIndent = true;
+                triggeredRule = rule.name;
+                break; // Use first matching rule
+            }
+        }
+        // Check dedent triggers (only if no indent trigger matched)
+        if (!shouldIndent) {
+            for (const rule of config.dedentTriggers) {
+                if (this.matchesDedentRule(context.currentLine, rule)) {
+                    // Note: Dedent triggers indicate that the NEXT line after the current
+                    // line should be dedented. The current line maintains its indent.
+                    shouldDedent = true;
+                    triggeredRule = rule.name;
+                    break;
+                }
+            }
+        }
+        // Apply custom rules
+        if (config.customRules) {
+            for (const customRule of config.customRules) {
+                if (customRule.condition(context.currentLine, context)) {
+                    resultSpaces = customRule.apply(resultSpaces, context);
+                    break; // Use first matching custom rule
+                }
+            }
+        }
+        // Ensure we never go negative
+        resultSpaces = Math.max(0, resultSpaces);
+        const result = {
+            spaces: resultSpaces,
+            shouldIndent,
+            shouldDedent,
+            triggeredRule,
+        };
+        return result;
+    }
+    /**
+     * Get tab string for a language (either spaces or actual tab character)
+     *
+     * @param language - Language identifier
+     * @returns String to insert for one tab press
+     */
+    getTabString(language) {
+        const config = this.registry.getConfigOrDefault(language);
+        if (config.useTabs) {
+            return '\t';
+        }
+        return ' '.repeat(config.tabSize);
+    }
+    /**
+     * Get tab size (number of spaces) for a language
+     *
+     * @param language - Language identifier
+     * @returns Number of spaces per indentation level
+     */
+    getTabSize(language) {
+        const config = this.registry.getConfigOrDefault(language);
+        return config.tabSize;
+    }
+    /**
+     * Calculate indentation for outdenting (Shift+Tab or dedent)
+     *
+     * @param currentIndent - Current indentation in spaces
+     * @param language - Language identifier
+     * @returns New indentation level after outdent
+     */
+    calculateOutdent(currentIndent, language) {
+        const config = this.registry.getConfigOrDefault(language);
+        const newIndent = currentIndent - config.tabSize;
+        return Math.max(0, newIndent);
+    }
+    /**
+     * Get leading whitespace count from a line
+     *
+     * @param line - Line of text
+     * @returns Number of leading whitespace characters (spaces and tabs)
+     */
+    getLeadingWhitespaceCount(line) {
+        const match = line.match(/^[\t ]*/);
+        if (!match) {
+            return 0;
+        }
+        const whitespace = match[0];
+        let count = 0;
+        for (const char of whitespace) {
+            if (char === '\t') {
+                // Count tab as 4 spaces (or configured tab size)
+                // Note: This is a simplification; actual tab width depends on config
+                count += 4;
+            }
+            else {
+                count += 1;
+            }
+        }
+        return count;
+    }
+    /**
+     * Get leading whitespace string from a line
+     *
+     * @param line - Line of text
+     * @returns Leading whitespace characters
+     */
+    getLeadingWhitespace(line) {
+        const match = line.match(/^[\t ]*/);
+        return match ? match[0] : '';
+    }
+    /**
+     * Check if a line matches an indent rule
+     *
+     * @param line - Line of text
+     * @param rule - Indent rule to check
+     * @returns True if line matches the rule
+     */
+    matchesIndentRule(line, rule) {
+        switch (rule.context) {
+            case 'line-end':
+                return rule.pattern.test(line);
+            case 'line-start':
+                return rule.pattern.test(line);
+            case 'anywhere':
+                return rule.pattern.test(line);
+            default:
+                return false;
+        }
+    }
+    /**
+     * Check if a line matches a dedent rule
+     *
+     * @param line - Line of text
+     * @param rule - Dedent rule to check
+     * @returns True if line matches the rule
+     */
+    matchesDedentRule(line, rule) {
+        switch (rule.context) {
+            case 'line-start':
+                return rule.pattern.test(line);
+            case 'anywhere':
+                return rule.pattern.test(line);
+            default:
+                return false;
+        }
+    }
+    /**
+     * Normalize indentation to use consistent spacing
+     * Converts tabs to spaces based on language config
+     *
+     * @param line - Line of text
+     * @param language - Language identifier
+     * @returns Line with normalized indentation
+     */
+    normalizeIndentation(line, language) {
+        const config = this.registry.getConfigOrDefault(language);
+        if (config.useTabs) {
+            // Convert spaces to tabs
+            const leadingSpaces = this.getLeadingWhitespace(line);
+            const spaceCount = leadingSpaces.length;
+            const tabCount = Math.floor(spaceCount / config.tabSize);
+            const remainingSpaces = spaceCount % config.tabSize;
+            const normalized = '\t'.repeat(tabCount) +
+                ' '.repeat(remainingSpaces) +
+                line.substring(leadingSpaces.length);
+            return normalized;
+        }
+        else {
+            // Convert tabs to spaces
+            const leadingWhitespace = this.getLeadingWhitespace(line);
+            const normalized = leadingWhitespace
+                .replace(/\t/g, ' '.repeat(config.tabSize))
+                .concat(line.substring(leadingWhitespace.length));
+            return normalized;
+        }
+    }
+}
+export default AutoIndentEngine;
+//# sourceMappingURL=AutoIndentEngine.js.map

package/lib/autoindent/AutoIndentEngine.js.map

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

package/lib/autoindent/LanguageIndentRegistry.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Language Indentation Registry
+ *
+ * Central registry for managing language-specific indentation configurations.
+ * Supports registration, retrieval, and updating of language configs.
+ *
+ * @module autoindent/LanguageIndentRegistry
+ */
+import type { LanguageIndentConfig, AutoIndentOptions } from './types';
+/**
+ * Registry for language indentation configurations
+ *
+ * Manages a collection of language-specific indent rules and provides
+ * methods to register, retrieve, and update configurations.
+ *
+ * @example
+ * ```typescript
+ * const registry = new LanguageIndentRegistry();
+ * const config = registry.getConfig('python');
+ * console.log(config.tabSize); // 4
+ * ```
+ */
+export declare class LanguageIndentRegistry {
+    private configs;
+    private options;
+    /**
+     * Create a new language indent registry
+     *
+     * @param options - Configuration options
+     */
+    constructor(options?: AutoIndentOptions);
+    /**
+     * Register default language configurations
+     * Currently supports: Python, JavaScript, TypeScript
+     */
+    private registerDefaultLanguages;
+    /**
+     * Register a language configuration
+     *
+     * @param config - Language indent configuration
+     * @throws Error if language already registered (use updateConfig to modify)
+     */
+    registerLanguage(config: LanguageIndentConfig): void;
+    /**
+     * Register a language alias
+     * Example: 'py' -> 'python', 'js' -> 'javascript'
+     *
+     * @param alias - Short alias name
+     * @param targetLanguage - Full language name
+     */
+    registerAlias(alias: string, targetLanguage: string): void;
+    /**
+     * Get configuration for a language
+     *
+     * @param language - Language identifier
+     * @returns Language config or undefined if not found
+     */
+    getConfig(language: string | null | undefined): LanguageIndentConfig | undefined;
+    /**
+     * Get configuration for a language with fallback to default
+     *
+     * @param language - Language identifier
+     * @returns Language config (never undefined - returns default if not found)
+     */
+    getConfigOrDefault(language: string | null | undefined): LanguageIndentConfig;
+    /**
+     * Create a minimal fallback configuration
+     */
+    private createFallbackConfig;
+    /**
+     * Check if a language is registered
+     *
+     * @param language - Language identifier
+     * @returns True if language has a configuration
+     */
+    hasLanguage(language: string | null | undefined): boolean;
+    /**
+     * Update an existing language configuration
+     *
+     * @param language - Language identifier
+     * @param updates - Partial configuration to merge
+     * @returns True if update successful, false if language not found
+     */
+    updateConfig(language: string, updates: Partial<LanguageIndentConfig>): boolean;
+    /**
+     * Get list of all registered languages
+     *
+     * @returns Array of language identifiers
+     */
+    getRegisteredLanguages(): string[];
+    /**
+     * Clear all registered configurations
+     * Useful for testing
+     */
+    clear(): void;
+    /**
+     * Reset to default configurations
+     * Removes custom configs but keeps built-in languages
+     */
+    reset(): void;
+}
+export default LanguageIndentRegistry;

package/lib/autoindent/LanguageIndentRegistry.js

@@ -0,0 +1,200 @@
+/*
+ * Copyright (c) 2021-2023 Datalayer, Inc.
+ *
+ * MIT License
+ */
+import { pythonIndentConfig } from './languages/python.js';
+import { javascriptIndentConfig, typescriptIndentConfig, } from './languages/javascript.js';
+/**
+ * Registry for language indentation configurations
+ *
+ * Manages a collection of language-specific indent rules and provides
+ * methods to register, retrieve, and update configurations.
+ *
+ * @example
+ * ```typescript
+ * const registry = new LanguageIndentRegistry();
+ * const config = registry.getConfig('python');
+ * console.log(config.tabSize); // 4
+ * ```
+ */
+export class LanguageIndentRegistry {
+    configs;
+    options;
+    /**
+     * Create a new language indent registry
+     *
+     * @param options - Configuration options
+     */
+    constructor(options = {}) {
+        this.configs = new Map();
+        this.options = {
+            defaultLanguage: 'python',
+            fallbackTabSize: 4,
+            debug: false,
+            ...options,
+        };
+        // Register default languages
+        this.registerDefaultLanguages();
+        // Register any custom configs provided
+        if (options.customConfigs) {
+            options.customConfigs.forEach(config => this.registerLanguage(config));
+        }
+    }
+    /**
+     * Register default language configurations
+     * Currently supports: Python, JavaScript, TypeScript
+     */
+    registerDefaultLanguages() {
+        this.registerLanguage(pythonIndentConfig);
+        this.registerLanguage(javascriptIndentConfig);
+        this.registerLanguage(typescriptIndentConfig);
+        // Add common language aliases
+        this.registerAlias('py', 'python');
+        this.registerAlias('js', 'javascript');
+        this.registerAlias('ts', 'typescript');
+        this.registerAlias('jsx', 'javascript');
+        this.registerAlias('tsx', 'typescript');
+    }
+    /**
+     * Register a language configuration
+     *
+     * @param config - Language indent configuration
+     * @throws Error if language already registered (use updateConfig to modify)
+     */
+    registerLanguage(config) {
+        if (this.configs.has(config.language)) {
+            if (this.options.debug) {
+                console.warn(`[LanguageIndentRegistry] Language '${config.language}' already registered. Use updateConfig() to modify.`);
+            }
+            return;
+        }
+        this.configs.set(config.language, config);
+    }
+    /**
+     * Register a language alias
+     * Example: 'py' -> 'python', 'js' -> 'javascript'
+     *
+     * @param alias - Short alias name
+     * @param targetLanguage - Full language name
+     */
+    registerAlias(alias, targetLanguage) {
+        const config = this.configs.get(targetLanguage);
+        if (config) {
+            this.configs.set(alias, config);
+        }
+    }
+    /**
+     * Get configuration for a language
+     *
+     * @param language - Language identifier
+     * @returns Language config or undefined if not found
+     */
+    getConfig(language) {
+        if (!language) {
+            return this.getConfig(this.options.defaultLanguage);
+        }
+        // Normalize language name (lowercase, trim)
+        const normalized = language.toLowerCase().trim();
+        return this.configs.get(normalized);
+    }
+    /**
+     * Get configuration for a language with fallback to default
+     *
+     * @param language - Language identifier
+     * @returns Language config (never undefined - returns default if not found)
+     */
+    getConfigOrDefault(language) {
+        const config = this.getConfig(language);
+        if (config) {
+            return config;
+        }
+        // Fallback to default language
+        const defaultConfig = this.getConfig(this.options.defaultLanguage);
+        if (defaultConfig) {
+            if (this.options.debug) {
+                console.warn(`[LanguageIndentRegistry] Language '${language}' not found, using default: ${this.options.defaultLanguage}`);
+            }
+            return defaultConfig;
+        }
+        // Ultimate fallback: create minimal config
+        if (this.options.debug) {
+            console.error(`[LanguageIndentRegistry] No config found for '${language}' and default '${this.options.defaultLanguage}' missing!`);
+        }
+        return this.createFallbackConfig(language || 'unknown');
+    }
+    /**
+     * Create a minimal fallback configuration
+     */
+    createFallbackConfig(language) {
+        return {
+            language,
+            tabSize: this.options.fallbackTabSize || 4,
+            useTabs: this.options.preserveTabs || false,
+            indentTriggers: [],
+            dedentTriggers: [],
+        };
+    }
+    /**
+     * Check if a language is registered
+     *
+     * @param language - Language identifier
+     * @returns True if language has a configuration
+     */
+    hasLanguage(language) {
+        if (!language) {
+            return false;
+        }
+        const normalized = language.toLowerCase().trim();
+        return this.configs.has(normalized);
+    }
+    /**
+     * Update an existing language configuration
+     *
+     * @param language - Language identifier
+     * @param updates - Partial configuration to merge
+     * @returns True if update successful, false if language not found
+     */
+    updateConfig(language, updates) {
+        const normalized = language.toLowerCase().trim();
+        const existing = this.configs.get(normalized);
+        if (!existing) {
+            if (this.options.debug) {
+                console.warn(`[LanguageIndentRegistry] Cannot update '${language}' - not registered`);
+            }
+            return false;
+        }
+        const updated = {
+            ...existing,
+            ...updates,
+            language: existing.language, // Preserve original language name
+        };
+        this.configs.set(normalized, updated);
+        return true;
+    }
+    /**
+     * Get list of all registered languages
+     *
+     * @returns Array of language identifiers
+     */
+    getRegisteredLanguages() {
+        return Array.from(this.configs.keys());
+    }
+    /**
+     * Clear all registered configurations
+     * Useful for testing
+     */
+    clear() {
+        this.configs.clear();
+    }
+    /**
+     * Reset to default configurations
+     * Removes custom configs but keeps built-in languages
+     */
+    reset() {
+        this.clear();
+        this.registerDefaultLanguages();
+    }
+}
+export default LanguageIndentRegistry;
+//# sourceMappingURL=LanguageIndentRegistry.js.map

package/lib/autoindent/LanguageIndentRegistry.js.map

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

package/lib/autoindent/__tests__/AutoIndentEngine.test.d.ts

@@ -0,0 +1 @@
+export {};