@devalok/shilp-sutra 0.37.0 → 0.38.0

package/llms.txt

@@ -4,6 +4,30 @@
 > Built on the same primitives as shadcn/ui but with key API differences.
 > Read this file BEFORE writing any UI code. Do NOT guess from shadcn/ui knowledge.
 
+## QUICK SETUP (AI agents — start here)
+
+If you are setting up shilp-sutra in a consumer project for the first time, **do not improvise**. Use a recipe.
+
+When the package is installed, recipes ship at `node_modules/@devalok/shilp-sutra/docs/recipes/`. Pick one based on the consumer's framework:
+
+| Framework | Recipe file |
+|---|---|
+| Next.js (App Router) | `install-next-app-router.md` |
+| Next.js (Pages Router) | `install-next-pages.md` |
+| Vite + React | `install-vite.md` |
+| Astro | `install-astro.md` |
+| Remix | `install-remix.md` |
+| TanStack Start | `install-tanstack-start.md` |
+| Other React + Tailwind | start from `install-vite.md` and adapt |
+
+Other recipes:
+
+- `customize-brand.md` — token override cookbook (color, radius, font, spacing)
+- `server-components.md` — RSC-safety matrix and import patterns
+- `troubleshoot.md` — decision tree for the 8 most common breakages
+
+The repo URL for these files is `https://github.com/devalok-design/shilp-sutra/tree/main/packages/core/docs/recipes`. Consumer projects should also have an `AGENTS.md` at their root with the rules above pre-loaded — read that first if it exists.
+
 ## BREAKING CHANGES (v0.37.0 — Tailwind 4 CSS-first)
 
 **Setup migration only — component APIs unchanged.** See `MIGRATION.md` at the root of this package (or https://github.com/devalok-design/shilp-sutra/blob/main/MIGRATION.md#v0370--tailwind-4-css-first-migration) for the full guide.
@@ -13,7 +37,7 @@
   @import "tailwindcss";
   @import "@devalok/shilp-sutra/css";
   ```
-  The old `./tailwind` export is a deprecated no-op stub; importing it logs a dev-mode `console.warn` and is scheduled for removal in 0.38.
+  The `./tailwind` export has been removed in 0.38. Delete any `tailwind.config.ts` that referenced the preset and switch to the CSS import above.
 - **framer-motion is now a required peer dep.** Previously bundled. Install: `pnpm add framer-motion`. Module-scoped React contexts (MotionConfig, LayoutGroup, AnimatePresence) must be single-copy — the peer declaration forces pnpm to dedupe against the consumer's version.
 - **sonner is now an optional peer dep.** Install only if you render `<Toaster />`: `pnpm add sonner`.
 - **tailwindcss peer tightened to `^4.0.0`.** No more `^3.4.0 || ^4.0.0`.
@@ -48,8 +72,6 @@
 - **MessageList:** `isLoadingMore` renamed to `loadingMore`.
 - **AppCommandPalette:** Default Karm routes removed. Use `CommandRegistryProvider` for page registration. `SearchResult` type adds optional `href` field.
 - **NumberInput:** Shape changed from pill to rounded rectangle.
-- **Alert:** `variant="filled"` deprecated → use `"solid"` (alias still works).
-- **SegmentedControl:** `variant="accent"` deprecated → use `"solid"` (alias still works).
 - **Dependencies:** `@floating-ui/dom`, `@tiptap/*`, `prosemirror-state` moved to devDeps (bundled; consumers no longer install them).
 
 ## NEW (v0.35.0)
@@ -100,14 +122,13 @@
 
 - **Button:** `variant="default"` removed (use `"solid"`), `variant="destructive"` removed (use `variant="solid" color="error"`), `color="default"` removed (use `"accent"`).
 - **Chip:** Removed. Use `Badge` instead.
-- **SegmentedControl:** Rewritten. `variant="filled"` → `"accent"`, `variant="tonal"` → `"default"`. `SegmentedControlItem` no longer exported. Legacy sizes `small`/`medium`/`big` removed.
+- **SegmentedControl:** Rewritten. Variants are `"default"` (white pill) and `"solid"` (brand pill). `SegmentedControlItem` no longer exported.
 - **TopBar:** Now renders as `<header>` (was `<div>`).
 - **Sidebar:** Now renders as `<aside>` (was `<div>`).
 - **InfoBlock:** `role="status"` (was `role="alert"`).
 - **Border tokens:** One step darker system-wide.
 - **Dark mode button text:** Pure white `neutral-0` (#fff) on brand-colored buttons.
 - **BottomNavbar:** Bottom padding is now `pb-safe` (safe-area-inset).
-- **ResponsiveOverlay:** Deprecated. Use Dialog or Sheet directly.
 - **iOS inputs:** Forced to `font-size: max(16px, 1em)` on mobile via preset.
 
 ## CHANGES (v0.32.0)
@@ -124,7 +145,7 @@
 - **DataTable `mobileView="card"`** — Rows render as stacked cards below 640px. First column = card title, rest = label-value pairs.
 - **DataTable `aria-sort`** — Sortable column headers include `aria-sort`.
 - **Charts `ariaLabel` prop** — Configurable screen reader label on all chart components.
-- **SegmentedControl** — Redesigned: `variant="default"` (white pill + shadow-sm) | `variant="accent"` (brand pill). Inset radius, snappy spring animation.
+- **SegmentedControl** — Redesigned: `variant="default"` (white pill + shadow-raised) | `variant="solid"` (brand pill). Inset radius, snappy spring animation.
 - **`--shadow-kbd` token** — Keyboard shortcut badge shadow. Use `shadow-kbd` utility.
 - **Checkbox/Radio `size` prop** — `sm | md (default) | lg`.
 
@@ -409,11 +430,8 @@ import { toast } from '@devalok/shilp-sutra/ui/toast'
 // Hooks:
 import { useColorMode } from '@devalok/shilp-sutra/hooks/use-color-mode'
 
-// CSS tokens (import once at app root):
-import '@devalok/shilp-sutra/tokens'
-
-// Tailwind preset (in tailwind.config):
-import shilpSutra from '@devalok/shilp-sutra/tailwind'
+// CSS tokens (import once at app root — already included in /css):
+import '@devalok/shilp-sutra/css'
 
 ## CRITICAL: Differences from shadcn/ui
 
@@ -456,7 +474,7 @@ Components with two-axis system: Button, Badge, Alert, Banner, Progress, StatusB
 - SplitButton: [Action | ▼] button with dropdown. Props: variant(solid|soft|outline), color, size(xs|sm|md|icon-xs|icon-sm|icon-md), triggerSide(left|right, default right), triggerWidth?(number|string), placement?(Floating UI Placement, default top-end), dropdownContent(ReactNode), open?, onOpenChange?, dropdownLabel?, dropdownIcon?. ARIA: role="group", aria-haspopup="menu", aria-expanded.
 - ButtonGroup: Visually merges adjacent Buttons. Props: variant, color, size, disabled (propagates), orientation(horizontal|vertical), attached(true|false, default true), fullWidth. Compound pattern: Button reads position from context, applies radius + border-removal inline. Tonal dividers for solid/soft/ghost. Focus z-index isolation.
 - Icon: `<Icon icon={IconPlus} />` — context-aware wrapper for Tabler icons. Size tiers: xs(14px) sm(16px) md(18px) lg(20px) xl(24px) 2xl(32px). Default: md. Stroke: light(1.5) regular(2) bold(2.5). Default: regular. Scales per size tier. Reads size from parent Button/IconGroup via IconContext. Explicit props override. Accessibility: aria-hidden by default. Pass label="Add item" for accessible icons. Animation: animate="spin|pulse|bounce|draw". `draw` renders SVG path-draw animation (check/X icons draw progressively via pathLength; other icons fall back to static). State machine: state="idle|loading|success|error". Button integration: startIcon={<Icon icon={IconPlus} />} (NOT raw <IconPlus />). IconGroup: <IconGroup size="sm" gap="tight"> for toolbar patterns.
-- Input: size(xs|sm|md|lg) state(InputState) + startSection(ReactNode), endSection(ReactNode), startSectionClickable(bool), endSectionClickable(bool), startSectionType('icon'|'label'), endSectionType('icon'|'label'), wrapperClassName(string). Container-level focus ring wraps input + sections as one unit. Sections are pointer-events-none by default; use *SectionClickable for interactive content (clear buttons, toggles). Section type auto-inferred: strings→'label' (tinted bg + border separator), React elements→'icon' (fixed-width centered). Override with *SectionType. Flexbox section layout. Icons auto-size via IconProvider per input size. className targets <input>, wrapperClassName targets wrapper div. Deprecated aliases: startIcon→startSection, endIcon→endSection, inputVariants→inputWrapperVariants. Type: InputState = 'default' | 'error' | 'warning' | 'success'
+- Input: size(xs|sm|md|lg) state(InputState) + startSection(ReactNode), endSection(ReactNode), startSectionClickable(bool), endSectionClickable(bool), startSectionType('icon'|'label'), endSectionType('icon'|'label'), wrapperClassName(string). Container-level focus ring wraps input + sections as one unit. Sections are pointer-events-none by default; use *SectionClickable for interactive content (clear buttons, toggles). Section type auto-inferred: strings→'label' (tinted bg + border separator), React elements→'icon' (fixed-width centered). Override with *SectionType. Flexbox section layout. Icons auto-size via IconProvider per input size. className targets <input>, wrapperClassName targets wrapper div. Type: InputState = 'default' | 'error' | 'warning' | 'success'
 - SearchInput: size(xs|sm|md|lg) + loading, onClear. Delegates to Input v2 sections internally.
 - NumberInput: value + onValueChange, min, max, step (controlled only)
 - Textarea: size(xs|sm|md|lg) state(default|error|warning|success)
@@ -467,12 +485,12 @@ Components with two-axis system: Button, Badge, Alert, Banner, Progress, StatusB
 - Select > SelectTrigger(size: xs|sm|md|lg) > SelectValue; SelectContent > SelectItem(value)
 - Toggle: variant(default|outline) size(sm|md|lg)
 - ToggleGroup > ToggleGroupItem (variant/size propagate from root)
-- SegmentedControl > SegmentedControlItem: variant(filled|tonal) size(sm|md|lg). Types: SegmentedControlOption = { id, text, icon? }, SegmentedControlSize = 'sm' | 'md' | 'lg', SegmentedControlVariant = 'filled' | 'tonal'
+- SegmentedControl: variant(default|solid) size(sm|md|lg) options selectedId onSelect. Types: SegmentedControlOption = { id, text, icon? }, SegmentedControlSize = 'sm' | 'md' | 'lg', SegmentedControlVariant = 'default' | 'solid'
 - Slider: standard Radix slider
 
 ### Feedback & Notifications
-- Alert: variant(subtle|filled|outline) color(info|success|warning|error|neutral) + title, onDismiss
-- Banner: color(info|success|warning|error|neutral) + actions?(ReactNode), onDismiss. `action` (singular) deprecated, use `actions`. Mobile flex-wrap for multiple buttons.
+- Alert: variant(subtle|solid|outline) color(info|success|warning|error|neutral) size(sm|md|lg) + title, onDismiss
+- Banner: color(info|success|warning|error|neutral) + actions?(ReactNode), onDismiss. Mobile flex-wrap for multiple buttons.
 - Toast: imperative API via toast.success/error/warning/info/loading/message/undo/promise/upload/custom — REQUIRES <Toaster> at layout root
 - Spinner: size(sm|md|lg) — renders with role="status"
 - Progress: track size(sm|md|lg), indicator color(default|success|warning|error), autoColor(boolean, auto-shifts color by value: 0-59=default, 60-84=warning, 85-100=success, >100=error)
@@ -568,7 +586,6 @@ Import: `@devalok/shilp-sutra/ui/chat`
 - BulkActionBar: show, count, onClearSelection, actions[{label,icon?,onClick,color?,disabled?}]. Fixed bottom floating bar for multi-select contexts.
 - DeadlineIndicator: deadline(Date|string), warningThreshold?(1440min), criticalThreshold?(240min), format(relative|absolute), showIcon. Color transitions: green→yellow→red→overdue.
 - MasterDetail: selected, onBack, masterWidth, breakpoint(sm|md|lg). Compound: MasterDetail.List, MasterDetail.Detail, MasterDetail.ListItem(active). Desktop=grid, mobile=stacked with back button.
-- ResponsiveOverlay: open, onOpenChange, title, description, breakpoint(sm|md). Dialog on desktop, bottom Sheet on mobile.
 - MarkdownViewer: content(string), compact?, allowHtml?(false), linkTarget?('_blank'). Renders markdown with design system tokens.
 - EmojiPicker: onSelect(emoji), set?(native|apple|google|twitter|facebook), theme(auto|light|dark). EmojiPickerPopover wraps in Popover. Lazy-loads emoji-mart with set-specific data.
 - EmojiNode: TipTap inline atom node for spritesheet emoji rendering. Attrs: id, native, set, x, y. Use createEmojiSuggestion(set) to wire :shortcode: autocomplete. Export: EmojiNode, EmojiNodeAttrs, createEmojiSuggestion.

package/package.json

@@ -1,13 +1,44 @@
 {
   "name": "@devalok/shilp-sutra",
-  "version": "0.37.0",
-  "description": "Devalok Design System — tokens, components, and patterns for Next.js",
+  "version": "0.38.0",
+  "description": "Devalok Design System — accessible React components, OKLCH design tokens, and Tailwind 4 CSS-first setup. Ships with AI-agent setup recipes.",
   "license": "MIT",
+  "author": "Devalok Design & Strategy Studios <shilp-sutra@devalok.in>",
+  "homepage": "https://devalok-design.github.io/shilp-sutra/",
   "repository": {
     "type": "git",
     "url": "https://github.com/devalok-design/shilp-sutra",
     "directory": "packages/core"
   },
+  "bugs": {
+    "url": "https://github.com/devalok-design/shilp-sutra/issues"
+  },
+  "keywords": [
+    "react",
+    "design-system",
+    "components",
+    "ui",
+    "ui-library",
+    "tailwindcss",
+    "tailwind-v4",
+    "typescript",
+    "accessible",
+    "a11y",
+    "wcag",
+    "radix-ui",
+    "headless",
+    "cva",
+    "design-tokens",
+    "oklch",
+    "framer-motion",
+    "dark-mode",
+    "nextjs",
+    "vite",
+    "astro",
+    "remix",
+    "ai-agent",
+    "llms-txt"
+  ],
   "type": "module",
   "main": "./dist/ui/index.js",
   "module": "./dist/ui/index.js",
@@ -554,11 +585,6 @@
       "import": "./dist/composed/status-badge.js",
       "default": "./dist/composed/status-badge.js"
     },
-    "./composed/responsive-overlay": {
-      "types": "./dist/composed/responsive-overlay.d.ts",
-      "import": "./dist/composed/responsive-overlay.js",
-      "default": "./dist/composed/responsive-overlay.js"
-    },
     "./composed/schedule-view": {
       "types": "./dist/composed/schedule-view.d.ts",
       "import": "./dist/composed/schedule-view.js",
@@ -629,23 +655,6 @@
       "import": "./dist/hooks/use-mobile.js",
       "default": "./dist/hooks/use-mobile.js"
     },
-    "./hooks/use-toast": {
-      "types": "./dist/hooks/use-toast.d.ts",
-      "import": "./dist/hooks/use-toast.js",
-      "default": "./dist/hooks/use-toast.js"
-    },
-    "./tailwind": {
-      "types": "./dist/tailwind/index.d.ts",
-      "require": "./dist/tailwind/index.cjs",
-      "import": "./dist/tailwind/index.js",
-      "default": "./dist/tailwind/index.js"
-    },
-    "./tailwind/preset": {
-      "types": "./dist/tailwind/preset.d.ts",
-      "require": "./dist/tailwind/index.cjs",
-      "import": "./dist/tailwind/preset.js",
-      "default": "./dist/tailwind/preset.js"
-    },
     "./utils": {
       "types": "./dist/ui/lib/utils.d.ts",
       "import": "./dist/ui/lib/utils.js",
@@ -722,6 +731,7 @@
   "files": [
     "dist",
     "docs/components",
+    "docs/recipes",
     "docs/rollback.md",
     "fonts",
     "MIGRATION.md",
@@ -830,19 +840,19 @@
     "@emoji-mart/react": "^1.1.1",
     "@floating-ui/dom": "^1.7.6",
     "@floating-ui/react-dom": "^2.1.8",
-    "@tabler/icons-react": "^3.41.1",
+    "@tabler/icons-react": "^3.42.0",
     "@tanstack/react-table": "^8.21.3",
     "@tanstack/react-virtual": "^3.13.23",
-    "@tiptap/core": "^3.22.3",
-    "@tiptap/extension-highlight": "^3.22.3",
-    "@tiptap/extension-image": "^3.22.3",
-    "@tiptap/extension-list": "^3.22.3",
-    "@tiptap/extension-mention": "^3.22.3",
-    "@tiptap/extension-text-align": "^3.22.3",
-    "@tiptap/extensions": "^3.22.3",
-    "@tiptap/react": "^3.22.3",
-    "@tiptap/starter-kit": "^3.22.3",
-    "@tiptap/suggestion": "^3.22.3",
+    "@tiptap/core": "^3.22.5",
+    "@tiptap/extension-highlight": "^3.22.5",
+    "@tiptap/extension-image": "^3.22.5",
+    "@tiptap/extension-list": "^3.22.5",
+    "@tiptap/extension-mention": "^3.22.5",
+    "@tiptap/extension-text-align": "^3.22.5",
+    "@tiptap/extensions": "^3.22.5",
+    "@tiptap/react": "^3.22.5",
+    "@tiptap/starter-kit": "^3.22.5",
+    "@tiptap/suggestion": "^3.22.5",
     "@types/react-syntax-highlighter": "^15.5.13",
     "aria-hidden": "^1.2.6",
     "class-variance-authority": "^0.7.1",

package/dist/composed/responsive-overlay.d.ts

@@ -1,23 +0,0 @@
-"use client";
-import * as React from 'react';
-/**
- * @deprecated Dialog and Sheet now auto-adapt to mobile viewports.
- * Use Dialog directly (fullScreens on mobile) or Sheet directly (becomes bottom sheet on mobile).
- * This component will be removed in a future major version.
- */
-export interface ResponsiveOverlayProps {
-    open: boolean;
-    onOpenChange: (open: boolean) => void;
-    title?: string;
-    description?: string;
-    /** Below this breakpoint renders as bottom Sheet @default 'md' */
-    breakpoint?: 'sm' | 'md';
-    children: React.ReactNode;
-    className?: string;
-}
-/**
- * @deprecated Use Dialog or Sheet directly — they are now individually mobile-responsive.
- */
-declare function ResponsiveOverlay({ open, onOpenChange, title, description, breakpoint, children, className, }: ResponsiveOverlayProps): import("react/jsx-runtime").JSX.Element;
-export { ResponsiveOverlay };
-//# sourceMappingURL=responsive-overlay.d.ts.map

package/dist/composed/responsive-overlay.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"responsive-overlay.d.ts","sourceRoot":"","sources":["../../src/composed/responsive-overlay.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAqB9B;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA8BD;;GAEG;AACH,iBAAS,iBAAiB,CAAC,EACzB,IAAI,EACJ,YAAY,EACZ,KAAK,EACL,WAAW,EACX,UAAiB,EACjB,QAAQ,EACR,SAAS,GACV,EAAE,sBAAsB,2CAgCxB;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/composed/responsive-overlay.js

@@ -1,40 +0,0 @@
-"use client";
-import { Dialog as e, DialogContent as t, DialogDescription as n, DialogHeader as r, DialogTitle as i } from "../ui/dialog.js";
-import { Sheet as a, SheetContent as o, SheetDescription as s, SheetHeader as c, SheetTitle as l } from "../ui/sheet.js";
-import * as u from "react";
-import { jsx as d, jsxs as f } from "react/jsx-runtime";
-//#region src/composed/responsive-overlay.tsx
-var p = {
-	sm: "640px",
-	md: "768px"
-};
-function m(e) {
-	let [t, n] = u.useState(!1);
-	return u.useEffect(() => {
-		if (typeof window > "u") return;
-		let t = window.matchMedia(`(max-width: ${p[e]})`);
-		n(t.matches);
-		let r = (e) => n(e.matches);
-		return t.addEventListener("change", r), () => t.removeEventListener("change", r);
-	}, [e]), t;
-}
-function h({ open: u, onOpenChange: p, title: h, description: g, breakpoint: _ = "md", children: v, className: y }) {
-	return m(_) ? /* @__PURE__ */ d(a, {
-		open: u,
-		onOpenChange: p,
-		children: /* @__PURE__ */ f(o, {
-			side: "bottom",
-			className: y,
-			children: [(h || g) && /* @__PURE__ */ f(c, { children: [h && /* @__PURE__ */ d(l, { children: h }), g && /* @__PURE__ */ d(s, { children: g })] }), v]
-		})
-	}) : /* @__PURE__ */ d(e, {
-		open: u,
-		onOpenChange: p,
-		children: /* @__PURE__ */ f(t, {
-			className: y,
-			children: [(h || g) && /* @__PURE__ */ f(r, { children: [h && /* @__PURE__ */ d(i, { children: h }), g && /* @__PURE__ */ d(n, { children: g })] }), v]
-		})
-	});
-}
-//#endregion
-export { h as ResponsiveOverlay };

package/dist/composed/responsive-overlay.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"responsive-overlay.js","names":[],"sources":["../../src/composed/responsive-overlay.tsx"],"sourcesContent":["'use client'\n\nimport * as React from 'react'\n\nimport {\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogHeader,\n  DialogTitle,\n} from '../ui/dialog'\nimport {\n  Sheet,\n  SheetContent,\n  SheetDescription,\n  SheetHeader,\n  SheetTitle,\n} from '../ui/sheet'\n\n// ============================================================\n// Types\n// ============================================================\n\n/**\n * @deprecated Dialog and Sheet now auto-adapt to mobile viewports.\n * Use Dialog directly (fullScreens on mobile) or Sheet directly (becomes bottom sheet on mobile).\n * This component will be removed in a future major version.\n */\nexport interface ResponsiveOverlayProps {\n  open: boolean\n  onOpenChange: (open: boolean) => void\n  title?: string\n  description?: string\n  /** Below this breakpoint renders as bottom Sheet @default 'md' */\n  breakpoint?: 'sm' | 'md'\n  children: React.ReactNode\n  className?: string\n}\n\n// ============================================================\n// Hook\n// ============================================================\n\nconst breakpointValues: Record<string, string> = {\n  sm: '640px',\n  md: '768px',\n}\n\nfunction useIsMobileOverlay(breakpoint: string): boolean {\n  const [isMobile, setIsMobile] = React.useState(false)\n\n  React.useEffect(() => {\n    if (typeof window === 'undefined') return\n    const mql = window.matchMedia(`(max-width: ${breakpointValues[breakpoint]})`)\n    setIsMobile(mql.matches)\n    const handler = (e: MediaQueryListEvent) => setIsMobile(e.matches)\n    mql.addEventListener('change', handler)\n    return () => mql.removeEventListener('change', handler)\n  }, [breakpoint])\n\n  return isMobile\n}\n\n// ============================================================\n// ResponsiveOverlay\n// ============================================================\n\n/**\n * @deprecated Use Dialog or Sheet directly — they are now individually mobile-responsive.\n */\nfunction ResponsiveOverlay({\n  open,\n  onOpenChange,\n  title,\n  description,\n  breakpoint = 'md',\n  children,\n  className,\n}: ResponsiveOverlayProps) {\n  const isMobile = useIsMobileOverlay(breakpoint)\n\n  if (isMobile) {\n    return (\n      <Sheet open={open} onOpenChange={onOpenChange}>\n        <SheetContent side=\"bottom\" className={className}>\n          {(title || description) && (\n            <SheetHeader>\n              {title && <SheetTitle>{title}</SheetTitle>}\n              {description && <SheetDescription>{description}</SheetDescription>}\n            </SheetHeader>\n          )}\n          {children}\n        </SheetContent>\n      </Sheet>\n    )\n  }\n\n  return (\n    <Dialog open={open} onOpenChange={onOpenChange}>\n      <DialogContent className={className}>\n        {(title || description) && (\n          <DialogHeader>\n            {title && <DialogTitle>{title}</DialogTitle>}\n            {description && <DialogDescription>{description}</DialogDescription>}\n          </DialogHeader>\n        )}\n        {children}\n      </DialogContent>\n    </Dialog>\n  )\n}\n\nexport { ResponsiveOverlay }\n"],"mappings":";;;;;;AA2CA,IAAM,IAA2C;CAC/C,IAAI;CACJ,IAAI;CACL;AAED,SAAS,EAAmB,GAA6B;CACvD,IAAM,CAAC,GAAU,KAAe,EAAM,SAAS,GAAM;AAWrD,QATA,EAAM,gBAAgB;AACpB,MAAI,OAAO,SAAW,IAAa;EACnC,IAAM,IAAM,OAAO,WAAW,eAAe,EAAiB,GAAY,GAAG;AAC7E,IAAY,EAAI,QAAQ;EACxB,IAAM,KAAW,MAA2B,EAAY,EAAE,QAAQ;AAElE,SADA,EAAI,iBAAiB,UAAU,EAAQ,QAC1B,EAAI,oBAAoB,UAAU,EAAQ;IACtD,CAAC,EAAW,CAAC,EAET;;AAUT,SAAS,EAAkB,EACzB,SACA,iBACA,UACA,gBACA,gBAAa,MACb,aACA,gBACyB;AAmBzB,QAlBiB,EAAmB,EAAW,GAI3C,kBAAC,GAAD;EAAa;EAAoB;YAC/B,kBAAC,GAAD;GAAc,MAAK;GAAoB;aAAvC,EACI,KAAS,MACT,kBAAC,GAAD,EAAA,UAAA,CACG,KAAS,kBAAC,GAAD,EAAA,UAAa,GAAmB,CAAA,EACzC,KAAe,kBAAC,GAAD,EAAA,UAAmB,GAA+B,CAAA,CACtD,EAAA,CAAA,EAEf,EACY;;EACT,CAAA,GAKV,kBAAC,GAAD;EAAc;EAAoB;YAChC,kBAAC,GAAD;GAA0B;aAA1B,EACI,KAAS,MACT,kBAAC,GAAD,EAAA,UAAA,CACG,KAAS,kBAAC,GAAD,EAAA,UAAc,GAAoB,CAAA,EAC3C,KAAe,kBAAC,GAAD,EAAA,UAAoB,GAAgC,CAAA,CACvD,EAAA,CAAA,EAEhB,EACa;;EACT,CAAA"}

package/dist/hooks/use-toast.d.ts

@@ -1,17 +0,0 @@
-"use client";
-/**
- * @deprecated Use `toast` directly from `@devalok/shilp-sutra/ui/toast` or `@devalok/shilp-sutra`.
- * This module is provided for back-compatibility during migration.
- *
- * @example
- * // New API (recommended):
- * import { toast } from '@devalok/shilp-sutra'
- * toast.success('Saved!')
- *
- * // Old API (deprecated):
- * import { toast } from '@devalok/shilp-sutra/hooks/use-toast'
- * toast('Something happened')
- */
-export { toast } from '../ui/toast';
-export type { ToastActionOptions, ToastOptions, ToastType, ToastUndoOptions, ToastUploadOptions, UploadFile, } from '../ui/toast-types';
-//# sourceMappingURL=use-toast.d.ts.map

package/dist/hooks/use-toast.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-toast.d.ts","sourceRoot":"","sources":["../../src/hooks/use-toast.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,GACX,MAAM,mBAAmB,CAAA"}

package/dist/hooks/use-toast.js

@@ -1,3 +0,0 @@
-"use client";
-import { toast as e } from "../ui/toast.js";
-export { e as toast };

package/dist/tailwind/index.cjs

@@ -1,41 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var preset_exports = {};
-__export(preset_exports, {
-  default: () => e
-});
-module.exports = __toCommonJS(preset_exports);
-var e = {}, t = false;
-function n() {
-  if (t) return;
-  t = true;
-  let e2 = '\n\u26A0\uFE0F  [@devalok/shilp-sutra] DEPRECATION: The JS preset at "./tailwind" is deprecated in 0.37.0 and will be removed in 0.38.0.\n\nEvery class utility you relied on from this preset (bg-surface-raised, p-ds-04, shadow-raised, text-ds-md, etc.) is now emitted zero CSS by Tailwind 4. Your app will ship unstyled unless you migrate.\n\nReplace:\n    // tailwind.config.ts\n    import shilpSutra from "@devalok/shilp-sutra/tailwind"\n    export default { presets: [shilpSutra], content: [...] }\n\nwith:\n    // app/globals.css\n    @import "tailwindcss";\n    @import "@devalok/shilp-sutra/css";\n\nFull guide: https://github.com/devalok-design/shilp-sutra/blob/main/MIGRATION.md\n';
-  try {
-    if (typeof process < "u" && typeof process.stderr?.write == "function") {
-      process.stderr.write(e2);
-      return;
-    }
-  } catch {
-  }
-  console.warn(e2);
-}
-n();
-
-module.exports = module.exports.default;
-module.exports.default = module.exports;

package/dist/tailwind/index.d.ts

@@ -1,2 +0,0 @@
-export { default } from './preset';
-//# sourceMappingURL=index.d.ts.map

package/dist/tailwind/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tailwind/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA"}

package/dist/tailwind/index.js

@@ -1,2 +0,0 @@
-import e from "./preset.js";
-export { e as default };

package/dist/tailwind/preset.d.ts

@@ -1,25 +0,0 @@
-import { Config } from 'tailwindcss';
-/**
- * @deprecated Since 0.37.0. Tailwind 4 uses CSS-first configuration via
- * `@theme`, `@utility`, and `@custom-variant`, not JavaScript presets.
- *
- * Migrate to:
- *
- * ```css
- *   // app/globals.css
- *   @import "tailwindcss";
- *   @import "@devalok/shilp-sutra/css";
- * ```
- *
- * And delete your `tailwind.config.ts` (or shrink it to whatever your own
- * app needs — we no longer ask you to reference our preset).
- *
- * This export remains as a typed no-op so in-flight consumer code that
- * still imports it doesn't crash at import time. Scheduled for removal
- * in 0.38.0.
- *
- * See MIGRATION.md at the repo root for the full 0.36 → 0.37 walkthrough.
- */
-declare const preset: Partial<Config>;
-export default preset;
-//# sourceMappingURL=preset.d.ts.map

package/dist/tailwind/preset.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/tailwind/preset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,QAAA,MAAM,MAAM,EAAE,OAAO,CAAC,MAAM,CAAM,CAAA;AA8DlC,eAAe,MAAM,CAAA"}

package/dist/tailwind/preset.js

@@ -1,17 +0,0 @@
-//#region src/tailwind/preset.ts
-var e = {}, t = !1;
-function n() {
-	if (t) return;
-	t = !0;
-	let e = "\n⚠️  [@devalok/shilp-sutra] DEPRECATION: The JS preset at \"./tailwind\" is deprecated in 0.37.0 and will be removed in 0.38.0.\n\nEvery class utility you relied on from this preset (bg-surface-raised, p-ds-04, shadow-raised, text-ds-md, etc.) is now emitted zero CSS by Tailwind 4. Your app will ship unstyled unless you migrate.\n\nReplace:\n    // tailwind.config.ts\n    import shilpSutra from \"@devalok/shilp-sutra/tailwind\"\n    export default { presets: [shilpSutra], content: [...] }\n\nwith:\n    // app/globals.css\n    @import \"tailwindcss\";\n    @import \"@devalok/shilp-sutra/css\";\n\nFull guide: https://github.com/devalok-design/shilp-sutra/blob/main/MIGRATION.md\n";
-	try {
-		if (typeof process < "u" && typeof process.stderr?.write == "function") {
-			process.stderr.write(e);
-			return;
-		}
-	} catch {}
-	console.warn(e);
-}
-n();
-//#endregion
-export { e as default };

package/dist/tailwind/preset.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"preset.js","names":[],"sources":["../../src/tailwind/preset.ts"],"sourcesContent":["import type { Config } from 'tailwindcss'\n\n/**\n * @deprecated Since 0.37.0. Tailwind 4 uses CSS-first configuration via\n * `@theme`, `@utility`, and `@custom-variant`, not JavaScript presets.\n *\n * Migrate to:\n *\n * ```css\n *   // app/globals.css\n *   @import \"tailwindcss\";\n *   @import \"@devalok/shilp-sutra/css\";\n * ```\n *\n * And delete your `tailwind.config.ts` (or shrink it to whatever your own\n * app needs — we no longer ask you to reference our preset).\n *\n * This export remains as a typed no-op so in-flight consumer code that\n * still imports it doesn't crash at import time. Scheduled for removal\n * in 0.38.0.\n *\n * See MIGRATION.md at the repo root for the full 0.36 → 0.37 walkthrough.\n */\nconst preset: Partial<Config> = {}\n\n// Emit a one-time deprecation warning so consumers on the old JS-preset\n// setup discover the migration via their build output — not via silent\n// visual breakage in production.\n//\n// Critical: the warning fires in ALL environments including `next build`\n// (NODE_ENV=production). Gating this on NODE_ENV would defeat the whole\n// point — the consumer most likely to ship broken CSS (CI-only pipeline,\n// no local dev loop) is exactly the one who would never see a dev-only\n// warn. Audited 0.37.0-pre-RC; see post-audit commit message.\n//\n// Written to stderr directly (not console.warn) so it survives Next's\n// output filters which can silence console calls during `next build`.\n// Inline process shim so we don't need @types/node in packages/core's\n// tsconfig (typecheck runs with types: []).\ndeclare const process:\n  | {\n      env?: { NODE_ENV?: string }\n      stderr?: { write: (s: string) => void }\n    }\n  | undefined\nlet warned = false\nfunction emitDeprecationNotice(): void {\n  if (warned) return\n  warned = true\n  const msg =\n    '\\n' +\n    '⚠️  [@devalok/shilp-sutra] DEPRECATION: The JS preset at \"./tailwind\" is ' +\n    'deprecated in 0.37.0 and will be removed in 0.38.0.\\n\\n' +\n    'Every class utility you relied on from this preset (bg-surface-raised, ' +\n    'p-ds-04, shadow-raised, text-ds-md, etc.) is now emitted zero CSS by ' +\n    'Tailwind 4. Your app will ship unstyled unless you migrate.\\n\\n' +\n    'Replace:\\n' +\n    '    // tailwind.config.ts\\n' +\n    '    import shilpSutra from \"@devalok/shilp-sutra/tailwind\"\\n' +\n    '    export default { presets: [shilpSutra], content: [...] }\\n\\n' +\n    'with:\\n' +\n    '    // app/globals.css\\n' +\n    '    @import \"tailwindcss\";\\n' +\n    '    @import \"@devalok/shilp-sutra/css\";\\n\\n' +\n    'Full guide: https://github.com/devalok-design/shilp-sutra/blob/main/MIGRATION.md\\n'\n\n  // Prefer process.stderr for CI visibility; fall back to console.warn\n  // in environments where process is not available (browsers, Edge runtime).\n  try {\n    if (\n      typeof process !== 'undefined' &&\n      typeof process.stderr?.write === 'function'\n    ) {\n      process.stderr.write(msg)\n      return\n    }\n  } catch {\n    // Fall through to console.warn.\n  }\n   \n  console.warn(msg)\n}\n// Fire when the module is imported (ESM evaluates module body once).\nemitDeprecationNotice()\n\nexport default preset\n"],"mappings":";AAuBA,IAAM,IAA0B,EAAE,EAsB9B,IAAS;AACb,SAAS,IAA8B;AACrC,KAAI,EAAQ;AACZ,KAAS;CACT,IAAM,IACJ;AAkBF,KAAI;AACF,MACE,OAAO,UAAY,OACnB,OAAO,QAAQ,QAAQ,SAAU,YACjC;AACA,WAAQ,OAAO,MAAM,EAAI;AACzB;;SAEI;AAIR,SAAQ,KAAK,EAAI;;AAGnB,GAAuB"}

package/docs/components/composed/responsive-overlay.md

@@ -1,34 +0,0 @@
-# ResponsiveOverlay
-
-- Import: @devalok/shilp-sutra/composed/responsive-overlay
-- Server-safe: No
-- Category: composed
-
-## Props
-    open: boolean
-    onOpenChange: (open: boolean) => void
-    title: string
-    description: string
-    breakpoint: "sm" | "md" (below this renders as bottom Sheet; above as Dialog)
-    children: ReactNode
-    className: string
-
-## Defaults
-    breakpoint="md"
-
-## Example
-```jsx
-<ResponsiveOverlay
-  open={open}
-  onOpenChange={setOpen}
-  title="Edit task"
-  description="Update the task details"
->
-  <TaskForm />
-</ResponsiveOverlay>
-```
-
-## Gotchas
-- Renders a centered Dialog on desktop and a bottom Sheet on mobile — same content, different container
-- Uses `window.matchMedia` internally — SSR defaults to desktop (Dialog) until hydration
-- Title and description are optional; if omitted, no header is rendered in either mode