@stigmer/theme 3.35.0 → 3.36.0

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigmer/theme",
-  "version": "3.35.0",
+  "version": "3.36.0",
   "description": "Design tokens, CSS custom properties, and utility functions for Stigmer UI components",
   "license": "Apache-2.0",
   "type": "module",

package/presets/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presets/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CiB,CAAC;AAE5C,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,CAY5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/presets/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CiB,CAAC;AAE5C,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,CAY5D"}

package/presets/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/presets/index.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,EAAE;QACb,WAAW,EAAE,iCAAiC;QAC9C,MAAM,EAAE,sBAAsB;KAC/B;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,sBAAsB;QACjC,WAAW,EAAE,gEAAgE;QAC7E,MAAM,EAAE,sBAAsB;KAC/B;IACD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,oBAAoB;QAC/B,WAAW,EAAE,8DAA8D;QAC3E,MAAM,EAAE,sBAAsB;KAC/B;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,qBAAqB;QAChC,WAAW,EAAE,0DAA0D;QACvE,MAAM,EAAE,qBAAqB;KAC9B;IACD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,oBAAoB;QAC/B,WAAW,EAAE,gEAAgE;QAC7E,MAAM,EAAE,sBAAsB;KAC/B;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE,uBAAuB;QAClC,WAAW,EAAE,6DAA6D;QAC1E,MAAM,EAAE,iBAAiB;KAC1B;CACwC,CAAC;AAK5C;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAiB;IAClD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CACV,oCAAoC,MAAM,CAAC,EAAE,CAAC,KAAK;gBACjD,cAAc,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5D,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,MAAM,CAAC,SAAS,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/presets/index.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,EAAE;QACb,WAAW,EAAE,iCAAiC;QAC9C,MAAM,EAAE,sBAAsB;KAC/B;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,sBAAsB;QACjC,WAAW,EAAE,gEAAgE;QAC7E,MAAM,EAAE,sBAAsB;KAC/B;IACD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,oBAAoB;QAC/B,WAAW,EAAE,8DAA8D;QAC3E,MAAM,EAAE,sBAAsB;KAC/B;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,qBAAqB;QAChC,WAAW,EAAE,0DAA0D;QACvE,MAAM,EAAE,qBAAqB;KAC9B;IACD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,oBAAoB;QAC/B,WAAW,EAAE,gEAAgE;QAC7E,MAAM,EAAE,sBAAsB;KAC/B;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE,uBAAuB;QAClC,WAAW,EAAE,6DAA6D;QAC1E,MAAM,EAAE,iBAAiB;KAC1B;CACwC,CAAC;AAK5C;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAiB;IAClD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CACV,oCAAoC,MAAM,CAAC,EAAE,CAAC,KAAK;gBACjD,cAAc,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5D,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,MAAM,CAAC,SAAS,CAAC;AAC1B,CAAC"}

package/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAG7C,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,SAAS,CAAC;AAqBrC;;;;;;;;GAQG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAG7C,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,SAAS,CAAC;AAqBrC;;;;;;;;GAQG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}

package/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,IAAI,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIrD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AAErC;;;;;;;;;GASG;AACH,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;IAC5C,0BAA0B,EAAE,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE,CAC5D,cAAc,CACZ,SAAS,CAAC,UAAU,CAAC,cAAc,CAAC;QAClC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC;QACxC,CAAC,CAAC,SAAS,CACd;CACJ,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,IAAI,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIrD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AAErC;;;;;;;;;GASG;AACH,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;IAC5C,0BAA0B,EAAE,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE,CAC5D,cAAc,CACZ,SAAS,CAAC,UAAU,CAAC,cAAc,CAAC;QAClC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC;QACxC,CAAC,CAAC,SAAS,CACd;CACJ,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/src/__tests__/cn-prefix-merge.test.ts

@@ -1,49 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { cn } from "../utils";
-
-/**
- * Pins the #454 override contract: the `stg:` utility prefix must be
- * TRANSPARENT for tailwind-merge conflict grouping, so a host's unprefixed
- * `className` utilities still displace the SDK's prefixed defaults. If these
- * pins fail, `cn("stg:p-2", hostClassName)` keeps both classes and the SDK's
- * higher cascade layer silently wins — the documented override channel
- * (DD-019) breaks without any visible error.
- */
-describe("cn: stg: prefix is transparent for conflict grouping", () => {
-  it("host unprefixed utility displaces the SDK's prefixed default", () => {
-    expect(cn("stg:p-2", "p-4")).toBe("p-4");
-  });
-
-  it("SDK-internal merges keep the prefixed spelling", () => {
-    expect(cn("stg:p-2", "stg:p-4")).toBe("stg:p-4");
-  });
-
-  it("non-conflicting utilities from both spellings all survive", () => {
-    expect(cn("stg:flex stg:gap-2", "p-4")).toBe("stg:flex stg:gap-2 p-4");
-  });
-
-  it("variant conflicts resolve across spellings", () => {
-    expect(cn("stg:hover:bg-red-500", "hover:bg-blue-500")).toBe(
-      "hover:bg-blue-500",
-    );
-  });
-
-  it("SDK prefixed utility displaces an earlier host utility", () => {
-    // SDK call sites put the host className LAST (cn(base, className)), but
-    // the grouping must be symmetric.
-    expect(cn("p-4", "stg:p-2")).toBe("stg:p-2");
-  });
-
-  it("non-Tailwind classes pass through untouched", () => {
-    expect(cn("stg:p-2", "custom-class")).toBe("stg:p-2 custom-class");
-    expect(cn("stgm-thread-item-enter", "stg:opacity-50")).toBe(
-      "stgm-thread-item-enter stg:opacity-50",
-    );
-  });
-
-  it("conditional falsy inputs are dropped (clsx semantics)", () => {
-    expect(cn("stg:flex", false, undefined, null, "stg:gap-2")).toBe(
-      "stg:flex stg:gap-2",
-    );
-  });
-});

package/src/contract/__tests__/color.test.ts

@@ -1,72 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { compositeOver, contrastRatio, isColorValue, lightnessDelta, parseColor } from "../color.js";
-
-describe("contrastRatio", () => {
-  it("computes the canonical black-on-white ratio", () => {
-    expect(contrastRatio("black", "white")).toBeCloseTo(21, 5);
-    expect(contrastRatio("white", "white")).toBeCloseTo(1, 5);
-  });
-
-  it("parses OKLCH token values", () => {
-    // Dark-mode foreground on background from tokens.css — a high-contrast pair.
-    const ratio = contrastRatio("oklch(0.985 0 0)", "oklch(0.145 0 0)");
-    expect(ratio).toBeGreaterThan(15);
-  });
-
-  it("composites a translucent foreground over the background first", () => {
-    // 50% white over black is a grey; contrast must be far below solid white's.
-    const solid = contrastRatio("white", "black");
-    const translucent = contrastRatio("rgb(255 255 255 / 50%)", "black");
-    expect(translucent).toBeLessThan(solid);
-    expect(translucent).toBeGreaterThan(1);
-  });
-
-  it("requires a backdrop for a translucent background", () => {
-    expect(() => contrastRatio("white", "oklch(1 0 0 / 14%)")).toThrow(/backdropValue/);
-    const ratio = contrastRatio("white", "oklch(1 0 0 / 14%)", "oklch(0.145 0 0)");
-    expect(ratio).toBeGreaterThan(1);
-  });
-});
-
-describe("compositeOver", () => {
-  it("returns the foreground unchanged when opaque", () => {
-    const fg = parseColor("rgb(10 20 30)");
-    expect(compositeOver(fg, parseColor("white"))).toBe(fg);
-  });
-
-  it("blends channels linearly by alpha in sRGB", () => {
-    const result = compositeOver(parseColor("rgb(255 255 255 / 50%)"), parseColor("black"));
-    expect(result.r).toBeCloseTo(0.5, 5);
-    expect(result.g).toBeCloseTo(0.5, 5);
-    expect(result.b).toBeCloseTo(0.5, 5);
-    expect(result.alpha).toBe(1);
-  });
-});
-
-describe("lightnessDelta", () => {
-  it("measures OKLCH lightness separation", () => {
-    expect(lightnessDelta("oklch(0.21 0 0)", "oklch(0.145 0 0)")).toBeCloseTo(0.065, 3);
-    expect(lightnessDelta("white", "white")).toBeCloseTo(0, 5);
-  });
-
-  it("composites a translucent fill over the surface first", () => {
-    // The default dark --stgm-input (20% white) over the popover surface:
-    // raw white would report a delta near 0.73; the painted fill is far
-    // dimmer but still clearly separated.
-    const delta = lightnessDelta("oklch(1 0 0 / 20%)", "oklch(0.269 0 0)");
-    expect(delta).toBeGreaterThan(0.045);
-    expect(delta).toBeLessThan(0.5);
-  });
-
-  it("rejects a translucent surface (nothing to composite onto)", () => {
-    expect(() => lightnessDelta("white", "oklch(1 0 0 / 14%)")).toThrow(/opaque surface/);
-  });
-});
-
-describe("isColorValue", () => {
-  it("distinguishes colors from other token values", () => {
-    expect(isColorValue("oklch(0.5 0.1 190)")).toBe(true);
-    expect(isColorValue("0.625rem")).toBe(false);
-    expect(isColorValue("var(--font-geist-sans, system-ui, sans-serif)")).toBe(false);
-  });
-});

package/src/contract/__tests__/contrast.test.ts

@@ -1,81 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { runContrastAudit, resultId } from "../audit.js";
-
-/**
- * The permanent contrast gate for the token contract (stigmer/stigmer#187).
- *
- * Every pair declared in `pairs.ts` must meet its threshold in every preset
- * × color mode, resolved through the real cascade. A regression here means
- * shipped chrome text or surfaces became unreadable in someone's theme.
- *
- * EXEMPTIONS is the explicit, reviewed list of accepted misses. Adding to
- * it is a design decision, not a fix — every entry needs a rationale, and
- * the exemption is pinned to a measured floor so an exempted pair can still
- * never silently get *worse*.
- */
-
-interface Exemption {
-  /** `resultId()` of the accepted miss. */
-  readonly id: string;
-  /** Why this miss is acceptable. */
-  readonly rationale: string;
-  /** The measured value at the time of exemption; regressions below fail. */
-  readonly measuredFloor: number;
-}
-
-const EXEMPTIONS: readonly Exemption[] = [];
-
-const exemptionById = new Map(EXEMPTIONS.map((e) => [e.id, e]));
-
-describe("token contract contrast audit", () => {
-  const { results, leaks } = runContrastAudit();
-
-  it("declared pairs resolve for every preset and mode", () => {
-    // 6 presets × 2 modes × (text+supporting+surface pairs); exact count is
-    // asserted loosely so adding a pair does not require touching this test.
-    expect(results.length).toBeGreaterThan(400);
-  });
-
-  it("no preset leaks a light-only token value into dark mode", () => {
-    const formatted = leaks.map(
-      (leak) => `${leak.preset}: ${leak.tokens.join(", ")}`,
-    );
-    expect(formatted, "preset tokens defined light-only override the default dark value (see resolve.ts)").toEqual([]);
-  });
-
-  const failures = results.filter(
-    (r) => r.enforced && !r.passes && !exemptionById.has(resultId(r)),
-  );
-
-  it("every non-exempt pair meets its threshold", () => {
-    const formatted = failures.map(
-      (r) =>
-        `${resultId(r)} — ${r.pair.kind} ${r.measured.toFixed(2)} < ${r.threshold} ` +
-        `(fg ${r.foregroundValue} on bg ${r.backgroundValue}; used by: ${r.pair.usage})`,
-    );
-    expect(formatted).toEqual([]);
-  });
-
-  it("exempted pairs never regress below their recorded floor", () => {
-    const regressions: string[] = [];
-    const staleExemptions: string[] = [];
-    for (const exemption of EXEMPTIONS) {
-      const result = results.find((r) => resultId(r) === exemption.id);
-      if (!result) {
-        staleExemptions.push(exemption.id);
-        continue;
-      }
-      if (result.passes) {
-        // The pair now meets the real threshold — the exemption must be
-        // removed so the full gate applies again.
-        staleExemptions.push(exemption.id);
-      } else if (result.measured < exemption.measuredFloor - 1e-6) {
-        regressions.push(
-          `${exemption.id}: ${result.measured.toFixed(3)} fell below exempted floor ${exemption.measuredFloor}`,
-        );
-      }
-    }
-    expect(regressions).toEqual([]);
-    expect(staleExemptions, "exemption no longer needed or references a removed pair — delete it").toEqual([]);
-  });
-});

package/src/contract/__tests__/parse.test.ts

@@ -1,106 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { parseThemeCss } from "../parse.js";
-
-describe("parseThemeCss", () => {
-  it("splits :root and dark-attribute blocks into light and dark maps", () => {
-    const css = `
-:root {
-  --stgm-background: oklch(0.98 0 0);
-  --stgm-foreground: oklch(0.145 0 0);
-}
-
-[data-stgm-color-mode="dark"] {
-  --stgm-background: oklch(0.145 0 0);
-}
-`;
-    const { light, dark } = parseThemeCss(css);
-    expect(light.get("--stgm-background")?.value).toBe("oklch(0.98 0 0)");
-    expect(light.get("--stgm-foreground")?.value).toBe("oklch(0.145 0 0)");
-    expect(dark.get("--stgm-background")?.value).toBe("oklch(0.145 0 0)");
-    expect(dark.has("--stgm-foreground")).toBe(false);
-  });
-
-  it("classifies the preset dual dark selector spanning multiple lines", () => {
-    const css = `
-.stgm-theme-x {
-  --stgm-primary: oklch(0.5 0.2 250);
-}
-
-[data-stgm-color-mode="dark"] .stgm-theme-x,
-.stgm-theme-x[data-stgm-color-mode="dark"] {
-  --stgm-primary: oklch(0.7 0.2 250);
-}
-`;
-    const { light, dark } = parseThemeCss(css);
-    expect(light.get("--stgm-primary")?.value).toBe("oklch(0.5 0.2 250)");
-    expect(dark.get("--stgm-primary")?.value).toBe("oklch(0.7 0.2 250)");
-  });
-
-  it("keeps values containing semicolons-free complex expressions intact", () => {
-    const css = `
-:root {
-  --stgm-shadow-sm: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
-  --stgm-font-sans: var(--font-geist-sans, system-ui, sans-serif);
-  --stgm-backdrop: oklch(0.98 0 0 / 80%);
-}
-`;
-    const { light } = parseThemeCss(css);
-    expect(light.get("--stgm-shadow-sm")?.value).toBe(
-      "0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1)",
-    );
-    expect(light.get("--stgm-font-sans")?.value).toBe(
-      "var(--font-geist-sans, system-ui, sans-serif)",
-    );
-    expect(light.get("--stgm-backdrop")?.value).toBe("oklch(0.98 0 0 / 80%)");
-  });
-
-  it("attaches @group headers and per-token descriptions", () => {
-    const css = `
-:root {
-  /* @group Core colors */
-  /* Page background behind all content. */
-  --stgm-background: oklch(0.98 0 0);
-  --stgm-foreground: oklch(0.145 0 0);
-
-  /* @group Shape */
-  --stgm-radius: 0.625rem;
-}
-`;
-    const { light } = parseThemeCss(css);
-    expect(light.get("--stgm-background")).toMatchObject({
-      group: "Core colors",
-      description: "Page background behind all content.",
-    });
-    // The description belongs only to the token directly beneath it.
-    expect(light.get("--stgm-foreground")).toMatchObject({ group: "Core colors" });
-    expect(light.get("--stgm-foreground")?.description).toBeUndefined();
-    expect(light.get("--stgm-radius")).toMatchObject({ group: "Shape" });
-  });
-
-  it("ignores multi-line file header comments", () => {
-    const css = `
-/* Corporate — Enterprise SaaS design language
-   Tight radius, corporate blue */
-
-.stgm-theme-corporate {
-  --stgm-radius: 0.375rem;
-}
-`;
-    const { light } = parseThemeCss(css);
-    expect(light.get("--stgm-radius")?.value).toBe("0.375rem");
-    expect(light.get("--stgm-radius")?.description).toBeUndefined();
-  });
-
-  it("ignores non-stgm declarations", () => {
-    const css = `
-:root {
-  --other-token: red;
-  color: blue;
-  --stgm-primary: oklch(0.5 0.1 190);
-}
-`;
-    const { light } = parseThemeCss(css);
-    expect(light.size).toBe(1);
-    expect(light.has("--stgm-primary")).toBe(true);
-  });
-});

package/src/contract/__tests__/resolve.test.ts

@@ -1,85 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { parseThemeCss } from "../parse.js";
-import { presetLightLeaksIntoDark, resolveTokens } from "../resolve.js";
-
-const DEFAULTS = parseThemeCss(`
-:root {
-  --stgm-background: light-default;
-  --stgm-foreground: light-default;
-  --stgm-primary: light-default;
-}
-[data-stgm-color-mode="dark"] {
-  --stgm-background: dark-default;
-  --stgm-primary: dark-default;
-}
-`);
-
-const PRESET = parseThemeCss(`
-.stgm-theme-x {
-  --stgm-background: light-preset;
-  --stgm-primary: light-preset;
-}
-[data-stgm-color-mode="dark"] .stgm-theme-x,
-.stgm-theme-x[data-stgm-color-mode="dark"] {
-  --stgm-background: dark-preset;
-}
-`);
-
-describe("resolveTokens", () => {
-  it("light mode without preset uses :root values", () => {
-    const resolved = resolveTokens(DEFAULTS, undefined, "light");
-    expect(resolved.get("--stgm-background")).toMatchObject({
-      value: "light-default",
-      source: "default-light",
-    });
-  });
-
-  it("dark mode without preset overlays the dark block, falling back to light", () => {
-    const resolved = resolveTokens(DEFAULTS, undefined, "dark");
-    expect(resolved.get("--stgm-background")?.value).toBe("dark-default");
-    // --stgm-foreground has no dark declaration: inherits the light value.
-    expect(resolved.get("--stgm-foreground")).toMatchObject({
-      value: "light-default",
-      source: "default-light",
-    });
-  });
-
-  it("light mode with preset prefers preset-light over defaults", () => {
-    const resolved = resolveTokens(DEFAULTS, PRESET, "light");
-    expect(resolved.get("--stgm-background")?.value).toBe("light-preset");
-    expect(resolved.get("--stgm-foreground")?.value).toBe("light-default");
-  });
-
-  it("dark mode with preset resolves preset-dark ?? preset-light ?? default-dark ?? default-light", () => {
-    const resolved = resolveTokens(DEFAULTS, PRESET, "dark");
-    // Defined in the preset dark block: preset-dark wins.
-    expect(resolved.get("--stgm-background")).toMatchObject({
-      value: "dark-preset",
-      source: "preset-dark",
-    });
-    // Defined in preset light only: the preset-light value leaks into dark
-    // (higher cascade priority than the default dark block).
-    expect(resolved.get("--stgm-primary")).toMatchObject({
-      value: "light-preset",
-      source: "preset-light",
-    });
-    // Untouched by the preset: default dark... which doesn't exist for
-    // foreground, so default light.
-    expect(resolved.get("--stgm-foreground")?.value).toBe("light-default");
-  });
-});
-
-describe("presetLightLeaksIntoDark", () => {
-  it("flags tokens the preset defines light-only while defaults have a dark value", () => {
-    expect(presetLightLeaksIntoDark(DEFAULTS, PRESET)).toEqual(["--stgm-primary"]);
-  });
-
-  it("does not flag tokens with no default dark value (nothing to leak over)", () => {
-    const preset = parseThemeCss(`
-.stgm-theme-y {
-  --stgm-foreground: light-preset;
-}
-`);
-    expect(presetLightLeaksIntoDark(DEFAULTS, preset)).toEqual([]);
-  });
-});