@opensite/ui 0.4.1 → 0.4.3

package/dist/navbar-enterprise-mega.d.cts

@@ -1,84 +1,232 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { P as PatternName } from './pattern-background-BXRgbd05.cjs';
+import { P as PatternName } from './pattern-background-a7gKHzHy.cjs';
 import { SectionBackground, SectionSpacing } from './types.cjs';
 import { A as ActionConfig, O as OptixFlowConfig } from './blocks-Cohq4eio.cjs';
-import './patternSvgs-c5ZNVoTT.cjs';
 import 'class-variance-authority';
 import './button-variants-lRElsmTc.cjs';
 import 'class-variance-authority/types';
 
-interface SubpageItem {
+/**
+ * SHARED BASE TYPE INTERFACES
+ * These types provide a consistent interface across navbar components
+ */
+/**
+ * Base link item - used across all navbar components
+ */
+interface ILinkItem {
+    label: React.ReactNode;
+    description?: React.ReactNode;
+    url: string;
+    icon?: React.ReactNode;
+    iconName?: string;
+    image?: string;
+    background?: string;
+}
+/**
+ * Group of links with optional metadata
+ */
+interface IMenuLinkGroup {
+    label: React.ReactNode;
+    description?: string;
+    image?: string;
+    links: ILinkItem[];
+}
+/**
+ * SPECIALIZED TYPE INTERFACES FOR ENTERPRISE MEGA MENU
+ * These extend the base types for specific layout requirements
+ */
+/**
+ * Subpage item for solution cards
+ */
+interface ISubpageItem {
     id: string;
     title: string;
     href: string;
     icon: string;
 }
-interface SolutionItem {
+/**
+ * Solution card with bordered layout and subpages
+ */
+interface ISolutionCard {
     id: string;
     title: string;
     description: string;
     href: string;
-    subpages: SubpageItem[];
+    subpages: ISubpageItem[];
 }
-interface TechnologyItem {
+/**
+ * Technology/platform item for developer platform section
+ */
+interface ITechnologyItem {
     id: string;
     title: string;
     href: string;
     icon: string;
 }
-interface ProductItem {
+/**
+ * Product item with image
+ */
+interface IProductItem {
     id: string;
     title: string;
     description: string;
     href: string;
     image: string;
 }
-interface ProductCategory {
+/**
+ * Product category grouping
+ */
+interface IProductCategory {
     title: string;
-    products: ProductItem[];
+    products: IProductItem[];
 }
-interface FeatureItem {
+/**
+ * Feature item with icon
+ */
+interface IFeatureItem {
     id: string;
     title: string;
     description: string;
     href: string;
     icon: string;
 }
-interface GlobalCategory {
+/**
+ * Feature category grouping
+ */
+interface IFeatureCategory {
     title: string;
-    features: FeatureItem[];
+    features: IFeatureItem[];
 }
-interface LocationItem {
+/**
+ * Location item for location grids
+ */
+interface ILocationItem {
     title: string;
     href: string;
     icon: string;
 }
-interface RegionItem {
+/**
+ * Region grouping for locations
+ */
+interface IRegionItem {
     title: string;
-    locations: LocationItem[];
+    locations: ILocationItem[];
 }
-interface ResourceItem {
+/**
+ * Resource card item
+ */
+interface IResourceItem {
     id: string;
     title: string;
     description: string;
     href: string;
     icon: string;
 }
-interface TopicItem {
+/**
+ * Topic item for sidebar
+ */
+interface ITopicItem {
     id: string;
     title: string;
     href: string;
     icon: string;
 }
-interface TopicGroup {
+/**
+ * Topic group for sidebar sections
+ */
+interface ITopicGroup {
+    title: string;
+    topics: ITopicItem[];
+}
+/**
+ * Featured hero card configuration
+ */
+interface IFeaturedHeroCard {
     title: string;
-    topics: TopicItem[];
+    subtitle?: string;
+    description: string;
+    href: string;
+    image: string;
+    imagePosition?: "top" | "bottom" | "background";
+    variant?: "primary" | "accent";
 }
-interface MenuItem {
+/**
+ * Partner card configuration
+ */
+interface IPartnerCard {
     title: string;
-    url?: string;
-    menuType?: "solutions" | "products" | "global" | "partners" | "resources";
+    description: string;
+    href: string;
+    icon: string;
+}
+/**
+ * Mega menu layout types
+ *
+ * LAYOUT OPTIONS FOR AI PAGE BUILDER:
+ *
+ * 1. "solutions-with-platform"
+ *    - Visual: Left column shows solution cards with expandable subpages, right column shows platform technologies and featured hero card
+ *    - Behavior: Solution cards expand to show subpages on hover
+ *    - Best for: Enterprise solutions with multiple sub-offerings and technology stack showcase
+ *    - Required data: solutionCards[] with title, description, href, subpages[]
+ *                     platformItems[] with title, icon, description
+ *                     featuredHeroCard (optional) with title, description, href, image
+ *    - Example use case: "Solutions" menu showing Enterprise, SMB, Startup solutions with React/Node/Python tech stack
+ *
+ * 2. "products-categorized"
+ *    - Visual: Left column shows product categories with nested products, right column shows featured hero card
+ *    - Behavior: Categories organize products hierarchically
+ *    - Best for: Large product catalogs organized by category
+ *    - Required data: productCategories[] with title and products[] (each with title, href, description, image)
+ *                     featuredHeroCard (optional)
+ *    - Example use case: "Products" menu with categories like Analytics, Marketing, Sales
+ *
+ * 3. "features-with-locations"
+ *    - Visual: Left column shows feature categories with nested features, right column shows geographic regions and featured hero card
+ *    - Behavior: Features organized by category, regions shown as list
+ *    - Best for: Global companies showcasing features and regional presence
+ *    - Required data: featureCategories[] with title and features[] (each with title, href, description, icon)
+ *                     regions[] with name, href, flag (optional)
+ *                     featuredHeroCard (optional)
+ *    - Example use case: "Company" menu showing features by category and office locations
+ *
+ * 4. "partners-promotional"
+ *    - Visual: Grid of partner cards with logos and descriptions, plus featured hero card
+ *    - Behavior: Partner cards in 2-column grid with hover effects
+ *    - Best for: Partner/integration showcases with promotional content
+ *    - Required data: partnerCards[] with title, description, href, logo, badge (optional)
+ *                     featuredHeroCard (optional)
+ *    - Example use case: "Partners" menu showing integration partners and partner program
+ *
+ * 5. "resources-with-topics"
+ *    - Visual: Left column shows resource items, right column shows topic groups and featured hero card
+ *    - Behavior: Resources as cards, topics organized in groups
+ *    - Best for: Learning resources, documentation, and content hubs
+ *    - Required data: resourceItems[] with title, description, href, icon
+ *                     topicGroups[] with title and topics[] (each with title, href, icon)
+ *                     featuredHeroCard (optional)
+ *    - Example use case: "Resources" menu with docs, guides, blog, organized by learning topics
+ */
+type MegaMenuLayout = "solutions-with-platform" | "products-categorized" | "features-with-locations" | "partners-promotional" | "resources-with-topics";
+/**
+ * Menu link interface for enterprise mega menu
+ */
+interface IMenuLink {
+    label: React.ReactNode;
+    href?: string;
+    layout?: MegaMenuLayout;
+    links?: ILinkItem[];
+    dropdownGroups?: IMenuLinkGroup[];
+    featuredHeroCard?: IFeaturedHeroCard;
+    solutionCards?: ISolutionCard[];
+    platformItems?: ITechnologyItem[];
+    productCategories?: IProductCategory[];
+    featureCategories?: IFeatureCategory[];
+    regions?: IRegionItem[];
+    partnerCards?: IPartnerCard[];
+    resourceItems?: IResourceItem[];
+    topicGroups?: ITopicGroup[];
 }
 /**
  * Logo configuration interface
@@ -127,45 +275,17 @@ interface NavbarEnterpriseMegaProps {
      */
     logoSlot?: React.ReactNode;
     /**
-     * Navigation menu items
-     */
-    navigation?: MenuItem[];
-    /**
-     * Solutions for Solutions menu
-     */
-    solutions?: SolutionItem[];
-    /**
-     * Solution technologies for Solutions menu
-     */
-    solutionTechnologies?: TechnologyItem[];
-    /**
-     * Product categories for Products menu
-     */
-    productCategories?: ProductCategory[];
-    /**
-     * Global categories for Global menu
-     */
-    globalCategories?: GlobalCategory[];
-    /**
-     * Regions for Global menu
-     */
-    regions?: RegionItem[];
-    /**
-     * Resources for Resources menu
-     */
-    resources?: ResourceItem[];
-    /**
-     * Topic groups for Resources menu
+     * Navigation menu links with mega menu configurations
      */
-    topicGroups?: TopicGroup[];
+    menuLinks?: IMenuLink[];
     /**
-     * Authentication action configurations
+     * Action configurations (e.g., login, signup buttons)
      */
-    authActions?: ActionConfig[];
+    actions?: ActionConfig[];
     /**
-     * Custom slot for auth actions (overrides authActions array)
+     * Custom slot for actions (overrides actions array)
      */
-    authActionsSlot?: React.ReactNode;
+    actionsSlot?: React.ReactNode;
     /**
      * Background style for the section
      */
@@ -177,7 +297,7 @@ interface NavbarEnterpriseMegaProps {
     /**
      * Optional background pattern name or URL
      */
-    pattern?: PatternName | string;
+    pattern?: PatternName | undefined;
     /**
      * Pattern overlay opacity (0-1)
      */
@@ -197,6 +317,6 @@ interface NavbarEnterpriseMegaProps {
  * cards. Each menu spans full width with rich content layouts. Mobile view uses a full-screen sheet
  * with accordion navigation. Ideal for large enterprise SaaS platforms and B2B software companies.
  */
-declare const NavbarEnterpriseMega: ({ className, containerClassName, navClassName, navigationMenuClassName, actionsClassName, logoClassName, logo, logoSlot, navigation, solutions, solutionTechnologies, productCategories, globalCategories, regions, resources, topicGroups, authActions, authActionsSlot, background, spacing, pattern, patternOpacity, optixFlowConfig, }: NavbarEnterpriseMegaProps) => react_jsx_runtime.JSX.Element;
+declare const NavbarEnterpriseMega: ({ className, containerClassName, navClassName, navigationMenuClassName, actionsClassName, logoClassName, logo, logoSlot, menuLinks, actions, actionsSlot, background, spacing, pattern, patternOpacity, optixFlowConfig, }: NavbarEnterpriseMegaProps) => react_jsx_runtime.JSX.Element;
 
-export { NavbarEnterpriseMega, type NavbarEnterpriseMegaProps };
+export { type IFeatureCategory, type IFeatureItem, type IFeaturedHeroCard, type ILinkItem, type ILocationItem, type IMenuLink, type IMenuLinkGroup, type IPartnerCard, type IProductCategory, type IProductItem, type IRegionItem, type IResourceItem, type ISolutionCard, type ISubpageItem, type ITechnologyItem, type ITopicGroup, type ITopicItem, type LogoConfig, type MegaMenuLayout, NavbarEnterpriseMega, type NavbarEnterpriseMegaProps };

package/dist/navbar-enterprise-mega.d.ts

@@ -1,84 +1,232 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { P as PatternName } from './pattern-background-z0e5HB0v.js';
+import { P as PatternName } from './pattern-background-a7gKHzHy.js';
 import { SectionBackground, SectionSpacing } from './types.js';
 import { A as ActionConfig, O as OptixFlowConfig } from './blocks-k17uluAz.js';
-import './patternSvgs-c5ZNVoTT.js';
 import 'class-variance-authority';
 import './button-variants-lRElsmTc.js';
 import 'class-variance-authority/types';
 
-interface SubpageItem {
+/**
+ * SHARED BASE TYPE INTERFACES
+ * These types provide a consistent interface across navbar components
+ */
+/**
+ * Base link item - used across all navbar components
+ */
+interface ILinkItem {
+    label: React.ReactNode;
+    description?: React.ReactNode;
+    url: string;
+    icon?: React.ReactNode;
+    iconName?: string;
+    image?: string;
+    background?: string;
+}
+/**
+ * Group of links with optional metadata
+ */
+interface IMenuLinkGroup {
+    label: React.ReactNode;
+    description?: string;
+    image?: string;
+    links: ILinkItem[];
+}
+/**
+ * SPECIALIZED TYPE INTERFACES FOR ENTERPRISE MEGA MENU
+ * These extend the base types for specific layout requirements
+ */
+/**
+ * Subpage item for solution cards
+ */
+interface ISubpageItem {
     id: string;
     title: string;
     href: string;
     icon: string;
 }
-interface SolutionItem {
+/**
+ * Solution card with bordered layout and subpages
+ */
+interface ISolutionCard {
     id: string;
     title: string;
     description: string;
     href: string;
-    subpages: SubpageItem[];
+    subpages: ISubpageItem[];
 }
-interface TechnologyItem {
+/**
+ * Technology/platform item for developer platform section
+ */
+interface ITechnologyItem {
     id: string;
     title: string;
     href: string;
     icon: string;
 }
-interface ProductItem {
+/**
+ * Product item with image
+ */
+interface IProductItem {
     id: string;
     title: string;
     description: string;
     href: string;
     image: string;
 }
-interface ProductCategory {
+/**
+ * Product category grouping
+ */
+interface IProductCategory {
     title: string;
-    products: ProductItem[];
+    products: IProductItem[];
 }
-interface FeatureItem {
+/**
+ * Feature item with icon
+ */
+interface IFeatureItem {
     id: string;
     title: string;
     description: string;
     href: string;
     icon: string;
 }
-interface GlobalCategory {
+/**
+ * Feature category grouping
+ */
+interface IFeatureCategory {
     title: string;
-    features: FeatureItem[];
+    features: IFeatureItem[];
 }
-interface LocationItem {
+/**
+ * Location item for location grids
+ */
+interface ILocationItem {
     title: string;
     href: string;
     icon: string;
 }
-interface RegionItem {
+/**
+ * Region grouping for locations
+ */
+interface IRegionItem {
     title: string;
-    locations: LocationItem[];
+    locations: ILocationItem[];
 }
-interface ResourceItem {
+/**
+ * Resource card item
+ */
+interface IResourceItem {
     id: string;
     title: string;
     description: string;
     href: string;
     icon: string;
 }
-interface TopicItem {
+/**
+ * Topic item for sidebar
+ */
+interface ITopicItem {
     id: string;
     title: string;
     href: string;
     icon: string;
 }
-interface TopicGroup {
+/**
+ * Topic group for sidebar sections
+ */
+interface ITopicGroup {
+    title: string;
+    topics: ITopicItem[];
+}
+/**
+ * Featured hero card configuration
+ */
+interface IFeaturedHeroCard {
     title: string;
-    topics: TopicItem[];
+    subtitle?: string;
+    description: string;
+    href: string;
+    image: string;
+    imagePosition?: "top" | "bottom" | "background";
+    variant?: "primary" | "accent";
 }
-interface MenuItem {
+/**
+ * Partner card configuration
+ */
+interface IPartnerCard {
     title: string;
-    url?: string;
-    menuType?: "solutions" | "products" | "global" | "partners" | "resources";
+    description: string;
+    href: string;
+    icon: string;
+}
+/**
+ * Mega menu layout types
+ *
+ * LAYOUT OPTIONS FOR AI PAGE BUILDER:
+ *
+ * 1. "solutions-with-platform"
+ *    - Visual: Left column shows solution cards with expandable subpages, right column shows platform technologies and featured hero card
+ *    - Behavior: Solution cards expand to show subpages on hover
+ *    - Best for: Enterprise solutions with multiple sub-offerings and technology stack showcase
+ *    - Required data: solutionCards[] with title, description, href, subpages[]
+ *                     platformItems[] with title, icon, description
+ *                     featuredHeroCard (optional) with title, description, href, image
+ *    - Example use case: "Solutions" menu showing Enterprise, SMB, Startup solutions with React/Node/Python tech stack
+ *
+ * 2. "products-categorized"
+ *    - Visual: Left column shows product categories with nested products, right column shows featured hero card
+ *    - Behavior: Categories organize products hierarchically
+ *    - Best for: Large product catalogs organized by category
+ *    - Required data: productCategories[] with title and products[] (each with title, href, description, image)
+ *                     featuredHeroCard (optional)
+ *    - Example use case: "Products" menu with categories like Analytics, Marketing, Sales
+ *
+ * 3. "features-with-locations"
+ *    - Visual: Left column shows feature categories with nested features, right column shows geographic regions and featured hero card
+ *    - Behavior: Features organized by category, regions shown as list
+ *    - Best for: Global companies showcasing features and regional presence
+ *    - Required data: featureCategories[] with title and features[] (each with title, href, description, icon)
+ *                     regions[] with name, href, flag (optional)
+ *                     featuredHeroCard (optional)
+ *    - Example use case: "Company" menu showing features by category and office locations
+ *
+ * 4. "partners-promotional"
+ *    - Visual: Grid of partner cards with logos and descriptions, plus featured hero card
+ *    - Behavior: Partner cards in 2-column grid with hover effects
+ *    - Best for: Partner/integration showcases with promotional content
+ *    - Required data: partnerCards[] with title, description, href, logo, badge (optional)
+ *                     featuredHeroCard (optional)
+ *    - Example use case: "Partners" menu showing integration partners and partner program
+ *
+ * 5. "resources-with-topics"
+ *    - Visual: Left column shows resource items, right column shows topic groups and featured hero card
+ *    - Behavior: Resources as cards, topics organized in groups
+ *    - Best for: Learning resources, documentation, and content hubs
+ *    - Required data: resourceItems[] with title, description, href, icon
+ *                     topicGroups[] with title and topics[] (each with title, href, icon)
+ *                     featuredHeroCard (optional)
+ *    - Example use case: "Resources" menu with docs, guides, blog, organized by learning topics
+ */
+type MegaMenuLayout = "solutions-with-platform" | "products-categorized" | "features-with-locations" | "partners-promotional" | "resources-with-topics";
+/**
+ * Menu link interface for enterprise mega menu
+ */
+interface IMenuLink {
+    label: React.ReactNode;
+    href?: string;
+    layout?: MegaMenuLayout;
+    links?: ILinkItem[];
+    dropdownGroups?: IMenuLinkGroup[];
+    featuredHeroCard?: IFeaturedHeroCard;
+    solutionCards?: ISolutionCard[];
+    platformItems?: ITechnologyItem[];
+    productCategories?: IProductCategory[];
+    featureCategories?: IFeatureCategory[];
+    regions?: IRegionItem[];
+    partnerCards?: IPartnerCard[];
+    resourceItems?: IResourceItem[];
+    topicGroups?: ITopicGroup[];
 }
 /**
  * Logo configuration interface
@@ -127,45 +275,17 @@ interface NavbarEnterpriseMegaProps {
      */
     logoSlot?: React.ReactNode;
     /**
-     * Navigation menu items
-     */
-    navigation?: MenuItem[];
-    /**
-     * Solutions for Solutions menu
-     */
-    solutions?: SolutionItem[];
-    /**
-     * Solution technologies for Solutions menu
-     */
-    solutionTechnologies?: TechnologyItem[];
-    /**
-     * Product categories for Products menu
-     */
-    productCategories?: ProductCategory[];
-    /**
-     * Global categories for Global menu
-     */
-    globalCategories?: GlobalCategory[];
-    /**
-     * Regions for Global menu
-     */
-    regions?: RegionItem[];
-    /**
-     * Resources for Resources menu
-     */
-    resources?: ResourceItem[];
-    /**
-     * Topic groups for Resources menu
+     * Navigation menu links with mega menu configurations
      */
-    topicGroups?: TopicGroup[];
+    menuLinks?: IMenuLink[];
     /**
-     * Authentication action configurations
+     * Action configurations (e.g., login, signup buttons)
      */
-    authActions?: ActionConfig[];
+    actions?: ActionConfig[];
     /**
-     * Custom slot for auth actions (overrides authActions array)
+     * Custom slot for actions (overrides actions array)
      */
-    authActionsSlot?: React.ReactNode;
+    actionsSlot?: React.ReactNode;
     /**
      * Background style for the section
      */
@@ -177,7 +297,7 @@ interface NavbarEnterpriseMegaProps {
     /**
      * Optional background pattern name or URL
      */
-    pattern?: PatternName | string;
+    pattern?: PatternName | undefined;
     /**
      * Pattern overlay opacity (0-1)
      */
@@ -197,6 +317,6 @@ interface NavbarEnterpriseMegaProps {
  * cards. Each menu spans full width with rich content layouts. Mobile view uses a full-screen sheet
  * with accordion navigation. Ideal for large enterprise SaaS platforms and B2B software companies.
  */
-declare const NavbarEnterpriseMega: ({ className, containerClassName, navClassName, navigationMenuClassName, actionsClassName, logoClassName, logo, logoSlot, navigation, solutions, solutionTechnologies, productCategories, globalCategories, regions, resources, topicGroups, authActions, authActionsSlot, background, spacing, pattern, patternOpacity, optixFlowConfig, }: NavbarEnterpriseMegaProps) => react_jsx_runtime.JSX.Element;
+declare const NavbarEnterpriseMega: ({ className, containerClassName, navClassName, navigationMenuClassName, actionsClassName, logoClassName, logo, logoSlot, menuLinks, actions, actionsSlot, background, spacing, pattern, patternOpacity, optixFlowConfig, }: NavbarEnterpriseMegaProps) => react_jsx_runtime.JSX.Element;
 
-export { NavbarEnterpriseMega, type NavbarEnterpriseMegaProps };
+export { type IFeatureCategory, type IFeatureItem, type IFeaturedHeroCard, type ILinkItem, type ILocationItem, type IMenuLink, type IMenuLinkGroup, type IPartnerCard, type IProductCategory, type IProductItem, type IRegionItem, type IResourceItem, type ISolutionCard, type ISubpageItem, type ITechnologyItem, type ITopicGroup, type ITopicItem, type LogoConfig, type MegaMenuLayout, NavbarEnterpriseMega, type NavbarEnterpriseMegaProps };