@usefidel/design-system 0.26.0 → 0.27.0

package/dist/index.js

@@ -2299,13 +2299,17 @@ var AppLayout = Object.assign(AppLayoutRoot, { Panel: AppLayoutPanel });
 
 // src/components/PageHeader/PageHeader.tsx
 import { jsx as jsx47, jsxs as jsxs38 } from "react/jsx-runtime";
-function PageHeader({ title, description, breadcrumb, actions, className, children, ...rest }) {
+function PageHeader({ title, description, leading, meta, breadcrumb, actions, className, children, ...rest }) {
   return /* @__PURE__ */ jsxs38("header", { className: ["fds-page-header", className].filter(Boolean).join(" "), ...rest, children: [
+    breadcrumb != null && /* @__PURE__ */ jsx47("div", { className: "fds-page-header__breadcrumb", children: breadcrumb }),
     /* @__PURE__ */ jsxs38("div", { className: "fds-page-header__row", children: [
-      /* @__PURE__ */ jsxs38("div", { className: "fds-page-header__text", children: [
-        breadcrumb != null && /* @__PURE__ */ jsx47("div", { className: "fds-page-header__breadcrumb", children: breadcrumb }),
-        /* @__PURE__ */ jsx47("h1", { className: "fds-page-header__title", children: title }),
-        description != null && /* @__PURE__ */ jsx47("p", { className: "fds-page-header__description", children: description })
+      /* @__PURE__ */ jsxs38("div", { className: "fds-page-header__lead", children: [
+        leading != null && /* @__PURE__ */ jsx47("div", { className: "fds-page-header__leading", children: leading }),
+        /* @__PURE__ */ jsxs38("div", { className: "fds-page-header__text", children: [
+          /* @__PURE__ */ jsx47("h1", { className: "fds-page-header__title", children: title }),
+          description != null && /* @__PURE__ */ jsx47("p", { className: "fds-page-header__description", children: description }),
+          meta != null && /* @__PURE__ */ jsx47("div", { className: "fds-page-header__meta", children: meta })
+        ] })
       ] }),
       actions != null && /* @__PURE__ */ jsx47("div", { className: "fds-page-header__actions", children: actions })
     ] }),
@@ -2577,6 +2581,263 @@ var PageSkeleton = Object.assign(PageSkeletonRoot, {
   Form: PageSkeletonForm,
   Split: PageSkeletonSplit
 });
+
+// src/components/PreviewCard/PreviewCard.tsx
+import { jsx as jsx56, jsxs as jsxs47 } from "react/jsx-runtime";
+function PreviewCardRoot({ as, variant = "default", className, ...rest }) {
+  const Root = as ?? "div";
+  return /* @__PURE__ */ jsx56(Root, { className: ["fds-preview-card", `fds-preview-card--${variant}`, className].filter(Boolean).join(" "), ...rest });
+}
+function PreviewCardPreview({ label, className, children, ...rest }) {
+  return /* @__PURE__ */ jsxs47("div", { className: ["fds-preview-card__preview", className].filter(Boolean).join(" "), ...rest, children: [
+    label != null && /* @__PURE__ */ jsx56("span", { className: "fds-preview-card__label", children: label }),
+    children
+  ] });
+}
+function PreviewCardTitle({ aside, className, children, ...rest }) {
+  return /* @__PURE__ */ jsxs47("div", { className: ["fds-preview-card__title", className].filter(Boolean).join(" "), ...rest, children: [
+    /* @__PURE__ */ jsx56("span", { className: "fds-preview-card__name", children }),
+    aside != null && /* @__PURE__ */ jsx56("span", { className: "fds-preview-card__aside", children: aside })
+  ] });
+}
+function part(name) {
+  return function PreviewCardPart({ className, ...rest }) {
+    return /* @__PURE__ */ jsx56("div", { className: [`fds-preview-card__${name}`, className].filter(Boolean).join(" "), ...rest });
+  };
+}
+var PreviewCard = Object.assign(PreviewCardRoot, {
+  Preview: PreviewCardPreview,
+  Body: part("body"),
+  Title: PreviewCardTitle,
+  Meta: part("meta"),
+  Footer: part("footer")
+});
+
+// src/components/Tile/Tile.tsx
+import { jsx as jsx57, jsxs as jsxs48 } from "react/jsx-runtime";
+function Tile({ label, aside, className, children, ...rest }) {
+  return /* @__PURE__ */ jsxs48("section", { className: ["fds-tile", className].filter(Boolean).join(" "), ...rest, children: [
+    /* @__PURE__ */ jsxs48("header", { className: "fds-tile__head", children: [
+      /* @__PURE__ */ jsx57("span", { className: "fds-tile__label", children: label }),
+      aside
+    ] }),
+    /* @__PURE__ */ jsx57("div", { className: "fds-tile__body", children })
+  ] });
+}
+
+// src/components/ListCard/ListCard.tsx
+import { jsx as jsx58, jsxs as jsxs49 } from "react/jsx-runtime";
+function ListCardRoot({ title, count, aside, footer, className, children, ...rest }) {
+  return /* @__PURE__ */ jsxs49("section", { className: ["fds-list-card", className].filter(Boolean).join(" "), ...rest, children: [
+    (title != null || aside != null) && /* @__PURE__ */ jsxs49("header", { className: "fds-list-card__head", children: [
+      /* @__PURE__ */ jsxs49("span", { className: "fds-list-card__title", children: [
+        title,
+        count != null && /* @__PURE__ */ jsx58("span", { className: "fds-list-card__count", children: count })
+      ] }),
+      aside != null && /* @__PURE__ */ jsx58("span", { className: "fds-list-card__aside", children: aside })
+    ] }),
+    /* @__PURE__ */ jsx58("ul", { className: "fds-list-card__rows", children }),
+    footer != null && /* @__PURE__ */ jsx58("footer", { className: "fds-list-card__footer", children: footer })
+  ] });
+}
+function ListCardRow({ icon, tone = "neutral", title, description, trailing, muted, className, ...rest }) {
+  return /* @__PURE__ */ jsxs49("li", { className: ["fds-list-card__row", muted ? "fds-list-card__row--muted" : "", className].filter(Boolean).join(" "), ...rest, children: [
+    icon != null && /* @__PURE__ */ jsx58("span", { className: `fds-list-card__icon fds-list-card__icon--${tone}`, "aria-hidden": "true", children: icon }),
+    /* @__PURE__ */ jsxs49("span", { className: "fds-list-card__text", children: [
+      /* @__PURE__ */ jsx58("span", { className: "fds-list-card__row-title", children: title }),
+      description != null && /* @__PURE__ */ jsx58("span", { className: "fds-list-card__description", children: description })
+    ] }),
+    trailing != null && /* @__PURE__ */ jsx58("span", { className: "fds-list-card__trailing", children: trailing })
+  ] });
+}
+var ListCard = Object.assign(ListCardRoot, { Row: ListCardRow });
+
+// src/components/DescriptionList/DescriptionList.tsx
+import { jsx as jsx59, jsxs as jsxs50 } from "react/jsx-runtime";
+function DescriptionList({ title, action, items = [], note, className, children, ...rest }) {
+  return /* @__PURE__ */ jsxs50("section", { className: ["fds-description-list", className].filter(Boolean).join(" "), ...rest, children: [
+    (title != null || action != null) && /* @__PURE__ */ jsxs50("header", { className: "fds-description-list__head", children: [
+      /* @__PURE__ */ jsx59("span", { className: "fds-description-list__title", children: title }),
+      action != null && /* @__PURE__ */ jsx59("span", { className: "fds-description-list__action", children: action })
+    ] }),
+    items.length > 0 && /* @__PURE__ */ jsx59("dl", { className: "fds-description-list__items", children: items.map((item, i) => /* @__PURE__ */ jsxs50("div", { className: "fds-description-list__item", children: [
+      /* @__PURE__ */ jsx59("dt", { children: item.label }),
+      /* @__PURE__ */ jsx59("dd", { children: item.value })
+    ] }, i)) }),
+    children,
+    note != null && /* @__PURE__ */ jsx59("p", { className: "fds-description-list__note", children: note })
+  ] });
+}
+
+// src/components/ColorRamp/ColorRamp.tsx
+import { jsx as jsx60 } from "react/jsx-runtime";
+function ColorRamp({ colors, size = "md", className, ...rest }) {
+  return /* @__PURE__ */ jsx60("div", { className: ["fds-color-ramp", `fds-color-ramp--${size}`, className].filter(Boolean).join(" "), "aria-hidden": "true", ...rest, children: colors.map((c, i) => /* @__PURE__ */ jsx60("span", { className: "fds-color-ramp__step", style: { "--fds-ramp-color": c } }, i)) });
+}
+
+// src/components/SwatchList/SwatchList.tsx
+import { jsx as jsx61, jsxs as jsxs51 } from "react/jsx-runtime";
+function SwatchList({ items, className, ...rest }) {
+  return /* @__PURE__ */ jsx61("ul", { className: ["fds-swatch-list", className].filter(Boolean).join(" "), ...rest, children: items.map((item, i) => /* @__PURE__ */ jsxs51("li", { className: "fds-swatch-list__item", children: [
+    /* @__PURE__ */ jsx61(
+      "span",
+      {
+        className: ["fds-swatch-list__dot", item.color ? "" : "fds-swatch-list__dot--empty"].filter(Boolean).join(" "),
+        style: item.color ? { "--fds-swatch-list-color": item.color } : void 0,
+        "aria-hidden": "true"
+      }
+    ),
+    /* @__PURE__ */ jsx61("span", { className: "fds-swatch-list__name", children: item.name }),
+    /* @__PURE__ */ jsx61("span", { className: "fds-swatch-list__value", children: item.value })
+  ] }, i)) });
+}
+
+// src/components/TypeSpecimen/TypeSpecimen.tsx
+import { jsx as jsx62, jsxs as jsxs52 } from "react/jsx-runtime";
+var ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz 0123456789";
+function TypeSpecimen({ family, fontFamily, tokens, sample, weights = [], footer, className, ...rest }) {
+  const face = { "--fds-specimen-font": fontFamily };
+  return /* @__PURE__ */ jsxs52("section", { className: ["fds-type-specimen", className].filter(Boolean).join(" "), style: face, ...rest, children: [
+    /* @__PURE__ */ jsxs52("header", { className: "fds-type-specimen__head", children: [
+      /* @__PURE__ */ jsxs52("div", { className: "fds-type-specimen__titles", children: [
+        /* @__PURE__ */ jsx62("h3", { className: "fds-type-specimen__family", children: family }),
+        tokens != null && /* @__PURE__ */ jsx62("div", { className: "fds-type-specimen__tokens", children: tokens })
+      ] }),
+      /* @__PURE__ */ jsx62("span", { className: "fds-type-specimen__glyph", "aria-hidden": "true", children: "Aa" })
+    ] }),
+    sample != null && /* @__PURE__ */ jsx62("p", { className: "fds-type-specimen__sample", children: sample }),
+    /* @__PURE__ */ jsx62("p", { className: "fds-type-specimen__alphabet", children: ALPHABET }),
+    weights.length > 0 && /* @__PURE__ */ jsx62("ul", { className: "fds-type-specimen__weights", children: weights.map((w) => /* @__PURE__ */ jsxs52("li", { children: [
+      /* @__PURE__ */ jsx62("span", { style: { fontWeight: w.weight }, children: "Ag" }),
+      /* @__PURE__ */ jsx62("small", { children: w.label })
+    ] }, w.label)) }),
+    footer != null && /* @__PURE__ */ jsx62("footer", { className: "fds-type-specimen__footer", children: footer })
+  ] });
+}
+function TypeSample({ fontFamily, caption, className, ...rest }) {
+  return /* @__PURE__ */ jsxs52("div", { className: ["fds-type-sample", className].filter(Boolean).join(" "), style: { "--fds-specimen-font": fontFamily }, ...rest, children: [
+    /* @__PURE__ */ jsx62("span", { className: "fds-type-sample__glyph", "aria-hidden": "true", children: "Aa" }),
+    caption != null && /* @__PURE__ */ jsx62("span", { className: "fds-type-sample__caption", children: caption })
+  ] });
+}
+
+// src/components/TypeScale/TypeScale.tsx
+import { jsx as jsx63, jsxs as jsxs53 } from "react/jsx-runtime";
+function TypeScaleRoot({ className, ...rest }) {
+  return /* @__PURE__ */ jsx63("ul", { className: ["fds-type-scale", className].filter(Boolean).join(" "), ...rest });
+}
+function TypeScaleRow({ name, detail, sampleStyle, sample = "Check every pull request", className, ...rest }) {
+  return /* @__PURE__ */ jsxs53("li", { className: ["fds-type-scale__row", className].filter(Boolean).join(" "), ...rest, children: [
+    /* @__PURE__ */ jsxs53("span", { className: "fds-type-scale__label", children: [
+      /* @__PURE__ */ jsx63("span", { className: "fds-type-scale__name", children: name }),
+      detail != null && /* @__PURE__ */ jsx63("span", { className: "fds-type-scale__detail", children: detail })
+    ] }),
+    /* @__PURE__ */ jsx63("span", { className: "fds-type-scale__sample", style: sampleStyle, children: sample })
+  ] });
+}
+var TypeScale = Object.assign(TypeScaleRoot, { Row: TypeScaleRow });
+
+// src/components/MeasureList/MeasureList.tsx
+import { jsx as jsx64, jsxs as jsxs54 } from "react/jsx-runtime";
+function MeasureList({ items, max, tone = "accent", className, ...rest }) {
+  const top = max ?? Math.max(1, ...items.map((i) => i.amount));
+  return /* @__PURE__ */ jsx64("ul", { className: ["fds-measure-list", `fds-measure-list--${tone}`, className].filter(Boolean).join(" "), ...rest, children: items.map((item, i) => /* @__PURE__ */ jsxs54("li", { className: "fds-measure-list__item", children: [
+    /* @__PURE__ */ jsx64("span", { className: "fds-measure-list__name", children: item.name }),
+    /* @__PURE__ */ jsx64("span", { className: "fds-measure-list__value", children: item.value }),
+    /* @__PURE__ */ jsx64("span", { className: "fds-measure-list__track", "aria-hidden": "true", children: /* @__PURE__ */ jsx64("span", { className: "fds-measure-list__bar", style: { "--fds-measure": `${Math.min(100, item.amount / top * 100)}%` } }) })
+  ] }, i)) });
+}
+
+// src/components/TokenSample/TokenSample.tsx
+import { jsx as jsx65, jsxs as jsxs55 } from "react/jsx-runtime";
+function TokenSample({ kind, value, name, detail, className, ...rest }) {
+  const style = { [kind === "radius" ? "--fds-sample-radius" : "--fds-sample-shadow"]: value };
+  return /* @__PURE__ */ jsxs55("div", { className: ["fds-token-sample", `fds-token-sample--${kind}`, className].filter(Boolean).join(" "), ...rest, children: [
+    /* @__PURE__ */ jsx65("span", { className: "fds-token-sample__shape", style, "aria-hidden": "true" }),
+    /* @__PURE__ */ jsx65("span", { className: "fds-token-sample__name", children: name }),
+    detail != null && /* @__PURE__ */ jsx65("span", { className: "fds-token-sample__detail", children: detail })
+  ] });
+}
+
+// src/components/EasingCurve/EasingCurve.tsx
+import { jsx as jsx66, jsxs as jsxs56 } from "react/jsx-runtime";
+var BEZIER = /cubic-bezier\(\s*([-\d.]+)\s*,\s*([-\d.]+)\s*,\s*([-\d.]+)\s*,\s*([-\d.]+)\s*\)/;
+var W = 120;
+var H = 72;
+var PAD = 12;
+function easingPath(value) {
+  const m = BEZIER.exec(value);
+  const [x1, y1, x2, y2] = m ? m.slice(1).map(Number) : [0, 0, 1, 1];
+  const x = (t) => PAD + t * (W - PAD * 2);
+  const y = (t) => H - PAD - t * (H - PAD * 2);
+  return `M${x(0)},${y(0)} C${x(x1)},${y(y1)} ${x(x2)},${y(y2)} ${x(1)},${y(1)}`;
+}
+function EasingCurve({ value, name, className, ...rest }) {
+  return /* @__PURE__ */ jsxs56("div", { className: ["fds-easing-curve", className].filter(Boolean).join(" "), ...rest, children: [
+    /* @__PURE__ */ jsx66("svg", { className: "fds-easing-curve__plot", viewBox: `0 0 ${W} ${H}`, "aria-hidden": "true", children: /* @__PURE__ */ jsx66("path", { d: easingPath(value) }) }),
+    /* @__PURE__ */ jsx66("span", { className: "fds-easing-curve__name", children: name }),
+    /* @__PURE__ */ jsx66("span", { className: "fds-easing-curve__value", children: value })
+  ] });
+}
+
+// src/components/FilterChips/FilterChips.tsx
+import { useRef as useRef11 } from "react";
+import { jsx as jsx67, jsxs as jsxs57 } from "react/jsx-runtime";
+function FilterChips({ options, value, onChange, "aria-label": ariaLabel, className }) {
+  const refs = useRef11([]);
+  const onKeyDown = (e, index) => {
+    const step = e.key === "ArrowRight" || e.key === "ArrowDown" ? 1 : e.key === "ArrowLeft" || e.key === "ArrowUp" ? -1 : 0;
+    if (!step) return;
+    e.preventDefault();
+    const next = (index + step + options.length) % options.length;
+    onChange(options[next].value);
+    refs.current[next]?.focus();
+  };
+  return /* @__PURE__ */ jsx67("div", { role: "radiogroup", "aria-label": ariaLabel, className: ["fds-filter-chips", className].filter(Boolean).join(" "), children: options.map((o, i) => {
+    const selected = o.value === value;
+    return /* @__PURE__ */ jsxs57(
+      "button",
+      {
+        ref: (el) => {
+          refs.current[i] = el;
+        },
+        type: "button",
+        role: "radio",
+        "aria-checked": selected,
+        tabIndex: selected ? 0 : -1,
+        className: ["fds-filter-chips__chip", selected ? "fds-filter-chips__chip--selected" : ""].filter(Boolean).join(" "),
+        onClick: () => onChange(o.value),
+        onKeyDown: (e) => onKeyDown(e, i),
+        children: [
+          o.label,
+          o.count != null && /* @__PURE__ */ jsx67("span", { className: "fds-filter-chips__count", children: o.count })
+        ]
+      },
+      o.value
+    );
+  }) });
+}
+
+// src/components/Meter/Meter.tsx
+import { jsx as jsx68, jsxs as jsxs58 } from "react/jsx-runtime";
+function Meter({ value, max, label, className, ...rest }) {
+  const pct = max > 0 ? Math.min(100, Math.max(0, value / max * 100)) : 0;
+  return /* @__PURE__ */ jsxs58("div", { className: ["fds-meter", className].filter(Boolean).join(" "), ...rest, children: [
+    /* @__PURE__ */ jsx68(
+      "span",
+      {
+        className: "fds-meter__track",
+        role: "meter",
+        "aria-valuemin": 0,
+        "aria-valuemax": max,
+        "aria-valuenow": value,
+        "aria-label": typeof label === "string" ? label : void 0,
+        children: /* @__PURE__ */ jsx68("span", { className: "fds-meter__fill", style: { "--fds-meter": `${pct}%` } })
+      }
+    ),
+    /* @__PURE__ */ jsx68("span", { className: "fds-meter__label", children: label })
+  ] });
+}
 export {
   Accordion,
   AppLayout,
@@ -2591,15 +2852,22 @@ export {
   Card,
   Checkbox,
   Checklist,
+  ColorRamp,
+  DescriptionList,
   DiffPropertyList,
   DiffSection,
   Divider,
   Drawer,
+  EasingCurve,
   EmptyState,
+  FilterChips,
   IconButton,
   Input,
+  ListCard,
   ListLabel,
+  MeasureList,
   Menu,
+  Meter,
   MismatchCard,
   Modal,
   MultiSelect,
@@ -2609,6 +2877,7 @@ export {
   PageHeader,
   PageSkeleton,
   Pagination,
+  PreviewCard,
   PricingCard,
   Radio,
   RadioCard,
@@ -2630,13 +2899,19 @@ export {
   StepList,
   Stepper,
   Swatch,
+  SwatchList,
   TabNav,
   Table,
   Tag,
+  Tile,
   Toast,
   ToastRegion,
   Toggle,
+  TokenSample,
   Tooltip,
+  TypeSample,
+  TypeScale,
+  TypeSpecimen,
   WorkspaceAvatar,
   WorkspaceSwitcher,
   breakpoints,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usefidel/design-system",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "Fidel brand design tokens + React component library — DTCG token source of truth, generated per-surface CSS + Tailwind-v4 parser-compatibility output, and on-brand React components (Button, MismatchCard, DiffSection).",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -42,20 +42,25 @@
     "typecheck": "tsc --noEmit",
     "surface-check": "node build/surface-check.mjs",
     "test": "node --test test/*.test.mjs",
-    "gitleaks": "gitleaks detect --no-banner --redact -v"
+    "gitleaks": "gitleaks detect --no-banner --redact -v",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build -o storybook-static"
   },
   "peerDependencies": {
     "react": ">=18",
     "react-dom": ">=18"
   },
   "devDependencies": {
+    "@storybook/react-vite": "10.6.2",
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
+    "storybook": "10.6.2",
     "style-dictionary": "^4.3.0",
     "tsup": "^8.3.5",
-    "typescript": "^5.6.3"
+    "typescript": "^5.6.3",
+    "vite": "8.3.4"
   },
   "dependencies": {
     "lucide-react": "^1.33.0"