Add README files

Author: dragomano

README.md

@@ -0,0 +1,103 @@
+# sass-embedded-php
+
+![PHP](https://img.shields.io/badge/PHP-^8.2-blue.svg?style=flat)
+[![Coverage Status](https://coveralls.io/repos/github/dragomano/sass-embedded-php/badge.svg?branch=main)](https://coveralls.io/github/dragomano/sass-embedded-php?branch=main)
+
+> Created for research purposes, not for use on production sites!
+
+PHP wrapper for [sass-embedded](https://www.npmjs.com/package/sass-embedded) (Dart Sass via Node.js).
+
+Allows compiling SCSS/SASS to CSS through PHP using Node.js and npm.
+
+---
+
+## Requirements
+
+- PHP >= 8.2
+- Node.js >= 18
+
+---
+
+## Installation via Composer
+
+```bash
+composer require bugo/sass-embedded-php
+```
+
+## Usage examples
+
+### Compiling SCSS file
+
+```php
+<?php
+require __DIR__ . '/vendor/autoload.php';
+
+use Bugo\Sass\Compiler;
+
+$compiler = new Compiler();
+
+$css = $compiler->compileFile(__DIR__ . '/assets/app.scss');
+
+file_put_contents(__DIR__ . '/assets/app.css', $css);
+
+echo "CSS compiled!\n";
+```
+
+### Compiling SCSS from string
+
+```php
+<?php
+require __DIR__ . '/vendor/autoload.php';
+
+use Bugo\Sass\Compiler;
+
+$compiler = new Compiler();
+
+$scss = '$color: red; body { color: $color; }';
+$css = $compiler->compileString($scss);
+
+echo $css;
+```
+
+### Safe compilation
+
+```php
+require __DIR__ . '/vendor/autoload.php';
+
+use Bugo\Sass\Exception;
+use Bugo\Sass\Compiler;
+
+$compiler = new Compiler();
+
+$scss = <<<'SCSS'
+$color: #e74c3c;
+.foo { color: $color; }
+SCSS;
+
+try {
+    echo $compiler->compileString($scss);
+} catch (Exception $e) {
+    echo "Compilation error: " . $e->getMessage();
+}
+```
+
+## Parameters
+
+Paths to bridge.js and Node are specified only through the constructor:
+
+```php
+$compiler = new Compiler('/path/to/bridge.js', '/path/to/node');
+```
+
+Other parameters can be set either for the entire compiler at once or for a specific method separately:
+
+```php
+$compiler->setOptions([
+    'syntax' => 'sass', // 'scss' | 'sass'
+    'compressed' => true, // false | true
+]);
+````
+```php
+$compiler->compileString($string, ['syntax' => 'sass']);
+$compiler->compileFile($file, ['compressed' => true]);
+```

README.ru.md

@@ -0,0 +1,103 @@
+# sass-embedded-php
+
+![PHP](https://img.shields.io/badge/PHP-^8.2-blue.svg?style=flat)
+[![Coverage Status](https://coveralls.io/repos/github/dragomano/sass-embedded-php/badge.svg?branch=main)](https://coveralls.io/github/dragomano/sass-embedded-php?branch=main)
+
+> Создано в исследовательских целях, не для использования на рабочих сайтах!
+
+PHP-обёртка для [sass-embedded](https://www.npmjs.com/package/sass-embedded) (Dart Sass через Node.js).
+
+Позволяет компилировать SCSS/SASS в CSS через PHP, используя Node.js и npm.
+
+---
+
+## Требования
+
+- PHP >= 8.2
+- Node.js >= 18
+
+---
+
+## Установка через Composer
+
+```bash
+composer require bugo/sass-embedded-php
+```
+
+## Примеры использования
+
+### Компиляция файла SCSS
+
+```php
+<?php
+require __DIR__ . '/vendor/autoload.php';
+
+use Bugo\Sass\Compiler;
+
+$compiler = new Compiler();
+
+$css = $compiler->compileFile(__DIR__ . '/assets/app.scss');
+
+file_put_contents(__DIR__ . '/assets/app.css', $css);
+
+echo "CSS скомпилирован!\n";
+```
+
+### Компиляция SCSS из строки
+
+```php
+<?php
+require __DIR__ . '/vendor/autoload.php';
+
+use Bugo\Sass\Compiler;
+
+$compiler = new Compiler();
+
+$scss = '$color: red; body { color: $color; }';
+$css = $compiler->compileString($scss);
+
+echo $css;
+```
+
+### Безопасная компиляция
+
+```php
+require __DIR__ . '/vendor/autoload.php';
+
+use Bugo\Sass\Exception;
+use Bugo\Sass\Compiler;
+
+$compiler = new Compiler();
+
+$scss = <<<'SCSS'
+$color: #e74c3c;
+.foo { color: $color; }
+SCSS;
+
+try {
+    echo $compiler->compileString($scss);
+} catch (Exception $e) {
+    echo "Ошибка компиляции: " . $e->getMessage();
+}
+```
+
+## Параметры
+
+Пути к bridge.js и Node указываются только через конструктор:
+
+```php
+$compiler = new Compiler('/path/to/bridge.js', '/path/to/node');
+```
+
+Остальные параметры можно включать как для всего компилятора сразу, так и для конкретного метода отдельно:
+
+```php
+$compiler->setOptions([
+    'syntax' => 'sass', // 'scss' | 'sass'
+    'compressed' => true, // false | true
+]);
+````
+```php
+$compiler->compileString($string, ['syntax' => 'sass']);
+$compiler->compileFile($file, ['compressed' => true]);
+```