@contractspec/lib.design-system 1.44.0

package/dist/components/atoms/LoaderCircular.d.ts

@@ -0,0 +1,23 @@
+import * as React from "react";
+import * as react_jsx_runtime72 from "react/jsx-runtime";
+import { VariantProps } from "class-variance-authority";
+import * as class_variance_authority_types14 from "class-variance-authority/types";
+
+//#region src/components/atoms/LoaderCircular.d.ts
+declare const spinnerVariants: (props?: ({
+  size?: "sm" | "md" | "lg" | null | undefined;
+  tone?: "default" | "muted" | null | undefined;
+} & class_variance_authority_types14.ClassProp) | undefined) => string;
+type LoaderCircularProps = React.HTMLAttributes<HTMLDivElement> & VariantProps<typeof spinnerVariants> & {
+  label?: React.ReactNode;
+};
+declare function LoaderCircular({
+  size,
+  tone,
+  label,
+  className,
+  ...props
+}: LoaderCircularProps): react_jsx_runtime72.JSX.Element;
+//#endregion
+export { LoaderCircular };
+//# sourceMappingURL=LoaderCircular.d.ts.map

package/dist/components/atoms/LoaderCircular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoaderCircular.d.ts","names":[],"sources":["../../../src/components/atoms/LoaderCircular.tsx"],"sourcesContent":[],"mappings":";;;;;;cAKM;;;IAaJ,gCAAA,CAAA;AAbI,KAeM,mBAAA,GAAsB,KAAA,CAAM,cAFtC,CAEqD,cAFrD,CAAA,GAGA,YAHA,CAAA,OAGoB,eAHpB,CAAA,GAAA;EAEU,KAAA,CAAA,EAEA,KAAA,CAAM,SAFa;CAAwB;AAAf,iBAKxB,cAAA,CALwB;EAAA,IAAA;EAAA,IAAA;EAAA,KAAA;EAAA,SAAA;EAAA,GAAA;AAAA,CAAA,EAWrC,mBAXqC,CAAA,EAWlB,mBAAA,CAAA,GAAA,CAAA,OAXkB"}

package/dist/components/atoms/LoaderCircular.js

@@ -0,0 +1,44 @@
+import "react";
+import { Loader2 } from "lucide-react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { cva } from "class-variance-authority";
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+
+//#region src/components/atoms/LoaderCircular.tsx
+const spinnerVariants = cva("animate-spin", {
+	variants: {
+		size: {
+			sm: "h-4 w-4",
+			md: "h-5 w-5",
+			lg: "h-6 w-6"
+		},
+		tone: {
+			default: "text-foreground",
+			muted: "text-muted-foreground"
+		}
+	},
+	defaultVariants: {
+		size: "md",
+		tone: "muted"
+	}
+});
+function LoaderCircular({ size, tone, label, className, ...props }) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: cn("inline-flex items-center gap-2", className),
+		role: "status",
+		"aria-live": "polite",
+		"aria-busy": true,
+		...props,
+		children: [/* @__PURE__ */ jsx(Loader2, { className: cn(spinnerVariants({
+			size,
+			tone
+		})) }), label ? /* @__PURE__ */ jsx("span", {
+			className: "text-muted-foreground text-base",
+			children: label
+		}) : null]
+	});
+}
+
+//#endregion
+export { LoaderCircular };
+//# sourceMappingURL=LoaderCircular.js.map

package/dist/components/atoms/LoaderCircular.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoaderCircular.js","names":[],"sources":["../../../src/components/atoms/LoaderCircular.tsx"],"sourcesContent":["import * as React from 'react';\nimport { Loader2 } from 'lucide-react';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { cn } from '@contractspec/lib.ui-kit-web/ui/utils';\n\nconst spinnerVariants = cva('animate-spin', {\n  variants: {\n    size: {\n      sm: 'h-4 w-4',\n      md: 'h-5 w-5',\n      lg: 'h-6 w-6',\n    },\n    tone: {\n      default: 'text-foreground',\n      muted: 'text-muted-foreground',\n    },\n  },\n  defaultVariants: { size: 'md', tone: 'muted' },\n});\n\nexport type LoaderCircularProps = React.HTMLAttributes<HTMLDivElement> &\n  VariantProps<typeof spinnerVariants> & {\n    label?: React.ReactNode;\n  };\n\nexport function LoaderCircular({\n  size,\n  tone,\n  label,\n  className,\n  ...props\n}: LoaderCircularProps) {\n  return (\n    <div\n      className={cn('inline-flex items-center gap-2', className)}\n      role=\"status\"\n      aria-live=\"polite\"\n      aria-busy\n      {...props}\n    >\n      <Loader2 className={cn(spinnerVariants({ size, tone }))} />\n      {label ? (\n        <span className=\"text-muted-foreground text-base\">{label}</span>\n      ) : null}\n    </div>\n  );\n}\n\nexport default LoaderCircular;\n"],"mappings":";;;;;;;AAKA,MAAM,kBAAkB,IAAI,gBAAgB;CAC1C,UAAU;EACR,MAAM;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACL;EACD,MAAM;GACJ,SAAS;GACT,OAAO;GACR;EACF;CACD,iBAAiB;EAAE,MAAM;EAAM,MAAM;EAAS;CAC/C,CAAC;AAOF,SAAgB,eAAe,EAC7B,MACA,MACA,OACA,WACA,GAAG,SACmB;AACtB,QACE,qBAAC;EACC,WAAW,GAAG,kCAAkC,UAAU;EAC1D,MAAK;EACL,aAAU;EACV;EACA,GAAI;aAEJ,oBAAC,WAAQ,WAAW,GAAG,gBAAgB;GAAE;GAAM;GAAM,CAAC,CAAC,GAAI,EAC1D,QACC,oBAAC;GAAK,WAAU;aAAmC;IAAa,GAC9D;GACA"}

package/dist/components/atoms/NavBrand.d.ts

@@ -0,0 +1,19 @@
+import * as React from "react";
+import * as react_jsx_runtime42 from "react/jsx-runtime";
+
+//#region src/components/atoms/NavBrand.d.ts
+interface NavBrandProps {
+  href?: string;
+  logo?: React.ReactNode;
+  title?: React.ReactNode;
+  className?: string;
+}
+declare function NavBrand({
+  href,
+  logo,
+  title,
+  className
+}: NavBrandProps): react_jsx_runtime42.JSX.Element;
+//#endregion
+export { NavBrand };
+//# sourceMappingURL=NavBrand.d.ts.map

package/dist/components/atoms/NavBrand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavBrand.d.ts","names":[],"sources":["../../../src/components/atoms/NavBrand.tsx"],"sourcesContent":[],"mappings":";;;;UAKiB,aAAA;;SAER,KAAA,CAAM;EAFE,KAAA,CAAA,EAGP,KAAA,CAAM,SAHc;EAOd,SAAA,CAAA,EAAQ,MAAA;;AAEtB,iBAFc,QAAA,CAEd;EAAA,IAAA;EAAA,IAAA;EAAA,KAAA;EAAA;AAAA,CAAA,EAGC,aAHD,CAAA,EAGc,mBAAA,CAAA,GAAA,CAAA,OAHd"}

package/dist/components/atoms/NavBrand.js

@@ -0,0 +1,26 @@
+'use client';
+
+import "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+
+//#region src/components/atoms/NavBrand.tsx
+function NavBrand({ href = "/", logo, title, className }) {
+	const content = /* @__PURE__ */ jsxs("div", {
+		className: cn("flex items-center gap-2 truncate font-semibold", className),
+		children: [logo, title && /* @__PURE__ */ jsx("span", {
+			className: "truncate text-xl font-bold",
+			children: title
+		})]
+	});
+	return href ? /* @__PURE__ */ jsx("a", {
+		href,
+		className: "flex items-center",
+		"aria-label": "Home",
+		children: content
+	}) : content;
+}
+
+//#endregion
+export { NavBrand };
+//# sourceMappingURL=NavBrand.js.map

package/dist/components/atoms/NavBrand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavBrand.js","names":[],"sources":["../../../src/components/atoms/NavBrand.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { cn } from '@contractspec/lib.ui-kit-web/ui/utils';\n\nexport interface NavBrandProps {\n  href?: string;\n  logo?: React.ReactNode;\n  title?: React.ReactNode;\n  className?: string;\n}\n\nexport function NavBrand({\n  href = '/',\n  logo,\n  title,\n  className,\n}: NavBrandProps) {\n  const content = (\n    <div\n      className={cn(\n        'flex items-center gap-2 truncate font-semibold',\n        className\n      )}\n    >\n      {logo}\n      {title && <span className=\"truncate text-xl font-bold\">{title}</span>}\n    </div>\n  );\n  return href ? (\n    <a href={href} className=\"flex items-center\" aria-label=\"Home\">\n      {content}\n    </a>\n  ) : (\n    content\n  );\n}\n"],"mappings":";;;;;;;AAYA,SAAgB,SAAS,EACvB,OAAO,KACP,MACA,OACA,aACgB;CAChB,MAAM,UACJ,qBAAC;EACC,WAAW,GACT,kDACA,UACD;aAEA,MACA,SAAS,oBAAC;GAAK,WAAU;aAA8B;IAAa;GACjE;AAER,QAAO,OACL,oBAAC;EAAQ;EAAM,WAAU;EAAoB,cAAW;YACrD;GACC,GAEJ"}

package/dist/components/atoms/Stepper.d.ts

@@ -0,0 +1,8 @@
+import * as react_jsx_runtime6 from "react/jsx-runtime";
+import { StepperProps } from "@contractspec/lib.ui-kit-web/ui/stepper";
+
+//#region src/components/atoms/Stepper.d.ts
+declare function Stepper$1(props: StepperProps): react_jsx_runtime6.JSX.Element;
+//#endregion
+export { Stepper$1 as Stepper };
+//# sourceMappingURL=Stepper.d.ts.map

package/dist/components/atoms/Stepper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stepper.d.ts","names":[],"sources":["../../../src/components/atoms/Stepper.tsx"],"sourcesContent":[],"mappings":";;;;iBAQgB,SAAA,QAAe,eAAY,kBAAA,CAAA,GAAA,CAAA"}

package/dist/components/atoms/Stepper.js

@@ -0,0 +1,14 @@
+'use client';
+
+import "react";
+import { jsx } from "react/jsx-runtime";
+import { Stepper } from "@contractspec/lib.ui-kit-web/ui/stepper";
+
+//#region src/components/atoms/Stepper.tsx
+function Stepper$1(props) {
+	return /* @__PURE__ */ jsx(Stepper, { ...props });
+}
+
+//#endregion
+export { Stepper$1 as Stepper };
+//# sourceMappingURL=Stepper.js.map

package/dist/components/atoms/Stepper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stepper.js","names":["Stepper","WebStepper"],"sources":["../../../src/components/atoms/Stepper.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport {\n  Stepper as WebStepper,\n  type StepperProps,\n} from '@contractspec/lib.ui-kit-web/ui/stepper';\n\nexport function Stepper(props: StepperProps) {\n  return <WebStepper {...props} />;\n}\n"],"mappings":";;;;;;;AAQA,SAAgBA,UAAQ,OAAqB;AAC3C,QAAO,oBAACC,WAAW,GAAI,QAAS"}

package/dist/components/atoms/Textarea.d.ts

@@ -0,0 +1,38 @@
+import { KeyboardOptions } from "../../lib/keyboard.js";
+import * as react_jsx_runtime4 from "react/jsx-runtime";
+import { TextareaProps } from "@contractspec/lib.ui-kit-web/ui/textarea";
+
+//#region src/components/atoms/Textarea.d.ts
+interface BaseFieldProps {
+  value?: string;
+  defaultValue?: string;
+  placeholder?: string;
+  disabled?: boolean;
+  readOnly?: boolean;
+  maxLength?: number;
+  name?: string;
+  className?: string;
+  rows?: number;
+  keyboard?: KeyboardOptions;
+}
+type TextareaProps$1 = TextareaProps & BaseFieldProps;
+declare function Textarea$1({
+  value,
+  defaultValue,
+  onChange,
+  onSubmit,
+  onFocus,
+  onBlur,
+  placeholder,
+  disabled,
+  readOnly,
+  maxLength,
+  name,
+  className,
+  rows,
+  keyboard,
+  ...rest
+}: TextareaProps$1): react_jsx_runtime4.JSX.Element;
+//#endregion
+export { Textarea$1 as Textarea };
+//# sourceMappingURL=Textarea.d.ts.map

package/dist/components/atoms/Textarea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Textarea.d.ts","names":[],"sources":["../../../src/components/atoms/Textarea.tsx"],"sourcesContent":[],"mappings":";;;;;UAOU,cAAA;;;EAAA,WAAA,CAAA,EAAA,MAAc;EAiBZ,QAAA,CAAA,EAAA,OAAa;EAQT,QAAA,CAAA,EAAA,OAAQ;EACtB,SAAA,CAAA,EAAA,MAAA;EACA,IAAA,CAAA,EAAA,MAAA;EACA,SAAA,CAAA,EAAA,MAAA;EACA,IAAA,CAAA,EAAA,MAAA;EACA,QAAA,CAAA,EAhBW,eAgBX;;AAEA,KAfU,eAAA,GAAgB,aAe1B,GAf6C,cAe7C;AACA,iBARc,UAAA,CAQd;EAAA,KAAA;EAAA,YAAA;EAAA,QAAA;EAAA,QAAA;EAAA,OAAA;EAAA,MAAA;EAAA,WAAA;EAAA,QAAA;EAAA,QAAA;EAAA,SAAA;EAAA,IAAA;EAAA,SAAA;EAAA,IAAA;EAAA,QAAA;EAAA,GAAA;AAAA,CAAA,EAQC,eARD,CAAA,EAQc,kBAAA,CAAA,GAAA,CAAA,OARd"}

package/dist/components/atoms/Textarea.js

@@ -0,0 +1,36 @@
+import { mapKeyboardToWeb } from "../../lib/keyboard.js";
+import * as React from "react";
+import { jsx } from "react/jsx-runtime";
+import { Textarea } from "@contractspec/lib.ui-kit-web/ui/textarea";
+
+//#region src/components/atoms/Textarea.tsx
+function Textarea$1({ value, defaultValue, onChange, onSubmit, onFocus, onBlur, placeholder, disabled, readOnly, maxLength, name, className, rows, keyboard, ...rest }) {
+	const webKeyboard = mapKeyboardToWeb(keyboard);
+	const handleChange = React.useCallback((e) => onChange?.(e), [onChange]);
+	const handleKeyDown = React.useCallback((e) => {
+		if (e.key === "Enter" && webKeyboard.type !== "search") {
+			if (e.metaKey || e.ctrlKey) onSubmit?.(e);
+		}
+	}, [onSubmit, webKeyboard.type]);
+	return /* @__PURE__ */ jsx(Textarea, {
+		...rest,
+		className,
+		value,
+		defaultValue,
+		onChange: handleChange,
+		onKeyDown: handleKeyDown,
+		onFocus,
+		onBlur,
+		placeholder,
+		disabled,
+		readOnly,
+		maxLength,
+		name,
+		rows,
+		...webKeyboard
+	});
+}
+
+//#endregion
+export { Textarea$1 as Textarea };
+//# sourceMappingURL=Textarea.js.map

package/dist/components/atoms/Textarea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Textarea.js","names":["Textarea","WebTextarea"],"sources":["../../../src/components/atoms/Textarea.tsx"],"sourcesContent":["import * as React from 'react';\nimport {\n  Textarea as WebTextarea,\n  type TextareaProps as WebTextareaProps,\n} from '@contractspec/lib.ui-kit-web/ui/textarea';\nimport { type KeyboardOptions, mapKeyboardToWeb } from '../../lib/keyboard';\n\ninterface BaseFieldProps {\n  value?: string;\n  defaultValue?: string;\n  // onChange?: (text: string) => void;\n  // onSubmit?: () => void;\n  // onFocus?: () => void;\n  // onBlur?: () => void;\n  placeholder?: string;\n  disabled?: boolean;\n  readOnly?: boolean;\n  maxLength?: number;\n  name?: string;\n  className?: string;\n  rows?: number;\n  keyboard?: KeyboardOptions;\n}\n\nexport type TextareaProps = WebTextareaProps & BaseFieldProps;\n\n// export type TextareaProps = Omit<\n//   WebTextareaProps,\n//   // 'onChange' | 'value' | 'defaultValue'\n// > &\n//   BaseFieldProps;\n\nexport function Textarea({\n  value,\n  defaultValue,\n  onChange,\n  onSubmit,\n  onFocus,\n  onBlur,\n  placeholder,\n  disabled,\n  readOnly,\n  maxLength,\n  name,\n  className,\n  rows,\n  keyboard,\n  ...rest\n}: TextareaProps) {\n  const webKeyboard = mapKeyboardToWeb(keyboard);\n\n  const handleChange = React.useCallback<\n    React.ChangeEventHandler<HTMLTextAreaElement>\n  >((e) => onChange?.(e), [onChange]);\n\n  const handleKeyDown = React.useCallback<\n    React.KeyboardEventHandler<HTMLTextAreaElement>\n  >(\n    (e) => {\n      if (e.key === 'Enter' && webKeyboard.type !== 'search') {\n        // For textarea, Enter inserts newline; onSubmit could be used with modifier\n        if (e.metaKey || e.ctrlKey) onSubmit?.(e);\n      }\n    },\n    [onSubmit, webKeyboard.type]\n  );\n\n  return (\n    <WebTextarea\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      {...(rest as any)}\n      className={className}\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      value={value as any}\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      defaultValue={defaultValue as any}\n      onChange={handleChange}\n      onKeyDown={handleKeyDown}\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      onFocus={onFocus as any}\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      onBlur={onBlur as any}\n      placeholder={placeholder}\n      disabled={disabled}\n      readOnly={readOnly}\n      maxLength={maxLength}\n      name={name}\n      rows={rows}\n      {...webKeyboard}\n    />\n  );\n}\n\nexport default Textarea;\n"],"mappings":";;;;;;AAgCA,SAAgBA,WAAS,EACvB,OACA,cACA,UACA,UACA,SACA,QACA,aACA,UACA,UACA,WACA,MACA,WACA,MACA,UACA,GAAG,QACa;CAChB,MAAM,cAAc,iBAAiB,SAAS;CAE9C,MAAM,eAAe,MAAM,aAExB,MAAM,WAAW,EAAE,EAAE,CAAC,SAAS,CAAC;CAEnC,MAAM,gBAAgB,MAAM,aAGzB,MAAM;AACL,MAAI,EAAE,QAAQ,WAAW,YAAY,SAAS,UAE5C;OAAI,EAAE,WAAW,EAAE,QAAS,YAAW,EAAE;;IAG7C,CAAC,UAAU,YAAY,KAAK,CAC7B;AAED,QACE,oBAACC;EAEC,GAAK;EACM;EAEJ;EAEO;EACd,UAAU;EACV,WAAW;EAEF;EAED;EACK;EACH;EACA;EACC;EACL;EACA;EACN,GAAI;GACJ"}

package/dist/components/data-view/DataViewDetail.d.ts

@@ -0,0 +1,22 @@
+import * as React from "react";
+import * as react_jsx_runtime107 from "react/jsx-runtime";
+import { DataViewSpec } from "@contractspec/lib.contracts/data-views";
+
+//#region src/components/data-view/DataViewDetail.d.ts
+interface DataViewDetailProps {
+  spec: DataViewSpec;
+  item: Record<string, unknown> | null;
+  className?: string;
+  emptyState?: React.ReactNode;
+  headerActions?: React.ReactNode;
+}
+declare function DataViewDetail({
+  spec,
+  item,
+  className,
+  emptyState,
+  headerActions
+}: DataViewDetailProps): react_jsx_runtime107.JSX.Element;
+//#endregion
+export { DataViewDetail };
+//# sourceMappingURL=DataViewDetail.d.ts.map

package/dist/components/data-view/DataViewDetail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataViewDetail.d.ts","names":[],"sources":["../../../src/components/data-view/DataViewDetail.tsx"],"sourcesContent":[],"mappings":";;;;;UAWiB,mBAAA;QACT;QACA;EAFS,SAAA,CAAA,EAAA,MAAA;EACT,UAAA,CAAA,EAGO,KAAA,CAAM,SAHb;EACA,aAAA,CAAA,EAGU,KAAA,CAAM,SAHhB;;AAGgB,iBAGR,cAAA,CAHQ;EAAA,IAAA;EAAA,IAAA;EAAA,SAAA;EAAA,UAAA;EAAA;AAAA,CAAA,EASrB,mBATqB,CAAA,EASF,oBAAA,CAAA,GAAA,CAAA,OATE"}

package/dist/components/data-view/DataViewDetail.js

@@ -0,0 +1,80 @@
+'use client';
+
+import { cn } from "../../lib/utils.js";
+import { formatValue, getAtPath } from "./utils.js";
+import "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/data-view/DataViewDetail.tsx
+function DataViewDetail({ spec, item, className, emptyState, headerActions }) {
+	if (spec.view.kind !== "detail") throw new Error(`DataViewDetail received view kind "${spec.view.kind}", expected "detail".`);
+	const view = spec.view;
+	const fields = view.fields;
+	if (!item) return /* @__PURE__ */ jsxs("div", {
+		className: cn("flex w-full flex-col gap-4", className),
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "flex items-center justify-between",
+			children: [/* @__PURE__ */ jsx("h3", {
+				className: "text-foreground text-base font-semibold",
+				children: spec.meta.title
+			}), headerActions]
+		}), emptyState ?? /* @__PURE__ */ jsx("div", {
+			className: "border-muted-foreground/40 text-muted-foreground rounded-md border border-dashed p-8 text-center text-sm",
+			children: "Select a record to view details."
+		})]
+	});
+	const sections = view.sections && view.sections.length > 0 ? view.sections : [{ fields: fields.map((field) => field.key) }];
+	return /* @__PURE__ */ jsxs("div", {
+		className: cn("flex w-full flex-col gap-6", className),
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "flex items-center justify-between",
+			children: [/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("h3", {
+				className: "text-foreground text-xl font-semibold",
+				children: spec.meta.title
+			}), /* @__PURE__ */ jsx("p", {
+				className: "text-muted-foreground text-sm",
+				children: spec.meta.description
+			})] }), headerActions]
+		}), /* @__PURE__ */ jsx("div", {
+			className: "flex flex-col gap-6",
+			children: sections.map((section, idx) => /* @__PURE__ */ jsxs("div", {
+				className: "border-border bg-card rounded-lg border p-4 shadow-sm",
+				children: [
+					section.title ? /* @__PURE__ */ jsx("h4", {
+						className: "text-muted-foreground mb-2 text-sm font-semibold tracking-wide uppercase",
+						children: section.title
+					}) : null,
+					section.description ? /* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground mb-4 text-sm",
+						children: section.description
+					}) : null,
+					/* @__PURE__ */ jsx("dl", {
+						className: "grid gap-4 md:grid-cols-2",
+						children: section.fields.map((fieldKey) => {
+							const field = fieldByKey(fields, fieldKey);
+							if (!field) return null;
+							const value = getAtPath(item, field.dataPath);
+							return /* @__PURE__ */ jsxs("div", {
+								className: "flex flex-col gap-1",
+								children: [/* @__PURE__ */ jsx("dt", {
+									className: "text-muted-foreground/80 text-xs font-semibold uppercase",
+									children: field.label
+								}), /* @__PURE__ */ jsx("dd", {
+									className: "text-foreground text-sm",
+									children: formatValue(value, field.format)
+								})]
+							}, field.key);
+						})
+					})
+				]
+			}, idx))
+		})]
+	});
+}
+function fieldByKey(fields, key) {
+	return fields.find((field) => field.key === key);
+}
+
+//#endregion
+export { DataViewDetail };
+//# sourceMappingURL=DataViewDetail.js.map

package/dist/components/data-view/DataViewDetail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataViewDetail.js","names":[],"sources":["../../../src/components/data-view/DataViewDetail.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport type {\n  DataViewSpec,\n  DataViewDetailConfig,\n  DataViewField,\n} from '@contractspec/lib.contracts/data-views';\nimport { cn } from '../../lib/utils';\nimport { getAtPath, formatValue } from './utils';\n\nexport interface DataViewDetailProps {\n  spec: DataViewSpec;\n  item: Record<string, unknown> | null;\n  className?: string;\n  emptyState?: React.ReactNode;\n  headerActions?: React.ReactNode;\n}\n\nexport function DataViewDetail({\n  spec,\n  item,\n  className,\n  emptyState,\n  headerActions,\n}: DataViewDetailProps) {\n  if (spec.view.kind !== 'detail') {\n    throw new Error(\n      `DataViewDetail received view kind \"${spec.view.kind}\", expected \"detail\".`\n    );\n  }\n\n  const view = spec.view as DataViewDetailConfig;\n  const fields = view.fields;\n\n  if (!item) {\n    return (\n      <div className={cn('flex w-full flex-col gap-4', className)}>\n        <div className=\"flex items-center justify-between\">\n          <h3 className=\"text-foreground text-base font-semibold\">\n            {spec.meta.title}\n          </h3>\n          {headerActions}\n        </div>\n        {emptyState ?? (\n          <div className=\"border-muted-foreground/40 text-muted-foreground rounded-md border border-dashed p-8 text-center text-sm\">\n            Select a record to view details.\n          </div>\n        )}\n      </div>\n    );\n  }\n\n  const sections =\n    view.sections && view.sections.length > 0\n      ? view.sections\n      : [{ fields: fields.map((field) => field.key) }];\n\n  return (\n    <div className={cn('flex w-full flex-col gap-6', className)}>\n      <div className=\"flex items-center justify-between\">\n        <div>\n          <h3 className=\"text-foreground text-xl font-semibold\">\n            {spec.meta.title}\n          </h3>\n          <p className=\"text-muted-foreground text-sm\">\n            {spec.meta.description}\n          </p>\n        </div>\n        {headerActions}\n      </div>\n      <div className=\"flex flex-col gap-6\">\n        {sections.map((section, idx) => (\n          <div\n            key={idx}\n            className=\"border-border bg-card rounded-lg border p-4 shadow-sm\"\n          >\n            {section.title ? (\n              <h4 className=\"text-muted-foreground mb-2 text-sm font-semibold tracking-wide uppercase\">\n                {section.title}\n              </h4>\n            ) : null}\n            {section.description ? (\n              <p className=\"text-muted-foreground mb-4 text-sm\">\n                {section.description}\n              </p>\n            ) : null}\n            <dl className=\"grid gap-4 md:grid-cols-2\">\n              {section.fields.map((fieldKey) => {\n                const field = fieldByKey(fields, fieldKey);\n                if (!field) return null;\n                const value = getAtPath(item, field.dataPath);\n                return (\n                  <div key={field.key} className=\"flex flex-col gap-1\">\n                    <dt className=\"text-muted-foreground/80 text-xs font-semibold uppercase\">\n                      {field.label}\n                    </dt>\n                    <dd className=\"text-foreground text-sm\">\n                      {formatValue(value, field.format)}\n                    </dd>\n                  </div>\n                );\n              })}\n            </dl>\n          </div>\n        ))}\n      </div>\n    </div>\n  );\n}\n\nfunction fieldByKey(fields: DataViewField[], key: string) {\n  return fields.find((field) => field.key === key);\n}\n"],"mappings":";;;;;;;;AAmBA,SAAgB,eAAe,EAC7B,MACA,MACA,WACA,YACA,iBACsB;AACtB,KAAI,KAAK,KAAK,SAAS,SACrB,OAAM,IAAI,MACR,sCAAsC,KAAK,KAAK,KAAK,uBACtD;CAGH,MAAM,OAAO,KAAK;CAClB,MAAM,SAAS,KAAK;AAEpB,KAAI,CAAC,KACH,QACE,qBAAC;EAAI,WAAW,GAAG,8BAA8B,UAAU;aACzD,qBAAC;GAAI,WAAU;cACb,oBAAC;IAAG,WAAU;cACX,KAAK,KAAK;KACR,EACJ;IACG,EACL,cACC,oBAAC;GAAI,WAAU;aAA2G;IAEpH;GAEJ;CAIV,MAAM,WACJ,KAAK,YAAY,KAAK,SAAS,SAAS,IACpC,KAAK,WACL,CAAC,EAAE,QAAQ,OAAO,KAAK,UAAU,MAAM,IAAI,EAAE,CAAC;AAEpD,QACE,qBAAC;EAAI,WAAW,GAAG,8BAA8B,UAAU;aACzD,qBAAC;GAAI,WAAU;cACb,qBAAC,oBACC,oBAAC;IAAG,WAAU;cACX,KAAK,KAAK;KACR,EACL,oBAAC;IAAE,WAAU;cACV,KAAK,KAAK;KACT,IACA,EACL;IACG,EACN,oBAAC;GAAI,WAAU;aACZ,SAAS,KAAK,SAAS,QACtB,qBAAC;IAEC,WAAU;;KAET,QAAQ,QACP,oBAAC;MAAG,WAAU;gBACX,QAAQ;OACN,GACH;KACH,QAAQ,cACP,oBAAC;MAAE,WAAU;gBACV,QAAQ;OACP,GACF;KACJ,oBAAC;MAAG,WAAU;gBACX,QAAQ,OAAO,KAAK,aAAa;OAChC,MAAM,QAAQ,WAAW,QAAQ,SAAS;AAC1C,WAAI,CAAC,MAAO,QAAO;OACnB,MAAM,QAAQ,UAAU,MAAM,MAAM,SAAS;AAC7C,cACE,qBAAC;QAAoB,WAAU;mBAC7B,oBAAC;SAAG,WAAU;mBACX,MAAM;UACJ,EACL,oBAAC;SAAG,WAAU;mBACX,YAAY,OAAO,MAAM,OAAO;UAC9B;UANG,MAAM,IAOV;QAER;OACC;;MA7BA,IA8BD,CACN;IACE;GACF;;AAIV,SAAS,WAAW,QAAyB,KAAa;AACxD,QAAO,OAAO,MAAM,UAAU,MAAM,QAAQ,IAAI"}

package/dist/components/data-view/DataViewList.d.ts

@@ -0,0 +1,24 @@
+import * as React from "react";
+import * as react_jsx_runtime105 from "react/jsx-runtime";
+import { DataViewSpec } from "@contractspec/lib.contracts/data-views";
+
+//#region src/components/data-view/DataViewList.d.ts
+interface DataViewListProps {
+  spec: DataViewSpec;
+  items: Record<string, unknown>[];
+  className?: string;
+  renderActions?: (item: Record<string, unknown>) => React.ReactNode;
+  onSelect?: (item: Record<string, unknown>) => void;
+  emptyState?: React.ReactNode;
+}
+declare function DataViewList({
+  spec,
+  items,
+  className,
+  renderActions,
+  onSelect,
+  emptyState
+}: DataViewListProps): react_jsx_runtime105.JSX.Element;
+//#endregion
+export { DataViewList };
+//# sourceMappingURL=DataViewList.d.ts.map

package/dist/components/data-view/DataViewList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataViewList.d.ts","names":[],"sources":["../../../src/components/data-view/DataViewList.tsx"],"sourcesContent":[],"mappings":";;;;;UAWiB,iBAAA;QACT;SACC;EAFQ,SAAA,CAAA,EAAA,MAAA;EACT,aAAA,CAAA,EAAA,CAAA,IAAA,EAGiB,MAHjB,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAG6C,KAAA,CAAM,SAHnD;EACC,QAAA,CAAA,EAAA,CAAA,IAAA,EAGW,MAHX,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAAA;EAEgB,UAAA,CAAA,EAEV,KAAA,CAAM,SAFI;;AACL,iBAIJ,YAAA,CAJI;EAAA,IAAA;EAAA,KAAA;EAAA,SAAA;EAAA,aAAA;EAAA,QAAA;EAAA;AAAA,CAAA,EAWjB,iBAXiB,CAAA,EAWA,oBAAA,CAAA,GAAA,CAAA,OAXA"}

package/dist/components/data-view/DataViewList.js

@@ -0,0 +1,67 @@
+'use client';
+
+import { cn } from "../../lib/utils.js";
+import { formatValue, getAtPath } from "./utils.js";
+import "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/data-view/DataViewList.tsx
+function DataViewList({ spec, items, className, renderActions, onSelect, emptyState }) {
+	if (spec.view.kind !== "list") throw new Error(`DataViewList received view kind "${spec.view.kind}", expected "list".`);
+	const view = spec.view;
+	const fields = view.fields;
+	const primaryField = view.primaryField ?? fields.find((field) => field.key === view.primaryField)?.key ?? fields[0]?.key;
+	if (!items.length) return /* @__PURE__ */ jsx("div", {
+		className: cn("flex w-full flex-col gap-4", className),
+		children: emptyState ?? /* @__PURE__ */ jsx("div", {
+			className: "border-muted-foreground/40 text-muted-foreground rounded-md border border-dashed p-8 text-center text-sm",
+			children: "No records available."
+		})
+	});
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("flex w-full flex-col gap-4", className),
+		children: items.map((item, idx) => /* @__PURE__ */ jsxs("button", {
+			type: "button",
+			className: cn("border-muted bg-card hover:border-primary/40 focus-visible:border-primary focus-visible:ring-primary/40 flex w-full flex-col gap-2 rounded-lg border p-4 text-left shadow-sm transition hover:shadow-md focus-visible:ring-2 focus-visible:outline-none", view.layout === "compact" && "md:flex-row md:items-center md:gap-4"),
+			onClick: () => onSelect?.(item),
+			children: [/* @__PURE__ */ jsxs("div", {
+				className: "flex flex-1 flex-col gap-1",
+				children: [primaryField ? /* @__PURE__ */ jsx("span", {
+					className: "text-foreground text-base font-medium",
+					children: displayValue(item, fields, primaryField)
+				}) : null, /* @__PURE__ */ jsx("div", {
+					className: "text-muted-foreground flex flex-wrap gap-x-4 gap-y-1 text-sm",
+					children: secondaryFieldKeys(view, primaryField).map((fieldKey) => /* @__PURE__ */ jsxs("span", {
+						className: "flex items-center gap-1.5",
+						children: [/* @__PURE__ */ jsx("span", {
+							className: "text-foreground/80 font-medium",
+							children: fieldLabel(fields, fieldKey)
+						}), /* @__PURE__ */ jsx("span", { children: displayValue(item, fields, fieldKey) })]
+					}, fieldKey))
+				})]
+			}), renderActions ? /* @__PURE__ */ jsx("div", {
+				className: "flex shrink-0 items-center gap-2",
+				children: renderActions(item)
+			}) : null]
+		}, idx))
+	});
+}
+function fieldLabel(fields, key) {
+	return fields.find((field) => field.key === key)?.label ?? key;
+}
+function fieldByKey(fields, key) {
+	return fields.find((field) => field.key === key);
+}
+function displayValue(item, fields, key) {
+	const field = fieldByKey(fields, key);
+	if (!field) return "";
+	return formatValue(getAtPath(item, field.dataPath), field.format);
+}
+function secondaryFieldKeys(view, primaryField) {
+	if (view.secondaryFields?.length) return view.secondaryFields;
+	return view.fields.map((field) => field.key).filter((key) => key !== primaryField);
+}
+
+//#endregion
+export { DataViewList };
+//# sourceMappingURL=DataViewList.js.map

package/dist/components/data-view/DataViewList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataViewList.js","names":[],"sources":["../../../src/components/data-view/DataViewList.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport type {\n  DataViewSpec,\n  DataViewListConfig,\n  DataViewField,\n} from '@contractspec/lib.contracts/data-views';\nimport { cn } from '../../lib/utils';\nimport { getAtPath, formatValue } from './utils';\n\nexport interface DataViewListProps {\n  spec: DataViewSpec;\n  items: Record<string, unknown>[];\n  className?: string;\n  renderActions?: (item: Record<string, unknown>) => React.ReactNode;\n  onSelect?: (item: Record<string, unknown>) => void;\n  emptyState?: React.ReactNode;\n}\n\nexport function DataViewList({\n  spec,\n  items,\n  className,\n  renderActions,\n  onSelect,\n  emptyState,\n}: DataViewListProps) {\n  if (spec.view.kind !== 'list') {\n    throw new Error(\n      `DataViewList received view kind \"${spec.view.kind}\", expected \"list\".`\n    );\n  }\n  const view = spec.view as DataViewListConfig;\n  const fields = view.fields;\n  const primaryField =\n    view.primaryField ??\n    fields.find((field) => field.key === view.primaryField)?.key ??\n    fields[0]?.key;\n\n  if (!items.length) {\n    return (\n      <div className={cn('flex w-full flex-col gap-4', className)}>\n        {emptyState ?? (\n          <div className=\"border-muted-foreground/40 text-muted-foreground rounded-md border border-dashed p-8 text-center text-sm\">\n            No records available.\n          </div>\n        )}\n      </div>\n    );\n  }\n\n  return (\n    <div className={cn('flex w-full flex-col gap-4', className)}>\n      {items.map((item, idx) => (\n        <button\n          type=\"button\"\n          key={idx}\n          className={cn(\n            'border-muted bg-card hover:border-primary/40 focus-visible:border-primary focus-visible:ring-primary/40 flex w-full flex-col gap-2 rounded-lg border p-4 text-left shadow-sm transition hover:shadow-md focus-visible:ring-2 focus-visible:outline-none',\n            view.layout === 'compact' && 'md:flex-row md:items-center md:gap-4'\n          )}\n          onClick={() => onSelect?.(item)}\n        >\n          <div className=\"flex flex-1 flex-col gap-1\">\n            {primaryField ? (\n              <span className=\"text-foreground text-base font-medium\">\n                {displayValue(item, fields, primaryField)}\n              </span>\n            ) : null}\n            <div className=\"text-muted-foreground flex flex-wrap gap-x-4 gap-y-1 text-sm\">\n              {secondaryFieldKeys(view, primaryField).map((fieldKey) => (\n                <span key={fieldKey} className=\"flex items-center gap-1.5\">\n                  <span className=\"text-foreground/80 font-medium\">\n                    {fieldLabel(fields, fieldKey)}\n                  </span>\n                  <span>{displayValue(item, fields, fieldKey)}</span>\n                </span>\n              ))}\n            </div>\n          </div>\n          {renderActions ? (\n            <div className=\"flex shrink-0 items-center gap-2\">\n              {renderActions(item)}\n            </div>\n          ) : null}\n        </button>\n      ))}\n    </div>\n  );\n}\n\nfunction fieldLabel(fields: DataViewField[], key: string) {\n  return fields.find((field) => field.key === key)?.label ?? key;\n}\n\nfunction fieldByKey(fields: DataViewField[], key?: string) {\n  return fields.find((field) => field.key === key);\n}\n\nfunction displayValue(\n  item: Record<string, unknown>,\n  fields: DataViewField[],\n  key: string\n) {\n  const field = fieldByKey(fields, key);\n  if (!field) return '';\n  const value = getAtPath(item, field.dataPath);\n  return formatValue(value, field.format);\n}\n\nfunction secondaryFieldKeys(view: DataViewListConfig, primaryField?: string) {\n  if (view.secondaryFields?.length) return view.secondaryFields;\n  return view.fields\n    .map((field) => field.key)\n    .filter((key) => key !== primaryField);\n}\n"],"mappings":";;;;;;;;AAoBA,SAAgB,aAAa,EAC3B,MACA,OACA,WACA,eACA,UACA,cACoB;AACpB,KAAI,KAAK,KAAK,SAAS,OACrB,OAAM,IAAI,MACR,oCAAoC,KAAK,KAAK,KAAK,qBACpD;CAEH,MAAM,OAAO,KAAK;CAClB,MAAM,SAAS,KAAK;CACpB,MAAM,eACJ,KAAK,gBACL,OAAO,MAAM,UAAU,MAAM,QAAQ,KAAK,aAAa,EAAE,OACzD,OAAO,IAAI;AAEb,KAAI,CAAC,MAAM,OACT,QACE,oBAAC;EAAI,WAAW,GAAG,8BAA8B,UAAU;YACxD,cACC,oBAAC;GAAI,WAAU;aAA2G;IAEpH;GAEJ;AAIV,QACE,oBAAC;EAAI,WAAW,GAAG,8BAA8B,UAAU;YACxD,MAAM,KAAK,MAAM,QAChB,qBAAC;GACC,MAAK;GAEL,WAAW,GACT,2PACA,KAAK,WAAW,aAAa,uCAC9B;GACD,eAAe,WAAW,KAAK;cAE/B,qBAAC;IAAI,WAAU;eACZ,eACC,oBAAC;KAAK,WAAU;eACb,aAAa,MAAM,QAAQ,aAAa;MACpC,GACL,MACJ,oBAAC;KAAI,WAAU;eACZ,mBAAmB,MAAM,aAAa,CAAC,KAAK,aAC3C,qBAAC;MAAoB,WAAU;iBAC7B,oBAAC;OAAK,WAAU;iBACb,WAAW,QAAQ,SAAS;QACxB,EACP,oBAAC,oBAAM,aAAa,MAAM,QAAQ,SAAS,GAAQ;QAJ1C,SAKJ,CACP;MACE;KACF,EACL,gBACC,oBAAC;IAAI,WAAU;cACZ,cAAc,KAAK;KAChB,GACJ;KA5BC,IA6BE,CACT;GACE;;AAIV,SAAS,WAAW,QAAyB,KAAa;AACxD,QAAO,OAAO,MAAM,UAAU,MAAM,QAAQ,IAAI,EAAE,SAAS;;AAG7D,SAAS,WAAW,QAAyB,KAAc;AACzD,QAAO,OAAO,MAAM,UAAU,MAAM,QAAQ,IAAI;;AAGlD,SAAS,aACP,MACA,QACA,KACA;CACA,MAAM,QAAQ,WAAW,QAAQ,IAAI;AACrC,KAAI,CAAC,MAAO,QAAO;AAEnB,QAAO,YADO,UAAU,MAAM,MAAM,SAAS,EACnB,MAAM,OAAO;;AAGzC,SAAS,mBAAmB,MAA0B,cAAuB;AAC3E,KAAI,KAAK,iBAAiB,OAAQ,QAAO,KAAK;AAC9C,QAAO,KAAK,OACT,KAAK,UAAU,MAAM,IAAI,CACzB,QAAQ,QAAQ,QAAQ,aAAa"}

package/dist/components/data-view/DataViewRenderer.d.ts

@@ -0,0 +1,48 @@
+import * as React from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { DataViewSpec } from "@contractspec/lib.contracts/data-views";
+
+//#region src/components/data-view/DataViewRenderer.d.ts
+interface DataViewRendererProps {
+  spec: DataViewSpec;
+  items?: Record<string, unknown>[];
+  item?: Record<string, unknown> | null;
+  className?: string;
+  renderActions?: (item: Record<string, unknown>) => React.ReactNode;
+  onSelect?: (item: Record<string, unknown>) => void;
+  onRowClick?: (item: Record<string, unknown>) => void;
+  headerActions?: React.ReactNode;
+  emptyState?: React.ReactNode;
+  footer?: React.ReactNode;
+  search?: string;
+  onSearchChange?: (value: string) => void;
+  filters?: Record<string, unknown>;
+  onFilterChange?: (filters: Record<string, unknown>) => void;
+  pagination?: {
+    page: number;
+    pageSize: number;
+    total: number;
+  };
+  onPageChange?: (page: number) => void;
+}
+declare function DataViewRenderer({
+  spec,
+  items,
+  item,
+  className,
+  renderActions,
+  onSelect,
+  onRowClick,
+  headerActions,
+  emptyState,
+  footer,
+  search,
+  onSearchChange,
+  filters,
+  onFilterChange,
+  pagination,
+  onPageChange
+}: DataViewRendererProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DataViewRenderer };
+//# sourceMappingURL=DataViewRenderer.d.ts.map

package/dist/components/data-view/DataViewRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataViewRenderer.d.ts","names":[],"sources":["../../../src/components/data-view/DataViewRenderer.tsx"],"sourcesContent":[],"mappings":";;;;;UAqBiB,qBAAA;QACT;UACE;EAFO,IAAA,CAAA,EAGR,MAHQ,CAAA,MAAA,EAAA,OAAqB,CAAA,GAAA,IAAA;EAC9B,SAAA,CAAA,EAAA,MAAA;EACE,aAAA,CAAA,EAAA,CAAA,IAAA,EAGe,MAHf,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAG2C,KAAA,CAAM,SAHjD;EACD,QAAA,CAAA,EAAA,CAAA,IAAA,EAGW,MAHX,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAAA;EAEgB,UAAA,CAAA,EAAA,CAAA,IAAA,EAEH,MAFG,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAAA;EAA4B,aAAM,CAAA,EAGzC,KAAA,CAAM,SAHmC;EACvC,UAAA,CAAA,EAGL,KAAA,CAAM,SAHD;EACE,MAAA,CAAA,EAGX,KAAA,CAAM,SAHK;EACJ,MAAM,CAAA,EAAA,MAAA;EACT,cAAM,CAAA,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EACV,OAAM,CAAA,EAKL,MALK,CAAA,MAAA,EAAA,OAAA,CAAA;EAKL,cAAA,CAAA,EAAA,CAAA,OAAA,EACiB,MADjB,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAAA;EACiB,UAAA,CAAA,EAAA;IAAM,IAAA,EAAA,MAAA;IAWnB,QAAA,EAAA,MAAgB;IAC9B,KAAA,EAAA,MAAA;EACA,CAAA;EACA,YAAA,CAAA,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GAAA,IAAA;;AAEA,iBALc,gBAAA,CAKd;EAAA,IAAA;EAAA,KAAA;EAAA,IAAA;EAAA,SAAA;EAAA,aAAA;EAAA,QAAA;EAAA,UAAA;EAAA,aAAA;EAAA,UAAA;EAAA,MAAA;EAAA,MAAA;EAAA,cAAA;EAAA,OAAA;EAAA,cAAA;EAAA,UAAA;EAAA;AAAA,CAAA,EAYC,qBAZD,CAAA,EAYsB,kBAAA,CAAA,GAAA,CAAA,OAZtB"}