@krizaka/ui 2.8.0 → 2.10.0

package/dist/continue-prompt.js

@@ -0,0 +1,200 @@
+import {
+  brandClass,
+  cn,
+  storyVariantClass
+} from "./chunk-VCAAHCHL.js";
+
+// src/button/button.tsx
+import { Slot } from "radix-ui";
+import { tv } from "tailwind-variants";
+
+// src/spinner/glyph.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+var HEX = "M12 3 19.79 7.5 19.79 16.5 12 21 4.21 16.5 4.21 7.5Z";
+function LoaderGlyph({ state = "loading", value, ...props }) {
+  const known = typeof value === "number" && Number.isFinite(value);
+  const fill = state !== "loading" ? 100 : known ? Math.round(Math.min(1, Math.max(0, value)) * 100) : null;
+  return /* @__PURE__ */ jsxs("svg", { viewBox: "0 0 24 24", fill: "none", "aria-hidden": true, "data-state": state, "data-progress": fill === null ? void 0 : fill, ...props, children: [
+    /* @__PURE__ */ jsx("path", { d: HEX, stroke: "currentColor", strokeOpacity: "0.22", strokeWidth: "2.2", strokeLinejoin: "round" }),
+    /* @__PURE__ */ jsx(
+      "path",
+      {
+        d: HEX,
+        pathLength: 100,
+        stroke: "currentColor",
+        strokeWidth: "2.2",
+        strokeLinejoin: "round",
+        strokeLinecap: "round",
+        className: "kz-loader-trace",
+        strokeDasharray: fill === null ? void 0 : `${fill} ${100 - fill}`
+      }
+    ),
+    state === "loading" && /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "2.6", fill: "currentColor", className: "kz-loader-node" }),
+    state === "success" && /* @__PURE__ */ jsx("path", { d: "M8.3 12.3l2.6 2.6 4.9-5.3", pathLength: 20, stroke: "currentColor", strokeWidth: "2.2", strokeLinecap: "round", strokeLinejoin: "round", className: "kz-loader-mark" }),
+    state === "error" && /* @__PURE__ */ jsx("path", { d: "M9.4 9.4l5.2 5.2M14.6 9.4l-5.2 5.2", pathLength: 20, stroke: "currentColor", strokeWidth: "2.2", strokeLinecap: "round", className: "kz-loader-mark" })
+  ] });
+}
+
+// src/button/button.tsx
+import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+var buttonVariants = tv({
+  base: "inline-flex shrink-0 select-none items-center justify-center gap-2 whitespace-nowrap font-semibold transition-all focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-surface-0 disabled:pointer-events-none disabled:opacity-40 data-loading:cursor-progress active:scale-[0.98] [&[data-loading]]:opacity-100",
+  variants: {
+    variant: {
+      primary: "bg-accent text-on-accent shadow-sm hover:bg-accent-hover",
+      // The brand's signature: accent → accent-2 (on-accent reads on both stops, tested in @krizaka/tokens).
+      gradient: "bg-linear-to-r from-accent to-accent-2 text-on-accent shadow-sm hover:brightness-110",
+      secondary: "border border-border-default bg-surface-2 text-fg hover:border-border-strong hover:bg-surface-3",
+      outline: "border border-border-default bg-transparent text-fg hover:border-accent hover:text-fg-accent",
+      ghost: "text-fg-secondary hover:bg-surface-2 hover:text-fg",
+      // The border and the tint carry the danger; the label stays the primary text role, legible on the tint at rest
+      // and hovered over every surface (`text-fg-danger` is for text set directly on a surface).
+      danger: "border border-danger/50 bg-danger/10 text-fg hover:border-danger hover:bg-danger/20"
+    },
+    size: { sm: "h-8 px-3 text-xs", md: "h-10 px-4 text-sm", lg: "h-12 px-6 text-sm", icon: "h-10 w-10" },
+    // `cut`: the Krizaka chamfer — 45° corners (CSS corner-shape, where supported; rounded elsewhere). The border, the
+    // focus ring and the hover follow the cut, unlike a clip-path.
+    shape: { rounded: "rounded-lg", pill: "rounded-full", cut: "rounded-[10px] [corner-shape:bevel]" }
+  },
+  defaultVariants: { variant: "secondary", size: "md", shape: "rounded" }
+});
+var STATUS_TEXT = { success: "text-fg-success", error: "text-fg-danger" };
+function Button({
+  asChild,
+  loading,
+  progress,
+  status,
+  announce,
+  indicator = true,
+  shimmer,
+  magnetic,
+  variant,
+  size,
+  shape,
+  className,
+  disabled,
+  children,
+  ...props
+}) {
+  const Comp = asChild ? Slot.Root : "button";
+  const known = loading && typeof progress === "number" && Number.isFinite(progress);
+  const ratio = known ? Math.min(1, Math.max(0, progress)) : 0;
+  const glyph = indicator && !asChild && (loading || status) ? status ?? "loading" : null;
+  const filled = variant === "primary" || variant === "gradient";
+  const button = /* @__PURE__ */ jsx2(
+    Comp,
+    {
+      type: asChild ? void 0 : "button",
+      "aria-busy": loading || void 0,
+      "data-loading": loading ? "" : void 0,
+      "data-variant": variant ?? "secondary",
+      "data-kz-status": status ?? void 0,
+      "data-kz-magnetic": magnetic ? "" : void 0,
+      disabled: asChild ? void 0 : disabled || loading,
+      "aria-disabled": asChild && (disabled || loading) ? true : void 0,
+      className: buttonVariants({
+        variant,
+        size,
+        shape,
+        className: [known && "relative isolate overflow-hidden", shimmer && "kz-sheen", className].filter(Boolean).join(" ") || void 0
+      }),
+      ...props,
+      children: asChild ? children : /* @__PURE__ */ jsxs2(Fragment, { children: [
+        known && /* @__PURE__ */ jsx2("span", { "aria-hidden": true, className: "absolute inset-y-0 left-0 -z-10 bg-current opacity-15 transition-[width] duration-500", style: { width: `${ratio * 100}%` } }),
+        glyph && /* @__PURE__ */ jsx2(
+          "span",
+          {
+            "aria-hidden": true,
+            "data-slot": "indicator",
+            className: "-my-1 grid grid-cols-[1fr] transition-[grid-template-columns,margin,opacity] duration-300 starting:-mr-2 starting:grid-cols-[0fr] starting:opacity-0",
+            children: /* @__PURE__ */ jsx2("span", { className: "overflow-hidden", children: /* @__PURE__ */ jsx2(LoaderGlyph, { state: glyph, value: known ? ratio : null, className: ["h-4 w-4", glyph !== "loading" && !filled && STATUS_TEXT[glyph]].filter(Boolean).join(" ") }) })
+          }
+        ),
+        children
+      ] })
+    }
+  );
+  if (announce === void 0 || asChild) return button;
+  return /* @__PURE__ */ jsxs2(Fragment, { children: [
+    button,
+    /* @__PURE__ */ jsx2("span", { role: "status", className: "sr-only", children: announce })
+  ] });
+}
+
+// src/continue-prompt/continue-prompt.tsx
+import { Fragment as Fragment2, jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+var Arrow = () => /* @__PURE__ */ jsx3("svg", { viewBox: "0 0 24 24", width: "16", height: "16", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", strokeLinejoin: "round", children: /* @__PURE__ */ jsx3("path", { d: "M5 12h14M13 6l6 6-6 6" }) });
+function countdownCss(from, to) {
+  const steps = Math.max(1, Math.abs(from - to));
+  const frames = Array.from({ length: steps + 1 }, (_, i) => {
+    const n = from > to ? from - i : from + i;
+    return `${Math.round(i / steps * 100)}% { content: "${n}"; }`;
+  }).join(" ");
+  return `@keyframes kzs-count-${from}-${to} { ${frames} }
+@media (prefers-reduced-motion: no-preference) {
+  [data-in] .kzs-prompt-count[data-from="${from}"][data-to="${to}"] { color: transparent; }
+  [data-in] .kzs-prompt-count[data-from="${from}"][data-to="${to}"]::after { content: "${to}"; animation: kzs-count-${from}-${to} ${steps}s steps(1) 1s both; }
+}`;
+}
+function ContinuePrompt({
+  title,
+  count,
+  countdown,
+  children,
+  actionLabel,
+  onAction,
+  href,
+  actionKey,
+  actionIcon,
+  caption,
+  highlight,
+  hint,
+  status,
+  variant,
+  brand,
+  className,
+  ...props
+}) {
+  const arcade = variant === "arcade";
+  const inner = /* @__PURE__ */ jsxs3(Fragment2, { children: [
+    actionKey && /* @__PURE__ */ jsx3("span", { className: "kzs-prompt-key", "aria-hidden": true, children: actionKey }),
+    actionLabel,
+    /* @__PURE__ */ jsx3("span", { className: "kzs-prompt-icon", "aria-hidden": true, children: actionIcon ?? /* @__PURE__ */ jsx3(Arrow, {}) })
+  ] });
+  const button = { variant: arcade ? "secondary" : "primary", size: "md", shape: arcade ? "cut" : void 0, className: "kzs-prompt-action" };
+  return /* @__PURE__ */ jsxs3("div", { "data-kzs-scene": "", className: cn("kzs-prompt", storyVariantClass(variant), brandClass(brand), className), ...props, children: [
+    countdown && /* @__PURE__ */ jsx3("style", { children: countdownCss(countdown.from, countdown.to) }),
+    (caption || arcade) && /* @__PURE__ */ jsxs3("div", { className: "kzs-prompt-top", children: [
+      /* @__PURE__ */ jsx3("span", { className: "kzs-prompt-screw", "aria-hidden": true }),
+      caption && /* @__PURE__ */ jsx3("span", { children: caption }),
+      /* @__PURE__ */ jsx3("span", { className: "kzs-prompt-screw", "aria-hidden": true })
+    ] }),
+    /* @__PURE__ */ jsxs3("div", { className: cn("kzs-prompt-screen", arcade && "theme-dark", brandClass(brand)), children: [
+      /* @__PURE__ */ jsx3("span", { className: "kzs-texture", "aria-hidden": true }),
+      /* @__PURE__ */ jsx3("span", { className: "kzs-scan kzs-loop", "aria-hidden": true }),
+      /* @__PURE__ */ jsx3("span", { className: "kzs-prompt-glass", "aria-hidden": true }),
+      /* @__PURE__ */ jsxs3("div", { className: "kzs-prompt-content", children: [
+        /* @__PURE__ */ jsxs3("div", { className: "kzs-prompt-head", children: [
+          /* @__PURE__ */ jsx3("span", { className: "kzs-prompt-title", children: title }),
+          countdown ? /* @__PURE__ */ jsx3("span", { className: "kzs-prompt-count", "data-from": countdown.from, "data-to": countdown.to, "aria-hidden": true, children: countdown.from }) : count !== void 0 && /* @__PURE__ */ jsx3("span", { className: "kzs-prompt-count", "aria-hidden": true, children: count })
+        ] }),
+        children
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs3("div", { className: "kzs-prompt-deck", children: [
+      (highlight || hint || status) && /* @__PURE__ */ jsxs3("div", { className: "kzs-prompt-coin", children: [
+        highlight && /* @__PURE__ */ jsx3("span", { className: "kzs-prompt-highlight", children: highlight }),
+        hint && /* @__PURE__ */ jsx3("span", { className: "kzs-prompt-hint", children: hint }),
+        status && /* @__PURE__ */ jsxs3("span", { className: "kzs-prompt-status", children: [
+          /* @__PURE__ */ jsx3("span", { className: "kzs-prompt-led", "aria-hidden": true }),
+          status
+        ] })
+      ] }),
+      href ? /* @__PURE__ */ jsx3(Button, { asChild: true, ...button, children: /* @__PURE__ */ jsx3("a", { href, children: inner }) }) : /* @__PURE__ */ jsx3(Button, { type: "button", onClick: onAction, ...button, children: inner })
+    ] })
+  ] });
+}
+export {
+  ContinuePrompt
+};
+//# sourceMappingURL=continue-prompt.js.map

package/dist/continue-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/button/button.tsx","../src/spinner/glyph.tsx","../src/continue-prompt/continue-prompt.tsx"],"sourcesContent":["// Server-safe: no hook, no context. `buttonVariants` styles a <Link> or a Server Component without the component.\nimport { Slot } from \"radix-ui\";\nimport type * as React from \"react\";\nimport { tv, type VariantProps } from \"tailwind-variants\";\n\nimport { LoaderGlyph } from \"../spinner/glyph\";\n\nexport const buttonVariants = tv({\n  base:\n    \"inline-flex shrink-0 select-none items-center justify-center gap-2 whitespace-nowrap font-semibold transition-all \" +\n    \"focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-surface-0 \" +\n    \"disabled:pointer-events-none disabled:opacity-40 data-loading:cursor-progress active:scale-[0.98] \" +\n    // Busy is not unavailable: a loading button keeps its colour (it is disabled only so it is not pressed twice).\n    \"[&[data-loading]]:opacity-100\",\n  variants: {\n    variant: {\n      primary: \"bg-accent text-on-accent shadow-sm hover:bg-accent-hover\",\n      // The brand's signature: accent → accent-2 (on-accent reads on both stops, tested in @krizaka/tokens).\n      gradient: \"bg-linear-to-r from-accent to-accent-2 text-on-accent shadow-sm hover:brightness-110\",\n      secondary: \"border border-border-default bg-surface-2 text-fg hover:border-border-strong hover:bg-surface-3\",\n      outline: \"border border-border-default bg-transparent text-fg hover:border-accent hover:text-fg-accent\",\n      ghost: \"text-fg-secondary hover:bg-surface-2 hover:text-fg\",\n      // The border and the tint carry the danger; the label stays the primary text role, legible on the tint at rest\n      // and hovered over every surface (`text-fg-danger` is for text set directly on a surface).\n      danger: \"border border-danger/50 bg-danger/10 text-fg hover:border-danger hover:bg-danger/20\",\n    },\n    size: { sm: \"h-8 px-3 text-xs\", md: \"h-10 px-4 text-sm\", lg: \"h-12 px-6 text-sm\", icon: \"h-10 w-10\" },\n    // `cut`: the Krizaka chamfer — 45° corners (CSS corner-shape, where supported; rounded elsewhere). The border, the\n    // focus ring and the hover follow the cut, unlike a clip-path.\n    shape: { rounded: \"rounded-lg\", pill: \"rounded-full\", cut: \"rounded-[10px] [corner-shape:bevel]\" },\n  },\n  defaultVariants: { variant: \"secondary\", size: \"md\", shape: \"rounded\" },\n});\n\nexport type ButtonVariants = VariantProps<typeof buttonVariants>;\n\nexport type ButtonProps = React.ComponentProps<\"button\"> &\n  ButtonVariants & {\n    /**\n     * The look: `primary` (the accent), `gradient` (accent → accent-2), `secondary` (a raised surface), `outline`,\n     * `ghost`, `danger`.\n     * @default \"secondary\"\n     */\n    variant?: ButtonVariants[\"variant\"];\n    /**\n     * sm · md · lg, or `icon` (a square).\n     * @default \"md\"\n     */\n    size?: ButtonVariants[\"size\"];\n    /**\n     * rounded · pill · cut (45° corners, the Krizaka chamfer).\n     * @default \"rounded\"\n     */\n    shape?: ButtonVariants[\"shape\"];\n    /** Renders the child (e.g. a <Link>) instead of the <button>, with props, classes and ref merged. */\n    asChild?: boolean;\n    /**\n     * Disables and signals the wait (aria-busy, data-loading) and shows the Krizaka loader glyph before the label; the\n     * button keeps its colour.\n     */\n    loading?: boolean;\n    /**\n     * Between 0 and 1, while `loading`: the glyph's trace and a light fill across the button grow to the value (an\n     * upload, an export).\n     */\n    progress?: number | null;\n    /**\n     * How the action ended: `success` draws a check, `error` a cross (and the button shakes its head once); a ring of\n     * the status colour opens around it. Clear it to return to rest.\n     */\n    status?: \"success\" | \"error\" | null;\n    /** A message announced politely by assistive technology when it changes (“Saved”, “Upload failed”) — passed translated. */\n    announce?: string;\n    /**\n     * Shows the glyph while `loading` / with a `status`. `false`: you draw your own.\n     * @default true\n     */\n    indicator?: boolean;\n    /** A sheen of light crosses the button on hover — for the one action a page is about. */\n    shimmer?: boolean;\n    /** The button leans a few pixels toward a fine pointer (driven by `MotionObserver`; never under reduced motion or on touch). */\n    magnetic?: boolean;\n  };\n\nconst STATUS_TEXT = { success: \"text-fg-success\", error: \"text-fg-danger\" } as const;\n\nexport function Button({\n  asChild,\n  loading,\n  progress,\n  status,\n  announce,\n  indicator = true,\n  shimmer,\n  magnetic,\n  variant,\n  size,\n  shape,\n  className,\n  disabled,\n  children,\n  ...props\n}: ButtonProps) {\n  const Comp = asChild ? Slot.Root : \"button\";\n  const known = loading && typeof progress === \"number\" && Number.isFinite(progress);\n  const ratio = known ? Math.min(1, Math.max(0, progress)) : 0;\n  const glyph = indicator && !asChild && (loading || status) ? (status ?? \"loading\") : null;\n  // On a filled variant the glyph stays in the label's colour; on the others it takes the status colour.\n  const filled = variant === \"primary\" || variant === \"gradient\";\n  const button = (\n    <Comp\n      type={asChild ? undefined : \"button\"}\n      aria-busy={loading || undefined}\n      data-loading={loading ? \"\" : undefined}\n      data-variant={variant ?? \"secondary\"}\n      data-kz-status={status ?? undefined}\n      data-kz-magnetic={magnetic ? \"\" : undefined}\n      disabled={asChild ? undefined : disabled || loading}\n      aria-disabled={asChild && (disabled || loading) ? true : undefined}\n      className={buttonVariants({\n        variant,\n        size,\n        shape,\n        className: [known && \"relative isolate overflow-hidden\", shimmer && \"kz-sheen\", className].filter(Boolean).join(\" \") || undefined,\n      })}\n      {...props}\n    >\n      {asChild ? (\n        children\n      ) : (\n        <>\n          {known && (\n            <span aria-hidden className=\"absolute inset-y-0 left-0 -z-10 bg-current opacity-15 transition-[width] duration-500\" style={{ width: `${ratio * 100}%` }} />\n          )}\n          {glyph && (\n            <span\n              aria-hidden\n              data-slot=\"indicator\"\n              className=\"-my-1 grid grid-cols-[1fr] transition-[grid-template-columns,margin,opacity] duration-300 starting:-mr-2 starting:grid-cols-[0fr] starting:opacity-0\"\n            >\n              <span className=\"overflow-hidden\">\n                <LoaderGlyph state={glyph} value={known ? ratio : null} className={[\"h-4 w-4\", glyph !== \"loading\" && !filled && STATUS_TEXT[glyph]].filter(Boolean).join(\" \")} />\n              </span>\n            </span>\n          )}\n          {children}\n        </>\n      )}\n    </Comp>\n  );\n  if (announce === undefined || asChild) return button;\n  return (\n    <>\n      {button}\n      <span role=\"status\" className=\"sr-only\">\n        {announce}\n      </span>\n    </>\n  );\n}\n\nexport type IconButtonProps = Omit<ButtonProps, \"size\"> & {\n  /** The accessible name (and tooltip) of the button — required, passed translated. */\n  label: string;\n  /**\n   * sm · md · lg, or `icon` (a square).\n   * @default \"icon\"\n   */\n  size?: ButtonProps[\"size\"];\n};\n\n/** An icon-only button: `label` is required, it is its accessible name. Loading or with a status, the glyph takes the icon's place. */\nexport function IconButton({ label, size = \"icon\", children, ...props }: IconButtonProps) {\n  const swap = props.indicator !== false && !props.asChild && (props.loading || props.status);\n  return (\n    <Button aria-label={label} title={label} size={size} {...props}>\n      {swap ? null : children}\n    </Button>\n  );\n}\n","// The Krizaka loader glyph, server-safe: a hexagon (the marks' shape) traced by a segment of light around a node that\n// breathes; determinate, it fills to its value; done, the trace closes and a check (or a cross) draws itself. Animated by\n// motion.css (`kz-loader-*`); still under prefers-reduced-motion — a segment at rest and the node lit, never blank.\nimport type * as React from \"react\";\n\n/** The hexagon, pointy top, radius 9 around (12, 12). */\nconst HEX = \"M12 3 19.79 7.5 19.79 16.5 12 21 4.21 16.5 4.21 7.5Z\";\n\n/** What the glyph shows: a wait (with an optional value), or how it ended. */\nexport type LoaderGlyphState = \"loading\" | \"success\" | \"error\";\n\nexport interface LoaderGlyphProps extends Omit<React.ComponentProps<\"svg\">, \"children\"> {\n  /** loading · success · error. */\n  state?: LoaderGlyphState;\n  /** Between 0 and 1: a determinate wait, the trace grows to it. Absent: indeterminate. */\n  value?: number | null;\n}\n\n/** The glyph alone (decorative): the Spinner, the Loader and the Button's `loading` draw it. */\nexport function LoaderGlyph({ state = \"loading\", value, ...props }: LoaderGlyphProps) {\n  const known = typeof value === \"number\" && Number.isFinite(value);\n  const fill = state !== \"loading\" ? 100 : known ? Math.round(Math.min(1, Math.max(0, value)) * 100) : null;\n  return (\n    <svg viewBox=\"0 0 24 24\" fill=\"none\" aria-hidden data-state={state} data-progress={fill === null ? undefined : fill} {...props}>\n      <path d={HEX} stroke=\"currentColor\" strokeOpacity=\"0.22\" strokeWidth=\"2.2\" strokeLinejoin=\"round\" />\n      <path\n        d={HEX}\n        pathLength={100}\n        stroke=\"currentColor\"\n        strokeWidth=\"2.2\"\n        strokeLinejoin=\"round\"\n        strokeLinecap=\"round\"\n        className=\"kz-loader-trace\"\n        strokeDasharray={fill === null ? undefined : `${fill} ${100 - fill}`}\n      />\n      {state === \"loading\" && <circle cx=\"12\" cy=\"12\" r=\"2.6\" fill=\"currentColor\" className=\"kz-loader-node\" />}\n      {state === \"success\" && <path d=\"M8.3 12.3l2.6 2.6 4.9-5.3\" pathLength={20} stroke=\"currentColor\" strokeWidth=\"2.2\" strokeLinecap=\"round\" strokeLinejoin=\"round\" className=\"kz-loader-mark\" />}\n      {state === \"error\" && <path d=\"M9.4 9.4l5.2 5.2M14.6 9.4l-5.2 5.2\" pathLength={20} stroke=\"currentColor\" strokeWidth=\"2.2\" strokeLinecap=\"round\" className=\"kz-loader-mark\" />}\n    </svg>\n  );\n}\n","// Server-safe. The last call of a page or a flow (story.css): a short question, a figure that counts (days, seats,\n// seconds), what to say before leaving, and the one action that continues — “Keep your studio? · 3 days left”.\nimport type * as React from \"react\";\n\nimport { Button } from \"../button/button\";\nimport { cn } from \"../cn\";\nimport { brandClass, type StoryVariant, storyVariantClass } from \"../story-variant\";\n\nexport type ContinuePromptProps = Omit<React.HTMLAttributes<HTMLDivElement>, \"title\"> & {\n  /** The question (“Keep your studio?”, arcade “Continue?”). */\n  title: React.ReactNode;\n  /** What counts, beside the question: a figure, or a live `Countdown` for a real deadline. Decorative: say it in words too. */\n  count?: React.ReactNode;\n  /**\n   * A count that ticks down once when its scene plays (`{ from: 9, to: 7 }`), then waits; still under reduced motion.\n   * Use `count` for anything else.\n   */\n  countdown?: { readonly from: number; readonly to: number };\n  /** Inside the screen, under the question: a heading, a line, links — the closing call itself. */\n  children?: React.ReactNode;\n  /** The action's words. */\n  actionLabel: React.ReactNode;\n  /** Runs the action (a client handler). Without `href`, the action is a `button`. */\n  onAction?: React.MouseEventHandler<HTMLButtonElement>;\n  /** Makes the action a link. */\n  href?: string;\n  /** A key-cap before the action's words (“Enter”, arcade “1P Start”). Decorative. */\n  actionKey?: React.ReactNode;\n  /** The action's glyph after its words; default an arrow. Decorative. */\n  actionIcon?: React.ReactNode;\n  /** A small line at the top of the card (where it comes from). */\n  caption?: React.ReactNode;\n  /** In the deck, in the accent: the call (“Last places”, arcade “Insert coin”). */\n  highlight?: React.ReactNode;\n  /** Beside the highlight: how (“One click, no card”). */\n  hint?: React.ReactNode;\n  /** A status with a green dot (“All features on”, “Credit 01”). */\n  status?: React.ReactNode;\n  /**\n   * `default`: a calm card. `arcade`: the cabinet — screws, a dark CRT that switches on, a coin deck.\n   * @default \"default\"\n   */\n  variant?: StoryVariant;\n  /** A brand scope (`krizaka` → `.brand-krizaka`). */\n  brand?: string;\n};\n\nconst Arrow = () => (\n  <svg viewBox=\"0 0 24 24\" width=\"16\" height=\"16\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2.5\" strokeLinecap=\"round\" strokeLinejoin=\"round\">\n    <path d=\"M5 12h14M13 6l6 6-6 6\" />\n  </svg>\n);\n\n/** One countdown's keyframes, named by its range: the digit steps from `from` to `to`, once. */\nfunction countdownCss(from: number, to: number) {\n  const steps = Math.max(1, Math.abs(from - to));\n  const frames = Array.from({ length: steps + 1 }, (_, i) => {\n    const n = from > to ? from - i : from + i;\n    return `${Math.round((i / steps) * 100)}% { content: \"${n}\"; }`;\n  }).join(\" \");\n  return `@keyframes kzs-count-${from}-${to} { ${frames} }\n@media (prefers-reduced-motion: no-preference) {\n  [data-in] .kzs-prompt-count[data-from=\"${from}\"][data-to=\"${to}\"] { color: transparent; }\n  [data-in] .kzs-prompt-count[data-from=\"${from}\"][data-to=\"${to}\"]::after { content: \"${to}\"; animation: kzs-count-${from}-${to} ${steps}s steps(1) 1s both; }\n}`;\n}\n\n/** A last call: a question, what counts, the closing words, the one action that continues — a `button`, or a link. */\nexport function ContinuePrompt({\n  title,\n  count,\n  countdown,\n  children,\n  actionLabel,\n  onAction,\n  href,\n  actionKey,\n  actionIcon,\n  caption,\n  highlight,\n  hint,\n  status,\n  variant,\n  brand,\n  className,\n  ...props\n}: ContinuePromptProps) {\n  const arcade = variant === \"arcade\";\n  const inner = (\n    <>\n      {actionKey && (\n        <span className=\"kzs-prompt-key\" aria-hidden>\n          {actionKey}\n        </span>\n      )}\n      {actionLabel}\n      <span className=\"kzs-prompt-icon\" aria-hidden>\n        {actionIcon ?? <Arrow />}\n      </span>\n    </>\n  );\n  const button = { variant: arcade ? (\"secondary\" as const) : (\"primary\" as const), size: \"md\" as const, shape: arcade ? (\"cut\" as const) : undefined, className: \"kzs-prompt-action\" };\n  return (\n    <div data-kzs-scene=\"\" className={cn(\"kzs-prompt\", storyVariantClass(variant), brandClass(brand), className)} {...props}>\n      {countdown && <style>{countdownCss(countdown.from, countdown.to)}</style>}\n      {(caption || arcade) && (\n        <div className=\"kzs-prompt-top\">\n          <span className=\"kzs-prompt-screw\" aria-hidden />\n          {caption && <span>{caption}</span>}\n          <span className=\"kzs-prompt-screw\" aria-hidden />\n        </div>\n      )}\n      <div className={cn(\"kzs-prompt-screen\", arcade && \"theme-dark\", brandClass(brand))}>\n        <span className=\"kzs-texture\" aria-hidden />\n        <span className=\"kzs-scan kzs-loop\" aria-hidden />\n        <span className=\"kzs-prompt-glass\" aria-hidden />\n        <div className=\"kzs-prompt-content\">\n          <div className=\"kzs-prompt-head\">\n            <span className=\"kzs-prompt-title\">{title}</span>\n            {countdown ? (\n              <span className=\"kzs-prompt-count\" data-from={countdown.from} data-to={countdown.to} aria-hidden>\n                {countdown.from}\n              </span>\n            ) : (\n              count !== undefined && (\n                <span className=\"kzs-prompt-count\" aria-hidden>\n                  {count}\n                </span>\n              )\n            )}\n          </div>\n          {children}\n        </div>\n      </div>\n      <div className=\"kzs-prompt-deck\">\n        {(highlight || hint || status) && (\n          <div className=\"kzs-prompt-coin\">\n            {highlight && <span className=\"kzs-prompt-highlight\">{highlight}</span>}\n            {hint && <span className=\"kzs-prompt-hint\">{hint}</span>}\n            {status && (\n              <span className=\"kzs-prompt-status\">\n                <span className=\"kzs-prompt-led\" aria-hidden />\n                {status}\n              </span>\n            )}\n          </div>\n        )}\n        {href ? (\n          <Button asChild {...button}>\n            <a href={href}>{inner}</a>\n          </Button>\n        ) : (\n          <Button type=\"button\" onClick={onAction} {...button}>\n            {inner}\n          </Button>\n        )}\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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","names":["jsx","jsxs","Fragment","jsx","jsxs"]}

package/dist/dashboard-layout.d.ts

@@ -0,0 +1,139 @@
+import * as tailwind_variants from 'tailwind-variants';
+import * as React from 'react';
+
+declare const dashboardLayout: tailwind_variants.TVReturnType<{
+    span: {
+        1: {
+            widget: string;
+        };
+        2: {
+            widget: string;
+        };
+        3: {
+            widget: string;
+        };
+        full: {
+            widget: string;
+        };
+    };
+}, {
+    root: string;
+    head: string;
+    text: string;
+    eyebrow: string;
+    title: string;
+    description: string;
+    actions: string;
+    toolbar: string;
+    grid: string;
+    widget: string;
+    widgetHead: string;
+    widgetTitle: string;
+    widgetDescription: string;
+    widgetBody: string;
+}, undefined, {
+    span: {
+        1: {
+            widget: string;
+        };
+        2: {
+            widget: string;
+        };
+        3: {
+            widget: string;
+        };
+        full: {
+            widget: string;
+        };
+    };
+}, {
+    root: string;
+    head: string;
+    text: string;
+    eyebrow: string;
+    title: string;
+    description: string;
+    actions: string;
+    toolbar: string;
+    grid: string;
+    widget: string;
+    widgetHead: string;
+    widgetTitle: string;
+    widgetDescription: string;
+    widgetBody: string;
+}, tailwind_variants.TVReturnTypeLike<{
+    span: {
+        1: {
+            widget: string;
+        };
+        2: {
+            widget: string;
+        };
+        3: {
+            widget: string;
+        };
+        full: {
+            widget: string;
+        };
+    };
+}, {
+    root: string;
+    head: string;
+    text: string;
+    eyebrow: string;
+    title: string;
+    description: string;
+    actions: string;
+    toolbar: string;
+    grid: string;
+    widget: string;
+    widgetHead: string;
+    widgetTitle: string;
+    widgetDescription: string;
+    widgetBody: string;
+}>>;
+type DashboardLayoutProps = Omit<React.ComponentProps<"div">, "title"> & {
+    /** The screen's title: `Good morning, Eric`. */
+    title: React.ReactNode;
+    /** A mono line above it (the workspace, the date). */
+    eyebrow?: React.ReactNode;
+    /** One sentence under it. */
+    description?: React.ReactNode;
+    /** The screen's actions (a primary Button, a DropdownMenu). */
+    actions?: React.ReactNode;
+    /** Under the heading: the period, the filters (Segmented tabs, a DateRangePicker, a FilterBar). */
+    toolbar?: React.ReactNode;
+    /**
+     * The heading's level: `h1` when the dashboard is the screen, `h2` inside an AppShell whose header holds the h1.
+     * @default "h1"
+     */
+    headingAs?: "h1" | "h2";
+    /** The widgets (`Widget`), in reading order. */
+    children: React.ReactNode;
+};
+/** A dashboard screen: heading, actions, filters, then the grid of widgets. */
+declare function DashboardLayout({ title, eyebrow, description, actions, toolbar, headingAs: H, className, children, ...props }: DashboardLayoutProps): React.JSX.Element;
+type WidgetProps = Omit<React.ComponentProps<"section">, "title"> & {
+    /** The widget's title: it names the region. */
+    title: React.ReactNode;
+    /** One line under the title (the period, the source). */
+    description?: React.ReactNode;
+    /** An action on the right of the title (`See all`). */
+    action?: React.ReactNode;
+    /**
+     * The columns it takes: 1, 2, 3 or the full row (from `sm`; one column on a phone).
+     * @default 1
+     */
+    span?: 1 | 2 | 3 | "full";
+    /**
+     * The title's level: one under the dashboard's heading — `2` under an `h1`, `3` inside an AppShell (`headingAs="h2"`).
+     * @default 2
+     */
+    level?: 2 | 3;
+    /** The content: a Stat, a chart of @krizaka/charts, a DataTable, a list. */
+    children: React.ReactNode;
+};
+/** A widget of the dashboard: a titled region on a card. */
+declare function Widget({ title, description, action, span, level, className, children, id, ...props }: WidgetProps): React.JSX.Element;
+
+export { DashboardLayout, type DashboardLayoutProps, Widget, type WidgetProps, dashboardLayout };

package/dist/dashboard-layout.js

@@ -0,0 +1,68 @@
+// src/dashboard-layout/dashboard-layout.tsx
+import * as React from "react";
+import { tv } from "tailwind-variants";
+import { jsx, jsxs } from "react/jsx-runtime";
+var dashboardLayout = tv({
+  slots: {
+    root: "flex w-full flex-col gap-6",
+    head: "flex flex-col gap-4 sm:flex-row sm:items-end sm:justify-between",
+    text: "flex min-w-0 flex-col gap-1",
+    eyebrow: "font-mono text-[11px] font-semibold uppercase tracking-[0.16em] text-fg-accent",
+    title: "font-display text-2xl font-extrabold tracking-tight text-fg sm:text-[1.75rem]",
+    description: "max-w-2xl text-sm text-fg-secondary",
+    actions: "flex shrink-0 flex-wrap items-center gap-2",
+    toolbar: "flex flex-wrap items-center gap-2",
+    grid: "grid grid-cols-1 gap-4 sm:grid-cols-2 xl:grid-cols-4",
+    widget: "flex min-w-0 flex-col gap-3 rounded-xl border border-border-default bg-surface-1 p-4 sm:p-5",
+    widgetHead: "flex items-start justify-between gap-3",
+    widgetTitle: "text-sm font-semibold text-fg",
+    widgetDescription: "mt-0.5 text-xs text-fg-secondary",
+    widgetBody: "min-w-0 flex-1"
+  },
+  variants: {
+    span: {
+      1: { widget: "" },
+      2: { widget: "sm:col-span-2" },
+      3: { widget: "sm:col-span-2 xl:col-span-3" },
+      full: { widget: "sm:col-span-2 xl:col-span-4" }
+    }
+  },
+  defaultVariants: { span: 1 }
+});
+var s = dashboardLayout();
+function DashboardLayout({ title, eyebrow, description, actions, toolbar, headingAs: H = "h1", className, children, ...props }) {
+  return /* @__PURE__ */ jsxs("div", { className: s.root({ className }), ...props, children: [
+    /* @__PURE__ */ jsxs("div", { className: s.head(), children: [
+      /* @__PURE__ */ jsxs("div", { className: s.text(), children: [
+        eyebrow && /* @__PURE__ */ jsx("p", { className: s.eyebrow(), children: eyebrow }),
+        /* @__PURE__ */ jsx(H, { className: s.title(), children: title }),
+        description && /* @__PURE__ */ jsx("p", { className: s.description(), children: description })
+      ] }),
+      actions && /* @__PURE__ */ jsx("div", { className: s.actions(), children: actions })
+    ] }),
+    toolbar && /* @__PURE__ */ jsx("div", { className: s.toolbar(), children: toolbar }),
+    /* @__PURE__ */ jsx("div", { className: s.grid(), children })
+  ] });
+}
+function Widget({ title, description, action, span = 1, level = 2, className, children, id, ...props }) {
+  const H = level === 2 ? "h2" : "h3";
+  const sv = dashboardLayout({ span });
+  const auto = React.useId();
+  const titleId = `${id ?? auto}-title`;
+  return /* @__PURE__ */ jsxs("section", { className: sv.widget({ className }), "aria-labelledby": titleId, id, ...props, children: [
+    /* @__PURE__ */ jsxs("div", { className: s.widgetHead(), children: [
+      /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
+        /* @__PURE__ */ jsx(H, { id: titleId, className: s.widgetTitle(), children: title }),
+        description && /* @__PURE__ */ jsx("p", { className: s.widgetDescription(), children: description })
+      ] }),
+      action
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: s.widgetBody(), children })
+  ] });
+}
+export {
+  DashboardLayout,
+  Widget,
+  dashboardLayout
+};
+//# sourceMappingURL=dashboard-layout.js.map

package/dist/dashboard-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dashboard-layout/dashboard-layout.tsx"],"sourcesContent":["// Server-safe. A dashboard, read from the products' home screens (Orochia's creator studio, Orazaka's console for\n// Eric): the screen's heading with its actions and filters, then a responsive grid of widgets — one column on a phone,\n// two from `sm`, four from `xl`; a widget spans 1, 2, 3 columns or the full row, and keeps its order everywhere.\nimport * as React from \"react\";\nimport { tv } from \"tailwind-variants\";\n\nexport const dashboardLayout = tv({\n  slots: {\n    root: \"flex w-full flex-col gap-6\",\n    head: \"flex flex-col gap-4 sm:flex-row sm:items-end sm:justify-between\",\n    text: \"flex min-w-0 flex-col gap-1\",\n    eyebrow: \"font-mono text-[11px] font-semibold uppercase tracking-[0.16em] text-fg-accent\",\n    title: \"font-display text-2xl font-extrabold tracking-tight text-fg sm:text-[1.75rem]\",\n    description: \"max-w-2xl text-sm text-fg-secondary\",\n    actions: \"flex shrink-0 flex-wrap items-center gap-2\",\n    toolbar: \"flex flex-wrap items-center gap-2\",\n    grid: \"grid grid-cols-1 gap-4 sm:grid-cols-2 xl:grid-cols-4\",\n    widget: \"flex min-w-0 flex-col gap-3 rounded-xl border border-border-default bg-surface-1 p-4 sm:p-5\",\n    widgetHead: \"flex items-start justify-between gap-3\",\n    widgetTitle: \"text-sm font-semibold text-fg\",\n    widgetDescription: \"mt-0.5 text-xs text-fg-secondary\",\n    widgetBody: \"min-w-0 flex-1\",\n  },\n  variants: {\n    span: {\n      1: { widget: \"\" },\n      2: { widget: \"sm:col-span-2\" },\n      3: { widget: \"sm:col-span-2 xl:col-span-3\" },\n      full: { widget: \"sm:col-span-2 xl:col-span-4\" },\n    },\n  },\n  defaultVariants: { span: 1 },\n});\nconst s = dashboardLayout();\n\nexport type DashboardLayoutProps = Omit<React.ComponentProps<\"div\">, \"title\"> & {\n  /** The screen's title: `Good morning, Eric`. */\n  title: React.ReactNode;\n  /** A mono line above it (the workspace, the date). */\n  eyebrow?: React.ReactNode;\n  /** One sentence under it. */\n  description?: React.ReactNode;\n  /** The screen's actions (a primary Button, a DropdownMenu). */\n  actions?: React.ReactNode;\n  /** Under the heading: the period, the filters (Segmented tabs, a DateRangePicker, a FilterBar). */\n  toolbar?: React.ReactNode;\n  /**\n   * The heading's level: `h1` when the dashboard is the screen, `h2` inside an AppShell whose header holds the h1.\n   * @default \"h1\"\n   */\n  headingAs?: \"h1\" | \"h2\";\n  /** The widgets (`Widget`), in reading order. */\n  children: React.ReactNode;\n};\n\n/** A dashboard screen: heading, actions, filters, then the grid of widgets. */\nexport function DashboardLayout({ title, eyebrow, description, actions, toolbar, headingAs: H = \"h1\", className, children, ...props }: DashboardLayoutProps) {\n  return (\n    <div className={s.root({ className })} {...props}>\n      <div className={s.head()}>\n        <div className={s.text()}>\n          {eyebrow && <p className={s.eyebrow()}>{eyebrow}</p>}\n          <H className={s.title()}>{title}</H>\n          {description && <p className={s.description()}>{description}</p>}\n        </div>\n        {actions && <div className={s.actions()}>{actions}</div>}\n      </div>\n      {toolbar && <div className={s.toolbar()}>{toolbar}</div>}\n      <div className={s.grid()}>{children}</div>\n    </div>\n  );\n}\n\nexport type WidgetProps = Omit<React.ComponentProps<\"section\">, \"title\"> & {\n  /** The widget's title: it names the region. */\n  title: React.ReactNode;\n  /** One line under the title (the period, the source). */\n  description?: React.ReactNode;\n  /** An action on the right of the title (`See all`). */\n  action?: React.ReactNode;\n  /**\n   * The columns it takes: 1, 2, 3 or the full row (from `sm`; one column on a phone).\n   * @default 1\n   */\n  span?: 1 | 2 | 3 | \"full\";\n  /**\n   * The title's level: one under the dashboard's heading — `2` under an `h1`, `3` inside an AppShell (`headingAs=\"h2\"`).\n   * @default 2\n   */\n  level?: 2 | 3;\n  /** The content: a Stat, a chart of @krizaka/charts, a DataTable, a list. */\n  children: React.ReactNode;\n};\n\n/** A widget of the dashboard: a titled region on a card. */\nexport function Widget({ title, description, action, span = 1, level = 2, className, children, id, ...props }: WidgetProps) {\n  const H = level === 2 ? \"h2\" : \"h3\";\n  const sv = dashboardLayout({ span });\n  const auto = React.useId();\n  const titleId = `${id ?? auto}-title`;\n  return (\n    <section className={sv.widget({ className })} aria-labelledby={titleId} id={id} {...props}>\n      <div className={s.widgetHead()}>\n        <div className=\"min-w-0\">\n          <H id={titleId} className={s.widgetTitle()}>\n            {title}\n          </H>\n          {description && <p className={s.widgetDescription()}>{description}</p>}\n        </div>\n        {action}\n      </div>\n      <div className={s.widgetBody()}>{children}</div>\n    </section>\n  );\n}\n"],"mappings":";AAGA,YAAY,WAAW;AACvB,SAAS,UAAU;AAwDX,SACc,KADd;AAtDD,IAAM,kBAAkB,GAAG;AAAA,EAChC,OAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,SAAS;AAAA,IACT,OAAO;AAAA,IACP,aAAa;AAAA,IACb,SAAS;AAAA,IACT,SAAS;AAAA,IACT,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,mBAAmB;AAAA,IACnB,YAAY;AAAA,EACd;AAAA,EACA,UAAU;AAAA,IACR,MAAM;AAAA,MACJ,GAAG,EAAE,QAAQ,GAAG;AAAA,MAChB,GAAG,EAAE,QAAQ,gBAAgB;AAAA,MAC7B,GAAG,EAAE,QAAQ,8BAA8B;AAAA,MAC3C,MAAM,EAAE,QAAQ,8BAA8B;AAAA,IAChD;AAAA,EACF;AAAA,EACA,iBAAiB,EAAE,MAAM,EAAE;AAC7B,CAAC;AACD,IAAM,IAAI,gBAAgB;AAuBnB,SAAS,gBAAgB,EAAE,OAAO,SAAS,aAAa,SAAS,SAAS,WAAW,IAAI,MAAM,WAAW,UAAU,GAAG,MAAM,GAAyB;AAC3J,SACE,qBAAC,SAAI,WAAW,EAAE,KAAK,EAAE,UAAU,CAAC,GAAI,GAAG,OACzC;AAAA,yBAAC,SAAI,WAAW,EAAE,KAAK,GACrB;AAAA,2BAAC,SAAI,WAAW,EAAE,KAAK,GACpB;AAAA,mBAAW,oBAAC,OAAE,WAAW,EAAE,QAAQ,GAAI,mBAAQ;AAAA,QAChD,oBAAC,KAAE,WAAW,EAAE,MAAM,GAAI,iBAAM;AAAA,QAC/B,eAAe,oBAAC,OAAE,WAAW,EAAE,YAAY,GAAI,uBAAY;AAAA,SAC9D;AAAA,MACC,WAAW,oBAAC,SAAI,WAAW,EAAE,QAAQ,GAAI,mBAAQ;AAAA,OACpD;AAAA,IACC,WAAW,oBAAC,SAAI,WAAW,EAAE,QAAQ,GAAI,mBAAQ;AAAA,IAClD,oBAAC,SAAI,WAAW,EAAE,KAAK,GAAI,UAAS;AAAA,KACtC;AAEJ;AAwBO,SAAS,OAAO,EAAE,OAAO,aAAa,QAAQ,OAAO,GAAG,QAAQ,GAAG,WAAW,UAAU,IAAI,GAAG,MAAM,GAAgB;AAC1H,QAAM,IAAI,UAAU,IAAI,OAAO;AAC/B,QAAM,KAAK,gBAAgB,EAAE,KAAK,CAAC;AACnC,QAAM,OAAa,YAAM;AACzB,QAAM,UAAU,GAAG,MAAM,IAAI;AAC7B,SACE,qBAAC,aAAQ,WAAW,GAAG,OAAO,EAAE,UAAU,CAAC,GAAG,mBAAiB,SAAS,IAAS,GAAG,OAClF;AAAA,yBAAC,SAAI,WAAW,EAAE,WAAW,GAC3B;AAAA,2BAAC,SAAI,WAAU,WACb;AAAA,4BAAC,KAAE,IAAI,SAAS,WAAW,EAAE,YAAY,GACtC,iBACH;AAAA,QACC,eAAe,oBAAC,OAAE,WAAW,EAAE,kBAAkB,GAAI,uBAAY;AAAA,SACpE;AAAA,MACC;AAAA,OACH;AAAA,IACA,oBAAC,SAAI,WAAW,EAAE,WAAW,GAAI,UAAS;AAAA,KAC5C;AAEJ;","names":[]}

package/dist/detail-layout.d.ts

@@ -0,0 +1,126 @@
+import * as tailwind_variants from 'tailwind-variants';
+import * as React from 'react';
+
+declare const detailLayout: tailwind_variants.TVReturnType<{
+    [key: string]: {
+        [key: string]: tailwind_variants.ClassValue | {
+            root?: tailwind_variants.ClassValue;
+            back?: tailwind_variants.ClassValue;
+            header?: tailwind_variants.ClassValue;
+            media?: tailwind_variants.ClassValue;
+            text?: tailwind_variants.ClassValue;
+            eyebrow?: tailwind_variants.ClassValue;
+            titleRow?: tailwind_variants.ClassValue;
+            title?: tailwind_variants.ClassValue;
+            meta?: tailwind_variants.ClassValue;
+            actions?: tailwind_variants.ClassValue;
+            columns?: tailwind_variants.ClassValue;
+            main?: tailwind_variants.ClassValue;
+            aside?: tailwind_variants.ClassValue;
+        };
+    };
+} | {
+    [x: string]: {
+        [x: string]: tailwind_variants.ClassValue | {
+            root?: tailwind_variants.ClassValue;
+            back?: tailwind_variants.ClassValue;
+            header?: tailwind_variants.ClassValue;
+            media?: tailwind_variants.ClassValue;
+            text?: tailwind_variants.ClassValue;
+            eyebrow?: tailwind_variants.ClassValue;
+            titleRow?: tailwind_variants.ClassValue;
+            title?: tailwind_variants.ClassValue;
+            meta?: tailwind_variants.ClassValue;
+            actions?: tailwind_variants.ClassValue;
+            columns?: tailwind_variants.ClassValue;
+            main?: tailwind_variants.ClassValue;
+            aside?: tailwind_variants.ClassValue;
+        };
+    };
+} | {}, {
+    root: string;
+    back: string;
+    header: string;
+    media: string;
+    text: string;
+    eyebrow: string;
+    titleRow: string;
+    title: string;
+    meta: string;
+    actions: string;
+    columns: string;
+    main: string;
+    aside: string;
+}, undefined, {
+    [key: string]: {
+        [key: string]: tailwind_variants.ClassValue | {
+            root?: tailwind_variants.ClassValue;
+            back?: tailwind_variants.ClassValue;
+            header?: tailwind_variants.ClassValue;
+            media?: tailwind_variants.ClassValue;
+            text?: tailwind_variants.ClassValue;
+            eyebrow?: tailwind_variants.ClassValue;
+            titleRow?: tailwind_variants.ClassValue;
+            title?: tailwind_variants.ClassValue;
+            meta?: tailwind_variants.ClassValue;
+            actions?: tailwind_variants.ClassValue;
+            columns?: tailwind_variants.ClassValue;
+            main?: tailwind_variants.ClassValue;
+            aside?: tailwind_variants.ClassValue;
+        };
+    };
+} | {}, {
+    root: string;
+    back: string;
+    header: string;
+    media: string;
+    text: string;
+    eyebrow: string;
+    titleRow: string;
+    title: string;
+    meta: string;
+    actions: string;
+    columns: string;
+    main: string;
+    aside: string;
+}, tailwind_variants.TVReturnTypeLike<unknown, {
+    root: string;
+    back: string;
+    header: string;
+    media: string;
+    text: string;
+    eyebrow: string;
+    titleRow: string;
+    title: string;
+    meta: string;
+    actions: string;
+    columns: string;
+    main: string;
+    aside: string;
+}>>;
+type DetailLayoutProps = Omit<React.ComponentProps<"div">, "title"> & {
+    /** The way back to the list: your router's link (`<Link href="/videos">Videos</Link>`), drawn with its arrow. */
+    back?: React.ReactNode;
+    /** A thumbnail, a cover or an avatar beside the name. */
+    media?: React.ReactNode;
+    /** A mono line above the name (the object's kind, its id). */
+    eyebrow?: React.ReactNode;
+    /** The object's name: the `h1`. */
+    title: React.ReactNode;
+    /** Beside the name: its status (a Badge). */
+    status?: React.ReactNode;
+    /** Under the name: its facts (the author, a date, a count — `Facts` or plain text). */
+    meta?: React.ReactNode;
+    /** The object's actions (edit, publish, a DropdownMenu). */
+    actions?: React.ReactNode;
+    /** Under the header: the object's tabs (`Tabs.List` of @krizaka/ui/tabs, inside your `Tabs.Root` around the layout). */
+    tabs?: React.ReactNode;
+    /** The side panel: details, related objects, activity (under the content on a phone). */
+    aside?: React.ReactNode;
+    /** The content (the current tab). */
+    children: React.ReactNode;
+};
+/** One object's page: header (back, media, name, status, facts, actions), tabs, content and a side panel. */
+declare function DetailLayout({ back, media, eyebrow, title, status, meta, actions, tabs, aside, className, children, ...props }: DetailLayoutProps): React.JSX.Element;
+
+export { DetailLayout, type DetailLayoutProps, detailLayout };

package/dist/detail-layout.js

@@ -0,0 +1,48 @@
+// src/detail-layout/detail-layout.tsx
+import { tv } from "tailwind-variants";
+import { jsx, jsxs } from "react/jsx-runtime";
+var detailLayout = tv({
+  slots: {
+    root: "flex w-full flex-col gap-6",
+    back: "inline-flex w-fit items-center gap-1.5 rounded-md text-sm font-medium text-fg-secondary no-underline hover:text-fg focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring",
+    header: "flex flex-col gap-4 border-b border-border-subtle pb-5 sm:flex-row sm:items-start",
+    media: "shrink-0 overflow-hidden rounded-xl [&>img]:block [&>img]:h-full [&>img]:w-full [&>img]:object-cover",
+    text: "flex min-w-0 flex-1 flex-col gap-2",
+    eyebrow: "font-mono text-[11px] font-semibold uppercase tracking-[0.16em] text-fg-accent",
+    titleRow: "flex flex-wrap items-center gap-2",
+    title: "min-w-0 font-display text-2xl font-extrabold tracking-tight text-fg break-words",
+    meta: "flex flex-wrap items-center gap-x-3 gap-y-1 text-sm text-fg-secondary",
+    actions: "flex shrink-0 flex-wrap items-center gap-2",
+    columns: "grid grid-cols-1 gap-6 lg:grid-cols-[minmax(0,1fr)_20rem] lg:gap-8",
+    main: "flex min-w-0 flex-col gap-5",
+    aside: "flex min-w-0 flex-col gap-4 lg:sticky lg:top-20 lg:self-start"
+  }
+});
+var s = detailLayout();
+function DetailLayout({ back, media, eyebrow, title, status, meta, actions, tabs, aside, className, children, ...props }) {
+  return /* @__PURE__ */ jsxs("div", { className: s.root({ className }), ...props, children: [
+    back && /* @__PURE__ */ jsx("div", { className: s.back(), children: back }),
+    /* @__PURE__ */ jsxs("div", { className: s.header(), children: [
+      media && /* @__PURE__ */ jsx("div", { className: s.media(), children: media }),
+      /* @__PURE__ */ jsxs("div", { className: s.text(), children: [
+        eyebrow && /* @__PURE__ */ jsx("p", { className: s.eyebrow(), children: eyebrow }),
+        /* @__PURE__ */ jsxs("div", { className: s.titleRow(), children: [
+          /* @__PURE__ */ jsx("h1", { className: s.title(), children: title }),
+          status
+        ] }),
+        meta && /* @__PURE__ */ jsx("div", { className: s.meta(), children: meta })
+      ] }),
+      actions && /* @__PURE__ */ jsx("div", { className: s.actions(), children: actions })
+    ] }),
+    tabs,
+    /* @__PURE__ */ jsxs("div", { className: aside ? s.columns() : void 0, children: [
+      /* @__PURE__ */ jsx("div", { className: s.main(), children }),
+      aside && /* @__PURE__ */ jsx("aside", { className: s.aside(), children: aside })
+    ] })
+  ] });
+}
+export {
+  DetailLayout,
+  detailLayout
+};
+//# sourceMappingURL=detail-layout.js.map