@faqir-ui/core 1.1.2 → 1.2.0

package/dist/sri.json

@@ -1,39 +1,44 @@
 {
-  "faqir-core.js": "sha384-GHlaOUQ2hVOWHPv9DiXtyYgtCqdiwSB9LZ9gzvEcImqa8ISSkWprEfGjBpth/hK2",
-  "faqir-core.min.js": "sha384-QIoNAZIvm+fow0p483t3dS7yjI/2mNpEfyg+xRq6mIKNJ0pbhTMDvS+RsXzWPXH+",
-  "faqir-core.min.js.map": "sha384-D9M6vk5GQ302jHMYBA42YyBBAzoYFB14/Ai+4Q3SvYoHKaNnOwgVUCmY0udJee7l",
-  "faqir-core.mjs": "sha384-NgEl5+je3pP718IFtOWR3i5nlcXmYOT2wVeY8yl5/03e1S6leM4kIIOXnewOgTqL",
-  "faqir.aurora.css": "sha384-ZfycA0bNs1ZOLQFVAShto3TMcXm1ZkYd7HkENleFW9UHWAmM0rYFmAsDlRcbpD1P",
-  "faqir.brutalist.css": "sha384-rKEWQ1ocsmIa4hFZrqSyZwADRrt2zlp+xvEeSjXgTlSq+xbODy16jyj0TThiRRIH",
-  "faqir.candy.css": "sha384-9j6Hc3tfMFgU6AvZWLmXKXmWbe3UtYy4BPlfSCLWJ72OdhVzv/9uCVCsesXc3lll",
-  "faqir.clinical.css": "sha384-fkMPP/oMpdji3Jbk4ZNAEwFCwxFVwcBSJm5xBmL8Fyw+XG5R9DG3jQdu7p3PwK2j",
-  "faqir.contrast.css": "sha384-OHHowNIftVzWHlj6/4ps50ZHA6MJG6AkCxcixjZ63tkxCDpr83Wp7BLLbRJAb6ho",
-  "faqir.default.css": "sha384-m9mJ/+g9iFEVKJCVE46Cfvmf21WKOOxjGKXwSAnUTacD6MKXMsZc9J+yWCyvWBNn",
-  "faqir.document-serif.css": "sha384-g/vf0oMKMJNlxzcY2EMzou3EB5K6iN/09n6dbODX2ByMqZovShnKNynZVFdQzCE9",
-  "faqir.document.css": "sha384-HINAn/RdXt2R48f7F44PZlhc1//xUew3qwL79YzJTsezdvePKQdFltQwOtyihUXu",
-  "faqir.editorial-document.css": "sha384-7/lBHx0lZ9PJqB42PKKE55LtgXo682gOWgInWLgtIlUjoCzLR5/oTanZfGwd/Bch",
-  "faqir.editorial.css": "sha384-uUiMtRova00e/GuBXW/N2uVY3l048tYj3bv+ga067W6ZvKwx4i8yULm6RbxB8wlo",
-  "faqir.fintech.css": "sha384-OWyfsC3mjXV3OXWG2uo/vioWW9tnv8W+jDENq1XqC1Lj4Y02pRDfaB10kIQoWri6",
-  "faqir.glass.css": "sha384-qkx/DVixf/A+8Cw7R7ADAKdyZnICWasgTMwmyEKNoI59AiGjRR6rr5+8IVmS+UMw",
-  "faqir.ink-document.css": "sha384-a39pfAsSIa/wBMpwwF6kvZw6kWLc1qRHFcZefJCY2f49lpmeYzaEi2g9YVCwYc9V",
-  "faqir.ink.css": "sha384-xWghw25FmwTdJKEyG76GUh/K7kuDMspbefBPUkfDUTcC9ZRdfMqRtbHLzTxo/ugb",
-  "faqir.luxe.css": "sha384-EhVP+DEEzB9f7JenTo9G+1WdeLWUsEdYy59k4b/1uiP+/plnjr+TceCb4b+dkfGy",
-  "faqir.midnight.css": "sha384-RpEh4Rhpw3ffsiV1Xy+S2ZhLhQMiwxnwHLwfB1vDwCSR7SlyoEQB/+sJNT5pgoC3",
-  "faqir.neo.css": "sha384-peEZz+vAHXoXmmTZbFTcBKQka7IZAe2HnyBDDLXyTjSsGPZ7AMYVYzvaa9O9XfVF",
-  "faqir.neumorph.css": "sha384-XjnfiTcYKSOS6QGxXXhlWjgxwsc2IK/uMRrB9JxiV9bxKNV19aiHeTR4keBtnSuy",
-  "faqir.nordic.css": "sha384-ia8Jun21Bvz26UJkbnus0saxO2/Pxh/C+OStv07uFe029z8Ma9aEjFqXG9XQNazF",
-  "faqir.organic.css": "sha384-uNmSZ1VJwDxC9hh7NnwDy5sUYEx7CFZdPQDmpebO5SVDOhIPJyo9baRc4+4tD4sa",
-  "faqir.paper.css": "sha384-v19qP8TYy5uqAGiFTb0lLnpId68wYMGYNKalvZ+sKVL836TQC3ZC8k2LTvFVfX3n",
-  "faqir.slate.css": "sha384-XfZ4IWpVS7+6m6ZqU3nEsNveg7X7WU5s9yOU+tkTkV6ALMohiG9u+zhCSkWuLCBJ",
-  "faqir.soft.css": "sha384-YZ8hVr92Fbfdnve44ue2RvojtgPyJcdzO55vMnCo7aH5WtnznV6SRIl3/p+Pypk5",
-  "faqir.sunset.css": "sha384-h2Ovn9eS+QCl24cojeI8LNjWk1uIsB3pjdyVxOz8KizMXQltFm3B9Y/rGL3OLx71",
-  "faqir.swiss-document.css": "sha384-ujQOm08Wdiy3TW2HNrf4dpBH5nwXjqgWJGPEPMXr6zZ4ihu6udkAroXjuTQyJhJc",
-  "faqir.swiss.css": "sha384-4C8wATYMgbyNm4wjsaxgqqtVEpMQI4EyAfsNBVFwB8GuNkMrsrhMIP0rpRWBYhJ4",
-  "faqir.terminal.css": "sha384-fcEM0/i8MaY7XKf5Bhqt8cELiuJwCn8pwFX/tYPhDstOYzii4msJxufh9xFpk4zX",
+  "faqir-core.js": "sha384-oSPiZQb5mIYtZmrsnNSo8k+hPR5Vtj+vRBhyzNozUvPreSMCtlFAbpN1yC6h6Uxh",
+  "faqir-core.min.js": "sha384-Y/ObjBaUa4Ex33uNV5X++IK1pNAbYjGKYgPKfqHcjuL4xBb2At005nebcWxtkh/s",
+  "faqir-core.min.js.map": "sha384-BIOKuESd9GUiom8bpxYvxVJX7JnTzOmUG9vZpFUWEStCmZItzqvoyYxzLTHimjcT",
+  "faqir-core.mjs": "sha384-UDfHzfCPD8MgedS3Lh5vgtD3G7q+f3gtC402jFEb17qOkdZdxmikvriRhWFM2WqD",
+  "faqir.aurora.css": "sha384-O7Wv2oLKBqIIa2fFLZtmIeDTfVRIY7xahud1ANigc9GrwuXWC8S5mgq+49dTbcjm",
+  "faqir.brutalist.css": "sha384-hKZywJEhj3gZMRrUKzpDzPDe8SbUfT65XTCMr73jwqk36wYcFH61RlmlXtnecdoz",
+  "faqir.candy.css": "sha384-dCgK+o1yNlP8V+ZKU4Bd0AkVwOdX3834QdyX1q77cI2HwPECGio9E+JFE6fe2zPO",
+  "faqir.clay.css": "sha384-kMWNTs1EyXt8mGO0jCDRQATe3RtoE+ib2nTlA4I9dEfKrm/wRXEB/EOmBflmYeZV",
+  "faqir.clinical.css": "sha384-MUphY05uuN+f06x8uE3SSDa1OB09VwoDtz2VtGf7jzaROYMIwavQ6QyJF59QG6cu",
+  "faqir.contrast.css": "sha384-tDWLh2dEAEilGupWHgXCWqT7nSWUqjw9jCKhjwZNizBgSUSvv2n8qw2WbY6quIXm",
+  "faqir.deco.css": "sha384-iMIsXH+vKkvn371uVOkeLI/8GlBOzbWgp3ZbypZZBPh2Sx72hOwEsxYFKqsfEnDt",
+  "faqir.default.css": "sha384-uEZhIJiJ3OqaxWWs9bQYa8WXwVi6h5NCzpGghGrKfL9fHgwz5EM+8V+HNFIcbBn3",
+  "faqir.document-serif.css": "sha384-G1fXY22VtWhZU7OFgjoYAHKRHsrRrgsNK/Q9ujFZ6QEXPIUWmxGxmdqWwt77Sp9X",
+  "faqir.document.css": "sha384-uFsIc0MPqiYO5M3IEVuA9/d8Fie9bovzNPEurO2WfoWxaRDaPU+OX1DvSTdJlznj",
+  "faqir.editorial-document.css": "sha384-6bwR/CcUYm9+EfleRr1575dUDam5j+42n2oFLBOHsriRshRjFqu7RhFeUqh+qz18",
+  "faqir.editorial.css": "sha384-MNXkBiePIc8/vz6uRHXBrQXpUnsaAKj9ewRTtKgn3NsJVQteqIdFd+iRDk85UXum",
+  "faqir.fintech.css": "sha384-OeZiY4mj/BTS5UOSkUO8N09wJnA647RPTNMn4xAUONSMQaM5hmz39OpSK+CZTS8t",
+  "faqir.glass.css": "sha384-XxsAsrZsI7bSoiXY0M69nHODL9RXLsypPiQRNi/a3t7mPgRlrfpVeF1XqazySwIZ",
+  "faqir.ink-document.css": "sha384-ckm9FvqPBGKYH0a/YjS5/VEb0wzIDwQZ2nUexPw/tVMJmfdUA7Fv9mYHBAMfcAmm",
+  "faqir.ink.css": "sha384-1+0kDzO3g/8DJVJRnfbyYiFTkDkLFub31wDUXQOpyATkYlaRXuAqGUOickpnZDHI",
+  "faqir.luxe.css": "sha384-VECuRGQVX5tAPf9f4nlMLVbRt1D8QfSXIjLJymL0+3Xg5ciIt+JFTF54x5CEDtvC",
+  "faqir.memphis.css": "sha384-Ys0NhabYE9eJvtwpHXlvDy+zZYijrNSaWKysnf/O6lF9ZgcrGdeQ217UJv6vp8KN",
+  "faqir.midnight.css": "sha384-53kut5yzw/uUdx94tPiwQs7AuoXUm3WtFfubo1OqnDlleXUU1XFDNAAVt3B20J0m",
+  "faqir.monolith.css": "sha384-W5wiFpYP6jpmGJO+aJqGhZm/0UmISNpDnQIP5Nlz0UJqtNCVGf+b9Ss6AvPXRMRY",
+  "faqir.neo.css": "sha384-oFh/li8+nfUeNvFKEdjdU0enGCpy1oPbVQHnNBjBqxecjNdOn27dkGvSxSlvCb97",
+  "faqir.neumorph.css": "sha384-T+bc0+8l1Glcxzyg2BGoyFsYv1VGGS6LOklborctelrraugVpVVB2kUH+lrRFLhP",
+  "faqir.nordic.css": "sha384-YxRFYTXk8p3P/DkQK/qmIYT1djJLGPGWFLTHM4fpUeb5T+4eS3GpdDC5iNR7E5Y2",
+  "faqir.organic.css": "sha384-jInVyUMGkfiUGCUnNVtTcSWkIE9+gKD1Bro/B0BCaoDxz5lpUu7+oMT5DwYEwV6x",
+  "faqir.paper.css": "sha384-PX1BVPl7/KuVDuQwCQxr4sF+NewTOVfle9bZ84UXecZAe3hIaJk0z/Mt02Wt80MD",
+  "faqir.slate.css": "sha384-H3tEPGyt/rO6IjWLRh1AasgdJtMZoBiMG7Z6xy77TQWIDsOSvHUp6m5kOMGm380E",
+  "faqir.soft.css": "sha384-/h4lb3FiDm1xsf4lzq7Bo46QTKPCR80dXmThK57MAHHPSl9vjExdNeKWCJuHc8x+",
+  "faqir.sunset.css": "sha384-Q6HwuPDyuUm8zy1Q3oGSntM/5ShrwgYOlfzy9eTaGmpOhQezs/rM8018TDgqlzYD",
+  "faqir.swiss-document.css": "sha384-ZnsDSmgRCib00+CLAMtWE5dAvqp+K9jusr84CEMQe4u60EIOQrjetz1Px2f6TloS",
+  "faqir.swiss.css": "sha384-e9szmB9PrfXFylpwBcLafOJ9pO+L/T25Cr5B27AHXNEB4o4MZVlhfGLUMyXIh/He",
+  "faqir.terminal.css": "sha384-eVzvXojjoNdeCiLLT8SFKR6VHR9tgEJeqWNxEcbshKHrsy4oxqpititV7Rv0pbhp",
   "plugins/faqir-collapse.js": "sha384-3l5Z+isXlDkidRevDGkuNOiDp6eJ2ML11RkXA0j4ixQBaepuu8pAhyY4YRnR1qB7",
   "plugins/faqir-intersect.js": "sha384-Q/akZjAcnTnGYPKBP7b8c3iyYbHTIW1IPjBivzOH9dE7Nflr9Cu6adjeDXU2bhk6",
   "plugins/faqir-mask.js": "sha384-QvmZoq/+9/ef3U9JkdKlRMFhUMNGjnKct4JC3g7/ypEXEuTeny3JlUvsnrFv75v+",
   "plugins/faqir-persist.js": "sha384-o0jfddebC8QZ3S26VXUlOme723BNMlb/N7vqpn+fWpSeEFXzpq+3MoeXhVL/0PSv",
-  "plugins/faqir-rules.js": "sha384-xJ/JhLJ+0oryaniOzZISjeDFAgiJfFwlUw+wCrLdmpr8m0ZAtN4rsvqD/1gwl/T/",
-  "plugins/faqir-validate.js": "sha384-TIyGNL8dHBnFdV56LAhdklvhQLsClQqGuQ7DT0Zgxva8DIzfONXZSJYTXhQxJcN0"
+  "plugins/faqir-rules.js": "sha384-4P6QegEl5xANFU63W5O6J9qHNVZd2YYmSK+Fvj97LtHCOW8Zw9mskXbzw3vfJBmW",
+  "plugins/faqir-tweak.js": "sha384-hrasWR6y1Qwn7ktBPOPjuVPqam95j4YlhwGWVnbevkLdH7kklfVIUOjIpmibEcdE",
+  "plugins/faqir-validate.js": "sha384-f0J87Wkiuei3MJ6WmNUdje/Uc/LnLXdOGUtoUHfvT73XawsUfKLtniOE/qCjYpXD"
 }

package/faqir-core.d.ts

@@ -795,6 +795,46 @@ export interface Devtools {
 // The global
 // ─────────────────────────────────────────────────────────────────────────
 
+/**
+ * The theme studio `plugins/faqir-tweak.js` installs as `Faqir.tweak`. A state
+ * is the position of every dial; `apply` writes the tokens it implies onto
+ * `<html>`, `css` renders the same overrides as a `:root` block.
+ */
+export interface TweakState {
+  scheme: "" | "light" | "dark" | "auto";
+  density: "" | "compact" | "comfortable" | "spacious";
+  hue: number;
+  chroma: number;
+  radius: number;
+  space: number;
+  type: number;
+  speed: number;
+  weight: string;
+  tracking: string;
+  headingFont: "" | "sans" | "serif" | "mono";
+  bodyFont: "" | "sans" | "serif" | "mono";
+  easing: "" | "spring" | "bounce" | "linear";
+  lift: string;
+  ambient: "" | "paused";
+  border: "" | "hairline" | "regular" | "heavy";
+  depth: "" | "flat" | "deep";
+  page: string;
+  surface: string;
+}
+
+export interface TweakApi {
+  /** Apply a (partial) state; omitted dials take their defaults. Returns the full state. */
+  apply(state: Partial<TweakState> | null): TweakState;
+  /** Remove every override and restore the page's own attributes. */
+  reset(): TweakState;
+  /** The current overrides as a `:root { … }` block, ready to paste into a theme. */
+  css(): string;
+  /** Re-apply the state saved in localStorage, if any. */
+  restore(): TweakState | null;
+  /** The current state, or null before the first apply. */
+  readonly state: TweakState | null;
+}
+
 export interface FaqirGlobal {
   readonly version: string;
 
@@ -896,6 +936,8 @@ export interface FaqirGlobal {
    * the engine for exactly this reason.  [1.1B-03]
    */
   readonly validate?: ValidateApi;
+  /** The theme studio `plugins/faqir-tweak.js` installs; absent until that file loads. */
+  readonly tweak?: TweakApi;
 }
 
 declare const Faqir: FaqirGlobal;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faqir-ui/core",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "Faqir UI runtime engine — the Alpine-style reactive core (faqir-core.js), minified CDN build, and prebuilt per-theme CSS bundles. Zero dependencies.",
   "type": "module",
   "main": "./dist/faqir-core.mjs",