@ramstack/alpinegear-main 1.0.0-preview.1

package/README.md

@@ -0,0 +1,145 @@
+# @ramstack/alpinegear-main
+
+`@ramstack/alpinegear-main` is a combined plugin for [Alpine.js](https://alpinejs.dev/) that includes several useful directives. This plugin aggregates multiple individual plugins, providing a convenient all-in-one package.
+
+## Included Plugins
+
+**[@ramstack/alpinegear-bound](https://github.com/rameel/ramstack.alpinegear.js/tree/main/src/plugins/bound)** ([README](https://github.com/rameel/ramstack.alpinegear.js/tree/main/src/plugins/bound))<br>
+Provides the `x-bound` directive, which allows for two-way binding of input elements and their associated data properties. It works similarly to the binding provided by [Svelte](https://svelte.dev/docs/element-directives#bind-property) and also supports synchronizing values between two `Alpine.js` data properties.
+
+```html
+<div x-data="{ width: 0, height: 0, files: [] }">
+    <input &files="files" type="file" accept="image/jpeg" />
+
+    <img &naturalwidth="width" &naturalheight="height" src="..." />
+
+    ...
+
+    For other examples, see README
+
+</div>
+```
+
+
+**[@ramstack/alpinegear-format](https://github.com/rameel/ramstack.alpinegear.js/tree/main/src/plugins/format)** ([README](https://github.com/rameel/ramstack.alpinegear.js/tree/main/src/plugins/format))<br>
+Provides `x-format` directive, which allows you to easily interpolate text using a template syntax similar to what's available in `Vue.js`.
+
+```html
+<div x-data="{ message: 'Hello, World!'}" x-format>
+    <span>Message: {{ message }}</span>
+</div>
+```
+
+
+**[@ramstack/alpinegear-template](https://github.com/rameel/ramstack.alpinegear.js/tree/main/src/plugins/template)** ([README](https://github.com/rameel/ramstack.alpinegear.js/tree/main/src/plugins/template))<br>
+Provides `x-template` directive, allowing to define a template once anywhere in the DOM and reference it by its ID.
+
+This helps avoid duplicating templates, simplifying markup and making it easier to manage.
+
+Moreover, it enables recursive templates, allowing you to create components like a **tree view** with ease,
+something that would otherwise be quite complex to implement.
+
+```html
+<template id="treeitem">
+    <span x-format>{{ model.name }}</span>
+
+    <template x-if="model.list">
+        <ul>
+            <template x-for="item in model.list">
+                <li x-template="treeitem" x-data="{ model: item }"></li>
+            </template>
+        </ul>
+    </template>
+</template>
+
+<ul x-data="json">
+    <li x-template="treeitem"></li>
+</ul>
+```
+
+
+**[@ramstack/alpinegear-fragment](https://github.com/rameel/ramstack.alpinegear.js/tree/main/src/plugins/fragment)** ([README](https://github.com/rameel/ramstack.alpinegear.js/tree/main/src/plugins/fragment))<br>
+Provides the `x-fragment` directive, allowing for fragment-like behavior similar to what's available in frameworks like `Vue.js` or `React`, where multiple root elements can be grouped together.
+
+It is particularly useful when you want to avoid wrapping elements in unnecessary container tags.
+
+```html
+<dl>
+    <template x-for="item in items" :key="item.id">
+        <template x-fragment>
+            <dt x-text="item.term"></dt>
+            <dd x-text="item.description"></dd>
+        </template>
+    </template>
+</dl>
+```
+
+
+**[@ramstack/alpinegear-match](https://github.com/rameel/ramstack.alpinegear.js/tree/main/src/plugins/match)** ([README](https://github.com/rameel/ramstack.alpinegear.js/tree/main/src/plugins/match))<br>
+Provides the `x-match` directive, which functions similarly to the `switch` statement in many programming languages, allowing to conditionally render elements based on matching cases.
+
+```html
+<template x-for="n in numbers">
+    <template x-match>
+        <div x-case="n % 3 == 0 && n % 5 == 0">Fizz Buzz</div>
+        <div x-case="n % 3 == 0">Fizz</div>
+        <div x-case="n % 5 == 0">Buzz</div>
+        <div x-default x-text="n"></div>
+    </template>
+</template>
+```
+
+
+**[@ramstack/alpinegear-when](https://github.com/rameel/ramstack.alpinegear.js/tree/main/src/plugins/when)** ([README](https://github.com/rameel/ramstack.alpinegear.js/tree/main/src/plugins/when))<br>
+Provides the `x-when` directive, which allows for conditional rendering of elements similar to `x-if`, but supports multiple root elements.
+
+```html
+<template x-for="item in items" :key="item.id">
+    <template x-when="item.visible">
+        <dt x-text="item.term"></dt>
+        <dd x-text="item.description"></dd>
+    </template>
+</template>
+```
+
+## Installation
+
+### Using CDN
+To include the CDN version of this plugin, add the following `<script>` tag before the core `alpine.js` file:
+
+```html
+<!-- alpine.js plugin -->
+<script src="https://cdn.jsdelivr.net/npm/@ramstack/alpinegear-main@1/dist/alpinegear-main.min.js" defer></script>
+
+<!-- alpine.js -->
+<script src="https://cdn.jsdelivr.net/npm/alpinejs@3.x.x/dist/cdn.min.js" defer></script>
+```
+
+### Using NPM
+Alternatively, you can install the plugin via `npm`:
+
+```bash
+npm install --save @ramstack/alpinegear-main
+```
+
+Then initialize it in your bundle:
+
+```js
+import Alpine from "alpinejs";
+import main from "@ramstack/alpinegear-main";
+
+Alpine.plugin(main);
+Alpine.start();
+```
+
+## Source Code
+You can find the source code for this plugin on GitHub:
+
+https://github.com/rameel/ramstack.alpinegear.js/tree/main/src/plugins/main
+
+## Contributions
+Bug reports and contributions are welcome.
+
+## License
+This package is released as open source under the **MIT License**.
+See the [LICENSE](https://github.com/rameel/ramstack.alpinegear.js/blob/main/LICENSE) file for more details.