🚀 LLP Programming Language (lolpaon) • Extension v1.5.6

Welcome to the official VS Code extension for the LLP programming language (lolpaon language), an ecosystem engineered to combine simplicity, power, hierarchical object architecture (Parent-Child Instance Tree), drag-and-drop declarative visual UI design (.illp), encrypted database storage (.cllpdb), and lightning-fast Linux server deployment.

🌟 What's New in Version 1.5.6

• 🎨 Full ILLP & ILLPS GUI Engine & Real-Time Browser Rendering:
  • Complete Component Compiler: Native parsing and tree compilation for all declarative interface elements (Background, Card, Row, Grid, Column, Text, Button, TextInput, ProgressBar, ItemBox, Checkbox, Image).
  • Stylesheet (.illps) Live Integration: Direct mapping of companion .illps stylesheets into scoped CSS with selector auto-mapping (Tag#Id and Tag.Class), support for gradients, shadows, padding, custom borders, and modern glassmorphism (backdrop-filter: blur(...)).
  • Interactive Feedback: Native responsive action triggers with animated notification toasts on button clicks and inputs.
• 🛡️ Resilient Dynamic GUI Port Binding:
  • Automatically detects port conflicts (EADDRINUSE) and safely switches to the next available TCP port (4876, 4877...) without crashing.
• 💡 Comprehensive Hover Tooltips for .illps, Phone & ProcessIO:
  • Interface Stylesheet (.illps): Full multilingual documentation on hover for style properties (background, color, fontSize, borderRadius, padding, margin, marginBottom, border, responsive, align, width, height, opacity, backdrop-filter, etc.) and selectors.
  • Mobile & Telephony (Phone): Rich hover descriptions for incoming calls, dialing, audio route switching, vibration, battery, GPS, and sensors.
  • Process I/O (ProcessIO): Complete hover documentation for spawning subprocesses and piping STDOUT/STDERR/STDIN.
• ✨ Context-Aware Autocomplete for .illps and Hardware:
  • Instant completions for stylesheet block rules and CSS-style properties inside .illps files.
  • Autocomplete method proposals when typing Phone. and ProcessIO..
• 🌍 Standardized International English Scaffolding:
  • All project templates generated via llp create and CLI examples are fully written in English.
• 🐛 Static Analyzer & Diagnostics Parser Fix:
  • Resolved false-positive syntax errors underlining closing end statements in functions, classes, modules, and namespaces declared with then.

🌟 What's New in Version 1.5.4

• 🎨 Enhanced Syntax Highlighting (Functions, Modules, Booleans, Classes & Final Constants):
  • Functions & Declarations: First-class coloring for function and func declaration statements across all VS Code themes (storage.type.function.llp keyword.declaration.function.llp).
  • Boolean Literals (True & False): Native support for Python/Pascal-style True and False as well as true and false (constant.language.boolean.llp).
  • Modules & Namespaces: Scoped highlighting for imported/used modules (import, use, from) and standard library modules (Math, Crypto, Network, Sync, Validator, Device, Server, Client, Database, CLLPDB, Instance, RPC, App, Session, Bitwise, ByteBuffer, Ethernet, IP, Socket, NetOptimizer, NetworkProfiler, Phone, ProcessIO).
  • Built-in & PascalCase Classes: Distinct class styling for standard LLP classes and any custom user class beginning with an uppercase letter (entity.name.type.class.llp support.class.llp).
  • Final Variables & Constants (PY, PI, RPC_PORT): Distinctive theme coloring for universal constants (PY, PI, E), all-caps screaming snake case identifiers (RPC_PORT, MAX_USERS, etc.), and variables declared with const / final.
  • Scopes for Architecture: Added syntax scopes for class, package, namespace, and interface.
• 📦 Complete Functional Product Management Example (examples/product_management/):
  • Account Authentication: Secure login against encrypted .cllpdb database (admin / admin123 or gestionnaire / secret456).
  • Inactivity Session Management: 2 minutes of idle time automatically triggers an interactive 45-minute countdown modal before session termination and database lock, with a "Stay Connected" reset action and a 1-click DevMode test button.
  • Live Catalog & Real-Time Filtering: Instant client-side search and category filtering with persistent add and delete capabilities in .cllpdb.
• ⚡ Low-Level OSI Stack (Layers 1-7) & Systems Programming (C++ Parity):
  • Layers 1 & 2 (Physical & Data Link): Direct memory manipulation via ByteBuffer.Alloc(), typed Big/Little Endian reads/writes, bitwise operators (Bitwise.And/Or/Xor/ShiftLeft), and raw Ethernet II frame crafting with CRC-32 (Ethernet.BuildFrame, Ethernet.CRC32).
  • Layer 3 (Network): IPv4 packet forging (IP.BuildIPv4Header) and RFC 1071 16-bit Internet checksum calculation (IP.Checksum).
  • Layer 4 (Transport): Berkeley Sockets API (Socket.Create, Connect, Bind, Send, Recv, SendTo, RecvFrom, SetSockOpt) with TCP_NODELAY to eliminate Nagle's latency for immediate dispatch.
  • Layers 5-7 (Session, Presentation & Application): Binary struct packing via NetOptimizer.PackBinary() cutting network payload size by up to 88% compared to JSON, and stream compression (NetOptimizer.Compress).
• 📊 Independent Resource & Network Performance Monitor (llp.openPerformanceMonitor):
  • Real-Time Companion Panel: Completely isolated from project scripts; monitors CPU (%), RAM (MB), GPU (acceleration, VRAM estimate, FPS), and Network IN/OUT (RX/TX) metrics.
  • Bandwidth Minimization Meter: Measures exact bytes received and sent to help developers reduce data transferred over local and remote networks.
  • Dual-Series Live Chart: Real-time SVG graph tracking RX in cyan and TX in emerald.
• 📱 Official Phone & Mobile Hardware Library (Phone) & Process Streaming (ProcessIO):
  • Telephony & Call Lifecycle: Phone.OnIncomingCall, Phone.OnCallAnswered, Phone.OnCallEnded, Phone.Dial, Phone.Answer, Phone.Hangup.
  • Audio & Microphone Routing: Phone.GetAudioInputs, Phone.GetAudioOutputs, Phone.SetAudioRoute (speaker, earpiece, bluetooth, headset), audio recording and playback.
  • Camera & Sensors: Phone.GetCameras, Phone.CapturePhoto, Phone.SetFlashlight, Phone.Vibrate, Phone.GetBattery, Phone.GetGPS, Phone.GetNetworkInfo.
  • Process I/O Streaming (ProcessIO): Spawn sub-processes and monitor STDOUT, STDERR, and STDIN in real-time across mobile terminals and desktops.
• 🖥️ Accurate Visual Designer & UI Builder Rendering (.illp & .illps):
  • True-to-File Canvas State: Empty .illp files render an authentic, clean blank white page (#ffffff) without fallback mock widgets.
  • Dynamic .illps Compilation: Live compilation of companion .illps stylesheets into scoped CSS injected into the preview.
• 📁 New File & Component Creator UI (Explorer Title, Context Menu, Status Bar & Tree View):
  • Dedicated Explorer View (LLP File Creator & Templates): Interactive sidebar view with a + creation button for Classes, Pure Classes, Packages, Interfaces, Styles, Scripts, and Databases.

📑 Table of Contents

1. Architecture & File Extensions
2. Visibility System & File Hierarchy
3. Comment Syntax & Embedded Executable Code
4. Types & Variables
5. Logical & Mathematical Operators
6. Control Structures (then ... end)
7. Parent-Child Architecture (Instance Tree)
8. GUI Interface Creation (.illp & .illps)
9. Standard Libraries (StdLib)
10. Encrypted Database System (.cllpdb)
11. CLI Commands & Tooling
12. Linux VPS / Dedicated Server Deployment (LLP-Server)
13. VS Code Extension Features
14. Release History (Changelog)

📂 Architecture & File Extensions

The LLP ecosystem relies on specialized file formats:

🔒 Visibility System & File Hierarchy

All files (.llp, .illp, .illps) specify their access scope on the very first line:

visibility: All

Available Visibility Levels:

• visibility: All : Completely public and accessible across the entire project.
• visibility: Package : Visible only to other files residing within the same directory/package.
• visibility: Parent : Accessible by the parent folder and all of its subdirectories.
• visibility: Private : Strictly isolated; completely inaccessible to external files.

💬 Comment Syntax & Embedded Executable Code

1. Single-line Comment: /-

/- This is a single-line comment
int score = 100

2. Multi-line Block Comment: /* ... *\

/*
   This comment block can span
   freely across multiple lines.
*\

3. Inline Comment with Embedded Executable Code: /- ... { code } \

Annotate your code while maintaining an active inline statement:

/- Initialize secret token { Global secretToken = 999 } end of note \
print("Active token:", secretToken) /- Prints 999

💡 Dynamic Highlighting: In VS Code, comment text remains subtly dimmed, whereas statements inside { ... } are instantly highlighted in full syntax colors!

🧱 Types & Variables

LLP seamlessly blends dynamic typing via General (or its alias Global) with strict static typing:

General projectName = "Lolpaon Studio" /- Dynamic (can be reassigned to any type)
Global counter = 0                     /- Alias of General
string author = "lolpaon"              /- Strict string
int year = 2026                        /- Strict integer
float version = 1.4                    /- Strict float
bool isActive = true                   /- Strict boolean

Resizable Lists and Fixed-Size Arrays:

/- Dynamic resizable list \
General modules = General{"Database", "Network", "UI"}
modules.Add("Security")

/- Fixed-size array \
General memory = General[3]{"BlockA", "BlockB", "BlockC"}

⚙️ Logical & Mathematical Operators

• Arithmetic : +, -, *, /, %
• Comparison : ==, !=, <, <=, >, >=
• Logical : and, or, not

if userAge >= 18 and isActive then
    print("Access granted.")
end

🔁 Control Structures (then ... end)

No mandatory curly braces for control structures:

/- If-Else condition \
if score > 90 then
    print("Excellent work")
else
    print("Passed")
end

/- While loop \
int i = 0
while i < 5 then
    print("Iteration:", i)
    i = i + 1
end

/- For ... In loop \
for item in modules then
    print("Loaded module:", item)
end

🌲 Parent-Child Architecture (Instance Tree)

Inspired by modern game engines and hierarchical object systems, LLP unifies all software components under a single Parent-Child tree:

General appRoot = Instance.new("Folder")
appRoot.Name = "MainApplication"

General dataService = Instance.new("Folder")
dataService.Name = "DataService"
dataService.Parent = appRoot

General tableUsers = Instance.new("Configuration")
tableUsers.Name = "UsersTable"
tableUsers.Parent = dataService

General target = appRoot.FindFirstChild("DataService")
print("Found service:", target.Name)

🎨 GUI Interface Creation (.illp & .illps)

Interface Declaration (main.illp):

visibility: All

Background "MainWindow" responsive: true minWidth: "800px" maxWidth: "1200px" minHeight: "650px" {
    Card "HeaderCard" title: "LLP Dashboard" {
        Row "HeaderRow" {
            Image "OfficialLogo" src: "assets/logo.png"
            Text "AppTitle" content: "⚡ Lolpaon Pro Application"
        }
    }

    Row "ContentRow" {
        Card "UsersCard" title: "Active Sessions" {
            DataGrid "UsersGrid" {
                columns: ["ID", "Username", "Role"]
                rpc: "Users.List"
            }
        }
    }
}

Styling Sheet (main.illps):

visibility: All

Background.MainWindow {
    background: #0b0f19
    padding: 24px
    responsive: true
}

Card#HeaderCard {
    background: [#111827](https://github.com/lolpaoncreation/LLP-Server/issues/111827)
    borderRadius: 12px
    padding: 16px
    marginBottom: 16px
}

Text#AppTitle {
    color: #38bdf8
    fontSize: 20px
    font: bold
}

📚 Standard Libraries (StdLib)

LLP bundles 9 built-in standard libraries:

1. Math : Mathematical functions, universal constants (PY, E), trigonometry, and rounding.
2. SciLlp : Scientific computing (means, standard deviations, moving averages, convolution, FFT).
3. SymLlp : Symbolic mathematics (formal differentiation, polynomial simplification, factorization).
4. ProbLlp : Probability and statistics (Gaussian, Poisson, binomial distributions, cryptographic random sampling).
5. Device : Hardware anti-spoofing fingerprinting (HWID) and Ed25519 signing.
6. Session : PHP-style secure session management for backend servers and client apps.
7. CLLPDB : High-performance encrypted database engine with table relational storage.
8. File : Complete filesystem I/O operations (file reading, writing, directories, metadata).
9. Network & Server : High-performance HTTP/RPC server with Concurrency Orchestrator load balancing.

🗄️ Encrypted Database System (.cllpdb)

• Creation via VS Code: Ctrl + Shift + P ➔ LLP: Create Encrypted Database (.cllpdb).
• AES-256 Encryption & PBKDF2: Bound to the project key stored in project.config.
• Configurable Session Lifetime: Indefinite / permanent by default in code (db.StartSession("admin", "password")), or with custom expiration timeouts.
• Integrated Visual Editor: Double-click any .cllpdb file in the VS Code explorer to open the interactive database manager with an SQL query console, table browser, and record insertion tools!

💻 CLI Commands & Tooling

# Run an LLP script
llp run script.llp

# Launch dedicated backend server
llp server server.llp --port 8080

# Launch interactive GUI application
llp app

# Open the Visual UI Builder
llp builder client/views/main.illp

# Statically analyze and lint code
llp check script.llp

# Build standalone executables
llp build --client
llp build --server
llp build

🌐 Linux VPS / Dedicated Server Deployment (LLP-Server)

Official Server Repository: https://github.com/lolpaoncreation/LLP-Server.git

1-Liner Automated SSH Command:

curl -fsSL https://raw.githubusercontent.com/lolpaoncreation/LLP-Server/main/install-vps.sh | sudo bash

The script automatically detects your Linux distribution (Ubuntu, Debian, CentOS, RHEL, Arch), installs Node.js 20 LTS, builds LLP, configures /var/www/llp-server/server.llp, opens firewall ports, and sets up a 24/7 Systemd service (llp-server.service).

🛠️ VS Code Extension Features

• 🎨 WYSIWYG Visual Designer: Live drag-and-drop preview and instant visual editing for .illp interfaces and .illps stylesheets.
• 🌍 Multilingual Interactive Documentation:
  • Universal English by default, with instant on-the-fly switching between English, French (Français), Spanish (Español), and German (Deutsch).
  • Accessible via Ctrl + Shift + P ➔ LLP: Open Interactive Documentation or by right-clicking any keyword ➔ LLP: Open Documentation for Keyword.
• 🗄️ Custom Editor for .cllpdb: Click any encrypted database file in the file explorer to open the visual manager with SQL execution and table viewing.
• ⚡ Autocomplete & Real-Time Diagnostics:
  • Real-time semantic syntax error detection and hierarchy validation.
  • Comprehensive code snippets (vis-all, ifthen, forend, ui-illp, ui-illps, cllpdb-open).
• 📦 Project Generators:
  • LLP: Create New Empty Project (choose between Client/Server or Monolithic architecture).
  • LLP: Create Example Project (Product Management).

📜 Complete Release History & Changelog

🚀 Version 1.5.4 (Current Version)

• Vibrant Syntax Highlighting for Functions, Modules, Booleans, Classes & Final Constants:
  • Distinct, vivid syntax scopes for function and func declaration statements (storage.type.function.llp keyword.declaration.function.llp).
  • Built-in and user-defined module highlighting (import, use, Math, Crypto, Network, Sync, Validator, etc.).
  • Boolean value styling for Python/Pascal-style True and False as well as true and false (constant.language.boolean.llp).
  • Distinctive styling for base language classes (CLLPDB, Device, Server, Client, Database, Instance, etc.) and all capitalized/PascalCase classes (entity.name.type.class.llp support.class.llp).
  • Dedicated constant/Final variable coloring for universal constants (PY, PI), all-caps screaming snake case identifiers (RPC_PORT, MAX_USERS, etc.), and const / final declarations (variable.other.constant.llp constant.other.caps.llp entity.name.constant.llp).
  • Updated diagnostics.js AST analyzer and autocompleteEngine.js with instant keyword and snippet completion for True, False, PI, RPC_PORT.
• Accurate Visual Designer & UI Builder Canvas:
  • Fixed an issue where opening an empty .illp file displayed hardcoded mock components (Header, DataGrid, Kanban, FormSection).
  • Removed mock fallback injection: empty .illp files now render an authentic blank white page canvas (#ffffff) with 0 elements.
  • Added live compiler for .illps stylesheet rules (convertIllpsToCss), dynamically injecting custom backgrounds, padding, and borders into the webview preview.
  • Added renderer and parser support for Row, Column, Container, and Image components.
• New File & Component Creator UI System:
  • Added dedicated Explorer sidebar view LLP File Creator & Templates with a title bar + button ($(file-add)).
  • Implemented 1-click file generation for:
    • 📦 Class (.llp) : Object-oriented class with constructor, fields, and getter/setter.
    • 🏛️ Pure Class (.cllp) : Isolated single class file matching the file name.
    • 📁 Package (Namespace) : Modular directory package with package.llp initializer.
    • 🎨 Interface (.illp) : Declarative UI layout with automatic companion .illps stylesheet prompt.
    • 🖌️ Interface Style (.illps) : Dedicated styling sheet with colors, padding, and borders.
    • ⚡ Script (.llp) : General runnable LLP executable script.
    • 🗄️ Encrypted Database (.cllpdb) : AES-256 encrypted local database.
  • Added Explorer right-click context menu options (explorer/context) with target directory awareness.
  • Added status bar item ($(file-add) New LLP File) and editor title bar action for immediate access.

⚡ Version 1.5.3

• VS Code Marketplace Readiness & Publication Compliance:
  • Unified all documentation, schemas, and release notes to English standards required for marketplace distribution.
  • Packaged compliant .vsix ready for direct publishing to the Visual Studio Code Marketplace and Open VSX Registry.
• Standardized Read-Only Engine & Project Templates:
  • Synchronized versioning across compiler, project templates, DLL binary builder, and CLI toolchain to 1.5.3.

⚡ Version 1.5.2

• Critical Grammar Fix (var Removal):
  • Completely eliminated the non-existent var keyword from all project templates (client-server and monolithic).
  • Enforced explicit typing using native LLP types: string, int, float, bool, and General.
• Standardized Module & Method Signatures:
  • Replaced invalid Device.GetHardwareID() with the official Device.GetId() method.
  • Replaced pseudo-calls RPC.Call() with official network client methods (Client.Connect()).
  • Replaced Server.RegisterRPC() and Server.Start() with Server.Listen(port).
  • All generated project code passes the static code analyzer with 0 errors and 0 red underlines.
• Clean White Interface by Default:
  • main.illp and main.illps templates now render a minimal, pure white canvas (#ffffff) without demo cards or clutter.
• Interactive Root Database Setup (.cllpdb):
  • Prompt the developer for a custom root username (default: root) and password during project creation.
  • Initialize the encrypted database file with these exact credentials and authenticate automatically in startup scripts.
• Dynamic GUI Server Resolution (app_runner.ts):
  • Dynamically locates .illp views and .cllpdb databases inside any project structure, eliminating missing-file errors.

⚡ Version 1.5.1

• Fixed VS Code Freezing on Project Creation:
  • Replaced the immediate blocking modal Windows showOpenDialog (which hung Electron's Extension Host) with a non-blocking QuickPick menu:
    • 1-click selection of the currently active workspace directory.
    • 1-click selection of user home directory.
    • Manual absolute path entry.
    • System Explorer file dialog only opened upon explicit selection.
• Eliminated Blocking execSync('attrib') Subprocesses:
  • Removed child process spawning (cmd.exe /c attrib) on the single-threaded Extension Host; replaced with native Win32 fs.chmodSync executing in microseconds.
• Progress Notification & Robust Error Handling:
  • Wrapped project creation in vscode.window.withProgress with real-time UI feedback.
  • Handled exceptions with try...catch and clean error notifications.
  • Added an interactive completion dialog offering to open the created project folder directly in VS Code.

🎨 Version 1.5.0

• Official LLP File Icons Theme:
  • Registered and contributed llp-icon-theme with official peacock logos for .llp, .illp, .illps, and .cllpdb files.
  • Added command: LLP: Activate LLP File Icons Theme.
• Clean Project Scaffolding Without Forced Logos:
  • Removed language logo asset copying from user-generated projects (clean projects without third-party assets).
• Strict Read-Only Library Protection (lib/ contains strictly .dll):
  • Enforced that the lib/ directory exclusively contains .dll binary libraries locked in read-only mode (0o444 / Win32 Read-Only).
  • Auto-generated all 9 standard language libraries: math.dll, scillp.dll, symllp.dll, probllp.dll, cllpdb.dll, sync.dll, crypto.dll, network.dll, validator.dll with the LLPDLL\x01\x00 magic binary header.
  • Added commands: LLP: Add Library (.dll) to Project (Read-Only) and LLP: Verify & Protect lib/ Directory.
• CLI Toolchain Integration into VS Code Terminal & System PATH:
  • Injected the bin/ directory into the PATH of all VS Code integrated terminals via environmentVariableCollection.prepend.
  • Added command: LLP: Add LLP CLI to Windows PATH for permanent system-wide external console access.
  • Bundled multi-platform launcher scripts: bin/llp (Bash/Linux/macOS), bin/llp.cmd (Windows CMD), bin/llp.ps1 (PowerShell).

🦚 Version 1.4.3

• Integrated the official Peacock emblem (lolpaon) throughout the marketplace, sidebar, interactive documentation, and Visual UI Builder.
• Streamlined VSIX distribution package.

🌐 Version 1.4.2

• Native integration with the official dedicated server repository LLP-Server.
• 1-liner automated Linux VPS installer (install-vps.sh).
• 24/7 Systemd daemon service (llp-server.service), Nginx reverse proxy configuration, and Docker / Docker Compose containers.

📖 Version 1.4.1

• Header logo rendering in interactive documentation webviews and UI Builder.
• Improved CSS scoping and isolation across extension panels.

🌍 Version 1.4.0

• Integrated multilingual interactive documentation supporting 4 languages (English, French, Spanish, German) with on-the-fly live switching.
• Architectural separation into Client / Server (Distributed) and Monolithic (Standalone) project modes.

🎛️ Version 1.3.0

• Application lifecycle controllers: App.Launch, App.Lock, App.Silence, App.Close.
• Added background service mode (RunBack: True).

🗄️ Version 1.2.0

• Visual editor and management panel for encrypted .cllpdb databases (AES-256-CBC).
• Implemented the 9 standard libraries (mathematics, scientific computing, symbolic calculus, probability, networking, etc.).

🔍 Version 1.1.0

• Real-time AST static code analyzer and linter (diagnostics.js).
• Context-aware autocomplete engine with Levenshtein-distance typo correction.

🚀 Version 1.0.0

• Initial release: TextMate syntax highlighting for .llp, .illp, .illps, .cllp, language configuration, and code snippets.

LLP Ecosystem (lolpaon) • Engineered for modern, clean, and powerful software development.