@epicbagel/saas-kit 0.0.0-stage → 1.1.0

package/dist/primitives/marker.d.ts

@@ -0,0 +1,15 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const markerVariants: (props?: ({
+    variant?: "separator" | "border" | "default" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare function Marker({ className, variant, asChild, ...props }: React.ComponentProps<"div"> & VariantProps<typeof markerVariants> & {
+    asChild?: boolean;
+}): react_jsx_runtime.JSX.Element;
+declare function MarkerIcon({ className, ...props }: React.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
+declare function MarkerContent({ className, ...props }: React.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
+
+export { Marker, MarkerContent, MarkerIcon, markerVariants };

package/dist/primitives/marker.js

@@ -0,0 +1,14 @@
+"use client";
+import {
+  Marker,
+  MarkerContent,
+  MarkerIcon,
+  markerVariants
+} from "../chunk-IW4ZIXXG.js";
+import "../chunk-G6SRSWXB.js";
+export {
+  Marker,
+  MarkerContent,
+  MarkerIcon,
+  markerVariants
+};

package/dist/primitives/message-scroller.cjs

@@ -0,0 +1,26 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+"use client";
+
+
+
+
+
+
+
+
+
+
+var _chunkXABXUP6Lcjs = require('../chunk-XABXUP6L.cjs');
+require('../chunk-L4DH72UF.cjs');
+require('../chunk-KWLSBTB2.cjs');
+
+
+
+
+
+
+
+
+
+
+exports.MessageScroller = _chunkXABXUP6Lcjs.MessageScroller; exports.MessageScrollerButton = _chunkXABXUP6Lcjs.MessageScrollerButton; exports.MessageScrollerContent = _chunkXABXUP6Lcjs.MessageScrollerContent; exports.MessageScrollerItem = _chunkXABXUP6Lcjs.MessageScrollerItem; exports.MessageScrollerProvider = _chunkXABXUP6Lcjs.MessageScrollerProvider; exports.MessageScrollerViewport = _chunkXABXUP6Lcjs.MessageScrollerViewport; exports.useMessageScroller = _chunkXABXUP6Lcjs.useMessageScroller; exports.useMessageScrollerScrollable = _chunkXABXUP6Lcjs.useMessageScrollerScrollable; exports.useMessageScrollerVisibility = _chunkXABXUP6Lcjs.useMessageScrollerVisibility;

package/dist/primitives/message-scroller.d.cts

@@ -0,0 +1,16 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import { MessageScroller as MessageScroller$1 } from '@shadcn/react/message-scroller';
+export { useMessageScroller, useMessageScrollerScrollable, useMessageScrollerVisibility } from '@shadcn/react/message-scroller';
+import { Button } from './button.cjs';
+import 'class-variance-authority/types';
+import 'class-variance-authority';
+
+declare function MessageScrollerProvider(props: React.ComponentProps<typeof MessageScroller$1.Provider>): react_jsx_runtime.JSX.Element;
+declare function MessageScroller({ className, ...props }: React.ComponentProps<typeof MessageScroller$1.Root>): react_jsx_runtime.JSX.Element;
+declare function MessageScrollerViewport({ className, ...props }: React.ComponentProps<typeof MessageScroller$1.Viewport>): react_jsx_runtime.JSX.Element;
+declare function MessageScrollerContent({ className, ...props }: React.ComponentProps<typeof MessageScroller$1.Content>): react_jsx_runtime.JSX.Element;
+declare function MessageScrollerItem({ className, scrollAnchor, ...props }: React.ComponentProps<typeof MessageScroller$1.Item>): react_jsx_runtime.JSX.Element;
+declare function MessageScrollerButton({ direction, className, children, render, variant, size, ...props }: React.ComponentProps<typeof MessageScroller$1.Button> & Pick<React.ComponentProps<typeof Button>, "variant" | "size">): react_jsx_runtime.JSX.Element;
+
+export { MessageScroller, MessageScrollerButton, MessageScrollerContent, MessageScrollerItem, MessageScrollerProvider, MessageScrollerViewport };

package/dist/primitives/message-scroller.d.ts

@@ -0,0 +1,16 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import { MessageScroller as MessageScroller$1 } from '@shadcn/react/message-scroller';
+export { useMessageScroller, useMessageScrollerScrollable, useMessageScrollerVisibility } from '@shadcn/react/message-scroller';
+import { Button } from './button.js';
+import 'class-variance-authority/types';
+import 'class-variance-authority';
+
+declare function MessageScrollerProvider(props: React.ComponentProps<typeof MessageScroller$1.Provider>): react_jsx_runtime.JSX.Element;
+declare function MessageScroller({ className, ...props }: React.ComponentProps<typeof MessageScroller$1.Root>): react_jsx_runtime.JSX.Element;
+declare function MessageScrollerViewport({ className, ...props }: React.ComponentProps<typeof MessageScroller$1.Viewport>): react_jsx_runtime.JSX.Element;
+declare function MessageScrollerContent({ className, ...props }: React.ComponentProps<typeof MessageScroller$1.Content>): react_jsx_runtime.JSX.Element;
+declare function MessageScrollerItem({ className, scrollAnchor, ...props }: React.ComponentProps<typeof MessageScroller$1.Item>): react_jsx_runtime.JSX.Element;
+declare function MessageScrollerButton({ direction, className, children, render, variant, size, ...props }: React.ComponentProps<typeof MessageScroller$1.Button> & Pick<React.ComponentProps<typeof Button>, "variant" | "size">): react_jsx_runtime.JSX.Element;
+
+export { MessageScroller, MessageScrollerButton, MessageScrollerContent, MessageScrollerItem, MessageScrollerProvider, MessageScrollerViewport };

package/dist/primitives/message-scroller.js

@@ -0,0 +1,26 @@
+"use client";
+"use client";
+import {
+  MessageScroller,
+  MessageScrollerButton,
+  MessageScrollerContent,
+  MessageScrollerItem,
+  MessageScrollerProvider,
+  MessageScrollerViewport,
+  useMessageScroller,
+  useMessageScrollerScrollable,
+  useMessageScrollerVisibility
+} from "../chunk-GFG2R5BZ.js";
+import "../chunk-HQRWRRZJ.js";
+import "../chunk-G6SRSWXB.js";
+export {
+  MessageScroller,
+  MessageScrollerButton,
+  MessageScrollerContent,
+  MessageScrollerItem,
+  MessageScrollerProvider,
+  MessageScrollerViewport,
+  useMessageScroller,
+  useMessageScrollerScrollable,
+  useMessageScrollerVisibility
+};

package/dist/primitives/message.cjs

@@ -0,0 +1,18 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+
+
+
+
+
+
+
+var _chunk2AU7ZRGXcjs = require('../chunk-2AU7ZRGX.cjs');
+require('../chunk-KWLSBTB2.cjs');
+
+
+
+
+
+
+
+exports.Message = _chunk2AU7ZRGXcjs.Message; exports.MessageAvatar = _chunk2AU7ZRGXcjs.MessageAvatar; exports.MessageContent = _chunk2AU7ZRGXcjs.MessageContent; exports.MessageFooter = _chunk2AU7ZRGXcjs.MessageFooter; exports.MessageGroup = _chunk2AU7ZRGXcjs.MessageGroup; exports.MessageHeader = _chunk2AU7ZRGXcjs.MessageHeader;

package/dist/primitives/message.d.cts

@@ -0,0 +1,13 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+
+declare function MessageGroup({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function Message({ className, align, ...props }: React.ComponentProps<"div"> & {
+    align?: "start" | "end";
+}): react_jsx_runtime.JSX.Element;
+declare function MessageAvatar({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function MessageContent({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function MessageHeader({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function MessageFooter({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+
+export { Message, MessageAvatar, MessageContent, MessageFooter, MessageGroup, MessageHeader };

package/dist/primitives/message.d.ts

@@ -0,0 +1,13 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+
+declare function MessageGroup({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function Message({ className, align, ...props }: React.ComponentProps<"div"> & {
+    align?: "start" | "end";
+}): react_jsx_runtime.JSX.Element;
+declare function MessageAvatar({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function MessageContent({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function MessageHeader({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function MessageFooter({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+
+export { Message, MessageAvatar, MessageContent, MessageFooter, MessageGroup, MessageHeader };

package/dist/primitives/message.js

@@ -0,0 +1,18 @@
+"use client";
+import {
+  Message,
+  MessageAvatar,
+  MessageContent,
+  MessageFooter,
+  MessageGroup,
+  MessageHeader
+} from "../chunk-JZOBIPFC.js";
+import "../chunk-G6SRSWXB.js";
+export {
+  Message,
+  MessageAvatar,
+  MessageContent,
+  MessageFooter,
+  MessageGroup,
+  MessageHeader
+};

package/dist/primitives/native-select.cjs

@@ -0,0 +1,33 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+
+
+var _chunkKWLSBTB2cjs = require('../chunk-KWLSBTB2.cjs');
+
+// src/primitives/native-select.tsx
+var _react = require('react');
+var _lucidereact = require('lucide-react');
+var _jsxruntime = require('react/jsx-runtime');
+var NativeSelect = _react.forwardRef.call(void 0, 
+  function NativeSelect2({ className, children, options, ...props }, ref) {
+    return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "span", { className: "relative block", children: [
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+        "select",
+        {
+          ref,
+          className: _chunkKWLSBTB2cjs.cn.call(void 0, 
+            "flex h-10 w-full appearance-none rounded-md border border-input bg-background px-3 py-2 pr-9 text-[16px] md:text-sm",
+            "ring-offset-background focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2",
+            "disabled:cursor-not-allowed disabled:opacity-50",
+            className
+          ),
+          ...props,
+          children: options ? options.map((option) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "option", { value: option.value, disabled: option.disabled, children: option.label }, option.value)) : children
+        }
+      ),
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.ChevronDown, { "aria-hidden": true, className: "pointer-events-none absolute right-3 top-1/2 size-4 -translate-y-1/2 text-muted-foreground" })
+    ] });
+  }
+);
+
+
+exports.NativeSelect = NativeSelect;

package/dist/primitives/native-select.d.cts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import { SelectHTMLAttributes } from 'react';
+
+interface NativeSelectOption {
+    value: string | number;
+    label: string;
+    disabled?: boolean;
+}
+interface NativeSelectProps extends SelectHTMLAttributes<HTMLSelectElement> {
+    options?: NativeSelectOption[];
+}
+/** Native select control for imperative or non-React option management. */
+declare const NativeSelect: React.ForwardRefExoticComponent<NativeSelectProps & React.RefAttributes<HTMLSelectElement>>;
+
+export { NativeSelect, type NativeSelectOption, type NativeSelectProps };

package/dist/primitives/native-select.d.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import { SelectHTMLAttributes } from 'react';
+
+interface NativeSelectOption {
+    value: string | number;
+    label: string;
+    disabled?: boolean;
+}
+interface NativeSelectProps extends SelectHTMLAttributes<HTMLSelectElement> {
+    options?: NativeSelectOption[];
+}
+/** Native select control for imperative or non-React option management. */
+declare const NativeSelect: React.ForwardRefExoticComponent<NativeSelectProps & React.RefAttributes<HTMLSelectElement>>;
+
+export { NativeSelect, type NativeSelectOption, type NativeSelectProps };

package/dist/primitives/native-select.js

@@ -0,0 +1,33 @@
+"use client";
+import {
+  cn
+} from "../chunk-G6SRSWXB.js";
+
+// src/primitives/native-select.tsx
+import { forwardRef } from "react";
+import { ChevronDown } from "lucide-react";
+import { jsx, jsxs } from "react/jsx-runtime";
+var NativeSelect = forwardRef(
+  function NativeSelect2({ className, children, options, ...props }, ref) {
+    return /* @__PURE__ */ jsxs("span", { className: "relative block", children: [
+      /* @__PURE__ */ jsx(
+        "select",
+        {
+          ref,
+          className: cn(
+            "flex h-10 w-full appearance-none rounded-md border border-input bg-background px-3 py-2 pr-9 text-[16px] md:text-sm",
+            "ring-offset-background focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2",
+            "disabled:cursor-not-allowed disabled:opacity-50",
+            className
+          ),
+          ...props,
+          children: options ? options.map((option) => /* @__PURE__ */ jsx("option", { value: option.value, disabled: option.disabled, children: option.label }, option.value)) : children
+        }
+      ),
+      /* @__PURE__ */ jsx(ChevronDown, { "aria-hidden": true, className: "pointer-events-none absolute right-3 top-1/2 size-4 -translate-y-1/2 text-muted-foreground" })
+    ] });
+  }
+);
+export {
+  NativeSelect
+};

package/dist/primitives/page-header-actions.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+"use client";
+
+
+var _chunkWQJKUKBLcjs = require('../chunk-WQJKUKBL.cjs');
+require('../chunk-ZAITUDYD.cjs');
+require('../chunk-L4DH72UF.cjs');
+require('../chunk-KWLSBTB2.cjs');
+
+
+exports.PageHeaderActions = _chunkWQJKUKBLcjs.PageHeaderActions;

package/dist/primitives/page-header-actions.d.cts

@@ -0,0 +1,49 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { ButtonProps } from './button.cjs';
+import 'class-variance-authority/types';
+import 'class-variance-authority';
+
+interface PageHeaderAction {
+    /** Stable identity used when rendering the action in both layouts. */
+    id: string;
+    label: ReactNode;
+    icon?: ReactNode;
+    onSelect?: () => void;
+    /** Optional nested actions. Desktop renders a menu button; mobile nests it inside Actions. */
+    items?: PageHeaderAction[];
+    /** Optional supporting copy shown when the action appears in a menu. */
+    description?: ReactNode;
+    disabled?: boolean;
+    /** Button treatment used in the expanded desktop layout. */
+    variant?: ButtonProps["variant"];
+    /**
+     * Visual hierarchy in the expanded desktop layout. Primary actions are
+     * always placed at the far right. When omitted, hierarchy is inferred from
+     * the button variant.
+     */
+    priority?: "primary" | "secondary" | "tertiary";
+    /** Semantic treatment used in the collapsed mobile menu. */
+    tone?: "default" | "muted" | "destructive";
+    /** Visually separates destructive or lower-priority actions in the menu. */
+    separatorBefore?: boolean;
+    title?: string;
+}
+interface PageHeaderActionsProps {
+    actions: PageHeaderAction[];
+    /** Visible label for the collapsed mobile trigger. */
+    mobileLabel?: ReactNode;
+    /** Accessible label when `mobileLabel` is not plain text. */
+    mobileAriaLabel?: string;
+    className?: string;
+}
+/**
+ * Responsive action cluster designed for `PageHeader`.
+ *
+ * Desktop keeps every action visible for fast scanning. Mobile collapses the
+ * same action definitions into one menu so page titles retain useful space.
+ * Status and other non-interactive metadata should remain beside the title.
+ */
+declare function PageHeaderActions({ actions, mobileLabel, mobileAriaLabel, className, }: PageHeaderActionsProps): react_jsx_runtime.JSX.Element | null;
+
+export { type PageHeaderAction, PageHeaderActions, type PageHeaderActionsProps };

package/dist/primitives/page-header-actions.d.ts

@@ -0,0 +1,49 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { ButtonProps } from './button.js';
+import 'class-variance-authority/types';
+import 'class-variance-authority';
+
+interface PageHeaderAction {
+    /** Stable identity used when rendering the action in both layouts. */
+    id: string;
+    label: ReactNode;
+    icon?: ReactNode;
+    onSelect?: () => void;
+    /** Optional nested actions. Desktop renders a menu button; mobile nests it inside Actions. */
+    items?: PageHeaderAction[];
+    /** Optional supporting copy shown when the action appears in a menu. */
+    description?: ReactNode;
+    disabled?: boolean;
+    /** Button treatment used in the expanded desktop layout. */
+    variant?: ButtonProps["variant"];
+    /**
+     * Visual hierarchy in the expanded desktop layout. Primary actions are
+     * always placed at the far right. When omitted, hierarchy is inferred from
+     * the button variant.
+     */
+    priority?: "primary" | "secondary" | "tertiary";
+    /** Semantic treatment used in the collapsed mobile menu. */
+    tone?: "default" | "muted" | "destructive";
+    /** Visually separates destructive or lower-priority actions in the menu. */
+    separatorBefore?: boolean;
+    title?: string;
+}
+interface PageHeaderActionsProps {
+    actions: PageHeaderAction[];
+    /** Visible label for the collapsed mobile trigger. */
+    mobileLabel?: ReactNode;
+    /** Accessible label when `mobileLabel` is not plain text. */
+    mobileAriaLabel?: string;
+    className?: string;
+}
+/**
+ * Responsive action cluster designed for `PageHeader`.
+ *
+ * Desktop keeps every action visible for fast scanning. Mobile collapses the
+ * same action definitions into one menu so page titles retain useful space.
+ * Status and other non-interactive metadata should remain beside the title.
+ */
+declare function PageHeaderActions({ actions, mobileLabel, mobileAriaLabel, className, }: PageHeaderActionsProps): react_jsx_runtime.JSX.Element | null;
+
+export { type PageHeaderAction, PageHeaderActions, type PageHeaderActionsProps };

package/dist/primitives/page-header-actions.js

@@ -0,0 +1,11 @@
+"use client";
+"use client";
+import {
+  PageHeaderActions
+} from "../chunk-QNZYQLNP.js";
+import "../chunk-V4LE2HWP.js";
+import "../chunk-HQRWRRZJ.js";
+import "../chunk-G6SRSWXB.js";
+export {
+  PageHeaderActions
+};

package/dist/primitives/page-header.cjs

@@ -0,0 +1,72 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+
+
+var _chunkKWLSBTB2cjs = require('../chunk-KWLSBTB2.cjs');
+
+// src/primitives/page-header.tsx
+var _jsxruntime = require('react/jsx-runtime');
+function PageHeader({
+  eyebrow,
+  title,
+  description,
+  children,
+  size = "default",
+  actionsLayout = "inline",
+  spacing = "default",
+  responsiveVisibility = "always",
+  className
+}) {
+  const display = size === "display";
+  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
+    "div",
+    {
+      className: _chunkKWLSBTB2cjs.cn.call(void 0, 
+        "flex items-start justify-between gap-4",
+        spacing === "default" && (display ? "mb-8 md:mb-10" : "mb-6"),
+        spacing === "compact" && "mb-4",
+        display && "flex-col gap-6 sm:flex-row sm:gap-4",
+        actionsLayout === "responsive" && "flex-wrap gap-y-3 [&>div:last-child]:w-full [&>div:last-child]:justify-end sm:[&>div:last-child]:w-auto",
+        responsiveVisibility === "desktop" && "hidden md:flex",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: _chunkKWLSBTB2cjs.cn.call(void 0, "min-w-0 flex-1", display ? "space-y-2" : "space-y-1.5"), children: [
+          eyebrow && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { className: "font-mono text-xs uppercase tracking-widest text-muted-foreground", children: eyebrow }),
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+            "h1",
+            {
+              className: _chunkKWLSBTB2cjs.cn.call(void 0, 
+                "font-semibold tracking-tight",
+                size === "display" ? "text-4xl leading-none md:text-6xl md:leading-none" : "text-2xl md:text-3xl"
+              ),
+              children: title
+            }
+          ),
+          description && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+            "p",
+            {
+              className: _chunkKWLSBTB2cjs.cn.call(void 0, 
+                "max-w-[72ch] text-muted-foreground",
+                size === "display" ? "text-base md:text-lg" : "text-sm"
+              ),
+              children: description
+            }
+          )
+        ] }),
+        children && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+          "div",
+          {
+            className: _chunkKWLSBTB2cjs.cn.call(void 0, 
+              "flex shrink-0 items-center gap-2",
+              size === "display" ? "w-full flex-wrap sm:mt-0.5 sm:w-auto sm:flex-nowrap md:mt-1" : "mt-1"
+            ),
+            children
+          }
+        )
+      ]
+    }
+  );
+}
+
+
+exports.PageHeader = PageHeader;

package/dist/primitives/page-header.d.cts

@@ -0,0 +1,40 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface PageHeaderProps {
+    eyebrow?: ReactNode;
+    title: ReactNode;
+    description?: ReactNode;
+    /**
+     * Action area on the right — typically a primary CTA ("New event")
+     * or a small cluster of secondary controls.
+     */
+    children?: ReactNode;
+    /**
+     * Visual scale. `display` gives index and overview pages an editorial
+     * anchor without changing the compact default used by existing apps.
+     */
+    size?: "default" | "display";
+    className?: string;
+    actionsLayout?: "inline" | "responsive";
+    spacing?: "default" | "compact" | "none";
+    /** Hide the page-level header when `AppLayout` already supplies mobile context. */
+    responsiveVisibility?: "always" | "desktop";
+}
+/**
+ * Page-level heading used at the top of every dashboard route.
+ *
+ * Typography (page-level, deliberately a step heavier than section
+ * headings):
+ *   - title: text-2xl on mobile, text-3xl on desktop, semibold
+ *   - eyebrow: small mono uppercase, used for breadcrumb-style context
+ *     ("client · session 2", "overview")
+ *   - description: text-sm muted, capped at 72ch for readability
+ *
+ * Layout: the compact default remains a single row. The opt-in display
+ * scale stacks actions on narrow screens so the larger heading keeps its
+ * intended measure, then returns them to the right on larger viewports.
+ */
+declare function PageHeader({ eyebrow, title, description, children, size, actionsLayout, spacing, responsiveVisibility, className, }: PageHeaderProps): react_jsx_runtime.JSX.Element;
+
+export { PageHeader };

package/dist/primitives/page-header.d.ts

@@ -0,0 +1,40 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface PageHeaderProps {
+    eyebrow?: ReactNode;
+    title: ReactNode;
+    description?: ReactNode;
+    /**
+     * Action area on the right — typically a primary CTA ("New event")
+     * or a small cluster of secondary controls.
+     */
+    children?: ReactNode;
+    /**
+     * Visual scale. `display` gives index and overview pages an editorial
+     * anchor without changing the compact default used by existing apps.
+     */
+    size?: "default" | "display";
+    className?: string;
+    actionsLayout?: "inline" | "responsive";
+    spacing?: "default" | "compact" | "none";
+    /** Hide the page-level header when `AppLayout` already supplies mobile context. */
+    responsiveVisibility?: "always" | "desktop";
+}
+/**
+ * Page-level heading used at the top of every dashboard route.
+ *
+ * Typography (page-level, deliberately a step heavier than section
+ * headings):
+ *   - title: text-2xl on mobile, text-3xl on desktop, semibold
+ *   - eyebrow: small mono uppercase, used for breadcrumb-style context
+ *     ("client · session 2", "overview")
+ *   - description: text-sm muted, capped at 72ch for readability
+ *
+ * Layout: the compact default remains a single row. The opt-in display
+ * scale stacks actions on narrow screens so the larger heading keeps its
+ * intended measure, then returns them to the right on larger viewports.
+ */
+declare function PageHeader({ eyebrow, title, description, children, size, actionsLayout, spacing, responsiveVisibility, className, }: PageHeaderProps): react_jsx_runtime.JSX.Element;
+
+export { PageHeader };

package/dist/primitives/page-header.js

@@ -0,0 +1,72 @@
+"use client";
+import {
+  cn
+} from "../chunk-G6SRSWXB.js";
+
+// src/primitives/page-header.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+function PageHeader({
+  eyebrow,
+  title,
+  description,
+  children,
+  size = "default",
+  actionsLayout = "inline",
+  spacing = "default",
+  responsiveVisibility = "always",
+  className
+}) {
+  const display = size === "display";
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn(
+        "flex items-start justify-between gap-4",
+        spacing === "default" && (display ? "mb-8 md:mb-10" : "mb-6"),
+        spacing === "compact" && "mb-4",
+        display && "flex-col gap-6 sm:flex-row sm:gap-4",
+        actionsLayout === "responsive" && "flex-wrap gap-y-3 [&>div:last-child]:w-full [&>div:last-child]:justify-end sm:[&>div:last-child]:w-auto",
+        responsiveVisibility === "desktop" && "hidden md:flex",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsxs("div", { className: cn("min-w-0 flex-1", display ? "space-y-2" : "space-y-1.5"), children: [
+          eyebrow && /* @__PURE__ */ jsx("p", { className: "font-mono text-xs uppercase tracking-widest text-muted-foreground", children: eyebrow }),
+          /* @__PURE__ */ jsx(
+            "h1",
+            {
+              className: cn(
+                "font-semibold tracking-tight",
+                size === "display" ? "text-4xl leading-none md:text-6xl md:leading-none" : "text-2xl md:text-3xl"
+              ),
+              children: title
+            }
+          ),
+          description && /* @__PURE__ */ jsx(
+            "p",
+            {
+              className: cn(
+                "max-w-[72ch] text-muted-foreground",
+                size === "display" ? "text-base md:text-lg" : "text-sm"
+              ),
+              children: description
+            }
+          )
+        ] }),
+        children && /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: cn(
+              "flex shrink-0 items-center gap-2",
+              size === "display" ? "w-full flex-wrap sm:mt-0.5 sm:w-auto sm:flex-nowrap md:mt-1" : "mt-1"
+            ),
+            children
+          }
+        )
+      ]
+    }
+  );
+}
+export {
+  PageHeader
+};