@faqir-ui/core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Narcis Brindusescu
+
+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,97 @@
+# @faqir-ui/core
+
+The Faqir UI **runtime** — a zero-dependency, Alpine-style reactive engine plus
+prebuilt, per-theme CSS bundles. This is the *trial & embed* path: drop two tags into
+any HTML file and you have a styled, interactive Faqir page. No build step, no install.
+
+> The CLI (`faqir-ui-cli`) remains the *ownership* path — it copies component files into
+> your project so you can audit, theme, and upgrade them. The CDN is for scratch pages,
+> CodePen, Claude artifacts, and agents without a shell.
+
+## The two-tag CDN story
+
+```html
+<!-- 1. A theme's full CSS bundle (tokens + theme + base + every component) -->
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@faqir-ui/core@0.2/dist/faqir.default.css">
+
+<!-- 2. The reactive engine — sets window.Faqir and auto-boots on DOMContentLoaded -->
+<script src="https://cdn.jsdelivr.net/npm/@faqir-ui/core@0.2/dist/faqir-core.min.js" defer></script>
+```
+
+That's it. Now write Faqir markup:
+
+```html
+<div l-data="{ count: 0 }" data-ui="surface">
+  <button data-ui="button" data-variant="primary" l-on:click="count++">
+    Clicked <span l-text="count">0</span> times
+  </button>
+</div>
+```
+
+Swap the stylesheet to change theme: `faqir.default.css`, `faqir.midnight.css`,
+`faqir.paper.css`, `faqir.document.css`, `faqir.brutalist.css`.
+
+## Subresource Integrity (SRI)
+
+Every file in `dist/` has a SHA-384 hash in [`dist/sri.json`](./dist/sri.json). Pin them
+for tamper-proof loads:
+
+```html
+<link rel="stylesheet"
+      href="https://cdn.jsdelivr.net/npm/@faqir-ui/core@0.2/dist/faqir.default.css"
+      integrity="sha384-…paste from sri.json…"
+      crossorigin="anonymous">
+<script src="https://cdn.jsdelivr.net/npm/@faqir-ui/core@0.2/dist/faqir-core.min.js"
+        integrity="sha384-…paste from sri.json…"
+        crossorigin="anonymous" defer></script>
+```
+
+## Artifacts (in `dist/`)
+
+| File | What it is |
+|------|------------|
+| `faqir-core.mjs` | Real ESM — what `import "@faqir-ui/core"` resolves to. `export default` plus one named export per engine member. |
+| `faqir-core.js` | Canonical UMD engine — what `<script src>` and the CDN load. Reachable explicitly at `@faqir-ui/core/faqir-core.js`. |
+| `faqir-core.min.js` (+ `.map`) | Minified classic-script build; a plain `<script src>` sets `window.Faqir`. |
+| `faqir.{theme}.css` | Full CSS bundle per theme: all tokens + theme + base + every component. Self-contained (no `@import`). |
+| `plugins/` | Official self-registering drops: `faqir-persist`, `faqir-intersect`, `faqir-collapse`, and `faqir-validate`. |
+| `sri.json` | SHA-384 integrity hashes for every file above. |
+
+## Module usage
+
+The package is **ESM-only**. The default export is the engine; every member is
+also a named export, so a bundler can tree-shake the import site (the engine
+itself is one blob and is not tree-shakeable).
+
+```js
+import Faqir from "@faqir-ui/core";              // dist/faqir-core.mjs
+import "@faqir-ui/core/dist/faqir.default.css";  // or your project's own bundle
+
+Faqir.start();
+```
+
+```js
+import { start, reactive, store } from "@faqir-ui/core";
+start();
+```
+
+There is no `require` condition. `require("@faqir-ui/core")` fails on Node 18
+and 20 with a message pointing at `import()`, and resolves through `default` on
+Node ≥ 22.12; use `await import("@faqir-ui/core")` from CommonJS. The UMD build
+is still published for `<script>` and CDN use and can be reached directly:
+
+```js
+// UMD, for a bundler that must have CommonJS-shaped bytes
+import "@faqir-ui/core/faqir-core.js";  // sets globalThis.Faqir
+```
+
+## Building
+
+Artifacts are generated from the registry by the repo build (Bun required to build, not
+to run):
+
+```sh
+bun run build:core-package   # → packages/core/dist/*
+```
+
+Zero runtime dependencies. MIT licensed.

package/cdn.json

@@ -0,0 +1,28 @@
+{
+  "package": "@faqir-ui/core",
+  "version": "1.0.0",
+  "base": "https://cdn.jsdelivr.net/npm/@faqir-ui/core@1.0.0/dist/",
+  "integrity": {
+    "faqir-core.js": "sha384-vH2gsWr7R/OAJLvYeBC4txN6mleQzdRiuLsc5AH2xbdge5+zQipF5AqSJS7Yc4Vz",
+    "faqir-core.min.js": "sha384-BHt1gSursbCylX/U3FT6iW5dWukyZcjDXKWOanw4baYgwn8qj1LIpI1It8ct7CyK",
+    "faqir-core.min.js.map": "sha384-io5FkzZ1meZXs3UY/kEJkmvB8YXwO/JfezQe4yZop6KZZjjwn6UCjeDUSh0FG1sz",
+    "faqir-core.mjs": "sha384-jqsZ/HqqXSuUjt6SikvDjynm7EdDVAfVLXYSoJHjzvOF+3V5CDmEZgzXDJPWvQ4I",
+    "faqir.aurora.css": "sha384-M7yDwTC7MuWfGfiIFLv9MFibCkYDDSHx6RFszEQ7iyd4Lp/bEG/SIyRcvSsfn2Vv",
+    "faqir.brutalist.css": "sha384-aRtTqpJetmoMa6uL2krMPEHsjTwF11oNlTzS9zZrdtqXSvzkSUCKKoHyr1WbCBnb",
+    "faqir.contrast.css": "sha384-Fy3tZU7cwb7LGNm9B/5nFNK1yRgwAZqv+FF69pY/w6AEGykZA4jSoDeFKU4hXdBf",
+    "faqir.default.css": "sha384-w2sH1K7AwYMeLQIhxBnAU1LuRrexg/xJx/eLLMgAjG7avxLYhYeuvM2pTu1yJJVi",
+    "faqir.document-serif.css": "sha384-2xWhB1DahXndhbbk7D+RV6w1NI7lPoO3tPgVtDvgWp8G+qE4jjI5nCWZa0IC1XiV",
+    "faqir.document.css": "sha384-loA3uWvclgLBd8OntpB4YrQP/jBsLScb06KI61EMauFjYxOadmCszUBkYYNoo4Wc",
+    "faqir.glass.css": "sha384-OQOzZy8BxLxPl1pFNkCwizX0oqOsmPf49FKhFa4d9HUM6bcJrJnzw3XU8IZGqSkG",
+    "faqir.midnight.css": "sha384-J0SQyAklYwD+yJ7jubtIJ+0t9DWBymcJikhI242PpTvzAL9SU4iWTYCwJBqSUbj0",
+    "faqir.paper.css": "sha384-OCmkztWvVBgacdb9HlGiRl+RRQ1QaFU8MCrQIYLeL17EMsT2tG8lZeU0mfQKLo6N",
+    "faqir.slate.css": "sha384-BxHSyxsLdi690Q1LBWIyAXodugjLNT764ZjqBRAaCtAaQeei81qzV46C5rMYonb4",
+    "faqir.soft.css": "sha384-a77S0Tcfd1I2V+r6Prt4gTtIzSZahltCuQ0jEzOKXUd+taDRjM0EsIy3n5VycLJT",
+    "faqir.terminal.css": "sha384-YvP4CkNUhcsFYJjBgnhcSMthsEheRg2RlZ0837GBzDVfmeJx9IYpMSrG7BkAb697",
+    "plugins/faqir-collapse.js": "sha384-y16PnFkcJiJLQIxuQMtdS+QalrC6lJ0EsPT/oceZWpLMGdqASXq3HhVHebfUWktm",
+    "plugins/faqir-intersect.js": "sha384-AfbB6icyS1ngl1JdiAMZ9//m5lHTMdgXXHWCdi5INfE9FmLbYRUeiyKTv4E4g6ri",
+    "plugins/faqir-mask.js": "sha384-cSq2DpUnoJCxEDAQjsbzAa+jSuHf4WsOaKT8t7b9p8pA7MaaRhA1DLzjMNChSa/I",
+    "plugins/faqir-persist.js": "sha384-o0jfddebC8QZ3S26VXUlOme723BNMlb/N7vqpn+fWpSeEFXzpq+3MoeXhVL/0PSv",
+    "plugins/faqir-validate.js": "sha384-DSzQ7I94Qm+VKjpgBo3qgALyuU3zgQZ+jXOIqgRHkJ6utr8nqF7tQMKWnOv1/YH2"
+  }
+}