From f8075f69c0b79f8d3a6ae1d6721cffe22fe73097 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Kuna?=
 <1282324+codecalm@users.noreply.github.com>
Date: Mon, 12 May 2025 22:14:42 +0200
Subject: [PATCH] Add documentation for 3rd-party libraries and resources
 (#2356)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Kevin Papst <kevinpapst@users.noreply.github.com>
Co-authored-by: Bartłomiej Gawęda <bagaweda@gmail.com>
---
 .changeset/wise-deers-refuse.md               |   5 +
 docs/content/ui/getting-started/references.md |   7 +
 shared/data/open-source.json                  | 122 ++++++++++++++++++
 .../includes/docs/open-source-resources.html  |  24 ++++
 4 files changed, 158 insertions(+)
 create mode 100644 .changeset/wise-deers-refuse.md
 create mode 100644 docs/content/ui/getting-started/references.md
 create mode 100644 shared/data/open-source.json
 create mode 100644 shared/includes/docs/open-source-resources.html

diff --git a/.changeset/wise-deers-refuse.md b/.changeset/wise-deers-refuse.md
new file mode 100644
index 000000000..d9f8a8977
--- /dev/null
+++ b/.changeset/wise-deers-refuse.md
@@ -0,0 +1,5 @@
+---
+"@tabler/docs": patch
+---
+
+Add documentation for 3rd-party libraries and resources
diff --git a/docs/content/ui/getting-started/references.md b/docs/content/ui/getting-started/references.md
new file mode 100644
index 000000000..1f1a8d731
--- /dev/null
+++ b/docs/content/ui/getting-started/references.md
@@ -0,0 +1,7 @@
+---
+title: 3rd-party Libraries & Resources
+---
+
+Tabler uses the following open source resources:
+
+{% include "docs/open-source-resources.html" %}
diff --git a/shared/data/open-source.json b/shared/data/open-source.json
new file mode 100644
index 000000000..c1b59cfa4
--- /dev/null
+++ b/shared/data/open-source.json
@@ -0,0 +1,122 @@
+[
+  {
+    "name": "Bootstrap",
+    "url": "https://getbootstrap.com/",
+    "description": "The most popular front-end framework for developing responsive, mobile first projects on the web.",
+    "license": "MIT"
+  },
+  {
+    "name": "IMask",
+    "url": "https://imask.js.org/",
+    "description": "Vanilla JavaScript input masking library with support for various mask types and dynamic behavior.",
+    "license": "MIT"
+  },
+  {
+    "name": "Autosize",
+    "url": "https://www.jacklmoore.com/autosize/",
+    "description": "Automatically adjusts textarea height to fit text content.",
+    "license": "MIT"
+  },
+  {
+    "name": "ApexCharts",
+    "url": "https://apexcharts.com/",
+    "description": "Modern charting library offering interactive and responsive charts.",
+    "license": "MIT"
+  },
+  {
+    "name": "noUiSlider",
+    "url": "https://refreshless.com/nouislider/",
+    "description": "Lightweight JavaScript range slider with multi-touch support and extensive customization options.",
+    "license": "MIT"
+  },
+  {
+    "name": "CountUp.js",
+    "url": "https://inorganik.github.io/countUp.js/",
+    "description": "Animates numerical values by counting up to them.",
+    "license": "MIT"
+  },
+  {
+    "name": "List.js",
+    "url": "https://listjs.com/",
+    "description": "Adds search, sort, and flexibility to tables, lists, and various HTML elements.",
+    "license": "MIT"
+  },
+  {
+    "name": "Masonry",
+    "url": "https://masonry.desandro.com/",
+    "description": "JavaScript grid layout library that arranges elements optimally based on available vertical space.",
+    "license": "MIT"
+  },
+  {
+    "name": "Mapbox GL JS",
+    "url": "https://docs.mapbox.com/mapbox-gl-js/",
+    "description": "JavaScript library for interactive, customizable vector maps on the web.",
+    "license": "BSD-3-Clause"
+  },
+  {
+    "name": "Litepicker",
+    "url": "https://github.com/wakirin/Litepicker",
+    "description": "Lightweight, no-dependency date range picker.",
+    "license": "MIT"
+  },
+  {
+    "name": "Tom Select",
+    "url": "https://tom-select.js.org/",
+    "description": "Dynamic and framework-agnostic <select> UI control with autocomplete and keyboard navigation.",
+    "license": "Apache-2.0"
+  },
+  {
+    "name": "jsVectorMap",
+    "url": "https://jvm-docs.vercel.app/",
+    "description": "Lightweight JavaScript library for creating interactive maps and data visualizations.",
+    "license": "MIT"
+  },
+  {
+    "name": "Fslightbox",
+    "url": "https://fslightbox.com/",
+    "description": "Vanilla JavaScript plugin for displaying images and videos in a fullscreen lightbox.",
+    "license": "MIT"
+  },
+  {
+    "name": "HugeRTE",
+    "url": "https://hugerte.org/",
+    "description": "MIT-licensed fork of TinyMCE, a web-based JavaScript HTML WYSIWYG editor control.",
+    "license": "MIT"
+  },
+  {
+    "name": "Plyr",
+    "url": "https://plyr.io/",
+    "description": "Simple, accessible, and customizable HTML5, YouTube, and Vimeo media player.",
+    "license": "MIT"
+  },
+  {
+    "name": "Dropzone",
+    "url": "https://www.dropzone.dev/",
+    "description": "Open-source library that provides drag-and-drop file uploads with image previews.",
+    "license": "MIT"
+  },
+  {
+    "name": "Star Rating.js",
+    "url": "https://pryley.github.io/star-rating.js/",
+    "description": "Lightweight JavaScript library for rendering star ratings.",
+    "license": "MIT"
+  },
+  {
+    "name": "Coloris",
+    "url": "https://github.com/melloware/coloris-npm",
+    "description": "Lightweight and elegant color picker written in vanilla JavaScript.",
+    "license": "MIT"
+  },
+  {
+    "name": "Typed.js",
+    "url": "https://mattboldt.com/demos/typed-js/",
+    "description": "JavaScript library that types out sentences in a human-like manner.",
+    "license": "MIT"
+  },
+  {
+    "name": "Signature Pad",
+    "url": "https://github.com/szimek/signature_pad",
+    "description": "JavaScript library for drawing smooth signatures.",
+    "license": "MIT"
+  }
+]
\ No newline at end of file
diff --git a/shared/includes/docs/open-source-resources.html b/shared/includes/docs/open-source-resources.html
new file mode 100644
index 000000000..cc52e2028
--- /dev/null
+++ b/shared/includes/docs/open-source-resources.html
@@ -0,0 +1,24 @@
+<table class="table">
+	<tr>
+		<th>
+			Name
+		</th>
+		<th>
+			Description
+		</th>
+		<th>
+			License
+		</th>
+	</tr>
+	{% for resource in open-source %}
+	<tr>
+		<td>
+			<a href="{{ resource.url }}" target="_blank">
+				{{ resource.name }}
+			</a>
+		</td>
+		<td>{{ resource.description | escape }}</td>
+		<td>{{ resource.license }}</td>
+	</tr>
+	{% endfor %}
+</table>
\ No newline at end of file