@salilvnair/dui 1.0.0

package/dist/lib/core/CardBase.d.ts

@@ -0,0 +1,21 @@
+import { DuiSize, DuiRadius, DuiFontStyle } from './DuiTypes';
+export interface CardBaseConfig {
+    fontSize: string;
+    borderRadius: string;
+    padding: string;
+    gap: string;
+    color: string | undefined;
+    fontStyle: DuiFontStyle | undefined;
+}
+/** Local override props that any card component can accept. */
+export interface CardContainerProps {
+    borderRadius?: DuiRadius | number;
+    color?: string;
+    fontStyle?: DuiFontStyle;
+}
+/**
+ * Category base for: PromptCardView, RequestCardView, EnvironmentCardView,
+ * and any future card/list-item component.
+ * Falls back to DuiProvider values when no local prop is given.
+ */
+export declare function useCardBase(sizeProp?: DuiSize, overrides?: CardContainerProps): CardBaseConfig;

package/dist/lib/core/ChipBase.d.ts

@@ -0,0 +1,21 @@
+import { DuiSize, DuiRadius, DuiFontStyle } from './DuiTypes';
+export interface ChipBaseConfig {
+    height: string;
+    fontSize: string;
+    paddingX: string;
+    borderRadius: string;
+    color: string | undefined;
+    fontStyle: DuiFontStyle | undefined;
+}
+/** Local override props that any chip/badge component can accept. */
+export interface ChipContainerProps {
+    borderRadius?: DuiRadius | number;
+    color?: string;
+    fontStyle?: DuiFontStyle;
+}
+/**
+ * Category base for: ChipView, StatusBadgeView, CountBadgeView.
+ * Chips always default to 'full' (pill) radius — context borderRadius overrides that.
+ * Falls back to DuiProvider values when no local prop is given.
+ */
+export declare function useChipBase(sizeProp?: DuiSize, overrides?: ChipContainerProps): ChipBaseConfig;

package/dist/lib/core/DisplayBase.d.ts

@@ -0,0 +1,21 @@
+import { DuiSize, DuiRadius, DuiFontStyle } from './DuiTypes';
+export interface DisplayBaseConfig {
+    fontSize: string;
+    iconSize: number;
+    borderRadius: string;
+    gap: string;
+    color: string | undefined;
+    fontStyle: DuiFontStyle | undefined;
+}
+/** Local override props that any display component can accept. */
+export interface DisplayContainerProps {
+    borderRadius?: DuiRadius | number;
+    color?: string;
+    fontStyle?: DuiFontStyle;
+}
+/**
+ * Category base for: LabelView, EmptyStateView, PromptCardView, FeatureCategoryView,
+ * StatusBadgeView, InfoPopup, and any future read-only display component.
+ * Falls back to DuiProvider values when no local prop is given.
+ */
+export declare function useDisplayBase(sizeProp?: DuiSize, overrides?: DisplayContainerProps): DisplayBaseConfig;

package/dist/lib/core/DuiContext.d.ts

@@ -0,0 +1,53 @@
+import { ReactNode } from 'react';
+import { DuiConfig, DuiSize, DuiRadius, DuiWidth, DuiFontStyle } from './DuiTypes';
+/**
+ * Wrap any subtree to give all DUI components a shared set of default props.
+ * Every prop is optional and falls back to its system default when omitted.
+ *
+ * @example
+ * <DuiProvider size="sm" borderRadius="lg" activeColor="var(--color-primary)">
+ *   <ButtonView>Save</ButtonView>
+ * </DuiProvider>
+ */
+export declare function DuiProvider({ size, width, borderRadius, color, defaultColor, activeColor, fontStyle, children, }: {
+    size?: DuiSize;
+    width?: DuiWidth;
+    borderRadius?: DuiRadius | number;
+    color?: string;
+    defaultColor?: string;
+    activeColor?: string;
+    fontStyle?: DuiFontStyle;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Returns the current DUI config. Components call this and fall back to the
+ * context values when no explicit prop is passed.
+ *
+ * @example
+ * const { size } = useDui();
+ * const resolved = sizeProp ?? size;
+ */
+export declare function useDui(): DuiConfig;
+/**
+ * Resolves the border-radius value from either a DuiConfig override
+ * (preset name or raw px number) or the size-derived default.
+ */
+export declare function resolveBorderRadius(override: DuiRadius | number | undefined, sizeFallback: string): string;
+/**
+ * Resolves a width preset to a CSS string.
+ * Falls back to `'auto'` when no width is set.
+ */
+export declare function resolveWidth(width: DuiWidth | undefined): string;
+/**
+ * Convenience hook — returns resolved border-radius and width strings
+ * plus raw color/style overrides from the current DUI context.
+ * Components call this to merge context defaults with their own prop overrides.
+ */
+export declare function useDuiStyle(sizeFallback: string): {
+    borderRadius: string;
+    width: string;
+    color: string | undefined;
+    defaultColor: string | undefined;
+    activeColor: string | undefined;
+    fontStyle: DuiFontStyle | undefined;
+};

package/dist/lib/core/DuiTokens.d.ts

@@ -0,0 +1,115 @@
+import { DuiSize, DuiRadius, DuiWidth } from './DuiTypes';
+/** Heights (px) per size × category */
+export declare const DUI_HEIGHT: {
+    /** Standard form controls: text input, select, duration, search, highlighted input */
+    readonly input: {
+        readonly xxs: 16;
+        readonly xs: 20;
+        readonly sm: 24;
+        readonly md: 28;
+        readonly lg: 36;
+        readonly xl: 40;
+        readonly xxl: 48;
+        readonly xxxl: 56;
+    };
+    /** Push buttons (primary, secondary, ghost, danger) */
+    readonly button: {
+        readonly xxs: 16;
+        readonly xs: 20;
+        readonly sm: 24;
+        readonly md: 28;
+        readonly lg: 36;
+        readonly xl: 40;
+        readonly xxl: 48;
+        readonly xxxl: 56;
+    };
+    /** Pill tabs, segment controls */
+    readonly tab: {
+        readonly xxs: 16;
+        readonly xs: 20;
+        readonly sm: 24;
+        readonly md: 28;
+        readonly lg: 36;
+        readonly xl: 40;
+        readonly xxl: 48;
+        readonly xxxl: 56;
+    };
+    /** Sidebar nav items, settings nav links */
+    readonly nav: {
+        readonly xxs: 20;
+        readonly xs: 24;
+        readonly sm: 28;
+        readonly md: 32;
+        readonly lg: 36;
+        readonly xl: 44;
+        readonly xxl: 52;
+        readonly xxxl: 60;
+    };
+    /** Context-menu items, dropdown options, sub-menu rows */
+    readonly menu: {
+        readonly xxs: 14;
+        readonly xs: 18;
+        readonly sm: 22;
+        readonly md: 26;
+        readonly lg: 30;
+        readonly xl: 36;
+        readonly xxl: 42;
+        readonly xxxl: 48;
+    };
+    /** Table / KV-table rows */
+    readonly table: {
+        readonly xxs: 18;
+        readonly xs: 22;
+        readonly sm: 26;
+        readonly md: 30;
+        readonly lg: 36;
+        readonly xl: 40;
+        readonly xxl: 46;
+        readonly xxxl: 54;
+    };
+    /** Card container min-height (loosely applied) */
+    readonly card: {
+        readonly xxs: 28;
+        readonly xs: 36;
+        readonly sm: 48;
+        readonly md: 64;
+        readonly lg: 80;
+        readonly xl: 96;
+        readonly xxl: 112;
+        readonly xxxl: 128;
+    };
+};
+/** Chip / badge heights */
+export declare const DUI_CHIP_HEIGHT: Record<DuiSize, number>;
+/** Toggle track dimensions (trackW, trackH, thumb) */
+export declare const DUI_TOGGLE: Record<DuiSize, {
+    trackW: number;
+    trackH: number;
+    thumb: number;
+}>;
+/**
+ * Checkbox box and inner icon sizes (px).
+ * Centralised here so components never define ad-hoc local maps.
+ */
+export declare const DUI_CHECKBOX: Record<DuiSize, {
+    box: number;
+    icon: number;
+}>;
+/** Icon sizes (px) — used for icons inside buttons, inputs, menus */
+export declare const DUI_ICON_SIZE: Record<DuiSize, number>;
+/** Font sizes (px) */
+export declare const DUI_FONT_SIZE: Record<DuiSize, string>;
+/** Vertical padding (px) for dropdown / select option rows */
+export declare const DUI_SELECT_ITEM_PY: Record<DuiSize, string>;
+/** Editor (Monaco) font sizes (px) — larger than DUI_FONT_SIZE since code is harder to read at label sizes */
+export declare const DUI_EDITOR_FONT_SIZE: Record<DuiSize, number>;
+/** Horizontal padding (px) */
+export declare const DUI_PADDING_X: Record<DuiSize, string>;
+/** Gap between icon and text inside a component (px) */
+export declare const DUI_GAP: Record<DuiSize, string>;
+/** Border-radius presets (px) */
+export declare const DUI_RADIUS_MAP: Record<DuiRadius, string>;
+/** Default border-radius per size */
+export declare const DUI_DEFAULT_RADIUS: Record<DuiSize, string>;
+/** Width presets for DUI components. */
+export declare const DUI_WIDTH_MAP: Record<DuiWidth, string>;

package/dist/lib/core/DuiTypes.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Eight canonical sizes for all DUI components.
+ * DuiProvider is the "parent" — every component inherits from it unless overridden.
+ *
+ */
+export type DuiSize = 'xxs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl' | 'xxxl';
+/** Named radius presets — components may also accept a raw number. */
+export type DuiRadius = 'none' | 'sm' | 'md' | 'lg' | 'full';
+/** Width presets for DUI components. */
+export type DuiWidth = 'sm' | 'md' | 'default' | 'lg' | 'fullWidth' | 'maxContent' | 'fw' | 'mx';
+/** Font style override. */
+export type DuiFontStyle = 'normal' | 'italic';
+/** Global DUI context shape. */
+export interface DuiConfig {
+    /** Default size inherited by all DUI components when no local size prop is passed. */
+    size: DuiSize;
+    /** Default width preset. Components that support width read this as their default. */
+    width?: DuiWidth;
+    /** Border-radius preset or raw px number. Overrides the size-derived default. */
+    borderRadius?: DuiRadius | number;
+    /** Text color override (CSS var or value, e.g. `var(--color-text-primary)`). */
+    color?: string;
+    /** Primary/accent color used for interactive highlights (buttons, selections). */
+    defaultColor?: string;
+    /** Color for active / selected states (tabs, nav items, toggles). */
+    activeColor?: string;
+    /** Font style applied to all text within the DUI subtree. */
+    fontStyle?: DuiFontStyle;
+}

package/dist/lib/core/EditorBase.d.ts

@@ -0,0 +1,13 @@
+import { DuiSize } from './DuiTypes';
+export interface EditorBaseConfig {
+    fontSize: number;
+}
+/** Reserved for future editor-level overrides (e.g. minLines, theme override). */
+export interface EditorContainerProps {
+}
+/**
+ * Category base for EditorView (Monaco-based editors).
+ * Reads the DuiProvider size context so every editor automatically inherits
+ * the app-level size without a local prop.  Pass `sizeProp` to override per-instance.
+ */
+export declare function useEditorBase(sizeProp?: DuiSize, _overrides?: EditorContainerProps): EditorBaseConfig;

package/dist/lib/core/InputBase.d.ts

@@ -0,0 +1,25 @@
+import { DuiSize, DuiRadius, DuiWidth, DuiFontStyle } from './DuiTypes';
+export interface InputBaseConfig {
+    height: string;
+    fontSize: string;
+    iconSize: number;
+    borderRadius: string;
+    paddingX: string;
+    gap: string;
+    width: string;
+    color: string | undefined;
+    fontStyle: DuiFontStyle | undefined;
+}
+/** Local override props that any input component can accept. */
+export interface InputContainerProps {
+    width?: DuiWidth;
+    borderRadius?: DuiRadius | number;
+    color?: string;
+    fontStyle?: DuiFontStyle;
+}
+/**
+ * Category base for: TextInputView, SearchInputView, DurationInputView,
+ * HighlightedInputView, NumberInputView, TextAreaView, and any future text-input component.
+ * Falls back to DuiProvider values when no local prop is given.
+ */
+export declare function useInputBase(sizeProp?: DuiSize, overrides?: InputContainerProps): InputBaseConfig;

package/dist/lib/core/MenuBase.d.ts

@@ -0,0 +1,23 @@
+import { DuiSize, DuiRadius, DuiFontStyle } from './DuiTypes';
+export interface MenuBaseConfig {
+    itemHeight: string;
+    fontSize: string;
+    iconSize: number;
+    borderRadius: string;
+    paddingX: string;
+    gap: string;
+    color: string | undefined;
+    fontStyle: DuiFontStyle | undefined;
+}
+/** Local override props that any menu component can accept. */
+export interface MenuContainerProps {
+    borderRadius?: DuiRadius | number;
+    color?: string;
+    fontStyle?: DuiFontStyle;
+}
+/**
+ * Category base for: StyledDropdown options, ContextMenuView items, submenu rows,
+ * SelectInputView options, and any future menu/dropdown component.
+ * Falls back to DuiProvider values when no local prop is given.
+ */
+export declare function useMenuBase(sizeProp?: DuiSize, overrides?: MenuContainerProps): MenuBaseConfig;

package/dist/lib/core/NavBase.d.ts

@@ -0,0 +1,26 @@
+import { DuiSize, DuiRadius, DuiFontStyle } from './DuiTypes';
+export interface NavBaseConfig {
+    /** Nav item row height — intentionally taller than inputs for click comfort */
+    itemHeight: string;
+    fontSize: string;
+    iconSize: number;
+    borderRadius: string;
+    gap: string;
+    paddingX: string;
+    color: string | undefined;
+    activeColor: string | undefined;
+    fontStyle: DuiFontStyle | undefined;
+}
+/** Local override props that any nav component can accept. */
+export interface NavContainerProps {
+    borderRadius?: DuiRadius | number;
+    color?: string;
+    activeColor?: string;
+    fontStyle?: DuiFontStyle;
+}
+/**
+ * Category base for: SideNavView, SettingsNavView, BreadcrumbView, TabBarView,
+ * and any future navigation component.
+ * Falls back to DuiProvider values when no local prop is given.
+ */
+export declare function useNavBase(sizeProp?: DuiSize, overrides?: NavContainerProps): NavBaseConfig;

package/dist/lib/core/OverlayBase.d.ts

@@ -0,0 +1,20 @@
+import { DuiSize, DuiRadius } from './DuiTypes';
+export interface OverlayBaseConfig {
+    fontSize: string;
+    borderRadius: string;
+    headerFontSize: string;
+    paddingX: string;
+    paddingY: string;
+    color: string | undefined;
+}
+/** Local override props that any overlay component can accept. */
+export interface OverlayContainerProps {
+    borderRadius?: DuiRadius | number;
+    color?: string;
+}
+/**
+ * Category base for: ModalView, ToastView, TooltipView, PopoverView, DrawerView.
+ * Overlays use slightly larger radius for a "floating" feel.
+ * Falls back to DuiProvider values when no local prop is given.
+ */
+export declare function useOverlayBase(sizeProp?: DuiSize, overrides?: OverlayContainerProps): OverlayBaseConfig;

package/dist/lib/core/SelectBase.d.ts

@@ -0,0 +1,22 @@
+import { DuiSize, DuiRadius, DuiWidth } from './DuiTypes';
+export interface SelectBaseConfig {
+    height: string;
+    fontSize: string;
+    iconSize: number;
+    borderRadius: string;
+    paddingX: string;
+    gap: string;
+    width: string;
+    color: string | undefined;
+    itemPy: string;
+}
+export interface SelectContainerProps {
+    width?: DuiWidth;
+    borderRadius?: DuiRadius | number;
+    color?: string;
+}
+/**
+ * Category base for: SelectInputView, StyledDropdown, and any future picker component.
+ * Falls back to DuiProvider values when no local prop is given.
+ */
+export declare function useSelectBase(sizeProp?: DuiSize, overrides?: SelectContainerProps): SelectBaseConfig;

package/dist/lib/core/TabBase.d.ts

@@ -0,0 +1,25 @@
+import { DuiSize, DuiRadius, DuiWidth, DuiFontStyle } from './DuiTypes';
+export interface TabBaseConfig {
+    height: string;
+    fontSize: string;
+    gap: string;
+    borderRadius: string;
+    paddingX: string;
+    width: string;
+    color: string | undefined;
+    activeColor: string | undefined;
+    fontStyle: DuiFontStyle | undefined;
+}
+/** Local override props that any tab component can accept. */
+export interface TabContainerProps {
+    width?: DuiWidth;
+    borderRadius?: DuiRadius | number;
+    color?: string;
+    activeColor?: string;
+    fontStyle?: DuiFontStyle;
+}
+/**
+ * Category base for: PillTabsView, SegmentTabsView, TabView, and any future tab/segment component.
+ * Falls back to DuiProvider values when no local prop is given.
+ */
+export declare function useTabBase(sizeProp?: DuiSize, overrides?: TabContainerProps): TabBaseConfig;

package/dist/lib/core/TableBase.d.ts

@@ -0,0 +1,19 @@
+import { DuiSize, DuiFontStyle } from './DuiTypes';
+export interface TableBaseConfig {
+    rowHeight: string;
+    headerFontSize: string;
+    cellFontSize: string;
+    paddingX: string;
+    color: string | undefined;
+    fontStyle: DuiFontStyle | undefined;
+}
+/** Local override props that any table component can accept. */
+export interface TableContainerProps {
+    color?: string;
+    fontStyle?: DuiFontStyle;
+}
+/**
+ * Category base for: KeyValueTableView, DataTableView, and any future table component.
+ * Falls back to DuiProvider values when no local prop is given.
+ */
+export declare function useTableBase(sizeProp?: DuiSize, overrides?: TableContainerProps): TableBaseConfig;

package/dist/lib/core/ToggleBase.d.ts

@@ -0,0 +1,19 @@
+import { DuiSize } from './DuiTypes';
+export interface ToggleBaseConfig {
+    trackW: number;
+    trackH: number;
+    thumb: number;
+    fontSize: string;
+    activeColor: string | undefined;
+    color: string | undefined;
+}
+/** Local override props that any toggle/checkbox component can accept. */
+export interface ToggleContainerProps {
+    activeColor?: string;
+    color?: string;
+}
+/**
+ * Category base for: ToggleSwitchView, CheckboxView, RadioButtonView.
+ * Falls back to DuiProvider values when no local prop is given.
+ */
+export declare function useToggleBase(sizeProp?: DuiSize, overrides?: ToggleContainerProps): ToggleBaseConfig;

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

@@ -0,0 +1,25 @@
+export type { DuiSize, DuiRadius, DuiWidth, DuiFontStyle, DuiConfig } from './DuiTypes';
+export { DUI_HEIGHT, DUI_CHIP_HEIGHT, DUI_TOGGLE, DUI_CHECKBOX, DUI_ICON_SIZE, DUI_FONT_SIZE, DUI_PADDING_X, DUI_GAP, DUI_RADIUS_MAP, DUI_DEFAULT_RADIUS, DUI_WIDTH_MAP, } from './DuiTokens';
+export { DuiProvider, useDui, useDuiStyle, resolveBorderRadius, resolveWidth } from './DuiContext';
+export type { InputBaseConfig, InputContainerProps } from './InputBase';
+export { useInputBase } from './InputBase';
+export type { ButtonBaseConfig, ButtonContainerProps } from './ButtonBase';
+export { useButtonBase } from './ButtonBase';
+export type { NavBaseConfig, NavContainerProps } from './NavBase';
+export { useNavBase } from './NavBase';
+export type { ChipBaseConfig, ChipContainerProps } from './ChipBase';
+export { useChipBase } from './ChipBase';
+export type { ToggleBaseConfig, ToggleContainerProps } from './ToggleBase';
+export { useToggleBase } from './ToggleBase';
+export type { MenuBaseConfig, MenuContainerProps } from './MenuBase';
+export { useMenuBase } from './MenuBase';
+export type { TabBaseConfig, TabContainerProps } from './TabBase';
+export { useTabBase } from './TabBase';
+export type { TableBaseConfig, TableContainerProps } from './TableBase';
+export { useTableBase } from './TableBase';
+export type { DisplayBaseConfig, DisplayContainerProps } from './DisplayBase';
+export { useDisplayBase } from './DisplayBase';
+export type { OverlayBaseConfig, OverlayContainerProps } from './OverlayBase';
+export { useOverlayBase } from './OverlayBase';
+export type { CardBaseConfig, CardContainerProps } from './CardBase';
+export { useCardBase } from './CardBase';