add husky with pre-commit script that check if package.json not changed then restore pnpm-lock.yaml

Co-authored-by: Paweł Kuna <1282324+codecalm@users.noreply.github.com>

.changeset/aaaa.md

@@ -0,0 +1,5 @@
+---
+"@tabler/core": minor
+---
+
+Add gradient background utilities

.changeset/chatty-bottles-jam.md

@@ -0,0 +1,5 @@
+---
+"@tabler/core": patch
+---
+
+Rollback accordion component structure

.changeset/forty-pots-happen.md

@@ -0,0 +1,5 @@
+---
+"@tabler/core": patch
+---
+
+Add Bootstrap components to Tabler JS

.changeset/large-elephants-camp.md

@@ -0,0 +1,4 @@
+---
+---
+
+Replace HTML `alt` attribute to `aria-title` used on SVG element

.changeset/lovely-dots-know.md

@@ -0,0 +1,4 @@
+---
+---
+
+Update modal examples

.changeset/pink-bottles-rest.md

@@ -0,0 +1,5 @@
+---
+"@tabler/core": patch
+---
+
+Apply border radius to `tom-select` on focus 

.changeset/popular-geckos-flow.md

@@ -0,0 +1,5 @@
+---
+"preview": patch
+---
+
+Add missing `tw` entry in `flags.json`

.changeset/quick-taxis-impress.md

@@ -0,0 +1,5 @@
+---
+"@tabler/core": patch
+---
+
+Minor spelling and grammar improvements to emails docs

.changeset/stale-lions-talk.md

@@ -0,0 +1,5 @@
+---
+"@tabler/core": patch
+---
+
+Fix `autosize` and `input mask` plugins to use window scope

.changeset/twenty-radios-punch.md

@@ -0,0 +1,5 @@
+---
+"@tabler/core": patch
+---
+
+Improve README 

.github/workflows/argos.yml

@@ -22,7 +22,8 @@ jobs:
   test:
     timeout-minutes: 60
     runs-on: ubuntu-latest
-    if: github.event.pull_request.draft == false
+    # if: github.event.pull_request.draft == false
+    if: false
     steps:
       - name: Clone repository
         uses: actions/checkout@v4

.husky/pre-commit

@@ -0,0 +1,16 @@
+#!/bin/sh
+
+if git diff --quiet --cached package.json; then
+  if git diff --quiet --cached pnpm-lock.yaml; then
+    echo "pnpm-lock.yaml not changed, nothing to do."
+  else
+    echo "pnpm-lock.yaml changed, restore..."
+    git restore --staged pnpm-lock.yaml
+    git checkout pnpm-lock.yaml
+    echo "Restored pnpm-lock.yaml."
+  fi
+else
+  echo "package.json changed, pnpm-lock.yaml change"
+fi
+
+exit 0

README.md

@@ -15,7 +15,7 @@ A premium and open source dashboard template with a responsive and high-quality
 
 ## Sponsors
 
-**If you want to support our project and help me grow it, you can [become a sponsor on GitHub](https://github.com/sponsors/codecalm) or just [donate on PayPal](https://paypal.me/codecalm) :)**
+**If you want to support our project and help us grow it, you can [become a sponsor on GitHub](https://github.com/sponsors/codecalm) or just [donate on PayPal](https://paypal.me/codecalm) :)**
 
 <p align="center">
 	<a href="https://github.com/sponsors/codecalm">
@@ -23,8 +23,24 @@ A premium and open source dashboard template with a responsive and high-quality
 	</a>
 </p>
 
+<p align="center">
+	<a href="https://github.com/sponsors/codecalm" target="_blank">
+			<img src="https://raw.githubusercontent.com/tabler/tabler/dev/preview/static/sponsor-banner-homepage.svg" alt="Sponsor Banner">
+	</a>
+</p>
+
 ## Testing
 
+<p align="center">Visual testing with:</p>
+
+<p align="center">
+	<a href="https://argos-ci.com/" target="_blank">
+		<picture>
+			<img src="https://github.com/user-attachments/assets/7d231a26-eff5-4fc5-8392-b2a679a7c572" alt="Argos-CI" height="164" />
+		</picture>
+	</a>
+</p>
+
 <p align="center">Browser testing via:</p>
 
 <p align="center">
@@ -32,7 +48,7 @@ A premium and open source dashboard template with a responsive and high-quality
 		<picture>
 			<source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/14dd2a0a-bafe-436e-a6cb-29636278c781">
 			<source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/d3dede5a-d702-47c3-bb66-4d887948ed83">
-			<img src="https://github.com/user-attachments/assets/d3dede5a-d702-47c3-bb66-4d887948ed83" alt="Tabler Icons preview" width="296">
+			<img src="https://github.com/user-attachments/assets/d3dede5a-d702-47c3-bb66-4d887948ed83" alt="labmdatest" width="296">
 		</picture>
 	</a>
 </p>
@@ -56,116 +72,30 @@ We've created this admin panel for everyone who wants to create templates based
 * **HTML5 & CSS3:** We use only modern web technologies, such as HTML5 and CSS3. Our theme includes some subtle CSS3 animations, which will help you attract attention.
 * **Clean Code:** We followed Bootstrap’s guidelines carefully to make your integration as easy as possible. All code is handwritten and W3C valid.
 * **Demo pages**: Tabler features over 20 individual pages using various components, which gives you the freedom to choose and combine. All components can vary in color and styling that you can easily modify using Sass. Sky is the limit!
-* **Single Page Application versions:** [Tabler React](https://github.com/tabler/tabler-react) has React components for Tabler.
 
 ## 📖 Documentation
 
-Documentation is available as a part of Tabler preview: https://tabler.io/docs/
-
-To run the documentation site locally, follow instructions in the [Documentation README](https://github.com/tabler/tabler/blob/dev/site/README.md).
+The documentation is available at https://tabler.io/docs/
 
 ## 🪴 Project Activity
 
-![Alt](https://repobeats.axiom.co/api/embed/61d1db34446967b0848af68198a392067e0f5870.svg "Repobeats analytics image")
-
-## 💕 Sponsor Tabler
-
 <p align="center">
-	<a href="https://github.com/sponsors/codecalm" target="_blank">
-			<img src="https://raw.githubusercontent.com/tabler/tabler/dev/preview/static/sponsor-banner-homepage.svg" alt="Sponsor Banner">
-	</a>
+	<img src="https://repobeats.axiom.co/api/embed/61d1db34446967b0848af68198a392067e0f5870.svg" alt="Repobeats analytics image" />
 </p>
 
-### Sponsors
-
-Support this project by becoming a sponsor. Your logo will show up in this README with a link to your website. [Become a sponsor!](https://opencollective.com/tabler#sponsor)
-
-<a href="https://opencollective.com/tabler/tiers/sponsor/0/website" target="_blank"><img src="https://opencollective.com/tabler/tiers/sponsor/0/avatar.svg" /></a>
-<a href="https://opencollective.com/tabler/tiers/sponsor/1/website" target="_blank"><img src="https://opencollective.com/tabler/tiers/sponsor/1/avatar.svg" /></a>
-<a href="https://opencollective.com/tabler/tiers/sponsor/2/website" target="_blank"><img src="https://opencollective.com/tabler/tiers/sponsor/2/avatar.svg" /></a>
-<a href="https://opencollective.com/tabler/tiers/sponsor/3/website" target="_blank"><img src="https://opencollective.com/tabler/tiers/sponsor/3/avatar.svg" /></a>
-<a href="https://opencollective.com/tabler/tiers/sponsor/4/website" target="_blank"><img src="https://opencollective.com/tabler/tiers/sponsor/4/avatar.svg" /></a>
-<a href="https://opencollective.com/tabler/tiers/sponsor/5/website" target="_blank"><img src="https://opencollective.com/tabler/tiers/sponsor/5/avatar.svg" /></a>
-<a href="https://opencollective.com/tabler/tiers/sponsor/6/website" target="_blank"><img src="https://opencollective.com/tabler/tiers/sponsor/6/avatar.svg" /></a>
-<a href="https://opencollective.com/tabler/tiers/sponsor/7/website" target="_blank"><img src="https://opencollective.com/tabler/tiers/sponsor/7/avatar.svg" /></a>
-<a href="https://opencollective.com/tabler/tiers/sponsor/8/website" target="_blank"><img src="https://opencollective.com/tabler/tiers/sponsor/8/avatar.svg" /></a>
-<a href="https://opencollective.com/tabler/tiers/sponsor/9/website" target="_blank"><img src="https://opencollective.com/tabler/tiers/sponsor/9/avatar.svg" /></a>
-
-## 📦 Setup environment
-
-To use our build system and run our documentation locally, you'll need a copy of Tabler's source files. Follow the steps below:
-
-1. [Install Node.js](https://nodejs.org/download/), which we use to manage our dependencies.
-2. Navigate to the root `/tabler` directory and run `pnpm install` to install our local dependencies listed in `package.json`.
-
-**OSX users**:
-
-```sh
-pnpm install
-```
-
-and then 
-
-```sh
-npm run start
-```
-
-**Windows users**:
-
-[Install Git](https://git-scm.com/download/win) in `C:\Program Files\git\bin` directory and run `npm config set script-shell "C:\\Program Files\\git\\bin\\bash.exe"` to change the default shell.
-
-Once you complete the setup, you'll be able to run the various commands provided from the command line.
-
-
-## Build locally
-
-You need to have `pnpm` installed.
-
-1. From the root `/tabler` directory, run installation in the command line: `pnpm install` 
-2. Then execute `pnpm run start` to start up the application stack.
-3. Open [http://localhost:3000](http://localhost:3000) in your browser, and voilà.
-4. Any change in the `/src` directory will build the application and refresh the page.
-
-**Note**:
-Run `pnpm run build` for reforms a one off build application without refresh.
-Open [http://localhost:3001](http://localhost:3001) to configure the Web server.
-
 ## Installation
 
-Tabler is distributed via npm.
+### Package Managers
+
+Tabler is distributed via npm. You can install it with this or your preferred JavaScript package manager:
 
 ```sh
 npm install --save @tabler/core
 ```
 
-## Running with Docker
-
-**Plain Docker**
-
-If you don't want to install node/npm and the dependencies on your local environment, you can use the provided Dockerfile to build a docker image.
-This Dockerfile is provided as an example to spin-up a container running Tabler.
-
-Example of how to use this image:
-
-1. Build the tabler image : `docker build -t tabler .`
-2. Run the tabler image while mounting the `src` directory as well as the `_config.yml` file into the container.
-
-Don't forget to expose the port 3000 so you can browse the website locally.
-You can also expose the port 3001 to have access to BrowserSync
-
-```sh
-docker run -p 3000:3000 -p 3001:3001 -v $(pwd)/src:/app/src -v $(pwd)/_config.yml:/app/_config.yml tabler
-```
-
-Now open your browser to [http://localhost:3000](http://localhost:3000). Edit anything in the `src/` folder and watch your browser refresh the page after it has been rebuilt.
-
-**Docker Compose**
-
-You can also use the docker compose config from this repo. Use `docker compose build && docker compose up` or `docker compose up --build` to build and start the container. Edit anything in the `src/` folder the same way as with plain docker and access the same URLs and ports in your browser.
-
 ### CDN support
 
-All files included in `@tabler/core` npm package are available over a CDN.
+All files included in `@tabler/core` npm package are also available over a CDN.
 
 #### Javascript
 
@@ -179,24 +109,84 @@ All files included in `@tabler/core` npm package are available over a CDN.
 <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@tabler/core@latest/dist/css/tabler.min.css">
 ```
 
-## Feature requests
+## Building locally
 
-https://tabler.canny.io/feature-requests
+To build a copy of Tabler locally, you have two options. You can either set up your device directly with the development tools required to build Tabler, or if you would prefer not to install all the development dependencies directly onto your device, you can use a Dockerfile that Tabler provides to build a docker image. Instructions follow below.
 
+### First steps: Downloading the Tabler source files
+
+With either method, the first thing you'll want to do is download a copy of the Tabler source files to your device.
+
+#### From the Tabler GitHub releases page
+
+If you don't want to edit the source code once you've downloaded it, and aren't interested in merging future project updates into your copy, you can just download the source files straight from the [Tabler releases on GitHub](https://github.com/tabler/tabler/releases) and extract the contents to a directory called `tabler`.
+
+#### Cloning with Git
+
+If you **do** wish to edit the source code after downloading it, for example to contribute changes back to the Tabler project, you'll want to do this by cloning it with Git:
+1. If you don't have Git installed on your device, download and install it. You can find instructions at [https://git-scm.com/downloads](https://git-scm.com/downloads).
+2. (Optional) **Windows users:** you could optionally install Git in the `C:\Program Files\git\bin` directory and run `npm config set script-shell "C:\\Program Files\\git\\bin\\bash.exe"` to change the default shell.
+3. Clone the Tabler project into a folder on your device. Instructions can be found at [cloning a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository).
+
+### Installing and running development tools directly
+
+1. [Install Node.js](https://nodejs.org/download/), which we use to manage our dependencies.
+2. [Install pnpm](https://pnpm.io/installation) (We recommend either by [Using Corepack](https://pnpm.io/installation#using-corepack) or by [Using npm](https://pnpm.io/installation#using-npm))
+3. From the root `/tabler` directory where you downloaded the Tabler source files, run installation on the command line:
+```sh
+pnpm install
+```
+4. Then execute the following to start up the application stack:
+```sh
+pnpm run start
+```
+5. Open [http://localhost:3000](http://localhost:3000) in your browser, and voilà.
+Any change in the `/src` directory will rebuild the application and refresh the page.
+
+**Note**:
+If you wish to perform a one-off build without auto-refresh on any changes, you can run:
+```sh
+pnpm run build
+```
+You can open [http://localhost:3001](http://localhost:3001) to configure the Web server.
+
+
+### Installing and running development tools with Docker
+
+**Plain Docker**
+
+Here is an example of how to use this image:
+
+1. From the root `/tabler` directory where you downloaded the Tabler source files, build the tabler image:
+```sh
+docker build -t tabler .
+```
+2. Run the tabler image. The following command mounts the `src` directory into the container, exposes port 3000 to browse the website locally, and exposes port 3001 to automatically sync changes:
+```sh
+docker run -p 3000:3000 -p 3001:3001 -v $(pwd)/src:/app/src tabler
+```
+3. Open your browser to [http://localhost:3000](http://localhost:3000). Edit anything in the `src/` folder and watch your browser refresh the page after it has been rebuilt.
+
+**Docker Compose**
+
+You can also use the docker compose config from this repo. From the root `/tabler` directory where you downloaded the Tabler source files, use `docker compose build && docker compose up` or `docker compose up --build` to build and start the container. Edit anything in the `src/` folder the same way as with plain docker and access the same URLs and ports in your browser.
 
 ## Bugs and feature requests
 
 Found a bug or have a feature request? [Please open a new issue](https://github.com/tabler/tabler/issues/new).
 
-
 ## 🤓 Creators
 
 **Paweł Kuna**
 
-- <https://twitter.com/codecalm>
+- <https://x.com/codecalm>
 - <https://github.com/codecalm>
 - <https://codecalm.net>
 
+**Bartłomiej Gawęda**
+
+- <https://x.com/B_Gaweda>
+- <https://github.com/BG-Software-BG>
 
 ## 👨‍🚀 Contributors
 
@@ -204,25 +194,11 @@ This project exists thanks to all the people who contribute.
 
 <img src="https://opencollective.com/tabler/contributors.svg?width=890&button=false" />
 
-## 🌸 Backers
+## Social media
 
-Thank you to all our backers! 🙏 [Become a backer](https://opencollective.com/tabler#backer)
-
-<a href="https://opencollective.com/tabler#backers" target="_blank"><img src="https://opencollective.com/tabler/tiers/backer.svg?width=890&button=false" /></a>
+Stay up to date by joining our community on <a href="https://x.com/tabler_io" >X</a> and <a href="https://www.facebook.com/tabler.io">Facebook</a>
 
 ## License
 
 See the [LICENSE](https://github.com/tabler/tabler/blob/master/LICENSE) file.
 
-## Contributors ✨
-
-Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
-
-<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
-<!-- prettier-ignore-start -->
-<!-- markdownlint-disable -->
-<!-- markdownlint-restore -->
-<!-- prettier-ignore-end -->
-<!-- ALL-CONTRIBUTORS-LIST:END -->
-
-This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

core/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @tabler/core
 
+## 1.1.1
+
+### Patch Changes
+
+- f29c911: Fix Documentation structure
+
 ## 1.1.0
 
 ### Minor Changes

core/docs/emails/index.mdx

@@ -0,0 +1,8 @@
+---
+title: Tabler Emails
+seoTitle: Tabler Emails - premium email templates
+order: 4
+description: Customizable email templates for over 90 clients and devices.
+summary: Tabler Emails is a set of 80 eye-catching, customizable HTML templates. They are compatible with over 90 email clients and devices.
+seoDescription: Tabler Emails is a collection of 80 premium, customizable HTML templates. They are compatible with over 90 email clients and devices.
+---

core/docs/emails/introduction/compiled-html.mdx

@@ -0,0 +1,29 @@
+---
+title: Compiled templates
+order: 2
+seoTitle: Tabler Emails - How to use the compiled HTML email templates
+description: Learn how to use the compiled HTML email templates from the Tabler Emails package.
+summary: The compiled HTML files from the Tabler Emails package are ready to use in your email marketing campaigns. This guide explains how to use them effectively.
+seoDescription: The compiled HTML files from the Tabler Emails package are ready to use in your email marketing campaigns. This guide explains how to use them effectively.
+---
+
+## Compiled version of the template
+
+If you only want to change content (text or images) of the email template, you can just use the compiled HTML files - `compiled.html`. They are ready to use, and you need only a basic knowledge of HTML to modify them.
+
+## How to modify the compiled HTML files
+
+1. Open the `compiled.html` file in your favorite code editor.
+2. Find the content you want to change inside the `<body>` element.
+3. Modify the content as needed:
+* Change the text, which is mostly placed inside the `<p>` or `<h1>` tags.
+* Change the images by replacing the `src` attribute of the `<img>` tag.
+* Change the links by replacing the `href` attribute of the `<a>` tag.
+* Remove the HTML elements you don't need, but only if you're sure that they are not necessary for the email template to work correctly.
+4. If you changed the images, make sure to replace them in the `assets/` folder.
+5. Remove all the images you don't use from `assets/` to reduce the size of the email template.
+
+## How to use the compiled HTML files
+
+After changing the templates as needed, you can use them in your email campaigns.
+The `compiled.html` file with the `assets/` folder should be sent to your email marketing tool, like Mailchimp, SendGrid, or any other.

core/docs/emails/introduction/contents.mdx

@@ -0,0 +1,63 @@
+---
+title: Contents
+order: 1
+seoTitle: Tabler Emails - Content of the package
+description: Content of the Tabler Emails package.
+summary: The Tabler Emails package contains files which can be used by everyone, even without great knowledge of HTML.
+seoDescription: todo
+---
+
+## Folder structure
+
+Once you unzip the downloaded file, you will see the following structure:
+
+```
+tabler-emails/
+├── emails/
+|	├── absence/
+|	|	├── assets/
+|	|	├── compiled.html
+|	|	├── compiled-dark.html
+|	|	├── source.html
+|	|	├── source-dark.html
+|	|	├── screenshot.jpg
+|	|	├── screenshot-dark.jpg
+|	|	├── screenshot-mobile.jpg
+|	|	└── screenshot-mobile-dark.jpg
+|	├── access-token/
+|	├── account-deleted/
+|	├── .../
+|	├── welcome/
+|	└── whishlist/
+├── images/
+|	├── chart-donuts/
+|	├── icons/
+|	├── illustrations/
+|	└── overlays/
+├── license.txt
+└── readme.html
+```
+
+## Understanding the file structure in Tabler Emails
+
+The **Tabler Emails** package is organized into a clear and efficient folder structure to streamline the use of its assets. Below is a breakdown of its key directories:
+
+### 1. Email Templates: `emails/`
+This folder contains <EmailsCount /> email subfolders, each with a specific template. Each email folder contains the following files:
+* Compiled HTML files for light and dark themes. Read more about their usage in the [Compiled HTML](/docs/emails/compiled-html) section.
+* Source HTML files for light and dark themes. Find more information in the [Source HTML](/docs/emails/source-html) section.
+* Screenshot images for desktop and mobile views.
+* Assets folder with images used in the email template and the CSS file with styles.
+
+### 2. Images: `images/`
+It contains 4 subfolders with images used across the different email templates:
+* `chart-donuts/`: Images of donut charts with different fills.
+* `icons/`: [Tabler Icons](/icons) used in the email templates, in PNG version.
+* `illustrations/`: PNG versions of [Tabler Illustrations](/illustrations) for light and dark themes.
+* `overlays/`: Overlay images used in the email templates.
+
+### 3. License: `license.txt`
+This file contains the license information for the Tabler Emails package.
+
+### 4. Readme: `readme.html`
+This file with the main information about the Tabler Emails package. It contains a brief description of the package and instructions on how to use it.

core/docs/emails/introduction/index.mdx

@@ -0,0 +1,9 @@
+---
+title: Introduction
+seoTitle: Introduction to Tabler Emails
+description: Base information about Tabler Emails package.
+summary: Tabler Emails is a set of 80 eye-catching, customizable HTML templates. They are compatible with over 90 email clients and devices.
+seoDescription: Tabler Emails is a collection of 80 premium, customizable HTML templates. They are compatible with over 90 email clients and devices.
+---
+
+

core/docs/emails/introduction/source-html.mdx

@@ -0,0 +1,26 @@
+---
+title: Source templates
+order: 3
+seoTitle: Tabler Emails - How to use the source HTML email templates
+description: Learn how to use the source HTML email templates from the Tabler Emails package.
+summary: The source HTML files from the Tabler Emails package need a bit more work than the compiled ones. Learn how to use them.
+seoDescription: The source HTML files from the Tabler Emails package need a bit more work than the compiled ones. Learn how to use them.
+---
+
+## Source version of the template
+
+If you want to make more advanced changes to the email template, you can use the source HTML files - `source.html` combined with the `theme.css` file. They are ready to use, but you need a basic knowledge of HTML and CSS to modify them.
+
+## How to modify the source HTML files
+
+1. Open the `source.html` file in your favorite code editor.
+2. Open the `theme.css` file from the `assets/`* directory in the same editor.
+3. Change all the content and styles as needed.
+4. Use a selected tool to inline the CSS styles into the HTML file. There are a lot of options, such as:
+* Online tools like [Juice](https://automattic.github.io/juice/) or [Mailchimp CSS Inliner Tool](https://templates.mailchimp.com/resources/inline-css/).
+* NPM tools like [juice](https://www.npmjs.com/package/juice) or [inline-css](https://www.npmjs.com/package/inline-css).
+5. Save the output HTML file.
+
+## How to use the source HTML files
+
+To use the modified HTML template send the output file with the `assets/` folder to your email marketing tool.

core/docs/index.mdx

@@ -11,6 +11,6 @@ Find all the guides and resources you need to develop with Tabler and our other
    <Card title="UI Components" href="/docs/ui" icon="paint">Free and open source web application UI kit based on Bootstrap</Card>
    <Card title="Icons" href="/docs/icons" icon="ghost"><IconsCount /> pixel-perfect icons for web design and development</Card>
    <Card title="Illustrations" href="/docs/illustrations" icon="brand-figma"><IllustrationsCount /> customizable SVG illustrations for your web project</Card>
-   <Card title="Email Templates" icon="mail" disabled badge="Coming soon"><EmailsCount /> responsive email templates ready to use in your marketing campaigns</Card>
-   <Card title="Avatars" icon="user-circle" disabled badge="Coming soon">Package of over 100 avatars for your next web project</Card>
-</Cards>
+   <Card title="Email Templates" href="/docs/emails" icon="mail"><EmailsCount /> responsive email templates ready to use in your marketing campaigns</Card>
+   <Card title="Avatars" icon="user-circle" disabled badge="Comming soon">Package of over 100 avatars for your next web project</Card>
+</Cards>