@lyeve-labs/ui-kit 0.41.0 → 0.42.0

package/README.md

@@ -70,7 +70,7 @@ ThemeToggle, Toaster (plus the `toast` service)
 - **Svelte 5.0** or newer
 - **Tailwind CSS v4** with the `@tailwindcss/vite` plugin
 - **`@lucide/svelte`** 0.511 or newer, below 2.0
-- **Node 20** or newer
+- **Node 24** or newer
 
 ## Install
 
@@ -385,6 +385,9 @@ const JOB_TONE: Record<JobState, StatusTone> = {
 
 ## Local development
 
+The kit is developed on Node 26 and installs with pnpm only. Applications that
+consume it need Node 24 or newer and may use any package manager.
+
 ```bash
 pnpm install            # install dependencies
 pnpm test               # run unit tests

package/dist/components/PluginCart.svelte

@@ -69,6 +69,21 @@
     actions?: Snippet<[{ skus: string[]; total: number | null }]>;
     /** Anything the host wants between the total and the actions. */
     notice?: Snippet;
+    /**
+     * The host's own summary, drawn in place of everything inside the aside:
+     * the title line, `error`, the list, the ladder, the total, `notice` and
+     * `actions`. For a host that prices more than the selection, such as a
+     * plan change or a discount code. The aside keeps its id, its stickiness
+     * and the bar that jumps to it on a narrow screen. `remove` takes one
+     * selected capability out and reports it through `onchange`, as unticking
+     * its card does. A capability that is not selected is left alone. `total`
+     * is null both while a price is in flight and before one is asked for, so
+     * a host that tells the two apart tracks its own request, as it does for
+     * `quoting`.
+     */
+    summary?: Snippet<[{ skus: string[]; total: number | null; remove: (sku: string) => void }]>;
+    /** The panel's name: the aside's accessible name, also printed atop the default summary. */
+    heading?: string;
     /**
      * How far below the top of the window the summary sticks on a wide
      * screen, as a CSS length. A page with a sticky header passes its height,
@@ -111,6 +126,8 @@
     onchange,
     actions,
     notice,
+    summary,
+    heading = 'Your selection',
     stickyTop = '1rem',
     class: klass = '',
   }: Props = $props();
@@ -349,129 +366,141 @@
     id={summaryId}
     class="scroll-mt-20 self-start rounded-xl border border-line bg-surface p-5 lg:sticky"
     style:top={stickyTop}
-    aria-label="Your selection"
+    aria-label={heading}
   >
-    <div class="mb-4 flex items-center justify-between gap-2">
-      <p class="text-xs font-semibold uppercase tracking-widest text-faint">Your selection</p>
-      {#if count > 0}
-        <Badge tone="brand" size="sm">
-          {count}
-          {count === 1 ? 'capability' : 'capabilities'}
-        </Badge>
-      {/if}
-    </div>
+    {#if summary}
+      {@render summary({
+        skus: [...selected],
+        total,
+        remove: (sku) => {
+          if (selected.has(sku)) toggle(sku);
+        },
+      })}
+    {:else}
+      <div class="mb-4 flex items-center justify-between gap-2">
+        <p class="text-xs font-semibold uppercase tracking-widest text-faint">{heading}</p>
+        {#if count > 0}
+          <Badge tone="brand" size="sm">
+            {count}
+            {count === 1 ? 'capability' : 'capabilities'}
+          </Badge>
+        {/if}
+      </div>
 
-    {#if error}
-      <p class="mb-3 rounded-lg border border-danger/30 bg-danger/10 p-3 text-xs text-danger">
-        {error}
-      </p>
-    {/if}
+      {#if error}
+        <p class="mb-3 rounded-lg border border-danger/30 bg-danger/10 p-3 text-xs text-danger">
+          {error}
+        </p>
+      {/if}
 
-    {#if count === 0}
-      <p class="py-6 text-center text-sm text-muted">
-        Nothing picked yet. With none of these you are on the free tier, which needs no checkout.
-      </p>
-    {:else}
-      <ul class="mb-4 max-h-56 space-y-1 overflow-y-auto pe-1">
-        {#each [...selected] as sku (sku)}
-          {@const p = bySku.get(sku)}
-          <li class="flex items-center justify-between gap-2 text-xs">
-            <span class="truncate text-fg">{p?.name ?? sku}</span>
-            <span class="flex items-center gap-1">
-              <span class="font-mono text-muted">{formatCents(p?.price_cents ?? 0, currency)}</span>
-              <Button
-                type="button"
-                variant="ghost"
-                size="sm"
-                onclick={() => toggle(sku)}
-                aria-label={`Take ${p?.name ?? sku} out of your selection`}
-              >
-                <X size={12} />
-              </Button>
-            </span>
-          </li>
-        {/each}
-      </ul>
+      {#if count === 0}
+        <p class="py-6 text-center text-sm text-muted">
+          Nothing picked yet. With none of these you are on the free tier, which needs no checkout.
+        </p>
+      {:else}
+        <ul class="mb-4 max-h-56 space-y-1 overflow-y-auto pe-1">
+          {#each [...selected] as sku (sku)}
+            {@const p = bySku.get(sku)}
+            <li class="flex items-center justify-between gap-2 text-xs">
+              <span class="truncate text-fg">{p?.name ?? sku}</span>
+              <span class="flex items-center gap-1">
+                <span class="font-mono text-muted"
+                  >{formatCents(p?.price_cents ?? 0, currency)}</span
+                >
+                <Button
+                  type="button"
+                  variant="ghost"
+                  size="sm"
+                  onclick={() => toggle(sku)}
+                  aria-label={`Take ${p?.name ?? sku} out of your selection`}
+                >
+                  <X size={12} />
+                </Button>
+              </span>
+            </li>
+          {/each}
+        </ul>
 
-      {#if rungs.length > 0}
-        <!-- The ladder as a meter, so "two more" is something a reader can
+        {#if rungs.length > 0}
+          <!-- The ladder as a meter, so "two more" is something a reader can
              see the distance to. -->
-        <div class="mb-3" aria-hidden="true">
-          <div class="relative h-1.5 rounded-full bg-surface-2">
-            <span
-              class="absolute inset-y-0 start-0 rounded-full bg-brand transition-[width] duration-progress"
-              style:width="{ladderFill}%"
-            ></span>
-            {#each rungs as r (r.plugins)}
+          <div class="mb-3" aria-hidden="true">
+            <div class="relative h-1.5 rounded-full bg-surface-2">
               <span
-                class={cn(
-                  'absolute top-1/2 size-2.5 -translate-x-1/2 -translate-y-1/2 rounded-full border-2 transition-colors',
-                  ladder.count >= r.plugins
-                    ? 'border-brand bg-brand'
-                    : 'border-line-strong bg-surface',
-                )}
-                style:left="{(r.plugins / ladderTop) * 100}%"
+                class="absolute inset-y-0 start-0 rounded-full bg-brand transition-[width] duration-progress"
+                style:width="{ladderFill}%"
               ></span>
-            {/each}
-          </div>
-          <div class="relative mt-2 h-4 text-[10px] text-muted">
-            {#each rungs as r (r.plugins)}
-              <span
-                class="absolute -translate-x-1/2 whitespace-nowrap font-mono"
-                style:left="{Math.min((r.plugins / ladderTop) * 100, 92)}%"
-              >
-                {r.plugins}+ · {r.discount_pct}%
-              </span>
-            {/each}
+              {#each rungs as r (r.plugins)}
+                <span
+                  class={cn(
+                    'absolute top-1/2 size-2.5 -translate-x-1/2 -translate-y-1/2 rounded-full border-2 transition-colors',
+                    ladder.count >= r.plugins
+                      ? 'border-brand bg-brand'
+                      : 'border-line-strong bg-surface',
+                  )}
+                  style:left="{(r.plugins / ladderTop) * 100}%"
+                ></span>
+              {/each}
+            </div>
+            <div class="relative mt-2 h-4 text-[10px] text-muted">
+              {#each rungs as r (r.plugins)}
+                <span
+                  class="absolute -translate-x-1/2 whitespace-nowrap font-mono"
+                  style:left="{Math.min((r.plugins / ladderTop) * 100, 92)}%"
+                >
+                  {r.plugins}+ · {r.discount_pct}%
+                </span>
+              {/each}
+            </div>
           </div>
-        </div>
-      {/if}
-
-      {#if ladder.reachedPct > 0}
-        <p class="mb-2 text-xs text-success">
-          Volume discount {ladder.reachedPct}% applied.
-        </p>
-      {/if}
-      {#if ladder.next}
-        <p class="mb-3 text-xs text-muted">
-          {ladder.next.more} more and the discount is {ladder.next.discount_pct}%.
-        </p>
-      {/if}
+        {/if}
 
-      <div class="mb-4 border-t border-line pt-3">
-        {#if total === null}
-          <p class="flex items-center gap-2 text-sm text-muted">
-            {#if quoting}
-              <Spinner size={14} />
-              Pricing your selection
-            {:else}
-              Waiting for a price.
-            {/if}
+        {#if ladder.reachedPct > 0}
+          <p class="mb-2 text-xs text-success">
+            Volume discount {ladder.reachedPct}% applied.
           </p>
-        {:else}
-          <p class="flex items-baseline justify-between gap-2">
-            <span class="text-sm text-muted">Total</span>
-            <span class="font-mono text-xl font-semibold text-fg">
-              {formatCents(total, currency)}<span class="text-sm font-normal text-muted"
-                >{perLabel}</span
-              >
-            </span>
+        {/if}
+        {#if ladder.next}
+          <p class="mb-3 text-xs text-muted">
+            {ladder.next.more} more and the discount is {ladder.next.discount_pct}%.
           </p>
-          {#if quoted && quoted.volume_discount_cents > 0}
-            <p class="mt-1 text-end text-xs text-muted">
-              {formatCents(quoted.volume_discount_cents, currency)} off the list price.
+        {/if}
+
+        <div class="mb-4 border-t border-line pt-3">
+          {#if total === null}
+            <p class="flex items-center gap-2 text-sm text-muted">
+              {#if quoting}
+                <Spinner size={14} />
+                Pricing your selection
+              {:else}
+                Waiting for a price.
+              {/if}
             </p>
-          {/if}
-          {#if quoted && quoted.community_discount_cents > 0}
-            <p class="mt-1 text-end text-xs text-success">
-              Community discount {quoted.community_discount_pct}% applied.
+          {:else}
+            <p class="flex items-baseline justify-between gap-2">
+              <span class="text-sm text-muted">Total</span>
+              <span class="font-mono text-xl font-semibold text-fg">
+                {formatCents(total, currency)}<span class="text-sm font-normal text-muted"
+                  >{perLabel}</span
+                >
+              </span>
             </p>
+            {#if quoted && quoted.volume_discount_cents > 0}
+              <p class="mt-1 text-end text-xs text-muted">
+                {formatCents(quoted.volume_discount_cents, currency)} off the list price.
+              </p>
+            {/if}
+            {#if quoted && quoted.community_discount_cents > 0}
+              <p class="mt-1 text-end text-xs text-success">
+                Community discount {quoted.community_discount_pct}% applied.
+              </p>
+            {/if}
           {/if}
-        {/if}
-      </div>
-    {/if}
+        </div>
+      {/if}
 
-    {#if notice}{@render notice()}{/if}
-    {#if actions}{@render actions({ skus: [...selected], total })}{/if}
+      {#if notice}{@render notice()}{/if}
+      {#if actions}{@render actions({ skus: [...selected], total })}{/if}
+    {/if}
   </aside>
 </div>

package/dist/components/PluginCart.svelte.d.ts

@@ -38,6 +38,25 @@ interface Props {
     }]>;
     /** Anything the host wants between the total and the actions. */
     notice?: Snippet;
+    /**
+     * The host's own summary, drawn in place of everything inside the aside:
+     * the title line, `error`, the list, the ladder, the total, `notice` and
+     * `actions`. For a host that prices more than the selection, such as a
+     * plan change or a discount code. The aside keeps its id, its stickiness
+     * and the bar that jumps to it on a narrow screen. `remove` takes one
+     * selected capability out and reports it through `onchange`, as unticking
+     * its card does. A capability that is not selected is left alone. `total`
+     * is null both while a price is in flight and before one is asked for, so
+     * a host that tells the two apart tracks its own request, as it does for
+     * `quoting`.
+     */
+    summary?: Snippet<[{
+        skus: string[];
+        total: number | null;
+        remove: (sku: string) => void;
+    }]>;
+    /** The panel's name: the aside's accessible name, also printed atop the default summary. */
+    heading?: string;
     /**
      * How far below the top of the window the summary sticks on a wide
      * screen, as a CSS length. A page with a sticky header passes its height,

package/dist/index.d.ts

@@ -107,4 +107,4 @@ export { cn, type ClassValue } from './utils/cn.js';
 export { getTheme, getThemePreference, nextThemePreference, resolveTheme, setTheme, setThemePreference, systemTheme, themeBootScript, watchThemePreference, toggleTheme, watchSystemTheme, THEME_PREFERENCES, type Theme, type ThemePreference, } from './utils/theme.js';
 export * as motion from './motion.js';
 export type { Rung as MotionRung, Curve as MotionCurve } from './motion.js';
-export declare const VERSION = "0.41.0";
+export declare const VERSION = "0.42.0";

package/dist/index.js

@@ -119,4 +119,4 @@ export * as motion from './motion.js';
 // ── Version ────────────────────────────────────────────────────────────────
 // Generated from package.json by `pnpm version:sync`. Bump package.json, never
 // this line. The build and the test suite fail when the two disagree.
-export const VERSION = '0.41.0';
+export const VERSION = '0.42.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lyeve-labs/ui-kit",
-  "version": "0.41.0",
+  "version": "0.42.0",
   "description": "A clean, accessible, palette-aware Svelte 5 component library. The design system behind LyEve.",
   "license": "MIT",
   "author": "LyEve Labs <hello@lyeve.com>",
@@ -58,18 +58,19 @@
     "@lucide/svelte": "^0.511.0",
     "@playwright/experimental-ct-svelte": "1.58.2",
     "@sveltejs/package": "^2.5.7",
-    "@sveltejs/vite-plugin-svelte": "^4.0.4",
+    "@sveltejs/vite-plugin-svelte": "^5.1.1",
     "@testing-library/svelte": "^5.3.1",
-    "@vitest/coverage-v8": "^2.1.9",
+    "@vitest/coverage-v8": "^4.1.12",
     "jsdom": "^25.0.1",
     "prettier": "^3.8.3",
     "prettier-plugin-svelte": "^4.0.1",
     "prettier-plugin-tailwindcss": "^0.8.0",
     "publint": "^0.2.12",
-    "svelte": "^5.55.9",
+    "svelte": "^5.57.2",
     "svelte-check": "^4.4.8",
     "typescript": "^5.9.3",
-    "vitest": "^2.1.9"
+    "vite": "^6.4.5",
+    "vitest": "^4.1.12"
   },
   "scripts": {
     "build": "pnpm version:check && svelte-package && publint && node scripts/check-dist.mjs",