IncludeCPP 4.0.0__py3-none-any.whl → 4.2.2__py3-none-any.whl

includecpp/cli/commands.py

@@ -9,8 +9,12 @@ import re
 import urllib.request
 import urllib.error
 from pathlib import Path
+from colorama import init as colorama_init, Fore, Style
 from .config_parser import CppProjectConfig
 
+# Initialize colorama for Windows ANSI color support
+colorama_init()
+
 
 def _is_experimental_enabled() -> bool:
     """Check if experimental features (cppy, ai) are enabled."""
@@ -148,113 +152,276 @@ def _render_readme_with_colors(readme_text):
             click.echo("  " + stripped)
 
 
-def _show_changelog():
-    """Extract and display changelog from README."""
+def _get_changelog_path():
+    """Get path to CHANGELOG.md file."""
+    # Try package location first
+    package_dir = Path(__file__).parent.parent
+    changelog_path = package_dir / 'CHANGELOG.md'
+    if changelog_path.exists():
+        return changelog_path
+    # Fallback to current directory
+    cwd_path = Path.cwd() / 'CHANGELOG.md'
+    if cwd_path.exists():
+        return cwd_path
+    return None
+
+
+def _parse_changelog_entries(content: str) -> list:
+    """Parse changelog into list of version entries.
+
+    Returns list of tuples: (version_header, content_lines)
+    """
+    entries = []
+    lines = content.split('\n')
+    current_version = None
+    current_lines = []
+
+    for line in lines:
+        # Match version headers like "## v4.2.0 (2025-01-08)"
+        if line.startswith('## '):
+            # Save previous entry
+            if current_version:
+                entries.append((current_version, current_lines))
+            current_version = line[3:].strip()
+            current_lines = []
+        elif current_version:
+            current_lines.append(line)
+
+    # Save last entry
+    if current_version:
+        entries.append((current_version, current_lines))
+
+    return entries
+
+
+def _show_changelog(count: int = 2, show_all: bool = False):
+    """Display changelog from local CHANGELOG.md file.
+
+    Args:
+        count: Number of version entries to show (default 2)
+        show_all: If True, show all entries
+    """
     _safe_echo("=" * 70)
     _safe_echo("IncludeCPP Changelog", fg='cyan', bold=True)
     _safe_echo("=" * 70)
     _safe_echo("")
 
-    try:
-        _safe_echo("  Fetching changelog from PyPI...", nl=False)
-        req = urllib.request.Request(
-            "https://pypi.org/pypi/IncludeCPP/json",
-            headers={"User-Agent": "IncludeCPP-CLI"}
-        )
-        with urllib.request.urlopen(req, timeout=15) as response:
-            raw_data = response.read().decode('utf-8')
-
-        data = json.loads(raw_data)
-        description = data.get('info', {}).get('description', '')
-        version = data.get('info', {}).get('version', 'unknown')
-        _safe_echo(" OK", fg='green')
+    changelog_path = _get_changelog_path()
+    if not changelog_path:
+        _safe_echo("CHANGELOG.md not found.", fg='yellow')
         _safe_echo("")
+        _safe_echo("=" * 70)
+        return
+
+    try:
+        content = changelog_path.read_text(encoding='utf-8')
+        entries = _parse_changelog_entries(content)
 
-        if description:
-            _safe_echo(f"Current Version: {version}", fg='green', bold=True)
+        if not entries:
+            _safe_echo("No changelog entries found.", fg='yellow')
             _safe_echo("")
+            _safe_echo("=" * 70)
+            return
 
-            lines = description.split('\n')
-            in_changelog = False
-            changelog_lines = []
+        # Determine how many to show
+        if show_all:
+            entries_to_show = entries
+        else:
+            entries_to_show = entries[:count]
+
+        _safe_echo(f"Showing {len(entries_to_show)} of {len(entries)} releases", fg='bright_black')
+        _safe_echo("")
+
+        for version, lines in entries_to_show:
+            _safe_echo(version, fg='yellow', bold=True)
 
             for line in lines:
-                if line.strip().startswith('# Changelog'):
-                    in_changelog = True
+                stripped = line.strip()
+                if not stripped:
                     continue
-                if in_changelog:
-                    if line.startswith('# ') and not line.startswith('## '):
-                        break
-                    changelog_lines.append(line)
-
-            if changelog_lines:
-                for line in changelog_lines:
-                    stripped = line.strip()
-                    if stripped.startswith('## '):
-                        _safe_echo(stripped[3:], fg='yellow', bold=True)
-                    elif stripped.startswith('- '):
-                        _safe_echo("  " + stripped)
-                    elif stripped:
-                        _safe_echo("  " + stripped)
+                elif stripped.startswith('### '):
+                    _safe_echo("  " + stripped[4:], fg='cyan', bold=True)
+                elif stripped.startswith('- '):
+                    _safe_echo("    " + stripped)
+                elif stripped.startswith('---'):
+                    _safe_echo("")
+                else:
+                    _safe_echo("    " + stripped)
+
+            _safe_echo("")
+
+        if not show_all and len(entries) > count:
+            _safe_echo(f"Use --changelog --all to see all {len(entries)} releases", fg='bright_black')
+            _safe_echo(f"Or --changelog --{len(entries)} to see specific count", fg='bright_black')
+
+    except Exception as e:
+        _safe_echo(f"Error reading changelog: {e}", fg='red', err=True)
+
+    _safe_echo("")
+    _safe_echo("=" * 70)
+
+
+def _get_doc_path():
+    """Get path to DOCUMENTATION.md file."""
+    package_dir = Path(__file__).parent.parent
+    doc_path = package_dir / 'DOCUMENTATION.md'
+    if doc_path.exists():
+        return doc_path
+    # Fallback to current directory
+    cwd_path = Path.cwd() / 'DOCUMENTATION.md'
+    if cwd_path.exists():
+        return cwd_path
+    return None
+
+
+def _show_doc(search_term: str = None):
+    """Display documentation from local DOCUMENTATION.md file.
+
+    Args:
+        search_term: Optional search term to filter content
+    """
+    _safe_echo("=" * 70)
+    _safe_echo("IncludeCPP Documentation", fg='cyan', bold=True)
+    _safe_echo("=" * 70)
+    _safe_echo("")
+
+    doc_path = _get_doc_path()
+    if not doc_path:
+        _safe_echo("DOCUMENTATION.md not found.", fg='yellow')
+        _safe_echo("")
+        _safe_echo("=" * 70)
+        return
+
+    try:
+        content = doc_path.read_text(encoding='utf-8')
+
+        if search_term:
+            # Search mode - find matching sections
+            _safe_echo(f"Searching for: '{search_term}'", fg='green', bold=True)
+            _safe_echo("")
+
+            # Split into sections (## headers)
+            sections = re.split(r'(?=^## )', content, flags=re.MULTILINE)
+
+            # Find matching sections
+            matches = []
+            for section in sections:
+                if search_term.lower() in section.lower():
+                    # Get section title
+                    title_match = re.match(r'^## (.+)$', section, re.MULTILINE)
+                    if title_match:
+                        matches.append((title_match.group(1), section))
+
+            if matches:
+                _safe_echo(f"Found {len(matches)} matching section(s):", fg='green')
+                _safe_echo("")
+
+                for title, section_content in matches[:5]:  # Limit to 5
+                    _safe_echo(f"## {title}", fg='yellow', bold=True)
+
+                    # Highlight search term
+                    lines = section_content.split('\n')
+                    for line in lines[:30]:  # Limit lines per section
+                        stripped = line.strip()
+                        if not stripped or stripped.startswith('## '):
+                            continue
+
+                        # Highlight matches
+                        if search_term.lower() in stripped.lower():
+                            # Simple highlight - wrap matches
+                            highlighted = re.sub(
+                                f'({re.escape(search_term)})',
+                                lambda m: click.style(m.group(1), fg='green', bold=True),
+                                stripped,
+                                flags=re.IGNORECASE
+                            )
+                            _safe_echo("  " + highlighted)
+                        else:
+                            _safe_echo("  " + stripped)
+
+                    _safe_echo("")
+                    _safe_echo("-" * 40)
+                    _safe_echo("")
+
+                if len(matches) > 5:
+                    _safe_echo(f"... and {len(matches) - 5} more sections", fg='bright_black')
             else:
-                _safe_echo("No changelog found in README.", fg='yellow')
+                _safe_echo(f"No matches found for '{search_term}'", fg='yellow')
+                _safe_echo("")
+                _safe_echo("Try searching for:")
+                _safe_echo("  - Commands: init, rebuild, plugin, auto")
+                _safe_echo("  - Features: CSSL, AI, CPPY, classes, functions")
+                _safe_echo("  - Syntax: $, @, <==, define, class")
         else:
-            _safe_echo("No documentation available.", fg='yellow')
+            # Full documentation display
+            _safe_echo("+" + "=" * 68 + "+", fg='red', bold=True)
+            _safe_echo("|  IMPORTANT: All C++ code MUST be in 'namespace includecpp { }'     |", fg='red', bold=True)
+            _safe_echo("+" + "=" * 68 + "+", fg='red', bold=True)
+            _safe_echo("")
+            _render_readme_with_colors(content)
 
     except Exception as e:
-        _safe_echo(" FAILED", fg='red')
-        _safe_echo("")
-        _safe_echo("Could not fetch changelog: " + str(e), fg='red', err=True)
+        _safe_echo(f"Error reading documentation: {e}", fg='red', err=True)
 
     _safe_echo("")
     _safe_echo("=" * 70)
 
 
 @click.group(invoke_without_command=True)
-@click.option('--doc', 'show_doc', is_flag=True, help='Show documentation (README) with color highlighting')
-@click.option('--changelog', 'show_changelog', is_flag=True, help='Show changelog for the latest version')
+@click.option('--doc', 'doc_search', is_flag=False, flag_value='__SHOW_ALL__', default=None, help='Show documentation. Use --doc "term" to search.')
+@click.option('--changelog', 'show_changelog', is_flag=True, help='Show changelog (last 2 releases by default)')
+@click.option('--all', 'changelog_all', is_flag=True, help='Show all changelog entries (use with --changelog)')
+@click.option('--1', 'changelog_1', is_flag=True, hidden=True)
+@click.option('--2', 'changelog_2', is_flag=True, hidden=True)
+@click.option('--3', 'changelog_3', is_flag=True, hidden=True)
+@click.option('--4', 'changelog_4', is_flag=True, hidden=True)
+@click.option('--5', 'changelog_5', is_flag=True, hidden=True)
+@click.option('--6', 'changelog_6', is_flag=True, hidden=True)
+@click.option('--7', 'changelog_7', is_flag=True, hidden=True)
+@click.option('--8', 'changelog_8', is_flag=True, hidden=True)
+@click.option('--9', 'changelog_9', is_flag=True, hidden=True)
+@click.option('--10', 'changelog_10', is_flag=True, hidden=True)
 @click.pass_context
-def cli(ctx, show_doc, show_changelog):
-    """IncludeCPP - C++ Performance in Python, Zero Hassle"""
-    if show_changelog:
-        _show_changelog()
-        ctx.exit(0)
-    if show_doc:
-        click.echo("=" * 70)
-        click.secho("IncludeCPP Documentation", fg='cyan', bold=True)
-        click.echo("=" * 70)
-        click.echo()
-
-        try:
-            click.echo("  Fetching documentation from PyPI...", nl=False)
-            req = urllib.request.Request(
-                "https://pypi.org/pypi/IncludeCPP/json",
-                headers={"User-Agent": "IncludeCPP-CLI"}
-            )
-            with urllib.request.urlopen(req, timeout=15) as response:
-                raw_data = response.read().decode('utf-8')
+def cli(ctx, doc_search, show_changelog, changelog_all, changelog_1, changelog_2, changelog_3,
+        changelog_4, changelog_5, changelog_6, changelog_7, changelog_8, changelog_9, changelog_10):
+    """IncludeCPP - C++ Performance in Python, Zero Hassle
 
-            data = json.loads(raw_data)
-            description = data.get('info', {}).get('description', '')
-            click.secho(" OK", fg='green')
-            click.echo()
-
-            if description:
-                click.secho("+" + "=" * 68 + "+", fg='red', bold=True)
-                click.secho("|  IMPORTANT: All C++ code MUST be in 'namespace includecpp { }'     |", fg='red', bold=True)
-                click.secho("|  This is REQUIRED for IncludeCPP to work!                         |", fg='red', bold=True)
-                click.secho("+" + "=" * 68 + "+", fg='red', bold=True)
-                click.echo()
-                _render_readme_with_colors(description)
-            else:
-                click.secho("No documentation available.", fg='yellow')
+    \b
+    Documentation:
+      includecpp --doc              Show full documentation
+      includecpp --doc "CSSL"       Search documentation for "CSSL"
+      includecpp --doc "rebuild"    Search documentation for "rebuild"
 
-        except Exception as e:
-            click.secho(" FAILED", fg='red')
-            click.echo()
-            click.secho("Could not fetch documentation: " + str(e), fg='red', err=True)
+    \b
+    Changelog:
+      includecpp --changelog        Show last 2 releases
+      includecpp --changelog --all  Show all releases
+      includecpp --changelog --5    Show last 5 releases
+    """
+    # Handle changelog
+    if show_changelog:
+        # Determine count from --N flags
+        count = 2  # default
+        if changelog_all:
+            _show_changelog(show_all=True)
+        else:
+            if changelog_1: count = 1
+            elif changelog_2: count = 2
+            elif changelog_3: count = 3
+            elif changelog_4: count = 4
+            elif changelog_5: count = 5
+            elif changelog_6: count = 6
+            elif changelog_7: count = 7
+            elif changelog_8: count = 8
+            elif changelog_9: count = 9
+            elif changelog_10: count = 10
+            _show_changelog(count=count)
+        ctx.exit(0)
 
-        click.echo("=" * 70)
+    # Handle documentation - --doc or --doc "search"
+    if doc_search is not None:
+        search_term = None if doc_search == '__SHOW_ALL__' else doc_search
+        _show_doc(search_term)
         ctx.exit(0)
 
     # If no subcommand is given, show help
@@ -5195,7 +5362,7 @@ def ai_ask(question, module_name, files, all_modules, exclude, think_mode, think
     verbose.phase('init', 'Setting up context')
     verbose.detail('Question', question[:50] + '...' if len(question) > 50 else question)
     verbose.detail('Mode', mode)
-    verbose.detail('Model', ai_mgr.config.get('model', 'gpt-5'))
+    verbose.detail('Model', ai_mgr.config.get('model', 'gpt-4o'))
 
     project_root = Path.cwd()
     plugins_dir = project_root / "plugins"
@@ -5216,7 +5383,7 @@ def ai_ask(question, module_name, files, all_modules, exclude, think_mode, think
         files=len(source_files) + len(plugin_files),
         lines=total_lines,
         tokens=total_lines * 4,  # Approximate
-        model=ai_mgr.config.get('model', 'gpt-5')
+        model=ai_mgr.config.get('model', 'gpt-4o')
     )
 
     if use_websearch:
@@ -6452,7 +6619,7 @@ def _convert_with_ai(content: str, module_name: str, source_file,
         )
 
         if not success:
-            ai_verbose.warning("AI conversion failed, using standard converter")
+            ai_verbose.warning(f"AI conversion failed: {response}")
             ai_verbose.phase('fallback', 'Falling back to standard conversion')
             ai_verbose.end(success=True, message="Fallback successful")
             if to_cpp:
@@ -7320,7 +7487,6 @@ def exec_repl(lang, path, import_all):
     code_lines = imports + [''] + lines if imports else lines
 
     click.echo()
-    click.secho("--- Output ---", fg='green')
 
     if is_python:
         # Execute Python code
@@ -7443,9 +7609,6 @@ def exec_repl(lang, path, import_all):
             except Exception:
                 pass
 
-    click.echo()
-    click.secho("--------------", fg='green')
-
 
 # ============================================================================
 # CSSL - Hidden Command Group
@@ -7526,19 +7689,12 @@ def _cssl_execute(path, code):
         source = '\n'.join(lines)
 
     # Execute
-    click.secho("--- Output ---", fg='green')
     try:
         result = cssl_lang.run(source)
-
-        # Output is already printed to stdout during execution via runtime.output()
-        # Don't print "Result:" automatically - users should use printl() for output
-        # This prevents unwanted output for function calls like: Function();
-        pass
-
     except Exception as e:
-        click.secho(f"CSSL Error: {e}", fg='red')
-
-    click.secho("--------------", fg='green')
+        error_msg = str(e)
+        # Clean display - single CSSL Error: prefix with colorama
+        click.echo(f"{Fore.RED}CSSL Error: {error_msg}{Style.RESET_ALL}")
 
 
 @cssl.command(name='makemodule')
@@ -7926,6 +8082,457 @@ def cssl_vscode():
         click.secho(f"Installation failed: {e}", fg='red')
 
 
+@cssl.command(name='sdk')
+@click.argument('lang', required=False, default=None)
+@click.option('--doc', is_flag=True, help='Show SDK documentation')
+def cssl_sdk(lang, doc):
+    """Generate SDK files for cross-language instance sharing.
+
+    \b
+    Usage:
+      includecpp cssl sdk cpp        # Create C++ SDK in ./sdk/cpp/
+      includecpp cssl sdk java       # Create Java SDK in ./sdk/java/
+      includecpp cssl sdk csharp     # Create C# SDK in ./sdk/csharp/
+      includecpp cssl sdk js         # Create JavaScript SDK in ./sdk/javascript/
+      includecpp cssl sdk all        # Create all SDKs
+      includecpp cssl sdk --doc      # Show SDK documentation
+
+    \b
+    Languages:
+      cpp, c++      C++ header-only SDK
+      java          Java SDK (com.includecpp.CSSL)
+      csharp, c#    C# SDK (IncludeCPP.CSSL)
+      js, javascript  JavaScript/Node.js SDK
+      all           All languages
+
+    \b
+    Cross-Language Instance Sharing:
+      Share instances from any language and access them in CSSL using
+      the lang$InstanceName syntax:
+
+      C++:    CSSL::share("Engine", &engine);  -> cpp$Engine
+      Java:   CSSL.share("Service", svc);      -> java$Service
+      C#:     CSSL.Share("Handler", hdl);      -> csharp$Handler
+      JS:     CSSL.share('Processor', proc);   -> js$Processor
+    """
+    from pathlib import Path as PathLib
+    import shutil
+
+    # Show documentation if --doc flag is set
+    if doc or lang == 'doc':
+        _show_sdk_documentation()
+        return
+
+    if lang is None:
+        # Show help
+        click.secho("CSSL Multi-Language SDK Generator", fg='cyan', bold=True)
+        click.echo()
+        click.echo("Usage:")
+        click.echo("  includecpp cssl sdk <lang>     Create SDK for language")
+        click.echo("  includecpp cssl sdk --doc      Show documentation")
+        click.echo()
+        click.echo("Languages:")
+        click.echo("  cpp, c++      C++ header-only SDK")
+        click.echo("  java          Java SDK")
+        click.echo("  csharp, c#    C# SDK")
+        click.echo("  js, javascript  JavaScript SDK")
+        click.echo("  all           All SDKs")
+        return
+
+    # Normalize language name
+    lang_map = {
+        'cpp': 'cpp', 'c++': 'cpp',
+        'java': 'java',
+        'csharp': 'csharp', 'c#': 'csharp', 'cs': 'csharp',
+        'js': 'javascript', 'javascript': 'javascript',
+        'all': 'all'
+    }
+
+    normalized = lang_map.get(lang.lower())
+    if normalized is None:
+        click.secho(f"Unknown language: {lang}", fg='red')
+        click.echo("Supported: cpp, java, csharp, js, all")
+        return
+
+    # Find source SDK directory in package
+    package_dir = PathLib(__file__).parent.parent
+    source_sdk_dir = package_dir / 'sdk'
+
+    # Target SDK directory
+    target_sdk_dir = PathLib.cwd() / 'sdk'
+
+    langs_to_create = ['cpp', 'java', 'csharp', 'javascript'] if normalized == 'all' else [normalized]
+
+    click.secho("Creating CSSL SDK files...", fg='cyan', bold=True)
+    click.echo()
+
+    for lang_name in langs_to_create:
+        _create_sdk_for_language(target_sdk_dir, lang_name)
+
+    click.echo()
+    click.secho("SDK created successfully!", fg='green', bold=True)
+    click.echo()
+    click.echo("Next steps:")
+    click.echo("  1. Copy SDK file(s) to your project")
+    click.echo("  2. Import and use CSSL.share() in your code")
+    click.echo("  3. Access instances in CSSL via lang$InstanceName")
+    click.echo()
+    click.echo("Documentation: includecpp cssl sdk --doc")
+
+
+def _create_sdk_for_language(target_dir, lang_name):
+    """Create SDK files for a specific language."""
+    from pathlib import Path as PathLib
+
+    # SDK content for each language
+    sdk_content = {
+        'cpp': _get_cpp_sdk_content(),
+        'java': _get_java_sdk_content(),
+        'csharp': _get_csharp_sdk_content(),
+        'javascript': _get_js_sdk_content(),
+    }
+
+    sdk_paths = {
+        'cpp': ('cpp', 'includecpp.h'),
+        'java': ('java/src/com/includecpp', 'CSSL.java'),
+        'csharp': ('csharp', 'IncludeCPP.cs'),
+        'javascript': ('javascript', 'includecpp.js'),
+    }
+
+    subdir, filename = sdk_paths[lang_name]
+    target_subdir = target_dir / subdir
+    target_subdir.mkdir(parents=True, exist_ok=True)
+
+    target_file = target_subdir / filename
+    target_file.write_text(sdk_content[lang_name], encoding='utf-8')
+
+    lang_display = {'cpp': 'C++', 'java': 'Java', 'csharp': 'C#', 'javascript': 'JavaScript'}
+    click.echo(f"  {lang_display[lang_name]}: {target_file}")
+
+
+def _get_cpp_sdk_content():
+    return '''/**
+ * IncludeCPP CSSL SDK for C++ (v4.2.0)
+ * Cross-language instance sharing between C++ and CSSL.
+ *
+ * USAGE:
+ *     #include "includecpp.h"
+ *
+ *     class Engine { public: int power = 100; };
+ *
+ *     int main() {
+ *         Engine engine;
+ *         CSSL::share("Engine", &engine);
+ *         // In CSSL: cpp = libinclude("c++"); engine = cpp$Engine;
+ *         return 0;
+ *     }
+ */
+#pragma once
+#include <string>
+#include <any>
+#include <unordered_map>
+#include <vector>
+#include <mutex>
+
+namespace includecpp { namespace cssl {
+class Registry {
+public:
+    static Registry& instance() { static Registry r; return r; }
+    void share(const std::string& n, std::any v) { std::lock_guard<std::mutex> l(_m); _i[n] = v; }
+    template<typename T> void share(const std::string& n, T* p) { std::lock_guard<std::mutex> l(_m); _i[n] = static_cast<void*>(p); }
+    std::any get(const std::string& n) { std::lock_guard<std::mutex> l(_m); auto it = _i.find(n); return it != _i.end() ? it->second : std::any{}; }
+    template<typename T> T* get(const std::string& n) { std::lock_guard<std::mutex> l(_m); auto it = _i.find(n); if (it != _i.end()) try { return static_cast<T*>(std::any_cast<void*>(it->second)); } catch (...) {} return nullptr; }
+    bool has(const std::string& n) { std::lock_guard<std::mutex> l(_m); return _i.count(n) > 0; }
+    bool remove(const std::string& n) { std::lock_guard<std::mutex> l(_m); return _i.erase(n) > 0; }
+    std::vector<std::string> list() { std::lock_guard<std::mutex> l(_m); std::vector<std::string> r; for (auto& p : _i) r.push_back(p.first); return r; }
+    void clear() { std::lock_guard<std::mutex> l(_m); _i.clear(); }
+private:
+    Registry() = default;
+    std::unordered_map<std::string, std::any> _i;
+    std::mutex _m;
+};
+}}
+
+namespace CSSL {
+    template<typename T> inline void share(const std::string& n, T* i) { includecpp::cssl::Registry::instance().share(n, i); }
+    inline void share(const std::string& n, std::any v) { includecpp::cssl::Registry::instance().share(n, v); }
+    template<typename T> inline T* get(const std::string& n) { return includecpp::cssl::Registry::instance().get<T>(n); }
+    inline bool has(const std::string& n) { return includecpp::cssl::Registry::instance().has(n); }
+    inline bool remove(const std::string& n) { return includecpp::cssl::Registry::instance().remove(n); }
+    inline std::vector<std::string> list() { return includecpp::cssl::Registry::instance().list(); }
+    inline void clear() { includecpp::cssl::Registry::instance().clear(); }
+}
+
+#define CSSL_SHARE(name, instance) CSSL::share(#name, instance)
+#define CSSL_GET(type, name) CSSL::get<type>(#name)
+'''
+
+
+def _get_java_sdk_content():
+    return '''/**
+ * IncludeCPP CSSL SDK for Java (v4.2.0)
+ * Cross-language instance sharing between Java and CSSL.
+ *
+ * USAGE:
+ *     import com.includecpp.CSSL;
+ *
+ *     MyService service = new MyService();
+ *     CSSL.share("MyService", service);
+ *     // In CSSL: java = libinclude("java"); svc = java$MyService;
+ */
+package com.includecpp;
+
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.List;
+import java.util.ArrayList;
+
+public class CSSL {
+    private static final ConcurrentHashMap<String, Object> instances = new ConcurrentHashMap<>();
+
+    public static void share(String name, Object instance) { instances.put(name, instance); }
+    @SuppressWarnings("unchecked")
+    public static <T> T get(String name) { return (T) instances.get(name); }
+    public static <T> T get(String name, Class<T> type) { Object o = instances.get(name); return type.isInstance(o) ? type.cast(o) : null; }
+    public static boolean has(String name) { return instances.containsKey(name); }
+    public static boolean remove(String name) { return instances.remove(name) != null; }
+    public static List<String> list() { return new ArrayList<>(instances.keySet()); }
+    public static void clear() { instances.clear(); }
+    public static int size() { return instances.size(); }
+}
+'''
+
+
+def _get_csharp_sdk_content():
+    return '''/**
+ * IncludeCPP CSSL SDK for C# (v4.2.0)
+ * Cross-language instance sharing between C# and CSSL.
+ *
+ * USAGE:
+ *     using IncludeCPP;
+ *
+ *     var service = new MyService();
+ *     CSSL.Share("MyService", service);
+ *     // In CSSL: cs = libinclude("c#"); svc = cs$MyService;
+ */
+using System.Collections.Concurrent;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace IncludeCPP
+{
+    public static class CSSL
+    {
+        private static readonly ConcurrentDictionary<string, object> _instances = new();
+
+        public static void Share(string name, object instance) => _instances[name] = instance;
+        public static T Get<T>(string name) where T : class => _instances.TryGetValue(name, out var o) ? o as T : null;
+        public static object Get(string name) => _instances.TryGetValue(name, out var o) ? o : null;
+        public static bool Has(string name) => _instances.ContainsKey(name);
+        public static bool Remove(string name) => _instances.TryRemove(name, out _);
+        public static IReadOnlyList<string> List() => _instances.Keys.ToList().AsReadOnly();
+        public static void Clear() => _instances.Clear();
+        public static int Count => _instances.Count;
+    }
+}
+'''
+
+
+def _get_js_sdk_content():
+    return '''/**
+ * IncludeCPP CSSL SDK for JavaScript (v4.2.0)
+ * Cross-language instance sharing between JavaScript and CSSL.
+ *
+ * USAGE:
+ *     const { CSSL } = require('includecpp-cssl');
+ *     // or: import { CSSL } from 'includecpp-cssl';
+ *
+ *     class DataProcessor { process(data) { return data.toUpperCase(); } }
+ *     CSSL.share('DataProcessor', new DataProcessor());
+ *     // In CSSL: js = libinclude("javascript"); proc = js$DataProcessor;
+ */
+const instances = new Map();
+
+const CSSL = {
+    share(name, instance) { instances.set(name, instance); },
+    get(name) { return instances.get(name); },
+    has(name) { return instances.has(name); },
+    remove(name) { return instances.delete(name); },
+    list() { return Array.from(instances.keys()); },
+    clear() { instances.clear(); },
+    get size() { return instances.size; }
+};
+
+if (typeof module !== 'undefined') { module.exports = { CSSL }; module.exports.default = CSSL; }
+if (typeof window !== 'undefined') { window.CSSL = CSSL; }
+export { CSSL };
+export default CSSL;
+'''
+
+
+def _show_sdk_documentation():
+    """Show detailed SDK documentation."""
+    click.secho("=" * 70, fg='cyan')
+    click.secho("  CSSL Multi-Language SDK Documentation (v4.2.0)", fg='cyan', bold=True)
+    click.secho("=" * 70, fg='cyan')
+    click.echo()
+
+    click.secho("OVERVIEW", fg='yellow', bold=True)
+    click.echo("  The CSSL SDK enables cross-language instance sharing between")
+    click.echo("  C++, Java, C#, JavaScript and CSSL scripts.")
+    click.echo()
+    click.echo("  Share an instance from any language, then access it in CSSL")
+    click.echo("  using the lang$InstanceName syntax.")
+    click.echo()
+
+    click.secho("HOW IT WORKS", fg='yellow', bold=True)
+    click.echo("  1. In your language, call CSSL.share(name, instance)")
+    click.echo("  2. In CSSL, load language support with libinclude()")
+    click.echo("  3. Access instance via lang$InstanceName")
+    click.echo()
+
+    click.secho("C++ USAGE", fg='green', bold=True)
+    click.echo('''
+    #include "includecpp.h"
+
+    class Engine {
+    public:
+        int power = 500;
+        void start() { /* ... */ }
+    };
+
+    int main() {
+        Engine engine;
+        CSSL::share("Engine", &engine);
+
+        // Alternative macro syntax:
+        // CSSL_SHARE(Engine, &engine);
+
+        return 0;
+    }
+
+    // In CSSL:
+    // cpp = libinclude("c++");
+    // engine = cpp$Engine;
+    // printl(engine.power);  // 500
+''')
+
+    click.secho("JAVA USAGE", fg='green', bold=True)
+    click.echo('''
+    import com.includecpp.CSSL;
+
+    public class Main {
+        public static void main(String[] args) {
+            MyService service = new MyService();
+            CSSL.share("MyService", service);
+
+            // Check if exists
+            if (CSSL.has("MyService")) {
+                MyService s = CSSL.get("MyService", MyService.class);
+            }
+        }
+    }
+
+    // In CSSL:
+    // java = libinclude("java");
+    // service = java$MyService;
+    // service.doSomething();
+''')
+
+    click.secho("C# USAGE", fg='green', bold=True)
+    click.echo('''
+    using IncludeCPP;
+
+    class Program {
+        static void Main() {
+            var handler = new DataHandler();
+            CSSL.Share("DataHandler", handler);
+
+            // List all shared
+            foreach (var name in CSSL.List()) {
+                Console.WriteLine(name);
+            }
+        }
+    }
+
+    // In CSSL:
+    // cs = libinclude("c#");
+    // handler = cs$DataHandler;
+    // handler.Process(data);
+''')
+
+    click.secho("JAVASCRIPT USAGE", fg='green', bold=True)
+    click.echo('''
+    const { CSSL } = require('includecpp-cssl');
+    // or: import { CSSL } from 'includecpp-cssl';
+
+    class DataProcessor {
+        process(data) {
+            return data.toUpperCase();
+        }
+    }
+
+    CSSL.share('DataProcessor', new DataProcessor());
+    console.log(CSSL.list());  // ['DataProcessor']
+
+    // In CSSL:
+    // js = libinclude("javascript");
+    // processor = js$DataProcessor;
+    // result = processor.process("hello");
+''')
+
+    click.secho("CSSL SIDE (Complete Example)", fg='green', bold=True)
+    click.echo('''
+    // Load language support
+    cpp = libinclude("c++");
+    java = libinclude("java");
+    cs = libinclude("c#");
+    js = libinclude("javascript");
+
+    // Access shared instances
+    engine = cpp$Engine;
+    service = java$MyService;
+    handler = cs$DataHandler;
+    processor = js$DataProcessor;
+
+    // Use them
+    printl("Engine power: " + engine.power);
+    service.doSomething();
+    handler.Process(data);
+    result = processor.process("hello");
+
+    // Cross-language inheritance
+    class TurboEngine : extends cpp$Engine {
+        int boost;
+
+        constr TurboEngine(int b) {
+            this->boost = b;
+        }
+    }
+''')
+
+    click.secho("API REFERENCE", fg='yellow', bold=True)
+    click.echo('''
+    Method             Description
+    ---------------    ------------------------------------------
+    share(name, obj)   Share an instance by name
+    get(name)          Get a shared instance
+    has(name)          Check if instance exists
+    remove(name)       Remove a shared instance
+    list()             Get all instance names
+    clear()            Clear all instances
+    size/Count         Number of shared instances
+''')
+
+    click.secho("GENERATE SDK FILES", fg='yellow', bold=True)
+    click.echo('''
+    includecpp cssl sdk cpp        # C++ SDK
+    includecpp cssl sdk java       # Java SDK
+    includecpp cssl sdk csharp     # C# SDK
+    includecpp cssl sdk js         # JavaScript SDK
+    includecpp cssl sdk all        # All SDKs
+''')
+
+
 # Register hidden cssl command group
 cli.add_command(cssl)