@contractspec/lib.design-system 1.46.2 → 1.48.0

package/dist/components/molecules/CommandTabs/CommandTabs.js

@@ -0,0 +1,68 @@
+'use client';
+
+import { cn } from "../../../lib/utils.js";
+import { CopyButton } from "../CopyButton/CopyButton.js";
+import { usePackageManager } from "../../providers/PackageManagerProvider.js";
+import { useEffect, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/molecules/CommandTabs/CommandTabs.tsx
+const STORAGE_KEY = "package-manager-preference";
+function CommandTabs({ commands, initialPreference = "bun", className, ...props }) {
+	const context = usePackageManager();
+	const [localSelected, setLocalSelected] = useState(() => {
+		return initialPreference;
+	});
+	const selected = context?.preference ?? localSelected;
+	const setSelected = context?.setPreference ?? setLocalSelected;
+	useEffect(() => {
+		if (context) return;
+		try {
+			const saved = localStorage.getItem(STORAGE_KEY);
+			if (saved && commands[saved]) setLocalSelected(saved);
+		} catch {}
+	}, [commands, context]);
+	const handleSelect = (pm) => {
+		setSelected(pm);
+		if (!context) try {
+			localStorage.setItem(STORAGE_KEY, pm);
+		} catch {}
+	};
+	const packageManagers = Object.keys(commands);
+	if (packageManagers.length === 0) return null;
+	const effectiveSelected = commands[selected] ? selected : packageManagers[0];
+	if (!effectiveSelected) return null;
+	const currentCommand = commands[effectiveSelected];
+	if (!currentCommand) return null;
+	return /* @__PURE__ */ jsxs("div", {
+		className: cn("relative rounded-lg border border-zinc-800 bg-zinc-950", className),
+		...props,
+		children: [/* @__PURE__ */ jsx("div", {
+			className: "flex items-center border-b border-zinc-800 bg-zinc-900/50 px-2 pt-2",
+			role: "tablist",
+			"aria-label": "Package manager selection",
+			children: packageManagers.map((pm) => /* @__PURE__ */ jsx("button", {
+				type: "button",
+				role: "tab",
+				"aria-selected": effectiveSelected === pm,
+				onClick: () => handleSelect(pm),
+				className: cn("rounded-t-md border-t border-r border-l border-transparent px-4 py-2 text-xs font-medium text-zinc-400", "transition-colors hover:text-zinc-100", "focus:ring-2 focus:ring-zinc-600 focus:ring-offset-1 focus:ring-offset-zinc-900 focus:outline-none", effectiveSelected === pm && "border-zinc-800 bg-zinc-950 text-zinc-100"),
+				children: pm
+			}, pm))
+		}), /* @__PURE__ */ jsxs("div", {
+			className: "relative p-4",
+			role: "tabpanel",
+			children: [/* @__PURE__ */ jsx(CopyButton, {
+				value: currentCommand,
+				className: "absolute top-3 right-3"
+			}), /* @__PURE__ */ jsx("pre", {
+				className: "overflow-x-auto pr-10 font-mono text-[13px] leading-6 text-white",
+				children: /* @__PURE__ */ jsx("code", { children: currentCommand })
+			})]
+		})]
+	});
+}
+
+//#endregion
+export { CommandTabs };
+//# sourceMappingURL=CommandTabs.js.map

package/dist/components/molecules/CommandTabs/CommandTabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandTabs.js","names":[],"sources":["../../../../src/components/molecules/CommandTabs/CommandTabs.tsx"],"sourcesContent":["'use client';\n\nimport { cn } from '../../../lib/utils';\nimport { useEffect, useState } from 'react';\nimport { CopyButton } from '../CopyButton';\nimport { usePackageManager } from '../../providers/PackageManagerProvider';\nimport type { CommandTabsProps, PackageManager } from './types';\n\nconst STORAGE_KEY = 'package-manager-preference';\n\nexport function CommandTabs({\n  commands,\n  initialPreference = 'bun',\n  className,\n  ...props\n}: CommandTabsProps) {\n  const context = usePackageManager();\n\n  const [localSelected, setLocalSelected] = useState<PackageManager>(() => {\n    return initialPreference;\n  });\n\n  // Use context if available, otherwise use local state\n  const selected = context?.preference ?? localSelected;\n  const setSelected = context?.setPreference ?? setLocalSelected;\n\n  // Hydrate preference from localStorage (only if not using context)\n  useEffect(() => {\n    if (context) return; // Context handles its own persistence\n\n    try {\n      const saved = localStorage.getItem(STORAGE_KEY) as PackageManager | null;\n      if (saved && commands[saved]) {\n        setLocalSelected(saved);\n      }\n    } catch {\n      // localStorage not available\n    }\n  }, [commands, context]);\n\n  const handleSelect = (pm: PackageManager) => {\n    setSelected(pm);\n\n    // Only persist locally if not using context\n    if (!context) {\n      try {\n        localStorage.setItem(STORAGE_KEY, pm);\n      } catch {\n        // localStorage not available\n      }\n    }\n  };\n\n  // Get available package managers from commands\n  const packageManagers = Object.keys(commands) as PackageManager[];\n\n  // Early return if no commands available\n  if (packageManagers.length === 0) return null;\n\n  // Use selected if available, otherwise fallback to first available\n  const effectiveSelected = commands[selected] ? selected : packageManagers[0];\n  if (!effectiveSelected) return null;\n  const currentCommand = commands[effectiveSelected];\n  if (!currentCommand) return null;\n\n  return (\n    <div\n      className={cn(\n        'relative rounded-lg border border-zinc-800 bg-zinc-950',\n        className\n      )}\n      {...props}\n    >\n      <div\n        className=\"flex items-center border-b border-zinc-800 bg-zinc-900/50 px-2 pt-2\"\n        role=\"tablist\"\n        aria-label=\"Package manager selection\"\n      >\n        {packageManagers.map((pm) => (\n          <button\n            key={pm}\n            type=\"button\"\n            role=\"tab\"\n            aria-selected={effectiveSelected === pm}\n            onClick={() => handleSelect(pm)}\n            className={cn(\n              'rounded-t-md border-t border-r border-l border-transparent px-4 py-2 text-xs font-medium text-zinc-400',\n              'transition-colors hover:text-zinc-100',\n              'focus:ring-2 focus:ring-zinc-600 focus:ring-offset-1 focus:ring-offset-zinc-900 focus:outline-none',\n              effectiveSelected === pm &&\n                'border-zinc-800 bg-zinc-950 text-zinc-100'\n            )}\n          >\n            {pm}\n          </button>\n        ))}\n      </div>\n      <div className=\"relative p-4\" role=\"tabpanel\">\n        <CopyButton value={currentCommand} className=\"absolute top-3 right-3\" />\n        <pre className=\"overflow-x-auto pr-10 font-mono text-[13px] leading-6 text-white\">\n          <code>{currentCommand}</code>\n        </pre>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;AAQA,MAAM,cAAc;AAEpB,SAAgB,YAAY,EAC1B,UACA,oBAAoB,OACpB,WACA,GAAG,SACgB;CACnB,MAAM,UAAU,mBAAmB;CAEnC,MAAM,CAAC,eAAe,oBAAoB,eAA+B;AACvE,SAAO;GACP;CAGF,MAAM,WAAW,SAAS,cAAc;CACxC,MAAM,cAAc,SAAS,iBAAiB;AAG9C,iBAAgB;AACd,MAAI,QAAS;AAEb,MAAI;GACF,MAAM,QAAQ,aAAa,QAAQ,YAAY;AAC/C,OAAI,SAAS,SAAS,OACpB,kBAAiB,MAAM;UAEnB;IAGP,CAAC,UAAU,QAAQ,CAAC;CAEvB,MAAM,gBAAgB,OAAuB;AAC3C,cAAY,GAAG;AAGf,MAAI,CAAC,QACH,KAAI;AACF,gBAAa,QAAQ,aAAa,GAAG;UAC/B;;CAOZ,MAAM,kBAAkB,OAAO,KAAK,SAAS;AAG7C,KAAI,gBAAgB,WAAW,EAAG,QAAO;CAGzC,MAAM,oBAAoB,SAAS,YAAY,WAAW,gBAAgB;AAC1E,KAAI,CAAC,kBAAmB,QAAO;CAC/B,MAAM,iBAAiB,SAAS;AAChC,KAAI,CAAC,eAAgB,QAAO;AAE5B,QACE,qBAAC;EACC,WAAW,GACT,0DACA,UACD;EACD,GAAI;aAEJ,oBAAC;GACC,WAAU;GACV,MAAK;GACL,cAAW;aAEV,gBAAgB,KAAK,OACpB,oBAAC;IAEC,MAAK;IACL,MAAK;IACL,iBAAe,sBAAsB;IACrC,eAAe,aAAa,GAAG;IAC/B,WAAW,GACT,0GACA,yCACA,sGACA,sBAAsB,MACpB,4CACH;cAEA;MAbI,GAcE,CACT;IACE,EACN,qBAAC;GAAI,WAAU;GAAe,MAAK;cACjC,oBAAC;IAAW,OAAO;IAAgB,WAAU;KAA2B,EACxE,oBAAC;IAAI,WAAU;cACb,oBAAC,oBAAM,iBAAsB;KACzB;IACF;GACF"}

package/dist/components/molecules/CommandTabs/index.d.ts

@@ -0,0 +1,2 @@
+import { CommandTabsProps, PackageManager, PackageManagerContextValue } from "./types.js";
+import { CommandTabs } from "./CommandTabs.js";

package/dist/components/molecules/CommandTabs/types.d.ts

@@ -0,0 +1,19 @@
+import { HTMLAttributes } from "react";
+
+//#region src/components/molecules/CommandTabs/types.d.ts
+type PackageManager = 'bun' | 'npm' | 'yarn' | 'pnpm';
+interface CommandTabsProps extends HTMLAttributes<HTMLDivElement> {
+  /** Commands for each package manager */
+  commands: Partial<Record<PackageManager, string>>;
+  /** Initial package manager preference (overridden by context if available) */
+  initialPreference?: PackageManager;
+}
+interface PackageManagerContextValue {
+  /** Current package manager preference */
+  preference: PackageManager;
+  /** Set the package manager preference */
+  setPreference: (pm: PackageManager) => void;
+}
+//#endregion
+export { CommandTabsProps, PackageManager, PackageManagerContextValue };
+//# sourceMappingURL=types.d.ts.map

package/dist/components/molecules/CommandTabs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/components/molecules/CommandTabs/types.ts"],"sourcesContent":[],"mappings":";;;KAEY,cAAA;UAEK,gBAAA,SAAyB,eAAe;EAF7C;EAEK,QAAA,EAEL,OAFK,CAEG,MAFc,CAEP,cAFO,EAAA,MAAA,CAAA,CAAA;EAAuB;EAE9B,iBAAA,CAAA,EAEL,cAFK;;AAAf,UAKK,0BAAA,CALL;EAEU;EAJoB,UAAA,EAS5B,cAT4B;EAAc;EAOvC,aAAA,EAAA,CAAA,EAAA,EAIK,cAJqB,EAAA,GAAA,IAE7B"}

package/dist/components/molecules/CopyButton/CopyButton.d.ts

@@ -0,0 +1,13 @@
+import { CopyButtonProps } from "./types.js";
+import * as react_jsx_runtime112 from "react/jsx-runtime";
+
+//#region src/components/molecules/CopyButton/CopyButton.d.ts
+declare function CopyButton({
+  value,
+  onCopy,
+  className,
+  ...props
+}: CopyButtonProps): react_jsx_runtime112.JSX.Element;
+//#endregion
+export { CopyButton };
+//# sourceMappingURL=CopyButton.d.ts.map

package/dist/components/molecules/CopyButton/CopyButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyButton.d.ts","names":[],"sources":["../../../../src/components/molecules/CopyButton/CopyButton.tsx"],"sourcesContent":[],"mappings":";;;;iBAOgB,UAAA;;;;;GAKb,kBAAe,oBAAA,CAAA,GAAA,CAAA"}

package/dist/components/molecules/CopyButton/CopyButton.js

@@ -0,0 +1,42 @@
+'use client';
+
+import { cn } from "../../../lib/utils.js";
+import { useCallback, useEffect, useState } from "react";
+import { Check, Copy } from "lucide-react";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/molecules/CopyButton/CopyButton.tsx
+function CopyButton({ value, onCopy, className, ...props }) {
+	const [hasCopied, setHasCopied] = useState(false);
+	useEffect(() => {
+		if (!hasCopied) return;
+		const timeout = setTimeout(() => {
+			setHasCopied(false);
+		}, 2e3);
+		return () => clearTimeout(timeout);
+	}, [hasCopied]);
+	const copyToClipboard = useCallback(async () => {
+		try {
+			await navigator.clipboard.writeText(value);
+			setHasCopied(true);
+			onCopy?.();
+		} catch (err) {
+			console.error("Failed to copy to clipboard:", err);
+		}
+	}, [value, onCopy]);
+	return /* @__PURE__ */ jsxs("button", {
+		type: "button",
+		className: cn("relative z-10 inline-flex h-6 w-6 items-center justify-center rounded-md", "border border-zinc-700 bg-zinc-800 text-zinc-400", "transition-all hover:bg-zinc-700 hover:text-zinc-100", "focus:ring-2 focus:ring-zinc-600 focus:ring-offset-2 focus:ring-offset-zinc-900 focus:outline-none", className),
+		onClick: copyToClipboard,
+		"aria-label": hasCopied ? "Copied" : "Copy to clipboard",
+		...props,
+		children: [/* @__PURE__ */ jsx("span", {
+			className: "sr-only",
+			children: hasCopied ? "Copied" : "Copy"
+		}), hasCopied ? /* @__PURE__ */ jsx(Check, { className: "h-3 w-3" }) : /* @__PURE__ */ jsx(Copy, { className: "h-3 w-3" })]
+	});
+}
+
+//#endregion
+export { CopyButton };
+//# sourceMappingURL=CopyButton.js.map

package/dist/components/molecules/CopyButton/CopyButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyButton.js","names":[],"sources":["../../../../src/components/molecules/CopyButton/CopyButton.tsx"],"sourcesContent":["'use client';\n\nimport { cn } from '../../../lib/utils';\nimport { Check, Copy } from 'lucide-react';\nimport { useCallback, useEffect, useState } from 'react';\nimport type { CopyButtonProps } from './types';\n\nexport function CopyButton({\n  value,\n  onCopy,\n  className,\n  ...props\n}: CopyButtonProps) {\n  const [hasCopied, setHasCopied] = useState(false);\n\n  useEffect(() => {\n    if (!hasCopied) return;\n    const timeout = setTimeout(() => {\n      setHasCopied(false);\n    }, 2000);\n    return () => clearTimeout(timeout);\n  }, [hasCopied]);\n\n  const copyToClipboard = useCallback(async () => {\n    try {\n      await navigator.clipboard.writeText(value);\n      setHasCopied(true);\n      onCopy?.();\n    } catch (err) {\n      console.error('Failed to copy to clipboard:', err);\n    }\n  }, [value, onCopy]);\n\n  return (\n    <button\n      type=\"button\"\n      className={cn(\n        'relative z-10 inline-flex h-6 w-6 items-center justify-center rounded-md',\n        'border border-zinc-700 bg-zinc-800 text-zinc-400',\n        'transition-all hover:bg-zinc-700 hover:text-zinc-100',\n        'focus:ring-2 focus:ring-zinc-600 focus:ring-offset-2 focus:ring-offset-zinc-900 focus:outline-none',\n        className\n      )}\n      onClick={copyToClipboard}\n      aria-label={hasCopied ? 'Copied' : 'Copy to clipboard'}\n      {...props}\n    >\n      <span className=\"sr-only\">{hasCopied ? 'Copied' : 'Copy'}</span>\n      {hasCopied ? <Check className=\"h-3 w-3\" /> : <Copy className=\"h-3 w-3\" />}\n    </button>\n  );\n}\n"],"mappings":";;;;;;;;AAOA,SAAgB,WAAW,EACzB,OACA,QACA,WACA,GAAG,SACe;CAClB,MAAM,CAAC,WAAW,gBAAgB,SAAS,MAAM;AAEjD,iBAAgB;AACd,MAAI,CAAC,UAAW;EAChB,MAAM,UAAU,iBAAiB;AAC/B,gBAAa,MAAM;KAClB,IAAK;AACR,eAAa,aAAa,QAAQ;IACjC,CAAC,UAAU,CAAC;CAEf,MAAM,kBAAkB,YAAY,YAAY;AAC9C,MAAI;AACF,SAAM,UAAU,UAAU,UAAU,MAAM;AAC1C,gBAAa,KAAK;AAClB,aAAU;WACH,KAAK;AACZ,WAAQ,MAAM,gCAAgC,IAAI;;IAEnD,CAAC,OAAO,OAAO,CAAC;AAEnB,QACE,qBAAC;EACC,MAAK;EACL,WAAW,GACT,4EACA,oDACA,wDACA,sGACA,UACD;EACD,SAAS;EACT,cAAY,YAAY,WAAW;EACnC,GAAI;aAEJ,oBAAC;GAAK,WAAU;aAAW,YAAY,WAAW;IAAc,EAC/D,YAAY,oBAAC,SAAM,WAAU,YAAY,GAAG,oBAAC,QAAK,WAAU,YAAY;GAClE"}

package/dist/components/molecules/CopyButton/index.d.ts

@@ -0,0 +1,2 @@
+import { CopyButtonProps } from "./types.js";
+import { CopyButton } from "./CopyButton.js";

package/dist/components/molecules/CopyButton/types.d.ts

@@ -0,0 +1,12 @@
+import { HTMLAttributes } from "react";
+
+//#region src/components/molecules/CopyButton/types.d.ts
+interface CopyButtonProps extends HTMLAttributes<HTMLButtonElement> {
+  /** The value to copy to clipboard */
+  value: string;
+  /** Optional callback when copy succeeds */
+  onCopy?: () => void;
+}
+//#endregion
+export { CopyButtonProps };
+//# sourceMappingURL=types.d.ts.map

package/dist/components/molecules/CopyButton/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/components/molecules/CopyButton/types.ts"],"sourcesContent":[],"mappings":";;;UAEiB,eAAA,SAAwB,eAAe;;EAAvC,KAAA,EAAA,MAAA"}

package/dist/components/molecules/EntityCard.d.ts

@@ -1,12 +1,12 @@
 import * as React from "react";
-import * as react_jsx_runtime46 from "react/jsx-runtime";
+import * as react_jsx_runtime47 from "react/jsx-runtime";
 import { VariantProps } from "class-variance-authority";
 import { Card } from "@contractspec/lib.ui-kit-web/ui/card";
 import * as class_variance_authority_types7 from "class-variance-authority/types";
 
 //#region src/components/molecules/EntityCard.d.ts
 declare const entityCardVariants: (props?: ({
-  emphasis?: "default" | "strong" | "subtle" | null | undefined;
+  emphasis?: "strong" | "default" | "subtle" | null | undefined;
   density?: "compact" | "comfortable" | null | undefined;
 } & class_variance_authority_types7.ClassProp) | undefined) => string;
 type EntityCardProps = React.ComponentProps<typeof Card> & VariantProps<typeof entityCardVariants> & {
@@ -32,7 +32,7 @@ declare function EntityCard({
   href,
   preview,
   ...cardProps
-}: EntityCardProps): react_jsx_runtime46.JSX.Element;
+}: EntityCardProps): react_jsx_runtime47.JSX.Element;
 //#endregion
 export { EntityCard };
 //# sourceMappingURL=EntityCard.d.ts.map

package/dist/components/molecules/EntityCard.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityCard.js","names":["Wrapper: React.ElementType"],"sources":["../../../src/components/molecules/EntityCard.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { Card, CardContent } from '@contractspec/lib.ui-kit-web/ui/card';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { cn } from '@contractspec/lib.ui-kit-web/ui/utils';\n\nconst entityCardVariants = cva('transition-all hover:shadow-2xs', {\n  variants: {\n    emphasis: {\n      default: '',\n      subtle: 'border-muted/60 bg-muted/20',\n      strong: 'border-primary/50 bg-primary/5',\n    },\n    density: {\n      compact: 'p-3',\n      comfortable: 'p-4 md:p-5',\n    },\n  },\n  defaultVariants: { emphasis: 'default', density: 'comfortable' },\n});\n\nexport type EntityCardProps = React.ComponentProps<typeof Card> &\n  VariantProps<typeof entityCardVariants> & {\n    cardTitle: React.ReactNode;\n    cardSubtitle?: React.ReactNode;\n    chips?: React.ReactNode; // right-aligned small chips\n    meta?: React.ReactNode; // rows of icon+text data\n    footer?: React.ReactNode; // actions area\n    href?: string; // optional link wrapper\n    contentClassName?: string;\n    preview?: React.ReactNode; // hover preview content\n  };\n\nexport function EntityCard({\n  cardTitle,\n  cardSubtitle,\n  chips,\n  meta,\n  footer,\n  emphasis,\n  density,\n  className,\n  contentClassName,\n  href,\n  preview,\n  ...cardProps\n}: EntityCardProps) {\n  const Wrapper: React.ElementType = href ? 'a' : 'div';\n  const cardContent = (\n    <Card\n      className={cn(entityCardVariants({ emphasis }), className)}\n      {...cardProps}\n    >\n      <CardContent\n        className={cn(entityCardVariants({ density }), contentClassName)}\n      >\n        <div className=\"space-y-3\">\n          <div className=\"flex items-start justify-between gap-2\">\n            <div className=\"min-w-0\">\n              <div className=\"truncate text-lg font-medium\">{cardTitle}</div>\n              {cardSubtitle && (\n                <div className=\"text-muted-foreground text-base\">\n                  {cardSubtitle}\n                </div>\n              )}\n            </div>\n            {chips && (\n              <div className=\"inline-flex shrink-0 items-center gap-1\">\n                {chips}\n              </div>\n            )}\n          </div>\n          {meta && <div className=\"space-y-1\">{meta}</div>}\n          {footer && (\n            <div className=\"flex items-center justify-between\">{footer}</div>\n          )}\n        </div>\n      </CardContent>\n    </Card>\n  );\n\n  const maybePreview = (() => {\n    if (!preview) return cardContent;\n    try {\n      /* eslint-disable @typescript-eslint/no-require-imports */\n      const { HoverPreview } =\n        require('./HoverPreview') as typeof import('./HoverPreview');\n      /* eslint-enable @typescript-eslint/no-require-imports */\n      return <HoverPreview trigger={cardContent} content={preview} />;\n    } catch {\n      return cardContent;\n    }\n  })();\n\n  return (\n    <Wrapper href={href} className={href ? 'block' : undefined}>\n      {maybePreview}\n    </Wrapper>\n  );\n}\n"],"mappings":";;;;;;;;;;;AAOA,MAAM,qBAAqB,IAAI,mCAAmC;CAChE,UAAU;EACR,UAAU;GACR,SAAS;GACT,QAAQ;GACR,QAAQ;GACT;EACD,SAAS;GACP,SAAS;GACT,aAAa;GACd;EACF;CACD,iBAAiB;EAAE,UAAU;EAAW,SAAS;EAAe;CACjE,CAAC;AAcF,SAAgB,WAAW,EACzB,WACA,cACA,OACA,MACA,QACA,UACA,SACA,WACA,kBACA,MACA,SACA,GAAG,aACe;CAClB,MAAMA,UAA6B,OAAO,MAAM;CAChD,MAAM,cACJ,oBAAC;EACC,WAAW,GAAG,mBAAmB,EAAE,UAAU,CAAC,EAAE,UAAU;EAC1D,GAAI;YAEJ,oBAAC;GACC,WAAW,GAAG,mBAAmB,EAAE,SAAS,CAAC,EAAE,iBAAiB;aAEhE,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;iBACb,qBAAC;OAAI,WAAU;kBACb,oBAAC;QAAI,WAAU;kBAAgC;SAAgB,EAC9D,gBACC,oBAAC;QAAI,WAAU;kBACZ;SACG;QAEJ,EACL,SACC,oBAAC;OAAI,WAAU;iBACZ;QACG;OAEJ;KACL,QAAQ,oBAAC;MAAI,WAAU;gBAAa;OAAW;KAC/C,UACC,oBAAC;MAAI,WAAU;gBAAqC;OAAa;;KAE/D;IACM;GACT;CAGT,MAAM,sBAAsB;AAC1B,MAAI,CAAC,QAAS,QAAO;AACrB,MAAI;GAEF,MAAM,EAAE;AAGR,UAAO,oBAAC;IAAa,SAAS;IAAa,SAAS;KAAW;UACzD;AACN,UAAO;;KAEP;AAEJ,QACE,oBAAC;EAAc;EAAM,WAAW,OAAO,UAAU;YAC9C;GACO"}
+{"version":3,"file":"EntityCard.js","names":[],"sources":["../../../src/components/molecules/EntityCard.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { Card, CardContent } from '@contractspec/lib.ui-kit-web/ui/card';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { cn } from '@contractspec/lib.ui-kit-web/ui/utils';\n\nconst entityCardVariants = cva('transition-all hover:shadow-2xs', {\n  variants: {\n    emphasis: {\n      default: '',\n      subtle: 'border-muted/60 bg-muted/20',\n      strong: 'border-primary/50 bg-primary/5',\n    },\n    density: {\n      compact: 'p-3',\n      comfortable: 'p-4 md:p-5',\n    },\n  },\n  defaultVariants: { emphasis: 'default', density: 'comfortable' },\n});\n\nexport type EntityCardProps = React.ComponentProps<typeof Card> &\n  VariantProps<typeof entityCardVariants> & {\n    cardTitle: React.ReactNode;\n    cardSubtitle?: React.ReactNode;\n    chips?: React.ReactNode; // right-aligned small chips\n    meta?: React.ReactNode; // rows of icon+text data\n    footer?: React.ReactNode; // actions area\n    href?: string; // optional link wrapper\n    contentClassName?: string;\n    preview?: React.ReactNode; // hover preview content\n  };\n\nexport function EntityCard({\n  cardTitle,\n  cardSubtitle,\n  chips,\n  meta,\n  footer,\n  emphasis,\n  density,\n  className,\n  contentClassName,\n  href,\n  preview,\n  ...cardProps\n}: EntityCardProps) {\n  const Wrapper: React.ElementType = href ? 'a' : 'div';\n  const cardContent = (\n    <Card\n      className={cn(entityCardVariants({ emphasis }), className)}\n      {...cardProps}\n    >\n      <CardContent\n        className={cn(entityCardVariants({ density }), contentClassName)}\n      >\n        <div className=\"space-y-3\">\n          <div className=\"flex items-start justify-between gap-2\">\n            <div className=\"min-w-0\">\n              <div className=\"truncate text-lg font-medium\">{cardTitle}</div>\n              {cardSubtitle && (\n                <div className=\"text-muted-foreground text-base\">\n                  {cardSubtitle}\n                </div>\n              )}\n            </div>\n            {chips && (\n              <div className=\"inline-flex shrink-0 items-center gap-1\">\n                {chips}\n              </div>\n            )}\n          </div>\n          {meta && <div className=\"space-y-1\">{meta}</div>}\n          {footer && (\n            <div className=\"flex items-center justify-between\">{footer}</div>\n          )}\n        </div>\n      </CardContent>\n    </Card>\n  );\n\n  const maybePreview = (() => {\n    if (!preview) return cardContent;\n    try {\n      /* eslint-disable @typescript-eslint/no-require-imports */\n      const { HoverPreview } =\n        require('./HoverPreview') as typeof import('./HoverPreview');\n      /* eslint-enable @typescript-eslint/no-require-imports */\n      return <HoverPreview trigger={cardContent} content={preview} />;\n    } catch {\n      return cardContent;\n    }\n  })();\n\n  return (\n    <Wrapper href={href} className={href ? 'block' : undefined}>\n      {maybePreview}\n    </Wrapper>\n  );\n}\n"],"mappings":";;;;;;;;;;;AAOA,MAAM,qBAAqB,IAAI,mCAAmC;CAChE,UAAU;EACR,UAAU;GACR,SAAS;GACT,QAAQ;GACR,QAAQ;GACT;EACD,SAAS;GACP,SAAS;GACT,aAAa;GACd;EACF;CACD,iBAAiB;EAAE,UAAU;EAAW,SAAS;EAAe;CACjE,CAAC;AAcF,SAAgB,WAAW,EACzB,WACA,cACA,OACA,MACA,QACA,UACA,SACA,WACA,kBACA,MACA,SACA,GAAG,aACe;CAClB,MAAM,UAA6B,OAAO,MAAM;CAChD,MAAM,cACJ,oBAAC;EACC,WAAW,GAAG,mBAAmB,EAAE,UAAU,CAAC,EAAE,UAAU;EAC1D,GAAI;YAEJ,oBAAC;GACC,WAAW,GAAG,mBAAmB,EAAE,SAAS,CAAC,EAAE,iBAAiB;aAEhE,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;iBACb,qBAAC;OAAI,WAAU;kBACb,oBAAC;QAAI,WAAU;kBAAgC;SAAgB,EAC9D,gBACC,oBAAC;QAAI,WAAU;kBACZ;SACG;QAEJ,EACL,SACC,oBAAC;OAAI,WAAU;iBACZ;QACG;OAEJ;KACL,QAAQ,oBAAC;MAAI,WAAU;gBAAa;OAAW;KAC/C,UACC,oBAAC;MAAI,WAAU;gBAAqC;OAAa;;KAE/D;IACM;GACT;CAGT,MAAM,sBAAsB;AAC1B,MAAI,CAAC,QAAS,QAAO;AACrB,MAAI;GAEF,MAAM,EAAE;AAGR,UAAO,oBAAC;IAAa,SAAS;IAAa,SAAS;KAAW;UACzD;AACN,UAAO;;KAEP;AAEJ,QACE,oBAAC;EAAc;EAAM,WAAW,OAAO,UAAU;YAC9C;GACO"}

package/dist/components/molecules/FiltersToolbar.d.ts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import * as react_jsx_runtime68 from "react/jsx-runtime";
+import * as react_jsx_runtime69 from "react/jsx-runtime";
 
 //#region src/components/molecules/FiltersToolbar.d.ts
 interface ActiveFilterChip {
@@ -30,7 +30,7 @@ declare function FiltersToolbar({
   debounceMs,
   activeChips,
   onClearAll
-}: FiltersToolbarProps): react_jsx_runtime68.JSX.Element;
+}: FiltersToolbarProps): react_jsx_runtime69.JSX.Element;
 //#endregion
 export { FiltersToolbar };
 //# sourceMappingURL=FiltersToolbar.d.ts.map

package/dist/components/molecules/FiltersToolbar.js

@@ -1,6 +1,5 @@
 import { Button } from "../atoms/Button.js";
 import { Input } from "../atoms/Input.js";
-import "../../index.js";
 import * as React from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";

package/dist/components/molecules/FiltersToolbar.js.map

@@ -1 +1 @@
-{"version":3,"file":"FiltersToolbar.js","names":[],"sources":["../../../src/components/molecules/FiltersToolbar.tsx"],"sourcesContent":["import * as React from 'react';\nimport { cn } from '@contractspec/lib.ui-kit-web/ui/utils';\nimport { Button, Input } from '../../index';\nimport { Badge } from '@contractspec/lib.ui-kit-web/ui/badge';\n\nexport interface ActiveFilterChip {\n  key: string;\n  label: React.ReactNode;\n  onRemove?: () => void;\n}\n\nexport interface FiltersToolbarProps {\n  className?: string;\n  children?: React.ReactNode;\n  right?: React.ReactNode;\n  searchPlaceholder?: string;\n  searchValue?: string;\n  onSearchChange?: (value: string) => void;\n  onSearchSubmit?: () => void;\n  debounceMs?: number;\n  activeChips?: ActiveFilterChip[];\n  onClearAll?: () => void;\n}\n\nexport function FiltersToolbar({\n  className,\n  children,\n  right,\n  searchPlaceholder,\n  searchValue,\n  onSearchChange,\n  onSearchSubmit,\n  debounceMs = 250,\n  activeChips = [],\n  onClearAll,\n}: FiltersToolbarProps) {\n  const [q, setQ] = React.useState<string>(searchValue ?? '');\n\n  React.useEffect(() => {\n    setQ(searchValue ?? '');\n  }, [searchValue]);\n\n  React.useEffect(() => {\n    if (!onSearchChange) return;\n    const id = setTimeout(() => onSearchChange(q), debounceMs);\n    return () => clearTimeout(id);\n  }, [q, debounceMs, onSearchChange]);\n\n  return (\n    <div className={cn('space-y-2', className)}>\n      <div className=\"flex flex-col items-stretch gap-2 md:flex-row md:items-center md:justify-between\">\n        <div className=\"flex flex-1 items-center gap-2\">\n          {onSearchChange ? (\n            <div className=\"flex flex-1 items-center gap-2\">\n              <Input\n                value={q}\n                onChange={(e) => setQ(e.target.value)}\n                onKeyDown={(e) => {\n                  if (e.key === 'Enter') onSearchSubmit?.();\n                }}\n                placeholder={searchPlaceholder}\n                keyboard={{ kind: 'search' }}\n              />\n              <Button\n                variant=\"outline\"\n                onPress={() => onSearchSubmit?.()}\n                className=\"shrink-0\"\n              >\n                Rechercher\n              </Button>\n            </div>\n          ) : null}\n          {children}\n        </div>\n        {right}\n      </div>\n\n      {(activeChips.length > 0 || onClearAll) && (\n        <div className=\"flex flex-wrap items-center gap-2\">\n          {activeChips.map((c) => (\n            <Badge\n              key={c.key}\n              variant=\"secondary\"\n              className=\"inline-flex items-center gap-2\"\n            >\n              <span>{c.label}</span>\n              {c.onRemove && (\n                <button\n                  type=\"button\"\n                  aria-label=\"Supprimer le filtre\"\n                  onClick={c.onRemove}\n                  className=\"hover:bg-muted rounded-xs px-1 text-base\"\n                >\n                  ×\n                </button>\n              )}\n            </Badge>\n          ))}\n          {onClearAll && (\n            <Button size=\"sm\" variant=\"ghost\" onPress={onClearAll}>\n              Effacer les filtres\n            </Button>\n          )}\n        </div>\n      )}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;AAwBA,SAAgB,eAAe,EAC7B,WACA,UACA,OACA,mBACA,aACA,gBACA,gBACA,aAAa,KACb,cAAc,EAAE,EAChB,cACsB;CACtB,MAAM,CAAC,GAAG,QAAQ,MAAM,SAAiB,eAAe,GAAG;AAE3D,OAAM,gBAAgB;AACpB,OAAK,eAAe,GAAG;IACtB,CAAC,YAAY,CAAC;AAEjB,OAAM,gBAAgB;AACpB,MAAI,CAAC,eAAgB;EACrB,MAAM,KAAK,iBAAiB,eAAe,EAAE,EAAE,WAAW;AAC1D,eAAa,aAAa,GAAG;IAC5B;EAAC;EAAG;EAAY;EAAe,CAAC;AAEnC,QACE,qBAAC;EAAI,WAAW,GAAG,aAAa,UAAU;aACxC,qBAAC;GAAI,WAAU;cACb,qBAAC;IAAI,WAAU;eACZ,iBACC,qBAAC;KAAI,WAAU;gBACb,oBAAC;MACC,OAAO;MACP,WAAW,MAAM,KAAK,EAAE,OAAO,MAAM;MACrC,YAAY,MAAM;AAChB,WAAI,EAAE,QAAQ,QAAS,mBAAkB;;MAE3C,aAAa;MACb,UAAU,EAAE,MAAM,UAAU;OAC5B,EACF,oBAAC;MACC,SAAQ;MACR,eAAe,kBAAkB;MACjC,WAAU;gBACX;OAEQ;MACL,GACJ,MACH;KACG,EACL;IACG,GAEJ,YAAY,SAAS,KAAK,eAC1B,qBAAC;GAAI,WAAU;cACZ,YAAY,KAAK,MAChB,qBAAC;IAEC,SAAQ;IACR,WAAU;eAEV,oBAAC,oBAAM,EAAE,QAAa,EACrB,EAAE,YACD,oBAAC;KACC,MAAK;KACL,cAAW;KACX,SAAS,EAAE;KACX,WAAU;eACX;MAEQ;MAbN,EAAE,IAeD,CACR,EACD,cACC,oBAAC;IAAO,MAAK;IAAK,SAAQ;IAAQ,SAAS;cAAY;KAE9C;IAEP;GAEJ"}
+{"version":3,"file":"FiltersToolbar.js","names":[],"sources":["../../../src/components/molecules/FiltersToolbar.tsx"],"sourcesContent":["import * as React from 'react';\nimport { cn } from '@contractspec/lib.ui-kit-web/ui/utils';\nimport { Button, Input } from '../../index';\nimport { Badge } from '@contractspec/lib.ui-kit-web/ui/badge';\n\nexport interface ActiveFilterChip {\n  key: string;\n  label: React.ReactNode;\n  onRemove?: () => void;\n}\n\nexport interface FiltersToolbarProps {\n  className?: string;\n  children?: React.ReactNode;\n  right?: React.ReactNode;\n  searchPlaceholder?: string;\n  searchValue?: string;\n  onSearchChange?: (value: string) => void;\n  onSearchSubmit?: () => void;\n  debounceMs?: number;\n  activeChips?: ActiveFilterChip[];\n  onClearAll?: () => void;\n}\n\nexport function FiltersToolbar({\n  className,\n  children,\n  right,\n  searchPlaceholder,\n  searchValue,\n  onSearchChange,\n  onSearchSubmit,\n  debounceMs = 250,\n  activeChips = [],\n  onClearAll,\n}: FiltersToolbarProps) {\n  const [q, setQ] = React.useState<string>(searchValue ?? '');\n\n  React.useEffect(() => {\n    setQ(searchValue ?? '');\n  }, [searchValue]);\n\n  React.useEffect(() => {\n    if (!onSearchChange) return;\n    const id = setTimeout(() => onSearchChange(q), debounceMs);\n    return () => clearTimeout(id);\n  }, [q, debounceMs, onSearchChange]);\n\n  return (\n    <div className={cn('space-y-2', className)}>\n      <div className=\"flex flex-col items-stretch gap-2 md:flex-row md:items-center md:justify-between\">\n        <div className=\"flex flex-1 items-center gap-2\">\n          {onSearchChange ? (\n            <div className=\"flex flex-1 items-center gap-2\">\n              <Input\n                value={q}\n                onChange={(e) => setQ(e.target.value)}\n                onKeyDown={(e) => {\n                  if (e.key === 'Enter') onSearchSubmit?.();\n                }}\n                placeholder={searchPlaceholder}\n                keyboard={{ kind: 'search' }}\n              />\n              <Button\n                variant=\"outline\"\n                onPress={() => onSearchSubmit?.()}\n                className=\"shrink-0\"\n              >\n                Rechercher\n              </Button>\n            </div>\n          ) : null}\n          {children}\n        </div>\n        {right}\n      </div>\n\n      {(activeChips.length > 0 || onClearAll) && (\n        <div className=\"flex flex-wrap items-center gap-2\">\n          {activeChips.map((c) => (\n            <Badge\n              key={c.key}\n              variant=\"secondary\"\n              className=\"inline-flex items-center gap-2\"\n            >\n              <span>{c.label}</span>\n              {c.onRemove && (\n                <button\n                  type=\"button\"\n                  aria-label=\"Supprimer le filtre\"\n                  onClick={c.onRemove}\n                  className=\"hover:bg-muted rounded-xs px-1 text-base\"\n                >\n                  ×\n                </button>\n              )}\n            </Badge>\n          ))}\n          {onClearAll && (\n            <Button size=\"sm\" variant=\"ghost\" onPress={onClearAll}>\n              Effacer les filtres\n            </Button>\n          )}\n        </div>\n      )}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;AAwBA,SAAgB,eAAe,EAC7B,WACA,UACA,OACA,mBACA,aACA,gBACA,gBACA,aAAa,KACb,cAAc,EAAE,EAChB,cACsB;CACtB,MAAM,CAAC,GAAG,QAAQ,MAAM,SAAiB,eAAe,GAAG;AAE3D,OAAM,gBAAgB;AACpB,OAAK,eAAe,GAAG;IACtB,CAAC,YAAY,CAAC;AAEjB,OAAM,gBAAgB;AACpB,MAAI,CAAC,eAAgB;EACrB,MAAM,KAAK,iBAAiB,eAAe,EAAE,EAAE,WAAW;AAC1D,eAAa,aAAa,GAAG;IAC5B;EAAC;EAAG;EAAY;EAAe,CAAC;AAEnC,QACE,qBAAC;EAAI,WAAW,GAAG,aAAa,UAAU;aACxC,qBAAC;GAAI,WAAU;cACb,qBAAC;IAAI,WAAU;eACZ,iBACC,qBAAC;KAAI,WAAU;gBACb,oBAAC;MACC,OAAO;MACP,WAAW,MAAM,KAAK,EAAE,OAAO,MAAM;MACrC,YAAY,MAAM;AAChB,WAAI,EAAE,QAAQ,QAAS,mBAAkB;;MAE3C,aAAa;MACb,UAAU,EAAE,MAAM,UAAU;OAC5B,EACF,oBAAC;MACC,SAAQ;MACR,eAAe,kBAAkB;MACjC,WAAU;gBACX;OAEQ;MACL,GACJ,MACH;KACG,EACL;IACG,GAEJ,YAAY,SAAS,KAAK,eAC1B,qBAAC;GAAI,WAAU;cACZ,YAAY,KAAK,MAChB,qBAAC;IAEC,SAAQ;IACR,WAAU;eAEV,oBAAC,oBAAM,EAAE,QAAa,EACrB,EAAE,YACD,oBAAC;KACC,MAAK;KACL,cAAW;KACX,SAAS,EAAE;KACX,WAAU;eACX;MAEQ;MAbN,EAAE,IAeD,CACR,EACD,cACC,oBAAC;IAAO,MAAK;IAAK,SAAQ;IAAQ,SAAS;cAAY;KAE9C;IAEP;GAEJ"}

package/dist/components/molecules/HoverPreview.d.ts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import * as react_jsx_runtime50 from "react/jsx-runtime";
+import * as react_jsx_runtime51 from "react/jsx-runtime";
 
 //#region src/components/molecules/HoverPreview.d.ts
 interface HoverPreviewProps {
@@ -15,7 +15,7 @@ declare function HoverPreview({
   align,
   sideOffset,
   className
-}: HoverPreviewProps): react_jsx_runtime50.JSX.Element;
+}: HoverPreviewProps): react_jsx_runtime51.JSX.Element;
 //#endregion
 export { HoverPreview };
 //# sourceMappingURL=HoverPreview.d.ts.map

package/dist/components/molecules/InstallCommand/InstallCommand.d.ts

@@ -0,0 +1,27 @@
+import { InstallCommandProps } from "./types.js";
+import * as react_jsx_runtime114 from "react/jsx-runtime";
+
+//#region src/components/molecules/InstallCommand/InstallCommand.d.ts
+
+/**
+ * Convenience component for displaying package installation commands.
+ * Automatically generates the correct command for each package manager.
+ *
+ * @example
+ * ```tsx
+ * <InstallCommand package="@contractspec/lib.contracts" />
+ * <InstallCommand package={["react", "react-dom"]} />
+ * <InstallCommand package="typescript" dev />
+ * <InstallCommand package="create-next-app" type="exec" />
+ * ```
+ */
+declare function InstallCommand({
+  package: packageName,
+  type,
+  dev,
+  global,
+  ...props
+}: InstallCommandProps): react_jsx_runtime114.JSX.Element;
+//#endregion
+export { InstallCommand };
+//# sourceMappingURL=InstallCommand.d.ts.map

package/dist/components/molecules/InstallCommand/InstallCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstallCommand.d.ts","names":[],"sources":["../../../../src/components/molecules/InstallCommand/InstallCommand.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAwFA;;;;;;;;;iBAAgB,cAAA;WACL;;;;;GAKR,sBAAmB,oBAAA,CAAA,GAAA,CAAA"}

package/dist/components/molecules/InstallCommand/InstallCommand.js

@@ -0,0 +1,68 @@
+'use client';
+
+import { CommandTabs } from "../CommandTabs/CommandTabs.js";
+import { useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/molecules/InstallCommand/InstallCommand.tsx
+function buildCommand(pm, packageNames, type, dev, global) {
+	const packages = packageNames.join(" ");
+	if (type === "exec") switch (pm) {
+		case "bun": return `bunx ${packages}`;
+		case "npm": return `npx ${packages}`;
+		case "yarn": return `yarn dlx ${packages}`;
+		case "pnpm": return `pnpm dlx ${packages}`;
+	}
+	if (type === "create") switch (pm) {
+		case "bun": return `bun create ${packages}`;
+		case "npm": return `npm create ${packages}`;
+		case "yarn": return `yarn create ${packages}`;
+		case "pnpm": return `pnpm create ${packages}`;
+	}
+	if (type === "run") switch (pm) {
+		case "bun": return `bun run ${packages}`;
+		case "npm": return `npm run ${packages}`;
+		case "yarn": return `yarn ${packages}`;
+		case "pnpm": return `pnpm ${packages}`;
+	}
+	const flags = [dev ? pm === "npm" ? "--save-dev" : "-D" : "", global ? "-g" : ""].filter(Boolean).join(" ");
+	switch (pm) {
+		case "bun": return `bun add ${packages}${flags ? ` ${flags}` : ""}`;
+		case "npm": return `npm install ${packages}${flags ? ` ${flags}` : ""}`;
+		case "yarn": return `yarn add ${packages}${flags ? ` ${flags}` : ""}`;
+		case "pnpm": return `pnpm add ${packages}${flags ? ` ${flags}` : ""}`;
+	}
+}
+/**
+* Convenience component for displaying package installation commands.
+* Automatically generates the correct command for each package manager.
+*
+* @example
+* ```tsx
+* <InstallCommand package="@contractspec/lib.contracts" />
+* <InstallCommand package={["react", "react-dom"]} />
+* <InstallCommand package="typescript" dev />
+* <InstallCommand package="create-next-app" type="exec" />
+* ```
+*/
+function InstallCommand({ package: packageName, type = "add", dev = false, global = false, ...props }) {
+	const packageNames = useMemo(() => Array.isArray(packageName) ? packageName : [packageName], [packageName]);
+	return /* @__PURE__ */ jsx(CommandTabs, {
+		commands: useMemo(() => ({
+			bun: buildCommand("bun", packageNames, type, dev, global),
+			npm: buildCommand("npm", packageNames, type, dev, global),
+			yarn: buildCommand("yarn", packageNames, type, dev, global),
+			pnpm: buildCommand("pnpm", packageNames, type, dev, global)
+		}), [
+			packageNames,
+			type,
+			dev,
+			global
+		]),
+		...props
+	});
+}
+
+//#endregion
+export { InstallCommand };
+//# sourceMappingURL=InstallCommand.js.map

package/dist/components/molecules/InstallCommand/InstallCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstallCommand.js","names":[],"sources":["../../../../src/components/molecules/InstallCommand/InstallCommand.tsx"],"sourcesContent":["'use client';\n\nimport { useMemo } from 'react';\nimport { CommandTabs } from '../CommandTabs';\nimport type { PackageManager } from '../CommandTabs/types';\nimport type { InstallCommandProps, InstallCommandType } from './types';\n\nfunction buildCommand(\n  pm: PackageManager,\n  packageNames: string[],\n  type: InstallCommandType,\n  dev: boolean,\n  global: boolean\n): string {\n  const packages = packageNames.join(' ');\n\n  // Handle exec/run commands (npx, bunx, etc.)\n  if (type === 'exec') {\n    switch (pm) {\n      case 'bun':\n        return `bunx ${packages}`;\n      case 'npm':\n        return `npx ${packages}`;\n      case 'yarn':\n        return `yarn dlx ${packages}`;\n      case 'pnpm':\n        return `pnpm dlx ${packages}`;\n    }\n  }\n\n  // Handle create commands\n  if (type === 'create') {\n    switch (pm) {\n      case 'bun':\n        return `bun create ${packages}`;\n      case 'npm':\n        return `npm create ${packages}`;\n      case 'yarn':\n        return `yarn create ${packages}`;\n      case 'pnpm':\n        return `pnpm create ${packages}`;\n    }\n  }\n\n  // Handle run commands\n  if (type === 'run') {\n    switch (pm) {\n      case 'bun':\n        return `bun run ${packages}`;\n      case 'npm':\n        return `npm run ${packages}`;\n      case 'yarn':\n        return `yarn ${packages}`;\n      case 'pnpm':\n        return `pnpm ${packages}`;\n    }\n  }\n\n  // Build flags\n  const devFlag = dev ? (pm === 'npm' ? '--save-dev' : '-D') : '';\n  const globalFlag = global ? '-g' : '';\n  const flags = [devFlag, globalFlag].filter(Boolean).join(' ');\n\n  // Handle add/install commands\n  switch (pm) {\n    case 'bun':\n      return `bun add ${packages}${flags ? ` ${flags}` : ''}`;\n    case 'npm':\n      return `npm install ${packages}${flags ? ` ${flags}` : ''}`;\n    case 'yarn':\n      return `yarn add ${packages}${flags ? ` ${flags}` : ''}`;\n    case 'pnpm':\n      return `pnpm add ${packages}${flags ? ` ${flags}` : ''}`;\n  }\n}\n\n/**\n * Convenience component for displaying package installation commands.\n * Automatically generates the correct command for each package manager.\n *\n * @example\n * ```tsx\n * <InstallCommand package=\"@contractspec/lib.contracts\" />\n * <InstallCommand package={[\"react\", \"react-dom\"]} />\n * <InstallCommand package=\"typescript\" dev />\n * <InstallCommand package=\"create-next-app\" type=\"exec\" />\n * ```\n */\nexport function InstallCommand({\n  package: packageName,\n  type = 'add',\n  dev = false,\n  global = false,\n  ...props\n}: InstallCommandProps) {\n  const packageNames = useMemo(\n    () => (Array.isArray(packageName) ? packageName : [packageName]),\n    [packageName]\n  );\n\n  const commands = useMemo(\n    () => ({\n      bun: buildCommand('bun', packageNames, type, dev, global),\n      npm: buildCommand('npm', packageNames, type, dev, global),\n      yarn: buildCommand('yarn', packageNames, type, dev, global),\n      pnpm: buildCommand('pnpm', packageNames, type, dev, global),\n    }),\n    [packageNames, type, dev, global]\n  );\n\n  return <CommandTabs commands={commands} {...props} />;\n}\n"],"mappings":";;;;;;;AAOA,SAAS,aACP,IACA,cACA,MACA,KACA,QACQ;CACR,MAAM,WAAW,aAAa,KAAK,IAAI;AAGvC,KAAI,SAAS,OACX,SAAQ,IAAR;EACE,KAAK,MACH,QAAO,QAAQ;EACjB,KAAK,MACH,QAAO,OAAO;EAChB,KAAK,OACH,QAAO,YAAY;EACrB,KAAK,OACH,QAAO,YAAY;;AAKzB,KAAI,SAAS,SACX,SAAQ,IAAR;EACE,KAAK,MACH,QAAO,cAAc;EACvB,KAAK,MACH,QAAO,cAAc;EACvB,KAAK,OACH,QAAO,eAAe;EACxB,KAAK,OACH,QAAO,eAAe;;AAK5B,KAAI,SAAS,MACX,SAAQ,IAAR;EACE,KAAK,MACH,QAAO,WAAW;EACpB,KAAK,MACH,QAAO,WAAW;EACpB,KAAK,OACH,QAAO,QAAQ;EACjB,KAAK,OACH,QAAO,QAAQ;;CAOrB,MAAM,QAAQ,CAFE,MAAO,OAAO,QAAQ,eAAe,OAAQ,IAC1C,SAAS,OAAO,GACA,CAAC,OAAO,QAAQ,CAAC,KAAK,IAAI;AAG7D,SAAQ,IAAR;EACE,KAAK,MACH,QAAO,WAAW,WAAW,QAAQ,IAAI,UAAU;EACrD,KAAK,MACH,QAAO,eAAe,WAAW,QAAQ,IAAI,UAAU;EACzD,KAAK,OACH,QAAO,YAAY,WAAW,QAAQ,IAAI,UAAU;EACtD,KAAK,OACH,QAAO,YAAY,WAAW,QAAQ,IAAI,UAAU;;;;;;;;;;;;;;;AAgB1D,SAAgB,eAAe,EAC7B,SAAS,aACT,OAAO,OACP,MAAM,OACN,SAAS,OACT,GAAG,SACmB;CACtB,MAAM,eAAe,cACZ,MAAM,QAAQ,YAAY,GAAG,cAAc,CAAC,YAAY,EAC/D,CAAC,YAAY,CACd;AAYD,QAAO,oBAAC;EAAY,UAVH,eACR;GACL,KAAK,aAAa,OAAO,cAAc,MAAM,KAAK,OAAO;GACzD,KAAK,aAAa,OAAO,cAAc,MAAM,KAAK,OAAO;GACzD,MAAM,aAAa,QAAQ,cAAc,MAAM,KAAK,OAAO;GAC3D,MAAM,aAAa,QAAQ,cAAc,MAAM,KAAK,OAAO;GAC5D,GACD;GAAC;GAAc;GAAM;GAAK;GAAO,CAClC;EAEuC,GAAI;GAAS"}

package/dist/components/molecules/InstallCommand/index.d.ts

@@ -0,0 +1,2 @@
+import { InstallCommandProps, InstallCommandType } from "./types.js";
+import { InstallCommand } from "./InstallCommand.js";

package/dist/components/molecules/InstallCommand/types.d.ts

@@ -0,0 +1,17 @@
+import { HTMLAttributes } from "react";
+
+//#region src/components/molecules/InstallCommand/types.d.ts
+type InstallCommandType = 'add' | 'install' | 'create' | 'run' | 'exec';
+interface InstallCommandProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+  /** The package name(s) to install */
+  package: string | string[];
+  /** The type of command (defaults to 'add' for package installation) */
+  type?: InstallCommandType;
+  /** Whether this is a dev dependency (adds -D flag) */
+  dev?: boolean;
+  /** Whether this is a global installation (adds -g flag) */
+  global?: boolean;
+}
+//#endregion
+export { InstallCommandProps, InstallCommandType };
+//# sourceMappingURL=types.d.ts.map

package/dist/components/molecules/InstallCommand/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/components/molecules/InstallCommand/types.ts"],"sourcesContent":[],"mappings":";;;KAEY,kBAAA;UAEK,mBAAA,SAA4B,KAC3C,eAAe;EAHL;EAEK,OAAA,EAAA,MAAA,GAAA,MAAoB,EAAA;EACpB;EAAf,IAAA,CAAA,EAMO,kBANP;EAMO;EAPoC,GAAA,CAAA,EAAA,OAAA;EAAI"}

package/dist/components/molecules/LangSwitch.d.ts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import * as react_jsx_runtime41 from "react/jsx-runtime";
+import * as react_jsx_runtime42 from "react/jsx-runtime";
 
 //#region src/components/molecules/LangSwitch.d.ts
 interface LangOption {
@@ -17,7 +17,7 @@ declare function LangSwitch({
   options,
   onChange,
   size
-}: LangSwitchProps): react_jsx_runtime41.JSX.Element;
+}: LangSwitchProps): react_jsx_runtime42.JSX.Element;
 //#endregion
 export { LangSwitch, LangSwitchProps };
 //# sourceMappingURL=LangSwitch.d.ts.map

package/dist/components/molecules/LoaderBlock.d.ts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import * as react_jsx_runtime73 from "react/jsx-runtime";
+import * as react_jsx_runtime74 from "react/jsx-runtime";
 
 //#region src/components/molecules/LoaderBlock.d.ts
 interface LoaderBlockProps {
@@ -13,7 +13,7 @@ declare function LoaderBlock({
   description,
   className,
   size
-}: LoaderBlockProps): react_jsx_runtime73.JSX.Element;
+}: LoaderBlockProps): react_jsx_runtime74.JSX.Element;
 //#endregion
 export { LoaderBlock };
 //# sourceMappingURL=LoaderBlock.d.ts.map

package/dist/components/molecules/NavMain.d.ts

@@ -1,5 +1,5 @@
 import { HeaderNavItem } from "../../types/navigation.js";
-import * as react_jsx_runtime17 from "react/jsx-runtime";
+import * as react_jsx_runtime16 from "react/jsx-runtime";
 
 //#region src/components/molecules/NavMain.d.ts
 declare function NavMain({
@@ -8,7 +8,7 @@ declare function NavMain({
 }: {
   items: HeaderNavItem[];
   className?: string;
-}): react_jsx_runtime17.JSX.Element;
+}): react_jsx_runtime16.JSX.Element;
 //#endregion
 export { NavMain };
 //# sourceMappingURL=NavMain.d.ts.map

package/dist/components/molecules/NavUser.d.ts

@@ -1,5 +1,5 @@
 import { UserMenuItem } from "../../types/navigation.js";
-import * as react_jsx_runtime18 from "react/jsx-runtime";
+import * as react_jsx_runtime17 from "react/jsx-runtime";
 
 //#region src/components/molecules/NavUser.d.ts
 declare function NavUser({
@@ -12,7 +12,7 @@ declare function NavUser({
   email?: string;
   imageUrl?: string;
   items: UserMenuItem[];
-}): react_jsx_runtime18.JSX.Element;
+}): react_jsx_runtime17.JSX.Element;
 //#endregion
 export { NavUser };
 //# sourceMappingURL=NavUser.d.ts.map

package/dist/components/molecules/OverviewCard.d.ts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import * as react_jsx_runtime49 from "react/jsx-runtime";
+import * as react_jsx_runtime50 from "react/jsx-runtime";
 
 //#region src/components/molecules/OverviewCard.d.ts
 interface OverviewCardProps {
@@ -15,7 +15,7 @@ declare function OverviewCard({
   href,
   preview,
   ctaLabel
-}: OverviewCardProps): react_jsx_runtime49.JSX.Element;
+}: OverviewCardProps): react_jsx_runtime50.JSX.Element;
 //#endregion
 export { OverviewCard };
 //# sourceMappingURL=OverviewCard.d.ts.map

package/dist/components/molecules/SkeletonBlock/index.web.d.ts

@@ -1,5 +1,5 @@
 import { SkeletonBlockProps } from "./types.js";
-import * as react_jsx_runtime108 from "react/jsx-runtime";
+import * as react_jsx_runtime117 from "react/jsx-runtime";
 
 //#region src/components/molecules/SkeletonBlock/index.web.d.ts
 declare function SkeletonBlock({
@@ -7,7 +7,7 @@ declare function SkeletonBlock({
   h,
   rounded,
   className
-}: SkeletonBlockProps): react_jsx_runtime108.JSX.Element;
+}: SkeletonBlockProps): react_jsx_runtime117.JSX.Element;
 //#endregion
 export { SkeletonBlock };
 //# sourceMappingURL=index.web.d.ts.map

package/dist/components/molecules/SkeletonCircle/index.web.d.ts

@@ -1,12 +1,12 @@
 import { SkeletonCircleProps } from "./types.js";
-import * as react_jsx_runtime109 from "react/jsx-runtime";
+import * as react_jsx_runtime116 from "react/jsx-runtime";
 
 //#region src/components/molecules/SkeletonCircle/index.web.d.ts
 declare function SkeletonCircle({
   size,
   sizeClass,
   className
-}: SkeletonCircleProps): react_jsx_runtime109.JSX.Element;
+}: SkeletonCircleProps): react_jsx_runtime116.JSX.Element;
 //#endregion
 export { SkeletonCircle };
 //# sourceMappingURL=index.web.d.ts.map

package/dist/components/molecules/SkeletonList/index.web.d.ts

@@ -1,11 +1,11 @@
 import { SkeletonListProps } from "./types.js";
-import * as react_jsx_runtime110 from "react/jsx-runtime";
+import * as react_jsx_runtime118 from "react/jsx-runtime";
 
 //#region src/components/molecules/SkeletonList/index.web.d.ts
 declare function SkeletonList({
   count,
   className
-}: SkeletonListProps): react_jsx_runtime110.JSX.Element;
+}: SkeletonListProps): react_jsx_runtime118.JSX.Element;
 //#endregion
 export { SkeletonList };
 //# sourceMappingURL=index.web.d.ts.map

package/dist/components/molecules/StatCard.d.ts

@@ -1,12 +1,12 @@
 import * as React from "react";
-import * as react_jsx_runtime47 from "react/jsx-runtime";
+import * as react_jsx_runtime48 from "react/jsx-runtime";
 import { VariantProps } from "class-variance-authority";
 import { Card } from "@contractspec/lib.ui-kit-web/ui/card";
 import * as class_variance_authority_types8 from "class-variance-authority/types";
 
 //#region src/components/molecules/StatCard.d.ts
 declare const statVariants: (props?: ({
-  emphasis?: "default" | "strong" | "subtle" | null | undefined;
+  emphasis?: "strong" | "default" | "subtle" | null | undefined;
   density?: "compact" | "comfortable" | null | undefined;
 } & class_variance_authority_types8.ClassProp) | undefined) => string;
 type StatCardProps = React.ComponentProps<typeof Card> & VariantProps<typeof statVariants> & {
@@ -24,14 +24,14 @@ declare function StatCard({
   density,
   className,
   ...props
-}: StatCardProps): react_jsx_runtime47.JSX.Element;
+}: StatCardProps): react_jsx_runtime48.JSX.Element;
 declare function StatCardGroup({
   children,
   className
 }: {
   children: React.ReactNode;
   className?: string;
-}): react_jsx_runtime47.JSX.Element;
+}): react_jsx_runtime48.JSX.Element;
 //#endregion
 export { StatCard, StatCardGroup };
 //# sourceMappingURL=StatCard.d.ts.map