sparkdesign 0.4.6 → 0.4.7

package/registry/tokens/ontology.json

@@ -0,0 +1,404 @@
+{
+  "schemaVersion": "0.1.0",
+  "library": "sparkdesign",
+  "purpose": "Machine-readable design token ontology for AI agents choosing semantic styling without reading CSS internals first.",
+  "axes": {
+    "theme": {
+      "attribute": "data-theme",
+      "intent": "Controls color palette independently from layout density or geometry.",
+      "knownValues": [
+        "light",
+        "dark",
+        "light-parchment",
+        "dark-parchment"
+      ],
+      "rules": [
+        "Do not infer layout density from data-theme.",
+        "Custom themes should define --token-color-* values and rely on theme-base.css mappings.",
+        "Components should consume --color-* semantic tokens rather than raw --token-color-* internals."
+      ]
+    },
+    "style": {
+      "attribute": "data-style",
+      "intent": "Controls spacing, radius, and typography rhythm independently from color.",
+      "knownValues": [
+        "neutral",
+        "compact",
+        "soft",
+        "sharp",
+        "dense"
+      ],
+      "rules": [
+        "Use neutral when no product density preference is known.",
+        "Use compact for efficiency-oriented workspaces that need tighter controls without becoming spreadsheet-dense.",
+        "Use dense for data-heavy UI where text-sm, line-height, spacing, and radius all need compression.",
+        "Use soft for airy, approachable, reading-friendly surfaces with larger radius and more breathing room.",
+        "Use sharp when square geometry and mono-like precision are a deliberate product direction."
+      ]
+    }
+  },
+  "families": {
+    "color.primary": {
+      "tokens": [
+        "--color-primary",
+        "--color-primary-hover",
+        "--color-primary-active",
+        "--color-primary-bg",
+        "--color-primary-bg-hover",
+        "--color-primary-border",
+        "--color-primary-border-hover",
+        "--color-primary-text",
+        "--color-primary-text-hover",
+        "--color-primary-text-active",
+        "--color-text-on-primary"
+      ],
+      "intent": "Brand and primary action emphasis.",
+      "useFor": [
+        "Primary action buttons",
+        "Selected controls",
+        "Active navigation accents",
+        "Focused brand emphasis"
+      ],
+      "avoidFor": [
+        "Large page backgrounds",
+        "Destructive actions",
+        "Neutral metadata",
+        "Multiple competing actions in the same group"
+      ],
+      "agentRules": [
+        "Use only one primary action per decision surface.",
+        "Use --color-text-on-primary for text placed directly on --color-primary."
+      ]
+    },
+    "color.text": {
+      "tokens": [
+        "--color-text",
+        "--color-text-secondary",
+        "--color-text-tertiary",
+        "--color-text-quaternary",
+        "--color-text-base"
+      ],
+      "intent": "Readable hierarchy for foreground content.",
+      "useFor": [
+        "Body copy",
+        "Headings",
+        "Metadata",
+        "Disabled-looking low-emphasis support text"
+      ],
+      "avoidFor": [
+        "Status semantics that need success, warning, error, or info color",
+        "Decorative accents"
+      ],
+      "agentRules": [
+        "Use --color-text for primary readable content.",
+        "Use secondary and tertiary text only after hierarchy is established."
+      ]
+    },
+    "color.background": {
+      "tokens": [
+        "--color-bg-base",
+        "--color-bg-container",
+        "--color-bg-elevated",
+        "--color-bg-layout",
+        "--color-bg-spotlight",
+        "--color-bg-mask",
+        "--color-bg-highlight",
+        "--color-bg-highlight-hover"
+      ],
+      "intent": "Page, container, elevation, overlay, and spotlight surfaces.",
+      "useFor": [
+        "Application background",
+        "Cards and panels",
+        "Popover and modal surfaces",
+        "Overlay masks",
+        "Temporary highlight surfaces"
+      ],
+      "avoidFor": [
+        "Text foreground",
+        "Status messages without semantic color",
+        "Arbitrary decorative blocks"
+      ],
+      "agentRules": [
+        "Use --color-bg-layout for app-level backgrounds.",
+        "Use --color-bg-container or --color-bg-base for content surfaces.",
+        "Use --color-bg-mask only for modal, drawer, dialog, and popover overlays."
+      ]
+    },
+    "color.border": {
+      "tokens": [
+        "--color-border",
+        "--color-border-secondary",
+        "--color-border-tertiary",
+        "--color-input",
+        "--color-ring"
+      ],
+      "intent": "Separation, input affordance, and keyboard focus indication.",
+      "useFor": [
+        "Card and panel boundaries",
+        "Dividers",
+        "Input borders",
+        "Focus rings"
+      ],
+      "avoidFor": [
+        "Primary semantic emphasis",
+        "Replacing spacing as the only separator"
+      ],
+      "agentRules": [
+        "Use --color-ring for focus indication.",
+        "Prefer border-secondary or border-tertiary for low-emphasis separators."
+      ]
+    },
+    "color.fill": {
+      "tokens": [
+        "--color-fill",
+        "--color-fill-secondary",
+        "--color-fill-tertiary",
+        "--color-fill-quaternary",
+        "--color-fill-disable",
+        "--color-accent",
+        "--color-muted"
+      ],
+      "intent": "Subtle non-surface fills for controls, hover areas, muted chips, and disabled states.",
+      "useFor": [
+        "Hover backgrounds",
+        "Secondary controls",
+        "Muted chips",
+        "Disabled fill areas"
+      ],
+      "avoidFor": [
+        "Primary page background",
+        "High-risk status feedback",
+        "Readable foreground text"
+      ],
+      "agentRules": [
+        "Use fill tokens to support interaction affordance without adding new brand colors.",
+        "Use --color-fill-disable only when disabled semantics are explicit."
+      ]
+    },
+    "color.semantic": {
+      "tokens": [
+        "--color-link",
+        "--color-error",
+        "--color-error-hover",
+        "--color-error-bg",
+        "--color-error-bg-hover",
+        "--color-error-border",
+        "--color-info",
+        "--color-info-hover",
+        "--color-info-bg",
+        "--color-info-bg-hover",
+        "--color-info-border",
+        "--color-success",
+        "--color-success-hover",
+        "--color-success-bg",
+        "--color-success-bg-hover",
+        "--color-success-border",
+        "--color-warning",
+        "--color-warning-hover",
+        "--color-warning-bg",
+        "--color-warning-bg-hover",
+        "--color-warning-border"
+      ],
+      "intent": "Meaningful status communication.",
+      "useFor": [
+        "Validation errors",
+        "Warnings",
+        "Success confirmations",
+        "Informational callouts",
+        "Links"
+      ],
+      "avoidFor": [
+        "Pure decoration",
+        "Brand emphasis",
+        "Dense rainbow categorization without labels"
+      ],
+      "agentRules": [
+        "Do not rely on color alone; pair semantic color with text or icon labels.",
+        "Use background and border companions for Alert-like surfaces."
+      ]
+    },
+    "color.accent": {
+      "tokens": [
+        "--color-pink",
+        "--color-pink-bg",
+        "--color-pink-bg-hover",
+        "--color-purple",
+        "--color-purple-bg",
+        "--color-purple-bg-hover",
+        "--color-yellow",
+        "--color-yellow-bg",
+        "--color-yellow-bg-hover",
+        "--color-orange",
+        "--color-orange-bg",
+        "--color-orange-bg-hover",
+        "--color-teal",
+        "--color-teal-bg",
+        "--color-teal-bg-hover",
+        "--color-blue",
+        "--color-blue-bg",
+        "--color-blue-bg-hover",
+        "--color-mauve",
+        "--color-mauve-bg",
+        "--color-mauve-bg-hover",
+        "--color-slate",
+        "--color-slate-bg",
+        "--color-slate-bg-hover",
+        "--color-lavender",
+        "--color-lavender-bg",
+        "--color-lavender-bg-hover",
+        "--color-sage",
+        "--color-sage-bg",
+        "--color-sage-bg-hover"
+      ],
+      "intent": "Categorical accents for tags, files, generated artifacts, or non-status grouping.",
+      "useFor": [
+        "Category tags",
+        "File type accents",
+        "Non-critical visual grouping",
+        "Generated artifact previews"
+      ],
+      "avoidFor": [
+        "Primary actions",
+        "Error, warning, success, or info status",
+        "Long-form text"
+      ],
+      "agentRules": [
+        "Use accents sparingly and label categories explicitly.",
+        "Do not invent new accent colors in generated UI."
+      ]
+    },
+    "spacing": {
+      "tokens": [
+        "--spacing-0",
+        "--spacing-px",
+        "--spacing-0.5",
+        "--spacing-1",
+        "--spacing-1.5",
+        "--spacing-2",
+        "--spacing-2.5",
+        "--spacing-3",
+        "--spacing-3.5",
+        "--spacing-4",
+        "--spacing-5",
+        "--spacing-6",
+        "--spacing-8",
+        "--spacing-10",
+        "--spacing-12",
+        "--spacing-16",
+        "--spacing-20",
+        "--spacing-24"
+      ],
+      "intent": "Rhythm and density controlled by data-style.",
+      "useFor": [
+        "Component padding",
+        "Stack gaps",
+        "Grid gutters",
+        "Inline icon-label spacing"
+      ],
+      "avoidFor": [
+        "One-off pixel nudges",
+        "Encoding visual hierarchy only through whitespace",
+        "Breaking sibling rhythm without a reason"
+      ],
+      "agentRules": [
+        "Prefer existing Tailwind spacing utilities mapped to Spark tokens.",
+        "Use larger spacing for section rhythm and smaller spacing for control internals."
+      ]
+    },
+    "radius": {
+      "tokens": [
+        "--radius-none",
+        "--radius-sm",
+        "--radius-md",
+        "--radius-lg",
+        "--radius-xl",
+        "--radius-2xl",
+        "--radius-3xl",
+        "--radius-full"
+      ],
+      "intent": "Geometry and softness controlled by data-style.",
+      "useFor": [
+        "Buttons",
+        "Cards",
+        "Inputs",
+        "Pills",
+        "Panels"
+      ],
+      "avoidFor": [
+        "Mixing unrelated radii in a single component",
+        "Using full radius for large rectangular panels",
+        "Overriding sharp or dense styles with arbitrary rounded values"
+      ],
+      "agentRules": [
+        "Let data-style drive geometry unless a component has a documented exception.",
+        "Use --radius-full only for pills, avatars, and circular controls."
+      ]
+    },
+    "typography": {
+      "tokens": [
+        "--font-size-xs",
+        "--font-size-sm",
+        "--font-size-base",
+        "--font-size-lg",
+        "--font-size-xl",
+        "--font-size-2xl",
+        "--font-size-3xl",
+        "--font-size-4xl",
+        "--font-size-5xl",
+        "--font-size-6xl",
+        "--font-size-7xl",
+        "--font-size-8xl",
+        "--font-size-9xl"
+      ],
+      "intent": "Readable type hierarchy controlled by data-style.",
+      "useFor": [
+        "Body text",
+        "Labels",
+        "Section headings",
+        "Display headings"
+      ],
+      "avoidFor": [
+        "Decorative scale jumps without information hierarchy",
+        "Tiny text for required content",
+        "Long paragraphs above base size without layout reason"
+      ],
+      "agentRules": [
+        "Use base or sm for dense application text.",
+        "Use larger sizes to express hierarchy, not decoration."
+      ]
+    },
+    "motion": {
+      "tokens": [
+        "--motion-duration-fast",
+        "--motion-duration-base",
+        "--motion-duration-slow",
+        "--motion-ease-standard",
+        "--motion-ease-emphasized",
+        "--motion-ease-out"
+      ],
+      "intent": "Purposeful feedback and state transition timing.",
+      "useFor": [
+        "Hover and press feedback",
+        "Disclosure transitions",
+        "Modal and popover entry/exit",
+        "Streaming or generation state changes"
+      ],
+      "avoidFor": [
+        "Purely decorative delay",
+        "Animating large layout shifts without user benefit",
+        "Long-running loops that distract from task work"
+      ],
+      "agentRules": [
+        "Use fast durations for control feedback.",
+        "Use base or slow only for surface transitions that clarify spatial change."
+      ]
+    }
+  },
+  "forbiddenPatterns": [
+    "Hard-coded hex colors in component className or style props.",
+    "Raw rgba overlays when --color-bg-mask or a semantic token exists.",
+    "Arbitrary radius values that fight data-style.",
+    "One-off spacing values that break sibling rhythm.",
+    "Using accent colors to communicate status without labels."
+  ]
+}

package/dist/_basePickBy-DnQN8w3y.js

@@ -1,151 +0,0 @@
-import { e as x, c as O, g as m, k as P, h as p, j as w, l as A, m as c, n as I, t as N, o as E } from "./_baseUniq-B-N2NQ50.js";
-import { aR as g, aA as F, aS as M, aT as T, aU as _, aV as l, aW as $, aX as B, aY as S, aZ as y } from "./mermaid.core-gFR0XUlD.js";
-var R = /\s/;
-function G(n) {
-  for (var r = n.length; r-- && R.test(n.charAt(r)); )
-    ;
-  return r;
-}
-var H = /^\s+/;
-function L(n) {
-  return n && n.slice(0, G(n) + 1).replace(H, "");
-}
-var o = NaN, W = /^[-+]0x[0-9a-f]+$/i, X = /^0b[01]+$/i, Y = /^0o[0-7]+$/i, q = parseInt;
-function z(n) {
-  if (typeof n == "number")
-    return n;
-  if (x(n))
-    return o;
-  if (g(n)) {
-    var r = typeof n.valueOf == "function" ? n.valueOf() : n;
-    n = g(r) ? r + "" : r;
-  }
-  if (typeof n != "string")
-    return n === 0 ? n : +n;
-  n = L(n);
-  var t = X.test(n);
-  return t || Y.test(n) ? q(n.slice(2), t ? 2 : 8) : W.test(n) ? o : +n;
-}
-var v = 1 / 0, C = 17976931348623157e292;
-function K(n) {
-  if (!n)
-    return n === 0 ? n : 0;
-  if (n = z(n), n === v || n === -v) {
-    var r = n < 0 ? -1 : 1;
-    return r * C;
-  }
-  return n === n ? n : 0;
-}
-function U(n) {
-  var r = K(n), t = r % 1;
-  return r === r ? t ? r - t : r : 0;
-}
-function fn(n) {
-  var r = n == null ? 0 : n.length;
-  return r ? O(n) : [];
-}
-var b = Object.prototype, Z = b.hasOwnProperty, dn = F(function(n, r) {
-  n = Object(n);
-  var t = -1, i = r.length, a = i > 2 ? r[2] : void 0;
-  for (a && M(r[0], r[1], a) && (i = 1); ++t < i; )
-    for (var f = r[t], e = T(f), s = -1, d = e.length; ++s < d; ) {
-      var u = e[s], h = n[u];
-      (h === void 0 || _(h, b[u]) && !Z.call(n, u)) && (n[u] = f[u]);
-    }
-  return n;
-});
-function un(n) {
-  var r = n == null ? 0 : n.length;
-  return r ? n[r - 1] : void 0;
-}
-function D(n) {
-  return function(r, t, i) {
-    var a = Object(r);
-    if (!l(r)) {
-      var f = m(t);
-      r = P(r), t = function(s) {
-        return f(a[s], s, a);
-      };
-    }
-    var e = n(r, t, i);
-    return e > -1 ? a[f ? r[e] : e] : void 0;
-  };
-}
-var J = Math.max;
-function Q(n, r, t) {
-  var i = n == null ? 0 : n.length;
-  if (!i)
-    return -1;
-  var a = t == null ? 0 : U(t);
-  return a < 0 && (a = J(i + a, 0)), p(n, m(r), a);
-}
-var hn = D(Q);
-function V(n, r) {
-  var t = -1, i = l(n) ? Array(n.length) : [];
-  return w(n, function(a, f, e) {
-    i[++t] = r(a, f, e);
-  }), i;
-}
-function gn(n, r) {
-  var t = $(n) ? A : V;
-  return t(n, m(r));
-}
-var j = Object.prototype, k = j.hasOwnProperty;
-function nn(n, r) {
-  return n != null && k.call(n, r);
-}
-function mn(n, r) {
-  return n != null && c(n, r, nn);
-}
-function rn(n, r) {
-  return n < r;
-}
-function tn(n, r, t) {
-  for (var i = -1, a = n.length; ++i < a; ) {
-    var f = n[i], e = r(f);
-    if (e != null && (s === void 0 ? e === e && !x(e) : t(e, s)))
-      var s = e, d = f;
-  }
-  return d;
-}
-function on(n) {
-  return n && n.length ? tn(n, B, rn) : void 0;
-}
-function an(n, r, t, i) {
-  if (!g(n))
-    return n;
-  r = I(r, n);
-  for (var a = -1, f = r.length, e = f - 1, s = n; s != null && ++a < f; ) {
-    var d = N(r[a]), u = t;
-    if (d === "__proto__" || d === "constructor" || d === "prototype")
-      return n;
-    if (a != e) {
-      var h = s[d];
-      u = void 0, u === void 0 && (u = g(h) ? h : S(r[a + 1]) ? [] : {});
-    }
-    y(s, d, u), s = s[d];
-  }
-  return n;
-}
-function vn(n, r, t) {
-  for (var i = -1, a = r.length, f = {}; ++i < a; ) {
-    var e = r[i], s = E(n, e);
-    t(s, e) && an(f, I(e, n), s);
-  }
-  return f;
-}
-export {
-  rn as a,
-  tn as b,
-  V as c,
-  vn as d,
-  on as e,
-  fn as f,
-  hn as g,
-  mn as h,
-  dn as i,
-  U as j,
-  un as l,
-  gn as m,
-  K as t
-};

package/dist/_basePickBy-a-kPMlkg.cjs

@@ -1 +0,0 @@
-"use strict";const u=require("./_baseUniq-Cc_zbSif.cjs"),d=require("./mermaid.core-DBwAx_jp.cjs");var P=/\s/;function p(n){for(var r=n.length;r--&&P.test(n.charAt(r)););return r}var w=/^\s+/;function A(n){return n&&n.slice(0,p(n)+1).replace(w,"")}var m=NaN,_=/^[-+]0x[0-9a-f]+$/i,y=/^0b[01]+$/i,E=/^0o[0-7]+$/i,F=parseInt;function M(n){if(typeof n=="number")return n;if(u.isSymbol(n))return m;if(d.isObject(n)){var r=typeof n.valueOf=="function"?n.valueOf():n;n=d.isObject(r)?r+"":r}if(typeof n!="string")return n===0?n:+n;n=A(n);var t=y.test(n);return t||E.test(n)?F(n.slice(2),t?2:8):_.test(n)?m:+n}var I=1/0,N=17976931348623157e292;function o(n){if(!n)return n===0?n:0;if(n=M(n),n===I||n===-I){var r=n<0?-1:1;return r*N}return n===n?n:0}function v(n){var r=o(n),t=r%1;return r===r?t?r-t:r:0}function B(n){var r=n==null?0:n.length;return r?u.baseFlatten(n):[]}var x=Object.prototype,$=x.hasOwnProperty,q=d.baseRest(function(n,r){n=Object(n);var t=-1,a=r.length,e=a>2?r[2]:void 0;for(e&&d.isIterateeCall(r[0],r[1],e)&&(a=1);++t<a;)for(var s=r[t],i=d.keysIn(s),f=-1,h=i.length;++f<h;){var b=i[f],g=n[b];(g===void 0||d.eq(g,x[b])&&!$.call(n,b))&&(n[b]=s[b])}return n});function L(n){var r=n==null?0:n.length;return r?n[r-1]:void 0}function S(n){return function(r,t,a){var e=Object(r);if(!d.isArrayLike(r)){var s=u.baseIteratee(t);r=u.keys(r),t=function(f){return s(e[f],f,e)}}var i=n(r,t,a);return i>-1?e[s?r[i]:i]:void 0}}var T=Math.max;function G(n,r,t){var a=n==null?0:n.length;if(!a)return-1;var e=t==null?0:v(t);return e<0&&(e=T(a+e,0)),u.baseFindIndex(n,u.baseIteratee(r),e)}var H=S(G);function l(n,r){var t=-1,a=d.isArrayLike(n)?Array(n.length):[];return u.baseEach(n,function(e,s,i){a[++t]=r(e,s,i)}),a}function R(n,r){var t=d.isArray(n)?u.arrayMap:l;return t(n,u.baseIteratee(r))}var z=Object.prototype,C=z.hasOwnProperty;function K(n,r){return n!=null&&C.call(n,r)}function U(n,r){return n!=null&&u.hasPath(n,r,K)}function O(n,r){return n<r}function c(n,r,t){for(var a=-1,e=n.length;++a<e;){var s=n[a],i=r(s);if(i!=null&&(f===void 0?i===i&&!u.isSymbol(i):t(i,f)))var f=i,h=s}return h}function W(n){return n&&n.length?c(n,d.identity,O):void 0}function X(n,r,t,a){if(!d.isObject(n))return n;r=u.castPath(r,n);for(var e=-1,s=r.length,i=s-1,f=n;f!=null&&++e<s;){var h=u.toKey(r[e]),b=t;if(h==="__proto__"||h==="constructor"||h==="prototype")return n;if(e!=i){var g=f[h];b=void 0,b===void 0&&(b=d.isObject(g)?g:d.isIndex(r[e+1])?[]:{})}d.assignValue(f,h,b),f=f[h]}return n}function Y(n,r,t){for(var a=-1,e=r.length,s={};++a<e;){var i=r[a],f=u.baseGet(n,i);t(f,i)&&X(s,u.castPath(i,n),f)}return s}exports.baseExtremum=c;exports.baseLt=O;exports.baseMap=l;exports.basePickBy=Y;exports.defaults=q;exports.find=H;exports.flatten=B;exports.has=U;exports.last=L;exports.map=R;exports.min=W;exports.toFinite=o;exports.toInteger=v;