@ugurdemirel/landcraft 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,589 @@
+import { ButtonHTMLAttributes } from 'react';
+import { ClassValue } from 'clsx';
+import { ElementType } from 'react';
+import { ForwardRefExoticComponent } from 'react';
+import { HTMLAttributes } from 'react';
+import { JSX as JSX_2 } from 'react';
+import { ReactNode } from 'react';
+import { RefAttributes } from 'react';
+import { SVGProps } from 'react';
+
+export declare const ArrowDown: (props: IconProps) => JSX_2.Element;
+
+export declare const ArrowRight: (props: IconProps) => JSX_2.Element;
+
+export declare const ArrowUp: (props: IconProps) => JSX_2.Element;
+
+export declare const ArrowUpRight: (props: IconProps) => JSX_2.Element;
+
+export declare const Badge: ForwardRefExoticComponent<BadgeProps & RefAttributes<HTMLSpanElement>>;
+
+export declare interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
+    variant?: BadgeVariant;
+    size?: BadgeSize;
+    icon?: ReactNode;
+    /** Paints the chip with an arbitrary CSS color; text color is computed for contrast. */
+    customColor?: string;
+}
+
+export declare type BadgeSize = "sm" | "md";
+
+export declare type BadgeVariant = "solid" | "soft" | "outline" | "dot";
+
+export declare const BarChart: (props: IconProps) => JSX_2.Element;
+
+export declare interface BlogAuthor {
+    name: string;
+    avatar?: ReactNode;
+}
+
+export declare const BlogCard: ForwardRefExoticComponent<BlogCardProps & RefAttributes<HTMLAnchorElement>>;
+
+export declare interface BlogCardProps extends HTMLAttributes<HTMLAnchorElement> {
+    post: BlogPost;
+    option?: "card" | "row";
+}
+
+export declare interface BlogPost {
+    title: string;
+    excerpt?: string;
+    /** Display date, e.g. "12 Aug 2026". */
+    date: string;
+    readTime?: string;
+    category?: string;
+    cover?: string;
+    /** Arbitrary CSS color for the cover placeholder accent. */
+    accent?: string;
+    href?: string;
+    author?: BlogAuthor;
+}
+
+export declare const BlogSection: ForwardRefExoticComponent<BlogSectionProps & RefAttributes<HTMLElement>>;
+
+export declare interface BlogSectionProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    posts: BlogPost[];
+    /** Show only the first N posts. */
+    limit?: number;
+    columns?: 2 | 3;
+    option?: "card" | "row";
+    eyebrow?: ReactNode;
+    eyebrowStyle?: "caps" | "soft" | "plain";
+    title?: ReactNode;
+    description?: ReactNode;
+    showAllLabel?: string;
+    showAllHref?: string;
+}
+
+export declare const Box: (props: IconProps) => JSX_2.Element;
+
+export declare const Button: ForwardRefExoticComponent<ButtonProps & RefAttributes<HTMLButtonElement>>;
+
+export declare interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: ButtonVariant;
+    size?: ButtonSize;
+    iconLeft?: ReactNode;
+    iconRight?: ReactNode;
+    /** Paints the button with an arbitrary CSS color; text color is computed for contrast. */
+    customColor?: string;
+    fullWidth?: boolean;
+}
+
+export declare type ButtonSize = "sm" | "md" | "lg";
+
+export declare type ButtonVariant = "primary" | "dark" | "outline" | "ghost" | "link";
+
+export declare const Card: ForwardRefExoticComponent<CardProps & RefAttributes<HTMLDivElement>>;
+
+export declare const CardContent: ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & RefAttributes<HTMLDivElement>>;
+
+export declare const CardDescription: ForwardRefExoticComponent<HTMLAttributes<HTMLParagraphElement> & RefAttributes<HTMLParagraphElement>>;
+
+export declare const CardFooter: ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & RefAttributes<HTMLDivElement>>;
+
+export declare const CardHeader: ForwardRefExoticComponent<CardHeaderProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface CardHeaderProps extends HTMLAttributes<HTMLDivElement> {
+    icon?: ReactNode;
+}
+
+export declare interface CardProps extends HTMLAttributes<HTMLDivElement> {
+    variant?: CardVariant;
+    /** Softens the whole card with hover lift + border tint. */
+    interactive?: boolean;
+}
+
+export declare const CardTitle: ForwardRefExoticComponent<HTMLAttributes<HTMLHeadingElement> & RefAttributes<HTMLHeadingElement>>;
+
+export declare type CardVariant = "outlined" | "elevated" | "inset";
+
+export declare const Check: (props: IconProps) => JSX_2.Element;
+
+export declare const ChevronDown: (props: IconProps) => JSX_2.Element;
+
+export declare const ChevronLeft: (props: IconProps) => JSX_2.Element;
+
+export declare const ChevronRight: (props: IconProps) => JSX_2.Element;
+
+export declare const Clock: (props: IconProps) => JSX_2.Element;
+
+export declare function cn(...inputs: ClassValue[]): string;
+
+export declare const Code: (props: IconProps) => JSX_2.Element;
+
+/**
+ * Contrast utilities.
+ *
+ * The library ships paired semantic tokens (e.g. --color-primary /
+ * --color-on-primary) so explicit pairings stay safe. For the few places where
+ * a *dynamic* color paints a background (a `customColor` prop, a token-based
+ * highlight card...) we pick the text color that yields the **best WCAG
+ * contrast ratio** at runtime.
+ *
+ * Inputs may be hex colors, bare RGB channels ("21 128 61"), rgb() functions
+ * (`rgb(21 128 61 / 0.95)`) or CSS variable references
+ * (`rgb(var(--color-primary) / 0.85)`). Variable references are resolved
+ * against the live stylesheet before computing luminance, so a re-themed
+ * palette never produces a low-contrast combination.
+ */
+export declare type ColorInput = string;
+
+/**
+ * Shared layout wrapper — the single source of the container + gutter rules
+ * used across Section, Footer, CTA, templates…
+ */
+export declare const Container: ForwardRefExoticComponent<ContainerProps & RefAttributes<HTMLElement>>;
+
+export declare interface ContainerProps extends HTMLAttributes<HTMLElement> {
+    /** Render as a specific element (section, header, …). */
+    as?: ElementType;
+    /**
+     * Maximum content width:
+     * `sm` → prose · `md` → reading · `lg` → plans/splits ·
+     * `xl` → default marketing page · `full` → edge-to-edge.
+     */
+    size?: ContainerSize;
+    /** Responsive gutters (px-5 / sm:px-8). Disable for flush content. */
+    gutters?: boolean;
+}
+
+export declare type ContainerSize = "sm" | "md" | "lg" | "xl" | "full";
+
+export declare const Cpu: (props: IconProps) => JSX_2.Element;
+
+export declare const CTA: ForwardRefExoticComponent<CTAProps & RefAttributes<HTMLElement>>;
+
+export declare interface CTAProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    title: ReactNode;
+    description?: ReactNode;
+    action?: ReactNode;
+    secondaryAction?: ReactNode;
+    option?: "panel" | "surface" | "inverse";
+    align?: "left" | "center";
+}
+
+export declare const Database: (props: IconProps) => JSX_2.Element;
+
+export declare const DollarSign: (props: IconProps) => JSX_2.Element;
+
+export declare const ExternalLink: (props: IconProps) => JSX_2.Element;
+
+export declare type EyebrowStyle = "caps" | "soft" | "plain";
+
+export declare const FAQ: {
+    ({ className, items, option, allowMultiple, defaultOpen, eyebrow, title, description, ...props }: FAQProps): JSX_2.Element;
+    displayName: string;
+};
+
+export declare interface FaqItem {
+    question: string;
+    answer: string;
+}
+
+export declare interface FAQProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    items: FaqItem[];
+    option?: "accordion" | "split" | "cards";
+    allowMultiple?: boolean;
+    defaultOpen?: number[];
+    eyebrow?: ReactNode;
+    title?: ReactNode;
+    description?: ReactNode;
+}
+
+export declare const FeatureCard: ForwardRefExoticComponent<FeatureCardProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface FeatureCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    icon?: ReactNode;
+    title: ReactNode;
+    description?: ReactNode;
+    /** Arbitrary CSS color for the icon chip; glyph color computed for contrast. */
+    accent?: string;
+    large?: boolean;
+}
+
+export declare const FeatureGrid: ForwardRefExoticComponent<FeatureGridProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface FeatureGridProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    features: FeatureItem[];
+    option?: "columns" | "bento" | "editorialRows";
+    columns?: 2 | 3 | 4;
+}
+
+export declare interface FeatureItem {
+    icon?: ReactNode;
+    title: string;
+    description?: string;
+    accent?: string;
+}
+
+export declare const Footer: {
+    ({ className, brand, description, columns, socials, bottom, option, badge, ...props }: FooterProps): JSX_2.Element;
+    displayName: string;
+};
+
+export declare interface FooterColumn {
+    title: string;
+    links: FooterLink[];
+}
+
+export declare interface FooterLink {
+    label: string;
+    href: string;
+}
+
+export declare interface FooterProps extends HTMLAttributes<HTMLElement> {
+    brand?: ReactNode;
+    description?: string;
+    columns: FooterColumn[];
+    socials?: ReactNode;
+    bottom?: ReactNode;
+    option?: "classic" | "minimal" | "editorial";
+    badge?: ReactNode;
+}
+
+export declare const Gauge: (props: IconProps) => JSX_2.Element;
+
+/**
+ * Returns the more readable of the two candidate text colors for a given
+ * background. Both candidates are evaluated with the WCAG contrast formula and
+ * the winning (highest ratio) color is returned — not a fixed luminance
+ * breakpoint — so mid-luminance backgrounds (amber, pastels, light violet…)
+ * always fall on the correct side.
+ */
+export declare function getContrastText(bg: ColorInput, light?: string, dark?: string): string;
+
+export declare const Globe: (props: IconProps) => JSX_2.Element;
+
+export declare const Hero: ForwardRefExoticComponent<HeroProps & RefAttributes<HTMLElement>>;
+
+export declare interface HeroMeta {
+    label: string;
+    icon?: ReactNode;
+}
+
+export declare interface HeroProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    variant?: "split" | "centered" | "statement";
+    eyebrow?: ReactNode;
+    title: ReactNode;
+    description?: ReactNode;
+    primaryAction?: ReactNode;
+    secondaryAction?: ReactNode;
+    media?: ReactNode;
+    /** Small trust/status row shown under the copy or CTAs. */
+    meta?: HeroMeta[];
+}
+
+/**
+ * Minimal 1.5px stroke icon set (Lucide/Heroicons inspired).
+ * No emojis — the library ships a single, consistent icon vocabulary.
+ *
+ * Usage:
+ *   <ArrowRight className="h-4 w-4" />
+ */
+declare type IconProps = SVGProps<SVGSVGElement>;
+
+export declare const Layers: (props: IconProps) => JSX_2.Element;
+
+declare const Lock_2: (props: IconProps) => JSX_2.Element;
+export { Lock_2 as Lock }
+
+export declare const LogoCloud: ForwardRefExoticComponent<LogoCloudProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface LogoCloudProps extends HTMLAttributes<HTMLDivElement> {
+    logos: LogoItem[];
+    title?: string;
+    /** Visual option: quiet list · infinite marquee · hairline strip */
+    option?: "quiet" | "marquee" | "strip";
+}
+
+export declare interface LogoItem {
+    name: string;
+    src?: string;
+    href?: string;
+}
+
+export declare const Mail: (props: IconProps) => JSX_2.Element;
+
+export declare const MegaMenu: {
+    ({ className, variant, brand, logo, logoSrc, logoAlt, logoClassName, brandHref, items, actions, cta, sticky, onKeyDown, ...props }: MegaMenuProps): JSX_2.Element;
+    displayName: string;
+};
+
+export declare interface MegaMenuColumn {
+    title?: string;
+    links: MegaMenuLink[];
+}
+
+export declare interface MegaMenuFeatured {
+    title: string;
+    description?: string;
+    href: string;
+    cta?: string;
+    /** Background color for the card; glyph text color is computed for contrast. */
+    accent?: string;
+}
+
+export declare interface MegaMenuItem {
+    label: string;
+    href?: string;
+    /** When set, the item becomes a trigger that opens a mega panel. */
+    columns?: MegaMenuColumn[];
+    /** Optional highlighted card pinned to the right side of the panel. */
+    featured?: MegaMenuFeatured;
+    /** Small pill rendered next to the trigger label. */
+    badge?: string;
+}
+
+export declare interface MegaMenuLink {
+    label: string;
+    href: string;
+    description?: string;
+}
+
+export declare interface MegaMenuProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    variant?: "classic" | "floating" | "inverse";
+    /** Wordmark rendered when no logo is supplied. */
+    brand?: ReactNode;
+    /** Custom logo node (component, <img>, inline SVG…). Replaces the wordmark. */
+    logo?: ReactNode;
+    /** Quick logo image source. */
+    logoSrc?: string;
+    logoAlt?: string;
+    logoClassName?: string;
+    brandHref?: string;
+    items: MegaMenuItem[];
+    /** Rendered at the right side of the bar (desktop) and inside the mobile panel. */
+    actions?: ReactNode;
+    cta?: ReactNode;
+    sticky?: boolean;
+}
+
+export declare const Menu: (props: IconProps) => JSX_2.Element;
+
+export declare const Navbar: {
+    ({ className, variant, brand, logo, logoSrc, logoAlt, logoClassName, brandHref, links, actions, cta, sticky, ...props }: NavbarProps): JSX_2.Element;
+    displayName: string;
+};
+
+export declare interface NavbarProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    variant?: "classic" | "floating" | "inverse";
+    /** Wordmark or fallback text rendered when no logo is supplied. */
+    brand?: ReactNode;
+    /** Custom logo node (component, <img>, inline SVG…). Replaces the wordmark. */
+    logo?: ReactNode;
+    /** Quick logo image source. */
+    logoSrc?: string;
+    logoAlt?: string;
+    /** Size / position tuning for logo images. Defaults to `h-7 w-auto`. */
+    logoClassName?: string;
+    brandHref?: string;
+    links: NavLink[];
+    actions?: ReactNode;
+    sticky?: boolean;
+    cta?: ReactNode;
+}
+
+export declare interface NavLink {
+    label: string;
+    href: string;
+}
+
+export declare const Newsletter: {
+    ({ className, option, placeholder, buttonLabel, successMessage, note, onSubmit, ...props }: NewsletterProps): JSX_2.Element;
+    displayName: string;
+};
+
+export declare interface NewsletterProps extends Omit<HTMLAttributes<HTMLFormElement>, "onSubmit"> {
+    option?: "inline" | "card" | "underline";
+    placeholder?: string;
+    buttonLabel?: string;
+    successMessage?: string;
+    note?: string;
+    onSubmit?: (email: string) => void;
+}
+
+export declare const Palette: (props: IconProps) => JSX_2.Element;
+
+export declare interface Plan {
+    name: string;
+    description?: string;
+    monthly: number | null;
+    yearly: number | null;
+    features: string[];
+    cta?: string;
+    href?: string;
+    highlighted?: boolean;
+    customColor?: string;
+}
+
+export declare const Play: (props: IconProps) => JSX_2.Element;
+
+export declare const Plus: (props: IconProps) => JSX_2.Element;
+
+export declare const Pricing: {
+    ({ className, plans, option, defaultBilling, onSelect, ...props }: PricingProps): JSX_2.Element;
+    displayName: string;
+};
+
+export declare interface PricingProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect"> {
+    plans: Plan[];
+    option?: "cards" | "bento" | "compact";
+    defaultBilling?: "monthly" | "yearly";
+    onSelect?: (plan: Plan, billing: "monthly" | "yearly") => void;
+}
+
+/**
+ * Blog / article / documentation body text.
+ *
+ * Wraps Tailwind Typography (`@tailwindcss/typography`) and re-skins its
+ * colors, type scale and code blocks through the same design tokens as every
+ * other component, so dark palettes and font swaps work out of the box.
+ */
+export declare const Prose: ForwardRefExoticComponent<ProseProps & RefAttributes<HTMLElement>>;
+
+/** Intro / stand-first paragraph styled with the `prose` lead class. */
+export declare const ProseLead: ForwardRefExoticComponent<HTMLAttributes<HTMLParagraphElement> & RefAttributes<HTMLParagraphElement>>;
+
+export declare interface ProseProps extends HTMLAttributes<HTMLElement> {
+    /** Content scale. `lg` (prose-lg) is the comfortable blog default. */
+    size?: ProseSize;
+    /** Renders raw HTML (CMS / MDX output). Mutually exclusive with children. */
+    html?: string;
+    /** When true, removes the reading-width cap. */
+    wide?: boolean;
+}
+
+export declare type ProseSize = "sm" | "md" | "lg" | "xl" | "2xl";
+
+export declare const Quote: (props: IconProps) => JSX_2.Element;
+
+export declare const Rocket: (props: IconProps) => JSX_2.Element;
+
+export declare const Section: ForwardRefExoticComponent<SectionProps & RefAttributes<HTMLElement>>;
+
+export declare const SectionHeader: ForwardRefExoticComponent<SectionHeaderProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface SectionHeaderProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    eyebrow?: ReactNode;
+    eyebrowStyle?: EyebrowStyle;
+    title?: ReactNode;
+    description?: ReactNode;
+    align?: "left" | "center";
+}
+
+export declare interface SectionProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    size?: "sm" | "md" | "lg";
+    eyebrow?: ReactNode;
+    eyebrowStyle?: EyebrowStyle;
+    title?: ReactNode;
+    description?: ReactNode;
+    align?: "left" | "center";
+    containerClassName?: string;
+}
+
+export declare const Send: (props: IconProps) => JSX_2.Element;
+
+export declare const ShieldCheck: (props: IconProps) => JSX_2.Element;
+
+export declare const Sliders: (props: IconProps) => JSX_2.Element;
+
+export declare const Smartphone: (props: IconProps) => JSX_2.Element;
+
+/** Vertical (or horizontal) rhythm helper using flex gaps. */
+export declare const Stack: ForwardRefExoticComponent<StackProps & RefAttributes<HTMLDivElement>>;
+
+export declare type StackGap = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 8 | 10 | 12 | 16 | 20;
+
+export declare interface StackProps extends HTMLAttributes<HTMLDivElement> {
+    gap?: StackGap;
+    horizontal?: boolean;
+}
+
+export declare const Star: (props: IconProps) => JSX_2.Element;
+
+export declare interface Stat {
+    value: string;
+    label: string;
+    /** Small unit rendered inline with the value, e.g. "ms" or "₺". */
+    suffix?: string;
+    /** Trend change in percent — renders an up/down badge. */
+    delta?: number;
+    /** Optional supporting copy. */
+    sub?: string;
+    icon?: ReactNode;
+    /** Highlights the value with the primary token. */
+    accent?: boolean;
+}
+
+export declare const Stats: ForwardRefExoticComponent<StatsProps & RefAttributes<HTMLDListElement>>;
+
+export declare interface StatsProps extends HTMLAttributes<HTMLDListElement> {
+    stats: Stat[];
+    option?: "editorial" | "hairline" | "cells" | "ticker";
+    columns?: 2 | 3 | 4;
+}
+
+export declare const Terminal: (props: IconProps) => JSX_2.Element;
+
+export declare interface Testimonial {
+    quote: string;
+    author: string;
+    role?: string;
+    company?: string;
+    avatar?: ReactNode;
+    /** Arbitrary CSS color for the initials avatar. */
+    accent?: string;
+    rating?: number;
+}
+
+export declare const TestimonialCard: ForwardRefExoticComponent<TestimonialCardProps & RefAttributes<HTMLElement>>;
+
+export declare interface TestimonialCardProps extends HTMLAttributes<HTMLElement> {
+    testimonial: Testimonial;
+}
+
+export declare const Testimonials: {
+    ({ className, items, option, ...props }: TestimonialsProps): JSX_2.Element;
+    displayName: string;
+};
+
+/** Holds per-option rendering + controls together. */
+export declare interface TestimonialsProps extends HTMLAttributes<HTMLDivElement> {
+    items: Testimonial[];
+    option?: "grid" | "carousel" | "marquee";
+    title?: string;
+}
+
+export declare const Users: (props: IconProps) => JSX_2.Element;
+
+/**
+ * Reads a `--color-*` token from the live stylesheet and returns a text color
+ * that is always readable against it. Recomputes whenever the palette changes
+ * at runtime (e.g. the Storybook theme switcher or an app-level theme swap).
+ */
+export declare function useTokenForeground(variable: string, fallback?: string): string;
+
+export declare const X: (props: IconProps) => JSX_2.Element;
+
+export declare const Zap: (props: IconProps) => JSX_2.Element;
+
+export { }