Migrace na Debian PHP autoloader systém

- Aktualizován debian/README.Debian s instrukcemi pro Debian autoloader
- Přechod z vendor/autoload.php na /usr/share/php/*/autoload.php
- Využití pkg-php-tools a phpab pro generování autoloaderu
- Dokumentace pro migraci existujících aplikací

Author: Vitexus

WARP.md

@@ -0,0 +1,74 @@
+# WARP.md - Working AI Reference for php-vitexsoftware-ease-html-widgets
+
+## Project Overview
+**Type**: PHP Project/Debian Package
+**Purpose**: Welcome to the VitexSoftware Ease HTML Widgets project! This repository contains a collection of reusable HTML widgets for PHP applications.
+**Status**: Active
+**Repository**: git@github.com:VitexSoftware/php-vitexsoftware-ease-html-widgets.git
+
+## Key Technologies
+- PHP
+- Composer
+- Debian Packaging
+
+## Architecture & Structure
+```
+php-vitexsoftware-ease-html-widgets/
+├── src/           # Source code
+├── tests/         # Test files
+├── docs/          # Documentation
+└── ...
+```
+
+## Development Workflow
+
+### Prerequisites
+- Development environment setup
+- Required dependencies
+
+### Setup Instructions
+```bash
+# Clone the repository
+git clone git@github.com:VitexSoftware/php-vitexsoftware-ease-html-widgets.git
+cd php-vitexsoftware-ease-html-widgets
+
+# Install dependencies
+composer install
+```
+
+### Build & Run
+```bash
+dpkg-buildpackage -b -uc
+```
+
+### Testing
+```bash
+composer test
+```
+
+## Key Concepts
+- **Main Components**: Core functionality and modules
+- **Configuration**: Configuration files and environment variables
+- **Integration Points**: External services and dependencies
+
+## Common Tasks
+
+### Development
+- Review code structure
+- Implement new features
+- Fix bugs and issues
+
+### Deployment
+- Build and package
+- Deploy to target environment
+- Monitor and maintain
+
+## Troubleshooting
+- **Common Issues**: Check logs and error messages
+- **Debug Commands**: Use appropriate debugging tools
+- **Support**: Check documentation and issue tracker
+
+## Additional Notes
+- Project-specific conventions
+- Development guidelines
+- Related documentation

debian/README.Debian

@@ -1,8 +1,76 @@
 php-vitexsoftware-ease-html-widgets for Debian
+===============================================
 
-Please edit this to provide information specific to
-this php-vitexsoftware-ease-html-widgets Debian package.
+PHP Autoloader
+--------------
 
-    (Automatically generated by debmake Version 4.4.0)
+This package uses the **Debian PHP autoloader system** (pkg-php-tools).
 
- -- Vítězslav Dvořák <info@vitexsoftware.cz>  Sat, 19 Oct 2024 11:12:51 +0200
+Classes are installed in: `/usr/share/php/Ease/Html/Widgets`
+Autoloader: `/usr/share/php/Ease/Html/Widgets/autoload.php`
+
+To use in your PHP code:
+
+```php
+require_once '/usr/share/php/Ease/Html/Widgets/autoload.php';
+```
+
+The autoloader is automatically generated by `phpab` during package build and 
+includes all package classes with proper dependency loading.
+
+**Note:** This package NO LONGER ships vendor/autoload.php from Composer.
+Use the Debian autoloader instead for proper system integration.
+
+Installation
+------------
+
+For Debian, Ubuntu & friends please use repo:
+
+```shell
+sudo apt install lsb-release wget
+echo "deb http://repo.vitexsoftware.cz $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
+sudo wget -O /etc/apt/trusted.gpg.d/vitexsoftware.gpg http://repo.vitexsoftware.cz/keyring.gpg
+sudo apt update
+sudo apt install php-vitexsoftware-ease-html-widgets
+```
+
+Composer Integration
+--------------------
+
+If using Composer in your application, you can reference the Debian package:
+
+```json
+{
+    "require": {
+        "deb/vitexsoftware-ease-html-widgets": "*"
+    },
+    "repositories": [
+        {
+            "type": "path",
+            "url": "/usr/share/php/Ease/Html/Widgets",
+            "options": {
+                "symlink": true
+            }
+        }
+    ]
+}
+```
+
+Migration from Composer vendor/autoload.php
+--------------------------------------------
+
+If you're migrating from Composer's autoloader, replace:
+
+```php
+require_once __DIR__ . '/../vendor/autoload.php';
+```
+
+with:
+
+```php
+require_once '/usr/share/php/Ease/Html/Widgets/autoload.php';
+```
+
+This ensures you're using the system-wide Debian packages instead of bundled dependencies.
+
+ -- VitexSoftware <info@vitexsoftware.cz>  Tue Mar 03 23:31:41 CET 2026