@xtyle/core 0.5.0 → 0.6.0

package/README.md

@@ -66,6 +66,7 @@ apply(register, { persistKey: "theme" });
 ```sh
 xtyle derive --bg "#0f1115" --accent "#5b8cff" --format css
 xtyle coverage --consumed "--bg-0,--fg-0,--accent" --bg "#0f1115"
+xtyle audit -a xtyle-default --level AA
 xtyle gauntlet --runs 200
 ```
 
@@ -198,7 +199,8 @@ Author your own with `defineXtyleAlgorithm` / `defineAlgorithm` from `@xtyle/cor
 engine the CLI hands a human. Point an MCP client at `xtyle mcp` (or `npx -y @xtyle/core xtyle
 mcp`).
 
-- **Tools**: `xtyle_derive`, `xtyle_coverage`, `xtyle_components` (list every component or
+- **Tools**: `xtyle_derive`, `xtyle_coverage`, `xtyle_audit` (grade a register's contrast
+  against the canonical WCAG text/fill pairs), `xtyle_components` (list every component or
   describe one's full manifest), `xtyle_gauntlet`, `xtyle_list_algorithms`, and
   `xtyle_server_info`; each runs the same code as its CLI counterpart, so the two can't drift.
 - **Resources**: `xtyle://concept/{id}` for the concept docs and `xtyle://component/{id}` for

package/dist/audit.d.ts

@@ -30,6 +30,11 @@ export interface ContrastAuditOptions {
     largeText?: boolean;
     /** The floor a pair must clear to count toward `passes` / `tallies.pass` (default `"AA"`). */
     level?: "AA" | "AAA";
+    /** Audit this consumer-supplied pair set instead of xtyle's canonical pairs. A consumer whose token
+     * contract differs (its status inks read on `--bg-0`, not each tone's soft tint) passes its own pairs
+     * so the audit grades what it actually renders, not xtyle's default surfaces. Reach for
+     * {@link canonicalContrastPairs} to start from xtyle's list and extend it. Omit to audit the canonical set. */
+    pairs?: readonly PairSpec[];
 }
 export interface ContrastAuditTallies {
     total: number;
@@ -48,5 +53,26 @@ export interface ContrastAudit {
     /** The lowest ratio across all audited pairs, the theme's weakest link (`0` when nothing was audited). */
     worst: number;
 }
+/** A text/fill token pair to grade for contrast: `fg` is the text token, `bg` the surface it sits on. */
+export interface PairSpec {
+    fg: TokenName;
+    bg: TokenName;
+    /** A human label for the pair in the audit result; defaults to `"<fg> on <bg>"`. */
+    label?: string;
+}
+/** xtyle's canonical text/fill pairs, each token audited against its *intended* surface rather than a
+ * naive fg×bg cross that cries wolf. This mirrors the token contract xtyle-default's own invariants
+ * enforce: the primary ink on the page base; the neutral / brand inks readable on the base *and* on
+ * both panel surfaces (so "does secondary text read on a card?" is a real check, not a false green);
+ * the placeholder on the field surface; each tone's on-fill text (`-fg` on the solid fill); the accent
+ * ramp's readable inks on the base; and the status readable inks on their soft tint. */
+/**
+ * xtyle's canonical text/fill pairs as data. Exported so a consumer can read the token contract
+ * directly — extend it with `opts.pairs`, or (for a QuickJS/xript sandbox that can't `import` from
+ * `@xtyle/core`) inline this small list and pair it with the equally-pure `contrast()` to run the
+ * same grade the frontend runs. That's the sandbox-reachable path: the audit is a pure function of a
+ * register plus this pair list, so the two surfaces agree by sharing the data, not the import.
+ */
+export declare function canonicalContrastPairs(): PairSpec[];
 export declare function auditRegister(register: TokenRegister, opts?: ContrastAuditOptions): ContrastAudit;
 //# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3D;;;;;;;;GAQG;AAEH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IAClC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,EAAE,EAAE,SAAS,CAAC;IACd,iDAAiD;IACjD,EAAE,EAAE,SAAS,CAAC;IACd,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,EAAE,YAAY,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACpC,2GAA2G;IAC3G,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,IAAI,GAAG,KAAK,CAAC;IACpB,0GAA0G;IAC1G,KAAK,EAAE,MAAM,CAAC;CACd;AAyCD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,GAAE,oBAAyB,GAAG,aAAa,CA6BrG"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3D;;;;;;;;GAQG;AAEH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IAClC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,EAAE,EAAE,SAAS,CAAC;IACd,iDAAiD;IACjD,EAAE,EAAE,SAAS,CAAC;IACd,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,EAAE,YAAY,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACpC,2GAA2G;IAC3G,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IACrB;;;mHAG+G;IAC/G,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,IAAI,GAAG,KAAK,CAAC;IACpB,0GAA0G;IAC1G,KAAK,EAAE,MAAM,CAAC;CACd;AAED,yGAAyG;AACzG,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,SAAS,CAAC;IACd,EAAE,EAAE,SAAS,CAAC;IACd,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAYD;;;;;wFAKwF;AACxF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,QAAQ,EAAE,CAQnD;AAUD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,GAAE,oBAAyB,GAAG,aAAa,CA6BrG"}

package/dist/audit.js

@@ -15,7 +15,14 @@ const TINT_TEXT_TONES = ["success", "warn", "danger", "info"];
  * both panel surfaces (so "does secondary text read on a card?" is a real check, not a false green);
  * the placeholder on the field surface; each tone's on-fill text (`-fg` on the solid fill); the accent
  * ramp's readable inks on the base; and the status readable inks on their soft tint. */
-function canonicalPairs() {
+/**
+ * xtyle's canonical text/fill pairs as data. Exported so a consumer can read the token contract
+ * directly — extend it with `opts.pairs`, or (for a QuickJS/xript sandbox that can't `import` from
+ * `@xtyle/core`) inline this small list and pair it with the equally-pure `contrast()` to run the
+ * same grade the frontend runs. That's the sandbox-reachable path: the audit is a pure function of a
+ * register plus this pair list, so the two surfaces agree by sharing the data, not the import.
+ */
+export function canonicalContrastPairs() {
     const pairs = [{ fg: "--fg-0", bg: "--bg-0" }];
     for (const ink of SURFACE_INKS)
         for (const surface of READING_SURFACES)
@@ -43,13 +50,13 @@ export function auditRegister(register, opts = {}) {
     const level = opts.level ?? "AA";
     const clears = (tier) => (level === "AAA" ? tier === "AAA" : tier !== "fail");
     const entries = [];
-    for (const { fg, bg } of canonicalPairs()) {
+    for (const { fg, bg, label } of opts.pairs ?? canonicalContrastPairs()) {
         const fgValue = register[fg];
         const bgValue = register[bg];
         if (fgValue == null || bgValue == null)
             continue;
         const ratio = Math.round(contrast(fgValue, bgValue) * 100) / 100;
-        entries.push({ pair: `${fg} on ${bg}`, fg, bg, fgValue, bgValue, ratio, tier: tierFor(ratio, largeText) });
+        entries.push({ pair: label ?? `${fg} on ${bg}`, fg, bg, fgValue, bgValue, ratio, tier: tierFor(ratio, largeText) });
     }
     const tallies = { total: entries.length, AAA: 0, AA: 0, fail: 0, pass: 0 };
     let worst = Infinity;

package/dist/audit.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"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"}

package/dist/css/components/alert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../../src/css/components/alert.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,QAAQ,QAkFb,CAAC"}
+{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../../src/css/components/alert.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,QAAQ,QA6Fb,CAAC"}

package/dist/css/components/alert.js

@@ -15,6 +15,7 @@ const solidRules = TONES.map((t) => `.xtyle-alert--solid.xtyle-alert--${t} {
 export const alertCss = `
 .xtyle-alert {
 	display: flex;
+	align-items: center;
 	gap: var(--space-3);
 	font-family: var(--font-sans);
 	font-size: var(--text-body);
@@ -23,6 +24,17 @@ export const alertCss = `
 	border-radius: var(--radius-md);
 	padding: var(--space-3) var(--space-4);
 }
+/* The fragment always emits the title/actions wrappers; they're only real when filled. A filled
+   title or actions stacks content, so the icon aligns to the first line; a message-only alert
+   centers the icon against its (possibly wrapped) text, and the empty wrappers collapse. */
+.xtyle-alert:has(.xtyle-alert__title:not(:empty)),
+.xtyle-alert:has(.xtyle-alert__actions:not(:empty)) {
+	align-items: flex-start;
+}
+.xtyle-alert__title:empty,
+.xtyle-alert__actions:empty {
+	display: none;
+}
 ${softRules}
 ${solidRules}
 .xtyle-alert__icon {
@@ -36,7 +48,6 @@ ${solidRules}
 	margin-top: var(--space-0);
 }
 .xtyle-alert--noicon .xtyle-alert__icon { display: none; }
-:host(:has([slot="icon"])) .xtyle-alert__icon { display: inline-flex; }
 .xtyle-alert__body {
 	display: flex;
 	flex-direction: column;

package/dist/css/components/alert.js.map

@@ -1 +1 @@
-{"version":3,"file":"alert.js","sourceRoot":"","sources":["../../../src/css/components/alert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,mCAAmC,CAAC;qBACvB,CAAC;gBACN,CAAC;uBACM,CAAC;;kCAEU,CAAC,sCAAsC,CAAC,MAAM,CAC/E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,oCAAoC,CAAC;qBACxB,CAAC;gBACN,CAAC;;;mCAGkB,CAAC,uCAAuC,CAAC;mCACzC,CAAC,sCAAsC,CAAC,SAAS,CACnF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;EAWtB,SAAS;EACT,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsEX,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"alert.js","sourceRoot":"","sources":["../../../src/css/components/alert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,mCAAmC,CAAC;qBACvB,CAAC;gBACN,CAAC;uBACM,CAAC;;kCAEU,CAAC,sCAAsC,CAAC,MAAM,CAC/E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,oCAAoC,CAAC;qBACxB,CAAC;gBACN,CAAC;;;mCAGkB,CAAC,uCAAuC,CAAC;mCACzC,CAAC,sCAAsC,CAAC,SAAS,CACnF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;EAuBtB,SAAS;EACT,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqEX,CAAC,IAAI,EAAE,CAAC"}

package/dist/css/components/app-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../src/css/components/app-shell.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,QA+IhB,CAAC"}
+{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../src/css/components/app-shell.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,QAsJhB,CAAC"}

package/dist/css/components/app-shell.js

@@ -24,6 +24,13 @@ export const appShellCss = `
 .xtyle-app__rail {
 	min-width: 0;
 }
+/* A dock's host element carries a standalone default width (14/18/22rem by size); in a rail it must
+   fill the shell-sized track instead, or its edge border overhangs the rail and bleeds into main. */
+.xtyle-app .xtyle-app__rail xtyle-dock,
+.xtyle-app .xtyle-app__rail xtyle-dock-zone {
+	width: 100%;
+	box-sizing: border-box;
+}
 .xtyle-app__rail--left {
 	grid-column: 1;
 }

package/dist/css/components/app-shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.js","sourceRoot":"","sources":["../../../src/css/components/app-shell.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+I1B,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"app-shell.js","sourceRoot":"","sources":["../../../src/css/components/app-shell.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsJ1B,CAAC,IAAI,EAAE,CAAC"}

package/dist/css/components/badge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../../src/css/components/badge.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,QAAQ,QA+Ib,CAAC"}
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../../src/css/components/badge.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,QAAQ,QAgLb,CAAC"}

package/dist/css/components/badge.js

@@ -129,12 +129,15 @@ ${toneOutline}
 	height: 0.75em;
 }
 .xtyle-dot {
+	--dot-color: var(--neutral);
+	--dot-pulse-duration: 1.4s;
+	position: relative;
 	display: inline-block;
 	width: var(--space-2);
 	height: var(--space-2);
 	flex: none;
 	border-radius: var(--radius-full);
-	background: var(--neutral);
+	background: var(--dot-color);
 }
 .xtyle-dot--sm {
 	width: var(--space-1);
@@ -144,18 +147,48 @@ ${toneOutline}
 	width: var(--space-3);
 	height: var(--space-3);
 }
-${TONES.map((t) => `.xtyle-dot--${t} { background: var(--${t}); }`).join("\n")}
+${TONES.map((t) => `.xtyle-dot--${t} { --dot-color: var(--${t}); }`).join("\n")}
 .xtyle-dot--pulse-slow {
-	animation: xtyle-badge-pulse 1.8s var(--ease-standard) infinite;
+	--dot-pulse-duration: 1.8s;
+	animation: xtyle-badge-pulse var(--dot-pulse-duration) var(--ease-standard) infinite;
 }
 .xtyle-dot--pulse-fast {
-	animation: xtyle-badge-pulse 0.9s var(--ease-standard) infinite;
+	--dot-pulse-duration: 0.9s;
+	animation: xtyle-badge-pulse var(--dot-pulse-duration) var(--ease-standard) infinite;
+}
+.xtyle-dot--glow {
+	box-shadow:
+		0 0 0 var(--border-thin) color-mix(in oklch, var(--dot-color) 35%, transparent),
+		0 0 var(--space-2) 0 var(--dot-color);
+}
+.xtyle-dot--ping::after {
+	content: "";
+	position: absolute;
+	inset: 0;
+	border-radius: inherit;
+	background: var(--dot-color);
+	animation: xtyle-dot-ping var(--dot-pulse-duration) var(--ease-standard) infinite;
+}
+@keyframes xtyle-dot-ping {
+	0% {
+		transform: scale(1);
+		opacity: 0.55;
+	}
+	80%,
+	100% {
+		transform: scale(2.6);
+		opacity: 0;
+	}
 }
 @media (prefers-reduced-motion: reduce) {
 	.xtyle-dot--pulse-slow,
 	.xtyle-dot--pulse-fast {
 		animation: none;
 	}
+	.xtyle-dot--ping::after {
+		animation: none;
+		opacity: 0;
+	}
 }
 `.trim();
 //# sourceMappingURL=badge.js.map

package/dist/css/components/badge.js.map

@@ -1 +1 @@
-{"version":3,"file":"badge.js","sourceRoot":"","sources":["../../../src/css/components/badge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,oCAAoC,CAAC;qBACxB,CAAC;gBACN,CAAC;;EAEf,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CACzB,CAAC,CAAC,EAAE,EAAE,CAAC,mCAAmC,CAAC;qBACvB,CAAC;gBACN,CAAC;;EAEf,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,sCAAsC,CAAC;;gBAE/B,CAAC;uBACM,CAAC;EACtB,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BtB,SAAS;EACT,QAAQ;EACR,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqGX,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;CAa7E,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"badge.js","sourceRoot":"","sources":["../../../src/css/components/badge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,oCAAoC,CAAC;qBACxB,CAAC;gBACN,CAAC;;EAEf,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CACzB,CAAC,CAAC,EAAE,EAAE,CAAC,mCAAmC,CAAC;qBACvB,CAAC;gBACN,CAAC;;EAEf,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,sCAAsC,CAAC;;gBAE/B,CAAC;uBACM,CAAC;EACtB,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BtB,SAAS;EACT,QAAQ;EACR,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwGX,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C9E,CAAC,IAAI,EAAE,CAAC"}

package/dist/css/components/button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../src/css/components/button.ts"],"names":[],"mappings":"AAwCA,eAAO,MAAM,SAAS,QA2Id,CAAC"}
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../src/css/components/button.ts"],"names":[],"mappings":"AAwCA,eAAO,MAAM,SAAS,QA8Id,CAAC"}

package/dist/css/components/button.js

@@ -161,5 +161,8 @@ ${linkRules}
 }
 .xtyle-button:disabled::after,
 .xtyle-button[aria-disabled="true"]::after { background: transparent; }
+@media (prefers-reduced-motion: reduce) {
+	.xtyle-button__spinner { animation: none; }
+}
 `.trim();
 //# sourceMappingURL=button.js.map

package/dist/css/components/button.js.map

@@ -1 +1 @@
-{"version":3,"file":"button.js","sourceRoot":"","sources":["../../../src/css/components/button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,sCAAsC,CAAC;qBAC1B,CAAC;gBACN,CAAC;;EAEf,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,wCAAwC,CAAC;;gBAEjC,CAAC;uBACM,CAAC;EACtB,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,sCAAsC,CAAC;;gBAE/B,CAAC;;EAEf,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,uCAAuC,CAAC;qBAC3B,CAAC;gBACN,CAAC;;EAEf,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,qCAAqC,CAAC;gBAC9B,CAAC;EACf,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDvB,UAAU;EACV,YAAY;EACZ,UAAU;EACV,WAAW;EACX,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFV,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"button.js","sourceRoot":"","sources":["../../../src/css/components/button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,sCAAsC,CAAC;qBAC1B,CAAC;gBACN,CAAC;;EAEf,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,wCAAwC,CAAC;;gBAEjC,CAAC;uBACM,CAAC;EACtB,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,sCAAsC,CAAC;;gBAE/B,CAAC;;EAEf,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,uCAAuC,CAAC;qBAC3B,CAAC;gBACN,CAAC;;EAEf,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,qCAAqC,CAAC;gBAC9B,CAAC;EACf,CACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDvB,UAAU;EACV,YAAY;EACZ,UAAU;EACV,WAAW;EACX,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyFV,CAAC,IAAI,EAAE,CAAC"}

package/dist/css/components/card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../src/css/components/card.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO,QAiFZ,CAAC"}
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../src/css/components/card.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO,QA0FZ,CAAC"}

package/dist/css/components/card.js

@@ -12,10 +12,15 @@ export const cardCss = `
 	background: var(--bg-1);
 	border: var(--border-thin) solid var(--line);
 	border-radius: var(--radius-lg);
-	box-shadow: var(--elevation-2);
+	box-shadow: var(--card-shadow, var(--elevation-1));
 	padding: var(--space-5);
 	gap: var(--space-4);
 }
+/* depthStrength: how far the surface lifts. The default (no class) is the eased md; sm is a
+   whisper, lg keeps the heavier legacy elevation. An interactive card bumps one step on hover. */
+.xtyle-card--depth-sm { --card-shadow: var(--elevation-0); --card-shadow-hover: var(--elevation-1); }
+.xtyle-card--depth-md { --card-shadow: var(--elevation-1); --card-shadow-hover: var(--elevation-2); }
+.xtyle-card--depth-lg { --card-shadow: var(--elevation-2); --card-shadow-hover: var(--elevation-3); }
 .xtyle-card--overlay {
 	background: var(--surface-overlay);
 	border-color: var(--surface-overlay-border);
@@ -38,6 +43,10 @@ export const cardCss = `
 	border-top: var(--border-thin) solid var(--line);
 	color: var(--fg-2);
 }
+.xtyle-card__header:empty,
+.xtyle-card__footer:empty {
+	display: none;
+}
 .xtyle-card--interactive {
 	position: relative;
 	isolation: isolate;
@@ -69,7 +78,7 @@ export const cardCss = `
 }
 ${cardToneVars}
 .xtyle-card--interactive:hover {
-	box-shadow: var(--elevation-4);
+	box-shadow: var(--card-shadow-hover, var(--elevation-2));
 	border-color: var(--line-2);
 	transform: translateY(calc(-1 * var(--space-1)));
 }

package/dist/css/components/card.js.map

@@ -1 +1 @@
-{"version":3,"file":"card.js","sourceRoot":"","sources":["../../../src/css/components/card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAExG,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmErB,YAAY;;;;;;;;;;;;;;CAcb,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../../../src/css/components/card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAExG,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4ErB,YAAY;;;;;;;;;;;;;;CAcb,CAAC,IAAI,EAAE,CAAC"}

package/dist/css/components/carousel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"carousel.d.ts","sourceRoot":"","sources":["../../../src/css/components/carousel.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,QAyEhB,CAAC"}
+{"version":3,"file":"carousel.d.ts","sourceRoot":"","sources":["../../../src/css/components/carousel.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,QA8EhB,CAAC"}

package/dist/css/components/carousel.js

@@ -60,7 +60,9 @@ xtyle-carousel[data-enhanced] .xtyle-carousel__controls { display: flex; }
 	border-radius: var(--radius-full);
 	background: var(--bg-3);
 	cursor: pointer;
-	transition: background var(--duration-fast) var(--ease-standard);
+	transition:
+		background var(--duration-fast) var(--ease-standard),
+		width var(--duration-fast) var(--ease-standard);
 }
 .xtyle-carousel__dot:hover { background: var(--fg-2); }
 .xtyle-carousel__dot.is-active { background: var(--accent); }
@@ -68,6 +70,9 @@ xtyle-carousel[data-enhanced] .xtyle-carousel__controls { display: flex; }
 	outline: var(--border-thin) solid var(--ring);
 	outline-offset: 2px;
 }
+@container style(--selection-cue: marker) {
+	.xtyle-carousel__dot.is-active { width: 1.4rem; }
+}
 @media (prefers-reduced-motion: reduce) {
 	.xtyle-carousel__track { scroll-behavior: auto; }
 }

package/dist/css/components/carousel.js.map

@@ -1 +1 @@
-{"version":3,"file":"carousel.js","sourceRoot":"","sources":["../../../src/css/components/carousel.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyE1B,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"carousel.js","sourceRoot":"","sources":["../../../src/css/components/carousel.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8E1B,CAAC,IAAI,EAAE,CAAC"}

package/dist/css/components/code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../src/css/components/code.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,QAqIZ,CAAC"}
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../src/css/components/code.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,QAwJZ,CAAC"}

package/dist/css/components/code.js

@@ -11,7 +11,17 @@ export const codeCss = `
 	line-height: var(--leading-normal);
 	tab-size: 2;
 }
-:host([wrap]) .xtyle-code {
+/* A block wide enough to scroll horizontally is made tabbable (see the element); an outline sits
+   outside the border box, so the scrolled code can't cover it. */
+.xtyle-code:focus-visible {
+	outline: var(--border-thick) solid var(--ring);
+	outline-offset: 2px;
+}
+/* Unlike the rest of the set (which keys state off .xtyle-x--variant classes), code drives state off
+   host attributes, so each state needs both a shadow (:host) and a light-DOM (xtyle-code) selector:
+   :host only matches a shadow host, and the element renders light DOM over Astro SSR. */
+:host([wrap]) .xtyle-code,
+xtyle-code[wrap] .xtyle-code {
 	white-space: pre-wrap;
 	overflow-wrap: anywhere;
 }
@@ -21,17 +31,24 @@ export const codeCss = `
 	background: none;
 }
 .xtyle-code-line { display: block; }
-:host([highlight]) .xtyle-code code { display: block; width: max-content; min-width: 100%; }
-:host([highlight][wrap]) .xtyle-code code { width: auto; }
+:host([highlight]) .xtyle-code code,
+xtyle-code[highlight] .xtyle-code code { display: block; width: max-content; min-width: 100%; }
+:host([highlight][wrap]) .xtyle-code code,
+xtyle-code[highlight][wrap] .xtyle-code code { width: auto; }
 .xtyle-code-line[data-line-highlight] { background: var(--code-line-highlight); }
-:host([line-numbers]) { --xtyle-code-gutter: 2.5ch; }
-:host([line-numbers]) .xtyle-code { padding-left: 0; }
-:host([line-numbers]) .xtyle-code code { display: block; counter-reset: xtyle-code-line; }
-:host([line-numbers]) .xtyle-code-line {
+:host([line-numbers]),
+xtyle-code[line-numbers] { --xtyle-code-gutter: 2.5ch; }
+:host([line-numbers]) .xtyle-code,
+xtyle-code[line-numbers] .xtyle-code { padding-left: 0; }
+:host([line-numbers]) .xtyle-code code,
+xtyle-code[line-numbers] .xtyle-code code { display: block; counter-reset: xtyle-code-line; }
+:host([line-numbers]) .xtyle-code-line,
+xtyle-code[line-numbers] .xtyle-code-line {
 	display: flex;
 	counter-increment: xtyle-code-line;
 }
-:host([line-numbers]) .xtyle-code-line::before {
+:host([line-numbers]) .xtyle-code-line::before,
+xtyle-code[line-numbers] .xtyle-code-line::before {
 	content: counter(xtyle-code-line);
 	position: sticky;
 	left: 0;
@@ -46,7 +63,8 @@ export const codeCss = `
 	user-select: none;
 	-webkit-user-select: none;
 }
-:host([line-numbers]) .xtyle-code-line__text {
+:host([line-numbers]) .xtyle-code-line__text,
+xtyle-code[line-numbers] .xtyle-code-line__text {
 	flex: 1 1 auto;
 	min-width: 0;
 }
@@ -91,6 +109,7 @@ export const codeCss = `
 		border-color var(--duration-fast) var(--ease-standard);
 }
 :host(:hover) .xtyle-code-copy,
+xtyle-code:hover .xtyle-code-copy,
 .xtyle-code-copy:focus-visible { opacity: 1; }
 .xtyle-code-copy:hover { color: var(--neutral-fg); background: var(--neutral); }
 .xtyle-code-copy[data-copied] {

package/dist/css/components/code.js.map

@@ -1 +1 @@
-{"version":3,"file":"code.js","sourceRoot":"","sources":["../../../src/css/components/code.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqItB,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"code.js","sourceRoot":"","sources":["../../../src/css/components/code.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwJtB,CAAC,IAAI,EAAE,CAAC"}

package/dist/css/components/empty.d.ts

@@ -0,0 +1,2 @@
+export declare const emptyCss: string;
+//# sourceMappingURL=empty.d.ts.map

package/dist/css/components/empty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.d.ts","sourceRoot":"","sources":["../../../src/css/components/empty.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,QAmCb,CAAC"}

package/dist/css/components/empty.js

@@ -0,0 +1,37 @@
+export const emptyCss = `
+.xtyle-empty {
+	display: flex;
+	flex-direction: column;
+	align-items: center;
+	text-align: center;
+	gap: var(--space-3);
+	padding: var(--space-8) var(--space-4);
+	font-family: var(--font-sans);
+}
+.xtyle-empty__media,
+.xtyle-empty > xtyle-icon {
+	font-size: var(--text-4xl);
+	line-height: 1;
+	color: var(--fg-3);
+}
+.xtyle-empty :is(h1, h2, h3, h4, h5, h6, .xtyle-empty__title) {
+	margin: 0;
+	font-size: var(--text-lg);
+	font-weight: var(--weight-semibold);
+	color: var(--fg-0);
+}
+.xtyle-empty :is(p, .xtyle-empty__text) {
+	margin: 0;
+	max-width: 34ch;
+	font-size: var(--text-sm);
+	color: var(--fg-2);
+}
+.xtyle-empty__actions {
+	display: flex;
+	flex-wrap: wrap;
+	justify-content: center;
+	gap: var(--space-2);
+	margin-top: var(--space-2);
+}
+`.trim();
+//# sourceMappingURL=empty.js.map

package/dist/css/components/empty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.js","sourceRoot":"","sources":["../../../src/css/components/empty.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCvB,CAAC,IAAI,EAAE,CAAC"}

package/dist/css/components/image.d.ts

@@ -1,2 +1,13 @@
+/**
+ * The lightbox variant of `<xtyle-dialog>`. The shared lightbox controller (`elements/lightbox.ts`)
+ * mounts an `<xtyle-dialog class="xtyle-lightbox">` on `document.body` and slots the image into the
+ * body and the caption into the footer; the dialog supplies the close button, scrim, focus trap,
+ * Escape, backdrop-click-to-close, and its own body-portal. These rules re-skin that dialog into an
+ * immersive viewer through the `.xtyle-lightbox` host class and `::part`-adjacent slot styling — the
+ * same override surface any app can use — so the lightbox is no longer a closed, hand-rolled box.
+ * They live in the shared component sheet the dialog's shadow adopts, so `:host()` and `::slotted()`
+ * resolve inside it; composed into `imageCss` below so the coverage lint still sees every token.
+ */
+export declare const imageLightboxCss: string;
 export declare const imageCss: string;
 //# sourceMappingURL=image.d.ts.map

package/dist/css/components/image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../src/css/components/image.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,QAoHb,CAAC"}
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../src/css/components/image.ts"],"names":[],"mappings":"AAqHA;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,QA2DrB,CAAC;AAET,eAAO,MAAM,QAAQ,QAAiD,CAAC"}