@codingfactory/mediables-vue 2.0.1

package/dist/types/types/shipment.d.ts

@@ -0,0 +1,62 @@
+export interface BoxShipment {
+    box_id: string | number;
+    dimensions?: string;
+    quantity?: number;
+    is_inner_box?: boolean;
+    box?: {
+        id: string | number;
+        name?: string;
+        dimensions?: string;
+        is_inner_box?: boolean;
+        length?: number | string;
+        width?: number | string;
+        height?: number | string;
+    };
+}
+export interface ShipmentItem {
+    id: string | number;
+    product_uuid?: string;
+    product_name: string;
+    sku?: string;
+    quantity: number;
+    weight?: number | string;
+    box_id?: string | number;
+    product?: {
+        name: string;
+        sku?: string;
+        uuid?: string;
+    };
+}
+export interface Shipment {
+    id: string | number;
+    uuid?: string;
+    order_id: string | number;
+    status?: string;
+    carrier?: string;
+    service?: string;
+    tracking_number?: string;
+    tracking_url?: string;
+    package_type?: string;
+    weight?: number | string;
+    shipped_at?: string;
+    estimated_delivery?: string;
+    delivered_at?: string;
+    shipping_cost?: number | string;
+    insurance_cost?: number | string;
+    boxShipments?: BoxShipment[];
+    items?: ShipmentItem[];
+    created_at?: string;
+    updated_at?: string;
+}
+export interface BoxSearchResult {
+    id: string | number;
+    reference: string;
+    name?: string;
+    length: number;
+    width: number;
+    height: number;
+    max_weight: number;
+    empty_weight: number;
+    available_quantity: number;
+    outer_volume?: number;
+}

package/dist/types/types/shipping.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Shipping type definitions for the application
+ */
+export interface ShippingRate {
+    rate_id: string;
+    id?: string | number;
+    carrier: string;
+    service?: string;
+    service_code?: string;
+    service_name?: string;
+    description?: string;
+    delivery_days?: number | {
+        min: number;
+        max: number;
+    };
+    min_delivery_days?: number;
+    max_delivery_days?: number;
+    rate?: number;
+    total_price?: string | number;
+    currency?: string;
+    is_pickup?: boolean;
+    transit_time?: string;
+    guaranteed_service?: boolean;
+    uuid?: string;
+    sequence_id?: string | number;
+    sequence_name?: string;
+    is_combined_rate?: boolean;
+    mock?: boolean;
+    packages_details?: unknown[];
+    [key: string]: any;
+}
+export interface PickupLocation {
+    uuid: string;
+    name: string;
+    description?: string;
+    address_line1: string;
+    address_line2?: string;
+    city: string;
+    state: string;
+    state_code?: string;
+    postal_code: string;
+    country: string;
+    country_code: string;
+    phone?: string;
+    email?: string;
+    latitude?: number;
+    longitude?: number;
+    hours_of_operation?: string;
+    instructions?: string;
+    is_active: boolean;
+    sort_order?: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface ShippingMethod {
+    id: string;
+    name: string;
+    description?: string;
+    price: number;
+    currency: string;
+    carrier: string;
+    service_code: string;
+    is_active: boolean;
+    sort_order?: number;
+    is_pickup?: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface ShippingQuoteRequest {
+    destination: {
+        address1: string;
+        address2?: string;
+        city: string;
+        state: string;
+        postal_code: string;
+        country: string;
+        residential: boolean;
+    };
+    items: {
+        quantity: number;
+        weight: number;
+        length?: number;
+        width?: number;
+        height?: number;
+        price?: number;
+    }[];
+    options?: {
+        include_pickup?: boolean;
+        currency?: string;
+        delivery_confirmation?: boolean;
+        saturday_delivery?: boolean;
+    };
+}
+export interface ShippingQuoteResponse {
+    rates: ShippingRate[];
+    pickup_locations?: PickupLocation[];
+    errors?: string[];
+}

package/dist/types/types/sidebar-variations.d.ts

@@ -0,0 +1,226 @@
+export interface CardStats {
+    primary: string;
+    secondary: string;
+    trend?: string;
+}
+export interface QuickAction {
+    id: string;
+    label: string;
+    icon?: string;
+    variant?: 'default' | 'primary' | 'secondary' | 'danger';
+    disabled?: boolean;
+    data?: any;
+}
+export interface MenuAction {
+    id: string;
+    label: string;
+    icon: string;
+    data?: any;
+}
+export interface ShopProduct {
+    id: number;
+    name: string;
+    price: string;
+    originalPrice?: string;
+    image: string;
+    onSale?: boolean;
+    salePercent?: number;
+    rating?: number;
+    reviewCount?: number;
+    isNew: boolean;
+}
+export interface ProductCategory {
+    id: number;
+    name: string;
+    icon: string;
+    newCount: number;
+}
+export interface WishlistItem {
+    id: number;
+    name: string;
+    price: string;
+    image: string;
+    onSale: boolean;
+}
+export interface DashboardMetric {
+    id: number;
+    label: string;
+    value: string;
+    change: string;
+    changeType: 'positive' | 'negative' | 'neutral';
+    changeIcon: string;
+    icon: string;
+}
+export interface DashboardActivity {
+    id: number;
+    type: string;
+    icon: string;
+    text: string;
+    timestamp: Date;
+    badge?: {
+        text: string;
+        type: 'success' | 'info' | 'warning' | 'error';
+    };
+}
+export interface AdminAction {
+    id: number;
+    label: string;
+    icon: string;
+    variant: 'primary' | 'secondary' | 'danger';
+    count: number;
+    route: string;
+}
+export interface OrderPreview {
+    id: number;
+    number: string;
+    status: string;
+    total: string;
+}
+export interface NavigationItem {
+    id: string;
+    label: string;
+    icon: string;
+    route: string;
+    badge?: number | string;
+    children?: NavigationItem[];
+}
+export interface NavigationSection {
+    id: string;
+    title: string;
+    items: NavigationItem[];
+    collapsible?: boolean;
+    collapsed?: boolean;
+}
+export interface ClassicSidebarConfig {
+    showUserProfile: boolean;
+    showSearch: boolean;
+    collapsible: boolean;
+    theme: 'light' | 'dark' | 'auto';
+}
+export interface IconSidebarConfig {
+    showTooltips: boolean;
+    expandOnHover: boolean;
+    position: 'left' | 'right';
+}
+export interface GroupedSidebarConfig {
+    sections: NavigationSection[];
+    allowReorder: boolean;
+    showSectionIcons: boolean;
+}
+export interface FloatingSidebarConfig {
+    position: 'left' | 'right';
+    autoHide: boolean;
+    backdrop: boolean;
+    width: number;
+}
+export interface TabbedSidebarConfig {
+    tabs: TabConfig[];
+    defaultTab: string;
+    tabPosition: 'top' | 'bottom';
+}
+export interface TabConfig {
+    id: string;
+    label: string;
+    icon: string;
+    content: NavigationItem[];
+    badge?: number | string;
+}
+export interface CardSidebarConfig {
+    cards: CardConfig[];
+    layout: 'grid' | 'list';
+    allowCustomization: boolean;
+}
+export interface CardConfig {
+    id: string;
+    type: string;
+    title: string;
+    icon?: string;
+    color: string;
+    visible: boolean;
+    order: number;
+    stats?: CardStats;
+    actions?: QuickAction[];
+}
+export interface SidebarProps {
+    collapsed?: boolean;
+    variant?: 'classic' | 'icon' | 'grouped' | 'floating' | 'tabbed' | 'cards';
+    config?: any;
+    theme?: 'light' | 'dark' | 'auto';
+    width?: number;
+    position?: 'left' | 'right';
+}
+export interface SidebarState {
+    collapsed: boolean;
+    activeItem?: string;
+    activeTab?: string;
+    searchQuery: string;
+    customizations: Record<string, any>;
+}
+export interface LayoutConfig {
+    sidebar: SidebarProps;
+    header: {
+        show: boolean;
+        height: number;
+        sticky: boolean;
+    };
+    footer: {
+        show: boolean;
+        height: number;
+    };
+    content: {
+        padding: number;
+        maxWidth?: number;
+    };
+}
+export interface ThemeConfig {
+    colors: {
+        primary: string;
+        secondary: string;
+        accent: string;
+        background: string;
+        surface: string;
+        text: string;
+        border: string;
+    };
+    spacing: {
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+    };
+    borderRadius: {
+        sm: string;
+        md: string;
+        lg: string;
+    };
+    shadows: {
+        sm: string;
+        md: string;
+        lg: string;
+    };
+}
+export interface AnimationConfig {
+    duration: number;
+    easing: string;
+    disabled: boolean;
+}
+export interface BreakpointConfig {
+    mobile: number;
+    tablet: number;
+    desktop: number;
+    wide: number;
+}
+export interface AccessibilityConfig {
+    reduceMotion: boolean;
+    highContrast: boolean;
+    focusVisible: boolean;
+    screenReader: boolean;
+}
+export interface SidebarAnalytics {
+    clickCount: Record<string, number>;
+    timeSpent: Record<string, number>;
+    searchQueries: string[];
+    customizations: Record<string, any>;
+}
+export type { CardStats as Variation6CardStats, QuickAction as Variation6QuickAction, MenuAction as Variation6MenuAction, ShopProduct as Variation6ShopProduct, ProductCategory as Variation6ProductCategory, WishlistItem as Variation6WishlistItem, DashboardMetric as Variation6DashboardMetric, DashboardActivity as Variation6DashboardActivity, AdminAction as Variation6AdminAction, OrderPreview as Variation6OrderPreview, CardConfig as Variation6CardConfig, CardSidebarConfig as Variation6Config };

package/dist/types/types/slots.d.ts

@@ -0,0 +1,2 @@
+export type SlotName = 'header' | 'search' | 'pre-main' | 'main' | 'post-main' | 'footer' | 'sidebar';
+export declare function assertSlotName(name: string): asserts name is SlotName;

package/dist/types/types/specification-types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Shared specification types for component and storybook use
+ */
+/**
+ * Represents a value in a product specification
+ */
+export interface SpecificationValue {
+    /**
+     * The actual value of the specification
+     * @example '16' for RAM size
+     */
+    value: string | number;
+    /**
+     * Optional unit for the value
+     * @example 'GB' for RAM size
+     */
+    unit?: string;
+    /**
+     * Optional highlight to show if this value is better/worse in comparison
+     */
+    highlight?: 'better' | 'worse' | 'same';
+    /**
+     * Optional tooltip to explain the value
+     * @example 'More RAM allows for better multitasking'
+     */
+    tooltip?: string;
+}
+/**
+ * Represents a full product specification with metadata
+ */
+export interface Specification {
+    /**
+     * Icon name in the format 'collection:icon-name'
+     * @example 'heroicons:cpu-chip'
+     */
+    icon: string;
+    /**
+     * Label for the specification
+     * @example 'Processor'
+     */
+    label: string;
+    /**
+     * Value for the specification
+     * @example '16GB Unified Memory' or a SpecificationValue object
+     */
+    value: string | SpecificationValue;
+    /**
+     * Optional group name for organizing specifications
+     * @example 'Performance'
+     */
+    group?: string;
+    /**
+     * Optional key for comparison matching
+     * @example 'ram_size'
+     */
+    key?: string;
+    /**
+     * Optional comparison function for custom comparison logic
+     * @example (a, b) => Number(a.value) - Number(b.value)
+     */
+    compare?: (a: SpecificationValue, b: SpecificationValue) => number;
+    /**
+     * Optional unit conversion functions
+     * @example {
+     *   kg: (v) => v,
+     *   lbs: (v) => v * 2.20462
+     * }
+     */
+    conversions?: Record<string, (value: number) => number>;
+}

package/dist/types/types/specifications.d.ts

@@ -0,0 +1,163 @@
+/**
+ * TypeScript types for dynamic specification faceting system
+ *
+ * These types support the unified specification loading pattern
+ * across SearchModal and CategoryInstantSearch components
+ */
+import type { Ref } from 'vue';
+export interface SpecificationType {
+    uuid: string;
+    title: string;
+    slug: string;
+    name: string;
+    displayName: string;
+    field_type: 'text' | 'number' | 'select' | 'boolean' | 'color' | 'date';
+    searchable: boolean;
+    display_in_filters: boolean;
+    sort_order: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface TransformedSpecificationType {
+    /** Slug for internal use (matches FilterSidebar expectations) */
+    name: string;
+    /** Title for UI display (matches FilterSidebar expectations) */
+    displayName: string;
+    /** Original slug from API */
+    slug: string;
+    /** Original title from API */
+    title: string;
+    /** Unique identifier */
+    uuid: string;
+    /** Field type for input hints */
+    field_type: string;
+    /** Whether this specification is searchable */
+    searchable: boolean;
+    /** Whether to display in filter sidebar */
+    display_in_filters: boolean;
+    /** Sort order for display */
+    sort_order: number;
+}
+export interface SpecificationError {
+    type: 'network' | 'api' | 'parsing' | 'cache' | 'timeout' | 'discovery' | 'typesense';
+    message: string;
+    context: Record<string, any>;
+    retryable: boolean;
+    userMessage: string;
+    timestamp: Date;
+    statusCode?: number;
+}
+export interface SpecificationLoadingState {
+    loading: boolean;
+    error: SpecificationError | null;
+    lastLoaded: Date | null;
+    retryCount: number;
+}
+export interface SpecificationCache {
+    specifications: TransformedSpecificationType[];
+    categoryUuid?: string;
+    timestamp: Date;
+    ttl: number;
+}
+export interface SpecificationDiscoveryResult {
+    /** Available spec_type_slugs fields found in Typesense schema */
+    availableFields: string[];
+    /** Fields that have actual data for the current category */
+    fieldsWithData: string[];
+    /** Discovery timestamp */
+    timestamp: Date;
+    /** Category this discovery applies to */
+    categoryUuid?: string;
+}
+export interface RetryOptions {
+    maxRetries: number;
+    retryDelay: number;
+    retryBackoff: number;
+    retryableErrors: string[];
+}
+export interface FallbackStrategy {
+    type: 'cache' | 'empty' | 'hardcoded' | 'graceful';
+    data?: TransformedSpecificationType[];
+    message?: string;
+}
+/**
+ * Options for useSpecificationTypes composable
+ */
+export interface UseSpecificationTypesOptions {
+    /** Category UUID to filter specifications for */
+    categoryUuid?: string;
+    /** Cache key for storing results */
+    cacheKey?: string;
+    /** Retry configuration */
+    retryOptions?: Partial<RetryOptions>;
+    /** Fallback strategy when loading fails */
+    fallbackStrategy?: FallbackStrategy;
+    /** Cache duration in milliseconds */
+    cacheDuration?: number;
+    /** Whether to enable caching */
+    enableCache?: boolean;
+    /** Whether to load immediately on composable creation */
+    autoLoad?: boolean;
+    /** Whether to filter only specifications marked for display in filters */
+    filterDisplayOnly?: boolean;
+}
+/**
+ * Return type for useSpecificationTypes composable
+ */
+export interface UseSpecificationTypesReturn {
+    /** Reactive specifications array */
+    specifications: Ref<TransformedSpecificationType[]>;
+    /** Loading state */
+    loading: Ref<boolean>;
+    /** Current error state */
+    error: Ref<SpecificationError | null>;
+    /** Retry the last failed operation */
+    retry: () => Promise<void>;
+    /** Force refresh specifications */
+    refresh: () => Promise<void>;
+    /** Clear current error */
+    clearError: () => void;
+}
+/**
+ * Options for useSpecificationDiscovery composable
+ */
+export interface UseSpecificationDiscoveryOptions {
+    /** Category UUID to discover specifications for */
+    categoryUuid: string;
+    /** Maximum number of specifications to discover */
+    maxSpecifications?: number;
+    /** Whether to cache discovery results */
+    enableCache?: boolean;
+    /** Cache duration for discovery results */
+    cacheDuration?: number;
+}
+/**
+ * Return type for useSpecificationDiscovery composable
+ */
+export interface UseSpecificationDiscoveryReturn {
+    /** Available specification fields from Typesense */
+    availableSpecifications: Ref<string[]>;
+    /** Fields with actual data */
+    fieldsWithData: Ref<string[]>;
+    /** Discovery loading state */
+    loading: Ref<boolean>;
+    /** Discovery error state */
+    error: Ref<SpecificationError | null>;
+    /** Trigger discovery process */
+    discover: () => Promise<void>;
+    /** Clear discovery cache */
+    clearCache: () => void;
+}
+/**
+ * Recovery strategy options for error handling
+ */
+export interface RecoveryStrategy {
+    /** Strategy type */
+    type: 'retry' | 'fallback' | 'cache' | 'graceful' | 'none';
+    /** Whether to show user message */
+    showUserMessage: boolean;
+    /** Custom recovery function */
+    execute?: () => Promise<TransformedSpecificationType[]>;
+    /** Fallback data to use */
+    fallbackData?: TransformedSpecificationType[];
+}

package/dist/types/types/store.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Store-related type definitions
+ */
+export interface Store {
+    uuid: string;
+    name: string;
+    slug: string;
+    status: number;
+    type: string;
+    parent_store_uuid?: string | null;
+    contact_email?: string;
+    phone?: string;
+    profile?: {
+        description?: string;
+        address?: string;
+        city?: string;
+        state?: string;
+        zip?: string;
+        country?: string;
+        website?: string;
+        social_media?: Record<string, string>;
+    };
+    owner_uuid: string;
+    version: number;
+    theme_name?: string;
+    layout_config?: any;
+    created_at: string;
+    updated_at: string;
+    logo?: Media;
+    banner_url?: string;
+    products_count?: number;
+    rating?: number;
+    is_featured?: boolean;
+    return_policy?: string;
+    shipping_policy?: string;
+    warranty_policy?: string;
+    is_verified?: boolean;
+    fast_shipping?: boolean;
+    fulfillment_rate?: number;
+    avg_response_time?: number;
+}
+export interface StoreContextState {
+    currentStore: Store | null;
+    availableStores: Store[];
+    loading: boolean;
+    error: string | null;
+    resolutionMethod: StoreResolutionMethod | null;
+}
+export declare enum StoreResolutionMethod {
+    DOMAIN = "domain",
+    HEADER = "header",
+    SESSION = "session",
+    DEFAULT = "default",
+    MANUAL = "manual"
+}
+export interface StoreSettings {
+    store_uuid: string;
+    key: string;
+    value: any;
+    is_global: boolean;
+    created_at: string;
+    updated_at: string;
+}
+import type { Media } from './api';

package/dist/types/types/template.d.ts

@@ -0,0 +1,8 @@
+export interface BaseTemplate {
+    uuid: string;
+    name: string;
+    module_type: string;
+    description?: string;
+    template: string;
+    is_active?: boolean;
+}