@krizaka/ui 3.29.0 → 3.31.0

package/registry/examples/marketing-layout/pricing.tsx

@@ -36,7 +36,7 @@ export default function MarketingLayoutPricing() {
                     <li key={x}>— {x}</li>
                   ))}
                 </ul>
-                <Button variant={p.featured ? "primary" : "secondary"} shape="cut" className="mt-auto w-full">
+                <Button variant={p.featured ? "primary" : "secondary"} className="mt-auto w-full">
                   Choose {p.name}
                 </Button>
               </GlowCard>

package/registry/examples/marketing-layout/product-page.js

@@ -50,7 +50,7 @@ function MarketingLayoutProductPage() {
             aside: /* @__PURE__ */ jsx(Mascot, { bird: "owl", mood: "welcome", size: 112 }),
             children: [
               /* @__PURE__ */ jsx(Facts, { items: [{ label: "Apache-2.0", tone: "ok" }, { label: "Law 25 \xB7 GDPR" }] }),
-              /* @__PURE__ */ jsx(Button, { variant: "primary", size: "lg", shape: "cut", shimmer: true, children: "Install in three commands" })
+              /* @__PURE__ */ jsx(Button, { variant: "primary", size: "lg", children: "Install in three commands" })
             ]
           }
         ),

package/registry/examples/marketing-layout/product-page.tsx

@@ -23,7 +23,7 @@ const DECISIONS = [
 ];
 const labels = { chose: "We chose", refused: "We refused", because: "Because", cost: "What it costs you" };
 
-// TEMPLATE — a product page (Orazaka): the hero with its facts and its main action (cut, shimmer), the reasons as compact
+// TEMPLATE — a product page (Orazaka): the hero with its facts and its main action, the reasons as compact
 // argument cards (the bird in the corner), the decisions with their cost, the owl's promise, the closing call. On a
 // phone the hero's bird goes above the title, the cards stack, the decisions' three parts stack under the choice.
 export default function MarketingLayoutProductPage() {
@@ -48,7 +48,7 @@ export default function MarketingLayoutProductPage() {
           aside={<Mascot bird="owl" mood="welcome" size={112} />}
         >
           <Facts items={[{ label: "Apache-2.0", tone: "ok" }, { label: "Law 25 · GDPR" }]} />
-          <Button variant="primary" size="lg" shape="cut" shimmer>Install in three commands</Button>
+          <Button variant="primary" size="lg">Install in three commands</Button>
         </PageHero>
         <Section id="why" eyebrow="Why" title="Three traps it removes">
           <CardGrid min={260} fit="fit" reveal={false}>

package/registry/examples/nav-bar/family-product.js

@@ -29,7 +29,7 @@ function NavBarFamilyProduct() {
         language
       ] }),
       /* @__PURE__ */ jsx(Button, { asChild: true, variant: "ghost", size: "sm", className: "hidden md:inline-flex", children: /* @__PURE__ */ jsx("a", { href: "#sign-in", children: "Sign in" }) }),
-      /* @__PURE__ */ jsx(Button, { asChild: true, variant: "primary", size: "sm", shape: "cut", className: "hidden md:inline-flex", children: /* @__PURE__ */ jsx("a", { href: "#talk", children: "Talk to us" }) }),
+      /* @__PURE__ */ jsx(Button, { asChild: true, variant: "primary", size: "sm", className: "hidden md:inline-flex", children: /* @__PURE__ */ jsx("a", { href: "#talk", children: "Talk to us" }) }),
       /* @__PURE__ */ jsxs(NavBar.Mobile, { openLabel: "Open the menu", closeLabel: "Close the menu", children: [
         groups.map((g) => /* @__PURE__ */ jsx(NavBar.MobileGroup, { label: g.label, children: g.links.map(([href, title]) => /* @__PURE__ */ jsx(NavBar.MobileLink, { href, children: title }, href)) }, g.id)),
         /* @__PURE__ */ jsx(NavBar.MobileLink, { href: "#docs", children: "Docs" }),

package/registry/examples/nav-bar/family-product.tsx

@@ -26,7 +26,7 @@ export default function NavBarFamilyProduct() {
         <NavBar.Actions>
           <span className="hidden items-center gap-1 md:inline-flex">{theme}{language}</span>
           <Button asChild variant="ghost" size="sm" className="hidden md:inline-flex"><a href="#sign-in">Sign in</a></Button>
-          <Button asChild variant="primary" size="sm" shape="cut" className="hidden md:inline-flex"><a href="#talk">Talk to us</a></Button>
+          <Button asChild variant="primary" size="sm" className="hidden md:inline-flex"><a href="#talk">Talk to us</a></Button>
           <NavBar.Mobile openLabel="Open the menu" closeLabel="Close the menu">
             {groups.map((g) => (
               <NavBar.MobileGroup key={g.id} label={g.label}>{g.links.map(([href, title]) => <NavBar.MobileLink key={href} href={href}>{title}</NavBar.MobileLink>)}</NavBar.MobileGroup>

package/registry/examples/pricing-page/credits.js

@@ -15,9 +15,9 @@ function PricingPageCredits() {
       lead: "Credits buy answers, images and minutes of video \u2014 never a seat you do not use.",
       plansLabel: "Plans",
       plans: [
-        { id: "community", name: "Community", price: "Free", unit: "self-hosted", features: ["Every feature", "Your hardware"], action: /* @__PURE__ */ jsx(Button, { variant: "secondary", shape: "cut", className: "w-full", children: "Install" }) },
-        { id: "workspace", name: "Workspace", price: "CA$29", unit: "per month \xB7 12,000 credits", features: ["Packs & Studios", "Shared workspaces"], featured: true, badge: "Most chosen", action: /* @__PURE__ */ jsx(Button, { variant: "primary", shape: "cut", shimmer: true, className: "w-full", children: "Choose Workspace" }) },
-        { id: "sovereign", name: "Sovereign", price: "Custom", unit: "on your servers", features: ["Installed with you", "A named engineer"], action: /* @__PURE__ */ jsx(Button, { variant: "secondary", shape: "cut", className: "w-full", children: "Talk to us" }) }
+        { id: "community", name: "Community", price: "Free", unit: "self-hosted", features: ["Every feature", "Your hardware"], action: /* @__PURE__ */ jsx(Button, { variant: "secondary", className: "w-full", children: "Install" }) },
+        { id: "workspace", name: "Workspace", price: "CA$29", unit: "per month \xB7 12,000 credits", features: ["Packs & Studios", "Shared workspaces"], featured: true, badge: "Most chosen", action: /* @__PURE__ */ jsx(Button, { variant: "primary", className: "w-full", children: "Choose Workspace" }) },
+        { id: "sovereign", name: "Sovereign", price: "Custom", unit: "on your servers", features: ["Installed with you", "A named engineer"], action: /* @__PURE__ */ jsx(Button, { variant: "secondary", className: "w-full", children: "Talk to us" }) }
       ],
       compare: {
         caption: "Compare the plans",

package/registry/examples/pricing-page/credits.tsx

@@ -13,9 +13,9 @@ export default function PricingPageCredits() {
       lead="Credits buy answers, images and minutes of video — never a seat you do not use."
       plansLabel="Plans"
       plans={[
-        { id: "community", name: "Community", price: "Free", unit: "self-hosted", features: ["Every feature", "Your hardware"], action: <Button variant="secondary" shape="cut" className="w-full">Install</Button> },
-        { id: "workspace", name: "Workspace", price: "CA$29", unit: "per month · 12,000 credits", features: ["Packs & Studios", "Shared workspaces"], featured: true, badge: "Most chosen", action: <Button variant="primary" shape="cut" shimmer className="w-full">Choose Workspace</Button> },
-        { id: "sovereign", name: "Sovereign", price: "Custom", unit: "on your servers", features: ["Installed with you", "A named engineer"], action: <Button variant="secondary" shape="cut" className="w-full">Talk to us</Button> },
+        { id: "community", name: "Community", price: "Free", unit: "self-hosted", features: ["Every feature", "Your hardware"], action: <Button variant="secondary" className="w-full">Install</Button> },
+        { id: "workspace", name: "Workspace", price: "CA$29", unit: "per month · 12,000 credits", features: ["Packs & Studios", "Shared workspaces"], featured: true, badge: "Most chosen", action: <Button variant="primary" className="w-full">Choose Workspace</Button> },
+        { id: "sovereign", name: "Sovereign", price: "Custom", unit: "on your servers", features: ["Installed with you", "A named engineer"], action: <Button variant="secondary" className="w-full">Talk to us</Button> },
       ]}
       compare={{
         caption: "Compare the plans",

package/registry/examples/product-page/orazaka.js

@@ -18,7 +18,7 @@ function ProductPageOrazaka() {
       title: "The AI that never leaves home",
       lead: "Chat, image, voice and video on your own server \u2014 one governed pipeline, nothing sent anywhere.",
       facts: [{ label: "Apache-2.0", tone: "ok" }, { label: "Law 25 \xB7 GDPR" }],
-      actions: /* @__PURE__ */ jsx(Button, { variant: "primary", size: "lg", shape: "cut", shimmer: true, children: "Install in three commands" }),
+      actions: /* @__PURE__ */ jsx(Button, { variant: "primary", size: "lg", children: "Install in three commands" }),
       visualLabel: "orazaka.local \u2014 chat",
       visual: /* @__PURE__ */ jsx("p", { className: "p-6 text-sm text-fg-secondary", children: "\u201CSummarise the lease in plain French.\u201D \u2014 answered locally in 1.8 s." }),
       reasonsHeading: { eyebrow: "Why", title: "Three traps it removes" },
@@ -35,7 +35,7 @@ function ProductPageOrazaka() {
         items: [{ id: "local", chose: "Local models by default.", refused: "A hosted API by default.", because: "A prompt that never leaves cannot leak.", cost: "A GPU, or patience." }]
       },
       promise: { bird: "owl", label: "The owl's promise", text: "Every personal record stays in Qu\xE9bec, and you can read who touched it." },
-      closing: { title: "Ready to run it at home?", actions: /* @__PURE__ */ jsx(Button, { variant: "primary", size: "lg", shape: "cut", children: "Install" }) }
+      closing: { title: "Ready to run it at home?", actions: /* @__PURE__ */ jsx(Button, { variant: "primary", size: "lg", children: "Install" }) }
     }
   );
 }

package/registry/examples/product-page/orazaka.tsx

@@ -13,7 +13,7 @@ export default function ProductPageOrazaka() {
       title="The AI that never leaves home"
       lead="Chat, image, voice and video on your own server — one governed pipeline, nothing sent anywhere."
       facts={[{ label: "Apache-2.0", tone: "ok" }, { label: "Law 25 · GDPR" }]}
-      actions={<Button variant="primary" size="lg" shape="cut" shimmer>Install in three commands</Button>}
+      actions={<Button variant="primary" size="lg">Install in three commands</Button>}
       visualLabel="orazaka.local — chat"
       visual={<p className="p-6 text-sm text-fg-secondary">“Summarise the lease in plain French.” — answered locally in 1.8 s.</p>}
       reasonsHeading={{ eyebrow: "Why", title: "Three traps it removes" }}
@@ -30,7 +30,7 @@ export default function ProductPageOrazaka() {
         items: [{ id: "local", chose: "Local models by default.", refused: "A hosted API by default.", because: "A prompt that never leaves cannot leak.", cost: "A GPU, or patience." }],
       }}
       promise={{ bird: "owl", label: "The owl's promise", text: "Every personal record stays in Québec, and you can read who touched it." }}
-      closing={{ title: "Ready to run it at home?", actions: <Button variant="primary" size="lg" shape="cut">Install</Button> }}
+      closing={{ title: "Ready to run it at home?", actions: <Button variant="primary" size="lg">Install</Button> }}
     />
   );
 }

package/registry/examples/settings-layout/account.js

@@ -20,7 +20,7 @@ function SettingsLayoutAccount() {
         id: "profile",
         title: "Profile",
         description: "What your fans see.",
-        footer: /* @__PURE__ */ jsx(Button, { size: "sm", variant: "primary", shape: "cut", children: "Save the profile" }),
+        footer: /* @__PURE__ */ jsx(Button, { size: "sm", variant: "primary", children: "Save the profile" }),
         children: [
           /* @__PURE__ */ jsxs(Field.Root, { children: [
             /* @__PURE__ */ jsx(Field.Label, { htmlFor: "settings-name", children: "Display name" }),

package/registry/examples/settings-layout/account.tsx

@@ -19,7 +19,7 @@ export default function SettingsLayoutAccount() {
         id="profile"
         title="Profile"
         description="What your fans see."
-        footer={<Button size="sm" variant="primary" shape="cut">Save the profile</Button>}
+        footer={<Button size="sm" variant="primary">Save the profile</Button>}
       >
         <Field.Root>
           <Field.Label htmlFor="settings-name">Display name</Field.Label>

package/registry/examples/settings-layout/sections.js

@@ -15,7 +15,7 @@ function SettingsLayoutSections() {
         { id: "models", label: "Models", href: "#models" }
       ],
       navLabel: "Settings sections",
-      children: /* @__PURE__ */ jsx(SettingsSection, { title: "Workspace", footer: /* @__PURE__ */ jsx(Button, { size: "sm", variant: "primary", shape: "cut", children: "Save" }), children: /* @__PURE__ */ jsxs(Field.Root, { children: [
+      children: /* @__PURE__ */ jsx(SettingsSection, { title: "Workspace", footer: /* @__PURE__ */ jsx(Button, { size: "sm", variant: "primary", children: "Save" }), children: /* @__PURE__ */ jsxs(Field.Root, { children: [
         /* @__PURE__ */ jsx(Field.Label, { htmlFor: "sections-name", children: "Name" }),
         /* @__PURE__ */ jsx(Input, { id: "sections-name", defaultValue: "Tremblay & associ\xE9s" })
       ] }) })

package/registry/examples/settings-layout/sections.tsx

@@ -13,7 +13,7 @@ export default function SettingsLayoutSections() {
       ]}
       navLabel="Settings sections"
     >
-      <SettingsSection title="Workspace" footer={<Button size="sm" variant="primary" shape="cut">Save</Button>}>
+      <SettingsSection title="Workspace" footer={<Button size="sm" variant="primary">Save</Button>}>
         <Field.Root>
           <Field.Label htmlFor="sections-name">Name</Field.Label>
           <Input id="sections-name" defaultValue="Tremblay & associés" />

package/registry/examples/split-view/messages.js

@@ -38,7 +38,7 @@ function SplitViewMessages() {
             /* @__PURE__ */ jsx(Field.Label, { htmlFor: "reply", className: "sr-only", children: "Reply to L\xE9a" }),
             /* @__PURE__ */ jsx(Textarea, { id: "reply", rows: 2, placeholder: "Write a reply\u2026" })
           ] }),
-          /* @__PURE__ */ jsx(Button, { type: "submit", variant: "primary", shape: "cut", children: "Send" })
+          /* @__PURE__ */ jsx(Button, { type: "submit", variant: "primary", children: "Send" })
         ] })
       ] })
     }

package/registry/examples/split-view/messages.tsx

@@ -43,7 +43,7 @@ export default function SplitViewMessages() {
               <Field.Label htmlFor="reply" className="sr-only">Reply to Léa</Field.Label>
               <Textarea id="reply" rows={2} placeholder="Write a reply…" />
             </Field.Root>
-            <Button type="submit" variant="primary" shape="cut">Send</Button>
+            <Button type="submit" variant="primary">Send</Button>
           </form>
         </div>
       }

package/registry/examples/status-page/building.js

@@ -19,7 +19,7 @@ function StatusPageBuilding() {
       checked: "Updated this week",
       children: /* @__PURE__ */ jsxs("div", { className: "flex max-w-md flex-col gap-4", children: [
         /* @__PURE__ */ jsx(Progress, { value: 40, label: "First build", showLabel: true, valueText: "4 of 10 milestones" }),
-        /* @__PURE__ */ jsx(Button, { variant: "primary", shape: "cut", className: "w-fit", children: "Tell me when it is ready" })
+        /* @__PURE__ */ jsx(Button, { variant: "primary", className: "w-fit", children: "Tell me when it is ready" })
       ] })
     }
   );

package/registry/examples/status-page/building.tsx

@@ -18,7 +18,7 @@ export default function StatusPageBuilding() {
     >
       <div className="flex max-w-md flex-col gap-4">
         <Progress value={40} label="First build" showLabel valueText="4 of 10 milestones" />
-        <Button variant="primary" shape="cut" className="w-fit">Tell me when it is ready</Button>
+        <Button variant="primary" className="w-fit">Tell me when it is ready</Button>
       </div>
     </StatusPage>
   );

package/registry/examples/sticky-action/phone.js

@@ -7,7 +7,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
 function StickyActionPhone() {
   return /* @__PURE__ */ jsxs("main", { className: "flex h-[28rem] flex-col overflow-auto", children: [
     /* @__PURE__ */ jsx("p", { className: "m-0 h-[40rem] p-4 text-fg-secondary", children: "The page scrolls here\u2026" }),
-    /* @__PURE__ */ jsx(StickyAction, { children: /* @__PURE__ */ jsx(Button, { size: "lg", shape: "cut", variant: "primary", children: "Book" }) })
+    /* @__PURE__ */ jsx(StickyAction, { children: /* @__PURE__ */ jsx(Button, { size: "lg", variant: "primary", children: "Book" }) })
   ] });
 }
 export {

package/registry/examples/sticky-action/phone.tsx

@@ -7,7 +7,7 @@ export default function StickyActionPhone() {
     <main className="flex h-[28rem] flex-col overflow-auto">
       <p className="m-0 h-[40rem] p-4 text-fg-secondary">The page scrolls here…</p>
       <StickyAction>
-        <Button size="lg" shape="cut" variant="primary">Book</Button>
+        <Button size="lg" variant="primary">Book</Button>
       </StickyAction>
     </main>
   );

package/registry/force-update-screen.json

@@ -231,7 +231,7 @@
   "files": [
     {
       "path": "force-update-screen/force-update-screen.tsx",
-      "content": "// Server-safe. The blocking screen: this version can no longer run. It replaces the app, it is not laid over it —\n// nothing behind it is reachable. Every word is a prop; the store URL and the versions come from the backend.\nimport { Button } from \"@krizaka/ui/button\";\nimport type * as React from \"react\";\nimport { tv } from \"tailwind-variants\";\n\nexport const forceUpdateScreen = tv({\n  slots: {\n    root: \"mx-auto flex min-h-dvh w-full max-w-md flex-col items-center justify-center gap-4 px-6 py-12 text-center text-fg\",\n    mark: \"flex h-24 w-24 items-center justify-center [&>svg]:h-24 [&>svg]:w-24\",\n    title: \"text-2xl font-semibold text-fg\",\n    message: \"text-fg-secondary\",\n    version: \"font-mono text-xs text-fg-tertiary\",\n    actions: \"mt-2 flex w-full flex-col gap-2\",\n  },\n});\n\nexport type ForceUpdateScreenProps = Omit<React.ComponentProps<\"main\">, \"title\"> & {\n  /** The headline (“Update to keep going”). */\n  title: React.ReactNode;\n  /** Why, in a sentence — the backend's localized `message`. */\n  message?: React.ReactNode;\n  /** The versions, in words and mono (“You have 1.1.0 · 1.2.0 or later is required”). */\n  versionLabel?: React.ReactNode;\n  /** The product's mark or mascot (decorative). */\n  mark?: React.ReactNode;\n  /** The button that updates (“Update the app”). */\n  updateLabel: string;\n  /** Opens the store page. */\n  onUpdate: () => void;\n  /** A secondary way (“Check again”) once the update is installed — optional. */\n  retryLabel?: string;\n  /** Checks the backend again. */\n  onRetry?: () => void;\n};\n\n/** The forced update: one thing to do, and the way to do it. */\nexport function ForceUpdateScreen({ title, message, versionLabel, mark, updateLabel, onUpdate, retryLabel, onRetry, className, ...props }: ForceUpdateScreenProps) {\n  const s = forceUpdateScreen();\n  return (\n    <main data-kind=\"update-force\" className={s.root({ className })} {...props}>\n      {mark && (\n        <div aria-hidden className={s.mark()}>\n          {mark}\n        </div>\n      )}\n      <h1 className={s.title()}>{title}</h1>\n      {message && <p className={s.message()}>{message}</p>}\n      {versionLabel && <p className={s.version()}>{versionLabel}</p>}\n      <div className={s.actions()}>\n        <Button variant=\"primary\" size=\"lg\" shape=\"cut\" shimmer autoFocus onClick={onUpdate}>\n          {updateLabel}\n        </Button>\n        {retryLabel && onRetry && (\n          <Button variant=\"ghost\" onClick={onRetry}>\n            {retryLabel}\n          </Button>\n        )}\n      </div>\n    </main>\n  );\n}\n"
+      "content": "// Server-safe. The blocking screen: this version can no longer run. It replaces the app, it is not laid over it —\n// nothing behind it is reachable. Every word is a prop; the store URL and the versions come from the backend.\nimport { Button } from \"@krizaka/ui/button\";\nimport type * as React from \"react\";\nimport { tv } from \"tailwind-variants\";\n\nexport const forceUpdateScreen = tv({\n  slots: {\n    root: \"mx-auto flex min-h-dvh w-full max-w-md flex-col items-center justify-center gap-4 px-6 py-12 text-center text-fg\",\n    mark: \"flex h-24 w-24 items-center justify-center [&>svg]:h-24 [&>svg]:w-24\",\n    title: \"text-2xl font-semibold text-fg\",\n    message: \"text-fg-secondary\",\n    version: \"font-mono text-xs text-fg-tertiary\",\n    actions: \"mt-2 flex w-full flex-col gap-2\",\n  },\n});\n\nexport type ForceUpdateScreenProps = Omit<React.ComponentProps<\"main\">, \"title\"> & {\n  /** The headline (“Update to keep going”). */\n  title: React.ReactNode;\n  /** Why, in a sentence — the backend's localized `message`. */\n  message?: React.ReactNode;\n  /** The versions, in words and mono (“You have 1.1.0 · 1.2.0 or later is required”). */\n  versionLabel?: React.ReactNode;\n  /** The product's mark or mascot (decorative). */\n  mark?: React.ReactNode;\n  /** The button that updates (“Update the app”). */\n  updateLabel: string;\n  /** Opens the store page. */\n  onUpdate: () => void;\n  /** A secondary way (“Check again”) once the update is installed — optional. */\n  retryLabel?: string;\n  /** Checks the backend again. */\n  onRetry?: () => void;\n};\n\n/** The forced update: one thing to do, and the way to do it. */\nexport function ForceUpdateScreen({ title, message, versionLabel, mark, updateLabel, onUpdate, retryLabel, onRetry, className, ...props }: ForceUpdateScreenProps) {\n  const s = forceUpdateScreen();\n  return (\n    <main data-kind=\"update-force\" className={s.root({ className })} {...props}>\n      {mark && (\n        <div aria-hidden className={s.mark()}>\n          {mark}\n        </div>\n      )}\n      <h1 className={s.title()}>{title}</h1>\n      {message && <p className={s.message()}>{message}</p>}\n      {versionLabel && <p className={s.version()}>{versionLabel}</p>}\n      <div className={s.actions()}>\n        <Button variant=\"primary\" size=\"lg\" autoFocus onClick={onUpdate}>\n          {updateLabel}\n        </Button>\n        {retryLabel && onRetry && (\n          <Button variant=\"ghost\" onClick={onRetry}>\n            {retryLabel}\n          </Button>\n        )}\n      </div>\n    </main>\n  );\n}\n"
     },
     {
       "path": "force-update-screen/index.ts",

package/registry/form.json

@@ -741,7 +741,7 @@
             "name": "magnetic",
             "type": "boolean",
             "default": null,
-            "description": "The button leans a few pixels toward a fine pointer (driven by `MotionObserver`; never under reduced motion or on touch).",
+            "description": "@deprecated Since 3.31 (krizaka-ui#393): does nothing — a button never moves under the pointer. Removed in 4.0.",
             "required": false
           },
           {
@@ -755,14 +755,14 @@
             "name": "shape",
             "type": "\"rounded\" | \"pill\" | \"cut\"",
             "default": "rounded",
-            "description": "rounded · pill · cut (45° corners, the Krizaka chamfer).",
+            "description": "`rounded` (an 8 px radius, the radius of a field) · `pill`. `cut` is deprecated (krizaka-ui#393: the chamfer is\nretired) — it draws `rounded` and warns in development; it will be removed in 4.0.",
             "required": false
           },
           {
             "name": "shimmer",
             "type": "boolean",
             "default": null,
-            "description": "A sheen of light crosses the button on hover — for the one action a page is about.",
+            "description": "@deprecated Since 3.31 (krizaka-ui#393): does nothing — the hover is quiet. Removed in 4.0.",
             "required": false
           },
           {
@@ -2785,7 +2785,7 @@
           "name": "magnetic",
           "type": "boolean",
           "default": null,
-          "description": "The button leans a few pixels toward a fine pointer (driven by `MotionObserver`; never under reduced motion or on touch).",
+          "description": "@deprecated Since 3.31 (krizaka-ui#393): does nothing — a button never moves under the pointer. Removed in 4.0.",
           "required": false
         },
         {
@@ -2799,14 +2799,14 @@
           "name": "shape",
           "type": "\"rounded\" | \"pill\" | \"cut\"",
           "default": "rounded",
-          "description": "rounded · pill · cut (45° corners, the Krizaka chamfer).",
+          "description": "`rounded` (an 8 px radius, the radius of a field) · `pill`. `cut` is deprecated (krizaka-ui#393: the chamfer is\nretired) — it draws `rounded` and warns in development; it will be removed in 4.0.",
           "required": false
         },
         {
           "name": "shimmer",
           "type": "boolean",
           "default": null,
-          "description": "A sheen of light crosses the button on hover — for the one action a page is about.",
+          "description": "@deprecated Since 3.31 (krizaka-ui#393): does nothing — the hover is quiet. Removed in 4.0.",
           "required": false
         },
         {