@devalok/shilp-sutra 0.57.0 → 0.59.0

package/docs/recipes/install-tanstack-start.md

@@ -41,10 +41,10 @@ Some components ship hard peers as optional. **Install BEFORE first import.**
 | When you import… | Install |
 |---|---|
 | `@devalok/shilp-sutra/composed/date-picker` | `pnpm add date-fns` |
+| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/file-preview` | `pnpm add react-pdf react-zoom-pan-pinch` |
 | `@devalok/shilp-sutra/composed/markdown-viewer` | `pnpm add react-markdown react-syntax-highlighter remark-gfm` |
 | `@devalok/shilp-sutra/composed/rich-chat-input` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion date-fns` |
-| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/rich-text-editor` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion` |
 | `@devalok/shilp-sutra/composed/schedule-view` | `pnpm add date-fns` |
 | `@devalok/shilp-sutra/ui/charts` | `pnpm add d3-axis d3-scale d3-selection d3-shape` |

package/docs/recipes/install-vite.md

@@ -47,10 +47,10 @@ Some components ship hard peers as optional. **Install BEFORE first import.**
 | When you import… | Install |
 |---|---|
 | `@devalok/shilp-sutra/composed/date-picker` | `pnpm add date-fns` |
+| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/file-preview` | `pnpm add react-pdf react-zoom-pan-pinch` |
 | `@devalok/shilp-sutra/composed/markdown-viewer` | `pnpm add react-markdown react-syntax-highlighter remark-gfm` |
 | `@devalok/shilp-sutra/composed/rich-chat-input` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion date-fns` |
-| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/rich-text-editor` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion` |
 | `@devalok/shilp-sutra/composed/schedule-view` | `pnpm add date-fns` |
 | `@devalok/shilp-sutra/ui/charts` | `pnpm add d3-axis d3-scale d3-selection d3-shape` |
@@ -137,6 +137,7 @@ export function ThemeToggle() {
 
 If you installed `sonner`, mount the Toaster once near the app root:
 
+<!-- typecheck-skip: imports the reader's own App entry -->
 ```tsx
 // src/main.tsx
 import { StrictMode } from "react";

package/docs/recipes/server-components.md

@@ -78,7 +78,7 @@ export function MyButton() {
 |---|---|
 | `ContentCard` | All other composed components become client islands when rendered |
 | `PageHeader` | |
-| `LoadingSkeleton` | |
+| `CardSkeleton` / `TableSkeleton` / `BoardSkeleton` / `ListSkeleton` | |
 | `PageSkeletons` | |
 
 ### `@devalok/shilp-sutra/shell`
@@ -127,20 +127,23 @@ All shilp-sutra components SSR cleanly. They have no client-only side effects at
 
 Use `<Suspense>` boundaries normally:
 
+<!-- typecheck-skip: ClientHeavyComponent is the reader's own component -->
 ```tsx
 import { Suspense } from "react";
-import { LoadingSkeleton } from "@devalok/shilp-sutra/composed/loading-skeleton";
+import { CardSkeleton } from "@devalok/shilp-sutra/composed/loading-skeleton";
 
 export default function Page() {
   return (
-    <Suspense fallback={<LoadingSkeleton variant="page" />}>
+    <Suspense fallback={<CardSkeleton />}>
       <ClientHeavyComponent />
     </Suspense>
   );
 }
 ```
 
-Both `<Suspense>` and `<LoadingSkeleton>` are server-safe.
+Both `<Suspense>` and the skeletons are server-safe. The module exports
+`CardSkeleton`, `TableSkeleton`, `BoardSkeleton` and `ListSkeleton` — pick the
+one whose shape matches what is loading.
 
 ## Common RSC mistakes
 

package/docs/recipes/troubleshoot.md

@@ -91,6 +91,7 @@ After editing, delete the lockfile + `node_modules` and reinstall.
 
 Add:
 
+<!-- typecheck-skip: a fragment of next.config, not a standalone module -->
 ```ts
 transpilePackages: ["@devalok/shilp-sutra"],
 ```

package/llms.txt

@@ -1,6 +1,6 @@
 # @devalok/shilp-sutra
 
-> Radix UI + Tailwind 4 (CSS-first) + CVA design system for Devalok apps, v0.57.0.
+> Radix UI + Tailwind 4 (CSS-first) + CVA design system for Devalok apps, v0.59.0.
 > Built on the same primitives as shadcn/ui but with DIFFERENT prop APIs — never guess from shadcn knowledge; verify every prop.
 > This file is a ROUTER: it tells you what exists and where to get details. Do not look for prop tables here — fetch them per component (MCP tool or per-component doc file below).
 

package/mcp-manifest.json

@@ -2,7 +2,7 @@
   "$schema": "./mcp-manifest.schema.json",
   "manifestVersion": "1.2.0",
   "package": "@devalok/shilp-sutra",
-  "packageVersion": "0.57.0",
+  "packageVersion": "0.59.0",
   "components": {
     "accordion": {
       "displayName": "Accordion",
@@ -14020,7 +14020,7 @@
       },
       {
         "name": "--color-segment-thumb",
-        "value": "var(--neutral-3)"
+        "value": "var(--neutral-5)"
       },
       {
         "name": "--color-overlay",
@@ -14738,7 +14738,7 @@
       },
       {
         "name": "--shadow-segment",
-        "value": "0 1px 2px -0.5px oklch(var(--shadow-color) / calc(0.10 * var(--shadow-strength))), 0 3px 8px -2px oklch(var(--shadow-color) / calc(0.09 * var(--shadow-strength)))"
+        "value": "0 0 0 1px oklch(1 0 0 / 0.07), 0 1px 2px -0.5px oklch(0 0 0 / 0.40), 0 3px 8px -2px oklch(0 0 0 / 0.30)"
       },
       {
         "name": "--shadow-floating",
@@ -14790,7 +14790,7 @@
       },
       {
         "name": "--shadow-kbd",
-        "value": "inset 0 -1px 0 oklch(0 0 0 / 0.1)"
+        "value": "inset 0 1px 0 oklch(1 0 0 / 0.10)"
       },
       {
         "name": "--shadow-strength",
@@ -14802,6 +14802,11 @@
         "value": "0 0 0 1px oklch(var(--shadow-color) / calc(0.09 * var(--shadow-strength)))",
         "darkValue": "0 0 0 1px oklch(1 0 0 / 0.12)"
       },
+      {
+        "name": "--shadow-edge-ring-subtle",
+        "value": "0 0 0 1px oklch(var(--shadow-color) / calc(0.035 * var(--shadow-strength)))",
+        "darkValue": "0 0 0 1px oklch(1 0 0 / 0.07)"
+      },
       {
         "name": "--shadow-color",
         "value": "0.15 0.015 260"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devalok/shilp-sutra",
-  "version": "0.57.0",
+  "version": "0.59.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>",
@@ -1049,6 +1049,7 @@
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/",
     "test": "vitest run",
-    "test:coverage": "vitest run --coverage"
+    "test:coverage": "vitest run --coverage",
+    "typecheck:docs": "node scripts/typecheck-doc-snippets.mjs --check"
   }
 }

package/skill/SKILL.md

@@ -3,7 +3,7 @@ name: shilp-sutra
 description: Add, configure, and use components from Devalok's shilp-sutra design system (@devalok/shilp-sutra) — a Tailwind 4 + React 19 + CVA library with 110+ accessible components, OKLCH design tokens, framer-motion animations, and per-component RSC-safe entry points. Use this skill whenever the user mentions shilp-sutra, Devalok, the @devalok npm scope, or asks to install/add/style/theme UI in any React project that already depends on the package — even if they don't name it explicitly. Use it instead of generic shadcn/ui, MUI, or Chakra knowledge when shilp-sutra is in the project. Covers Next.js (App + Pages), Vite, Astro, Remix, TanStack Start setup playbooks; component API and variant reference; brand token customization; Server Component import patterns; and a troubleshoot tree for the thirteen most common breakages.
 license: MIT
 metadata:
-  version: "0.57.0"
+  version: "0.59.0"
   author: Devalok Design & Strategy Studios
   homepage: https://github.com/devalok-design/shilp-sutra
   npm: https://www.npmjs.com/package/@devalok/shilp-sutra

package/skill/references/components.md

@@ -2,7 +2,7 @@
 
 # @devalok/shilp-sutra
 
-> Radix UI + Tailwind 4 (CSS-first) + CVA design system for Devalok apps, v0.57.0.
+> Radix UI + Tailwind 4 (CSS-first) + CVA design system for Devalok apps, v0.59.0.
 > Built on the same primitives as shadcn/ui but with DIFFERENT prop APIs — never guess from shadcn knowledge; verify every prop.
 > This file is a ROUTER: it tells you what exists and where to get details. Do not look for prop tables here — fetch them per component (MCP tool or per-component doc file below).
 

package/skill/references/customize-brand.md

@@ -258,6 +258,64 @@ Every override should consider both modes. Pattern:
 
 `.dark` is a regular class selector — its specificity is higher than `:root`/`@theme` body, so dark-mode overrides win when the class is active.
 
+## High contrast (`[data-contrast]`)
+
+WCAG 2.2 SC 1.4.11 asks for **3:1** between a control's edge and its background.
+The default control edge here is **2.00:1** in light and **2.08:1** in dark — a
+deliberately softer look, and deliberately under that bar. It is recorded as
+`CONTROL-EDGE-BELOW-AA` in the deviations register.
+
+Set `data-contrast="high"` to opt into edges that clear the threshold:
+
+```html
+<!-- whole app -->
+<html data-contrast="high">
+```
+
+```tsx
+{/* or one region — a data-entry screen inside an otherwise soft product */}
+<div data-contrast="high">
+  <InvoiceForm />
+</div>
+```
+
+| | control edge, light | control edge, dark |
+|---|---|---|
+| default | `#b7b7b7` — 2.00:1 | `#4c4c4c` — 2.08:1 |
+| `data-contrast="high"` | `#868686` — **3.64:1** | `#767676` — **3.93:1** |
+
+It affects Input, Textarea, Select, Combobox, Checkbox, Radio, Switch,
+NumberInput and outlined Button — anything using the control-edge tier. It does
+**not** touch decorative borders (card and panel hairlines stay soft), and it
+does not touch the chromatic ramps, so an outlined Button on a colour is
+unchanged.
+
+Composes with everything else — it is a plain attribute, like `.dark` and
+`data-shape`:
+
+```html
+<html class="dark" data-shape="sharp" data-contrast="high">
+```
+
+**Two things worth knowing.**
+
+If you override the neutral ramp, high contrast follows automatically — the
+block resolves `--neutral-8` / `--neutral-9` by name rather than hard-coding
+hexes, so a rebrand gets a correctly-scaled high-contrast mode for free.
+
+If you want the *opposite* — compliant edges everywhere, with no attribute to
+remember — set the tokens directly and skip the attribute entirely:
+
+```css
+:root {
+  --color-surface-border-interactive:        var(--neutral-8);
+  --color-surface-border-interactive-strong: var(--neutral-9);
+}
+```
+
+That is worth considering. A default is what most products ship, so leaving the
+attribute unset means shipping the edge that misses 1.4.11.
+
 ## Forced colors (Windows high-contrast)
 
 If you override semantic colors, the `@media (forced-colors: active)` block in `semantic.css` continues to remap to system keywords. Your override is ignored when the user is in high-contrast mode — this is the correct behavior.

package/skill/references/server-components.md

@@ -80,7 +80,7 @@ export function MyButton() {
 |---|---|
 | `ContentCard` | All other composed components become client islands when rendered |
 | `PageHeader` | |
-| `LoadingSkeleton` | |
+| `CardSkeleton` / `TableSkeleton` / `BoardSkeleton` / `ListSkeleton` | |
 | `PageSkeletons` | |
 
 ### `@devalok/shilp-sutra/shell`
@@ -129,20 +129,23 @@ All shilp-sutra components SSR cleanly. They have no client-only side effects at
 
 Use `<Suspense>` boundaries normally:
 
+<!-- typecheck-skip: ClientHeavyComponent is the reader's own component -->
 ```tsx
 import { Suspense } from "react";
-import { LoadingSkeleton } from "@devalok/shilp-sutra/composed/loading-skeleton";
+import { CardSkeleton } from "@devalok/shilp-sutra/composed/loading-skeleton";
 
 export default function Page() {
   return (
-    <Suspense fallback={<LoadingSkeleton variant="page" />}>
+    <Suspense fallback={<CardSkeleton />}>
       <ClientHeavyComponent />
     </Suspense>
   );
 }
 ```
 
-Both `<Suspense>` and `<LoadingSkeleton>` are server-safe.
+Both `<Suspense>` and the skeletons are server-safe. The module exports
+`CardSkeleton`, `TableSkeleton`, `BoardSkeleton` and `ListSkeleton` — pick the
+one whose shape matches what is loading.
 
 ## Common RSC mistakes
 

package/skill/references/setup-astro.md

@@ -38,10 +38,10 @@ Some components ship hard peers as optional. **Install BEFORE first import.**
 | When you import… | Install |
 |---|---|
 | `@devalok/shilp-sutra/composed/date-picker` | `pnpm add date-fns` |
+| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/file-preview` | `pnpm add react-pdf react-zoom-pan-pinch` |
 | `@devalok/shilp-sutra/composed/markdown-viewer` | `pnpm add react-markdown react-syntax-highlighter remark-gfm` |
 | `@devalok/shilp-sutra/composed/rich-chat-input` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion date-fns` |
-| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/rich-text-editor` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion` |
 | `@devalok/shilp-sutra/composed/schedule-view` | `pnpm add date-fns` |
 | `@devalok/shilp-sutra/ui/charts` | `pnpm add d3-axis d3-scale d3-selection d3-shape` |

package/skill/references/setup-next-app-router.md

@@ -51,10 +51,10 @@ Some components depend on third-party libraries that ship as optional peers. **I
 | When you import… | Install |
 |---|---|
 | `@devalok/shilp-sutra/composed/date-picker` | `pnpm add date-fns` |
+| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/file-preview` | `pnpm add react-pdf react-zoom-pan-pinch` |
 | `@devalok/shilp-sutra/composed/markdown-viewer` | `pnpm add react-markdown react-syntax-highlighter remark-gfm` |
 | `@devalok/shilp-sutra/composed/rich-chat-input` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion date-fns` |
-| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/rich-text-editor` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion` |
 | `@devalok/shilp-sutra/composed/schedule-view` | `pnpm add date-fns` |
 | `@devalok/shilp-sutra/ui/charts` | `pnpm add d3-axis d3-scale d3-selection d3-shape` |

package/skill/references/setup-next-pages.md

@@ -18,7 +18,28 @@ If both `app/` and `pages/` exist, prefer [install-next-app-router.md](./install
 
 Same dependencies as the App Router recipe — see [install-next-app-router.md § 2](./install-next-app-router.md#2-install-dependencies). Replace `next-themes`'s `attribute="class"` setup with the same on Pages Router (it works identically).
 
-**Optional peer dependencies** — if you'll render `<DataTable>`, any chart, `<DatePicker>`, `<ScheduleView>`, `<InputOTP>`, `<FilePreview>`, `<MarkdownViewer>`, or `<Toaster>`, install the matching peers BEFORE first import. (The emoji picker and rich-text editors bundle their deps — no install needed; `@tabler/icons-react` auto-installs as a required peer.) Full table at [install-next-app-router.md § 2a](./install-next-app-router.md#2a-optional-peer-dependencies-install-only-when-importing-the-matching-subpath) — identical for Pages Router.
+### 2a. Optional peer dependencies (install only when importing the matching subpath)
+
+Some components depend on third-party libraries that ship as optional peers. **Install BEFORE first import** of the matching component, or `next build` will exit with `Module not found`. Skip entirely if you only use core components (`Button`, `Text`, `Stack`, `Dialog`, `Toast`, `Form*`, `Input`, `Card`, etc.).
+
+| When you import… | Install |
+|---|---|
+| `@devalok/shilp-sutra/composed/date-picker` | `pnpm add date-fns` |
+| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
+| `@devalok/shilp-sutra/composed/file-preview` | `pnpm add react-pdf react-zoom-pan-pinch` |
+| `@devalok/shilp-sutra/composed/markdown-viewer` | `pnpm add react-markdown react-syntax-highlighter remark-gfm` |
+| `@devalok/shilp-sutra/composed/rich-chat-input` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion date-fns` |
+| `@devalok/shilp-sutra/composed/rich-text-editor` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion` |
+| `@devalok/shilp-sutra/composed/schedule-view` | `pnpm add date-fns` |
+| `@devalok/shilp-sutra/ui/charts` | `pnpm add d3-axis d3-scale d3-selection d3-shape` |
+| `@devalok/shilp-sutra/ui/data-table` | `pnpm add @tanstack/react-table @tanstack/react-virtual` |
+| `@devalok/shilp-sutra/ui/data-table-toolbar` | `pnpm add @tanstack/react-table` |
+| `@devalok/shilp-sutra/ui/input-otp` | `pnpm add input-otp` |
+| `@devalok/shilp-sutra/ui/toast` | `pnpm add sonner` |
+| `@devalok/shilp-sutra/ui/toaster` | `pnpm add sonner` |
+| Any `Icon` / `IconButton` with Tabler icons (near-universal — most components use icons internally, so it is a base-install peer) | `pnpm add @tabler/icons-react` |
+
+> These aren't in core deps so consumers who never render a chart, OTP input, or rich-text editor don't pay the install / bundle cost. One-time decision at install.
 
 ## 3. PostCSS
 

package/skill/references/setup-remix.md

@@ -34,10 +34,10 @@ Some components ship hard peers as optional. **Install BEFORE first import.**
 | When you import… | Install |
 |---|---|
 | `@devalok/shilp-sutra/composed/date-picker` | `pnpm add date-fns` |
+| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/file-preview` | `pnpm add react-pdf react-zoom-pan-pinch` |
 | `@devalok/shilp-sutra/composed/markdown-viewer` | `pnpm add react-markdown react-syntax-highlighter remark-gfm` |
 | `@devalok/shilp-sutra/composed/rich-chat-input` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion date-fns` |
-| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/rich-text-editor` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion` |
 | `@devalok/shilp-sutra/composed/schedule-view` | `pnpm add date-fns` |
 | `@devalok/shilp-sutra/ui/charts` | `pnpm add d3-axis d3-scale d3-selection d3-shape` |

package/skill/references/setup-tanstack-start.md

@@ -43,10 +43,10 @@ Some components ship hard peers as optional. **Install BEFORE first import.**
 | When you import… | Install |
 |---|---|
 | `@devalok/shilp-sutra/composed/date-picker` | `pnpm add date-fns` |
+| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/file-preview` | `pnpm add react-pdf react-zoom-pan-pinch` |
 | `@devalok/shilp-sutra/composed/markdown-viewer` | `pnpm add react-markdown react-syntax-highlighter remark-gfm` |
 | `@devalok/shilp-sutra/composed/rich-chat-input` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion date-fns` |
-| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/rich-text-editor` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion` |
 | `@devalok/shilp-sutra/composed/schedule-view` | `pnpm add date-fns` |
 | `@devalok/shilp-sutra/ui/charts` | `pnpm add d3-axis d3-scale d3-selection d3-shape` |

package/skill/references/setup-vite.md

@@ -49,10 +49,10 @@ Some components ship hard peers as optional. **Install BEFORE first import.**
 | When you import… | Install |
 |---|---|
 | `@devalok/shilp-sutra/composed/date-picker` | `pnpm add date-fns` |
+| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/file-preview` | `pnpm add react-pdf react-zoom-pan-pinch` |
 | `@devalok/shilp-sutra/composed/markdown-viewer` | `pnpm add react-markdown react-syntax-highlighter remark-gfm` |
 | `@devalok/shilp-sutra/composed/rich-chat-input` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion date-fns` |
-| `@devalok/shilp-sutra/composed/diff` | `pnpm add react-syntax-highlighter` |
 | `@devalok/shilp-sutra/composed/rich-text-editor` | `pnpm add @tiptap/core @tiptap/extension-highlight @tiptap/extension-image @tiptap/extension-list @tiptap/extension-mention @tiptap/extension-text-align @tiptap/extensions @tiptap/markdown @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/suggestion` |
 | `@devalok/shilp-sutra/composed/schedule-view` | `pnpm add date-fns` |
 | `@devalok/shilp-sutra/ui/charts` | `pnpm add d3-axis d3-scale d3-selection d3-shape` |
@@ -139,6 +139,7 @@ export function ThemeToggle() {
 
 If you installed `sonner`, mount the Toaster once near the app root:
 
+<!-- typecheck-skip: imports the reader's own App entry -->
 ```tsx
 // src/main.tsx
 import { StrictMode } from "react";

package/skill/references/troubleshoot.md

@@ -93,6 +93,7 @@ After editing, delete the lockfile + `node_modules` and reinstall.
 
 Add:
 
+<!-- typecheck-skip: a fragment of next.config, not a standalone module -->
 ```ts
 transpilePackages: ["@devalok/shilp-sutra"],
 ```

package/dist/motion/check-motion-provider.d.ts

@@ -1,2 +0,0 @@
-export declare function checkMotionProvider(): void;
-//# sourceMappingURL=check-motion-provider.d.ts.map

package/dist/motion/check-motion-provider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"check-motion-provider.d.ts","sourceRoot":"","sources":["../../src/motion/check-motion-provider.ts"],"names":[],"mappings":"AAWA,wBAAgB,mBAAmB,IAAI,IAAI,CAiB1C"}

package/dist/motion/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/motion/check-motion-provider.ts","../../src/motion/index.ts"],"sourcesContent":["/**\n * Dev-mode hint for missing MotionProvider.\n *\n * If the consumer hasn't wrapped their app in <MotionProvider>, Framer Motion\n * animations still work but reduced-motion preferences won't propagate through\n * MotionConfig. This check emits a one-time console.info in dev mode.\n *\n * Only runs once, only in development, only in the browser.\n */\nlet checked = false\n\nexport function checkMotionProvider(): void {\n  if (checked) return\n  if (typeof window === 'undefined') return\n\n  // Skip in production\n  try {\n    // @ts-expect-error -- import.meta.env is Vite-specific, not in base TS lib\n    if (import.meta.env?.PROD) return\n  } catch { /* not in Vite */ }\n\n  checked = true\n\n  // eslint-disable-next-line no-console\n  console.info(\n    '[shilp-sutra] Tip: Wrap your app in <MotionProvider> for reduced-motion support ' +\n    'across all shilp-sutra animations. See https://www.npmjs.com/package/@devalok/shilp-sutra',\n  )\n}\n","export { motionProps, type SpringPreset, springs, stagger, type TweenPreset,tweens, withReducedMotion } from '../ui/lib/motion'\nexport { MotionProvider, type MotionProviderProps,useMotion } from './motion-provider'\n\nimport { checkMotionProvider } from './check-motion-provider'\ncheckMotionProvider()\n"],"mappings":";;;AASA,IAAI,IAAU;AAEd,SAAgB,IAA4B;CACtC,UACA,SAAO,SAAW,MAGtB;MAAI;GAEyB;EAC7B,QAAQ,CAAoB;EAK5B,AAHA,IAAU,IAGV,QAAQ,KACN,2KAEF;CAR4B;AAS9B;;;ACxBA,EAAoB"}