@shohojdhara/atomix 0.1.5 → 0.1.7

package/dist/types/components/Rating/scripts/index.d.ts

@@ -0,0 +1,74 @@
+import type { RatingProps } from '../../../lib/types/components';
+/**
+ * Rating component class for vanilla JavaScript implementation
+ */
+export type RatingOptions = Pick<RatingProps, 'value' | 'defaultValue' | 'maxValue' | 'allowHalf' | 'readOnly' | 'size' | 'color' | 'onChange'>;
+/**
+ * Rating component class for vanilla JavaScript implementation
+ */
+export default class Rating {
+    element: HTMLElement;
+    options: RatingOptions;
+    stars: NodeListOf<HTMLElement> | null;
+    private _currentValue;
+    private _boundHandleMouseEnter;
+    private _boundHandleMouseLeave;
+    private _boundHandleClick;
+    private _boundHandleKeyDown;
+    /**
+     * Create a new Rating instance
+     * @param element - The element to attach the rating to
+     * @param options - Configuration options
+     */
+    constructor(element: string | HTMLElement, options?: RatingOptions);
+    /**
+     * Initialize the component
+     */
+    private _init;
+    /**
+     * Bind event listeners
+     */
+    private _bindEvents;
+    /**
+     * Handle mouse enter on a star
+     */
+    private _handleMouseEnter;
+    /**
+     * Handle mouse leave from rating component
+     */
+    private _handleMouseLeave;
+    /**
+     * Handle click on a star
+     */
+    private _handleClick;
+    /**
+     * Handle keyboard navigation
+     */
+    private _handleKeyDown;
+    /**
+     * Update star appearance based on current value
+     */
+    private _updateStars;
+    /**
+     * Temporarily highlight stars up to a value
+     */
+    private _highlightStars;
+    /**
+     * Get current rating value
+     */
+    getValue(): number;
+    /**
+     * Set the rating value
+     * @param value - The new rating value
+     */
+    setValue(value: number): void;
+    /**
+     * Update component options
+     * @param options Partial options to update
+     */
+    updateOptions(options: Partial<RatingOptions>): void;
+    /**
+     * Destroy the rating component and remove event listeners
+     */
+    destroy(): void;
+}

package/dist/types/components/Rating/scripts/ratingInteractions.d.ts

@@ -0,0 +1,28 @@
+import Rating from './index';
+/**
+ * Event handlers and utility functions for Rating component
+ */
+/**
+ * Handle keyboard navigation for rating stars
+ * @param event Keyboard event
+ * @param container Rating container element
+ */
+export declare function handleKeyboardNavigation(event: KeyboardEvent, container: HTMLElement): void;
+/**
+ * Enhance a rating with keyboard navigation
+ * @param rating Rating instance
+ */
+export declare function enhanceWithKeyboardNavigation(rating: Rating): void;
+/**
+ * Initialize ratings with data attributes
+ */
+export declare function initFromDataAttributes(): Rating[];
+/**
+ * Get a Rating instance from an element
+ * @param element Element or selector
+ */
+export declare function getInstance(element: string | HTMLElement): Rating | null;
+/**
+ * Dispose all Rating instances
+ */
+export declare function disposeAll(): void;

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

@@ -0,0 +1,9 @@
+import React from 'react';
+import { RiverProps } from '../../lib/composables/useRiver';
+/**
+ * River component for displaying content with image sections
+ */
+declare const River: React.FC<RiverProps>;
+export type { RiverProps };
+export default River;
+export { River };

package/dist/types/components/River/index.d.ts

@@ -0,0 +1,2 @@
+export { River } from './River';
+export type { RiverProps } from './River';

package/dist/types/components/River/scripts/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Interface for River instance
+ */
+interface RiverInstance {
+    init(): void;
+    destroy(): void;
+}
+/**
+ * Class representing a River component
+ */
+declare class River implements RiverInstance {
+    private $element;
+    private options;
+    /**
+     * Creates an instance of River
+     * @param element - The river element
+     * @param options - Custom options to override defaults
+     */
+    constructor(element: HTMLElement, options?: {});
+    /**
+     * Initialize the river component
+     */
+    init(): void;
+    /**
+     * Setup background image
+     */
+    private setupBackgroundImage;
+    /**
+     * Clean up component
+     */
+    destroy(): void;
+}
+/**
+ * Initialize all river components in the document
+ * @param selector - CSS selector string or DOM Element
+ * @param options - Custom options to override defaults
+ * @returns Array of River instances
+ */
+export declare function initializeRivers(selector?: string, options?: {}): RiverInstance[];
+export default River;

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

@@ -0,0 +1,64 @@
+import React, { ReactNode } from 'react';
+interface SectionIntroProps {
+    /**
+     * The section title
+     */
+    title: ReactNode;
+    /**
+     * Optional subtitle or overline text
+     */
+    /**
+     * Optional label text (equivalent to subtitle in the UI)
+     */
+    label?: ReactNode;
+    /**
+     * Optional description text
+     */
+    /**
+     * Optional text content
+     */
+    text?: ReactNode;
+    /**
+     * Optional call to action elements
+     */
+    actions?: ReactNode;
+    /**
+     * Alignment of the content
+     */
+    alignment?: 'left' | 'center' | 'right';
+    /**
+     * Optional background image URL
+     */
+    backgroundImageSrc?: string;
+    /**
+     * Whether to show an overlay on the background
+     */
+    showOverlay?: boolean;
+    /**
+     * Optional foreground image URL
+     */
+    imageSrc?: string;
+    /**
+     * Alternative text for the image
+     */
+    imageAlt?: string;
+    /**
+     * Size variant
+     */
+    size?: 'sm' | 'md' | 'lg';
+    /**
+     * Whether to show a skeleton loading state
+     */
+    skeleton?: boolean;
+    /**
+     * Additional CSS class
+     */
+    className?: string;
+}
+/**
+ * SectionIntro component for introducing content sections with titles, descriptions, and optional imagery
+ */
+declare const SectionIntro: React.FC<SectionIntroProps>;
+export type { SectionIntroProps };
+export default SectionIntro;
+export { SectionIntro };

package/dist/types/components/SectionIntro/index.d.ts

@@ -0,0 +1,4 @@
+export { SectionIntro } from './SectionIntro';
+export type { SectionIntroProps } from './SectionIntro';
+export { default as default } from './SectionIntro';
+export { initializeSectionIntros } from './scripts';

package/dist/types/components/SectionIntro/scripts/componentInteractions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Component interactions for SectionIntro
+ * This file contains any interactive behaviors for the SectionIntro component
+ */
+/**
+ * Apply any interactive behaviors to SectionIntro components
+ * @param element - The SectionIntro element to enhance
+ */
+export declare function enhanceSectionIntro(element: HTMLElement): void;
+/**
+ * Initialize all SectionIntro components in the document
+ */
+export declare function initializeSectionIntroInteractions(): void;

package/dist/types/components/SectionIntro/scripts/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Interface for SectionIntro instance
+ */
+interface SectionIntroInstance {
+    destroy: () => void;
+}
+/**
+ * Class representing a SectionIntro component
+ */
+declare class SectionIntro implements SectionIntroInstance {
+    private selector;
+    private $element;
+    private options;
+    /**
+     * Creates an instance of SectionIntro
+     * @param selector - CSS selector string or DOM Element
+     * @param options - Custom options to override defaults
+     */
+    constructor(selector: string | Element, options?: {});
+    /**
+     * Initialize the section intro component
+     */
+    private _initialize;
+    /**
+     * Clean up event listeners and remove added elements
+     */
+    destroy(): void;
+}
+/**
+ * Initialize all section intros in the document
+ * @param {string|Element} selector - CSS selector string or DOM Element
+ * @param {Object} options - Custom options to override defaults
+ * @returns {SectionIntroInstance[]} Array of SectionIntro instances
+ */
+export declare function initializeSectionIntros(selector?: string, options?: {}): SectionIntroInstance[];
+export default SectionIntro;

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

@@ -0,0 +1,6 @@
+import React from 'react';
+import { SpinnerProps } from '../../lib/types/components';
+declare const Spinner: React.FC<SpinnerProps>;
+export type { SpinnerProps };
+export default Spinner;
+export { Spinner };

package/dist/types/components/Spinner/index.d.ts

@@ -0,0 +1,2 @@
+export { Spinner } from './Spinner';
+export type { SpinnerProps } from './Spinner';

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

@@ -0,0 +1,44 @@
+import React, { ReactNode } from 'react';
+interface StepItem {
+    /**
+     * The number for the step
+     */
+    number: number | string | ReactNode;
+    /**
+     * The text label for the step
+     */
+    text: string;
+    /**
+     * Optional custom content for the step
+     */
+    content?: React.ReactNode;
+}
+interface StepsProps {
+    /**
+     * Array of step items
+     */
+    items: StepItem[];
+    /**
+     * Current active step index (0-based)
+     */
+    activeIndex?: number;
+    /**
+     * Whether to display steps vertically
+     */
+    vertical?: boolean;
+    /**
+     * Called when active step changes
+     */
+    onStepChange?: (index: number) => void;
+    /**
+     * Additional CSS class
+     */
+    className?: string;
+}
+/**
+ * Steps component for displaying a sequence of steps
+ */
+declare const Steps: React.FC<StepsProps>;
+export type { StepsProps, StepItem };
+export default Steps;
+export { Steps };

package/dist/types/components/Steps/index.d.ts

@@ -0,0 +1,4 @@
+export { Steps } from './Steps';
+export type { StepsProps, StepItem } from './Steps';
+export { default as default } from './Steps';
+export { initializeSteps } from './scripts';

package/dist/types/components/Steps/scripts/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Interface for Steps instance
+ */
+interface StepsInstance {
+    setActive: (index: number) => void;
+    next: () => void;
+    previous: () => void;
+    destroy: () => void;
+}
+/**
+ * Class representing a Steps component
+ */
+declare class Steps implements StepsInstance {
+    private selector;
+    private $element;
+    private options;
+    private $items;
+    private activeIndex;
+    /**
+     * Creates an instance of Steps
+     * @param selector - CSS selector string or DOM Element
+     * @param options - Custom options to override defaults
+     */
+    constructor(selector: string | Element, options?: {});
+    /**
+     * Initialize the steps component
+     */
+    private _initialize;
+    /**
+     * Initialize DOM elements
+     */
+    private _initializeElements;
+    /**
+     * Sets the active step
+     * @param index - The index of the step to make active
+     */
+    setActive(index: number): void;
+    /**
+     * Moves to the next step
+     */
+    next(): void;
+    /**
+     * Moves to the previous step
+     */
+    previous(): void;
+    /**
+     * Clean up event listeners
+     */
+    destroy(): void;
+}
+/**
+ * Initialize all steps in the document
+ * @param {string|Element} selector - CSS selector string or DOM Element
+ * @param {Object} options - Custom options to override defaults
+ * @returns {StepsInstance[]} Array of Steps instances
+ */
+export declare function initializeSteps(selector?: string, options?: {}): StepsInstance[];
+export default Steps;

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

@@ -0,0 +1,44 @@
+import React, { ReactNode } from 'react';
+interface TabItemProps {
+    /**
+     * Label for the tab
+     */
+    label: string;
+    /**
+     * Content of the tab panel
+     */
+    content: ReactNode;
+    /**
+     * Whether the tab is initially active
+     */
+    isActive?: boolean;
+    /**
+     * Additional CSS class for the tab
+     */
+    className?: string;
+}
+interface TabProps {
+    /**
+     * Array of tab items
+     */
+    items: TabItemProps[];
+    /**
+     * Initial active tab index
+     */
+    activeIndex?: number;
+    /**
+     * Callback when tab changes
+     */
+    onTabChange?: (index: number) => void;
+    /**
+     * Additional CSS class for the tab component
+     */
+    className?: string;
+}
+/**
+ * Tab component for switching between different content panels
+ */
+declare const Tab: React.FC<TabProps>;
+export type { TabProps, TabItemProps };
+export default Tab;
+export { Tab };

package/dist/types/components/Tab/index.d.ts

@@ -0,0 +1,2 @@
+export { Tab } from "./Tab";
+export type { TabProps, TabItemProps } from "./Tab";

package/dist/types/components/Tab/scripts/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Interface for Tab instance
+ */
+interface TabInstance {
+    destroy: () => void;
+}
+/**
+ * Class representing a Tab component
+ */
+declare class Tab implements TabInstance {
+    private selector;
+    private $element;
+    private options;
+    private $navItems;
+    private $panels;
+    private $panelBodys;
+    /**
+     * Creates an instance of Tab
+     * @param selector - CSS selector string or DOM Element
+     * @param options - Custom options to override defaults
+     */
+    constructor(selector: string | Element, options?: {});
+    /**
+     * Initialize the tab component
+     */
+    private _initialize;
+    /**
+     * Initialize DOM elements
+     */
+    private _initializeElements;
+    /**
+     * Bind event listeners
+     */
+    private _bindEvents;
+    /**
+     * Handle tab click event
+     * @param btn - The clicked tab button
+     */
+    private _handleTabClick;
+    /**
+     * Hide all tabs
+     */
+    private _hideAllTabs;
+    /**
+     * Show tab at specified index
+     * @param index - The index of tab to show
+     */
+    private _showTab;
+    /**
+     * Clean up event listeners
+     */
+    destroy(): void;
+}
+/**
+ * Initialize all tabs in the document
+ * @param {string|Element} selector - CSS selector string or DOM Element
+ * @param {Object} options - Custom options to override defaults
+ * @returns {TabInstance[]} Array of Tab instances
+ */
+export declare function initializeTabs(selector?: string, options?: {}): TabInstance[];
+export default Tab;

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

@@ -0,0 +1,48 @@
+import React, { ReactNode } from 'react';
+interface TestimonialAuthor {
+    /**
+     * The author's name
+     */
+    name: string;
+    /**
+     * The author's role or title
+     */
+    role: string;
+    /**
+     * The URL to the author's avatar image
+     */
+    avatarSrc?: string;
+    /**
+     * Alternative text for the avatar image
+     */
+    avatarAlt?: string;
+}
+interface TestimonialProps {
+    /**
+     * The testimonial quote text or content
+     */
+    quote: ReactNode;
+    /**
+     * Author information
+     */
+    author?: TestimonialAuthor;
+    /**
+     * Size variant
+     */
+    size?: 'sm' | 'lg' | '';
+    /**
+     * Whether to show a skeleton loading state
+     */
+    skeleton?: boolean;
+    /**
+     * Additional CSS class
+     */
+    className?: string;
+}
+/**
+ * Testimonial component for displaying customer quotes and feedback
+ */
+declare const Testimonial: React.FC<TestimonialProps>;
+export type { TestimonialProps, TestimonialAuthor };
+export default Testimonial;
+export { Testimonial };

package/dist/types/components/Testimonial/index.d.ts

@@ -0,0 +1,4 @@
+export { Testimonial } from './Testimonial';
+export type { TestimonialProps, TestimonialAuthor } from './Testimonial';
+export { default as default } from './Testimonial';
+export { initializeTestimonials } from './scripts';

package/dist/types/components/Testimonial/scripts/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Interface for Testimonial instance
+ */
+interface TestimonialInstance {
+    destroy: () => void;
+}
+/**
+ * Class representing a Testimonial component
+ */
+declare class Testimonial implements TestimonialInstance {
+    private selector;
+    private $element;
+    private options;
+    /**
+     * Creates an instance of Testimonial
+     * @param selector - CSS selector string or DOM Element
+     * @param options - Custom options to override defaults
+     */
+    constructor(selector: string | Element, options?: {});
+    /**
+     * Initialize the testimonial component
+     */
+    private _initialize;
+    /**
+     * Clean up event listeners
+     */
+    destroy(): void;
+}
+/**
+ * Initialize all testimonials in the document
+ * @param {string|Element} selector - CSS selector string or DOM Element
+ * @param {Object} options - Custom options to override defaults
+ * @returns {TestimonialInstance[]} Array of Testimonial instances
+ */
+export declare function initializeTestimonials(selector?: string, options?: {}): TestimonialInstance[];
+export default Testimonial;

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

@@ -0,0 +1,6 @@
+import React from 'react';
+import { TodoProps } from '../../lib/types/components';
+declare const Todo: React.FC<TodoProps>;
+export type { TodoProps };
+export default Todo;
+export { Todo };

package/dist/types/components/Todo/index.d.ts

@@ -0,0 +1 @@
+export { default } from './Todo';