@tribepad/themis 1.0.0

package/dist/elements/Button/Button.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Button Component - 3-Layer Architecture
+ * Accessible button with React Aria primitives and CVA styling
+ *
+ * Architecture:
+ * - Layer 1: Touch Target (44x44px WCAG AAA compliant, transparent)
+ * - Layer 2: Visual Button (configurable size, colors, borders)
+ * - Layer 3: Content & Effects (text, icons, ripple, loading spinner)
+ *
+ * @see 3layer-plan.md for architecture details
+ * @see spec.md FR-029 to FR-037 (Button Component Requirements)
+ * @see spec.md FR-009 (WCAG 2.2 AAA - 7:1 contrast ratio)
+ * @see spec.md FR-014 (44x44px minimum touch targets)
+ * @see constitution.md Principle IV (Accessibility First)
+ */
+import { type ReactNode } from 'react';
+import { type ButtonProps as AriaButtonProps } from 'react-aria-components';
+import { type VariantProps } from 'class-variance-authority';
+/**
+ * Layer 1: Transparent outer touch target (44x44px minimum)
+ * Handles WCAG 2.2 AAA touch target requirement
+ * Always transparent, centers the visual button inside
+ * IMPORTANT: Focus ring stays on Layer 1 for AAA compliance (2.4.13)
+ *
+ * In vertical ButtonGroups, uses items-stretch so the visual layer (Layer 2)
+ * can fill the full touch target height, eliminating gaps between buttons.
+ */
+declare const buttonOuterVariants: (props?: ({
+    fullWidth?: boolean | null | undefined;
+    inVerticalGroup?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Layer 2: Visual button appearance (adjustable size)
+ * Provides the visual appearance with configurable size
+ * Can be smaller than touch target for use cases like carousel dots
+ * NOTE: NO focus-visible styles here - focus ring is on Layer 1
+ */
+declare const buttonVisualVariants: (props?: ({
+    variant?: "default" | "link" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    fullWidth?: boolean | null | undefined;
+    visualSize?: "default" | "icon" | "sm" | "lg" | "dot" | null | undefined;
+    paywall?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * @deprecated Use buttonVisualVariants instead. This alias is kept for backward compatibility.
+ */
+declare const buttonVariants: (props?: ({
+    variant?: "default" | "link" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    fullWidth?: boolean | null | undefined;
+    visualSize?: "default" | "icon" | "sm" | "lg" | "dot" | null | undefined;
+    paywall?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface ButtonProps extends Omit<AriaButtonProps, 'className'>, VariantProps<typeof buttonVisualVariants> {
+    as?: 'button' | 'a';
+    loading?: boolean;
+    loadingText?: string;
+    shortcut?: string;
+    className?: string;
+    buttonVisualClassName?: string;
+    children?: ReactNode;
+    /** Enables paywall state - overrides variant styling and prevents normal action */
+    paywall?: boolean;
+    /** URL to open in new tab when paywalled button is clicked */
+    paywallRedirect?: string;
+    /** Description of the premium feature for tooltips and screen readers (max 200 chars) */
+    paywallDescription?: string;
+    /** Full width button */
+    fullWidth?: boolean;
+    /**
+     * Visual size of the button (Layer 2)
+     * Defaults to `size` for backward compatibility
+     * Use independently for small visual buttons with large touch targets
+     * @example <Button size="default" visualSize="dot" /> // 44px touch, 12px visual
+     */
+    visualSize?: 'sm' | 'default' | 'lg' | 'icon' | 'dot';
+    /**
+     * Size of the button - controls both touch target awareness and visual size
+     * @deprecated For independent visual sizing, use visualSize prop instead
+     */
+    size?: 'sm' | 'default' | 'lg' | 'icon';
+}
+/**
+ * Button Component - 3-Layer Architecture
+ * Fully accessible button with React Aria and themed styling
+ *
+ * Layer 1: Touch Target (AriaButton) - 44x44px WCAG AAA compliant
+ * Layer 2: Visual Button (span) - configurable appearance
+ * Layer 3: Content (children) - text, icons, effects
+ */
+declare const Button: import("react").NamedExoticComponent<ButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
+export { Button, buttonVariants, buttonOuterVariants, buttonVisualVariants };
+//# sourceMappingURL=Button.d.ts.map

package/dist/elements/Button/Button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/elements/Button/Button.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChE,OAAO,EAEL,KAAK,WAAW,IAAI,eAAe,EACpC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAUlE;;;;;;;;GAQG;AACH,QAAA,MAAM,mBAAmB;;;8EAkBxB,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,oBAAoB;;;;;8EAuCzB,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,cAAc;;;;;8EAAuB,CAAC;AAE5C,MAAM,WAAW,WACf,SAAQ,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,EACxC,YAAY,CAAC,OAAO,oBAAoB,CAAC;IAC3C,EAAE,CAAC,EAAE,QAAQ,GAAG,GAAG,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,mFAAmF;IACnF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wBAAwB;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,CAAC;IACtD;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,QAAA,MAAM,MAAM,sGA0KV,CAAC;AAIH,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/elements/Button/Button.types.d.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import type { ButtonProps as AriaButtonProps } from 'react-aria-components';
+/**
+ * Button props schema extending BaseComponentProps
+ *
+ * @see spec.md FR-029 to FR-037 (Button Component Requirements)
+ * @see spec.md FR-031 - Button MUST support ALL states: loading, disabled, pressed, focused
+ * @see spec.md FR-034 - Button MUST display keyboard shortcuts on focus when shortcut prop provided
+ */
+export declare const ButtonPropsSchema: z.ZodObject<{
+    className: z.ZodOptional<z.ZodString>;
+    children: z.ZodOptional<z.ZodAny>;
+    id: z.ZodOptional<z.ZodString>;
+    'aria-label': z.ZodOptional<z.ZodString>;
+    'aria-labelledby': z.ZodOptional<z.ZodString>;
+    'aria-describedby': z.ZodOptional<z.ZodString>;
+    'aria-live': z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        polite: "polite";
+        assertive: "assertive";
+    }>>;
+    'aria-hidden': z.ZodOptional<z.ZodBoolean>;
+    'data-testid': z.ZodOptional<z.ZodString>;
+    variant: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        link: "link";
+        destructive: "destructive";
+        outline: "outline";
+        secondary: "secondary";
+        ghost: "ghost";
+    }>>>;
+    size: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        icon: "icon";
+        sm: "sm";
+        lg: "lg";
+    }>>>;
+    loading: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    isDisabled: z.ZodOptional<z.ZodBoolean>;
+    loadingText: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    shortcut: z.ZodOptional<z.ZodString>;
+    onPress: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+    paywall: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    paywallRedirect: z.ZodOptional<z.ZodString>;
+    paywallDescription: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ButtonProps = z.infer<typeof ButtonPropsSchema> & Omit<AriaButtonProps, keyof z.infer<typeof ButtonPropsSchema>>;
+/**
+ * CVA variant configuration type
+ * Used for class-variance-authority integration (FR-036)
+ */
+export type ButtonVariant = z.infer<typeof ButtonPropsSchema>['variant'];
+export type ButtonSize = z.infer<typeof ButtonPropsSchema>['size'];
+//# sourceMappingURL=Button.types.d.ts.map

package/dist/elements/Button/Button.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.types.d.ts","sourceRoot":"","sources":["../../../src/elements/Button/Button.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmC5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACzD,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC;AACzE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/elements/Button/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Button Component Exports
+ * Barrel export for Button component and utilities
+ *
+ * 3-Layer Architecture (v0.9.0):
+ * - buttonOuterVariants: Layer 1 - Touch target (44x44px)
+ * - buttonVisualVariants: Layer 2 - Visual appearance
+ * - buttonVariants: Deprecated alias for buttonVisualVariants
+ *
+ * @see 3layer-plan.md for architecture details
+ * @see spec.md FR-029 to FR-037 (Button Component Requirements)
+ * @see spec.md FR-038 (Tree-shakeable exports)
+ */
+export { Button, buttonOuterVariants, buttonVisualVariants, 
+/** @deprecated Use buttonVisualVariants instead */
+buttonVariants, } from './Button';
+export type { ButtonProps } from './Button';
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/Button/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/elements/Button/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,oBAAoB;AACpB,mDAAmD;AACnD,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/elements/Button/index.js

@@ -0,0 +1,27 @@
+'use strict';
+
+var chunk3YOY2VJ6_js = require('../../chunk-3YOY2VJ6.js');
+require('../../chunk-Y3GT7ETK.js');
+require('../../chunk-B5Q4UPL6.js');
+require('../../chunk-VIREG536.js');
+
+
+
+Object.defineProperty(exports, "Button", {
+  enumerable: true,
+  get: function () { return chunk3YOY2VJ6_js.Button; }
+});
+Object.defineProperty(exports, "buttonOuterVariants", {
+  enumerable: true,
+  get: function () { return chunk3YOY2VJ6_js.buttonOuterVariants; }
+});
+Object.defineProperty(exports, "buttonVariants", {
+  enumerable: true,
+  get: function () { return chunk3YOY2VJ6_js.buttonVariants; }
+});
+Object.defineProperty(exports, "buttonVisualVariants", {
+  enumerable: true,
+  get: function () { return chunk3YOY2VJ6_js.buttonVisualVariants; }
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/elements/Button/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/elements/Button/index.mjs

@@ -0,0 +1,6 @@
+export { Button, buttonOuterVariants, buttonVariants, buttonVisualVariants } from '../../chunk-BDXKKMBZ.mjs';
+import '../../chunk-FPKEAJRZ.mjs';
+import '../../chunk-HK46BT5U.mjs';
+import '../../chunk-E2KQFV3O.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/elements/Button/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/elements/ButtonGroup/ButtonGroup.d.ts

@@ -0,0 +1,53 @@
+/**
+ * ButtonGroup - Groups related buttons with connected styling and keyboard navigation
+ *
+ * Uses React Aria's Toolbar for:
+ * - Roving tabindex (single tab stop)
+ * - Arrow key navigation
+ * - Home/End key support
+ * - RTL support
+ *
+ * @example
+ * ```tsx
+ * <ButtonGroup aria-label="Text formatting">
+ *   <Button variant="outline">Bold</Button>
+ *   <Button variant="outline">Italic</Button>
+ *   <Button variant="outline">Underline</Button>
+ * </ButtonGroup>
+ * ```
+ */
+declare const ButtonGroup: import("react").ForwardRefExoticComponent<{
+    orientation: "horizontal" | "vertical";
+    children: import("react").ReactNode;
+    variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | undefined;
+    size?: "default" | "icon" | "sm" | "lg" | undefined;
+    isDisabled?: boolean | undefined;
+    'aria-label'?: string | undefined;
+    'aria-labelledby'?: string | undefined;
+    className?: string | undefined;
+} & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * ButtonGroupSeparator - Visual divider between button groups
+ *
+ * Renders a decorative separator that:
+ * - Adapts to orientation (vertical line for horizontal, horizontal for vertical)
+ * - Is hidden from screen readers (aria-hidden)
+ * - Is excluded from keyboard navigation
+ *
+ * @example
+ * ```tsx
+ * <ButtonGroup aria-label="Editor actions">
+ *   <Button>Undo</Button>
+ *   <Button>Redo</Button>
+ *   <ButtonGroupSeparator />
+ *   <Button>Cut</Button>
+ *   <Button>Copy</Button>
+ * </ButtonGroup>
+ * ```
+ */
+declare const ButtonGroupSeparator: import("react").ForwardRefExoticComponent<{
+    className?: string | undefined;
+    'data-testid'?: string | undefined;
+} & import("react").RefAttributes<HTMLDivElement>>;
+export { ButtonGroup, ButtonGroupSeparator };
+//# sourceMappingURL=ButtonGroup.d.ts.map

package/dist/elements/ButtonGroup/ButtonGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ButtonGroup.d.ts","sourceRoot":"","sources":["../../../src/elements/ButtonGroup/ButtonGroup.tsx"],"names":[],"mappings":"AA8BA;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,WAAW;;;;;;;;;kDA+DhB,CAAC;AAQF;;;;;;;;;;;;;;;;;;GAkBG;AACH,QAAA,MAAM,oBAAoB;;;kDAkBzB,CAAC;AAQF,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/elements/ButtonGroup/ButtonGroup.types.d.ts

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import type { ReactNode } from 'react';
+/**
+ * ButtonGroup Component Types
+ *
+ * Defines Zod schemas and TypeScript types for the ButtonGroup component.
+ * Uses a two-level context pattern:
+ * - ButtonGroupContext: Group-level props (orientation, variant, size, isDisabled)
+ * - ButtonGroupItemContext: Per-button position information
+ *
+ * @see plan.md for architecture details
+ * @see constitution.md Principle II (Type Safety First)
+ */
+/**
+ * Orientation of the button group
+ */
+export type ButtonGroupOrientation = 'horizontal' | 'vertical';
+/**
+ * Position of a button within the group
+ * Used for position-aware border-radius styling
+ */
+export type ButtonPosition = 'first' | 'middle' | 'last' | 'only';
+/**
+ * Button variants (matches Themis Button variants, excluding 'link')
+ * Link variant is excluded as it doesn't make sense in a grouped context
+ */
+export type ButtonGroupVariant = 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost';
+/**
+ * Button sizes (matches Themis Button sizes)
+ */
+export type ButtonGroupSize = 'sm' | 'default' | 'lg' | 'icon';
+/**
+ * ButtonGroup props schema
+ * Validates all props for the ButtonGroup container component
+ */
+export declare const ButtonGroupPropsSchema: z.ZodObject<{
+    orientation: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        horizontal: "horizontal";
+        vertical: "vertical";
+    }>>>;
+    variant: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        destructive: "destructive";
+        outline: "outline";
+        secondary: "secondary";
+        ghost: "ghost";
+    }>>;
+    size: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        icon: "icon";
+        sm: "sm";
+        lg: "lg";
+    }>>;
+    isDisabled: z.ZodOptional<z.ZodBoolean>;
+    'aria-label': z.ZodOptional<z.ZodString>;
+    'aria-labelledby': z.ZodOptional<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+    children: z.ZodCustom<ReactNode, ReactNode>;
+}, z.core.$strip>;
+/**
+ * ButtonGroupSeparator props schema
+ * Validates props for the visual separator between button groups
+ */
+export declare const ButtonGroupSeparatorPropsSchema: z.ZodObject<{
+    className: z.ZodOptional<z.ZodString>;
+    'data-testid': z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Props for the ButtonGroup container component
+ */
+export type ButtonGroupProps = z.infer<typeof ButtonGroupPropsSchema>;
+/**
+ * Props for the ButtonGroupSeparator component
+ */
+export type ButtonGroupSeparatorProps = z.infer<typeof ButtonGroupSeparatorPropsSchema>;
+/**
+ * Group-level context value
+ * Provides inherited props to all child buttons
+ */
+export interface ButtonGroupContextValue {
+    /** Orientation of the group (affects keyboard navigation and styling) */
+    orientation: ButtonGroupOrientation;
+    /** Default variant for buttons (can be overridden) */
+    variant?: ButtonGroupVariant;
+    /** Default size for buttons (can be overridden) */
+    size?: ButtonGroupSize;
+    /** Whether all buttons in the group are disabled */
+    isDisabled?: boolean;
+}
+/**
+ * Item-level context value
+ * Provides position information to each button for border-radius styling
+ */
+export interface ButtonGroupItemContextValue {
+    /** Position of this button in the group */
+    position: ButtonPosition;
+}
+//# sourceMappingURL=ButtonGroup.types.d.ts.map

package/dist/elements/ButtonGroup/ButtonGroup.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ButtonGroup.types.d.ts","sourceRoot":"","sources":["../../../src/elements/ButtonGroup/ButtonGroup.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;;;;;;GAUG;AAMH;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE/D;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,aAAa,GACb,SAAS,GACT,WAAW,GACX,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC;AAM/D;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;iBA6BjC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,+BAA+B;;;iBAK1C,CAAC;AAMH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAC;AAMF;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,WAAW,EAAE,sBAAsB,CAAC;IACpC,sDAAsD;IACtD,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,mDAAmD;IACnD,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,oDAAoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,2CAA2C;IAC3C,QAAQ,EAAE,cAAc,CAAC;CAC1B"}

package/dist/elements/ButtonGroup/ButtonGroup.utils.d.ts

@@ -0,0 +1,60 @@
+import { type ReactNode } from 'react';
+import type { ButtonPosition } from './ButtonGroup.types';
+/**
+ * ButtonGroup Utility Functions
+ *
+ * Provides helper functions for:
+ * - Child element detection (Button vs Separator vs other)
+ * - Position calculation for border-radius styling
+ *
+ * @see plan.md Decision 6: Non-Button Child Handling
+ */
+/**
+ * Checks if a React child is a Themis Button component
+ * Uses displayName for reliable detection across module boundaries
+ *
+ * @param child - React child element to check
+ * @returns true if the child is a Button component
+ */
+export declare const isButtonElement: (child: ReactNode) => boolean;
+/**
+ * Checks if a React child is a ButtonGroupSeparator component
+ * Uses displayName for reliable detection across module boundaries
+ *
+ * @param child - React child element to check
+ * @returns true if the child is a ButtonGroupSeparator component
+ */
+export declare const isSeparatorElement: (child: ReactNode) => boolean;
+/**
+ * Calculates the position of a button within a group
+ * Used for applying position-aware border-radius styling
+ *
+ * @param index - Zero-based index of the button
+ * @param total - Total number of buttons in the group
+ * @returns Position enum: 'only' | 'first' | 'last' | 'middle'
+ *
+ * @example
+ * getPosition(0, 1) // 'only' - single button
+ * getPosition(0, 3) // 'first'
+ * getPosition(1, 3) // 'middle'
+ * getPosition(2, 3) // 'last'
+ */
+export declare const getPosition: (index: number, total: number) => ButtonPosition;
+/**
+ * Filters an array of React children to only include Button elements
+ * Non-Button children (Separators, custom elements) are excluded
+ *
+ * @param children - Array of React children
+ * @returns Array containing only Button elements
+ */
+export declare const filterButtonChildren: (children: ReactNode[]) => ReactNode[];
+/**
+ * Gets the index of a button within the filtered button array
+ * Used when the child array contains non-Button elements (Separators, etc.)
+ *
+ * @param child - The button element to find
+ * @param buttonChildren - Array of only Button elements
+ * @returns Index of the button, or -1 if not found
+ */
+export declare const getButtonIndex: (child: ReactNode, buttonChildren: ReactNode[]) => number;
+//# sourceMappingURL=ButtonGroup.utils.d.ts.map

package/dist/elements/ButtonGroup/ButtonGroup.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ButtonGroup.utils.d.ts","sourceRoot":"","sources":["../../../src/elements/ButtonGroup/ButtonGroup.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,SAAS,EAAsB,MAAM,OAAO,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;GAQG;AAMH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,SAAS,KAAG,OAKlD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,SAAS,KAAG,OAKrD,CAAC;AAMF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,cAK1D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,SAAS,EAAE,KAAG,SAAS,EAErE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,SAAS,EAChB,gBAAgB,SAAS,EAAE,KAC1B,MAEF,CAAC"}

package/dist/elements/ButtonGroup/ButtonGroup.variants.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ButtonGroup CVA Variants
+ *
+ * Defines Class Variance Authority (CVA) variants for:
+ * - ButtonGroup container (orientation-based layout)
+ * - ButtonGroupItem (position-based border-radius)
+ * - ButtonGroupSeparator (orientation-based styling)
+ *
+ * @see plan.md Phase 1: Design & Contracts - CVA Variants
+ * @see constitution.md Principle V (Component Quality Standards)
+ */
+/**
+ * ButtonGroup container variants
+ * Controls the layout direction based on orientation
+ * Uses gap-0 to ensure buttons are connected (share borders)
+ */
+export declare const buttonGroupVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * ButtonGroupItem position variants
+ * Applied to Button's visual layer (Layer 2) for position-aware border-radius
+ *
+ * Compound variants handle both orientation and position combinations:
+ * - Horizontal: left/right borders and radii
+ * - Vertical: top/bottom borders and radii
+ */
+export declare const buttonGroupItemVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+    position?: "first" | "middle" | "last" | "only" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * ButtonGroupSeparator variants
+ * Orientation-aware visual divider between button groups
+ */
+export declare const buttonGroupSeparatorVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+//# sourceMappingURL=ButtonGroup.variants.d.ts.map

package/dist/elements/ButtonGroup/ButtonGroup.variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ButtonGroup.variants.d.ts","sourceRoot":"","sources":["../../../src/elements/ButtonGroup/ButtonGroup.variants.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAMH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;8EAU9B,CAAC;AAMH;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;8EA2DlC,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;8EAUvC,CAAC"}

package/dist/elements/ButtonGroup/ButtonGroupContext.d.ts

@@ -0,0 +1,42 @@
+import type { ButtonGroupContextValue, ButtonGroupItemContextValue } from './ButtonGroup.types';
+/**
+ * ButtonGroup Context System (Two-Level)
+ *
+ * Provides a two-level context pattern for ButtonGroup:
+ *
+ * 1. ButtonGroupContext (group-level):
+ *    - Provides: orientation, variant, size, isDisabled
+ *    - Consumed by: Button (for prop inheritance), Separator (for orientation)
+ *
+ * 2. ButtonGroupItemContext (item-level):
+ *    - Provides: position ('first' | 'middle' | 'last' | 'only')
+ *    - Consumed by: Button (for border-radius styling)
+ *
+ * Both contexts return null when not in a provider, allowing Button
+ * to work standalone without any group context.
+ *
+ * @see plan.md for architecture details
+ * @see ButtonGroup.tsx for Provider implementation
+ */
+/**
+ * Context for group-level props (orientation, variant, size, isDisabled)
+ * Default value is null to indicate "not in a group"
+ */
+declare const ButtonGroupContext: import("react").Context<ButtonGroupContextValue | null>;
+/**
+ * Hook to access group-level context
+ * @returns ButtonGroupContextValue if inside a ButtonGroup, null otherwise
+ */
+export declare function useButtonGroupContext(): ButtonGroupContextValue | null;
+/**
+ * Context for per-button position information
+ * Default value is null to indicate "not wrapped with position context"
+ */
+declare const ButtonGroupItemContext: import("react").Context<ButtonGroupItemContextValue | null>;
+/**
+ * Hook to access item-level context (position)
+ * @returns ButtonGroupItemContextValue if wrapped with position context, null otherwise
+ */
+export declare function useButtonGroupItemContext(): ButtonGroupItemContextValue | null;
+export { ButtonGroupContext, ButtonGroupItemContext };
+//# sourceMappingURL=ButtonGroupContext.d.ts.map

package/dist/elements/ButtonGroup/ButtonGroupContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ButtonGroupContext.d.ts","sourceRoot":"","sources":["../../../src/elements/ButtonGroup/ButtonGroupContext.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;GAkBG;AAMH;;;GAGG;AACH,QAAA,MAAM,kBAAkB,yDAAsD,CAAC;AAI/E;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,uBAAuB,GAAG,IAAI,CAEtE;AAMD;;;GAGG;AACH,QAAA,MAAM,sBAAsB,6DAC6B,CAAC;AAI1D;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,2BAA2B,GAAG,IAAI,CAE9E;AAMD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/elements/ButtonGroup/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ButtonGroup Component - Public API
+ *
+ * Exports all public members of the ButtonGroup component:
+ * - Components: ButtonGroup, ButtonGroupSeparator
+ * - Context Hooks: useButtonGroupContext, useButtonGroupItemContext
+ * - Types: ButtonGroupProps, ButtonGroupContextValue, etc.
+ * - Schemas: ButtonGroupPropsSchema
+ * - CVA Variants: for custom composition
+ * - Utilities: for advanced customization
+ *
+ * @example
+ * ```tsx
+ * import { ButtonGroup, ButtonGroupSeparator } from '@tribepad/themis/elements/ButtonGroup';
+ * import { Button } from '@tribepad/themis/elements/Button';
+ *
+ * function Toolbar() {
+ *   return (
+ *     <ButtonGroup aria-label="Text formatting">
+ *       <Button variant="outline">Bold</Button>
+ *       <Button variant="outline">Italic</Button>
+ *       <ButtonGroupSeparator />
+ *       <Button variant="outline">Link</Button>
+ *     </ButtonGroup>
+ *   );
+ * }
+ * ```
+ */
+export { ButtonGroup, ButtonGroupSeparator } from './ButtonGroup';
+export { useButtonGroupContext, useButtonGroupItemContext, } from './ButtonGroupContext';
+export type { ButtonGroupProps, ButtonGroupSeparatorProps, ButtonGroupContextValue, ButtonGroupItemContextValue, ButtonGroupOrientation, ButtonGroupVariant, ButtonGroupSize, ButtonPosition, } from './ButtonGroup.types';
+export { ButtonGroupPropsSchema, ButtonGroupSeparatorPropsSchema, } from './ButtonGroup.types';
+export { buttonGroupVariants, buttonGroupItemVariants, buttonGroupSeparatorVariants, } from './ButtonGroup.variants';
+export { isButtonElement, isSeparatorElement, getPosition, filterButtonChildren, getButtonIndex, } from './ButtonGroup.utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/ButtonGroup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/elements/ButtonGroup/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAMlE,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAM9B,YAAY,EACV,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,cAAc,GACf,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EACL,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,cAAc,GACf,MAAM,qBAAqB,CAAC"}

package/dist/elements/ButtonGroup/index.js

@@ -0,0 +1,66 @@
+'use strict';
+
+var chunkRFFO4KPM_js = require('../../chunk-RFFO4KPM.js');
+var chunkY3GT7ETK_js = require('../../chunk-Y3GT7ETK.js');
+require('../../chunk-VIREG536.js');
+
+
+
+Object.defineProperty(exports, "ButtonGroup", {
+  enumerable: true,
+  get: function () { return chunkRFFO4KPM_js.ButtonGroup; }
+});
+Object.defineProperty(exports, "ButtonGroupPropsSchema", {
+  enumerable: true,
+  get: function () { return chunkRFFO4KPM_js.ButtonGroupPropsSchema; }
+});
+Object.defineProperty(exports, "ButtonGroupSeparator", {
+  enumerable: true,
+  get: function () { return chunkRFFO4KPM_js.ButtonGroupSeparator; }
+});
+Object.defineProperty(exports, "ButtonGroupSeparatorPropsSchema", {
+  enumerable: true,
+  get: function () { return chunkRFFO4KPM_js.ButtonGroupSeparatorPropsSchema; }
+});
+Object.defineProperty(exports, "filterButtonChildren", {
+  enumerable: true,
+  get: function () { return chunkRFFO4KPM_js.filterButtonChildren; }
+});
+Object.defineProperty(exports, "getButtonIndex", {
+  enumerable: true,
+  get: function () { return chunkRFFO4KPM_js.getButtonIndex; }
+});
+Object.defineProperty(exports, "getPosition", {
+  enumerable: true,
+  get: function () { return chunkRFFO4KPM_js.getPosition; }
+});
+Object.defineProperty(exports, "isButtonElement", {
+  enumerable: true,
+  get: function () { return chunkRFFO4KPM_js.isButtonElement; }
+});
+Object.defineProperty(exports, "isSeparatorElement", {
+  enumerable: true,
+  get: function () { return chunkRFFO4KPM_js.isSeparatorElement; }
+});
+Object.defineProperty(exports, "buttonGroupItemVariants", {
+  enumerable: true,
+  get: function () { return chunkY3GT7ETK_js.buttonGroupItemVariants; }
+});
+Object.defineProperty(exports, "buttonGroupSeparatorVariants", {
+  enumerable: true,
+  get: function () { return chunkY3GT7ETK_js.buttonGroupSeparatorVariants; }
+});
+Object.defineProperty(exports, "buttonGroupVariants", {
+  enumerable: true,
+  get: function () { return chunkY3GT7ETK_js.buttonGroupVariants; }
+});
+Object.defineProperty(exports, "useButtonGroupContext", {
+  enumerable: true,
+  get: function () { return chunkY3GT7ETK_js.useButtonGroupContext; }
+});
+Object.defineProperty(exports, "useButtonGroupItemContext", {
+  enumerable: true,
+  get: function () { return chunkY3GT7ETK_js.useButtonGroupItemContext; }
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/elements/ButtonGroup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/elements/ButtonGroup/index.mjs

@@ -0,0 +1,5 @@
+export { ButtonGroup, ButtonGroupPropsSchema, ButtonGroupSeparator, ButtonGroupSeparatorPropsSchema, filterButtonChildren, getButtonIndex, getPosition, isButtonElement, isSeparatorElement } from '../../chunk-I3AUTOMZ.mjs';
+export { buttonGroupItemVariants, buttonGroupSeparatorVariants, buttonGroupVariants, useButtonGroupContext, useButtonGroupItemContext } from '../../chunk-FPKEAJRZ.mjs';
+import '../../chunk-E2KQFV3O.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map