@passui/react 0.1.31 → 0.1.33

package/dist/types/src/components/breadcrumb/breadcrumb.d.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from "react";
+export type BreadcrumbSize = "sm" | "md";
 export interface BreadcrumbItem {
     label: string;
     href?: string;
@@ -11,6 +12,8 @@ export interface BreadcrumbProps {
     renderLink?: (item: BreadcrumbItem & {
         href: string;
     }) => ReactNode;
+    /** Text scale. @default "md" */
+    size?: BreadcrumbSize;
 }
 /** Ancestors stay links; the final item identifies the current page. */
-export declare function Breadcrumb({ label, items, className, renderLink }: BreadcrumbProps): import("react").JSX.Element;
+export declare function Breadcrumb({ label, items, className, renderLink, size }: BreadcrumbProps): import("react").JSX.Element;

package/dist/types/src/components/section/section.d.ts

@@ -1,4 +1,5 @@
 import { type HTMLAttributes, type ReactNode } from "react";
+export type SectionSize = "sm" | "md" | "lg";
 export interface SectionProps extends HTMLAttributes<HTMLElement> {
     /** Optional group heading and accessible name. */
     title?: string;
@@ -6,10 +7,12 @@ export interface SectionProps extends HTMLAttributes<HTMLElement> {
     footer?: ReactNode;
     /** Rows, typically LabeledContent. */
     children?: ReactNode;
+    /** Title and footer text scale + padding. @default "md" */
+    size?: SectionSize;
 }
 /**
  * A titled, inset group of rows with an optional footer, as in iOS Settings
  * and SwiftUI's grouped `List` with `Section(header:footer:)`. Rows are
  * usually `LabeledContent`; dividers between them come for free.
  */
-export declare function Section({ title, footer, children, className, ...props }: SectionProps): import("react").JSX.Element;
+export declare function Section({ title, footer, children, className, size, ...props }: SectionProps): import("react").JSX.Element;

package/dist/types/src/components/skeleton/skeleton.d.ts

@@ -1,6 +1,9 @@
 import type { ComponentProps } from "react";
+export type SkeletonSize = "sm" | "md" | "lg";
 export interface SkeletonProps extends ComponentProps<"div"> {
     label?: string;
+    /** Minimum height and rounding. @default "md" */
+    size?: SkeletonSize;
 }
 /** A loading placeholder that becomes still when Reduce Motion is enabled. */
-export declare function Skeleton({ label, className, ...props }: SkeletonProps): import("react").JSX.Element;
+export declare function Skeleton({ label, size, className, ...props }: SkeletonProps): import("react").JSX.Element;

package/dist/types/src/components/stat-tile/stat-tile.d.ts

@@ -1,5 +1,6 @@
 import type { ReactNode } from "react";
 export type StatTileTone = "critical";
+export type StatTileSize = "sm" | "md" | "lg";
 export interface StatTileProps {
     label: string;
     value: number;
@@ -12,6 +13,8 @@ export interface StatTileProps {
     active?: boolean;
     /** Custom classes for the tile container. */
     className?: string;
+    /** Tile padding and number scale. @default "md" */
+    size?: StatTileSize;
 }
 /** One number with its label, optionally a toggle. */
-export declare function StatTile({ label, value, caption, tone, onClick, active, className, }: StatTileProps): import("react").JSX.Element;
+export declare function StatTile({ label, value, caption, tone, onClick, active, className, size, }: StatTileProps): import("react").JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@passui/react",
-    "version": "0.1.31",
+    "version": "0.1.33",
     "description": "Passui: native React controls, design tokens, presentation and appearance.",
     "license": "MIT",
     "repository": {

package/src/components/breadcrumb/breadcrumb.tsx

@@ -1,6 +1,13 @@
 import type { ReactNode } from "react"
 import { cn } from "../../lib/class-names"
 
+export type BreadcrumbSize = "sm" | "md"
+
+const sizes: Record<BreadcrumbSize, string> = {
+    sm: "text-caption",
+    md: "text-footnote",
+}
+
 export interface BreadcrumbItem {
     label: string
     href?: string
@@ -11,12 +18,19 @@ export interface BreadcrumbProps {
     className?: string
     /** Integrate a client router without nesting interactive elements. */
     renderLink?: (item: BreadcrumbItem & { href: string }) => ReactNode
+    /** Text scale. @default "md" */
+    size?: BreadcrumbSize
 }
 /** Ancestors stay links; the final item identifies the current page. */
-export function Breadcrumb({ label, items, className, renderLink }: BreadcrumbProps) {
+export function Breadcrumb({ label, items, className, renderLink, size = "md" }: BreadcrumbProps) {
     return (
         <nav aria-label={label} className={cn("not-typeset", className)}>
-            <ol className="m-0 flex list-none flex-wrap items-center gap-x-2 gap-y-1 p-0 text-footnote text-label-secondary">
+            <ol
+                className={cn(
+                    "m-0 flex list-none flex-wrap items-center gap-x-2 gap-y-1 p-0 text-label-secondary",
+                    sizes[size]
+                )}
+            >
                 {items.map((item, index) => (
                     <li
                         key={`${index}-${item.label}`}

package/src/components/section/section.tsx

@@ -1,6 +1,20 @@
 import { useId, type HTMLAttributes, type ReactNode } from "react"
 import { cn } from "../../lib/class-names"
 
+export type SectionSize = "sm" | "md" | "lg"
+
+const titleSizes: Record<SectionSize, string> = {
+    sm: "px-3 text-caption",
+    md: "px-4 text-footnote",
+    lg: "px-5 text-subheadline",
+}
+
+const footerSizes: Record<SectionSize, string> = {
+    sm: "px-3",
+    md: "px-4",
+    lg: "px-5",
+}
+
 export interface SectionProps extends HTMLAttributes<HTMLElement> {
     /** Optional group heading and accessible name. */
     title?: string
@@ -8,6 +22,8 @@ export interface SectionProps extends HTMLAttributes<HTMLElement> {
     footer?: ReactNode
     /** Rows, typically LabeledContent. */
     children?: ReactNode
+    /** Title and footer text scale + padding. @default "md" */
+    size?: SectionSize
 }
 
 /**
@@ -15,7 +31,14 @@ export interface SectionProps extends HTMLAttributes<HTMLElement> {
  * and SwiftUI's grouped `List` with `Section(header:footer:)`. Rows are
  * usually `LabeledContent`; dividers between them come for free.
  */
-export function Section({ title, footer, children, className, ...props }: SectionProps) {
+export function Section({
+    title,
+    footer,
+    children,
+    className,
+    size = "md",
+    ...props
+}: SectionProps) {
     const headingId = useId()
     return (
         <section
@@ -24,7 +47,10 @@ export function Section({ title, footer, children, className, ...props }: Sectio
             {...props}
         >
             {title && (
-                <h2 id={headingId} className="px-4 text-footnote font-medium text-label-tertiary">
+                <h2
+                    id={headingId}
+                    className={cn(titleSizes[size], "font-medium text-label-tertiary")}
+                >
                     {title}
                 </h2>
             )}
@@ -35,7 +61,14 @@ export function Section({ title, footer, children, className, ...props }: Sectio
                 </div>
             ) : null}
             {footer && (
-                <div className="px-4 text-caption leading-snug text-label-tertiary">{footer}</div>
+                <div
+                    className={cn(
+                        footerSizes[size],
+                        "text-caption leading-snug text-label-tertiary"
+                    )}
+                >
+                    {footer}
+                </div>
             )}
         </section>
     )

package/src/components/skeleton/skeleton.tsx

@@ -1,17 +1,27 @@
 import type { ComponentProps } from "react"
 import { cn } from "../../lib/class-names"
 
+export type SkeletonSize = "sm" | "md" | "lg"
+
+const minHeights: Record<SkeletonSize, string> = {
+    sm: "min-h-3 rounded-md",
+    md: "min-h-4 rounded-md",
+    lg: "min-h-6 rounded-lg",
+}
+
 export interface SkeletonProps extends ComponentProps<"div"> {
     label?: string
+    /** Minimum height and rounding. @default "md" */
+    size?: SkeletonSize
 }
 /** A loading placeholder that becomes still when Reduce Motion is enabled. */
-export function Skeleton({ label, className, ...props }: SkeletonProps) {
+export function Skeleton({ label, size = "md", className, ...props }: SkeletonProps) {
     return (
         <div
             {...props}
             role={label ? "status" : undefined}
             aria-hidden={label ? undefined : true}
-            className={cn("min-h-4 rounded-md bg-fill motion-safe:animate-pulse", className)}
+            className={cn("bg-fill motion-safe:animate-pulse", minHeights[size], className)}
         >
             {label && <span className="sr-only">{label}</span>}
         </div>

package/src/components/stat-tile/stat-tile.tsx

@@ -2,6 +2,13 @@ import type { ReactNode } from "react"
 import { cn } from "../../lib/class-names"
 
 export type StatTileTone = "critical"
+export type StatTileSize = "sm" | "md" | "lg"
+
+const tileSizes: Record<StatTileSize, { padding: string; valueText: string; labelText: string }> = {
+    sm: { padding: "p-3", valueText: "text-title3", labelText: "text-caption" },
+    md: { padding: "p-4", valueText: "text-title1", labelText: "text-footnote" },
+    lg: { padding: "p-5", valueText: "text-title", labelText: "text-subheadline" },
+}
 
 export interface StatTileProps {
     label: string
@@ -15,6 +22,8 @@ export interface StatTileProps {
     active?: boolean
     /** Custom classes for the tile container. */
     className?: string
+    /** Tile padding and number scale. @default "md" */
+    size?: StatTileSize
 }
 
 /** One number with its label, optionally a toggle. */
@@ -26,18 +35,29 @@ export function StatTile({
     onClick,
     active = false,
     className,
+    size = "md",
 }: StatTileProps) {
+    const dims = tileSizes[size]
     const body = (
         <>
-            <span className="text-label-secondary">{label}</span>
-            <span className={cn("tabular-nums", tone === "critical" && value > 0 && "text-danger")}>
+            <span className={cn(dims.labelText, "text-label-secondary")}>{label}</span>
+            <span
+                className={cn(
+                    "tabular-nums font-semibold",
+                    dims.valueText,
+                    tone === "critical" && value > 0 && "text-danger"
+                )}
+            >
                 {value.toLocaleString("en-US")}
             </span>
-            {caption && <span className="text-label-secondary">{caption}</span>}
+            {caption && (
+                <span className={cn(dims.labelText, "text-label-tertiary")}>{caption}</span>
+            )}
         </>
     )
     const tileClass = cn(
-        "flex min-w-0 flex-col gap-2 rounded-2xl border border-separator/35 bg-elevated p-4 text-left shadow-xs",
+        "flex min-w-0 flex-col gap-2 rounded-2xl border border-separator/35 bg-elevated text-left shadow-xs",
+        dims.padding,
         className
     )