@faqir-ui/core 1.1.1 → 1.2.0

package/dist/sri.json

@@ -1,39 +1,44 @@
 {
-  "faqir-core.js": "sha384-ypj/JvdM2DNbSf7TIOUBlbV3kKw3JE0YuKDPkDuroqFt8H/jB2O80j0rUa/s8N9l",
-  "faqir-core.min.js": "sha384-+0VjcV+UV4XDD6Y5YZ+yJG9qiwlcZRr+LgT6uVspQgw4ynLLzyNKrDc6HDvo6uiM",
-  "faqir-core.min.js.map": "sha384-3NMITzrdJEWU6VH6d64NSzEhMGdilUMAqm7tG37R9mq1oQcbiifI7azkysTVSK/a",
-  "faqir-core.mjs": "sha384-bFYiYI3mnO3fluPZh14FGac4ZgBXPEfENyv+/ewSMHNyataamJyDJYENbGaXnV8t",
-  "faqir.aurora.css": "sha384-TrPBHGXGxwY6sLypt3kbjbhEHz87wsYgqQhzPqi5zghmsiqewgykQx6aS+WP2O0h",
-  "faqir.brutalist.css": "sha384-N/VfEAEdOZ2PGFX4xsPzlHEmDkXtjzmkXXW1Ta3PCtBV/RZm1rF4EYsfwLEvwqPZ",
-  "faqir.candy.css": "sha384-/lk9HAr46O2pYwsM8vE8MBVkPLB1t2otA3Edfux98b564DvNkWqpsD4DSVdcmHAX",
-  "faqir.clinical.css": "sha384-quTFS0lcUB0sz5ysan8vVX75oBDNzY+of7CmKDEoX5fM5OCIbYEttiZ8eLL/vQ4u",
-  "faqir.contrast.css": "sha384-Kkc5S9mDWhATTvHHfZhNd+rN06hSCvbKLuqa5y+cwtvlF7jSunMH1bLkfrZsVw5f",
-  "faqir.default.css": "sha384-bbc2p6aV7UYxrmv8M6x0buppf4uT7yh8DZ9d///ykZjXQokcZNtOk6xK1UUl6Mnj",
-  "faqir.document-serif.css": "sha384-gruBhX1KhlPRKzCVMODRBoOB+IpJM3lgYB+xQgCbu35onXyy+OFvh0MBDThrRFSq",
-  "faqir.document.css": "sha384-oC4VnHJi2ez8nAPSBwN4GWOz+BraAWcXXcGjNrQmdKujuA3fVmawKwolH1zIEzT0",
-  "faqir.editorial-document.css": "sha384-sKWLbBQ4IvgSvhLYo0nE95l6pqku+T0VTmkkoTwg/YOx5vM9gBAPA7f6CLE8gLNa",
-  "faqir.editorial.css": "sha384-N5sYSpAAOB81nDI+eShZ+gTZ5zbTMwaUt9fIPxwiNWBkKdaEJnsvyP3na/2SyNbv",
-  "faqir.fintech.css": "sha384-xY6baIhCB0boozwIAPzhPg2FFZ8RhqSf/13CWeda9Bd+9D5bvZbNuiFcO67GGLOL",
-  "faqir.glass.css": "sha384-MW9qUMfNSCgUyQjY/UqCpRxsXxuDEoVFvvpLy2htmV1Vc2mtn/z7uCXscj6Yn5zq",
-  "faqir.ink-document.css": "sha384-uWhbYEZwSDk3QHPMWe7lzYM0HELolHkW8xyqoowVvXrToqTXnSYVw7zTVET3kTVC",
-  "faqir.ink.css": "sha384-57zpUenZ+vVG/PViYuf1yxB0VxdV/5hxhZbKy9vi8XawKTMpbbU7AtnvgZ81ZIvs",
-  "faqir.luxe.css": "sha384-AP+OFzUaZ0RNEOGS95dsf09tD8ltts0VslqgCyaJ3CBHHkesKJ+/MT3SA4gZPxbe",
-  "faqir.midnight.css": "sha384-xsSMTT7Pf9i0CDFfx5hlzCBkHx5gsfORYS3rZuKnasgMkHumNUsy0fTBFcHBxSo3",
-  "faqir.neo.css": "sha384-rNHNMTeReWOmjhAayIam2CSmH3cUpHI3VbCOxg1hhk0GE3pAB2GX6tqzXH8OU9kX",
-  "faqir.neumorph.css": "sha384-7N6RHoYWSlnTHeTwVWrCn4ey1KR62fsAS0p1QVyb0gcljIYhcMWADZrmH/hOjhx+",
-  "faqir.nordic.css": "sha384-A/O40XHz2mMUs3tKWT7usnwgAxSsdFpb8uXKNMtoIa3OBaR2Ibpqg5mGNov90PaT",
-  "faqir.organic.css": "sha384-acTW5ka4Zy5SXHHn1My078WAnPkj6/KbLHKuWzToArB8rWlwZGRqlFxfq8VNAaqY",
-  "faqir.paper.css": "sha384-O26GS1gp6lFBZmollq/g21aUGVoWixAfBEsFxhWzPif1X2ZrjeXyIOEmCn25R1Dz",
-  "faqir.slate.css": "sha384-lSeSUhJCMUsQxM1oS2AbeqbfdLzquz4zYDYSF1N2bpA4JC0g/7fcJA/lWvkZugyq",
-  "faqir.soft.css": "sha384-G7xaO/Rr9RdMdBch66kUiS+atQOluVXhwIb039G7WJg6KvAxDBSbA/7v8y9ouhZH",
-  "faqir.sunset.css": "sha384-7FyjK1RJrkGTvOSFLH15WiRI1i8V3bbfpUuv4Gq3stG1NwC56/JkXOH4uPscY95b",
-  "faqir.swiss-document.css": "sha384-hQKtiQvaCu9ot5TJnCIlPjZhUJif5cacuE27IvJi1j99iF9HuNOvfGp+epSzJlMT",
-  "faqir.swiss.css": "sha384-Ki39mfAWeHD1KRjAB07b4MygOk5swzXSp5sUKcTWldXuiNhpNTWo+vOeponF4yfB",
-  "faqir.terminal.css": "sha384-EE2EAqi6sG4GTe8l+7w0p8gqCjZu8A+dkfNFCx90Ue/loSNUSnLIYDqdAsApyOOR",
+  "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-7yA/VdjGdg/6vwX+zUbughO6ERyV2rEsVyNYBO5ghqJbAhj9912F9qMPTkLc55B6",
+  "plugins/faqir-mask.js": "sha384-QvmZoq/+9/ef3U9JkdKlRMFhUMNGjnKct4JC3g7/ypEXEuTeny3JlUvsnrFv75v+",
   "plugins/faqir-persist.js": "sha384-o0jfddebC8QZ3S26VXUlOme723BNMlb/N7vqpn+fWpSeEFXzpq+3MoeXhVL/0PSv",
-  "plugins/faqir-rules.js": "sha384-xE90r5W3AlWKu+idcwx6NAkVUcRWMgM9ZJ1VgJLOguj/0GYP0jfflCojiCWt4FVq",
-  "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

@@ -76,6 +76,12 @@ export interface Magics {
    * expression is written on. Every magic that walks the DOM starts here.
    */
   readonly $el: Element;
+  /**
+   * The element the directive is written on — the `<input>` carrying `l-init`,
+   * the button carrying `@click`. The root in `l-data` and a root's `l-init`;
+   * the `<template>` in `l-for`'s list and `l-key` expressions. [1.1F-06]
+   */
+  readonly $this: Element;
   /** The scope's `l-ref` elements, keyed by name. */
   readonly $refs: Record<string, Element>;
   /** Every store registered with `Faqir.store()`. */
@@ -739,10 +745,12 @@ export interface DevtoolsComponent {
 /**
  * One recorded diagnostic. The production engine records none, so
  * `warnings()` is always `[]` there — every class exists only in
- * `faqir-core.dev.js`. `key` is a duplicate `l-key` in a keyed `l-for`.
+ * `faqir-core.dev.js`. `key` is a duplicate `l-key` in a keyed `l-for`;
+ * `style` is a `:style` that declares `display` beside `l-show`; `shadow` is
+ * an `l-for` loop variable that shadows a name its scope already has.
  */
 export interface DevtoolsWarning {
-  kind: "expression" | "directive" | "reorder" | "key" | "html" | "plugin";
+  kind: "expression" | "directive" | "reorder" | "key" | "html" | "style" | "shadow" | "plugin";
   message: string;
   /** The offending element, as a short label. */
   element: string | null;
@@ -787,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;
 
@@ -888,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.1",
+  "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",