@makolabs/ripple 1.9.0 → 1.9.2

package/dist/forms/market/market.d.ts

@@ -0,0 +1,255 @@
+import type { CountryCode } from './country-data.js';
+/** Enum-style map: `Market.DE === 'DE'` (ISO 3166-1 alpha-2). */
+export declare const Market: {
+    readonly AD: "AD";
+    readonly AE: "AE";
+    readonly AF: "AF";
+    readonly AG: "AG";
+    readonly AI: "AI";
+    readonly AL: "AL";
+    readonly AM: "AM";
+    readonly AO: "AO";
+    readonly AQ: "AQ";
+    readonly AR: "AR";
+    readonly AS: "AS";
+    readonly AT: "AT";
+    readonly AU: "AU";
+    readonly AW: "AW";
+    readonly AX: "AX";
+    readonly AZ: "AZ";
+    readonly BA: "BA";
+    readonly BB: "BB";
+    readonly BD: "BD";
+    readonly BE: "BE";
+    readonly BF: "BF";
+    readonly BG: "BG";
+    readonly BH: "BH";
+    readonly BI: "BI";
+    readonly BJ: "BJ";
+    readonly BL: "BL";
+    readonly BM: "BM";
+    readonly BN: "BN";
+    readonly BO: "BO";
+    readonly BQ: "BQ";
+    readonly BR: "BR";
+    readonly BS: "BS";
+    readonly BT: "BT";
+    readonly BV: "BV";
+    readonly BW: "BW";
+    readonly BY: "BY";
+    readonly BZ: "BZ";
+    readonly CA: "CA";
+    readonly CC: "CC";
+    readonly CD: "CD";
+    readonly CF: "CF";
+    readonly CG: "CG";
+    readonly CH: "CH";
+    readonly CI: "CI";
+    readonly CK: "CK";
+    readonly CL: "CL";
+    readonly CM: "CM";
+    readonly CN: "CN";
+    readonly CO: "CO";
+    readonly CR: "CR";
+    readonly CU: "CU";
+    readonly CV: "CV";
+    readonly CW: "CW";
+    readonly CX: "CX";
+    readonly CY: "CY";
+    readonly CZ: "CZ";
+    readonly DE: "DE";
+    readonly DJ: "DJ";
+    readonly DK: "DK";
+    readonly DM: "DM";
+    readonly DO: "DO";
+    readonly DZ: "DZ";
+    readonly EC: "EC";
+    readonly EE: "EE";
+    readonly EG: "EG";
+    readonly EH: "EH";
+    readonly ER: "ER";
+    readonly ES: "ES";
+    readonly ET: "ET";
+    readonly FI: "FI";
+    readonly FJ: "FJ";
+    readonly FK: "FK";
+    readonly FM: "FM";
+    readonly FO: "FO";
+    readonly FR: "FR";
+    readonly GA: "GA";
+    readonly GB: "GB";
+    readonly GD: "GD";
+    readonly GE: "GE";
+    readonly GF: "GF";
+    readonly GG: "GG";
+    readonly GH: "GH";
+    readonly GI: "GI";
+    readonly GL: "GL";
+    readonly GM: "GM";
+    readonly GN: "GN";
+    readonly GP: "GP";
+    readonly GQ: "GQ";
+    readonly GR: "GR";
+    readonly GS: "GS";
+    readonly GT: "GT";
+    readonly GU: "GU";
+    readonly GW: "GW";
+    readonly GY: "GY";
+    readonly HK: "HK";
+    readonly HM: "HM";
+    readonly HN: "HN";
+    readonly HR: "HR";
+    readonly HT: "HT";
+    readonly HU: "HU";
+    readonly ID: "ID";
+    readonly IE: "IE";
+    readonly IL: "IL";
+    readonly IM: "IM";
+    readonly IN: "IN";
+    readonly IO: "IO";
+    readonly IQ: "IQ";
+    readonly IR: "IR";
+    readonly IS: "IS";
+    readonly IT: "IT";
+    readonly JE: "JE";
+    readonly JM: "JM";
+    readonly JO: "JO";
+    readonly JP: "JP";
+    readonly KE: "KE";
+    readonly KG: "KG";
+    readonly KH: "KH";
+    readonly KI: "KI";
+    readonly KM: "KM";
+    readonly KN: "KN";
+    readonly KP: "KP";
+    readonly KR: "KR";
+    readonly KW: "KW";
+    readonly KY: "KY";
+    readonly KZ: "KZ";
+    readonly LA: "LA";
+    readonly LB: "LB";
+    readonly LC: "LC";
+    readonly LI: "LI";
+    readonly LK: "LK";
+    readonly LR: "LR";
+    readonly LS: "LS";
+    readonly LT: "LT";
+    readonly LU: "LU";
+    readonly LV: "LV";
+    readonly LY: "LY";
+    readonly MA: "MA";
+    readonly MC: "MC";
+    readonly MD: "MD";
+    readonly ME: "ME";
+    readonly MF: "MF";
+    readonly MG: "MG";
+    readonly MH: "MH";
+    readonly MK: "MK";
+    readonly ML: "ML";
+    readonly MM: "MM";
+    readonly MN: "MN";
+    readonly MO: "MO";
+    readonly MP: "MP";
+    readonly MQ: "MQ";
+    readonly MR: "MR";
+    readonly MS: "MS";
+    readonly MT: "MT";
+    readonly MU: "MU";
+    readonly MV: "MV";
+    readonly MW: "MW";
+    readonly MX: "MX";
+    readonly MY: "MY";
+    readonly MZ: "MZ";
+    readonly NA: "NA";
+    readonly NC: "NC";
+    readonly NE: "NE";
+    readonly NF: "NF";
+    readonly NG: "NG";
+    readonly NI: "NI";
+    readonly NL: "NL";
+    readonly NO: "NO";
+    readonly NP: "NP";
+    readonly NR: "NR";
+    readonly NU: "NU";
+    readonly NZ: "NZ";
+    readonly OM: "OM";
+    readonly PA: "PA";
+    readonly PE: "PE";
+    readonly PF: "PF";
+    readonly PG: "PG";
+    readonly PH: "PH";
+    readonly PK: "PK";
+    readonly PL: "PL";
+    readonly PM: "PM";
+    readonly PN: "PN";
+    readonly PR: "PR";
+    readonly PS: "PS";
+    readonly PT: "PT";
+    readonly PW: "PW";
+    readonly PY: "PY";
+    readonly QA: "QA";
+    readonly RE: "RE";
+    readonly RO: "RO";
+    readonly RS: "RS";
+    readonly RU: "RU";
+    readonly RW: "RW";
+    readonly SA: "SA";
+    readonly SB: "SB";
+    readonly SC: "SC";
+    readonly SD: "SD";
+    readonly SE: "SE";
+    readonly SG: "SG";
+    readonly SH: "SH";
+    readonly SI: "SI";
+    readonly SJ: "SJ";
+    readonly SK: "SK";
+    readonly SL: "SL";
+    readonly SM: "SM";
+    readonly SN: "SN";
+    readonly SO: "SO";
+    readonly SR: "SR";
+    readonly SS: "SS";
+    readonly ST: "ST";
+    readonly SV: "SV";
+    readonly SX: "SX";
+    readonly SY: "SY";
+    readonly SZ: "SZ";
+    readonly TC: "TC";
+    readonly TD: "TD";
+    readonly TF: "TF";
+    readonly TG: "TG";
+    readonly TH: "TH";
+    readonly TJ: "TJ";
+    readonly TK: "TK";
+    readonly TL: "TL";
+    readonly TM: "TM";
+    readonly TN: "TN";
+    readonly TO: "TO";
+    readonly TR: "TR";
+    readonly TT: "TT";
+    readonly TV: "TV";
+    readonly TW: "TW";
+    readonly TZ: "TZ";
+    readonly UA: "UA";
+    readonly UG: "UG";
+    readonly UM: "UM";
+    readonly US: "US";
+    readonly UY: "UY";
+    readonly UZ: "UZ";
+    readonly VA: "VA";
+    readonly VC: "VC";
+    readonly VE: "VE";
+    readonly VG: "VG";
+    readonly VI: "VI";
+    readonly VN: "VN";
+    readonly VU: "VU";
+    readonly WF: "WF";
+    readonly WS: "WS";
+    readonly YE: "YE";
+    readonly YT: "YT";
+    readonly ZA: "ZA";
+    readonly ZM: "ZM";
+    readonly ZW: "ZW";
+};
+/** Same as `CountryCode` — use with `Market` enum-style object. */
+export type MarketCode = CountryCode;

package/dist/forms/market/market.js

@@ -0,0 +1,252 @@
+/** Enum-style map: `Market.DE === 'DE'` (ISO 3166-1 alpha-2). */
+export const Market = {
+    AD: 'AD',
+    AE: 'AE',
+    AF: 'AF',
+    AG: 'AG',
+    AI: 'AI',
+    AL: 'AL',
+    AM: 'AM',
+    AO: 'AO',
+    AQ: 'AQ',
+    AR: 'AR',
+    AS: 'AS',
+    AT: 'AT',
+    AU: 'AU',
+    AW: 'AW',
+    AX: 'AX',
+    AZ: 'AZ',
+    BA: 'BA',
+    BB: 'BB',
+    BD: 'BD',
+    BE: 'BE',
+    BF: 'BF',
+    BG: 'BG',
+    BH: 'BH',
+    BI: 'BI',
+    BJ: 'BJ',
+    BL: 'BL',
+    BM: 'BM',
+    BN: 'BN',
+    BO: 'BO',
+    BQ: 'BQ',
+    BR: 'BR',
+    BS: 'BS',
+    BT: 'BT',
+    BV: 'BV',
+    BW: 'BW',
+    BY: 'BY',
+    BZ: 'BZ',
+    CA: 'CA',
+    CC: 'CC',
+    CD: 'CD',
+    CF: 'CF',
+    CG: 'CG',
+    CH: 'CH',
+    CI: 'CI',
+    CK: 'CK',
+    CL: 'CL',
+    CM: 'CM',
+    CN: 'CN',
+    CO: 'CO',
+    CR: 'CR',
+    CU: 'CU',
+    CV: 'CV',
+    CW: 'CW',
+    CX: 'CX',
+    CY: 'CY',
+    CZ: 'CZ',
+    DE: 'DE',
+    DJ: 'DJ',
+    DK: 'DK',
+    DM: 'DM',
+    DO: 'DO',
+    DZ: 'DZ',
+    EC: 'EC',
+    EE: 'EE',
+    EG: 'EG',
+    EH: 'EH',
+    ER: 'ER',
+    ES: 'ES',
+    ET: 'ET',
+    FI: 'FI',
+    FJ: 'FJ',
+    FK: 'FK',
+    FM: 'FM',
+    FO: 'FO',
+    FR: 'FR',
+    GA: 'GA',
+    GB: 'GB',
+    GD: 'GD',
+    GE: 'GE',
+    GF: 'GF',
+    GG: 'GG',
+    GH: 'GH',
+    GI: 'GI',
+    GL: 'GL',
+    GM: 'GM',
+    GN: 'GN',
+    GP: 'GP',
+    GQ: 'GQ',
+    GR: 'GR',
+    GS: 'GS',
+    GT: 'GT',
+    GU: 'GU',
+    GW: 'GW',
+    GY: 'GY',
+    HK: 'HK',
+    HM: 'HM',
+    HN: 'HN',
+    HR: 'HR',
+    HT: 'HT',
+    HU: 'HU',
+    ID: 'ID',
+    IE: 'IE',
+    IL: 'IL',
+    IM: 'IM',
+    IN: 'IN',
+    IO: 'IO',
+    IQ: 'IQ',
+    IR: 'IR',
+    IS: 'IS',
+    IT: 'IT',
+    JE: 'JE',
+    JM: 'JM',
+    JO: 'JO',
+    JP: 'JP',
+    KE: 'KE',
+    KG: 'KG',
+    KH: 'KH',
+    KI: 'KI',
+    KM: 'KM',
+    KN: 'KN',
+    KP: 'KP',
+    KR: 'KR',
+    KW: 'KW',
+    KY: 'KY',
+    KZ: 'KZ',
+    LA: 'LA',
+    LB: 'LB',
+    LC: 'LC',
+    LI: 'LI',
+    LK: 'LK',
+    LR: 'LR',
+    LS: 'LS',
+    LT: 'LT',
+    LU: 'LU',
+    LV: 'LV',
+    LY: 'LY',
+    MA: 'MA',
+    MC: 'MC',
+    MD: 'MD',
+    ME: 'ME',
+    MF: 'MF',
+    MG: 'MG',
+    MH: 'MH',
+    MK: 'MK',
+    ML: 'ML',
+    MM: 'MM',
+    MN: 'MN',
+    MO: 'MO',
+    MP: 'MP',
+    MQ: 'MQ',
+    MR: 'MR',
+    MS: 'MS',
+    MT: 'MT',
+    MU: 'MU',
+    MV: 'MV',
+    MW: 'MW',
+    MX: 'MX',
+    MY: 'MY',
+    MZ: 'MZ',
+    NA: 'NA',
+    NC: 'NC',
+    NE: 'NE',
+    NF: 'NF',
+    NG: 'NG',
+    NI: 'NI',
+    NL: 'NL',
+    NO: 'NO',
+    NP: 'NP',
+    NR: 'NR',
+    NU: 'NU',
+    NZ: 'NZ',
+    OM: 'OM',
+    PA: 'PA',
+    PE: 'PE',
+    PF: 'PF',
+    PG: 'PG',
+    PH: 'PH',
+    PK: 'PK',
+    PL: 'PL',
+    PM: 'PM',
+    PN: 'PN',
+    PR: 'PR',
+    PS: 'PS',
+    PT: 'PT',
+    PW: 'PW',
+    PY: 'PY',
+    QA: 'QA',
+    RE: 'RE',
+    RO: 'RO',
+    RS: 'RS',
+    RU: 'RU',
+    RW: 'RW',
+    SA: 'SA',
+    SB: 'SB',
+    SC: 'SC',
+    SD: 'SD',
+    SE: 'SE',
+    SG: 'SG',
+    SH: 'SH',
+    SI: 'SI',
+    SJ: 'SJ',
+    SK: 'SK',
+    SL: 'SL',
+    SM: 'SM',
+    SN: 'SN',
+    SO: 'SO',
+    SR: 'SR',
+    SS: 'SS',
+    ST: 'ST',
+    SV: 'SV',
+    SX: 'SX',
+    SY: 'SY',
+    SZ: 'SZ',
+    TC: 'TC',
+    TD: 'TD',
+    TF: 'TF',
+    TG: 'TG',
+    TH: 'TH',
+    TJ: 'TJ',
+    TK: 'TK',
+    TL: 'TL',
+    TM: 'TM',
+    TN: 'TN',
+    TO: 'TO',
+    TR: 'TR',
+    TT: 'TT',
+    TV: 'TV',
+    TW: 'TW',
+    TZ: 'TZ',
+    UA: 'UA',
+    UG: 'UG',
+    UM: 'UM',
+    US: 'US',
+    UY: 'UY',
+    UZ: 'UZ',
+    VA: 'VA',
+    VC: 'VC',
+    VE: 'VE',
+    VG: 'VG',
+    VI: 'VI',
+    VN: 'VN',
+    VU: 'VU',
+    WF: 'WF',
+    WS: 'WS',
+    YE: 'YE',
+    YT: 'YT',
+    ZA: 'ZA',
+    ZM: 'ZM',
+    ZW: 'ZW'
+};

package/dist/forms/segmented-control.d.ts

@@ -0,0 +1,39 @@
+import type { VariantColors, VariantSizes } from '../index.js';
+export declare const segmentedTrack: import("tailwind-variants").TVReturnType<{
+    appearance: {
+        surface: string;
+        inverted: string;
+    };
+    orientation: {
+        horizontal: string;
+        vertical: string;
+    };
+}, undefined, "inline-flex overflow-hidden rounded-lg border p-0.5", {
+    appearance: {
+        surface: string;
+        inverted: string;
+    };
+    orientation: {
+        horizontal: string;
+        vertical: string;
+    };
+}, undefined, import("tailwind-variants").TVReturnType<{
+    appearance: {
+        surface: string;
+        inverted: string;
+    };
+    orientation: {
+        horizontal: string;
+        vertical: string;
+    };
+}, undefined, "inline-flex overflow-hidden rounded-lg border p-0.5", unknown, unknown, undefined>>;
+export declare function segmentClasses(args: {
+    selected: boolean;
+    disabled: boolean;
+    appearance: 'surface' | 'inverted';
+    color: VariantColors;
+    size: VariantSizes;
+    isFirst: boolean;
+    isLast: boolean;
+    orientation: 'horizontal' | 'vertical';
+}): string;

package/dist/forms/segmented-control.js

@@ -0,0 +1,54 @@
+import { tv } from 'tailwind-variants';
+import { cn } from '../helper/cls.js';
+import { Color, Size } from '../variants.js';
+export const segmentedTrack = tv({
+    base: 'inline-flex overflow-hidden rounded-lg border p-0.5',
+    variants: {
+        appearance: {
+            surface: 'border-default-200 bg-default-50',
+            inverted: 'border-white/20 bg-white/5'
+        },
+        orientation: {
+            horizontal: 'flex-row',
+            vertical: 'w-full flex-col'
+        }
+    },
+    defaultVariants: {
+        appearance: 'surface',
+        orientation: 'horizontal'
+    }
+});
+const selectedByColor = {
+    [Color.DEFAULT]: 'bg-default-800 text-white shadow-sm',
+    [Color.PRIMARY]: 'bg-primary-600 text-white shadow-sm',
+    [Color.SECONDARY]: 'bg-secondary-600 text-white shadow-sm',
+    [Color.INFO]: 'bg-info-600 text-white shadow-sm',
+    [Color.SUCCESS]: 'bg-success-600 text-white shadow-sm',
+    [Color.WARNING]: 'bg-warning-600 text-white shadow-sm',
+    [Color.DANGER]: 'bg-danger-600 text-white shadow-sm'
+};
+const segmentSize = {
+    [Size.XS]: 'gap-1 px-2 py-1 text-xs',
+    [Size.SM]: 'gap-1.5 px-2.5 py-1.5 text-xs',
+    [Size.BASE]: 'gap-1.5 px-3 py-1.5 text-sm',
+    [Size.LG]: 'gap-2 px-4 py-2 text-base',
+    [Size.XL]: 'gap-2 px-4 py-2.5 text-lg',
+    [Size.XXL]: 'gap-2 px-5 py-3 text-xl'
+};
+export function segmentClasses(args) {
+    const { selected, disabled, appearance, color, size, isFirst, isLast, orientation } = args;
+    const rounding = orientation === 'horizontal'
+        ? cn(isFirst && 'rounded-l-md', isLast && 'rounded-r-md')
+        : cn(isFirst && 'rounded-t-md', isLast && 'rounded-b-md');
+    const base = cn('flex cursor-pointer items-center justify-center font-medium transition-colors duration-150', 'focus-visible:ring-primary-500 focus-visible:ring-2 focus-visible:outline-none', appearance === 'inverted' ? 'focus-visible:ring-offset-0' : 'focus-visible:ring-offset-2', segmentSize[size], rounding, disabled && 'cursor-not-allowed opacity-50');
+    if (disabled) {
+        return cn(base, 'text-default-400');
+    }
+    if (selected) {
+        return cn(base, selectedByColor[color]);
+    }
+    if (appearance === 'surface') {
+        return cn(base, 'text-default-700 hover:bg-white/90', 'bg-transparent');
+    }
+    return cn(base, 'text-default-200 hover:bg-white/10', 'bg-transparent');
+}

package/dist/index.d.ts

@@ -29,7 +29,13 @@ export type { TabItem, TabProps, TabsGroupProps, TabContentProps } from './layou
 export type { NavbarLinkItem, NavbarProps } from './layout/navbar/navbar-types.js';
 export type { MenuBar, BaseNavigationItem, WithIcon, Activatable, LinkItem, ParentItem, DividerItem, NavigationItem, LogoType, NavGroupProps, NavItemProps, SidebarProps } from './layout/sidebar/sidebar-types.js';
 export type { ChartColorKey, ChartColorValue, ChartColors, ChartType, ChartColorString, XAxisConfig, YAxisConfig, SeriesConfig, GridConfig, LegendConfig, TooltipConfig, ToolboxConfig, ChartConfig, PointClickType, ChartRenderType, ChartProps } from './charts/chart-types.js';
-export type { FormProps, InputProps, RadioOption, RadioInputsProps, CheckboxProps, ToggleProps, CurrencyOption, NumberInputProps, DateRangeProps, DateSelectEvent, TagsProps, SliderMode, NotationType, EnumOption, SliderProps, RadioPillProps } from './forms/form-types.js';
+export type { FormProps, InputProps, RadioOption, RadioInputsProps, CheckboxProps, ToggleProps, CurrencyOption, NumberInputProps, DateRangeProps, DateSelectEvent, TagsProps, SliderMode, NotationType, EnumOption, SliderProps, RadioPillProps, SegmentedOption, SegmentedControlProps } from './forms/form-types.js';
+export type { CountryCode } from './forms/market/country-data.js';
+export type { MarketCode } from './forms/market/market.js';
+export { ALL_COUNTRY_CODES, COUNTRY_NAMES } from './forms/market/country-data.js';
+export { Market } from './forms/market/market.js';
+export type { MarketSelectorProps } from './forms/market/market-selector-types.js';
+export { countryCodeToFlagEmoji } from './forms/market/flag-emoji.js';
 export type { ProgressSegment, ProgressProps } from './elements/progress/progress-types.js';
 export type { AccordionProps } from './elements/accordion/accordion-types.js';
 export type { TimelineItem } from './elements/timeline/timeline-types.js';
@@ -87,6 +93,8 @@ export { default as NumberInput } from './forms/NumberInput.svelte';
 export { default as DateRange } from './forms/DateRange.svelte';
 export { default as Tags } from './forms/Tags.svelte';
 export { default as RadioPill } from './forms/RadioPill.svelte';
+export { default as SegmentedControl } from './forms/SegmentedControl.svelte';
+export { default as MarketSelector } from './forms/MarketSelector.svelte';
 export { dropdownMenu } from './elements/dropdown/dropdown.js';
 export { badge } from './elements/badge/badge.js';
 export { buttonVariants } from './button/button.js';
@@ -98,6 +106,7 @@ export { metricCard } from './layout/card/metric-card.js';
 export { rankedCard } from './layout/card/ranked-card.js';
 export { activityList } from './layout/activity-list/activity-list.js';
 export { slider } from './forms/slider.js';
+export { segmentedTrack, segmentClasses } from './forms/segmented-control.js';
 export { CompactFilters } from './filters/index.js';
 export * from './file-browser/index.js';
 export * from './adapters/storage/index.js';

package/dist/index.js

@@ -9,6 +9,9 @@ import { ChartColor, Color, Size } from './variants.js';
  */
 export { Color, Size, ChartColor };
 export { buildTestId } from './helper/testid.js';
+export { ALL_COUNTRY_CODES, COUNTRY_NAMES } from './forms/market/country-data.js';
+export { Market } from './forms/market/market.js';
+export { countryCodeToFlagEmoji } from './forms/market/flag-emoji.js';
 // ============================================================================
 // Helper utilities
 // ============================================================================
@@ -84,6 +87,8 @@ export { default as NumberInput } from './forms/NumberInput.svelte';
 export { default as DateRange } from './forms/DateRange.svelte';
 export { default as Tags } from './forms/Tags.svelte';
 export { default as RadioPill } from './forms/RadioPill.svelte';
+export { default as SegmentedControl } from './forms/SegmentedControl.svelte';
+export { default as MarketSelector } from './forms/MarketSelector.svelte';
 // ============================================================================
 // Component Variant Utilities
 // ============================================================================
@@ -98,6 +103,7 @@ export { metricCard } from './layout/card/metric-card.js';
 export { rankedCard } from './layout/card/ranked-card.js';
 export { activityList } from './layout/activity-list/activity-list.js';
 export { slider } from './forms/slider.js';
+export { segmentedTrack, segmentClasses } from './forms/segmented-control.js';
 // ============================================================================
 // Re-export filters
 // ============================================================================

package/dist/layout/sidebar/Sidebar.svelte

@@ -6,7 +6,7 @@
 	import { resolve } from '$app/paths';
 	import { buildTestId } from '../../helper/testid.js';
 
-	let { items = [], logo, footer, testId }: SidebarProps = $props();
+	let { items = [], logo, belowLogo, footer, testId }: SidebarProps = $props();
 	let menubar: MenuBar = $state({
 		collapsed: false
 	});
@@ -115,6 +115,15 @@
 		</button>
 	</div>
 
+	{#if belowLogo}
+		<div
+			class="shrink-0 border-b border-white/10 px-3 py-3"
+			data-testid={buildTestId('sidebar', 'below-logo', testId)}
+		>
+			{@render belowLogo({ collapsed: menubar.collapsed })}
+		</div>
+	{/if}
+
 	<div class="flex flex-1 flex-col overflow-y-auto bg-gradient-to-b from-transparent to-black/20">
 		<nav class="flex-1 space-y-6 px-2 py-4">
 			{#each navigationItems as item, index (index)}

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

@@ -51,6 +51,10 @@ export interface NavItemProps {
 export interface SidebarProps {
     items?: NavigationItem[];
     logo: LogoType;
+    /** Optional snippet between the logo row and the navigation (receives collapse state) */
+    belowLogo?: Snippet<[{
+        collapsed: boolean;
+    }]>;
     /** Optional footer snippet rendered at the bottom of the sidebar */
     footer?: Snippet<[{
         collapsed: boolean;