@devalok/shilp-sutra 0.51.0 → 0.53.0

package/AGENTS.md

@@ -20,7 +20,7 @@ If you are a human, read [README.md](./README.md) instead.
 
 ## How to get details, in priority order
 
-1. **shilp-sutra MCP** — version-exact answers as JSON, cheapest on context. Hosted at `https://shilp-sutra.devalok.in/mcp` (connect it if it isn't already; it beats reading the frozen docs in `node_modules`). The tool surface is listed under "MCP tools" below. Always pass the consumer's installed version (from `node_modules/@devalok/shilp-sutra/package.json`) as `version`.
+1. **shilp-sutra MCP** — version-exact answers as JSON, cheapest on context. Hosted at `https://shilp-sutra.devalok.in/mcp`. On install the package writes a project-scoped `.mcp.json` declaring this server, so your client (Claude Code / Cursor / Codex) should prompt you to approve it — approve it. If it is not wired yet, add it in one command: `claude mcp add --transport http shilp-sutra https://shilp-sutra.devalok.in/mcp` (or the equivalent in your agent). It beats reading the frozen docs in `node_modules`. The tool surface is listed under "MCP tools" below. Always pass the consumer's installed version (from `node_modules/@devalok/shilp-sutra/package.json`) as `version`.
 2. **`packages/core/llms.txt`** — the ~3K-token router: what exists + where to get detail. Load this by default; it is deliberately tiny.
 3. **`packages/core/docs/components/<tier>/<name>.md`** — single-component doc (~3K tokens: props, examples, composability, gotchas). Read ONLY the components you're using — never bulk-read the directory or concatenate these.
 4. **`packages/core/mcp-manifest.json`** — everything machine-readable (props, tokens, composition; react-docgen shape). Prefer targeted reads over prose when you need structured data without the MCP.

package/MIGRATION.md

@@ -4,6 +4,18 @@ This page indexes all breaking changes across `@devalok/shilp-sutra` versions. F
 
 > **Upgrading from < 0.36?** Start here, then read each intermediate version section. Breaking changes stack — skipping versions means stacking migrations.
 
+## v0.53.0 — additive (no migration required)
+
+Nothing breaks at the TypeScript level; this release is additive.
+
+> Auto-stubbed by `version-packages` so the release audit's MIGRATION-section gate can't block. If any behavioral or visual change needs consumer action, replace this stub with the specifics on the Version Packages PR before publishing.
+
+## v0.52.0 — additive (no migration required)
+
+Nothing breaks at the TypeScript level; this release is additive.
+
+> Auto-stubbed by `version-packages` so the release audit's MIGRATION-section gate can't block. If any behavioral or visual change needs consumer action, replace this stub with the specifics on the Version Packages PR before publishing.
+
 ## v0.51.0 — additive (no migration required)
 
 Nothing breaks at the TypeScript level; this release is additive.

package/dist/_chunks/motion-provider.js

@@ -4,11 +4,7 @@ import * as n from "react";
 import { jsx as r } from "react/jsx-runtime";
 import { MotionConfig as i, useReducedMotion as a } from "framer-motion";
 //#region src/motion/motion-provider.tsx
-var o = n.createContext({
-	springs: e,
-	tweens: t,
-	reducedMotion: !1
-});
+var o = n.createContext(null);
 function s({ children: s, reducedMotion: c = "user" }) {
 	let l = a() ?? !1, u = c === "user" ? l : c, d = n.useMemo(() => ({
 		springs: e,
@@ -24,7 +20,12 @@ function s({ children: s, reducedMotion: c = "user" }) {
 	});
 }
 function c() {
-	return n.useContext(o);
+	let r = n.useContext(o), i = a() ?? !1;
+	return r || {
+		springs: e,
+		tweens: t,
+		reducedMotion: i
+	};
 }
 //#endregion
 export { s as MotionProvider, c as useMotion };

package/dist/_chunks/motion-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"motion-provider.js","names":[],"sources":["../../src/motion/motion-provider.tsx"],"sourcesContent":["'use client'\n\nimport { MotionConfig, useReducedMotion as useFMReducedMotion } from 'framer-motion'\nimport * as React from 'react'\n\nimport { springs, tweens } from '../ui/lib/motion'\n\ntype ReducedMotionMode = 'user' | boolean\n\ntype MotionContextValue = {\n  springs: typeof springs\n  tweens: typeof tweens\n  reducedMotion: boolean\n}\n\nconst MotionContext = React.createContext<MotionContextValue>({\n  springs,\n  tweens,\n  reducedMotion: false,\n})\n\ntype MotionProviderProps = {\n  children: React.ReactNode\n  /** 'user' = detect OS preference, true = force off, false = force on */\n  reducedMotion?: ReducedMotionMode\n}\n\nfunction MotionProvider({ children, reducedMotion = 'user' }: MotionProviderProps) {\n  const osPreference = useFMReducedMotion() ?? false\n  const isReduced = reducedMotion === 'user' ? osPreference : reducedMotion\n\n  const value = React.useMemo<MotionContextValue>(\n    () => ({ springs, tweens, reducedMotion: isReduced }),\n    [isReduced],\n  )\n\n  return (\n    <MotionContext.Provider value={value}>\n      <MotionConfig reducedMotion={reducedMotion === 'user' ? 'user' : reducedMotion ? 'always' : 'never'}>\n        {children}\n      </MotionConfig>\n    </MotionContext.Provider>\n  )\n}\n\nfunction useMotion() {\n  return React.useContext(MotionContext)\n}\n\nexport { MotionProvider, type MotionProviderProps,useMotion }\n"],"mappings":";;;;;AAeA,IAAM,IAAgB,EAAM,cAAkC;CAC5D;CACA;CACA,eAAe;AACjB,CAAC;AAQD,SAAS,EAAe,EAAE,aAAU,mBAAgB,UAA+B;CACjF,IAAM,IAAe,EAAmB,KAAK,IACvC,IAAY,MAAkB,SAAS,IAAe,GAEtD,IAAQ,EAAM,eACX;EAAE;EAAS;EAAQ,eAAe;CAAU,IACnD,CAAC,CAAS,CACZ;CAEA,OACE,kBAAC,EAAc,UAAf;EAA+B;YAC7B,kBAAC,GAAD;GAAc,eAAe,MAAkB,SAAS,SAAS,IAAgB,WAAW;GACzF;EACW,CAAA;CACQ,CAAA;AAE5B;AAEA,SAAS,IAAY;CACnB,OAAO,EAAM,WAAW,CAAa;AACvC"}
+{"version":3,"file":"motion-provider.js","names":[],"sources":["../../src/motion/motion-provider.tsx"],"sourcesContent":["'use client'\n\nimport { MotionConfig, useReducedMotion as useFMReducedMotion } from 'framer-motion'\nimport * as React from 'react'\n\nimport { springs, tweens } from '../ui/lib/motion'\n\ntype ReducedMotionMode = 'user' | boolean\n\ntype MotionContextValue = {\n  springs: typeof springs\n  tweens: typeof tweens\n  reducedMotion: boolean\n}\n\n// `null` default = \"no MotionProvider mounted\". `useMotion()` detects this and\n// falls back to the OS `prefers-reduced-motion` setting, so components respect\n// reduced motion out of the box — a provider is an override, not a requirement.\nconst MotionContext = React.createContext<MotionContextValue | null>(null)\n\ntype MotionProviderProps = {\n  children: React.ReactNode\n  /** 'user' = detect OS preference, true = force off, false = force on */\n  reducedMotion?: ReducedMotionMode\n}\n\nfunction MotionProvider({ children, reducedMotion = 'user' }: MotionProviderProps) {\n  const osPreference = useFMReducedMotion() ?? false\n  const isReduced = reducedMotion === 'user' ? osPreference : reducedMotion\n\n  const value = React.useMemo<MotionContextValue>(\n    () => ({ springs, tweens, reducedMotion: isReduced }),\n    [isReduced],\n  )\n\n  return (\n    <MotionContext.Provider value={value}>\n      <MotionConfig reducedMotion={reducedMotion === 'user' ? 'user' : reducedMotion ? 'always' : 'never'}>\n        {children}\n      </MotionConfig>\n    </MotionContext.Provider>\n  )\n}\n\nfunction useMotion(): MotionContextValue {\n  const ctx = React.useContext(MotionContext)\n  // Always called (hook order stable); only used when no provider is mounted.\n  const osPreference = useFMReducedMotion() ?? false\n  if (ctx) return ctx\n  return { springs, tweens, reducedMotion: osPreference }\n}\n\nexport { MotionProvider, type MotionProviderProps,useMotion }\n"],"mappings":";;;;;AAkBA,IAAM,IAAgB,EAAM,cAAyC,IAAI;AAQzE,SAAS,EAAe,EAAE,aAAU,mBAAgB,UAA+B;CACjF,IAAM,IAAe,EAAmB,KAAK,IACvC,IAAY,MAAkB,SAAS,IAAe,GAEtD,IAAQ,EAAM,eACX;EAAE;EAAS;EAAQ,eAAe;CAAU,IACnD,CAAC,CAAS,CACZ;CAEA,OACE,kBAAC,EAAc,UAAf;EAA+B;YAC7B,kBAAC,GAAD;GAAc,eAAe,MAAkB,SAAS,SAAS,IAAgB,WAAW;GACzF;EACW,CAAA;CACQ,CAAA;AAE5B;AAEA,SAAS,IAAgC;CACvC,IAAM,IAAM,EAAM,WAAW,CAAa,GAEpC,IAAe,EAAmB,KAAK;CAE7C,OADI,KACG;EAAE;EAAS;EAAQ,eAAe;CAAa;AACxD"}

package/dist/_chunks/success.js

@@ -3,14 +3,14 @@ import { durations as e, springs as t, tweens as n } from "../ui/lib/motion.js";
 import { cn as r } from "../ui/lib/utils.js";
 import { Icon as i } from "../ui/icon.js";
 import { Alert as a } from "../ui/alert.js";
-import { Skeleton as o } from "../ui/skeleton.js";
-import { BadgeCompound as s } from "./badge-group.js";
-import { Button as c } from "../ui/button.js";
-import { Collapsible as l, CollapsibleContent as u, CollapsibleTrigger as d } from "../ui/collapsible.js";
-import { Table as f, TableBody as p, TableCaption as m, TableCell as h, TableHead as g, TableHeader as _, TableRow as v } from "../ui/table.js";
-import { Separator as y } from "../ui/separator.js";
-import { StatCard as b } from "../ui/stat-card.js";
-import { useMotion as x } from "./motion-provider.js";
+import { useMotion as o } from "./motion-provider.js";
+import { Skeleton as s } from "../ui/skeleton.js";
+import { BadgeCompound as c } from "./badge-group.js";
+import { Button as l } from "../ui/button.js";
+import { Collapsible as u, CollapsibleContent as d, CollapsibleTrigger as f } from "../ui/collapsible.js";
+import { Table as p, TableBody as m, TableCaption as h, TableCell as g, TableHead as _, TableHeader as v, TableRow as y } from "../ui/table.js";
+import { Separator as b } from "../ui/separator.js";
+import { StatCard as x } from "../ui/stat-card.js";
 import { BlockShell as S } from "./block-shell.js";
 import * as C from "react";
 import { jsx as w, jsxs as T } from "react/jsx-runtime";
@@ -21,14 +21,14 @@ function A(e, t) {
 	if (t.variant === "badge") {
 		if (e && typeof e == "object" && "label" in e) {
 			let t = e;
-			return /* @__PURE__ */ w(s, {
+			return /* @__PURE__ */ w(c, {
 				variant: "subtle",
 				size: "sm",
 				color: t.color,
 				children: t.label
 			});
 		}
-		return /* @__PURE__ */ w(s, {
+		return /* @__PURE__ */ w(c, {
 			variant: "subtle",
 			size: "sm",
 			children: String(e ?? "")
@@ -45,38 +45,38 @@ function j(e, t, n) {
 	});
 }
 var M = C.memo(function({ data: e, confidence: n }) {
-	let { reducedMotion: i } = x(), [a, o] = C.useState(null), [s, c] = C.useState(null), l = C.useCallback((t) => {
-		e.sortable && (a === t ? s === "asc" ? c("desc") : s === "desc" && (o(null), c(null)) : (o(t), c("asc")));
+	let { reducedMotion: i } = o(), [a, s] = C.useState(null), [c, l] = C.useState(null), u = C.useCallback((t) => {
+		e.sortable && (a === t ? c === "asc" ? l("desc") : c === "desc" && (s(null), l(null)) : (s(t), l("asc")));
 	}, [
 		e.sortable,
 		a,
-		s
-	]), u = e.columns ?? [], d = j(e.rows ?? [], a, s);
+		c
+	]), d = e.columns ?? [], f = j(e.rows ?? [], a, c);
 	return /* @__PURE__ */ w(S, {
 		confidence: n,
 		className: "overflow-x-auto",
-		children: /* @__PURE__ */ T(f, { children: [
-			e.caption && /* @__PURE__ */ w(m, { children: e.caption }),
-			/* @__PURE__ */ w(_, { children: /* @__PURE__ */ w(v, { children: u.map((t) => {
-				let n = a === t.key, i = e.sortable ? n ? s === "asc" ? "ascending" : "descending" : "none" : void 0;
-				return /* @__PURE__ */ w(g, {
+		children: /* @__PURE__ */ T(p, { children: [
+			e.caption && /* @__PURE__ */ w(h, { children: e.caption }),
+			/* @__PURE__ */ w(v, { children: /* @__PURE__ */ w(y, { children: d.map((t) => {
+				let n = a === t.key, i = e.sortable ? n ? c === "asc" ? "ascending" : "descending" : "none" : void 0;
+				return /* @__PURE__ */ w(_, {
 					role: "columnheader",
 					className: r(t.variant === "number" && "text-right", e.sortable && "cursor-pointer select-none"),
 					tabIndex: e.sortable ? 0 : void 0,
-					onClick: e.sortable ? () => l(t.key) : void 0,
+					onClick: e.sortable ? () => u(t.key) : void 0,
 					onKeyDown: e.sortable ? (e) => {
-						(e.key === "Enter" || e.key === " ") && (e.preventDefault(), l(t.key));
+						(e.key === "Enter" || e.key === " ") && (e.preventDefault(), u(t.key));
 					} : void 0,
 					"aria-sort": i,
 					children: /* @__PURE__ */ T("span", {
 						className: "inline-flex items-center gap-1",
 						children: [
 							t.label,
-							n && s === "asc" && /* @__PURE__ */ w("span", {
+							n && c === "asc" && /* @__PURE__ */ w("span", {
 								"aria-hidden": "true",
 								children: "▲"
 							}),
-							n && s === "desc" && /* @__PURE__ */ w("span", {
+							n && c === "desc" && /* @__PURE__ */ w("span", {
 								"aria-hidden": "true",
 								children: "▼"
 							})
@@ -84,7 +84,7 @@ var M = C.memo(function({ data: e, confidence: n }) {
 					})
 				}, t.key);
 			}) }) }),
-			/* @__PURE__ */ w(p, { children: d.map((e, n) => {
+			/* @__PURE__ */ w(m, { children: f.map((e, n) => {
 				let a = typeof e.id == "string" || typeof e.id == "number" ? String(e.id) : `row-${n}`;
 				return /* @__PURE__ */ w(i ? "tr" : k.tr, {
 					className: "hover:bg-surface-raised-hover transition-colors",
@@ -102,7 +102,7 @@ var M = C.memo(function({ data: e, confidence: n }) {
 							delay: n * .03
 						}
 					},
-					children: u.map((t) => /* @__PURE__ */ w(h, {
+					children: d.map((t) => /* @__PURE__ */ w(g, {
 						className: r("text-body-sm py-ds-02b px-ds-04", t.variant === "number" && "text-right tabular-nums font-medium"),
 						children: A(e[t.key], t)
 					}, t.key))
@@ -129,27 +129,27 @@ var N = C.memo(function({ data: e, confidence: t, onAction: n }) {
 			}),
 			/* @__PURE__ */ T("div", {
 				className: "flex items-center gap-3",
-				children: [/* @__PURE__ */ w(c, {
+				children: [/* @__PURE__ */ w(l, {
 					variant: "solid",
 					color: e.destructive ? "error" : void 0,
 					onClick: r,
 					children: e.label
-				}), /* @__PURE__ */ w(c, {
+				}), /* @__PURE__ */ w(l, {
 					variant: "ghost",
 					onClick: i,
 					children: "Cancel"
 				})]
 			}),
-			e.rationale && /* @__PURE__ */ T(l, {
+			e.rationale && /* @__PURE__ */ T(u, {
 				className: "mt-3",
-				children: [/* @__PURE__ */ w(d, {
+				children: [/* @__PURE__ */ w(f, {
 					asChild: !0,
 					children: /* @__PURE__ */ w("button", {
 						type: "button",
 						className: "text-caption text-surface-fg-subtle underline cursor-pointer",
 						children: "Why this action?"
 					})
-				}), /* @__PURE__ */ w(u, { children: /* @__PURE__ */ w("p", {
+				}), /* @__PURE__ */ w(d, { children: /* @__PURE__ */ w("p", {
 					className: "text-body-sm text-surface-fg-muted mt-2 p-3 bg-surface-raised rounded-surface",
 					children: e.rationale
 				}) })]
@@ -161,13 +161,13 @@ N.displayName = "ConfirmBlock";
 //#endregion
 //#region src/ai/blocks/divider.tsx
 var P = C.memo(function(e) {
-	let { reducedMotion: t } = x();
-	return t ? /* @__PURE__ */ w(y, {}) : /* @__PURE__ */ w(k.div, {
+	let { reducedMotion: t } = o();
+	return t ? /* @__PURE__ */ w(b, {}) : /* @__PURE__ */ w(k.div, {
 		initial: { scaleX: 0 },
 		animate: { scaleX: 1 },
 		style: { originX: .5 },
 		transition: n.elegant,
-		children: /* @__PURE__ */ w(y, {})
+		children: /* @__PURE__ */ w(b, {})
 	});
 });
 P.displayName = "DividerBlock";
@@ -227,7 +227,7 @@ function L({ status: e }) {
 	}
 }
 var R = C.memo(function({ data: t }) {
-	let { reducedMotion: n } = x(), i = n;
+	let { reducedMotion: n } = o(), i = n;
 	if (t.lines != null) {
 		let e = Math.max(1, t.lines);
 		return /* @__PURE__ */ T("div", {
@@ -235,7 +235,7 @@ var R = C.memo(function({ data: t }) {
 			"aria-busy": "true",
 			"aria-label": "Loading",
 			className: "flex flex-col gap-2",
-			children: [Array.from({ length: e }).map((t, n) => /* @__PURE__ */ w(o, {
+			children: [Array.from({ length: e }).map((t, n) => /* @__PURE__ */ w(s, {
 				animation: "shimmer",
 				className: r("h-4", n === e - 1 ? "w-3/5" : "w-full")
 			}, n)), /* @__PURE__ */ w("span", {
@@ -285,7 +285,7 @@ R.displayName = "LoadingBlock";
 //#endregion
 //#region src/ai/blocks/stat-row.tsx
 var z = C.memo(function({ data: e }) {
-	let { reducedMotion: n } = x(), r = e.stats ?? [];
+	let { reducedMotion: n } = o(), r = e.stats ?? [];
 	return r.length === 0 ? null : /* @__PURE__ */ w("div", {
 		className: "flex flex-wrap gap-ds-05",
 		children: r.map((e, r) => {
@@ -295,7 +295,7 @@ var z = C.memo(function({ data: e }) {
 			} : void 0;
 			return n ? /* @__PURE__ */ w("div", {
 				className: "flex-1 min-w-[140px]",
-				children: /* @__PURE__ */ w(b, {
+				children: /* @__PURE__ */ w(x, {
 					label: e.label,
 					value: e.value,
 					delta: i
@@ -311,7 +311,7 @@ var z = C.memo(function({ data: e }) {
 					...t.responsive,
 					delay: r * .08
 				},
-				children: /* @__PURE__ */ w(b, {
+				children: /* @__PURE__ */ w(x, {
 					label: e.label,
 					value: e.value,
 					delta: i
@@ -324,20 +324,20 @@ z.displayName = "StatRowBlock";
 //#endregion
 //#region src/ai/blocks/success.tsx
 var B = 5e3, V = C.memo(function({ data: e, blockId: t, confidence: n, onAction: r }) {
-	let { reducedMotion: i } = x(), o = i, s = e.undoTimeout ?? B, [l, u] = C.useState(s), [d, f] = C.useState(!!e.undoable);
+	let { reducedMotion: i } = o(), s = i, c = e.undoTimeout ?? B, [u, d] = C.useState(c), [f, p] = C.useState(!!e.undoable);
 	C.useEffect(() => {
 		if (!e.undoable) return;
 		let t = setInterval(() => {
-			u((e) => {
+			d((e) => {
 				let n = e - 100;
-				return n <= 0 ? (clearInterval(t), f(!1), 0) : n;
+				return n <= 0 ? (clearInterval(t), p(!1), 0) : n;
 			});
 		}, 100);
 		return () => clearInterval(t);
-	}, [e.undoable, s]);
-	let p = C.useCallback(() => {
+	}, [e.undoable, c]);
+	let m = C.useCallback(() => {
 		r?.(t || "unknown", "undo");
-	}, [t, r]), m = Math.ceil(l / 1e3), h = 2 * Math.PI * 9;
+	}, [t, r]), h = Math.ceil(u / 1e3), g = 2 * Math.PI * 9;
 	return /* @__PURE__ */ T(S, {
 		confidence: n,
 		children: [/* @__PURE__ */ w(a, {
@@ -345,13 +345,13 @@ var B = 5e3, V = C.memo(function({ data: e, blockId: t, confidence: n, onAction:
 			variant: "subtle",
 			title: e.title,
 			children: e.message
-		}), d && e.undoable && /* @__PURE__ */ w("div", {
+		}), f && e.undoable && /* @__PURE__ */ w("div", {
 			className: "mt-2 flex items-center gap-2",
-			children: /* @__PURE__ */ w(c, {
+			children: /* @__PURE__ */ w(l, {
 				variant: "ghost",
 				size: "sm",
-				onClick: p,
-				"aria-label": `Undo action, ${m} seconds remaining`,
+				onClick: m,
+				"aria-label": `Undo action, ${h} seconds remaining`,
 				children: /* @__PURE__ */ T("span", {
 					className: "flex items-center gap-1.5",
 					children: [/* @__PURE__ */ T("svg", {
@@ -375,11 +375,11 @@ var B = 5e3, V = C.memo(function({ data: e, blockId: t, confidence: n, onAction:
 							fill: "none",
 							stroke: "currentColor",
 							strokeWidth: 2,
-							strokeDasharray: h,
-							initial: o ? void 0 : { strokeDashoffset: 0 },
-							animate: { strokeDashoffset: h },
-							transition: o ? { duration: 0 } : {
-								duration: s / 1e3,
+							strokeDasharray: g,
+							initial: s ? void 0 : { strokeDashoffset: 0 },
+							animate: { strokeDashoffset: g },
+							transition: s ? { duration: 0 } : {
+								duration: c / 1e3,
 								ease: "linear"
 							}
 						})]