@misoto22/design 0.6.1 → 0.8.0

package/dist/components/Card/Card.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/Card/Card.tsx"],"sourcesContent":["import type { HTMLAttributes } from 'react'\nimport { cn } from '../../lib/cn'\n\nexport interface CardProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * `outline` is a hairline box on the page ground — the default, and correct\n   * for a card sitting among other cards. `plate` fills with the one reversed\n   * surface and is for a card that IS the point of its band; use at most one\n   * per screen. `flat` drops the border entirely, for a card whose grid already\n   * draws the rules between cells.\n   */\n  variant?: 'outline' | 'plate' | 'flat'\n}\n\nconst VARIANT = {\n  outline: 'border border-(--rule) bg-(--paper)',\n  plate:\n    'border border-(--feature-surface) bg-(--feature-surface) text-(--on-feature) [--card-title:var(--on-feature)]',\n  flat: 'border border-transparent bg-transparent',\n} as const\n\n/**\n * A bounded surface.\n *\n * No shadow, by law: depth in this system is a hairline and a change of ground,\n * never a blur. A card that needs to read as raised is a `plate`, which\n * separates by reversal instead.\n *\n * Compose with the named sub-parts, or drop children straight in when the card\n * has no header or footer to speak of.\n *\n * @example\n * <Card>\n *   <CardHeader><CardTitle>Recent deploys</CardTitle><Badge>12</Badge></CardHeader>\n *   <CardBody>…</CardBody>\n *   <CardFooter>Updated just now</CardFooter>\n * </Card>\n */\nexport function Card({ variant = 'outline', className, children, ...rest }: CardProps) {\n  return (\n    <div className={cn('rounded-(--radius-lg)', VARIANT[variant], className)} {...rest}>\n      {children}\n    </div>\n  )\n}\n\n/** Header row — title on the left, an action or marker on the right. */\nexport function CardHeader({ className, children, ...rest }: HTMLAttributes<HTMLDivElement>) {\n  return (\n    <div\n      className={cn(\n        'flex items-center justify-between gap-4 border-b border-(--rule) px-5 py-4',\n        className,\n      )}\n      {...rest}\n    >\n      {children}\n    </div>\n  )\n}\n\n/**\n * The card's title, in the editorial serif.\n *\n * An `<h3>` by default, which is right inside a section with its own `<h2>` and\n * wrong nearly everywhere else — pass `as` rather than leaving a page with a\n * heading order that jumps.\n */\nexport function CardTitle({\n  as: Comp = 'h3',\n  className,\n  children,\n  ...rest\n}: HTMLAttributes<HTMLHeadingElement> & { as?: 'h2' | 'h3' | 'h4' }) {\n  return (\n    <Comp\n      // Reads the card's own title colour rather than --ink directly. A plate\n      // is a reversed surface, and a hardcoded ink title on it came out at\n      // 1.25:1 — invisible, and invisible only on the one variant whose whole\n      // job is to be different.\n      className={cn(\n        'm-0 font-heading text-[length:var(--fs-item)] font-normal text-[var(--card-title,var(--ink))]',\n        className,\n      )}\n      {...rest}\n    >\n      {children}\n    </Comp>\n  )\n}\n\n/** The content well. */\nexport function CardBody({ className, children, ...rest }: HTMLAttributes<HTMLDivElement>) {\n  return (\n    <div className={cn('p-5 text-sm leading-relaxed text-(--ink-2)', className)} {...rest}>\n      {children}\n    </div>\n  )\n}\n\n/** A quiet strip for metadata or secondary actions. */\nexport function CardFooter({ className, children, ...rest }: HTMLAttributes<HTMLDivElement>) {\n  return (\n    <div\n      className={cn('border-t border-(--rule) px-5 py-4 mono-meta text-(--ink-3-aa)', className)}\n      {...rest}\n    >\n      {children}\n    </div>\n  )\n}\n\nexport default Card\n"],"mappings":"AAwCI;AAvCJ,SAAS,UAAU;AAanB,MAAM,UAAU;AAAA,EACd,SAAS;AAAA,EACT,OACE;AAAA,EACF,MAAM;AACR;AAmBO,SAAS,KAAK,EAAE,UAAU,WAAW,WAAW,UAAU,GAAG,KAAK,GAAc;AACrF,SACE,oBAAC,SAAI,WAAW,GAAG,yBAAyB,QAAQ,OAAO,GAAG,SAAS,GAAI,GAAG,MAC3E,UACH;AAEJ;AAGO,SAAS,WAAW,EAAE,WAAW,UAAU,GAAG,KAAK,GAAmC;AAC3F,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA,MAEH;AAAA;AAAA,EACH;AAEJ;AASO,SAAS,UAAU;AAAA,EACxB,IAAI,OAAO;AAAA,EACX;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAqE;AACnE,SACE;AAAA,IAAC;AAAA;AAAA,MAKC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA,MAEH;AAAA;AAAA,EACH;AAEJ;AAGO,SAAS,SAAS,EAAE,WAAW,UAAU,GAAG,KAAK,GAAmC;AACzF,SACE,oBAAC,SAAI,WAAW,GAAG,8CAA8C,SAAS,GAAI,GAAG,MAC9E,UACH;AAEJ;AAGO,SAAS,WAAW,EAAE,WAAW,UAAU,GAAG,KAAK,GAAmC;AAC3F,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,GAAG,kEAAkE,SAAS;AAAA,MACxF,GAAG;AAAA,MAEH;AAAA;AAAA,EACH;AAEJ;AAEA,IAAO,eAAQ;","names":[]}
+{"version":3,"sources":["../../../src/components/Card/Card.tsx"],"sourcesContent":["import type { HTMLAttributes } from 'react'\nimport { cn } from '../../lib/cn'\n\nexport interface CardProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * `outline` is a hairline box on the page ground — the default, and correct\n   * for a card sitting among other cards. `plate` fills with the one reversed\n   * surface and is for a card that IS the point of its band; use at most one\n   * per screen. `flat` drops the border entirely, for a card whose grid already\n   * draws the rules between cells.\n   */\n  variant?: 'outline' | 'plate' | 'flat'\n}\n\nconst VARIANT = {\n  outline: 'border border-(--rule) bg-(--paper)',\n  plate:\n    'border border-(--feature-surface) bg-(--feature-surface) text-(--on-feature) [--card-title:var(--on-feature)]',\n  flat: 'border border-transparent bg-transparent',\n} as const\n\n/**\n * A bounded surface.\n *\n * No shadow, by law: depth in this system is a hairline and a change of ground,\n * never a blur. A card that needs to read as raised is a `plate`, which\n * separates by reversal instead.\n *\n * It clips to its own corner. A card that rounds and does not clip lays a\n * full-bleed image's square corners over its round ones at all four corners,\n * and the same goes for a filled first child — a defect that is invisible until\n * the first card with an image at the top of it. Pass `overflow-visible` for\n * the rarer card that deliberately overhangs.\n *\n * Compose with the named sub-parts, or drop children straight in when the card\n * has no header or footer to speak of.\n *\n * @example\n * <Card>\n *   <CardHeader><CardTitle>Recent deploys</CardTitle><Badge>12</Badge></CardHeader>\n *   <CardBody>…</CardBody>\n *   <CardFooter>Updated just now</CardFooter>\n * </Card>\n */\nexport function Card({ variant = 'outline', className, children, ...rest }: CardProps) {\n  return (\n    <div className={cn('overflow-hidden rounded-(--radius-lg)', VARIANT[variant], className)} {...rest}>\n      {children}\n    </div>\n  )\n}\n\n/** Header row — title on the left, an action or marker on the right. */\nexport function CardHeader({ className, children, ...rest }: HTMLAttributes<HTMLDivElement>) {\n  return (\n    <div\n      className={cn(\n        'flex items-center justify-between gap-4 border-b border-(--rule) px-5 py-4',\n        className,\n      )}\n      {...rest}\n    >\n      {children}\n    </div>\n  )\n}\n\n/**\n * The card's title, in the editorial serif.\n *\n * An `<h3>` by default, which is right inside a section with its own `<h2>` and\n * wrong nearly everywhere else — pass `as` rather than leaving a page with a\n * heading order that jumps.\n */\nexport function CardTitle({\n  as: Comp = 'h3',\n  className,\n  children,\n  ...rest\n}: HTMLAttributes<HTMLHeadingElement> & { as?: 'h2' | 'h3' | 'h4' }) {\n  return (\n    <Comp\n      // Reads the card's own title colour rather than --ink directly. A plate\n      // is a reversed surface, and a hardcoded ink title on it came out at\n      // 1.25:1 — invisible, and invisible only on the one variant whose whole\n      // job is to be different.\n      className={cn(\n        'm-0 font-heading text-[length:var(--fs-item)] font-normal text-[var(--card-title,var(--ink))]',\n        className,\n      )}\n      {...rest}\n    >\n      {children}\n    </Comp>\n  )\n}\n\n/** The content well. */\nexport function CardBody({ className, children, ...rest }: HTMLAttributes<HTMLDivElement>) {\n  return (\n    <div className={cn('p-5 text-sm leading-relaxed text-(--ink-2)', className)} {...rest}>\n      {children}\n    </div>\n  )\n}\n\n/** A quiet strip for metadata or secondary actions. */\nexport function CardFooter({ className, children, ...rest }: HTMLAttributes<HTMLDivElement>) {\n  return (\n    <div\n      className={cn('border-t border-(--rule) px-5 py-4 mono-meta text-(--ink-3-aa)', className)}\n      {...rest}\n    >\n      {children}\n    </div>\n  )\n}\n\nexport default Card\n"],"mappings":"AA8CI;AA7CJ,SAAS,UAAU;AAanB,MAAM,UAAU;AAAA,EACd,SAAS;AAAA,EACT,OACE;AAAA,EACF,MAAM;AACR;AAyBO,SAAS,KAAK,EAAE,UAAU,WAAW,WAAW,UAAU,GAAG,KAAK,GAAc;AACrF,SACE,oBAAC,SAAI,WAAW,GAAG,yCAAyC,QAAQ,OAAO,GAAG,SAAS,GAAI,GAAG,MAC3F,UACH;AAEJ;AAGO,SAAS,WAAW,EAAE,WAAW,UAAU,GAAG,KAAK,GAAmC;AAC3F,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA,MAEH;AAAA;AAAA,EACH;AAEJ;AASO,SAAS,UAAU;AAAA,EACxB,IAAI,OAAO;AAAA,EACX;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAqE;AACnE,SACE;AAAA,IAAC;AAAA;AAAA,MAKC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA,MAEH;AAAA;AAAA,EACH;AAEJ;AAGO,SAAS,SAAS,EAAE,WAAW,UAAU,GAAG,KAAK,GAAmC;AACzF,SACE,oBAAC,SAAI,WAAW,GAAG,8CAA8C,SAAS,GAAI,GAAG,MAC9E,UACH;AAEJ;AAGO,SAAS,WAAW,EAAE,WAAW,UAAU,GAAG,KAAK,GAAmC;AAC3F,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW,GAAG,kEAAkE,SAAS;AAAA,MACxF,GAAG;AAAA,MAEH;AAAA;AAAA,EACH;AAEJ;AAEA,IAAO,eAAQ;","names":[]}

package/dist/components/Checkbox/Checkbox.d.ts

@@ -8,7 +8,10 @@ type CheckboxProps = ComponentProps<typeof CheckboxPrimitive.Root>;
  *
  * Supports the indeterminate state (`checked="indeterminate"`), which is what a
  * "select all" header needs when only some rows are selected — a plain
- * unchecked box there tells the reader the opposite of the truth.
+ * unchecked box there tells the reader the opposite of the truth. Controlled or
+ * not: the glyph follows the state the box is actually in, so an uncontrolled
+ * `defaultChecked="indeterminate"` draws the dash rather than the tick that says
+ * the opposite.
  *
  * Pair with `Field`, or wrap it in a `<label>` at the call site so the words
  * beside it are part of the click target.
@@ -18,6 +21,6 @@ type CheckboxProps = ComponentProps<typeof CheckboxPrimitive.Root>;
  *   <Checkbox defaultChecked /> Subscribe to updates
  * </label>
  */
-declare function Checkbox({ className, ...props }: CheckboxProps): react.JSX.Element;
+declare function Checkbox({ className, onCheckedChange, ...props }: CheckboxProps): react.JSX.Element;
 
 export { Checkbox, type CheckboxProps, Checkbox as default };

package/dist/components/Checkbox/Checkbox.js

@@ -2,17 +2,27 @@
 import { jsx } from "react/jsx-runtime";
 import * as CheckboxPrimitive from "@radix-ui/react-checkbox";
 import { Check, Minus } from "lucide-react";
+import { useState } from "react";
 import { cn } from "../../lib/cn.js";
-function Checkbox({ className, ...props }) {
+function Checkbox({ className, onCheckedChange, ...props }) {
+  const [uncontrolled, setUncontrolled] = useState(
+    props.defaultChecked ?? false
+  );
+  const state = props.checked ?? uncontrolled;
+  const handleChange = (next) => {
+    if (props.checked === void 0) setUncontrolled(next);
+    onCheckedChange?.(next);
+  };
   return /* @__PURE__ */ jsx(
     CheckboxPrimitive.Root,
     {
+      onCheckedChange: handleChange,
       className: cn(
         "inline-flex size-[18px] shrink-0 items-center justify-center rounded-(--radius-xs) border border-(--rule-2) bg-(--paper) text-(--accent-foreground) transition-colors duration-(--duration-fast) data-[state=checked]:border-(--accent) data-[state=checked]:bg-(--accent) data-[state=indeterminate]:border-(--accent) data-[state=indeterminate]:bg-(--accent) disabled:opacity-(--disabled-opacity) disabled:pointer-events-none",
         className
       ),
       ...props,
-      children: /* @__PURE__ */ jsx(CheckboxPrimitive.Indicator, { className: "flex items-center justify-center text-current", children: props.checked === "indeterminate" ? /* @__PURE__ */ jsx(Minus, { className: "size-3", strokeWidth: 3, "aria-hidden": true }) : /* @__PURE__ */ jsx(Check, { className: "size-3", strokeWidth: 3, "aria-hidden": true }) })
+      children: /* @__PURE__ */ jsx(CheckboxPrimitive.Indicator, { className: "flex items-center justify-center text-current", children: state === "indeterminate" ? /* @__PURE__ */ jsx(Minus, { className: "size-3", strokeWidth: 3, "aria-hidden": true }) : /* @__PURE__ */ jsx(Check, { className: "size-3", strokeWidth: 3, "aria-hidden": true }) })
     }
   );
 }

package/dist/components/Checkbox/Checkbox.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/Checkbox/Checkbox.tsx"],"sourcesContent":["'use client'\n\nimport * as CheckboxPrimitive from '@radix-ui/react-checkbox'\nimport { Check, Minus } from 'lucide-react'\nimport type { ComponentProps } from 'react'\nimport { cn } from '../../lib/cn'\n\nexport type CheckboxProps = ComponentProps<typeof CheckboxPrimitive.Root>\n\n/**\n * A choice that takes effect when the form is submitted.\n *\n * Supports the indeterminate state (`checked=\"indeterminate\"`), which is what a\n * \"select all\" header needs when only some rows are selected — a plain\n * unchecked box there tells the reader the opposite of the truth.\n *\n * Pair with `Field`, or wrap it in a `<label>` at the call site so the words\n * beside it are part of the click target.\n *\n * @example\n * <label className=\"flex items-center gap-2.5 text-sm\">\n *   <Checkbox defaultChecked /> Subscribe to updates\n * </label>\n */\nexport function Checkbox({ className, ...props }: CheckboxProps) {\n  return (\n    <CheckboxPrimitive.Root\n      className={cn(\n        'inline-flex size-[18px] shrink-0 items-center justify-center rounded-(--radius-xs) border border-(--rule-2) bg-(--paper) text-(--accent-foreground) transition-colors duration-(--duration-fast) data-[state=checked]:border-(--accent) data-[state=checked]:bg-(--accent) data-[state=indeterminate]:border-(--accent) data-[state=indeterminate]:bg-(--accent) disabled:opacity-(--disabled-opacity) disabled:pointer-events-none',\n        className,\n      )}\n      {...props}\n    >\n      <CheckboxPrimitive.Indicator className=\"flex items-center justify-center text-current\">\n        {props.checked === 'indeterminate' ? (\n          <Minus className=\"size-3\" strokeWidth={3} aria-hidden />\n        ) : (\n          <Check className=\"size-3\" strokeWidth={3} aria-hidden />\n        )}\n      </CheckboxPrimitive.Indicator>\n    </CheckboxPrimitive.Root>\n  )\n}\n\nexport default Checkbox\n"],"mappings":";AAmCU;AAjCV,YAAY,uBAAuB;AACnC,SAAS,OAAO,aAAa;AAE7B,SAAS,UAAU;AAmBZ,SAAS,SAAS,EAAE,WAAW,GAAG,MAAM,GAAkB;AAC/D,SACE;AAAA,IAAC,kBAAkB;AAAA,IAAlB;AAAA,MACC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA,MAEJ,8BAAC,kBAAkB,WAAlB,EAA4B,WAAU,iDACpC,gBAAM,YAAY,kBACjB,oBAAC,SAAM,WAAU,UAAS,aAAa,GAAG,eAAW,MAAC,IAEtD,oBAAC,SAAM,WAAU,UAAS,aAAa,GAAG,eAAW,MAAC,GAE1D;AAAA;AAAA,EACF;AAEJ;AAEA,IAAO,mBAAQ;","names":[]}
+{"version":3,"sources":["../../../src/components/Checkbox/Checkbox.tsx"],"sourcesContent":["'use client'\n\nimport * as CheckboxPrimitive from '@radix-ui/react-checkbox'\nimport { Check, Minus } from 'lucide-react'\nimport { useState, type ComponentProps } from 'react'\nimport { cn } from '../../lib/cn'\n\nexport type CheckboxProps = ComponentProps<typeof CheckboxPrimitive.Root>\n\n/**\n * A choice that takes effect when the form is submitted.\n *\n * Supports the indeterminate state (`checked=\"indeterminate\"`), which is what a\n * \"select all\" header needs when only some rows are selected — a plain\n * unchecked box there tells the reader the opposite of the truth. Controlled or\n * not: the glyph follows the state the box is actually in, so an uncontrolled\n * `defaultChecked=\"indeterminate\"` draws the dash rather than the tick that says\n * the opposite.\n *\n * Pair with `Field`, or wrap it in a `<label>` at the call site so the words\n * beside it are part of the click target.\n *\n * @example\n * <label className=\"flex items-center gap-2.5 text-sm\">\n *   <Checkbox defaultChecked /> Subscribe to updates\n * </label>\n */\nexport function Checkbox({ className, onCheckedChange, ...props }: CheckboxProps) {\n  // Tracked here rather than read off `props.checked`, which is set only by a\n  // CONTROLLED box: an uncontrolled `defaultChecked=\"indeterminate\"` drew the\n  // tick — the \"all of them\" picture on a partly selected list, which is the one\n  // thing this state exists to avoid saying.\n  const [uncontrolled, setUncontrolled] = useState<CheckboxProps['checked']>(\n    props.defaultChecked ?? false,\n  )\n  const state = props.checked ?? uncontrolled\n\n  const handleChange = (next: NonNullable<CheckboxProps['checked']>) => {\n    if (props.checked === undefined) setUncontrolled(next)\n    onCheckedChange?.(next)\n  }\n\n  return (\n    <CheckboxPrimitive.Root\n      onCheckedChange={handleChange}\n      className={cn(\n        'inline-flex size-[18px] shrink-0 items-center justify-center rounded-(--radius-xs) border border-(--rule-2) bg-(--paper) text-(--accent-foreground) transition-colors duration-(--duration-fast) data-[state=checked]:border-(--accent) data-[state=checked]:bg-(--accent) data-[state=indeterminate]:border-(--accent) data-[state=indeterminate]:bg-(--accent) disabled:opacity-(--disabled-opacity) disabled:pointer-events-none',\n        className,\n      )}\n      {...props}\n    >\n      <CheckboxPrimitive.Indicator className=\"flex items-center justify-center text-current\">\n        {state === 'indeterminate' ? (\n          <Minus className=\"size-3\" strokeWidth={3} aria-hidden />\n        ) : (\n          <Check className=\"size-3\" strokeWidth={3} aria-hidden />\n        )}\n      </CheckboxPrimitive.Indicator>\n    </CheckboxPrimitive.Root>\n  )\n}\n\nexport default Checkbox\n"],"mappings":";AAqDU;AAnDV,YAAY,uBAAuB;AACnC,SAAS,OAAO,aAAa;AAC7B,SAAS,gBAAqC;AAC9C,SAAS,UAAU;AAsBZ,SAAS,SAAS,EAAE,WAAW,iBAAiB,GAAG,MAAM,GAAkB;AAKhF,QAAM,CAAC,cAAc,eAAe,IAAI;AAAA,IACtC,MAAM,kBAAkB;AAAA,EAC1B;AACA,QAAM,QAAQ,MAAM,WAAW;AAE/B,QAAM,eAAe,CAAC,SAAgD;AACpE,QAAI,MAAM,YAAY,OAAW,iBAAgB,IAAI;AACrD,sBAAkB,IAAI;AAAA,EACxB;AAEA,SACE;AAAA,IAAC,kBAAkB;AAAA,IAAlB;AAAA,MACC,iBAAiB;AAAA,MACjB,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA,MAEJ,8BAAC,kBAAkB,WAAlB,EAA4B,WAAU,iDACpC,oBAAU,kBACT,oBAAC,SAAM,WAAU,UAAS,aAAa,GAAG,eAAW,MAAC,IAEtD,oBAAC,SAAM,WAAU,UAAS,aAAa,GAAG,eAAW,MAAC,GAE1D;AAAA;AAAA,EACF;AAEJ;AAEA,IAAO,mBAAQ;","names":[]}

package/dist/components/Code/Code.d.ts

@@ -0,0 +1,30 @@
+import * as react from 'react';
+import { HTMLAttributes, ReactNode } from 'react';
+
+interface CodeProps extends HTMLAttributes<HTMLElement> {
+    children: ReactNode;
+}
+/**
+ * A function name, a flag, a filename — inside a sentence.
+ *
+ * Renders a `<code>`, which is the element that means this. A `<span>` in a
+ * mono face looks identical and tells a screen reader nothing, and "pass
+ * dash dash force" is not what the sentence said.
+ *
+ * Sized in `em` rather than in pixels, so the chip tracks whatever type it sits
+ * beside — the same rule `Kbd` follows, and for the same reason: fixed at one
+ * value, the identical token came out three different sizes on one page
+ * depending on whether it landed in body copy, a caption or a table cell.
+ *
+ * The block form is `CodeBlock`. This one is inline by construction: it draws
+ * no plate, keeps no whitespace, and a multi-line string handed to it collapses
+ * into one run.
+ *
+ * @example
+ * Pass <Code>--force</Code> to overwrite the existing file.
+ * @example
+ * The helper lives in <Code>src/lib/cn.ts</Code>.
+ */
+declare function Code({ children, className, ...rest }: CodeProps): react.JSX.Element;
+
+export { Code, type CodeProps, Code as default };

package/dist/components/Code/Code.js

@@ -0,0 +1,21 @@
+import { jsx } from "react/jsx-runtime";
+import { cn } from "../../lib/cn.js";
+function Code({ children, className, ...rest }) {
+  return /* @__PURE__ */ jsx(
+    "code",
+    {
+      className: cn(
+        "rounded-(--radius-sm) bg-(--stone) px-[0.4em] py-[0.15em] font-mono text-[0.85em] text-(--ink)",
+        className
+      ),
+      ...rest,
+      children
+    }
+  );
+}
+var Code_default = Code;
+export {
+  Code,
+  Code_default as default
+};
+//# sourceMappingURL=Code.js.map

package/dist/components/Code/Code.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/Code/Code.tsx"],"sourcesContent":["import type { HTMLAttributes, ReactNode } from 'react'\nimport { cn } from '../../lib/cn'\n\nexport interface CodeProps extends HTMLAttributes<HTMLElement> {\n  children: ReactNode\n}\n\n/**\n * A function name, a flag, a filename — inside a sentence.\n *\n * Renders a `<code>`, which is the element that means this. A `<span>` in a\n * mono face looks identical and tells a screen reader nothing, and \"pass\n * dash dash force\" is not what the sentence said.\n *\n * Sized in `em` rather than in pixels, so the chip tracks whatever type it sits\n * beside — the same rule `Kbd` follows, and for the same reason: fixed at one\n * value, the identical token came out three different sizes on one page\n * depending on whether it landed in body copy, a caption or a table cell.\n *\n * The block form is `CodeBlock`. This one is inline by construction: it draws\n * no plate, keeps no whitespace, and a multi-line string handed to it collapses\n * into one run.\n *\n * @example\n * Pass <Code>--force</Code> to overwrite the existing file.\n * @example\n * The helper lives in <Code>src/lib/cn.ts</Code>.\n */\nexport function Code({ children, className, ...rest }: CodeProps) {\n  return (\n    <code\n      className={cn(\n        'rounded-(--radius-sm) bg-(--stone) px-[0.4em] py-[0.15em] font-mono text-[0.85em] text-(--ink)',\n        className,\n      )}\n      {...rest}\n    >\n      {children}\n    </code>\n  )\n}\n\nexport default Code\n"],"mappings":"AA8BI;AA7BJ,SAAS,UAAU;AA2BZ,SAAS,KAAK,EAAE,UAAU,WAAW,GAAG,KAAK,GAAc;AAChE,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA,MAEH;AAAA;AAAA,EACH;AAEJ;AAEA,IAAO,eAAQ;","names":[]}

package/dist/components/CodeBlock/CodeBlock.d.ts

@@ -0,0 +1,141 @@
+import * as react from 'react';
+
+interface CommonProps {
+    /**
+     * The snippet, verbatim.
+     *
+     * Required even when `html` is supplied, and that is the point: this is what
+     * the copy button puts on the clipboard. A block that copies its own rendered
+     * markup hands the reader a wall of `<span>`s, and one that copies
+     * `textContent` scraped back out of the DOM is a single non-breaking space
+     * away from pasting something that does not run.
+     */
+    code: string;
+    /** A filename or a caption, printed at the start of the strip. */
+    title?: string;
+    /**
+     * The language, printed at the end of the strip.
+     *
+     * Optional, and the omission is visible rather than silent: a block with no
+     * language gets no label instead of claiming a wrong one. A code block that
+     * does not say what it is written in makes the reader infer it from the
+     * syntax, which is the one thing they came to the block to learn.
+     */
+    lang?: string;
+    /**
+     * Caps the block's height and scrolls past it.
+     *
+     * A number is pixels; a string is any CSS length (`'24rem'`, `'50vh'`). The
+     * body scrolls in both axes and is focusable, so what is past the fold stays
+     * reachable with a keyboard rather than merely present in the DOM.
+     */
+    maxHeight?: number | string;
+    /** Drops the copy button, for a block nobody is meant to run. */
+    copyable?: boolean;
+    /**
+     * Names the scrollable body for a screen reader. Defaults to `title`, and to
+     * "Code" when there is not one.
+     */
+    label?: string;
+    className?: string;
+}
+/**
+ * The two forms, and why they are two.
+ *
+ * `html` is pre-highlighted markup for the SAME snippet. The package does not
+ * highlight, and will not: a highlighter is a few hundred kilobytes of grammar
+ * and a build-time job. The documentation site runs Shiki inside its generator
+ * and hands the result here, which is the shape that half exists for. Without
+ * `html` the block renders `code` as text, which is what a template, a README
+ * or an agent's answer has and all it needs.
+ *
+ * `lineNumbers` and `highlightLines` belong to the plain form only, and that is
+ * enforced in the TYPE rather than left to a note. They are a per-LINE
+ * structure, and `html` is one opaque string this component is not going to
+ * start parsing. Typed apart, passing both is a compile error at the call site;
+ * typed together it is a prop that renders nothing and says nothing.
+ *
+ * The plain form is written first because the emitted prop table reads the
+ * first arm of a union: this way `lineNumbers` documents as `boolean` rather
+ * than as the `never` the other arm gives it.
+ */
+type WithPlainSource = CommonProps & {
+    /**
+     * Absent on this form; `string` on the other.
+     *
+     * Pass pre-highlighted markup — Shiki's output, run at build time over this
+     * same `code` — and the block renders that instead of the plain text. Doing
+     * so takes `lineNumbers` and `highlightLines` away with it.
+     */
+    html?: undefined;
+    /** Numbers every line, counting from one. */
+    lineNumbers?: boolean;
+    /**
+     * Lines to band, counting from one. A number past the end of the snippet is
+     * ignored rather than throwing — the usual cause is a snippet that got
+     * shorter while the annotation did not.
+     */
+    highlightLines?: number[];
+};
+type WithHighlightedHtml = CommonProps & {
+    html: string;
+    /** Not available alongside `html`, which the component does not parse. */
+    lineNumbers?: never;
+    /** Not available alongside `html`, which the component does not parse. */
+    highlightLines?: never;
+};
+type CodeBlockProps = WithPlainSource | WithHighlightedHtml;
+/**
+ * A multi-line snippet, on a plate, with a way to take it away.
+ *
+ * The strip along the top carries the title, the language and the copy button,
+ * and it is there whenever there is anything to put in it. It is deliberately
+ * not a hover affordance: a control that appears on hover does not exist on a
+ * touch screen, which is where a reader is most likely to want the snippet and
+ * least able to select it by hand.
+ *
+ * Line numbers live INSIDE their own line's row rather than in a parallel gutter
+ * column. Two columns sharing a line-height align right up until one of them
+ * wraps, ships a different font, or scrolls on its own; a number that is a child
+ * of the line it numbers cannot come apart from it. The cost is that a number
+ * scrolls away with its line: it is inside the scrolling box, not in a gutter
+ * beside it. A gutter that stayed put would be a second column to keep in sync,
+ * which is the failure this avoids.
+ *
+ * The body is a focusable, named `role="group"`, and both halves of that are
+ * load-bearing. Focusable, because a scrollable box whose contents are not
+ * themselves focusable is unreachable by keyboard — there is nothing to Tab to
+ * and therefore no way to press an arrow key at it, so the right-hand half of a
+ * long line does not exist for anyone not using a mouse. Named, because a tab
+ * stop that announces nothing lands the reader in an anonymous box and leaves
+ * them to work out what they have arrived in.
+ *
+ * `group` rather than `region`, and that is the deliberate half. A region is a
+ * LANDMARK — one of the handful of major sections a reader navigates a whole
+ * page by — and a snippet is not one of those. Three fenced blocks in one
+ * article would put three landmarks called "Code" into that map, which is
+ * exactly the noise the `landmark-unique` rule exists to catch, and it would
+ * push the page's real landmarks down a list nobody can now skim. `group`
+ * carries the same accessible name to the same reader on the way in, and
+ * carries it nowhere else.
+ *
+ * For a function name inside a sentence, reach for `Code`.
+ *
+ * @example
+ * <CodeBlock code="pnpm add @misoto22/design" lang="bash" />
+ * @example
+ * <CodeBlock
+ *   title="cn.ts"
+ *   lang="ts"
+ *   lineNumbers
+ *   highlightLines={[2]}
+ *   maxHeight="24rem"
+ *   code={source}
+ * />
+ * @example
+ * // Highlighted at build time by the site's own Shiki pass.
+ * <CodeBlock code={source} html={highlighted} lang="tsx" />
+ */
+declare function CodeBlock({ code, html, title, lang, maxHeight, copyable, label, className, lineNumbers, highlightLines, }: CodeBlockProps): react.JSX.Element;
+
+export { CodeBlock, type CodeBlockProps, CodeBlock as default };

package/dist/components/CodeBlock/CodeBlock.js

@@ -0,0 +1,123 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Check, Copy } from "lucide-react";
+import { useEffect, useState } from "react";
+import { cn } from "../../lib/cn.js";
+import { Button } from "../Button/Button.js";
+const LANGUAGE_LABEL = {
+  bash: "Shell",
+  css: "CSS",
+  html: "HTML",
+  js: "JavaScript",
+  json: "JSON",
+  jsx: "JSX",
+  md: "Markdown",
+  sh: "Shell",
+  ts: "TypeScript",
+  tsx: "TSX"
+};
+const HIGHLIGHTED = "[&_pre]:m-0 [&_pre]:min-w-max [&_pre]:bg-transparent [&_pre]:p-0 [&_pre]:font-mono [&_pre]:text-[13px] [&_pre]:leading-[1.7] [&_code]:bg-transparent";
+function CodeBlock({
+  code,
+  html,
+  title,
+  lang,
+  maxHeight,
+  copyable = true,
+  label,
+  className,
+  lineNumbers = false,
+  highlightLines
+}) {
+  const [copied, setCopied] = useState(false);
+  useEffect(() => {
+    if (!copied) return;
+    const timer = setTimeout(() => setCopied(false), 1600);
+    return () => clearTimeout(timer);
+  }, [copied]);
+  const copy = async () => {
+    try {
+      await navigator.clipboard.writeText(code);
+      setCopied(true);
+    } catch {
+    }
+  };
+  const languageLabel = lang ? LANGUAGE_LABEL[lang] ?? lang.toUpperCase() : void 0;
+  const banded = new Set(highlightLines ?? []);
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn(
+        // `min-w-0` is what lets the body below actually scroll: a grid or flex
+        // item defaults to `min-width: auto`, so without it the block grows to
+        // the min-content width of its longest line — an unbroken install
+        // command — and pushes the whole page sideways on a phone.
+        "flex min-w-0 flex-col overflow-hidden rounded-(--radius-lg) border border-(--rule) bg-(--paper-2)",
+        className
+      ),
+      children: [
+        title || languageLabel || copyable ? /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3 border-b border-(--rule) py-1.5 ps-4 pe-1.5", children: [
+          title ? /* @__PURE__ */ jsx("span", { className: "mono-meta truncate text-(--ink-2)", children: title }) : null,
+          languageLabel ? /* @__PURE__ */ jsx("span", { className: "mono-meta shrink-0 text-(--ink-3-aa)", children: languageLabel }) : null,
+          copyable ? /* @__PURE__ */ jsx(
+            Button,
+            {
+              iconOnly: true,
+              size: "sm",
+              variant: "ghost",
+              onClick: copy,
+              "aria-label": copied ? "Copied" : "Copy the snippet",
+              className: "ms-auto shrink-0 pointer-coarse:min-h-11 pointer-coarse:min-w-11",
+              children: copied ? /* @__PURE__ */ jsx(Check, { size: 14, strokeWidth: 1.5, "aria-hidden": true }) : /* @__PURE__ */ jsx(Copy, { size: 14, strokeWidth: 1.5, "aria-hidden": true })
+            }
+          ) : null
+        ] }) : null,
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            tabIndex: 0,
+            role: "group",
+            "aria-label": label ?? title ?? "Code",
+            style: maxHeight === void 0 ? void 0 : { maxHeight },
+            className: "overflow-auto px-4 py-3.5 scroll-slim",
+            children: html === void 0 ? /* @__PURE__ */ jsx("pre", { className: "m-0 min-w-max bg-transparent p-0 font-mono text-[13px] leading-[1.7]", children: /* @__PURE__ */ jsx("code", { className: "block", children: code.split("\n").map((line, index) => /* @__PURE__ */ jsxs(
+              "span",
+              {
+                "data-line": index + 1,
+                "data-highlighted": banded.has(index + 1) ? "" : void 0,
+                className: cn(
+                  "block min-h-[1.7em] border-s-2 border-transparent ps-2",
+                  banded.has(index + 1) && "border-(--accent) bg-(--stone)"
+                ),
+                children: [
+                  lineNumbers ? /* @__PURE__ */ jsx(
+                    "span",
+                    {
+                      "aria-hidden": true,
+                      className: "inline-block w-8 shrink-0 select-none pe-3 text-end tabular-nums text-(--ink-3-aa)",
+                      children: index + 1
+                    }
+                  ) : null,
+                  line
+                ]
+              },
+              index
+            )) }) }) : (
+              // Trusted markup only: the output of the caller's own highlighter, run
+              // over the caller's own `code`. It is not a place to put anything a
+              // reader wrote — hand that to `code` and let the block render it as
+              // text, which it cannot mis-execute.
+              /* @__PURE__ */ jsx("div", { className: HIGHLIGHTED, dangerouslySetInnerHTML: { __html: html } })
+            )
+          }
+        )
+      ]
+    }
+  );
+}
+var CodeBlock_default = CodeBlock;
+export {
+  CodeBlock,
+  CodeBlock_default as default
+};
+//# sourceMappingURL=CodeBlock.js.map

package/dist/components/CodeBlock/CodeBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/CodeBlock/CodeBlock.tsx"],"sourcesContent":["'use client'\n\nimport { Check, Copy } from 'lucide-react'\nimport { useEffect, useState } from 'react'\nimport { cn } from '../../lib/cn'\nimport { Button } from '../Button/Button'\n\n/**\n * What a language id is CALLED, for the handful where the id is not a label.\n *\n * Shiki's ids are identifiers, not words: `tsx` and `bash` read fine in upper\n * case, `md` and `ts` do not, and nobody reads `sh` as \"shell\". Anything absent\n * falls through to the id upper-cased, which is right far more often than it is\n * wrong — and a wrong label here is a label, not a crash.\n */\nconst LANGUAGE_LABEL: Record<string, string> = {\n  bash: 'Shell',\n  css: 'CSS',\n  html: 'HTML',\n  js: 'JavaScript',\n  json: 'JSON',\n  jsx: 'JSX',\n  md: 'Markdown',\n  sh: 'Shell',\n  ts: 'TypeScript',\n  tsx: 'TSX',\n}\n\ninterface CommonProps {\n  /**\n   * The snippet, verbatim.\n   *\n   * Required even when `html` is supplied, and that is the point: this is what\n   * the copy button puts on the clipboard. A block that copies its own rendered\n   * markup hands the reader a wall of `<span>`s, and one that copies\n   * `textContent` scraped back out of the DOM is a single non-breaking space\n   * away from pasting something that does not run.\n   */\n  code: string\n  /** A filename or a caption, printed at the start of the strip. */\n  title?: string\n  /**\n   * The language, printed at the end of the strip.\n   *\n   * Optional, and the omission is visible rather than silent: a block with no\n   * language gets no label instead of claiming a wrong one. A code block that\n   * does not say what it is written in makes the reader infer it from the\n   * syntax, which is the one thing they came to the block to learn.\n   */\n  lang?: string\n  /**\n   * Caps the block's height and scrolls past it.\n   *\n   * A number is pixels; a string is any CSS length (`'24rem'`, `'50vh'`). The\n   * body scrolls in both axes and is focusable, so what is past the fold stays\n   * reachable with a keyboard rather than merely present in the DOM.\n   */\n  maxHeight?: number | string\n  /** Drops the copy button, for a block nobody is meant to run. */\n  copyable?: boolean\n  /**\n   * Names the scrollable body for a screen reader. Defaults to `title`, and to\n   * \"Code\" when there is not one.\n   */\n  label?: string\n  className?: string\n}\n\n/**\n * The two forms, and why they are two.\n *\n * `html` is pre-highlighted markup for the SAME snippet. The package does not\n * highlight, and will not: a highlighter is a few hundred kilobytes of grammar\n * and a build-time job. The documentation site runs Shiki inside its generator\n * and hands the result here, which is the shape that half exists for. Without\n * `html` the block renders `code` as text, which is what a template, a README\n * or an agent's answer has and all it needs.\n *\n * `lineNumbers` and `highlightLines` belong to the plain form only, and that is\n * enforced in the TYPE rather than left to a note. They are a per-LINE\n * structure, and `html` is one opaque string this component is not going to\n * start parsing. Typed apart, passing both is a compile error at the call site;\n * typed together it is a prop that renders nothing and says nothing.\n *\n * The plain form is written first because the emitted prop table reads the\n * first arm of a union: this way `lineNumbers` documents as `boolean` rather\n * than as the `never` the other arm gives it.\n */\ntype WithPlainSource = CommonProps & {\n  /**\n   * Absent on this form; `string` on the other.\n   *\n   * Pass pre-highlighted markup — Shiki's output, run at build time over this\n   * same `code` — and the block renders that instead of the plain text. Doing\n   * so takes `lineNumbers` and `highlightLines` away with it.\n   */\n  html?: undefined\n  /** Numbers every line, counting from one. */\n  lineNumbers?: boolean\n  /**\n   * Lines to band, counting from one. A number past the end of the snippet is\n   * ignored rather than throwing — the usual cause is a snippet that got\n   * shorter while the annotation did not.\n   */\n  highlightLines?: number[]\n}\n\ntype WithHighlightedHtml = CommonProps & {\n  html: string\n  /** Not available alongside `html`, which the component does not parse. */\n  lineNumbers?: never\n  /** Not available alongside `html`, which the component does not parse. */\n  highlightLines?: never\n}\n\nexport type CodeBlockProps = WithPlainSource | WithHighlightedHtml\n\n/**\n * The caller's `<pre>`, normalised to ours.\n *\n * Shiki emits a `<pre>` of its own with a background and padding baked in, so\n * the highlighted path would otherwise draw a second plate a shade off the one\n * it is sitting on, at a size that does not match the plain path.\n */\nconst HIGHLIGHTED =\n  '[&_pre]:m-0 [&_pre]:min-w-max [&_pre]:bg-transparent [&_pre]:p-0 [&_pre]:font-mono [&_pre]:text-[13px] [&_pre]:leading-[1.7] [&_code]:bg-transparent'\n\n/**\n * A multi-line snippet, on a plate, with a way to take it away.\n *\n * The strip along the top carries the title, the language and the copy button,\n * and it is there whenever there is anything to put in it. It is deliberately\n * not a hover affordance: a control that appears on hover does not exist on a\n * touch screen, which is where a reader is most likely to want the snippet and\n * least able to select it by hand.\n *\n * Line numbers live INSIDE their own line's row rather than in a parallel gutter\n * column. Two columns sharing a line-height align right up until one of them\n * wraps, ships a different font, or scrolls on its own; a number that is a child\n * of the line it numbers cannot come apart from it. The cost is that a number\n * scrolls away with its line: it is inside the scrolling box, not in a gutter\n * beside it. A gutter that stayed put would be a second column to keep in sync,\n * which is the failure this avoids.\n *\n * The body is a focusable, named `role=\"group\"`, and both halves of that are\n * load-bearing. Focusable, because a scrollable box whose contents are not\n * themselves focusable is unreachable by keyboard — there is nothing to Tab to\n * and therefore no way to press an arrow key at it, so the right-hand half of a\n * long line does not exist for anyone not using a mouse. Named, because a tab\n * stop that announces nothing lands the reader in an anonymous box and leaves\n * them to work out what they have arrived in.\n *\n * `group` rather than `region`, and that is the deliberate half. A region is a\n * LANDMARK — one of the handful of major sections a reader navigates a whole\n * page by — and a snippet is not one of those. Three fenced blocks in one\n * article would put three landmarks called \"Code\" into that map, which is\n * exactly the noise the `landmark-unique` rule exists to catch, and it would\n * push the page's real landmarks down a list nobody can now skim. `group`\n * carries the same accessible name to the same reader on the way in, and\n * carries it nowhere else.\n *\n * For a function name inside a sentence, reach for `Code`.\n *\n * @example\n * <CodeBlock code=\"pnpm add @misoto22/design\" lang=\"bash\" />\n * @example\n * <CodeBlock\n *   title=\"cn.ts\"\n *   lang=\"ts\"\n *   lineNumbers\n *   highlightLines={[2]}\n *   maxHeight=\"24rem\"\n *   code={source}\n * />\n * @example\n * // Highlighted at build time by the site's own Shiki pass.\n * <CodeBlock code={source} html={highlighted} lang=\"tsx\" />\n */\nexport function CodeBlock({\n  code,\n  html,\n  title,\n  lang,\n  maxHeight,\n  copyable = true,\n  label,\n  className,\n  lineNumbers = false,\n  highlightLines,\n}: CodeBlockProps) {\n  const [copied, setCopied] = useState(false)\n\n  useEffect(() => {\n    if (!copied) return\n    const timer = setTimeout(() => setCopied(false), 1600)\n    return () => clearTimeout(timer)\n  }, [copied])\n\n  const copy = async () => {\n    try {\n      await navigator.clipboard.writeText(code)\n      setCopied(true)\n    } catch {\n      // Clipboard access is denied in an insecure context and inside some\n      // embeds. The snippet is still selectable, so there is nothing to\n      // recover — and an unhandled rejection here would take the page with it.\n    }\n  }\n\n  const languageLabel = lang ? (LANGUAGE_LABEL[lang] ?? lang.toUpperCase()) : undefined\n  const banded = new Set(highlightLines ?? [])\n\n  return (\n    <div\n      className={cn(\n        // `min-w-0` is what lets the body below actually scroll: a grid or flex\n        // item defaults to `min-width: auto`, so without it the block grows to\n        // the min-content width of its longest line — an unbroken install\n        // command — and pushes the whole page sideways on a phone.\n        'flex min-w-0 flex-col overflow-hidden rounded-(--radius-lg) border border-(--rule) bg-(--paper-2)',\n        className,\n      )}\n    >\n      {title || languageLabel || copyable ? (\n        <div className=\"flex items-center gap-3 border-b border-(--rule) py-1.5 ps-4 pe-1.5\">\n          {title ? <span className=\"mono-meta truncate text-(--ink-2)\">{title}</span> : null}\n          {languageLabel ? (\n            <span className=\"mono-meta shrink-0 text-(--ink-3-aa)\">{languageLabel}</span>\n          ) : null}\n          {copyable ? (\n            <Button\n              iconOnly\n              size=\"sm\"\n              variant=\"ghost\"\n              onClick={copy}\n              aria-label={copied ? 'Copied' : 'Copy the snippet'}\n              // `sm` is 36px, under the 44px a finger needs. The bump is gated\n              // on a coarse pointer so a mouse-driven page keeps the compact\n              // strip (WCAG 2.5.5).\n              className=\"ms-auto shrink-0 pointer-coarse:min-h-11 pointer-coarse:min-w-11\"\n            >\n              {copied ? (\n                <Check size={14} strokeWidth={1.5} aria-hidden />\n              ) : (\n                <Copy size={14} strokeWidth={1.5} aria-hidden />\n              )}\n            </Button>\n          ) : null}\n        </div>\n      ) : null}\n\n      <div\n        tabIndex={0}\n        // A named group, not a landmark: see the note above the component.\n        role=\"group\"\n        aria-label={label ?? title ?? 'Code'}\n        style={maxHeight === undefined ? undefined : { maxHeight }}\n        className=\"overflow-auto px-4 py-3.5 scroll-slim\"\n      >\n        {html === undefined ? (\n          <pre className=\"m-0 min-w-max bg-transparent p-0 font-mono text-[13px] leading-[1.7]\">\n            <code className=\"block\">\n              {code.split('\\n').map((line, index) => (\n                <span\n                  key={index}\n                  data-line={index + 1}\n                  data-highlighted={banded.has(index + 1) ? '' : undefined}\n                  // The transparent border is carried by EVERY row, banded or\n                  // not. On the banded ones alone it would shift them two pixels\n                  // along the inline axis — which is the exact misalignment a\n                  // highlight is there to help the reader see past.\n                  //\n                  // `min-h` is what keeps a blank line a line: an empty block\n                  // has no line box and would otherwise collapse to nothing,\n                  // taking every number below it out of step with its code.\n                  className={cn(\n                    'block min-h-[1.7em] border-s-2 border-transparent ps-2',\n                    banded.has(index + 1) && 'border-(--accent) bg-(--stone)',\n                  )}\n                >\n                  {lineNumbers ? (\n                    <span\n                      aria-hidden\n                      className=\"inline-block w-8 shrink-0 select-none pe-3 text-end tabular-nums text-(--ink-3-aa)\"\n                    >\n                      {index + 1}\n                    </span>\n                  ) : null}\n                  {line}\n                </span>\n              ))}\n            </code>\n          </pre>\n        ) : (\n          // Trusted markup only: the output of the caller's own highlighter, run\n          // over the caller's own `code`. It is not a place to put anything a\n          // reader wrote — hand that to `code` and let the block render it as\n          // text, which it cannot mis-execute.\n          <div className={HIGHLIGHTED} dangerouslySetInnerHTML={{ __html: html }} />\n        )}\n      </div>\n    </div>\n  )\n}\n\nexport default CodeBlock\n"],"mappings":";AAgOQ,SACW,KADX;AA9NR,SAAS,OAAO,YAAY;AAC5B,SAAS,WAAW,gBAAgB;AACpC,SAAS,UAAU;AACnB,SAAS,cAAc;AAUvB,MAAM,iBAAyC;AAAA,EAC7C,MAAM;AAAA,EACN,KAAK;AAAA,EACL,MAAM;AAAA,EACN,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,KAAK;AAAA,EACL,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,KAAK;AACP;AAkGA,MAAM,cACJ;AAqDK,SAAS,UAAU;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd;AACF,GAAmB;AACjB,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,KAAK;AAE1C,YAAU,MAAM;AACd,QAAI,CAAC,OAAQ;AACb,UAAM,QAAQ,WAAW,MAAM,UAAU,KAAK,GAAG,IAAI;AACrD,WAAO,MAAM,aAAa,KAAK;AAAA,EACjC,GAAG,CAAC,MAAM,CAAC;AAEX,QAAM,OAAO,YAAY;AACvB,QAAI;AACF,YAAM,UAAU,UAAU,UAAU,IAAI;AACxC,gBAAU,IAAI;AAAA,IAChB,QAAQ;AAAA,IAIR;AAAA,EACF;AAEA,QAAM,gBAAgB,OAAQ,eAAe,IAAI,KAAK,KAAK,YAAY,IAAK;AAC5E,QAAM,SAAS,IAAI,IAAI,kBAAkB,CAAC,CAAC;AAE3C,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA,QAKT;AAAA,QACA;AAAA,MACF;AAAA,MAEC;AAAA,iBAAS,iBAAiB,WACzB,qBAAC,SAAI,WAAU,uEACZ;AAAA,kBAAQ,oBAAC,UAAK,WAAU,qCAAqC,iBAAM,IAAU;AAAA,UAC7E,gBACC,oBAAC,UAAK,WAAU,wCAAwC,yBAAc,IACpE;AAAA,UACH,WACC;AAAA,YAAC;AAAA;AAAA,cACC,UAAQ;AAAA,cACR,MAAK;AAAA,cACL,SAAQ;AAAA,cACR,SAAS;AAAA,cACT,cAAY,SAAS,WAAW;AAAA,cAIhC,WAAU;AAAA,cAET,mBACC,oBAAC,SAAM,MAAM,IAAI,aAAa,KAAK,eAAW,MAAC,IAE/C,oBAAC,QAAK,MAAM,IAAI,aAAa,KAAK,eAAW,MAAC;AAAA;AAAA,UAElD,IACE;AAAA,WACN,IACE;AAAA,QAEJ;AAAA,UAAC;AAAA;AAAA,YACC,UAAU;AAAA,YAEV,MAAK;AAAA,YACL,cAAY,SAAS,SAAS;AAAA,YAC9B,OAAO,cAAc,SAAY,SAAY,EAAE,UAAU;AAAA,YACzD,WAAU;AAAA,YAET,mBAAS,SACR,oBAAC,SAAI,WAAU,wEACb,8BAAC,UAAK,WAAU,SACb,eAAK,MAAM,IAAI,EAAE,IAAI,CAAC,MAAM,UAC3B;AAAA,cAAC;AAAA;AAAA,gBAEC,aAAW,QAAQ;AAAA,gBACnB,oBAAkB,OAAO,IAAI,QAAQ,CAAC,IAAI,KAAK;AAAA,gBAS/C,WAAW;AAAA,kBACT;AAAA,kBACA,OAAO,IAAI,QAAQ,CAAC,KAAK;AAAA,gBAC3B;AAAA,gBAEC;AAAA,gCACC;AAAA,oBAAC;AAAA;AAAA,sBACC,eAAW;AAAA,sBACX,WAAU;AAAA,sBAET,kBAAQ;AAAA;AAAA,kBACX,IACE;AAAA,kBACH;AAAA;AAAA;AAAA,cAxBI;AAAA,YAyBP,CACD,GACH,GACF;AAAA;AAAA;AAAA;AAAA;AAAA,cAMA,oBAAC,SAAI,WAAW,aAAa,yBAAyB,EAAE,QAAQ,KAAK,GAAG;AAAA;AAAA;AAAA,QAE5E;AAAA;AAAA;AAAA,EACF;AAEJ;AAEA,IAAO,oBAAQ;","names":[]}

package/dist/components/Collapsible/Collapsible.js

@@ -12,8 +12,9 @@ function CollapsibleContent({
   return /* @__PURE__ */ jsx(
     CollapsiblePrimitive.Content,
     {
+      "data-m22-animated": true,
       className: cn(
-        "overflow-hidden data-[state=closed]:animate-[m22-collapsible-up_var(--duration-base)_var(--ease)] data-[state=open]:animate-[m22-collapsible-down_var(--duration-base)_var(--ease)] motion-reduce:animate-none",
+        "overflow-hidden data-[state=closed]:animate-[m22-collapsible-up_var(--duration-base)_var(--ease)] data-[state=open]:animate-[m22-collapsible-down_var(--duration-base)_var(--ease)]",
         className
       ),
       ...props
@@ -39,7 +40,14 @@ function CollapsibleSection({
         }
       )
     ] }),
-    /* @__PURE__ */ jsx(CollapsiblePrimitive.Content, { className: "overflow-hidden text-sm leading-relaxed text-(--ink-2) data-[state=closed]:animate-[m22-collapsible-up_var(--duration-base)_var(--ease)] data-[state=open]:animate-[m22-collapsible-down_var(--duration-base)_var(--ease)]", children: /* @__PURE__ */ jsx("div", { className: "pb-3", children }) })
+    /* @__PURE__ */ jsx(
+      CollapsiblePrimitive.Content,
+      {
+        "data-m22-animated": true,
+        className: "overflow-hidden text-sm leading-relaxed text-(--ink-2) data-[state=closed]:animate-[m22-collapsible-up_var(--duration-base)_var(--ease)] data-[state=open]:animate-[m22-collapsible-down_var(--duration-base)_var(--ease)]",
+        children: /* @__PURE__ */ jsx("div", { className: "pb-3", children })
+      }
+    )
   ] });
 }
 var Collapsible_default = Collapsible;

package/dist/components/Collapsible/Collapsible.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/Collapsible/Collapsible.tsx"],"sourcesContent":["'use client'\n\nimport * as CollapsiblePrimitive from '@radix-ui/react-collapsible'\nimport { ChevronDown } from 'lucide-react'\nimport type { ComponentProps, ReactNode } from 'react'\nimport { cn } from '../../lib/cn'\n\n/** Radix Collapsible root, as a typed passthrough. */\nexport const Collapsible = CollapsiblePrimitive.Root\n\n/**\n * The trigger and the panel, unstyled, for a disclosure that needs its own\n * layout — a sidebar group whose header carries a count and a chevron on\n * opposite sides, say. `CollapsibleSection` is the composed version and is what\n * most call sites want; these two exist so the ones that do not have to reach\n * for Radix directly and re-derive the keyboard and `aria-expanded` wiring.\n *\n * The panel animates on `--radix-collapsible-content-height`, which Radix\n * measures — so it opens to its real height rather than to a guessed\n * `max-height`, which is what makes a long group and a short one take the same\n * time instead of the long one appearing to stall.\n */\nexport const CollapsibleTrigger = CollapsiblePrimitive.Trigger\n\nexport function CollapsibleContent({\n  className,\n  ...props\n}: ComponentProps<typeof CollapsiblePrimitive.Content>) {\n  return (\n    <CollapsiblePrimitive.Content\n      className={cn(\n        'overflow-hidden data-[state=closed]:animate-[m22-collapsible-up_var(--duration-base)_var(--ease)] data-[state=open]:animate-[m22-collapsible-down_var(--duration-base)_var(--ease)] motion-reduce:animate-none',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nexport interface CollapsibleSectionProps\n  extends Omit<ComponentProps<typeof CollapsiblePrimitive.Root>, 'children' | 'title'> {\n  /** What the trigger says. */\n  title: ReactNode\n  children: ReactNode\n}\n\n/**\n * One thing that opens, on its own.\n *\n * The difference from `Accordion` is arithmetic: an accordion is a SET, and a\n * set can coordinate — opening one closes another. A collapsible is one\n * disclosure with nothing to coordinate with. Reaching for an accordion of one\n * gets you a component managing a value you never read.\n *\n * The marker here is a chevron rather than the accordion's plus, and\n * deliberately: this reveals more of the same thing, where an accordion row\n * opens a distinct answer.\n *\n * @example\n * <CollapsibleSection title=\"Advanced settings\">\n *   <Field label=\"Retries\"><Input type=\"number\" /></Field>\n * </CollapsibleSection>\n */\nexport function CollapsibleSection({\n  title,\n  children,\n  className,\n  ...props\n}: CollapsibleSectionProps) {\n  return (\n    <CollapsiblePrimitive.Root className={cn('w-full', className)} {...props}>\n      <CollapsiblePrimitive.Trigger className=\"group flex w-full items-center justify-between gap-4 py-3 text-start text-sm text-(--ink) transition-colors duration-(--duration-fast) hover:text-(--ink-2)\">\n        {title}\n        <ChevronDown\n          size={16}\n          strokeWidth={1.5}\n          aria-hidden\n          className=\"shrink-0 text-(--ink-3-aa) transition-transform duration-(--duration-base) ease-(--ease-out-expo) group-data-[state=open]:rotate-180\"\n        />\n      </CollapsiblePrimitive.Trigger>\n      <CollapsiblePrimitive.Content className=\"overflow-hidden text-sm leading-relaxed text-(--ink-2) data-[state=closed]:animate-[m22-collapsible-up_var(--duration-base)_var(--ease)] data-[state=open]:animate-[m22-collapsible-down_var(--duration-base)_var(--ease)]\">\n        <div className=\"pb-3\">{children}</div>\n      </CollapsiblePrimitive.Content>\n    </CollapsiblePrimitive.Root>\n  )\n}\n\nexport default Collapsible\n"],"mappings":";AA6BI,cA0CE,YA1CF;AA3BJ,YAAY,0BAA0B;AACtC,SAAS,mBAAmB;AAE5B,SAAS,UAAU;AAGZ,MAAM,cAAc,qBAAqB;AAczC,MAAM,qBAAqB,qBAAqB;AAEhD,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA,GAAG;AACL,GAAwD;AACtD,SACE;AAAA,IAAC,qBAAqB;AAAA,IAArB;AAAA,MACC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA;AAAA,EACN;AAEJ;AA0BO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAA4B;AAC1B,SACE,qBAAC,qBAAqB,MAArB,EAA0B,WAAW,GAAG,UAAU,SAAS,GAAI,GAAG,OACjE;AAAA,yBAAC,qBAAqB,SAArB,EAA6B,WAAU,+JACrC;AAAA;AAAA,MACD;AAAA,QAAC;AAAA;AAAA,UACC,MAAM;AAAA,UACN,aAAa;AAAA,UACb,eAAW;AAAA,UACX,WAAU;AAAA;AAAA,MACZ;AAAA,OACF;AAAA,IACA,oBAAC,qBAAqB,SAArB,EAA6B,WAAU,8NACtC,8BAAC,SAAI,WAAU,QAAQ,UAAS,GAClC;AAAA,KACF;AAEJ;AAEA,IAAO,sBAAQ;","names":[]}
+{"version":3,"sources":["../../../src/components/Collapsible/Collapsible.tsx"],"sourcesContent":["'use client'\n\nimport * as CollapsiblePrimitive from '@radix-ui/react-collapsible'\nimport { ChevronDown } from 'lucide-react'\nimport type { ComponentProps, ReactNode } from 'react'\nimport { cn } from '../../lib/cn'\n\n/** Radix Collapsible root, as a typed passthrough. */\nexport const Collapsible = CollapsiblePrimitive.Root\n\n/**\n * The trigger and the panel, unstyled, for a disclosure that needs its own\n * layout — a sidebar group whose header carries a count and a chevron on\n * opposite sides, say. `CollapsibleSection` is the composed version and is what\n * most call sites want; these two exist so the ones that do not have to reach\n * for Radix directly and re-derive the keyboard and `aria-expanded` wiring.\n *\n * The panel animates on `--radix-collapsible-content-height`, which Radix\n * measures — so it opens to its real height rather than to a guessed\n * `max-height`, which is what makes a long group and a short one take the same\n * time instead of the long one appearing to stall.\n */\nexport const CollapsibleTrigger = CollapsiblePrimitive.Trigger\n\nexport function CollapsibleContent({\n  className,\n  ...props\n}: ComponentProps<typeof CollapsiblePrimitive.Content>) {\n  return (\n    <CollapsiblePrimitive.Content\n      data-m22-animated\n      className={cn(\n        'overflow-hidden data-[state=closed]:animate-[m22-collapsible-up_var(--duration-base)_var(--ease)] data-[state=open]:animate-[m22-collapsible-down_var(--duration-base)_var(--ease)]',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nexport interface CollapsibleSectionProps\n  extends Omit<ComponentProps<typeof CollapsiblePrimitive.Root>, 'children' | 'title'> {\n  /** What the trigger says. */\n  title: ReactNode\n  children: ReactNode\n}\n\n/**\n * One thing that opens, on its own.\n *\n * The difference from `Accordion` is arithmetic: an accordion is a SET, and a\n * set can coordinate — opening one closes another. A collapsible is one\n * disclosure with nothing to coordinate with. Reaching for an accordion of one\n * gets you a component managing a value you never read.\n *\n * The marker here is a chevron rather than the accordion's plus, and\n * deliberately: this reveals more of the same thing, where an accordion row\n * opens a distinct answer.\n *\n * @example\n * <CollapsibleSection title=\"Advanced settings\">\n *   <Field label=\"Retries\"><Input type=\"number\" /></Field>\n * </CollapsibleSection>\n */\nexport function CollapsibleSection({\n  title,\n  children,\n  className,\n  ...props\n}: CollapsibleSectionProps) {\n  return (\n    <CollapsiblePrimitive.Root className={cn('w-full', className)} {...props}>\n      <CollapsiblePrimitive.Trigger className=\"group flex w-full items-center justify-between gap-4 py-3 text-start text-sm text-(--ink) transition-colors duration-(--duration-fast) hover:text-(--ink-2)\">\n        {title}\n        <ChevronDown\n          size={16}\n          strokeWidth={1.5}\n          aria-hidden\n          className=\"shrink-0 text-(--ink-3-aa) transition-transform duration-(--duration-base) ease-(--ease-out-expo) group-data-[state=open]:rotate-180\"\n        />\n      </CollapsiblePrimitive.Trigger>\n      <CollapsiblePrimitive.Content\n        data-m22-animated\n        className=\"overflow-hidden text-sm leading-relaxed text-(--ink-2) data-[state=closed]:animate-[m22-collapsible-up_var(--duration-base)_var(--ease)] data-[state=open]:animate-[m22-collapsible-down_var(--duration-base)_var(--ease)]\"\n      >\n        <div className=\"pb-3\">{children}</div>\n      </CollapsiblePrimitive.Content>\n    </CollapsiblePrimitive.Root>\n  )\n}\n\nexport default Collapsible\n"],"mappings":";AA6BI,cA2CE,YA3CF;AA3BJ,YAAY,0BAA0B;AACtC,SAAS,mBAAmB;AAE5B,SAAS,UAAU;AAGZ,MAAM,cAAc,qBAAqB;AAczC,MAAM,qBAAqB,qBAAqB;AAEhD,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA,GAAG;AACL,GAAwD;AACtD,SACE;AAAA,IAAC,qBAAqB;AAAA,IAArB;AAAA,MACC,qBAAiB;AAAA,MACjB,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA;AAAA,EACN;AAEJ;AA0BO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAA4B;AAC1B,SACE,qBAAC,qBAAqB,MAArB,EAA0B,WAAW,GAAG,UAAU,SAAS,GAAI,GAAG,OACjE;AAAA,yBAAC,qBAAqB,SAArB,EAA6B,WAAU,+JACrC;AAAA;AAAA,MACD;AAAA,QAAC;AAAA;AAAA,UACC,MAAM;AAAA,UACN,aAAa;AAAA,UACb,eAAW;AAAA,UACX,WAAU;AAAA;AAAA,MACZ;AAAA,OACF;AAAA,IACA;AAAA,MAAC,qBAAqB;AAAA,MAArB;AAAA,QACC,qBAAiB;AAAA,QACjB,WAAU;AAAA,QAEV,8BAAC,SAAI,WAAU,QAAQ,UAAS;AAAA;AAAA,IAClC;AAAA,KACF;AAEJ;AAEA,IAAO,sBAAQ;","names":[]}

package/dist/components/Combobox/Combobox.d.ts

@@ -9,7 +9,13 @@ interface ComboboxOption {
 }
 interface CommonProps {
     options: ComboboxOption[];
-    /** Names the control. Required — the trigger's text is a value, not a label. */
+    /**
+     * Names the control. Required — the trigger's text is a value, not a label.
+     *
+     * Announced together with the summary rather than instead of it, so a reader
+     * hears "Tags, 3 selected". Inside a `Field` with a label, that label names
+     * the trigger and this one is not repeated.
+     */
     label: string;
     /** Shown on the trigger when nothing is chosen. */
     placeholder?: string;
@@ -19,6 +25,14 @@ interface CommonProps {
     emptyMessage?: string;
     disabled?: boolean;
     className?: string;
+    /** The TRIGGER's id — the element a label points at. A `Field` sets it. */
+    id?: string;
+    /** Ids of the copy describing the control. A `Field` sets it from hint, error and description. */
+    'aria-describedby'?: string;
+    /** Paints the resting border with `--danger` and is announced. A `Field` sets it from `error`. */
+    'aria-invalid'?: boolean | 'true' | 'false';
+    /** Announced on the trigger. A `Field` sets it from `required`. */
+    'aria-required'?: boolean;
 }
 interface SingleProps extends CommonProps {
     multiple?: false;

package/dist/components/Combobox/Combobox.js

@@ -1,8 +1,11 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Check, ChevronsUpDown, X } from "lucide-react";
-import { useState } from "react";
+import { useId, useState } from "react";
 import { cn } from "../../lib/cn.js";
+import { CONTROL_BORDER, isInvalid } from "../../lib/control.js";
+import { useFieldControl } from "../Field/field-control.js";
+import { warnBlankName } from "../../lib/warn.js";
 import {
   Command,
   CommandEmpty,
@@ -21,9 +24,20 @@ function Combobox(props) {
     searchPlaceholder = "Search\u2026",
     emptyMessage = "Nothing matches.",
     disabled = false,
-    className
+    className,
+    id,
+    "aria-describedby": describedBy,
+    "aria-invalid": ariaInvalid,
+    "aria-required": ariaRequired
   } = props;
   const multiple = props.multiple === true;
+  warnBlankName("Combobox", "label", label, "the trigger is announced with no name");
+  const field = useFieldControl();
+  const generated = useId();
+  const triggerId = id ?? generated;
+  const summaryId = `${triggerId}-value`;
+  const nameId = field?.labelId ?? `${triggerId}-name`;
+  const bad = isInvalid(void 0, ariaInvalid);
   const [open, setOpen] = useState(false);
   const [uncontrolled, setUncontrolled] = useState(() => {
     if (props.multiple === true) return props.defaultValue ?? [];
@@ -51,16 +65,22 @@ function Combobox(props) {
       PopoverTrigger,
       {
         role: "combobox",
+        id: triggerId,
         "aria-expanded": open,
-        "aria-label": label,
+        "aria-labelledby": `${nameId} ${summaryId}`,
+        "aria-describedby": describedBy,
+        "aria-required": ariaRequired,
+        "aria-invalid": bad || void 0,
         disabled,
         className: cn(
-          "group flex w-full items-center justify-between gap-2 rounded-(--radius) border border-(--rule-2) bg-(--paper) px-(--field-px) py-(--field-py) text-start text-sm transition-colors duration-(--duration-fast) hover:border-(--rule-hard) disabled:opacity-(--disabled-opacity) disabled:pointer-events-none",
+          "group flex w-full items-center justify-between gap-2 rounded-(--radius) border bg-(--paper) px-(--field-px) py-(--field-py) text-start text-sm transition-colors duration-(--duration-fast) hover:border-(--rule-hard) disabled:opacity-(--disabled-opacity) disabled:pointer-events-none",
+          bad ? CONTROL_BORDER.invalid : CONTROL_BORDER.resting,
           chosen.length > 0 ? "text-(--ink)" : "text-(--ink-3-aa)",
           className
         ),
         children: [
-          /* @__PURE__ */ jsx("span", { className: "truncate", children: summary }),
+          field?.labelId == null && /* @__PURE__ */ jsx("span", { id: nameId, className: "sr-only", children: label }),
+          /* @__PURE__ */ jsx("span", { id: summaryId, className: "truncate", children: summary }),
           /* @__PURE__ */ jsxs("span", { className: "flex shrink-0 items-center gap-1", children: [
             multiple && chosen.length > 0 && // A `<span role="button">` rather than a nested `<button>`, which
             // is invalid inside the trigger and which browsers reparent — the