@krizaka/ui 3.30.0 → 3.31.0

package/registry/link-card.json

@@ -2,8 +2,8 @@
   "name": "link-card",
   "type": "primitive",
   "title": "Link card",
-  "summary": "An entry point where the whole card is one link: an icon tile, a title, one sentence and the way in — compact, the same on every page, lifting and lighting under the pointer or the focus.",
-  "description": "An entry point where the whole card is one link: an icon tile, a title, one sentence and the way in — compact, the same on every page, lifting and lighting under the pointer or the focus.",
+  "summary": "An entry point where the whole card is one link: an icon tile, a title, one sentence and the way in — compact, the same on every page; under the pointer its surface and hairline go one step up, nothing moves.",
+  "description": "An entry point where the whole card is one link: an icon tile, a title, one sentence and the way in — compact, the same on every page; under the pointer its surface and hairline go one step up, nothing moves.",
   "status": "beta",
   "deprecated": null,
   "category": "blocks",
@@ -41,21 +41,20 @@
     "Use the product's mark or a signature icon as `icon`, never a placeholder.",
     "Pass the app's router link as `linkAs` (Next's `Link`) so internal links prefetch.",
     "In a row of cards at one height (`CardGrid`), the facts (`extra`) and the way in (`cta`) are pinned to the foot of each card, so they share a line whatever the length of the sentences; `footerAlign=\"top\"` keeps them under the text.",
-    "In a hub, keep the default `h3` titles under the section's `h2`; in a list of links, `titleAs=\"span\"`.",
-    "`hover=\"quiet\"` on a page of reading (a docs hub, a blog's index): no glow, a 2 px lift and a ring on focus, where the default `light` lights the card under the pointer. Set it on `CardGrid` to quiet a whole grid."
+    "In a hub, keep the default `h3` titles under the section's `h2`; in a list of links, `titleAs=\"span\"`."
   ],
   "accessibility": {
     "keyboard": [
       {
         "keys": "Tab",
-        "action": "Focuses the card, which lights and draws the focus ring like the pointer does."
+        "action": "Focuses the card: a 2 px ring of `--kz-ring` around it."
       }
     ],
     "notes": [
       "The card is a single link: its accessible name is its whole text — keep it short.",
       "An absolute address opens in a new tab with `rel=\"noopener noreferrer\"` and the external mark.",
-      "The icon and the arrow are decorative; the lift and the light stop under `prefers-reduced-motion`.",
-      "The quiet hover keeps the same text contrast in dark and light: it moves the surface and the hairline one step, and the title towards the accent text colour, never below it."
+      "The icon and the arrow are decorative; the arrow's lean stops under `prefers-reduced-motion`.",
+      "The hover keeps the same text contrast in dark and light: it moves the surface and the hairline one step, never the text below AA. `hover` is deprecated since 3.31 (krizaka-ui#393): there is one hover."
     ]
   },
   "related": [
@@ -74,7 +73,7 @@
       },
       {
         "component": "LinkCard",
-        "description": "An entry point: the whole card is one link — icon, title, sentence, the way in. Lifts and lights under the pointer.",
+        "description": "An entry point: the whole card is one link — icon, title, sentence, the way in. Its surface and hairline go one step up under the pointer; nothing moves.",
         "props": [
           {
             "name": "href",
@@ -122,7 +121,7 @@
             "name": "hover",
             "type": "CardHover",
             "default": null,
-            "description": "The hover of the card: `light` (the pointer's light, a coloured lift — the default) or `quiet` (no glow, a 2 px lift,\none step of surface and border, the focus as a ring). Unset, a card follows its grid (`CardGrid hover`).",
+            "description": "@deprecated Since 3.31 (krizaka-ui#393): does nothing — every card has the one quiet hover. Removed in 4.0.",
             "required": false
           },
           {
@@ -188,21 +187,13 @@
         "module": "@krizaka/ui/registry/examples/link-card/external",
         "code": "import { ProductLogo } from \"@krizaka/ui\";\nimport { LinkCard } from \"@krizaka/ui/link-card\";\n\n// An absolute address opens in a new tab and wears the external mark instead of the arrow.\nexport default function LinkCardExternal() {\n  return (\n    <LinkCard\n      className=\"max-w-sm\"\n      href=\"https://github.com/krizaka/krizaka-ui\"\n      icon={<ProductLogo id=\"krizaka\" size={24} animated={false} />}\n      title=\"krizaka-ui on GitHub\"\n      description=\"The sources, the issues, the discussions.\"\n      cta=\"Open the repository\"\n    />\n  );\n}\n"
       },
-      {
-        "name": "hover-light",
-        "title": "The light hover",
-        "description": "`hover=\"light\"`, the default: the pointer's light and the coloured lift, said explicitly.",
-        "path": "examples/link-card/hover-light.tsx",
-        "module": "@krizaka/ui/registry/examples/link-card/hover-light",
-        "code": "import { ProductLogo } from \"@krizaka/ui\";\nimport { CardGrid } from \"@krizaka/ui/card-grid\";\nimport { LinkCard } from \"@krizaka/ui/link-card\";\n\nconst shortcuts = [\n  { id: \"cli\", logo: \"orazaka\", title: \"The CLI\", text: \"npx orazaka install, start, dev — then every command and option.\" },\n  { id: \"packs\", logo: \"orazaka\", title: \"Packs & Studios\", text: \"The business offers Orazaka installs without code.\" },\n  { id: \"admin\", logo: \"orochia\", title: \"Orochia admin console\", text: \"Verification, moderation, payouts — behind four gates.\" },\n] as const;\n\n// The default hover, said explicitly: the pointer's light and the coloured lift.\nexport default function LinkCardHoverLight() {\n  return (\n    <CardGrid className=\"w-full max-w-4xl\" min={260} reveal={false}>\n      {shortcuts.map((s) => (\n        <LinkCard key={s.id} hover=\"light\" href={`#${s.id}`} icon={<ProductLogo id={s.logo} size={24} animated={false} />} title={s.title} description={s.text} cta=\"Open\" />\n      ))}\n    </CardGrid>\n  );\n}\n"
-      },
       {
         "name": "hover-quiet",
-        "title": "The quiet hover",
-        "description": "`hover=\"quiet\"`: no glow, a 2 px lift, one step of surface and border, a ring on focus.",
+        "title": "The hover",
+        "description": "One step of surface and border under the pointer, a ring on focus; nothing moves, no light.",
         "path": "examples/link-card/hover-quiet.tsx",
         "module": "@krizaka/ui/registry/examples/link-card/hover-quiet",
-        "code": "import { ProductLogo } from \"@krizaka/ui\";\nimport { CardGrid } from \"@krizaka/ui/card-grid\";\nimport { LinkCard } from \"@krizaka/ui/link-card\";\n\nconst shortcuts = [\n  { id: \"cli\", logo: \"orazaka\", title: \"The CLI\", text: \"npx orazaka install, start, dev — then every command and option.\" },\n  { id: \"packs\", logo: \"orazaka\", title: \"Packs & Studios\", text: \"The business offers Orazaka installs without code.\" },\n  { id: \"admin\", logo: \"orochia\", title: \"Orochia admin console\", text: \"Verification, moderation, payouts — behind four gates.\" },\n] as const;\n\n// The quiet hover on a card: no glow, a 2 px lift, one step of surface and border, a ring on focus.\nexport default function LinkCardHoverQuiet() {\n  return (\n    <CardGrid className=\"w-full max-w-4xl\" min={260} reveal={false}>\n      {shortcuts.map((s) => (\n        <LinkCard key={s.id} hover=\"quiet\" href={`#${s.id}`} icon={<ProductLogo id={s.logo} size={24} animated={false} />} title={s.title} description={s.text} cta=\"Open\" />\n      ))}\n    </CardGrid>\n  );\n}\n"
+        "code": "import { ProductLogo } from \"@krizaka/ui\";\nimport { CardGrid } from \"@krizaka/ui/card-grid\";\nimport { LinkCard } from \"@krizaka/ui/link-card\";\n\nconst shortcuts = [\n  { id: \"cli\", logo: \"orazaka\", title: \"The CLI\", text: \"npx orazaka install, start, dev — then every command and option.\" },\n  { id: \"packs\", logo: \"orazaka\", title: \"Packs & Studios\", text: \"The business offers Orazaka installs without code.\" },\n  { id: \"admin\", logo: \"orochia\", title: \"Orochia admin console\", text: \"Verification, moderation, payouts — behind four gates.\" },\n] as const;\n\n// The quiet hover on a card: no glow, a 2 px lift, one step of surface and border, a ring on focus.\nexport default function LinkCardHoverQuiet() {\n  return (\n    <CardGrid className=\"w-full max-w-4xl\" min={260} reveal={false}>\n      {shortcuts.map((s) => (\n        <LinkCard key={s.id} href={`#${s.id}`} icon={<ProductLogo id={s.logo} size={24} animated={false} />} title={s.title} description={s.text} cta=\"Open\" />\n      ))}\n    </CardGrid>\n  );\n}\n"
       }
     ]
   },
@@ -222,11 +213,11 @@
     },
     {
       "path": "link-card/link-card.tsx",
-      "content": "// Server-safe. A card that leads somewhere (blocks.css): the whole card is the link — an icon, a title, one sentence,\n// the way in. Compact, one look for every entry point of a page (a documentation hub, the products, the next step).\nimport type * as React from \"react\";\n\nimport { BlockLink, isExternal, type LinkComponent } from \"../block-link\";\nimport { cn } from \"../cn\";\nimport { ArrowGlyph, ExternalGlyph } from \"../glyphs\";\n\nexport type LinkCardProps = Omit<React.ComponentProps<\"a\">, \"title\" | \"href\"> & {\n  /** Where the card leads. An absolute URL opens in a new tab, with the external mark. */\n  href: string;\n  /** The title: the name of the destination. */\n  title: React.ReactNode;\n  /** One sentence: what the reader finds there. */\n  description?: React.ReactNode;\n  /** The icon tile on the left (a product mark, a signature icon): decorative, the title names the link. */\n  icon?: React.ReactNode;\n  /** A short mono line above the title (a category, a version). */\n  meta?: React.ReactNode;\n  /** The way in, under the text, with an arrow: `Open`, `Read the guide`. */\n  cta?: React.ReactNode;\n  /** Under the text, before the way in: facts (`Facts`), badges. Never another link — the card is one. */\n  extra?: React.ReactNode;\n  /**\n   * The title's element: a heading when the cards are the content of a section (a hub), `span` inside a list of links.\n   * @default \"h3\"\n   */\n  titleAs?: \"h2\" | \"h3\" | \"h4\" | \"span\";\n  /**\n   * `row`: the icon beside the text (compact, the default); `stack`: the icon above it.\n   * @default \"row\"\n   */\n  layout?: \"row\" | \"stack\";\n  /**\n   * Where the facts (`extra`) and the way in (`cta`) sit when the card is taller than its text — a row of cards at one\n   * height: `bottom` pins them to the card's foot, so they share a line across the row; `top` leaves them under the text.\n   * @default \"bottom\"\n   */\n  footerAlign?: \"bottom\" | \"top\";\n  /** The app's link component for internal addresses (Next's `Link`); an `<a>` otherwise. */\n  linkAs?: LinkComponent;\n  /**\n   * The hover of the card: `light` (the pointer's light, a coloured lift — the default) or `quiet` (no glow, a 2 px lift,\n   * one step of surface and border, the focus as a ring). Unset, a card follows its grid (`CardGrid hover`).\n   */\n  hover?: CardHover;\n};\n\n/** The hover of a card (blocks.css): the pointer's light (`light`) or the quiet hover (`quiet`). */\nexport type CardHover = \"light\" | \"quiet\";\n\n/** The class that says a card's hover; none when it is not asked (the card then follows its grid, or the default). */\nexport function cardHoverClass(hover: CardHover | undefined): string | undefined {\n  return hover === \"quiet\" ? \"kz-hover-quiet\" : hover === \"light\" ? \"kz-hover-light\" : undefined;\n}\n\n/** An entry point: the whole card is one link — icon, title, sentence, the way in. Lifts and lights under the pointer. */\nexport function LinkCard({ href, title, description, icon, meta, cta, extra, titleAs: Title = \"h3\", layout = \"row\", footerAlign = \"bottom\", linkAs, hover, className, ...props }: LinkCardProps) {\n  const external = isExternal(href);\n  return (\n    <BlockLink\n      href={href}\n      linkAs={linkAs}\n      external={external}\n      className={cn(\"kz-block-card kz-link-card\", cardHoverClass(hover), className)}\n      data-kz-light=\"\"\n      data-layout={layout === \"row\" ? undefined : layout}\n      data-footer={footerAlign === \"top\" ? \"top\" : undefined}\n      {...props}\n    >\n      {icon && (\n        <span className=\"kz-block-icon\" aria-hidden>\n          {icon}\n        </span>\n      )}\n      <div className=\"kz-link-card-body\">\n        {meta && <p className=\"kz-link-card-meta\">{meta}</p>}\n        <Title className=\"kz-link-card-title\">{title}</Title>\n        {description && <p className=\"kz-link-card-text\">{description}</p>}\n        {(extra || cta || external) && (\n          <div className=\"kz-link-card-foot\">\n            {extra && <div className=\"kz-link-card-extra\">{extra}</div>}\n            {(cta || external) && (\n              <span className=\"kz-link-card-cta\">\n                {cta}\n                {external ? <ExternalGlyph className=\"h-3.5 w-3.5\" /> : <ArrowGlyph className=\"h-3.5 w-3.5\" />}\n              </span>\n            )}\n          </div>\n        )}\n      </div>\n    </BlockLink>\n  );\n}\n"
+      "content": "// Server-safe. A card that leads somewhere (blocks.css): the whole card is the link — an icon, a title, one sentence,\n// the way in. Compact, one look for every entry point of a page (a documentation hub, the products, the next step).\nimport type * as React from \"react\";\n\nimport { BlockLink, isExternal, type LinkComponent } from \"../block-link\";\nimport { cn } from \"../cn\";\nimport { ArrowGlyph, ExternalGlyph } from \"../glyphs\";\n\nexport type LinkCardProps = Omit<React.ComponentProps<\"a\">, \"title\" | \"href\"> & {\n  /** Where the card leads. An absolute URL opens in a new tab, with the external mark. */\n  href: string;\n  /** The title: the name of the destination. */\n  title: React.ReactNode;\n  /** One sentence: what the reader finds there. */\n  description?: React.ReactNode;\n  /** The icon tile on the left (a product mark, a signature icon): decorative, the title names the link. */\n  icon?: React.ReactNode;\n  /** A short mono line above the title (a category, a version). */\n  meta?: React.ReactNode;\n  /** The way in, under the text, with an arrow: `Open`, `Read the guide`. */\n  cta?: React.ReactNode;\n  /** Under the text, before the way in: facts (`Facts`), badges. Never another link — the card is one. */\n  extra?: React.ReactNode;\n  /**\n   * The title's element: a heading when the cards are the content of a section (a hub), `span` inside a list of links.\n   * @default \"h3\"\n   */\n  titleAs?: \"h2\" | \"h3\" | \"h4\" | \"span\";\n  /**\n   * `row`: the icon beside the text (compact, the default); `stack`: the icon above it.\n   * @default \"row\"\n   */\n  layout?: \"row\" | \"stack\";\n  /**\n   * Where the facts (`extra`) and the way in (`cta`) sit when the card is taller than its text — a row of cards at one\n   * height: `bottom` pins them to the card's foot, so they share a line across the row; `top` leaves them under the text.\n   * @default \"bottom\"\n   */\n  footerAlign?: \"bottom\" | \"top\";\n  /** The app's link component for internal addresses (Next's `Link`); an `<a>` otherwise. */\n  linkAs?: LinkComponent;\n  /** @deprecated Since 3.31 (krizaka-ui#393): does nothing — every card has the one quiet hover. Removed in 4.0. */\n  hover?: CardHover;\n};\n\n/** @deprecated Since 3.31 (krizaka-ui#393): a card has one quiet hover; the values are accepted and ignored. */\nexport type CardHover = \"light\" | \"quiet\";\n\n/** @deprecated Since 3.31 (krizaka-ui#393): there is one hover, so no class says it. Always `undefined`. */\nexport function cardHoverClass(_hover?: CardHover): string | undefined {\n  return undefined;\n}\n\n/** An entry point: the whole card is one link — icon, title, sentence, the way in. Its surface and hairline go one step up under the pointer; nothing moves. */\nexport function LinkCard({ href, title, description, icon, meta, cta, extra, titleAs: Title = \"h3\", layout = \"row\", footerAlign = \"bottom\", linkAs, hover, className, ...props }: LinkCardProps) {\n  const external = isExternal(href);\n  return (\n    <BlockLink\n      href={href}\n      linkAs={linkAs}\n      external={external}\n      className={cn(\"kz-block-card kz-link-card\", cardHoverClass(hover), className)}\n      data-layout={layout === \"row\" ? undefined : layout}\n      data-footer={footerAlign === \"top\" ? \"top\" : undefined}\n      {...props}\n    >\n      {icon && (\n        <span className=\"kz-block-icon\" aria-hidden>\n          {icon}\n        </span>\n      )}\n      <div className=\"kz-link-card-body\">\n        {meta && <p className=\"kz-link-card-meta\">{meta}</p>}\n        <Title className=\"kz-link-card-title\">{title}</Title>\n        {description && <p className=\"kz-link-card-text\">{description}</p>}\n        {(extra || cta || external) && (\n          <div className=\"kz-link-card-foot\">\n            {extra && <div className=\"kz-link-card-extra\">{extra}</div>}\n            {(cta || external) && (\n              <span className=\"kz-link-card-cta\">\n                {cta}\n                {external ? <ExternalGlyph className=\"h-3.5 w-3.5\" /> : <ArrowGlyph className=\"h-3.5 w-3.5\" />}\n              </span>\n            )}\n          </div>\n        )}\n      </div>\n    </BlockLink>\n  );\n}\n"
     },
     {
       "path": "link-card/meta.ts",
-      "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n  title: \"Link card\",\n  summary:\n    \"An entry point where the whole card is one link: an icon tile, a title, one sentence and the way in — compact, the same on every page, lifting and lighting under the pointer or the focus.\",\n  status: \"beta\",\n  category: \"blocks\",\n  platforms: \"web\",\n  parity: { native: { status: \"n/a\", reason: \"A block of a public site's page; an app screen on a phone is built from Screen, Header and Card.\", use: \"card\" }, desktop: { status: \"n/a\", reason: \"A public site's page, not a window of the Mac app.\" } },\n  whenToUse: [\n    \"The entry points of a hub: a documentation's sections, the products, the next steps of a guide.\",\n    \"Any link that deserves more than its words: what the reader finds there, in one sentence.\",\n  ],\n  whenNotToUse: [\n    { when: \"When the card holds several actions: a card that is a link holds no other link.\", use: \"argument-card\" },\n    { when: \"For a link inside a sentence or a list of plain links.\", use: \"chip-link\" },\n  ],\n  bestPractices: [\n    \"One sentence of description; the title names the destination, the way in (`cta`) says the action.\",\n    \"Use the product's mark or a signature icon as `icon`, never a placeholder.\",\n    \"Pass the app's router link as `linkAs` (Next's `Link`) so internal links prefetch.\",\n    \"In a row of cards at one height (`CardGrid`), the facts (`extra`) and the way in (`cta`) are pinned to the foot of each card, so they share a line whatever the length of the sentences; `footerAlign=\\\"top\\\"` keeps them under the text.\",\n    \"In a hub, keep the default `h3` titles under the section's `h2`; in a list of links, `titleAs=\\\"span\\\"`.\",\n    \"`hover=\\\"quiet\\\"` on a page of reading (a docs hub, a blog's index): no glow, a 2 px lift and a ring on focus, where the default `light` lights the card under the pointer. Set it on `CardGrid` to quiet a whole grid.\",\n  ],\n  accessibility: {\n    keyboard: [{ keys: \"Tab\", action: \"Focuses the card, which lights and draws the focus ring like the pointer does.\" }],\n    notes: [\n      \"The card is a single link: its accessible name is its whole text — keep it short.\",\n      \"An absolute address opens in a new tab with `rel=\\\"noopener noreferrer\\\"` and the external mark.\",\n      \"The icon and the arrow are decorative; the lift and the light stop under `prefers-reduced-motion`.\",\n      \"The quiet hover keeps the same text contrast in dark and light: it moves the surface and the hairline one step, and the title towards the accent text colour, never below it.\",\n    ],\n  },\n  related: [\"card-grid\", \"glow-card\", \"chip-link\"],\n  web: {\n    imports: [\"LinkCard\"],\n    examples: [\n      { name: \"docs-hub\", title: \"A documentation hub\", description: \"Three compact cards in a grid: a mark, a title, a sentence, `Open`.\" },\n      { name: \"stack\", title: \"Stacked, with facts\", description: \"`layout=\\\"stack\\\"`, a category above the title and facts under the text.\" },\n      { name: \"external\", title: \"An external link\", description: \"An absolute address: a new tab and the external mark.\" },\n      { name: \"hover-light\", title: \"The light hover\", description: \"`hover=\\\"light\\\"`, the default: the pointer's light and the coloured lift, said explicitly.\" },\n      { name: \"hover-quiet\", title: \"The quiet hover\", description: \"`hover=\\\"quiet\\\"`: no glow, a 2 px lift, one step of surface and border, a ring on focus.\" },\n    ],\n  },\n} satisfies ComponentMeta;\n"
+      "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n  title: \"Link card\",\n  summary:\n    \"An entry point where the whole card is one link: an icon tile, a title, one sentence and the way in — compact, the same on every page; under the pointer its surface and hairline go one step up, nothing moves.\",\n  status: \"beta\",\n  category: \"blocks\",\n  platforms: \"web\",\n  parity: { native: { status: \"n/a\", reason: \"A block of a public site's page; an app screen on a phone is built from Screen, Header and Card.\", use: \"card\" }, desktop: { status: \"n/a\", reason: \"A public site's page, not a window of the Mac app.\" } },\n  whenToUse: [\n    \"The entry points of a hub: a documentation's sections, the products, the next steps of a guide.\",\n    \"Any link that deserves more than its words: what the reader finds there, in one sentence.\",\n  ],\n  whenNotToUse: [\n    { when: \"When the card holds several actions: a card that is a link holds no other link.\", use: \"argument-card\" },\n    { when: \"For a link inside a sentence or a list of plain links.\", use: \"chip-link\" },\n  ],\n  bestPractices: [\n    \"One sentence of description; the title names the destination, the way in (`cta`) says the action.\",\n    \"Use the product's mark or a signature icon as `icon`, never a placeholder.\",\n    \"Pass the app's router link as `linkAs` (Next's `Link`) so internal links prefetch.\",\n    \"In a row of cards at one height (`CardGrid`), the facts (`extra`) and the way in (`cta`) are pinned to the foot of each card, so they share a line whatever the length of the sentences; `footerAlign=\\\"top\\\"` keeps them under the text.\",\n    \"In a hub, keep the default `h3` titles under the section's `h2`; in a list of links, `titleAs=\\\"span\\\"`.\",\n  ],\n  accessibility: {\n    keyboard: [{ keys: \"Tab\", action: \"Focuses the card: a 2 px ring of `--kz-ring` around it.\" }],\n    notes: [\n      \"The card is a single link: its accessible name is its whole text — keep it short.\",\n      \"An absolute address opens in a new tab with `rel=\\\"noopener noreferrer\\\"` and the external mark.\",\n      \"The icon and the arrow are decorative; the arrow's lean stops under `prefers-reduced-motion`.\",\n      \"The hover keeps the same text contrast in dark and light: it moves the surface and the hairline one step, never the text below AA. `hover` is deprecated since 3.31 (krizaka-ui#393): there is one hover.\",\n    ],\n  },\n  related: [\"card-grid\", \"glow-card\", \"chip-link\"],\n  web: {\n    imports: [\"LinkCard\"],\n    examples: [\n      { name: \"docs-hub\", title: \"A documentation hub\", description: \"Three compact cards in a grid: a mark, a title, a sentence, `Open`.\" },\n      { name: \"stack\", title: \"Stacked, with facts\", description: \"`layout=\\\"stack\\\"`, a category above the title and facts under the text.\" },\n      { name: \"external\", title: \"An external link\", description: \"An absolute address: a new tab and the external mark.\" },\n      { name: \"hover-quiet\", title: \"The hover\", description: \"One step of surface and border under the pointer, a ring on focus; nothing moves, no light.\" },\n    ],\n  },\n} satisfies ComponentMeta;\n"
     },
     {
       "path": "meta.ts",
@@ -249,7 +240,7 @@
     },
     {
       "component": "LinkCard",
-      "description": "An entry point: the whole card is one link — icon, title, sentence, the way in. Lifts and lights under the pointer.",
+      "description": "An entry point: the whole card is one link — icon, title, sentence, the way in. Its surface and hairline go one step up under the pointer; nothing moves.",
       "props": [
         {
           "name": "href",
@@ -297,7 +288,7 @@
           "name": "hover",
           "type": "CardHover",
           "default": null,
-          "description": "The hover of the card: `light` (the pointer's light, a coloured lift — the default) or `quiet` (no glow, a 2 px lift,\none step of surface and border, the focus as a ring). Unset, a card follows its grid (`CardGrid hover`).",
+          "description": "@deprecated Since 3.31 (krizaka-ui#393): does nothing — every card has the one quiet hover. Removed in 4.0.",
           "required": false
         },
         {