@proyecto-viviana/solidaria-components 0.3.2 → 0.4.0

package/dist/Checkbox.d.ts

@@ -4,7 +4,7 @@
  * Pre-wired headless checkbox components that combine state + aria hooks.
  * Port of react-aria-components/src/Checkbox.tsx
  */
-import { type JSX } from "solid-js";
+import { type JSX, type Context } from "solid-js";
 import { type AriaCheckboxProps, type AriaCheckboxGroupProps } from "@proyecto-viviana/solidaria";
 import { type CheckboxGroupState } from "@proyecto-viviana/solid-stately";
 import { type RenderChildren, type ClassNameOrFunction, type StyleOrFunction, type SlotProps } from "./utils";
@@ -54,6 +54,17 @@ export interface CheckboxGroupProps extends Omit<AriaCheckboxGroupProps, "childr
     style?: StyleOrFunction<CheckboxGroupRenderProps>;
     /** Ref for the checkbox group root element. */
     ref?: RefLike<HTMLDivElement>;
+    /**
+     * Whether this component renders its own description/error-message elements.
+     * A styled layer (e.g. solid-spectrum) that renders its own HelpText via a
+     * `<Text slot>` sets this to `false`: the wiring stays here — the single source
+     * of truth that mints the description/error ids and threads them onto the group
+     * and every item's `aria-describedby` — while the visible node is owned by the
+     * styled layer. Mirrors RAC, where the group provides a `TextContext` slot and
+     * never renders its own description node.
+     * @default true
+     */
+    renderHelpText?: boolean;
 }
 export interface CheckboxProps extends Omit<AriaCheckboxProps, "children">, SlotProps {
     /** The children of the component. A function may be provided to receive render props. */
@@ -81,12 +92,12 @@ export interface CheckboxProps extends Omit<AriaCheckboxProps, "children">, Slot
     /** Handler called when hover state changes. */
     onHoverChange?: (isHovered: boolean) => void;
 }
-export declare const CheckboxGroupContext: import("solid-js").Context<CheckboxGroupProps | null>;
-export declare const CheckboxGroupStateContext: import("solid-js").Context<CheckboxGroupState | null>;
+export declare const CheckboxGroupContext: Context<CheckboxGroupProps | null>;
+export declare const CheckboxGroupStateContext: Context<CheckboxGroupState | null>;
 export interface CheckboxContextValue extends CheckboxProps {
     slots?: Record<string, CheckboxProps>;
 }
-export declare const CheckboxContext: import("solid-js").Context<CheckboxContextValue | null>;
+export declare const CheckboxContext: Context<CheckboxContextValue | null>;
 /**
  * A checkbox group allows a user to select multiple items from a list of options.
  *
@@ -118,5 +129,73 @@ export declare function CheckboxGroup(props: CheckboxGroupProps): JSX.Element;
  * ```
  */
 export declare function Checkbox(props: CheckboxProps): JSX.Element;
+export interface CheckboxFieldRenderProps {
+    /** Whether the checkbox is selected. */
+    isSelected: boolean;
+    /** Whether the checkbox is indeterminate. */
+    isIndeterminate: boolean;
+    /** Whether the checkbox is disabled. */
+    isDisabled: boolean;
+    /** Whether the checkbox is read only. */
+    isReadOnly: boolean;
+    /** Whether the checkbox is invalid. */
+    isInvalid: boolean;
+    /** Whether the checkbox is required. */
+    isRequired: boolean;
+}
+export interface CheckboxButtonRenderProps extends CheckboxRenderProps {
+}
+export interface CheckboxFieldProps extends Omit<AriaCheckboxProps, "children" | "validationState">, SlotProps {
+    /** The children of the component (typically a `CheckboxButton`). A function may receive render props. */
+    children?: RenderChildren<CheckboxFieldRenderProps>;
+    /** The CSS className for the element. */
+    class?: ClassNameOrFunction<CheckboxFieldRenderProps>;
+    /** The inline style for the element. */
+    style?: StyleOrFunction<CheckboxFieldRenderProps>;
+    /** Whether the checkbox is indeterminate. */
+    isIndeterminate?: boolean;
+    /** Ref for the checkbox field root element. */
+    ref?: RefLike<HTMLDivElement>;
+    /** Ref for the underlying input element. */
+    inputRef?: RefLike<HTMLInputElement>;
+}
+export interface CheckboxButtonProps extends SlotProps {
+    /** The children of the component. A function may receive render props. */
+    children?: RenderChildren<CheckboxButtonRenderProps>;
+    /** The CSS className for the element. */
+    class?: ClassNameOrFunction<CheckboxButtonRenderProps>;
+    /** The inline style for the element. */
+    style?: StyleOrFunction<CheckboxButtonRenderProps>;
+    /** Ref for the outer label element. */
+    ref?: RefLike<HTMLLabelElement>;
+    /** Handler called when hover starts. */
+    onHoverStart?: () => void;
+    /** Handler called when hover ends. */
+    onHoverEnd?: () => void;
+    /** Handler called when hover state changes. */
+    onHoverChange?: (isHovered: boolean) => void;
+}
+export interface CheckboxFieldContextValue extends CheckboxFieldProps {
+    slots?: Record<string, CheckboxFieldProps>;
+}
+export declare const CheckboxFieldContext: Context<CheckboxFieldContextValue | null>;
+/**
+ * A checkbox allows a user to select an item, with support for validation and help text.
+ * Wraps a `CheckboxButton` and provides description/error wiring.
+ *
+ * @example
+ * ```tsx
+ * <CheckboxField>
+ *   <CheckboxButton>Accept terms</CheckboxButton>
+ *   <Text slot="description">Required to continue</Text>
+ * </CheckboxField>
+ * ```
+ */
+export declare function CheckboxField(props: CheckboxFieldProps): JSX.Element;
+/**
+ * A checkbox button is the clickable area of a checkbox, including the indicator and label.
+ * Must be rendered inside a `CheckboxField` (or the legacy `Checkbox`).
+ */
+export declare function CheckboxButton(props: CheckboxButtonProps): JSX.Element;
 export {};
 //# sourceMappingURL=Checkbox.d.ts.map

package/dist/Checkbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Checkbox.d.ts","sourceRoot":"","sources":["../src/Checkbox.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Checkbox.d.ts","sourceRoot":"","sources":["../src/Checkbox.tsx"],"names":[],"mappings":"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"}