Merge pull request #16 from edoardocavazza/cake5-entrypoint-shortcut

Add single entrypoint shortcut for script and css methods (cake5)

Author: passchn

README.md

@@ -65,6 +65,12 @@ In your php-template or in layout you can import javascript files with:
 <?php $this->ViteScripts->script($options) ?>
 ```
 
+or using this shourtcut for a single entrypoint:
+
+```php
+<?php $this->ViteScripts->script('webroot_src/main.ts') ?>
+```
+
 If you imported CSS files inside your JavaScript files, this method automatically
 appends your css tags to the css view block.
 
@@ -76,6 +82,12 @@ In your php-template you can import css files with:
 <?php $this->ViteScripts->css($options) ?>
 ```
 
+or using this shourtcut for a single entrypoint:
+
+```php
+<?php $this->ViteScripts->script('webroot_src/style.css') ?>
+```
+
 ## Configuration
 
 The plugin comes with some default configuration. You may need to change it depending on your setup. Or you might not

src/View/Helper/ViteScriptsHelper.php

@@ -68,15 +68,18 @@ public function isDev(ViteHelperConfig|string|null $config = null): bool
      * * devEntries (string[]): entry files in development mode
      * * other options are rendered as attributes to the html tag
      *
-     * @param array $options see above
+     * @param array|string $options file entrypoint or script options
      * @param \ViteHelper\Utilities\ViteHelperConfig|string|null $config config key or instance to use
      * @return void
      * @throws \ViteHelper\Exception\ConfigurationException
      * @throws \ViteHelper\Exception\ManifestNotFoundException|\ViteHelper\Exception\InvalidArgumentException
      */
-    public function script(array $options = [], ViteHelperConfig|string|null $config = null): void
+    public function script(array|string $options = [], ViteHelperConfig|string|null $config = null): void
     {
         $config = $this->createConfig($config);
+        if (is_string($options)) {
+            $options = ['files' => [$options]];
+        }
         $options['block'] = $options['block'] ?? $config->read('viewBlocks.script', ConfigDefaults::VIEW_BLOCK_SCRIPT);
         $options['cssBlock'] = $options['cssBlock'] ?? $config->read('viewBlocks.css', ConfigDefaults::VIEW_BLOCK_CSS);
         $options = $this->updateOptionsForFiltersAndEntries($options);
@@ -204,17 +207,19 @@ private function productionScript(array $options, ViteHelperConfig $config): voi
      * * devEntries (string[]): entry files in development mode
      * * other options are rendered as attributes to the html tag
      *
-     * @param array $options see above
+     * @param array|string $options file entrypoint or css options
      * @param \ViteHelper\Utilities\ViteHelperConfig|string|null $config config key or instance to use
      * @return void
      * @throws \ViteHelper\Exception\ManifestNotFoundException
      * @throws \ViteHelper\Exception\ConfigurationException
      * @throws \ViteHelper\Exception\InvalidArgumentException
      */
-    public function css(array $options = [], ViteHelperConfig|string|null $config = null): void
+    public function css(array|string $options = [], ViteHelperConfig|string|null $config = null): void
     {
         $config = $this->createConfig($config);
-
+        if (is_string($options)) {
+            $options = ['files' => [$options]];
+        }
         // TODO the default should be css. This is a bug but might break in production.
         // So this should be replaced in a major release.
         $options['block'] = $options['block'] ?? $config->read('viewBlocks.css', ConfigDefaults::VIEW_BLOCK_SCRIPT);