arekui 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andika Rekatias
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,198 @@
+# Arekui
+
+A standalone CSS framework. No dependencies, no build step. Just link and go.
+
+34 components, 3 themes (light/dark/neobrutalism), utility classes, and a smart builder that only outputs what you use.
+
+## Quick Start
+
+```html
+<link rel="stylesheet" href="arekui.css">
+```
+
+That's it. No npm required. Works in any HTML file.
+
+### Themes
+
+```html
+<html data-theme="light">
+<html data-theme="dark">
+<html data-theme="neo">     <!-- neobrutalism -->
+```
+
+Falls back to system preference if no theme is set.
+
+### Install via npm
+
+```bash
+npm install arekui
+# or: pnpm add arekui / yarn add arekui / bun add arekui
+```
+
+## Components
+
+`ar-btn` · `ar-card` · `ar-modal` · `ar-navbar` · `ar-tabs` · `ar-accordion` · `ar-drawer` · `ar-toast` · `ar-badge` · `ar-alert` · `ar-table` · `ar-forms` (input, select, checkbox, radio, toggle, textarea) · `ar-carousel` · `ar-skeleton` · `ar-breadcrumb` · `ar-pagination` · `ar-rating` · `ar-chat` · `ar-tag` · `ar-popover` · `ar-file-upload` · `ar-scroll-top` · `ar-tooltip` · `ar-footer` · `ar-hero` · `ar-prose` · `ar-progress` · `ar-timeline` · `ar-divider` · `ar-stepper` · `ar-avatar` · `ar-swap` · `ar-link` · `ar-join`
+
+All prefixed with `ar-`. No conflicts with other frameworks.
+
+### Buttons
+
+```html
+<button class="ar-btn">Default</button>
+<button class="ar-btn ar-btn-primary">Primary</button>
+<button class="ar-btn ar-btn-outline">Outline</button>
+<button class="ar-btn ar-btn-ghost">Ghost</button>
+<button class="ar-btn ar-btn-disabled" disabled>Disabled</button>
+```
+
+### Cards
+
+```html
+<div class="ar-card">
+  <div class="ar-card-body">
+    <h3 class="ar-card-title">Title</h3>
+    <p>Content goes here.</p>
+    <button class="ar-btn ar-btn-primary">Action</button>
+  </div>
+</div>
+```
+
+### Modal
+
+```html
+<dialog class="ar-modal">
+  <div class="ar-modal-box">
+    <h3>Hello</h3>
+    <p>Modal content</p>
+    <button data-ar-close>Close</button>
+  </div>
+  <form method="dialog" class="ar-modal-backdrop">
+    <button>close</button>
+  </form>
+</dialog>
+
+<button data-ar-open="my-modal">Open</button>
+```
+
+### Navbar
+
+```html
+<nav class="ar-navbar ar-bg-base-200 ar-p-4">
+  <div class="ar-navbar-start">Logo</div>
+  <div class="ar-navbar-center">Title</div>
+  <div class="ar-navbar-end">
+    <button class="ar-btn">Login</button>
+  </div>
+</nav>
+```
+
+See `demo/index.html` for every component.
+
+## Utilities
+
+Spacing: `ar-p-4`, `ar-m-2`, `ar-gap-4`
+Layout: `ar-flex`, `ar-grid`, `ar-grid-cols-3`, `ar-items-center`
+Typography: `ar-text-lg`, `ar-font-bold`, `ar-text-center`
+Colors: `ar-bg-primary`, `ar-text-base-content`
+Borders: `ar-rounded-lg`, `ar-shadow-md`, `ar-border`
+Responsive: `ar-md:grid-cols-2`, `ar-lg:flex`
+
+## Theming
+
+Override tokens in your own CSS:
+
+```css
+html[data-theme="light"] {
+  --ar-primary: oklch(65% 0.2 250);
+  --ar-radius-box: 1rem;
+}
+```
+
+### Neo Theme
+
+Hard shadows, thick borders, bold colors:
+
+```css
+--ar-shadow-md: 4px 4px 0px 0px #1e293b;
+--ar-border-width: 3px;
+--ar-primary: #00AEEF;
+```
+
+Use `ar-neo-*` utilities with any theme:
+
+```html
+<div class="ar-neo-shadow-lg ar-neo-border">Bold shadow</div>
+```
+
+## Smart Build
+
+`arekui-build` scans your source and only includes what you use.
+
+```bash
+npx arekui-build -i ./src -o ./assets
+```
+
+Your HTML uses `ar-btn`, `ar-card`, and `ar-flex`? Output includes only those — not all 34 components.
+
+### Config file (optional)
+
+```js
+// arekui.config.js
+module.exports = {
+  input: "./src",
+  output: "./assets",
+  name: "app",
+};
+```
+
+```bash
+npx arekui-build    # reads config
+```
+
+### CLI flags
+
+| Flag | What it does |
+| ------ | -------------- |
+| `-i` | Directory to scan |
+| `-o` | Output directory |
+| `-n` | Output filename |
+| `--sourcemap` | Generate sourcemap |
+| `--full` | Include everything |
+
+## JavaScript API
+
+Optional. Loads via `<script src="arekui.js">`.
+
+```js
+ARStyle.setTheme("dark");
+ARStyle.getTheme();
+
+ARStyle.toast("Saved!", { type: "success", duration: 3000 });
+ARStyle.openPopover("my-popover");
+ARStyle.closePopover("my-popover");
+ARStyle.setRating(el, 4);
+ARStyle.getRating(el);
+```
+
+## TypeScript
+
+Types included. Full autocomplete in VS Code.
+
+```ts
+import ARStyle from "arekui";
+
+ARStyle.setTheme("dark");
+ARStyle.toast("Hello", { type: "info" });
+```
+
+## Browser Support
+
+Modern browsers. Chrome, Edge, Firefox, Safari. Needs CSS custom properties support.
+
+## License
+
+MIT — use it however you want.
+
+---
+
+Made by [Andika Rekatias](https://github.com/andikarekatias)