feat: VivesPOS landing on Winter CMS 1.2 — theme + plugin + Dockerfile
Some checks are pending
Module sub-split / Sub-split (push) Waiting to run

- Base: wintercms/winter branch 1.2 (full framework)
- Theme vivespos: Canvas 7 + Bootstrap 5 CDN, custom CSS
- Layout: deferred GTM/GA4 tracking, JSON-LD SoftwareApplication
- Partials: hero (offline-first), features, modes (offline/nube toggle),
  screenshots, pricing (3 planes), comparison, FAQ, CTA
- Plugin VivesPOS.Site with ContactForm
- Dockerfile: PHP 8.2 Apache, port 80, healthcheck
- Added winter/wn-pages, blog, sitemap, seo plugins
- Active theme set to vivespos
This commit is contained in:
2026-08-21 19:29:00 -06:00
commit 1f72193a64
3266 changed files with 531480 additions and 0 deletions

View File

@@ -0,0 +1,232 @@
<?php
namespace System\Tests\Classes\Asset;
use System\Classes\Asset\BundleManager;
use System\Tests\Bootstrap\TestCase;
class BundleManagerTest extends TestCase
{
protected BundleManager $bundleManager;
public function setUp(): void
{
parent::setUp();
// Reset the bundle manager
BundleManager::forgetInstance();
// Bind the instance for convenience
$this->bundleManager = BundleManager::instance();
}
/**
* Test the registerBundles & registerBundle functions correctly allow the user to append bundles
*/
public function testRegisterBundles(): void
{
$defaultBundles = $this->bundleManager->getBundles();
$this->bundleManager->registerBundles([
'winter1js' => [
'winter1js' => 'v1.0.0'
]
]);
$this->bundleManager->registerBundle('winter2js', [
'winter2js' => 'v1.0.0'
]);
$bundles = $this->bundleManager->getBundles();
$this->assertCount(count($defaultBundles) + 2, $bundles);
$this->assertContains('winter1js', $bundles);
$this->assertContains('winter2js', $bundles);
}
/**
* This test ensures that defining new bundles does not affect the default bundles
*/
public function testRegisterBundlesDoesNotBreakDefaults(): void
{
// Get the default bundles so we can validate them existing later
$defaultBundles = $this->bundleManager->getBundles();
// Flush the instance as if we have just booted
BundleManager::forgetInstance();
$this->bundleManager = BundleManager::instance();
// Register a new bundle
$this->bundleManager->registerBundles([
'winterjs' => [
'winterjs' => 'v1.0.0'
]
]);
// Grab the current bundles
$bundles = $this->bundleManager->getBundles();
// Validate that all default bundles have been registered when adding a new bundle
foreach ($defaultBundles as $defaultBundle) {
$this->assertContains($defaultBundle, $bundles);
}
}
/**
* Test the forcing a package to a new version
*/
public function testRegisterBundlesOverrideDefault(): void
{
$tailwindPackages = $this->bundleManager->getBundlePackages('tailwind', 'mix');
$this->bundleManager->registerBundle('tailwind', [
'tailwindcss' => 'dev-999.999.999',
'@tailwindcss/forms' => 'dev-999.999.999',
'@tailwindcss/typography' => 'dev-999.999.999',
]);
$updatedTailwindPackages = $this->bundleManager->getBundlePackages('tailwind', 'mix');
foreach ($tailwindPackages as $tailwindPackage => $version) {
$this->assertArrayHasKey($tailwindPackage, $updatedTailwindPackages);
$this->assertNotEquals($updatedTailwindPackages[$tailwindPackage], $version);
}
}
/**
* Test getting all supported bundles
*/
public function testGetBundles(): void
{
$bundles = $this->bundleManager->getBundles();
$this->assertIsArray($bundles);
$count = count($bundles);
$this->bundleManager->registerBundle('test', [
'a' => 'v0.1.2',
]);
$this->assertCount($count + 1, $this->bundleManager->getBundles());
}
/**
* Test getting bundle packages works and allows for config overloading
*/
public function testGetBundlePackages(): void
{
// Test that getting a default returns an array and validate one of the packages
$packages = $this->bundleManager->getBundlePackages('tailwind', 'mix');
$this->assertIsArray($packages);
$this->assertArrayHasKey('tailwindcss', $packages);
// Test that getting a package with compiler dependant packages does not return the package for invalid compiler
$packages = $this->bundleManager->getBundlePackages('vue', 'mix');
$this->assertIsArray($packages);
$this->assertArrayNotHasKey('@vitejs/plugin-vue', $packages);
// Test that getting a package with compiler dependant packages does return the package for a valid compiler
$packages = $this->bundleManager->getBundlePackages('vue', 'vite');
$this->assertIsArray($packages);
$this->assertArrayHasKey('@vitejs/plugin-vue', $packages);
// Validate that `testing` does not exist
$packages = $this->bundleManager->getBundlePackages('testing', 'vite');
$this->assertIsArray($packages);
$this->assertEmpty($packages);
$this->bundleManager->registerBundle('testing', [
'a' => 'v0.1.2',
'mix' => [
'b' => 'v0.1.3',
]
]);
// Validate the testing bundle works with compiler dependent packages
$packages = $this->bundleManager->getBundlePackages('testing', 'vite');
$this->assertIsArray($packages);
$this->assertCount(1, $packages);
$packages = $this->bundleManager->getBundlePackages('testing', 'mix');
$this->assertIsArray($packages);
$this->assertCount(2, $packages);
}
/**
* Test the AssetBundles setup handlers functionality
*/
public function testSetupHandlers(): void
{
// Test that the default handler is accessible
$handler = $this->bundleManager->getSetupHandler('tailwind');
$this->assertIsCallable($handler);
// Add a new handler
$this->bundleManager->registerSetupHandler('testing', fn () => true);
$handler = $this->bundleManager->getSetupHandler('testing');
$this->assertIsCallable($handler);
// Validate that handler returned is ours
$this->assertTrue($handler());
// Override the handler
$this->bundleManager->registerSetupHandler('testing', fn () => false);
$handler = $this->bundleManager->getSetupHandler('testing');
$this->assertIsCallable($handler);
$this->assertFalse($handler());
}
/**
* Test the AssetBundles scaffold handlers functionality
*/
public function testScaffoldHandlers(): void
{
// Test that the default handler is accessible
$handler = $this->bundleManager->getScaffoldHandler('tailwind');
$this->assertIsCallable($handler);
// Add a new handler
$this->bundleManager->registerScaffoldHandler('testing', fn () => true);
$handler = $this->bundleManager->getScaffoldHandler('testing');
$this->assertIsCallable($handler);
// Validate that handler returned is ours
$this->assertTrue($handler());
// Override the handler
$this->bundleManager->registerScaffoldHandler('testing', fn () => false);
$handler = $this->bundleManager->getScaffoldHandler('testing');
$this->assertIsCallable($handler);
$this->assertFalse($handler());
}
/**
* Validate that when registered a callable is added to the `callbacks` array within the BundleManager
*/
public function testRegisterCallback(): void
{
$this->expectExceptionMessage('callback registered');
$this->bundleManager->registerCallback(function (BundleManager $manager) {
throw new \RuntimeException('callback registered');
});
}
/**
* Test that calling registerBundles within registerCallback functions correctly
*/
public function testLoadRegisteredBundles(): void
{
$this->bundleManager->registerCallback(function (BundleManager $manager) {
$manager->registerBundles([
'winter-test-js' => [
'test-package' => 'v0.1.2',
'vite' => [
'vite-package' => 'v0.1.3',
]
]
]);
});
$this->assertContains('winter-test-js', $this->bundleManager->getBundles());
$bundle = $this->bundleManager->getBundlePackages('winter-test-js', 'mix');
$this->assertArrayHasKey('test-package', $bundle);
$this->assertArrayNotHasKey('vite-package', $bundle);
$bundle = $this->bundleManager->getBundlePackages('winter-test-js', 'vite');
$this->assertArrayHasKey('test-package', $bundle);
$this->assertArrayHasKey('vite-package', $bundle);
}
}

View File

@@ -0,0 +1,469 @@
<?php
namespace System\Tests\Classes\Asset;
use System\Classes\Asset\PackageJson;
use System\Tests\Bootstrap\TestCase;
class PackageJsonTest extends TestCase
{
/**
* Default test file fixture
*/
protected string $testFile;
/**
* Bind the default test file fixture
*/
public function setUp(): void
{
parent::setUp();
$this->testFile = __DIR__ . '/../../fixtures/npm/package-test.json';
}
/**
* Test loading a package.json file from path
*/
public function testLoadFile(): void
{
$packageJson = new PackageJson($this->testFile);
$contents = $packageJson->getContents();
$this->assertArrayHasKey('workspaces', $contents);
$this->assertArrayHasKey('packages', $contents['workspaces']);
$this->assertIsArray($contents['workspaces']['packages']);
}
/**
* Test loading a corrupted package.json file correctly errors
*/
public function testLoadCorruptFile(): void
{
$this->expectException(\JsonException::class);
new PackageJson(__DIR__ . '/../../fixtures/npm/package-corrupt.json');
}
/**
* Test creating an instance with non-existing file
*/
public function testNewFile(): void
{
$packageJson = new PackageJson(__DIR__ . '/../fixtures/npm/package-test-new.json');
$contents = $packageJson->getContents();
$this->assertIsArray($contents);
$this->assertCount(0, $contents);
}
/**
* Test creating an instance without a path
*/
public function testMemoryInstance(): void
{
$packageJson = new PackageJson();
$contents = $packageJson->getContents();
$this->assertIsArray($contents);
$this->assertCount(0, $contents);
}
/**
* Test setting and getting the name property
*/
public function testNameMethods(): void
{
$packageJson = new PackageJson();
$contents = $packageJson->getContents();
$this->assertIsArray($contents);
$this->assertCount(0, $contents);
$packageJson->setName('example-name');
$this->assertEquals('example-name', $packageJson->getName());
$contents = $packageJson->getContents();
$this->assertIsArray($contents);
$this->assertCount(1, $contents);
$this->assertArrayHasKey('name', $contents);
$this->assertEquals('example-name', $contents['name']);
}
/**
* Test getting the path of the current file
*/
public function testGetPath(): void
{
$packageJson = new PackageJson(__DIR__ . '/package.json');
$path = $packageJson->getPath();
$this->assertIsString($path);
$this->assertEquals(__DIR__ . '/package.json', $path);
$packageJson = new PackageJson();
$path = $packageJson->getPath();
$this->assertNull($path);
}
/**
* Test validating the name on set
*/
public function testNameValidation(): void
{
$packageJson = new PackageJson();
$this->assertThrows(function () use ($packageJson) {
$packageJson->setName('Test');
}, \InvalidArgumentException::class, 'Package names must be lower case');
$this->assertThrows(function () use ($packageJson) {
$packageJson->setName('.test');
}, \InvalidArgumentException::class, 'Package names must not start with . or _');
$this->assertThrows(function () use ($packageJson) {
$packageJson->setName('_test');
}, \InvalidArgumentException::class, 'Package names must not start with . or _');
$this->assertThrows(function () use ($packageJson) {
$packageJson->setName('te~st');
}, \InvalidArgumentException::class, 'Package names must not include special characters');
$this->assertThrows(function () use ($packageJson) {
$packageJson->setName('te*st');
}, \InvalidArgumentException::class, 'Package names must not include special characters');
$this->assertThrows(function () use ($packageJson) {
$packageJson->setName('test!');
}, \InvalidArgumentException::class, 'Package names must not include special characters');
$this->assertThrows(function () use ($packageJson) {
$packageJson->setName(sprintf('te%sst', str_repeat('s', 214)));
}, \InvalidArgumentException::class, 'Package names must not be longer than 214 characters');
$this->assertThrows(function () use ($packageJson) {
$packageJson->setName('test ');
}, \InvalidArgumentException::class, 'Package names must not include whitespace');
$this->assertThrows(function () use ($packageJson) {
$packageJson->setName(' test');
}, \InvalidArgumentException::class, 'Package names must not include whitespace');
}
/**
* Test checking package workspace exists
*/
public function testHasWorkspace(): void
{
$packageJson = new PackageJson($this->testFile);
$this->assertTrue($packageJson->hasWorkspace('themes/demo'));
$this->assertFalse($packageJson->hasWorkspace('themes/test'));
}
/**
* Test adding workspace package
*/
public function testAddWorkspace(): void
{
$packageJson = new PackageJson($this->testFile);
$this->assertFalse($packageJson->hasWorkspace('themes/test'));
$packageJson->addWorkspace('themes/test');
$this->assertTrue($packageJson->hasWorkspace('themes/test'));
// Create blank source
$packageJson = new PackageJson();
$this->assertFalse($packageJson->hasWorkspace('themes/test'));
$packageJson->addWorkspace('themes/test');
$this->assertTrue($packageJson->hasWorkspace('themes/test'));
}
/**
* Test removing workspace package
*/
public function testRemoveWorkspace(): void
{
$packageJson = new PackageJson($this->testFile);
$this->assertTrue($packageJson->hasWorkspace('themes/demo'));
$packageJson->removeWorkspace('themes/demo');
$this->assertFalse($packageJson->hasWorkspace('themes/demo'));
// Create blank source
$packageJson = new PackageJson();
$packageJson->removeWorkspace('themes/demo');
$this->assertFalse($packageJson->hasWorkspace('themes/demo'));
}
/**
* Test when adding a workspace package, it removes the package from ignored workspace packages
*/
public function testAddWorkspaceRemovesIgnoredPackage(): void
{
$packageJson = new PackageJson($this->testFile);
$this->assertFalse($packageJson->hasWorkspace('modules/backend'));
$this->assertTrue($packageJson->hasIgnoredPackage('modules/backend'));
$packageJson->addWorkspace('modules/backend');
$this->assertTrue($packageJson->hasWorkspace('modules/backend'));
$this->assertFalse($packageJson->hasIgnoredPackage('modules/backend'));
}
/**
* Test checking ignore package workspace exists
*/
public function testHasIgnoredPackage(): void
{
$packageJson = new PackageJson($this->testFile);
$this->assertTrue($packageJson->hasIgnoredPackage('modules/backend'));
$this->assertFalse($packageJson->hasIgnoredPackage('modules/test'));
// Create blank source
$packageJson = new PackageJson();
$this->assertFalse($packageJson->hasIgnoredPackage('modules/backend'));
$this->assertFalse($packageJson->hasIgnoredPackage('modules/test'));
}
/**
* Test adding ignore workspace package
*/
public function testAddIgnoredPackage(): void
{
$packageJson = new PackageJson($this->testFile);
$this->assertFalse($packageJson->hasIgnoredPackage('themes/example'));
$packageJson->addIgnoredPackage('themes/example');
$this->assertTrue($packageJson->hasIgnoredPackage('themes/example'));
// Create blank source
$packageJson = new PackageJson();
$packageJson->addIgnoredPackage('themes/example');
$this->assertTrue($packageJson->hasIgnoredPackage('themes/example'));
}
/**
* Test removing ignore workspace package
*/
public function testRemoveIgnoredPackage(): void
{
$packageJson = new PackageJson($this->testFile);
$this->assertTrue($packageJson->hasIgnoredPackage('modules/system'));
$packageJson->removeIgnoredPackage('modules/system');
$this->assertFalse($packageJson->hasIgnoredPackage('modules/system'));
// Create blank source
$packageJson = new PackageJson();
$packageJson->removeIgnoredPackage('modules/system');
$this->assertFalse($packageJson->hasIgnoredPackage('modules/system'));
}
/**
* Test when adding an ignore workspace package, it removes the package from workspace packages
*/
public function testAddIgnoredPackageRemovesWorkspace(): void
{
$packageJson = new PackageJson($this->testFile);
$this->assertTrue($packageJson->hasWorkspace('themes/demo'));
$this->assertFalse($packageJson->hasIgnoredPackage('themes/demo'));
$packageJson->addIgnoredPackage('themes/demo');
$this->assertFalse($packageJson->hasWorkspace('themes/demo'));
$this->assertTrue($packageJson->hasIgnoredPackage('themes/demo'));
}
/**
* Test checking if package.json has deps
*/
public function testHasDependency(): void
{
$packageJson = new PackageJson($this->testFile);
// Check that deps exist
$this->assertTrue($packageJson->hasDependency('test'));
$this->assertTrue($packageJson->hasDependency('test-dev'));
// Check that deps don't exist
$this->assertFalse($packageJson->hasWorkspace('test-dev2'));
$this->assertFalse($packageJson->hasWorkspace('testx'));
}
/**
* Test adding dependencies, when overwriting check that package is moved from devDeps to deps or revsersed
*
* @return void
*/
public function testAddDependency(): void
{
// Test adding packages
$packageJson = new PackageJson($this->testFile);
$packageJson->addDependency('winter', '4.0.1', dev: false)
->addDependency('winter-dev', '4.0.1', dev: true);
$this->assertArrayNotHasKey('winter', $packageJson->getContents()['devDependencies']);
$this->assertArrayHasKey('winter', $packageJson->getContents()['dependencies']);
$this->assertArrayNotHasKey('winter-dev', $packageJson->getContents()['dependencies']);
$this->assertArrayHasKey('winter-dev', $packageJson->getContents()['devDependencies']);
// Test adding packages with overwrites
$packageJson = new PackageJson($this->testFile);
// Should do nothing as test is already in deps not dev deps
$packageJson->addDependency('test', '6.0.1', dev: true, overwrite: false);
$this->assertArrayHasKey('test', $packageJson->getContents()['dependencies']);
$this->assertArrayNotHasKey('test', $packageJson->getContents()['devDependencies']);
$this->assertEquals('^1.0.0', $packageJson->getContents()['dependencies']['test']);
// Should move package from dev deps to deps with new version
$packageJson->addDependency('test', '6.0.1', dev: true, overwrite: true);
$this->assertArrayNotHasKey('test', $packageJson->getContents()['dependencies']);
$this->assertArrayHasKey('test', $packageJson->getContents()['devDependencies']);
$this->assertEquals('6.0.1', $packageJson->getContents()['devDependencies']['test']);
// Create blank source
$packageJson = new PackageJson();
// Add a non-dev dependency
$packageJson->addDependency('winter', '4.0.1', dev: false);
// Add a dev dependency
$packageJson->addDependency('winter-dev', '4.0.1', dev: true);
}
/**
* Test removing dependencies
*/
public function testRemoveDependency(): void
{
$packageJson = new PackageJson($this->testFile);
// Check package removed from dev deps
$this->assertArrayHasKey('test-dev', $packageJson->getContents()['devDependencies'] ?? []);
$packageJson->removeDependency('test-dev');
$this->assertArrayNotHasKey('test-dev', $packageJson->getContents()['devDependencies'] ?? []);
// Check package removed from deps
$this->assertArrayHasKey('test', $packageJson->getContents()['dependencies'] ?? []);
$packageJson->removeDependency('test');
$this->assertArrayNotHasKey('test', $packageJson->getContents()['dependencies'] ?? []);
// Create blank source
$packageJson = new PackageJson();
$packageJson->removeDependency('test-dev');
$this->assertArrayNotHasKey('test-dev', $packageJson->getContents()['devDependencies'] ?? []);
}
/**
* Test checking if a script exists in a package.json
*/
public function testHasScript(): void
{
$packageJson = new PackageJson($this->testFile);
$this->assertTrue($packageJson->hasScript('foo'));
$this->assertTrue($packageJson->hasScript('example'));
$this->assertTrue($packageJson->hasScript('test'));
$this->assertFalse($packageJson->hasScript('bar'));
$this->assertFalse($packageJson->hasScript('winter'));
$this->assertFalse($packageJson->hasScript('testing'));
}
/**
* Test getting the value of a script by name
*/
public function testGetScript(): void
{
$packageJson = new PackageJson($this->testFile);
$this->assertEquals('bar ./test', $packageJson->getScript('foo'));
$this->assertEquals('example test', $packageJson->getScript('example'));
$this->assertEquals('testing', $packageJson->getScript('test'));
$packageJson = new PackageJson();
$this->assertNull($packageJson->getScript('foo'));
}
/**
* Test getting the value of a script by name
*/
public function testAddScript(): void
{
$packageJson = new PackageJson($this->testFile);
$packageJson->addScript('winter', 'winter ./testing');
$this->assertTrue($packageJson->hasScript('winter'));
$this->assertEquals('winter ./testing', $packageJson->getScript('winter'));
$contents = $packageJson->getContents();
$this->assertTrue(isset($contents['scripts']['winter']));
$this->assertEquals('winter ./testing', $contents['scripts']['winter']);
$packageJson = new PackageJson();
$packageJson->addScript('winter', 'winter ./testing');
$this->assertTrue($packageJson->hasScript('winter'));
}
/**
* Test removing scripts from package.json
*/
public function testRemoveScript(): void
{
$packageJson = new PackageJson($this->testFile);
$this->assertTrue($packageJson->hasScript('foo'));
$packageJson->removeScript('foo');
$this->assertFalse($packageJson->hasScript('foo'));
$this->assertTrue($packageJson->hasScript('example'));
$packageJson->removeScript('example');
$this->assertFalse($packageJson->hasScript('example'));
$packageJson = new PackageJson();
$packageJson->removeScript('foo');
$this->assertFalse($packageJson->hasScript('foo'));
}
/**
* Test saving, when saving with a file path set on init and passing a file path on save. Fails when no path given
*/
public function testSave(): void
{
$srcFile = $this->testFile;
$backupFile = __DIR__ . '/../../fixtures/npm/package-test.json.back';
// Backup config file
copy($srcFile, $backupFile);
// Make a change and save the file, overwriting
$packageJson = new PackageJson($srcFile);
$this->assertNull($packageJson->getName());
$packageJson->setName('testing');
$packageJson->save();
// Validate overwrite worked
$packageJson = new PackageJson($srcFile);
$this->assertEquals('testing', $packageJson->getName());
// Restore the config file
copy($backupFile, $srcFile);
// Remove backup file
unlink($backupFile);
// Test saving file to new path
$testFile = __DIR__ . '/../../fixtures/npm/package-test.json.test';
$packageJson = new PackageJson($srcFile);
$this->assertNull($packageJson->getName());
$packageJson->setName('testing');
$packageJson->save($testFile);
// Validate new file path exists and contains change
$packageJson = new PackageJson($testFile);
$this->assertEquals('testing', $packageJson->getName());
// Remove test file
unlink($testFile);
// Validate that a file save with no path throws an error
$this->assertThrows(function () {
$packageJson = new PackageJson();
$packageJson->setName('should-fail');
$packageJson->save();
}, \RuntimeException::class, 'Unable to save, no path given');
}
}