@alexgorbatchev/shadcn 0.0.23 → 0.0.24

package/llms/components/actions/Button.md

@@ -29,7 +29,7 @@ Button
 {
     variant: {
         control: "select",
-        options: ["default", "outline", "secondary", "ghost", "destructive", "success", "warning", "link"],
+        options: ["default", "outline", "secondary", "ghost", "destructive", "success", "warning", "link", "pad"],
     },
     size: {
         control: "select",
@@ -119,6 +119,22 @@ Storybook CSF excerpts. Default args and render apply unless overridden. Local h
 }
 ```
 
+### Pad
+
+```tsx
+{
+    args: { variant: "pad", size: "content" }
+}
+```
+
+### DisabledPad
+
+```tsx
+{
+    args: { variant: "pad", size: "content", disabled: true }
+}
+```
+
 ### Disabled
 
 ```tsx

package/llms/components/data-display/Avatar.md

@@ -27,7 +27,7 @@ Avatar
 ## Story controls
 
 ```tsx
-{ size: { control: "select", options: ["default", "sm", "lg", "preview"] } }
+{ size: { control: "select", options: ["default", "sm", "lg", "preview", "full"] } }
 ```
 
 ## Default render
@@ -67,6 +67,19 @@ Storybook CSF excerpts. Default args and render apply unless overridden. Local h
 }
 ```
 
+### FullWidth
+
+```tsx
+{
+    args: { size: "full", shape: "square" },
+    decorators: [
+        (Story) => (<div data-testid="Avatar--container" className="w-52">
+        <Story />
+      </div>),
+    ]
+}
+```
+
 ### Square
 
 ```tsx

package/llms/components/navigation/Sidebar.md

@@ -17,7 +17,7 @@ import { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupActio
 import type { Input } from "@base-ui/react/input";
 import type { ComponentProps, ReactElement } from "react";
 import { useRef, useState } from "react";
-import { FileIcon, HomeIcon, PlusIcon } from "lucide-react";
+import { FileIcon, HomeIcon, PlusIcon, SettingsIcon } from "lucide-react";
 ```
 
 ## Default component
@@ -48,7 +48,7 @@ Storybook CSF excerpts. Default args and render apply unless overridden. Local h
 
 ```tsx
 {
-    render: () => <WorkspaceLayout />
+    render: (args) => <WorkspaceLayout {...args}/>
 }
 ```
 
@@ -217,7 +217,16 @@ Storybook CSF excerpts. Default args and render apply unless overridden. Local h
 {
     render: (args) => (<SidebarProvider>
       <Sidebar {...args} aria-label="Loading projects">
-        <SidebarHeader>Loading projects</SidebarHeader>
+        <SidebarHeader>
+          <SidebarMenu>
+            <SidebarMenuItem>
+              <SidebarMenuButton disabled>
+                <HomeIcon aria-hidden/>
+                <span>Loading projects</span>
+              </SidebarMenuButton>
+            </SidebarMenuItem>
+          </SidebarMenu>
+        </SidebarHeader>
         <SidebarContent>
           <SidebarMenu>
             <SidebarMenuItem>
@@ -250,7 +259,10 @@ Storybook CSF excerpts. Default args and render apply unless overridden. Local h
                 <SidebarGroupContent>
                   <SidebarMenu>
                     <SidebarMenuItem>
-                      <SidebarMenuButton render={<a href="#folder"/>}>Folder link</SidebarMenuButton>
+                      <SidebarMenuButton render={<a href="#folder"/>}>
+                        <FileIcon aria-hidden/>
+                        <span>Folder link</span>
+                      </SidebarMenuButton>
                     </SidebarMenuItem>
                   </SidebarMenu>
                 </SidebarGroupContent>
@@ -328,3 +340,31 @@ Storybook CSF excerpts. Default args and render apply unless overridden. Local h
 ```tsx
 {}
 ```
+
+### WorkspaceMenusCompactRight
+
+```tsx
+{
+    render: (args) => <WorkspaceLayout {...args}/>,
+    args: { side: "right" },
+    globals: { density: "compact", theme: "light" }
+}
+```
+
+### RightCompactDensity
+
+```tsx
+{
+    args: { side: "right" },
+    globals: { density: "compact", theme: "light" }
+}
+```
+
+### RightComfortableDensity
+
+```tsx
+{
+    args: { side: "right" },
+    globals: { density: "comfortable", theme: "light" }
+}
+```

package/llms/components/providers/LayoutGuard.md

@@ -0,0 +1,24 @@
+# LayoutGuard
+
+ThemeProvider installs LayoutGuard in development. Mark a surface with data-layout-boundary="" to check both axes, or "x" / "y" for one axis. collectLayoutViolations(root, tolerance = 1) returns elements, edges, pixel overflow, and diagnostic messages for browser assertions. Checks include text ranges and clipped controls. Native scroll viewports permit displacement on their scrolling axes. Hidden/inert content and screen-reader labels are excluded; ellipsis text is allowed. Use data-layout-exclude="reason" only for intentional escape such as an edge-mounted resize rail. Portals are independent: mark their own surfaces. Finite layout animations settle before development errors; production installs no observer. Check every meaningful interaction state in tests. Axis-aligned DOM geometry does not measure shadows, pseudo-elements, or painted SVG paths.
+
+Story: @alexgorbatchev/shadcn/components/providers/LayoutGuard
+Source: src/components/stories/providers/LayoutGuard.stories.tsx
+
+[Full source and local helpers](https://github.com/alexgorbatchev/shadcn/blob/main/src/components/stories/providers/LayoutGuard.stories.tsx)
+
+## Public imports
+
+```tsx
+import { LayoutGuard } from "@alexgorbatchev/shadcn";
+```
+
+## Default component
+
+```tsx
+LayoutGuard
+```
+
+## Examples
+
+Storybook CSF excerpts. Default args and render apply unless overridden. Local helpers, fixtures, decorators, and providers may be required; these are reference excerpts, not standalone consumer modules. Interaction tests are omitted.

package/llms.txt

@@ -457,6 +457,7 @@ Generated from the public package exports and Storybook sources.
 
 - [DensityProvider](./llms/components/providers/DensityProvider.md)
 - [DirectionProvider](./llms/components/providers/DirectionProvider.md)
+- [LayoutGuard](./llms/components/providers/LayoutGuard.md): ThemeProvider installs LayoutGuard in development. Mark a surface with data-layout-boundary="" to check both axes, or "x" / "y" for one axis. collectLayoutViolations(root, tolerance = 1) returns elements, edges, pixel overflow, and diagnostic messages for browser assertions. Checks include text ranges and clipped controls. Native scroll viewports permit displacement on their scrolling axes. Hidden/inert content and screen-reader labels are excluded; ellipsis text is allowed. Use data-layout-exclude="reason" only for intentional escape such as an edge-mounted resize rail. Portals are independent: mark their own surfaces. Finite layout animations settle before development errors; production installs no observer. Check every meaningful interaction state in tests. Axis-aligned DOM geometry does not measure shadows, pseudo-elements, or painted SVG paths.
 - [PortalProvider](./llms/components/providers/PortalProvider.md)
 - [ScrollGuard](./llms/components/providers/ScrollGuard.md): ThemeProvider mounts ScrollGuard automatically in development. Mark any HTML element with data-scroll="none" to reject accidental scrolling on that element. Place intentional scrolling in a nested ScrollArea or native scroll viewport. Errors identify the offending element and axis. Production builds install no observers.
 - [ThemeProvider](./llms/components/providers/ThemeProvider.md): The preview decorator owns one document-wide ThemeProvider. These controls change its persisted preference. The theme toolbar can force a palette on any other story.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexgorbatchev/shadcn",
-  "version": "0.0.23",
+  "version": "0.0.24",
   "description": "Sharp, monospace React components with compact and comfortable densities.",
   "license": "MIT",
   "repository": {