baseline-kit 5.0.0 → 5.1.0

package/dist/core/src/config/schema.d.ts

@@ -1,33 +0,0 @@
-import type { GuideVariant, BaselineVariant, Variant, DebuggingMode } from '../types';
-type DebugColors = {
-    line: string;
-    flat: string;
-    text: string;
-};
-export type ConfigSchema = {
-    base: number;
-    baseline: {
-        variant: BaselineVariant;
-        debugging: DebuggingMode;
-        colors: Record<BaselineVariant, string>;
-    };
-    guide: {
-        variant: GuideVariant;
-        debugging: DebuggingMode;
-        colors: Record<GuideVariant, string>;
-    };
-    spacer: {
-        variant: Variant;
-        debugging: DebuggingMode;
-        colors: DebugColors;
-    };
-    box: {
-        debugging: DebuggingMode;
-        colors: DebugColors;
-    };
-    padder: {
-        debugging: DebuggingMode;
-        color: string;
-    };
-};
-export {};

package/dist/core/src/descriptors/baseline.d.ts

@@ -1,26 +0,0 @@
-import type { BaselineVariant } from '../types';
-export interface BaselineDescriptorParams {
-    base: number;
-    colors: Record<BaselineVariant, string>;
-    variant: BaselineVariant;
-    width?: number | string;
-    height?: number | string;
-    color?: string;
-    containerWidth: number;
-    containerHeight: number;
-    spacing: Record<string, unknown>;
-    isVisible: boolean;
-}
-export interface BaselineDescriptor {
-    containerStyle: Record<string, string>;
-    rowCount: number;
-    getRowStyle: (index: number) => Record<string, string>;
-    padding: string | undefined;
-    isVisible: boolean;
-    classTokens: string[];
-}
-/**
- * Computes all styles and data needed to render a Baseline component.
- * Pure function — framework-agnostic.
- */
-export declare function createBaselineDescriptor(params: BaselineDescriptorParams): BaselineDescriptor;

package/dist/core/src/descriptors/box.d.ts

@@ -1,20 +0,0 @@
-export interface BoxDescriptorParams {
-    base: number;
-    lineColor: string;
-    width?: number | string;
-    height?: number | string;
-    span?: number;
-    colSpan?: number;
-    rowSpan?: number;
-    isVisible: boolean;
-}
-export interface BoxDescriptor {
-    boxStyle: Record<string, string>;
-    gridSpanStyle: Record<string, string>;
-    classTokens: string[];
-}
-/**
- * Computes styles needed to render a Box component.
- * Pure function — framework-agnostic.
- */
-export declare function createBoxDescriptor(params: BoxDescriptorParams): BoxDescriptor;

package/dist/core/src/descriptors/guide.d.ts

@@ -1,44 +0,0 @@
-import type { GuideVariant, GuideConfig } from '../types';
-export interface GuideDescriptorParams {
-    base: number;
-    colors: Record<GuideVariant, string>;
-    variant: GuideVariant;
-    align: string;
-    width?: number | string;
-    height?: number | string;
-    columnWidth?: number | string;
-    maxWidth?: number | string;
-    color?: string;
-    /** Pre-computed guide template result (from useGuide or calculateGuideTemplate) */
-    template: string;
-    columnsCount: number;
-    calculatedGap: number;
-    isVisible: boolean;
-}
-export interface GuideDescriptor {
-    containerStyle: Record<string, string>;
-    columnColor: string;
-    columnsCount: number;
-    calculatedGap: number;
-    template: string;
-    isVisible: boolean;
-    isLineVariant: boolean;
-    classTokens: string[];
-}
-export interface GuideConfigParams {
-    variant: GuideVariant;
-    base: number;
-    gap: number;
-    columns?: number | readonly (string | number | undefined | 'auto')[];
-    columnWidth?: number | string;
-}
-/**
- * Creates a GuideConfig from component props.
- * Pure function — no React or DOM dependency.
- */
-export declare function createGuideConfig({ variant, base, gap, columns, columnWidth, }: GuideConfigParams): GuideConfig;
-/**
- * Computes all styles and data needed to render a Guide component.
- * Pure function — framework-agnostic.
- */
-export declare function createGuideDescriptor(params: GuideDescriptorParams): GuideDescriptor;

package/dist/core/src/descriptors/index.d.ts

@@ -1,5 +0,0 @@
-export * from './guide';
-export * from './baseline';
-export * from './box';
-export * from './spacer';
-export * from './padder';

package/dist/core/src/descriptors/padder.d.ts

@@ -1,19 +0,0 @@
-import type { Padding } from '../types';
-export interface PadderDescriptorParams {
-    base: number;
-    color: string;
-    width?: number | string;
-    height?: number | string;
-    padding: Padding;
-    enableSpacers: boolean;
-    isVisible: boolean;
-}
-export interface PadderDescriptor {
-    containerStyle: Record<string, string>;
-    classTokens: string[];
-}
-/**
- * Computes styles needed to render a Padder component.
- * Pure function — framework-agnostic.
- */
-export declare function createPadderDescriptor(params: PadderDescriptorParams): PadderDescriptor;

package/dist/core/src/descriptors/spacer.d.ts

@@ -1,24 +0,0 @@
-export interface SpacerDescriptorParams {
-    base: number;
-    colors: {
-        line: string;
-        flat: string;
-        text: string;
-    };
-    width?: number | string;
-    height?: number | string;
-    color?: string;
-    variant: string;
-    isVisible: boolean;
-}
-export interface SpacerDescriptor {
-    style: Record<string, string>;
-    normWidth: number;
-    normHeight: number;
-    classTokens: string[];
-}
-/**
- * Computes styles needed to render a Spacer component.
- * Pure function — framework-agnostic.
- */
-export declare function createSpacerDescriptor(params: SpacerDescriptorParams): SpacerDescriptor;

package/dist/core/src/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * @baseline-kit/core
- * Pure TypeScript core: types, utilities, config, validation, and descriptors
- * Zero dependencies — works in any JavaScript runtime
- */
-export * from './types';
-export * from './config';
-export * from './utils';
-export * from './validation';
-export * from './descriptors';

package/dist/core/src/types.d.ts

@@ -1,62 +0,0 @@
-/**
- * @baseline-kit/core - Pure type definitions
- * Framework-agnostic types for the baseline-kit system
- */
-export type Spacing = number | [number, number] | {
-    start?: number;
-    end?: number;
-};
-export type PaddingValue = number | [number, number] | [number, number, number] | [number, number, number, number] | {
-    top?: number;
-    bottom?: number;
-    left?: number;
-    right?: number;
-};
-export type Padding = {
-    top: number;
-    right: number;
-    bottom: number;
-    left: number;
-};
-export type SpacingProps = {
-    padding?: PaddingValue;
-    block?: Spacing;
-    inline?: Spacing;
-};
-export type GuideVariant = 'line' | 'pattern' | 'fixed' | 'auto';
-export type GuideColumnValue = string | number | undefined | 'auto';
-export type GuideColumnsPattern = readonly GuideColumnValue[];
-export declare const GRID_ALIGNMENTS: readonly ["start", "center", "end"];
-export type GridAlignment = (typeof GRID_ALIGNMENTS)[number];
-export declare const PADD_VARIANTS: readonly ["line", "flat"];
-export type PaddedVariant = (typeof PADD_VARIANTS)[number];
-export type Variant = 'line' | 'flat' | 'pattern';
-export type BaselineVariant = Exclude<Variant, 'pattern'>;
-export type SnappingMode = 'none' | 'height' | 'clamp';
-export type DebuggingMode = 'none' | 'hidden' | 'visible';
-type BaseGuideConfig = {
-    gap?: number | string;
-    base?: number;
-};
-export type PatternConfig = BaseGuideConfig & {
-    variant: 'pattern';
-    columns: GuideColumnsPattern;
-    columnWidth?: never;
-};
-export type FixedConfig = BaseGuideConfig & {
-    variant: 'fixed';
-    columns: number;
-    columnWidth?: number | string;
-};
-export type AutoConfig = BaseGuideConfig & {
-    variant: 'auto';
-    columnWidth: number | string;
-    columns?: never;
-};
-export type LineConfig = BaseGuideConfig & {
-    variant?: 'line';
-    columns?: never;
-    columnWidth?: never;
-};
-export type GuideConfig = PatternConfig | AutoConfig | FixedConfig | LineConfig;
-export {};

package/dist/core/src/utils/convert.d.ts

@@ -1,10 +0,0 @@
-export interface ConversionContext {
-    parentSize?: number;
-    viewportWidth?: number;
-    viewportHeight?: number;
-    rootFontSize?: number;
-    parentFontSize?: number;
-}
-export declare const ABSOLUTE_UNIT_CONVERSIONS: Record<string, number>;
-export declare const RELATIVE_UNITS: string[];
-export declare function convertValue(value: number | string | undefined, context?: ConversionContext): number | null;

package/dist/core/src/utils/grid.d.ts

@@ -1,18 +0,0 @@
-import type { GuideConfig } from '../types';
-import { type ConversionContext } from './convert';
-export interface GuideResult {
-    template: string;
-    columnsCount: number;
-    calculatedGap: number;
-    isValid: boolean;
-}
-/**
- * Pure calculation of grid template from container width and guide config.
- * Framework-agnostic — can be used outside React.
- *
- * Sizing note: the `line` variant still reports the number of pixel tracks as
- * metadata, but React renders line guides with a CSS gradient so dense grids do
- * not allocate one DOM node per line.
- */
-export declare function calculateGuideTemplate(width: number, config: GuideConfig, context?: ConversionContext): GuideResult;
-export declare const createGridSpanStyles: (span?: number, colSpan?: number, rowSpan?: number) => Record<string, string>;

package/dist/core/src/utils/index.d.ts

@@ -1,8 +0,0 @@
-export * from './parse';
-export * from './convert';
-export * from './math';
-export * from './normalize';
-export * from './padding';
-export * from './snapping';
-export * from './merge';
-export * from './grid';

package/dist/core/src/utils/math.d.ts

@@ -1,9 +0,0 @@
-export declare function clamp(value: number, min: number, max: number): number;
-type RowCountParams = {
-    height?: number;
-    top: number;
-    bottom: number;
-    base: number;
-};
-export declare function calculateRowCount(params: RowCountParams): number;
-export {};

package/dist/core/src/utils/merge.d.ts

@@ -1,28 +0,0 @@
-import type { DebuggingMode } from '../types';
-/**
- * Combines class names, filtering out falsy values.
- * Lightweight alternative to clsx/classnames.
- */
-export declare const cx: (...classes: Array<string | boolean | undefined | null>) => string;
-/**
- * Resolves component debug/visibility state from prop and config.
- * Pure function — framework-agnostic.
- */
-export interface DebugState {
-    isShown: boolean;
-    isHidden: boolean;
-    isNone: boolean;
-    debugging: DebuggingMode | undefined;
-}
-export declare function resolveDebugState(debuggingProp?: DebuggingMode, debuggingConfig?: DebuggingMode): DebugState;
-export type StyleOverrideParams = {
-    key: string;
-    value: string;
-    defaultStyles: Record<string, string>;
-    skipDimensions?: {
-        fitContent?: string[];
-        auto?: string[];
-        fullSize?: string[];
-    };
-};
-export declare function createStyleOverride(params: StyleOverrideParams | string, value?: string, defaultStyles?: Record<string, string>): Record<string, string>;

package/dist/core/src/utils/normalize.d.ts

@@ -1,13 +0,0 @@
-import { type ConversionContext } from './convert';
-export interface NormalizationOptions {
-    base?: number;
-    round?: boolean;
-    clamp?: {
-        min?: number;
-        max?: number;
-    };
-    suppressWarnings?: boolean;
-    context?: ConversionContext;
-}
-export declare function normalizeValue(value: string | number | undefined, options?: NormalizationOptions): number;
-export declare function normalizeValuePair(values: [string | number | undefined, string | number | undefined] | undefined, defaults: [number, number], options?: NormalizationOptions): [number, number];

package/dist/core/src/utils/padding.d.ts

@@ -1,2 +0,0 @@
-import type { Padding, SpacingProps } from '../types';
-export declare function parsePadding(spacing: SpacingProps): Padding;

package/dist/core/src/utils/parse.d.ts

@@ -1,5 +0,0 @@
-export declare function parseUnit(value: string): {
-    value: number;
-    unit: string;
-} | null;
-export declare function formatValue(value: string | number | undefined, defaultValue?: number): string;

package/dist/core/src/utils/snapping.d.ts

@@ -1,2 +0,0 @@
-import type { SnappingMode, Padding, PaddingValue } from '../types';
-export declare function calculateSnappedSpacing(height: number, base: number, initial: PaddingValue, snapping: SnappingMode): Padding;

package/dist/core/src/validation/guide.d.ts

@@ -1,3 +0,0 @@
-import type { GuideColumnsPattern, GuideColumnValue } from '../types';
-export declare const isValidGuideColumnValue: (value: unknown) => value is GuideColumnValue;
-export declare const isValidGuidePattern: (pattern: unknown) => pattern is GuideColumnsPattern;

package/dist/core/src/validation/index.d.ts

@@ -1 +0,0 @@
-export * from './guide';

package/dist/dom/src/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * @baseline-kit/dom
- * DOM utilities: timing, SSR detection, observers, and browser APIs
- * Depends on @baseline-kit/core
- */
-export * from './timing';
-export * from './ssr';
-export * from './measure';
-export * from './virtual';
-export * from './observers';
-export * from './viewport';

package/dist/dom/src/measure.d.ts

@@ -1,18 +0,0 @@
-/**
- * Element measurement observer.
- */
-export interface MeasureRect {
-    width: number;
-    height: number;
-}
-export interface MeasureObserverHandle {
-    /** Force an immediate re-measure */
-    refresh(): void;
-    /** Stop observing */
-    disconnect(): void;
-}
-/**
- * Observes an element's dimensions via ResizeObserver.
- * Calls `onChange` with rounded width/height whenever the size changes.
- */
-export declare function createMeasureObserver(el: Element, onChange: (rect: MeasureRect) => void): MeasureObserverHandle;

package/dist/dom/src/observers.d.ts

@@ -1,5 +0,0 @@
-/**
- * Imperative DOM observers — framework-agnostic compatibility barrel.
- */
-export * from './measure';
-export * from './virtual';

package/dist/dom/src/ssr.d.ts

@@ -1,20 +0,0 @@
-/**
- * Detects if code is running in a server-side environment
- */
-export declare const isSSR: boolean;
-/**
- * Default dimensions to use during server-side rendering
- */
-export declare const SSR_DIMENSIONS: {
-    width: number;
-    height: number;
-};
-/**
- * Safe window-using function that works in both server and client
- */
-export declare function safeClientValue<T>(clientFn: () => T, fallback: T): T;
-/**
- * Returns a stable value during SSR and initial render, then switches to
- * the dynamic value after hydration
- */
-export declare function hydratedValue<T>(isHydrated: boolean, ssrValue: T, dynamicValue: T): T;

package/dist/dom/src/timing.d.ts

@@ -1,2 +0,0 @@
-export declare const debounce: <T extends (...args: unknown[]) => void>(fn: T, delay: number) => [T, () => void];
-export declare const rafThrottle: <T extends (...args: never[]) => void>(fn: T) => [T, () => void];

package/dist/dom/src/viewport.d.ts

@@ -1,7 +0,0 @@
-import type { ConversionContext } from '@baseline-kit/core';
-/**
- * Returns the current browser viewport for vw/vh/vmin/vmax conversion.
- * Returns an empty object on the server so callers fall back to the
- * core defaults without crashing.
- */
-export declare function getViewportContext(): Partial<ConversionContext>;

package/dist/dom/src/virtual.d.ts

@@ -1,23 +0,0 @@
-/**
- * Virtual scroll range tracker.
- */
-export interface VirtualRange {
-    start: number;
-    end: number;
-}
-export interface VirtualTrackerOptions {
-    totalItems: number;
-    itemHeight: number;
-    buffer?: number;
-}
-export interface VirtualTrackerHandle {
-    /** Force recalculation */
-    refresh(): void;
-    /** Stop tracking */
-    disconnect(): void;
-}
-/**
- * Tracks which slice of a virtual list is visible in the viewport.
- * Uses IntersectionObserver + window scroll/resize events.
- */
-export declare function createVirtualTracker(el: Element, options: VirtualTrackerOptions, onChange: (range: VirtualRange) => void): VirtualTrackerHandle;

package/dist/react/src/components/Baseline/Baseline.d.ts

@@ -1,13 +0,0 @@
-import * as React from 'react';
-import { ComponentsProps } from '../types';
-import type { BaselineVariant } from '@baseline-kit/core';
-export type { BaselineVariant };
-export type BaselineProps = {
-    variant?: BaselineVariant;
-    width?: number | string;
-    height?: number | string;
-    base?: number;
-    color?: string;
-    ssrMode?: boolean;
-} & ComponentsProps;
-export declare const Baseline: React.NamedExoticComponent<BaselineProps>;

package/dist/react/src/components/Baseline/index.d.ts

@@ -1 +0,0 @@
-export * from './Baseline';

package/dist/react/src/components/Box/Box.d.ts

@@ -1,26 +0,0 @@
-import * as React from 'react';
-import type { SnappingMode } from '@baseline-kit/core';
-import { ComponentsProps } from '../types';
-export type { SnappingMode };
-export type BoxProps = {
-    colSpan?: number;
-    rowSpan?: number;
-    span?: number;
-    snapping?: SnappingMode;
-    ssrMode?: boolean;
-    children?: React.ReactNode;
-} & ComponentsProps;
-export declare const Box: React.NamedExoticComponent<{
-    colSpan?: number;
-    rowSpan?: number;
-    span?: number;
-    snapping?: SnappingMode;
-    ssrMode?: boolean;
-    children?: React.ReactNode;
-} & {
-    debugging?: import("@baseline-kit/core").DebuggingMode;
-    className?: string;
-    style?: React.CSSProperties;
-    height?: React.CSSProperties["height"];
-    width?: React.CSSProperties["width"];
-} & import("@baseline-kit/core").SpacingProps & React.RefAttributes<HTMLDivElement>>;

package/dist/react/src/components/Box/index.d.ts

@@ -1 +0,0 @@
-export * from './Box';

package/dist/react/src/components/Config/Config.d.ts

@@ -1,20 +0,0 @@
-import * as React from 'react';
-import type { ConfigSchema } from '@baseline-kit/core/config/schema';
-import { mergeConfig, createCSSVariables } from '@baseline-kit/core/config/merge';
-export type { DebuggingMode } from '@baseline-kit/core/types';
-export type { ConfigSchema } from '@baseline-kit/core/config/schema';
-export declare const useDefaultConfig: () => ConfigSchema;
-type ConfigProps = {
-    children: React.ReactNode;
-    base?: number;
-    baseline?: Partial<ConfigSchema['baseline']>;
-    guide?: Partial<ConfigSchema['guide']>;
-    spacer?: Partial<ConfigSchema['spacer']>;
-    box?: Partial<ConfigSchema['box']>;
-    padder?: Partial<ConfigSchema['padder']>;
-};
-/**
- * Configuration provider for baseline-kit components.
- */
-export declare function Config({ children, base, baseline, guide, spacer, box, padder, }: ConfigProps): import("react/jsx-runtime").JSX.Element;
-export { createCSSVariables, mergeConfig };

package/dist/react/src/components/Config/index.d.ts

@@ -1,2 +0,0 @@
-export * from './Config';
-export { DEFAULT_CONFIG } from '@baseline-kit/core';

package/dist/react/src/components/Guide/Guide.d.ts

@@ -1,16 +0,0 @@
-import * as React from 'react';
-import type { ComponentsProps } from '../types';
-import type { GuideVariant, GuideConfig } from '@baseline-kit/core/types';
-export type { GuideConfig };
-export type GuideProps = {
-    align?: React.CSSProperties['justifyContent'];
-    variant?: GuideVariant;
-    columns?: number | readonly (string | number | undefined | 'auto')[];
-    columnWidth?: React.CSSProperties['width'];
-    maxWidth?: React.CSSProperties['maxWidth'];
-    color?: React.CSSProperties['color'];
-    children?: React.ReactNode;
-    gap?: number;
-    ssrMode?: boolean;
-} & ComponentsProps & Omit<GuideConfig, 'columns' | 'columnWidth' | 'gap'>;
-export declare const Guide: React.NamedExoticComponent<GuideProps>;

package/dist/react/src/components/Guide/index.d.ts

@@ -1 +0,0 @@
-export * from './Guide';

package/dist/react/src/components/Padder/Padder.d.ts

@@ -1,20 +0,0 @@
-import * as React from 'react';
-import { ComponentsProps } from '../types';
-import { IndicatorNode } from '../Spacer';
-import type { DebuggingMode } from '../types';
-export type PadderProps = {
-    indicatorNode?: IndicatorNode;
-    ssrMode?: boolean;
-    children?: React.ReactNode;
-} & ComponentsProps;
-export declare const Padder: React.NamedExoticComponent<{
-    indicatorNode?: IndicatorNode;
-    ssrMode?: boolean;
-    children?: React.ReactNode;
-} & {
-    debugging?: DebuggingMode;
-    className?: string;
-    style?: React.CSSProperties;
-    height?: React.CSSProperties["height"];
-    width?: React.CSSProperties["width"];
-} & import("@baseline-kit/core").SpacingProps & React.RefAttributes<HTMLDivElement>>;

package/dist/react/src/components/Padder/index.d.ts

@@ -1 +0,0 @@
-export * from './Padder';

package/dist/react/src/components/Spacer/Spacer.d.ts

@@ -1,14 +0,0 @@
-import * as React from 'react';
-import { ComponentsProps, Variant } from '../types';
-export type IndicatorNode = (value: number, type: 'width' | 'height') => React.ReactNode;
-export type SpacerProps = {
-    width?: React.CSSProperties['width'];
-    height?: React.CSSProperties['height'];
-    variant?: Variant;
-    color?: string;
-    base?: number;
-    children?: React.ReactNode;
-    indicatorNode?: IndicatorNode;
-    ssrMode?: boolean;
-} & ComponentsProps;
-export declare const Spacer: React.NamedExoticComponent<SpacerProps>;

package/dist/react/src/components/Spacer/index.d.ts

@@ -1 +0,0 @@
-export * from './Spacer';

package/dist/react/src/components/index.d.ts

@@ -1,12 +0,0 @@
-/**
- * @baseline-kit/react components
- */
-import './styles/core.css';
-import './styles/theme.css';
-export * from './Box';
-export * from './Spacer';
-export * from './Padder';
-export * from './Guide';
-export * from './Baseline';
-export * from './Config';
-export * from './types';

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

@@ -1,29 +0,0 @@
-import * as React from 'react';
-import type { DebuggingMode, SpacingProps } from '@baseline-kit/core';
-export type { Spacing, PaddingValue, Padding, SpacingProps, GuideVariant, GuideColumnValue, GuideColumnsPattern, GridAlignment, PaddedVariant, Variant, DebuggingMode, ConfigSchema, } from '@baseline-kit/core';
-export { GRID_ALIGNMENTS, PADD_VARIANTS } from '@baseline-kit/core';
-/**
- * Common props shared across library components.
- */
-export type ComponentsProps = {
-    debugging?: DebuggingMode;
-    className?: string;
-    style?: React.CSSProperties;
-    height?: React.CSSProperties['height'];
-    width?: React.CSSProperties['width'];
-} & SpacingProps;
-/** Base configuration for components that support padding. */
-export type PaddedBaseConfig = {
-    base?: number;
-    color?: React.CSSProperties['color'] | React.CSSProperties['backgroundColor'];
-    zIndex?: React.CSSProperties['zIndex'];
-};
-export type Gaps = {
-    gap?: React.CSSProperties['gap'];
-    rowGap?: never;
-    columnGap?: never;
-} | {
-    gap?: never;
-    rowGap?: React.CSSProperties['rowGap'];
-    columnGap?: React.CSSProperties['columnGap'];
-};