@boreal-ui/types 0.0.9012-alpha.0

package/dist/types/components/Typography/Typography.types.d.ts

@@ -0,0 +1,142 @@
+import { AriaRole, CSSProperties, ElementType, ReactNode } from "react";
+export type TypographyVariant = "display" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "body-lg" | "body" | "body-sm" | "label" | "caption" | "overline" | "code";
+export type TypographyAlign = "left" | "center" | "right" | "inherit";
+export type TypographyWeight = "light" | "normal" | "medium" | "bold" | "bolder" | "inherit";
+export type TypographyTheme = "primary" | "secondary" | "tertiary" | "quaternary" | "clear" | "success" | "warning" | "error" | "inherit";
+export interface TypographyProps {
+    /**
+     * The content to render inside the typography component.
+     */
+    children?: ReactNode;
+    /**
+     * Predefined typography style variant.
+     * Examples may include headings, body text, captions, or labels.
+     *
+     * @default "body"
+     */
+    variant?: TypographyVariant;
+    /**
+     * The HTML element or custom component to render as.
+     * For example: `"p"`, `"span"`, `"h1"`, or a custom React component.
+     */
+    as?: ElementType;
+    /**
+     * Horizontal text alignment.
+     *
+     * @default "inherit"
+     */
+    align?: TypographyAlign;
+    /**
+     * Font weight of the text.
+     *
+     * @default "inherit"
+     */
+    weight?: TypographyWeight;
+    /**
+     * Visual theme style applied to the typography.
+     *
+     * @default "inherit"
+     */
+    theme?: TypographyTheme;
+    /**
+     * Applies a compact translucent frosted-glass treatment around the text.
+     *
+     * @default configured default glass setting (fallback: false)
+     */
+    glass?: boolean;
+    /**
+     * Whether the text should be displayed in italic style.
+     *
+     * @default false
+     */
+    italic?: boolean;
+    /**
+     * Whether the text should be underlined.
+     *
+     * @default false
+     */
+    underline?: boolean;
+    /**
+     * Whether overflowing text should be truncated, typically with an ellipsis.
+     *
+     * @default false
+     */
+    truncate?: boolean;
+    /**
+     * Whether the text should remain on a single line without wrapping.
+     *
+     * @default false
+     */
+    noWrap?: boolean;
+    /**
+     * Whether the text should be visually hidden but still available to screen readers.
+     *
+     * @default false
+     */
+    srOnly?: boolean;
+    /**
+     * Optional custom CSS class name for the root element.
+     */
+    className?: string;
+    /**
+     * Optional inline styles applied to the root element.
+     */
+    style?: CSSProperties;
+    /**
+     * Optional unique id for the root element.
+     */
+    id?: string;
+    /**
+     * Advisory text for the element, typically shown as a tooltip on hover.
+     */
+    title?: string;
+    /**
+     * Optional test id used for testing the component.
+     */
+    testId?: string;
+    /** Backward-compatible alias for test ID attributes. */
+    "data-testid"?: string;
+    /**
+     * Optional ARIA role for the rendered element.
+     */
+    role?: AriaRole;
+    /**
+     * Defines an accessible label for the element when a visible label is not sufficient.
+     */
+    "aria-label"?: string;
+    /**
+     * References the id of another element that labels this element.
+     */
+    "aria-labelledby"?: string;
+    /**
+     * References the id of another element that describes this element.
+     */
+    "aria-describedby"?: string;
+    /**
+     * Whether the element should be hidden from assistive technologies.
+     */
+    "aria-hidden"?: boolean;
+    /**
+     * Indicates that the element will be updated and describes how updates should be announced.
+     */
+    "aria-live"?: "off" | "polite" | "assertive";
+    /**
+     * Whether assistive technologies should present the entire updated region
+     * when part of a live region changes.
+     */
+    "aria-atomic"?: boolean;
+    /**
+     * Indicates whether the element is currently being updated, such as during loading.
+     */
+    "aria-busy"?: boolean;
+}
+export interface TypographyBaseProps extends TypographyProps {
+    /**
+     * Framework-specific class name map supplied by the core or Next wrapper.
+     */
+    classMap: Record<string, string>;
+    /**
+     * Combine Class Names callback used by the component.
+     */
+    combineClassNames: (...classes: Array<string | false | null | undefined>) => string;
+}

package/dist/types/components/Typography/Typography.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Typography.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Typography/Typography.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGxE,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,SAAS,GACT,MAAM,GACN,SAAS,GACT,OAAO,GACP,SAAS,GACT,UAAU,GACV,MAAM,CAAC;AAGX,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAGtE,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,SAAS,CAAC;AAGd,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,WAAW,GACX,UAAU,GACV,YAAY,GACZ,OAAO,GACP,SAAS,GACT,SAAS,GACT,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAE5B;;;OAGG;IACH,EAAE,CAAC,EAAE,WAAW,CAAC;IAEjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IAExB;;;;OAIG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAE1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IAExB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAEhB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;IAE7C;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;OAEG;IACH,iBAAiB,EAAE,CACjB,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,KACjD,MAAM,CAAC;CACb"}

package/dist/types/components/Typography/TypographyBase.d.ts

@@ -0,0 +1,7 @@
+import { JSX } from "react";
+import { TypographyBaseProps } from "./Typography.types";
+declare function TypographyBase({ children, variant, as, align, weight, theme, glass, italic, underline, truncate, noWrap, srOnly, className, style, id, title, testId, "data-testid": dataTestId, role, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, "aria-hidden": ariaHidden, "aria-live": ariaLive, "aria-atomic": ariaAtomic, "aria-busy": ariaBusy, classMap, combineClassNames, }: TypographyBaseProps): JSX.Element;
+declare namespace TypographyBase {
+    var displayName: string;
+}
+export default TypographyBase;

package/dist/types/components/Typography/TypographyBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypographyBase.d.ts","sourceRoot":"","sources":["../../../../src/components/Typography/TypographyBase.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,GAAG,EAAW,MAAM,OAAO,CAAC;AAEpD,OAAO,EAEL,mBAAmB,EAIpB,MAAM,oBAAoB,CAAC;AAmE5B,iBAAS,cAAc,CAAC,EACtB,QAAQ,EACR,OAAgB,EAChB,EAAE,EACF,KAAiB,EACjB,MAAkB,EAClB,KAAiB,EACjB,KAAyB,EACzB,MAAc,EACd,SAAiB,EACjB,QAAgB,EAChB,MAAc,EACd,MAAc,EACd,SAAS,EACT,KAAK,EACL,EAAE,EACF,KAAK,EACL,MAAM,EACN,aAAa,EAAE,UAAU,EACzB,IAAI,EACJ,YAAY,EAAE,SAAS,EACvB,iBAAiB,EAAE,cAAc,EACjC,kBAAkB,EAAE,eAAe,EACnC,aAAa,EAAE,UAAU,EACzB,WAAW,EAAE,QAAQ,EACrB,aAAa,EAAE,UAAU,EACzB,WAAW,EAAE,QAAQ,EACrB,QAAQ,EACR,iBAAiB,GAClB,EAAE,mBAAmB,GAAG,GAAG,CAAC,OAAO,CAwDnC;kBArFQ,cAAc;;;AAwFvB,eAAe,cAAc,CAAC"}

package/dist/types/components/Typography/core/Typography.d.ts

@@ -0,0 +1,3 @@
+import { JSX } from "react";
+import { TypographyProps } from "../Typography.types";
+export default function Typography(props: TypographyProps): JSX.Element;

package/dist/types/components/Typography/core/Typography.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Typography.d.ts","sourceRoot":"","sources":["../../../../../src/components/Typography/core/Typography.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,mBAAmB,CAAC;AA6C3B,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,CAQtE"}

package/dist/types/components/Typography/next/Typography.d.ts

@@ -0,0 +1,3 @@
+import { JSX } from "react";
+import { TypographyProps } from "../Typography.types";
+export default function Typography(props: TypographyProps): JSX.Element;

package/dist/types/components/Typography/next/Typography.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Typography.d.ts","sourceRoot":"","sources":["../../../../../src/components/Typography/next/Typography.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAItD,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,CAQtE"}

package/dist/types/components/ValidationSummary/ValidationSummary.types.d.ts

@@ -0,0 +1,239 @@
+import { ForwardRefExoticComponent, HTMLAttributes, ReactElement, ReactNode, RefAttributes } from "react";
+import { LabelPositionType, RoundingType, ShadowType, StateType, ThemeType } from "../../types/types";
+type NativeValidationSummaryProps = Omit<HTMLAttributes<HTMLDivElement>, "title">;
+/**
+ * Single validation issue rendered by the ValidationSummary component.
+ */
+export interface ValidationSummaryItem {
+    /**
+     * Stable item identifier used for React keys and test IDs.
+     */
+    id?: string;
+    /**
+     * Human-readable validation message.
+     */
+    message: ReactNode;
+    /**
+     * Optional form field id this issue points to.
+     */
+    fieldId?: string;
+    /**
+     * Optional href used when the issue should link to a field or route.
+     */
+    href?: string;
+}
+/**
+ * Props for the ValidationSummary component.
+ */
+export interface ValidationSummaryProps extends NativeValidationSummaryProps {
+    /**
+     * Main content rendered inside the component after the generated validation list.
+     */
+    children?: ReactNode;
+    /**
+     * Validation items rendered in the summary list.
+     */
+    items?: Array<ValidationSummaryItem | string>;
+    /**
+     * Optional icon rendered before the summary title.
+     * Accepts Font Awesome icons, SVG elements, or custom React elements.
+     */
+    icon?: ReactElement;
+    /**
+     * Accessible label for the icon when it communicates meaning.
+     * If omitted, the icon is treated as decorative.
+     */
+    iconAriaLabel?: string;
+    /**
+     * Additional class name for the title/icon header row.
+     */
+    headerClassName?: string;
+    /**
+     * Additional class name for the icon wrapper.
+     */
+    iconClassName?: string;
+    /**
+     * Optional visible label for the component.
+     */
+    label?: ReactNode;
+    /**
+     * Summary heading rendered inside the alert.
+     *
+     * @default label ?? "There is a problem"
+     */
+    title?: ReactNode;
+    /**
+     * Supporting text rendered beneath the title.
+     */
+    description?: ReactNode;
+    /**
+     * Position of the label relative to the component.
+     *
+     * @default "top"
+     */
+    labelPosition?: LabelPositionType;
+    /**
+     * Heading element used for the summary title.
+     *
+     * @default "h2"
+     */
+    titleAs?: "h2" | "h3" | "h4" | "h5" | "h6";
+    /**
+     * Role applied to the validation summary root.
+     *
+     * @default "alert"
+     */
+    role?: "alert" | "status" | "region";
+    /**
+     * Whether the summary should be focusable for programmatic focus.
+     *
+     * @default true
+     */
+    focusable?: boolean;
+    /**
+     * Whether the summary should focus itself when validation items are present.
+     *
+     * @default false
+     */
+    focusOnMount?: boolean;
+    /**
+     * Whether nothing should render when there are no items and no children.
+     *
+     * @default true
+     */
+    hideWhenEmpty?: boolean;
+    /**
+     * Message rendered when there are no validation items and hideWhenEmpty is false.
+     */
+    emptyMessage?: ReactNode;
+    /**
+     * Accessible label for the validation issue list.
+     *
+     * @default "Validation issues"
+     */
+    listLabel?: string;
+    /**
+     * Callback fired when a validation issue is selected.
+     */
+    onItemClick?: (item: ValidationSummaryItem, index: number) => void;
+    /**
+     * Theme used for styling.
+     *
+     * @default configured default theme (fallback: "primary")
+     */
+    theme?: ThemeType;
+    /**
+     * Visual state for styling.
+     *
+     * @default "error"
+     */
+    state?: StateType;
+    /**
+     * Whether to render outlined styling.
+     *
+     * @default configured default outline setting (fallback: false)
+     */
+    outline?: boolean;
+    /**
+     * Whether to render glass styling.
+     *
+     * @default configured default glass setting (fallback: false)
+     */
+    glass?: boolean;
+    /**
+     * Rounding style for the component.
+     *
+     * @default configured default rounding (fallback: "medium")
+     */
+    rounding?: RoundingType;
+    /**
+     * Shadow style for the component.
+     *
+     * @default configured default shadow (fallback: "light")
+     */
+    shadow?: ShadowType;
+    /**
+     * Whether the component is disabled.
+     *
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Whether the component should display a loading state.
+     *
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * Accessible loading message rendered while loading is true.
+     *
+     * @default "Checking validation"
+     */
+    loadingMessage?: ReactNode;
+    /**
+     * Additional class name for the component root.
+     */
+    className?: string;
+    /**
+     * Additional class name for the outer label/component container.
+     */
+    containerClassName?: string;
+    /**
+     * Additional class name for the visible label.
+     */
+    labelClassName?: string;
+    /**
+     * Additional class name for the title.
+     */
+    titleClassName?: string;
+    /**
+     * Additional class name for the description.
+     */
+    descriptionClassName?: string;
+    /**
+     * Additional class name for the list.
+     */
+    listClassName?: string;
+    /**
+     * Additional class name for each list item.
+     */
+    itemClassName?: string;
+    /**
+     * Additional class name for validation links.
+     */
+    linkClassName?: string;
+    /**
+     * Additional class name for the content area.
+     */
+    contentClassName?: string;
+    /**
+     * Additional class name for empty-state text.
+     */
+    emptyClassName?: string;
+    /**
+     * Optional content rendered for assistive technologies only.
+     */
+    srOnlyText?: ReactNode;
+    /**
+     * Additional class name for screen-reader-only content.
+     */
+    srOnlyClassName?: string;
+    /**
+     * Optional test ID for testing frameworks.
+     *
+     * @default dataTestId ?? "validation-summary"
+     */
+    testId?: string;
+    /**
+     * Backward-compatible alias for test ID attributes.
+     */
+    "data-testid"?: string;
+}
+export interface ValidationSummaryBaseProps extends ValidationSummaryProps {
+    /**
+     * Framework-specific class name map supplied by the core or Next wrapper.
+     */
+    classMap: Record<string, string>;
+}
+export type ValidationSummaryComponent = ForwardRefExoticComponent<ValidationSummaryProps & RefAttributes<HTMLDivElement>>;
+export {};

package/dist/types/components/ValidationSummary/ValidationSummary.types.d.ts.map

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

package/dist/types/components/ValidationSummary/ValidationSummaryBase.d.ts

@@ -0,0 +1,3 @@
+import { ValidationSummaryBaseProps } from "./ValidationSummary.types";
+declare const ValidationSummaryBase: import("react").ForwardRefExoticComponent<ValidationSummaryBaseProps & import("react").RefAttributes<HTMLDivElement>>;
+export default ValidationSummaryBase;

package/dist/types/components/ValidationSummary/ValidationSummaryBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationSummaryBase.d.ts","sourceRoot":"","sources":["../../../../src/components/ValidationSummary/ValidationSummaryBase.tsx"],"names":[],"mappings":"AASA,OAAO,EACL,0BAA0B,EAE3B,MAAM,2BAA2B,CAAC;AAiBnC,QAAA,MAAM,qBAAqB,uHA6S1B,CAAC;AAGF,eAAe,qBAAqB,CAAC"}

package/dist/types/components/ValidationSummary/core/ValidationSummary.d.ts

@@ -0,0 +1,3 @@
+import { ValidationSummaryProps } from "../ValidationSummary.types";
+declare const ValidationSummary: import("react").ForwardRefExoticComponent<ValidationSummaryProps & import("react").RefAttributes<HTMLDivElement>>;
+export default ValidationSummary;

package/dist/types/components/ValidationSummary/core/ValidationSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationSummary.d.ts","sourceRoot":"","sources":["../../../../../src/components/ValidationSummary/core/ValidationSummary.tsx"],"names":[],"mappings":"AAEA,OAAO,0BAA0B,CAAC;AAElC,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAwDpE,QAAA,MAAM,iBAAiB,mHAQtB,CAAC;AAGF,eAAe,iBAAiB,CAAC"}

package/dist/types/components/ValidationSummary/next/ValidationSummary.d.ts

@@ -0,0 +1,3 @@
+import { ValidationSummaryProps } from "../ValidationSummary.types";
+declare const ValidationSummary: import("react").ForwardRefExoticComponent<ValidationSummaryProps & import("react").RefAttributes<HTMLDivElement>>;
+export default ValidationSummary;

package/dist/types/components/ValidationSummary/next/ValidationSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationSummary.d.ts","sourceRoot":"","sources":["../../../../../src/components/ValidationSummary/next/ValidationSummary.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,QAAA,MAAM,iBAAiB,mHAQtB,CAAC;AAGF,eAAe,iBAAiB,CAAC"}

package/dist/types/config/boreal-style-config.d.ts

@@ -0,0 +1,101 @@
+/**
+ * ---------------------------------------------------------------------
+ * boreal-style-config.ts
+ * ---------------------------------------------------------------------
+ * Provides global configuration for default Boreal UI styles.
+ *
+ * Allows applications to override default values for:
+ * - Theme type (e.g., primary, secondary)
+ * - Component rounding
+ * - Shadow intensity
+ * - Default border width
+ * - Default size
+ * - Glass and outline variants
+ * - Default color scheme name
+ *
+ * These defaults are used when components are rendered without
+ * explicit props or style overrides.
+ *
+ * Usage:
+ * ```ts
+ * setBorealStyleConfig({
+ *   defaultTheme: "secondary",
+ *   defaultRounding: "large",
+ *   defaultShadow: "strong",
+ *   defaultBorderWidth: "sm",
+ *   defaultSize: "large",
+ *   defaultGlass: true,
+ *   defaultOutline: true,
+ *   defaultColorSchemeName: "Ocean Breeze",
+ * });
+ * ```
+ *
+ * Accessor functions ensure safe fallback to internal defaults.
+ */
+import { BorderType, RoundingType, ShadowType, SizeType, ThemeType } from "../types/types";
+/**
+ * Type for configuring global Boreal UI style defaults.
+ */
+export type BorealStyleConfig = {
+    defaultTheme: ThemeType;
+    defaultRounding: RoundingType;
+    defaultShadow: ShadowType;
+    defaultSize: SizeType;
+    defaultBorderWidth: BorderType;
+    defaultGlass: boolean;
+    defaultOutline: boolean;
+    defaultColorSchemeName: string;
+};
+/**
+ * Overrides the default Boreal UI styling configuration.
+ *
+ * @param {Partial<BorealStyleConfig>} config - A partial configuration object with any default values to override.
+ */
+export declare const setBorealStyleConfig: (config: Partial<BorealStyleConfig>) => void;
+/**
+ * Alias for a concise app-level setup API.
+ */
+export declare const borealConfig: (config: Partial<BorealStyleConfig>) => void;
+/**
+ * Gets the complete effective Boreal UI styling configuration.
+ */
+export declare const getBorealStyleConfig: () => BorealStyleConfig;
+/**
+ * Gets the default theme type (e.g., "primary", "secondary").
+ */
+export declare const getDefaultTheme: () => ThemeType;
+/**
+ * Gets the default component rounding type (e.g., "medium", "large").
+ */
+export declare const getDefaultRounding: () => RoundingType;
+/**
+ * Gets the default shadow depth (e.g., "light", "strong").
+ */
+export declare const getDefaultShadow: () => ShadowType;
+/**
+ * Resolves the class for component shadows while keeping the clear theme layout-first.
+ *
+ * Clear-themed components omit the configured default shadow, but still honor an
+ * explicit shadow prop from consumers.
+ */
+export declare const getShadowClassName: (classMap: Record<string, string>, theme: ThemeType, shadow?: ShadowType) => string | undefined;
+/**
+ * Gets the default component size (e.g., "small", "medium", "large").
+ */
+export declare const getDefaultSize: () => SizeType;
+/**
+ * Gets whether glass styling should be enabled by default.
+ */
+export declare const getDefaultGlass: () => boolean;
+/**
+ * Gets whether outline styling should be enabled by default.
+ */
+export declare const getDefaultOutline: () => boolean;
+/**
+ * Gets the default color scheme name (e.g., "Forest Dusk").
+ */
+export declare const getDefaultColorSchemeName: () => string;
+/**
+ * Gets the default border width (e.g., "none", "sm", "md", "lg").
+ */
+export declare const getDefaultBorder: () => BorderType;

package/dist/types/config/boreal-style-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boreal-style-config.d.ts","sourceRoot":"","sources":["../../../src/config/boreal-style-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,SAAS,EACV,MAAM,gBAAgB,CAAC;AAIxB;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,SAAS,CAAC;IACxB,eAAe,EAAE,YAAY,CAAC;IAC9B,aAAa,EAAE,UAAU,CAAC;IAC1B,WAAW,EAAE,QAAQ,CAAC;IACtB,kBAAkB,EAAE,UAAU,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAAC;AAeF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,OAAO,CAAC,iBAAiB,CAAC,SAEtE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,WAPoB,OAAO,CAAC,iBAAiB,CAAC,SAOvB,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAO,iBAItC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe,QAAO,SACkC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAO,YACkB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,UACgB,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,OAAO,SAAS,EAChB,SAAS,UAAU,KAClB,MAAM,GAAG,SAOX,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,QAAO,QACc,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,eAAe,QAAO,OACe,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,OACiB,CAAC;AAEvD;;GAEG;AAEH,eAAO,MAAM,yBAAyB,QAAO,MACyB,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,UAC0B,CAAC"}

package/dist/types/context/NextThemeProvider.d.ts

@@ -0,0 +1,2 @@
+import { ThemeProviderProps } from "./ThemeContext.types";
+export default function NextThemeProvider(props: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/context/NextThemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NextThemeProvider.d.ts","sourceRoot":"","sources":["../../../src/context/NextThemeProvider.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,2CAElE"}

package/dist/types/context/ThemeContext.d.ts

@@ -0,0 +1,6 @@
+import React from "react";
+import { ThemeContextType, ThemeProviderProps } from "./ThemeContext.types";
+export declare const ThemeContext: React.Context<ThemeContextType | undefined>;
+declare const ThemeProvider: React.FC<ThemeProviderProps>;
+export default ThemeProvider;
+export { getThemeInitializationScript } from "./themeRuntime";

package/dist/types/context/ThemeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeContext.d.ts","sourceRoot":"","sources":["../../../src/context/ThemeContext.tsx"],"names":[],"mappings":"AACA,OAAO,KAQN,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAc5E,eAAO,MAAM,YAAY,6CAExB,CAAC;AAKF,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAuM/C,CAAC;AAEF,eAAe,aAAa,CAAC;AAC7B,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/context/ThemeContext.types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * ---------------------------------------------------------------------
+ * ThemeContext.types.ts
+ * ---------------------------------------------------------------------
+ * Type definitions for the ThemeProvider and ThemeContext used
+ * in the Boreal UI theming system.
+ */
+import { ColorScheme } from "../types/types";
+import { ReactNode } from "react";
+/**
+ * Props for the `<ThemeProvider>` component.
+ *
+ * @property {ReactNode} children - The wrapped application or subtree.
+ * @property {ColorScheme[]} [customSchemes] - Optional array of custom color schemes
+ *                                             to be registered at runtime.
+ * @property {string} [initialSchemeName] - Optional name of the color scheme to be selected on initial load. If not provided, the provider will
+ *                                          attempt to use the saved scheme from localStorage or the default scheme.
+ * @property {boolean} [useOnlyCustomSchemes] - Optional flag to indicate if only custom schemes should be used, ignoring default schemes.
+ * @property {boolean} [enableThemeScript] - Optional flag to render the pre-hydration script that applies theme variables before React effects run.
+ *                                           Defaults to true for core and false for Next.
+ *
+ * @example
+ * <ThemeProvider customSchemes={[customTheme]}>
+ *   <App />
+ * </ThemeProvider>
+ */
+export interface ThemeProviderProps {
+    children: ReactNode;
+    customSchemes?: ColorScheme[];
+    enableThemeScript?: boolean;
+    initialSchemeName?: string;
+    useOnlyCustomSchemes?: boolean;
+}
+/**
+ * Context value provided by the ThemeProvider.
+ *
+ * @property {number} selectedScheme - Index of the currently active color scheme.
+ * @property {string} selectedSchemeName - Name of the currently active color scheme.
+ * @property {ColorScheme[]} schemes - Array of available color schemes.
+ * @property {Dispatch<SetStateAction<number>>} setSelectedScheme - Function to update the selected scheme index.
+ * @property {Dispatch<SetStateAction<string>>} setSelectedSchemeName - Function to update the selected scheme name.
+ *
+ * @example
+ * const { selectedSchemeName, setSelectedSchemeName } = useContext(ThemeContext);
+ */
+export interface ThemeContextType {
+    selectedScheme: number;
+    selectedSchemeName: string;
+    schemes: ColorScheme[];
+    setSelectedScheme: React.Dispatch<React.SetStateAction<number>>;
+    setSelectedSchemeName: React.Dispatch<React.SetStateAction<string>>;
+}

package/dist/types/context/ThemeContext.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeContext.types.d.ts","sourceRoot":"","sources":["../../../src/context/ThemeContext.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,iBAAiB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,qBAAqB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;CACrE"}

package/dist/types/context/themeRuntime.d.ts

@@ -0,0 +1,29 @@
+import { ColorScheme } from "../types/index";
+export declare const THEME_STORAGE_KEY = "boreal:selectedSchemeName";
+export declare const THEME_CHANGE_EVENT = "boreal:theme-change";
+export declare const MIN_TEXT_CONTRAST = 4.5;
+export declare const MIN_UI_CONTRAST = 3;
+export type ThemeVariableMap = Record<string, string>;
+export type ThemeResolutionOptions = {
+    customSchemes?: ColorScheme[];
+    initialSchemeName?: string;
+    savedSchemeName?: string | null;
+    useOnlyCustomSchemes?: boolean;
+};
+export declare function mergeSchemes(baseSchemes: ColorScheme[], customSchemes?: ColorScheme[]): ColorScheme[];
+export declare function getSchemeIndexByName(schemes: {
+    name: string;
+}[], name?: string | null): number;
+export declare function getAvailableSchemes({ customSchemes, useOnlyCustomSchemes, }: Pick<ThemeResolutionOptions, "customSchemes" | "useOnlyCustomSchemes">): ColorScheme[];
+export declare function resolveSchemeIndex(schemes: {
+    name: string;
+}[], { initialSchemeName, savedSchemeName, }: Pick<ThemeResolutionOptions, "initialSchemeName" | "savedSchemeName">): number;
+export declare function readSavedSchemeName(storage: Storage | undefined): string | null;
+export declare function writeSavedSchemeName(storage: Storage | undefined, schemeName: string): boolean;
+export declare function dispatchThemeChange(schemeName: string, windowRef?: Window | undefined): void;
+export declare function relativeLuminance(hex: string): number;
+export declare function contrastRatio(a: string, b: string): number;
+export declare function buildThemeVariables(scheme: ColorScheme): ThemeVariableMap;
+export declare function applyThemeVariables(targetStyle: CSSStyleDeclaration, vars: ThemeVariableMap): void;
+export declare function applyThemeScheme(scheme: ColorScheme, documentRef?: Document): void;
+export declare function getThemeInitializationScript({ customSchemes, initialSchemeName, useOnlyCustomSchemes, }?: Omit<ThemeResolutionOptions, "savedSchemeName">): string;