@retinalabsllc/zairusjs 0.1.0

package/README.md

@@ -0,0 +1,10 @@
+# ZairusJS
+
+**ZairusJS** is a high performance, Ai data driven React UI component library designed for Next.js. It is engineered by **Retina Labs Company** to prioritize precision, privacy, and absolute user control.
+
+## 🚀 Installation
+
+To install directly from GitHub:
+
+```bash
+npm install retinalabsllc/zairus

package/dist/index.d.mts

@@ -0,0 +1,341 @@
+import React from 'react';
+import { ToasterProps } from 'react-hot-toast';
+
+interface FaqItem {
+    question: string;
+    answer: string;
+}
+interface FaqProps {
+    title?: string;
+    subtitle?: string;
+    items: FaqItem[];
+}
+declare const Faq: React.FC<FaqProps>;
+
+interface ThreeDButtonProps {
+    href: string;
+    children: React.ReactNode;
+    className?: string;
+    onClick?: (e: React.MouseEvent<HTMLAnchorElement>) => void;
+}
+declare const ThreeDButton: React.FC<ThreeDButtonProps>;
+
+interface HeaderLink {
+    label: string;
+    href: string;
+    hideOnMobile?: boolean;
+}
+interface HeaderProps {
+    logoSrc: string;
+    companyName: string;
+    subtitle?: string;
+    links: HeaderLink[];
+}
+declare const Header: React.FC<HeaderProps>;
+
+interface FooterLink {
+    label: string;
+    href: string;
+    isExternal?: boolean;
+}
+interface FooterColumn {
+    title: string;
+    links: FooterLink[];
+}
+interface SocialLink {
+    name: string;
+    icon: any;
+    href: string;
+}
+interface FooterProps {
+    description: string;
+    columns: FooterColumn[];
+    socialLinks?: SocialLink[];
+    copyrightText: string;
+    topSection?: React.ReactNode;
+}
+declare const Footer: React.FC<FooterProps>;
+
+interface HeroSectionProps {
+    badgeText: string;
+    titlePrefix: React.ReactNode;
+    highlightText: string;
+    cursorLabel: string;
+    subtitle: string;
+    ctaText: string;
+    ctaHref: string;
+    showImage?: boolean;
+    imageSrc?: string;
+}
+declare const HeroSection: React.FC<HeroSectionProps>;
+
+interface BentoFeature {
+    label: string;
+    title: string;
+    desc: string;
+    size: string;
+    icon: any;
+    number?: string;
+    isBrand?: boolean;
+    isWhite?: boolean;
+}
+interface AppBento2Props {
+    tagline: string;
+    headline: React.ReactNode;
+    features: BentoFeature[];
+}
+declare const AppBento2: React.FC<AppBento2Props>;
+
+interface ScrollFeature {
+    title: string;
+    desc: string;
+    image?: string;
+}
+interface FeatureScrollProps {
+    tagline: string;
+    headline: React.ReactNode;
+    features: ScrollFeature[];
+}
+declare const FeatureScroll: React.FC<FeatureScrollProps>;
+
+interface AITranscriptionFeatureProps {
+    tagline: string;
+    headline: React.ReactNode;
+    description: string;
+    imagePath?: string;
+    detailTextPrefix: string;
+    highlightText: string;
+    cursorLabel: string;
+    detailTextSuffix: string;
+}
+declare const AITranscriptionFeature: React.FC<AITranscriptionFeatureProps>;
+
+interface PlatformFeatureItem {
+    title: string;
+    desc: string;
+    icon: any;
+    delay?: string;
+}
+interface PlatformFeaturesProps {
+    tagline: string;
+    headline: React.ReactNode;
+    description: string;
+    features: PlatformFeatureItem[];
+}
+declare const PlatformFeatures: React.FC<PlatformFeaturesProps>;
+
+interface DocumentSectionData {
+    /** Optional section heading */
+    heading?: string;
+    /** Array of paragraphs. Each string becomes its own <p> tag */
+    paragraphs?: string[];
+    /** If provided, renders a highlighted quote box */
+    quote?: string;
+}
+interface ManagedDocumentProps {
+    /** The small tracking text above the main title */
+    tagline?: string;
+    /** The main H1 title of the page */
+    title: string;
+    /** The content of the document */
+    sections: DocumentSectionData[];
+    /** Optional footer contact text */
+    contactText?: string;
+    /** Optional footer contact email to create a mailto link */
+    contactEmail?: string;
+}
+declare const ManagedDocument: React.FC<ManagedDocumentProps>;
+
+interface EmailContact {
+    /** The department or purpose (e.g., "General Inquiries") */
+    label: string;
+    /** The first part of the email before the @ (e.g., "info") */
+    user: string;
+    /** The domain after the @ (e.g., "audditur.com") */
+    domain: string;
+}
+interface SocialContact {
+    label: string;
+    href: string;
+    icon: any;
+}
+interface CompanyDetails {
+    name?: string;
+    /** Array of strings for addresses, registration numbers, etc. */
+    lines?: string[];
+    /** Phone number (automatically formats into a clickable tel: link) */
+    phone?: string;
+}
+interface ManagedContactBlockProps {
+    /** The small tracking text above the main title */
+    tagline?: string;
+    /** The main H1 title of the page */
+    title: string;
+    /** Company details column data */
+    company?: CompanyDetails;
+    /** Email directory column data */
+    emails?: EmailContact[];
+    /** Social links column data */
+    socials?: SocialContact[];
+}
+declare const ManagedContactBlock: React.FC<ManagedContactBlockProps>;
+
+interface PricingFeature {
+    name: string;
+    /** true = Checkmark, false = Cross, string = Checkmark with text (e.g., "3 Months") */
+    value: boolean | string;
+}
+interface PricingPlan {
+    name: string;
+    price: string;
+    period?: string;
+    description: string;
+    ctaText: string;
+    ctaHref: string;
+    /** If true, uses the ThreeDButton and adds premium border styling */
+    isPremium?: boolean;
+    features: PricingFeature[];
+}
+interface ManagedPricingBlockProps {
+    tagline?: string;
+    title: string;
+    plans: PricingPlan[];
+}
+declare const ManagedPricingBlock: React.FC<ManagedPricingBlockProps>;
+
+interface BoardMember {
+    name: string;
+    title: string;
+    imageSrc: string;
+    bio: string;
+    /** Link for the "Visit Website" button */
+    website: string;
+    /** Optional: X (Twitter) handle without the @ */
+    twitterHandle?: string;
+    /** Optional: Full LinkedIn URL */
+    linkedinHandle?: string;
+}
+interface ManagedBoardBlockProps {
+    /** Small tracking text above the main title */
+    tagline?: string;
+    /** Main H1 title of the page */
+    title: string;
+    /** Array of board member objects */
+    members: BoardMember[];
+    /** Optional footer contact text */
+    contactText?: string;
+    /** Optional footer contact email to create a mailto link */
+    contactEmail?: string;
+}
+declare const ManagedBoardBlock: React.FC<ManagedBoardBlockProps>;
+
+interface ProjectItem {
+    id: string;
+    title: string;
+    /** Right-aligned text, can be a date or a category like "Core Technology" */
+    date: string;
+    /** The destination URL */
+    link: string;
+    /** If true, uses a standard <a> tag with target="_blank" instead of next/link */
+    isExternal?: boolean;
+    /** Badge text. If "Production", it gets highlighted in black. */
+    status: string;
+    description: string;
+}
+interface ManagedProjectsBlockProps {
+    /** Small tracking text above the main title */
+    tagline?: string;
+    /** Main H1 title of the page */
+    title: string;
+    /** Array of project objects */
+    projects: ProjectItem[];
+}
+declare const ManagedProjectsBlock: React.FC<ManagedProjectsBlockProps>;
+
+interface ManagedNotFoundBlockProps {
+    /** The main error title. Defaults to "404 - Page Not Found" */
+    title?: string;
+    /** The description text. Defaults to standard not found message. */
+    description?: string;
+    /** The text for the back link. Defaults to "← Go back to Homepage" */
+    backLinkText?: string;
+    /** The destination for the back link. Defaults to "/" */
+    backLinkHref?: string;
+}
+declare const ManagedNotFoundBlock: React.FC<ManagedNotFoundBlockProps>;
+
+interface PageSpinnerProps {
+    /** Optional override for the outer container styling */
+    className?: string;
+    /** Optional override for the icon styling (defaults to text-black) */
+    iconClassName?: string;
+    /** Size of the spinner (defaults to 32) */
+    size?: number;
+}
+declare const PageSpinner: React.FC<PageSpinnerProps>;
+
+declare const ManagedToaster: React.FC<ToasterProps>;
+
+interface ManagedNewsletterSplitBlockProps {
+    tagline?: string;
+    title: string;
+    subtitle?: string;
+    description: string;
+    imageSrc: string;
+    imageAlt?: string;
+    dividerText?: string;
+    ctaText?: string;
+    ctaHref?: string;
+    /** Optional children to pass input fields (like the new TextInput) above the button */
+    children?: React.ReactNode;
+}
+declare const ManagedNewsletterSplitBlock: React.FC<ManagedNewsletterSplitBlockProps>;
+
+interface TextInputProps {
+    label: string;
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+    maxLength?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+    onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;
+}
+interface NumberInputProps {
+    label: string;
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+    maxLength?: number;
+    disabled?: boolean;
+}
+declare const TextInput: React.FC<TextInputProps>;
+declare const NumberInput: React.FC<NumberInputProps>;
+
+interface PortfolioHeroProps {
+    /** The source URL for the circular avatar */
+    imageSrc: string;
+    /** Alt text for the avatar */
+    imageAlt?: string;
+    /** The main H1 name */
+    name: string;
+    /** The small label above the social link (e.g., "LinkedIn") */
+    socialLabel?: string;
+    /** The display text for the social link */
+    socialLinkText?: string;
+    /** The destination URL for the social link */
+    socialLinkHref?: string;
+    /** The main biography paragraph */
+    bio: string;
+    /** Text for the primary 3D Button */
+    primaryCtaText?: string;
+    /** Destination for the primary 3D Button */
+    primaryCtaHref?: string;
+    /** Text for the secondary neutral button */
+    secondaryCtaText?: string;
+    /** Destination for the secondary neutral button */
+    secondaryCtaHref?: string;
+}
+declare const PortfolioHero: React.FC<PortfolioHeroProps>;
+
+export { AITranscriptionFeature, type AITranscriptionFeatureProps, AppBento2, type AppBento2Props, type BentoFeature, type BoardMember, type CompanyDetails, type DocumentSectionData, type EmailContact, Faq, type FaqItem, type FaqProps, FeatureScroll, type FeatureScrollProps, Footer, type FooterColumn, type FooterLink, type FooterProps, Header, type HeaderLink, type HeaderProps, HeroSection, type HeroSectionProps, ManagedBoardBlock, type ManagedBoardBlockProps, ManagedContactBlock, type ManagedContactBlockProps, ManagedDocument, type ManagedDocumentProps, ManagedNewsletterSplitBlock, type ManagedNewsletterSplitBlockProps, ManagedNotFoundBlock, type ManagedNotFoundBlockProps, ManagedPricingBlock, type ManagedPricingBlockProps, ManagedProjectsBlock, type ManagedProjectsBlockProps, ManagedToaster, NumberInput, type NumberInputProps, PageSpinner, type PageSpinnerProps, type PlatformFeatureItem, PlatformFeatures, type PlatformFeaturesProps, PortfolioHero, type PortfolioHeroProps, type PricingFeature, type PricingPlan, type ProjectItem, type ScrollFeature, type SocialContact, type SocialLink, TextInput, type TextInputProps, ThreeDButton, type ThreeDButtonProps };

package/dist/index.d.ts

@@ -0,0 +1,341 @@
+import React from 'react';
+import { ToasterProps } from 'react-hot-toast';
+
+interface FaqItem {
+    question: string;
+    answer: string;
+}
+interface FaqProps {
+    title?: string;
+    subtitle?: string;
+    items: FaqItem[];
+}
+declare const Faq: React.FC<FaqProps>;
+
+interface ThreeDButtonProps {
+    href: string;
+    children: React.ReactNode;
+    className?: string;
+    onClick?: (e: React.MouseEvent<HTMLAnchorElement>) => void;
+}
+declare const ThreeDButton: React.FC<ThreeDButtonProps>;
+
+interface HeaderLink {
+    label: string;
+    href: string;
+    hideOnMobile?: boolean;
+}
+interface HeaderProps {
+    logoSrc: string;
+    companyName: string;
+    subtitle?: string;
+    links: HeaderLink[];
+}
+declare const Header: React.FC<HeaderProps>;
+
+interface FooterLink {
+    label: string;
+    href: string;
+    isExternal?: boolean;
+}
+interface FooterColumn {
+    title: string;
+    links: FooterLink[];
+}
+interface SocialLink {
+    name: string;
+    icon: any;
+    href: string;
+}
+interface FooterProps {
+    description: string;
+    columns: FooterColumn[];
+    socialLinks?: SocialLink[];
+    copyrightText: string;
+    topSection?: React.ReactNode;
+}
+declare const Footer: React.FC<FooterProps>;
+
+interface HeroSectionProps {
+    badgeText: string;
+    titlePrefix: React.ReactNode;
+    highlightText: string;
+    cursorLabel: string;
+    subtitle: string;
+    ctaText: string;
+    ctaHref: string;
+    showImage?: boolean;
+    imageSrc?: string;
+}
+declare const HeroSection: React.FC<HeroSectionProps>;
+
+interface BentoFeature {
+    label: string;
+    title: string;
+    desc: string;
+    size: string;
+    icon: any;
+    number?: string;
+    isBrand?: boolean;
+    isWhite?: boolean;
+}
+interface AppBento2Props {
+    tagline: string;
+    headline: React.ReactNode;
+    features: BentoFeature[];
+}
+declare const AppBento2: React.FC<AppBento2Props>;
+
+interface ScrollFeature {
+    title: string;
+    desc: string;
+    image?: string;
+}
+interface FeatureScrollProps {
+    tagline: string;
+    headline: React.ReactNode;
+    features: ScrollFeature[];
+}
+declare const FeatureScroll: React.FC<FeatureScrollProps>;
+
+interface AITranscriptionFeatureProps {
+    tagline: string;
+    headline: React.ReactNode;
+    description: string;
+    imagePath?: string;
+    detailTextPrefix: string;
+    highlightText: string;
+    cursorLabel: string;
+    detailTextSuffix: string;
+}
+declare const AITranscriptionFeature: React.FC<AITranscriptionFeatureProps>;
+
+interface PlatformFeatureItem {
+    title: string;
+    desc: string;
+    icon: any;
+    delay?: string;
+}
+interface PlatformFeaturesProps {
+    tagline: string;
+    headline: React.ReactNode;
+    description: string;
+    features: PlatformFeatureItem[];
+}
+declare const PlatformFeatures: React.FC<PlatformFeaturesProps>;
+
+interface DocumentSectionData {
+    /** Optional section heading */
+    heading?: string;
+    /** Array of paragraphs. Each string becomes its own <p> tag */
+    paragraphs?: string[];
+    /** If provided, renders a highlighted quote box */
+    quote?: string;
+}
+interface ManagedDocumentProps {
+    /** The small tracking text above the main title */
+    tagline?: string;
+    /** The main H1 title of the page */
+    title: string;
+    /** The content of the document */
+    sections: DocumentSectionData[];
+    /** Optional footer contact text */
+    contactText?: string;
+    /** Optional footer contact email to create a mailto link */
+    contactEmail?: string;
+}
+declare const ManagedDocument: React.FC<ManagedDocumentProps>;
+
+interface EmailContact {
+    /** The department or purpose (e.g., "General Inquiries") */
+    label: string;
+    /** The first part of the email before the @ (e.g., "info") */
+    user: string;
+    /** The domain after the @ (e.g., "audditur.com") */
+    domain: string;
+}
+interface SocialContact {
+    label: string;
+    href: string;
+    icon: any;
+}
+interface CompanyDetails {
+    name?: string;
+    /** Array of strings for addresses, registration numbers, etc. */
+    lines?: string[];
+    /** Phone number (automatically formats into a clickable tel: link) */
+    phone?: string;
+}
+interface ManagedContactBlockProps {
+    /** The small tracking text above the main title */
+    tagline?: string;
+    /** The main H1 title of the page */
+    title: string;
+    /** Company details column data */
+    company?: CompanyDetails;
+    /** Email directory column data */
+    emails?: EmailContact[];
+    /** Social links column data */
+    socials?: SocialContact[];
+}
+declare const ManagedContactBlock: React.FC<ManagedContactBlockProps>;
+
+interface PricingFeature {
+    name: string;
+    /** true = Checkmark, false = Cross, string = Checkmark with text (e.g., "3 Months") */
+    value: boolean | string;
+}
+interface PricingPlan {
+    name: string;
+    price: string;
+    period?: string;
+    description: string;
+    ctaText: string;
+    ctaHref: string;
+    /** If true, uses the ThreeDButton and adds premium border styling */
+    isPremium?: boolean;
+    features: PricingFeature[];
+}
+interface ManagedPricingBlockProps {
+    tagline?: string;
+    title: string;
+    plans: PricingPlan[];
+}
+declare const ManagedPricingBlock: React.FC<ManagedPricingBlockProps>;
+
+interface BoardMember {
+    name: string;
+    title: string;
+    imageSrc: string;
+    bio: string;
+    /** Link for the "Visit Website" button */
+    website: string;
+    /** Optional: X (Twitter) handle without the @ */
+    twitterHandle?: string;
+    /** Optional: Full LinkedIn URL */
+    linkedinHandle?: string;
+}
+interface ManagedBoardBlockProps {
+    /** Small tracking text above the main title */
+    tagline?: string;
+    /** Main H1 title of the page */
+    title: string;
+    /** Array of board member objects */
+    members: BoardMember[];
+    /** Optional footer contact text */
+    contactText?: string;
+    /** Optional footer contact email to create a mailto link */
+    contactEmail?: string;
+}
+declare const ManagedBoardBlock: React.FC<ManagedBoardBlockProps>;
+
+interface ProjectItem {
+    id: string;
+    title: string;
+    /** Right-aligned text, can be a date or a category like "Core Technology" */
+    date: string;
+    /** The destination URL */
+    link: string;
+    /** If true, uses a standard <a> tag with target="_blank" instead of next/link */
+    isExternal?: boolean;
+    /** Badge text. If "Production", it gets highlighted in black. */
+    status: string;
+    description: string;
+}
+interface ManagedProjectsBlockProps {
+    /** Small tracking text above the main title */
+    tagline?: string;
+    /** Main H1 title of the page */
+    title: string;
+    /** Array of project objects */
+    projects: ProjectItem[];
+}
+declare const ManagedProjectsBlock: React.FC<ManagedProjectsBlockProps>;
+
+interface ManagedNotFoundBlockProps {
+    /** The main error title. Defaults to "404 - Page Not Found" */
+    title?: string;
+    /** The description text. Defaults to standard not found message. */
+    description?: string;
+    /** The text for the back link. Defaults to "← Go back to Homepage" */
+    backLinkText?: string;
+    /** The destination for the back link. Defaults to "/" */
+    backLinkHref?: string;
+}
+declare const ManagedNotFoundBlock: React.FC<ManagedNotFoundBlockProps>;
+
+interface PageSpinnerProps {
+    /** Optional override for the outer container styling */
+    className?: string;
+    /** Optional override for the icon styling (defaults to text-black) */
+    iconClassName?: string;
+    /** Size of the spinner (defaults to 32) */
+    size?: number;
+}
+declare const PageSpinner: React.FC<PageSpinnerProps>;
+
+declare const ManagedToaster: React.FC<ToasterProps>;
+
+interface ManagedNewsletterSplitBlockProps {
+    tagline?: string;
+    title: string;
+    subtitle?: string;
+    description: string;
+    imageSrc: string;
+    imageAlt?: string;
+    dividerText?: string;
+    ctaText?: string;
+    ctaHref?: string;
+    /** Optional children to pass input fields (like the new TextInput) above the button */
+    children?: React.ReactNode;
+}
+declare const ManagedNewsletterSplitBlock: React.FC<ManagedNewsletterSplitBlockProps>;
+
+interface TextInputProps {
+    label: string;
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+    maxLength?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+    onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;
+}
+interface NumberInputProps {
+    label: string;
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+    maxLength?: number;
+    disabled?: boolean;
+}
+declare const TextInput: React.FC<TextInputProps>;
+declare const NumberInput: React.FC<NumberInputProps>;
+
+interface PortfolioHeroProps {
+    /** The source URL for the circular avatar */
+    imageSrc: string;
+    /** Alt text for the avatar */
+    imageAlt?: string;
+    /** The main H1 name */
+    name: string;
+    /** The small label above the social link (e.g., "LinkedIn") */
+    socialLabel?: string;
+    /** The display text for the social link */
+    socialLinkText?: string;
+    /** The destination URL for the social link */
+    socialLinkHref?: string;
+    /** The main biography paragraph */
+    bio: string;
+    /** Text for the primary 3D Button */
+    primaryCtaText?: string;
+    /** Destination for the primary 3D Button */
+    primaryCtaHref?: string;
+    /** Text for the secondary neutral button */
+    secondaryCtaText?: string;
+    /** Destination for the secondary neutral button */
+    secondaryCtaHref?: string;
+}
+declare const PortfolioHero: React.FC<PortfolioHeroProps>;
+
+export { AITranscriptionFeature, type AITranscriptionFeatureProps, AppBento2, type AppBento2Props, type BentoFeature, type BoardMember, type CompanyDetails, type DocumentSectionData, type EmailContact, Faq, type FaqItem, type FaqProps, FeatureScroll, type FeatureScrollProps, Footer, type FooterColumn, type FooterLink, type FooterProps, Header, type HeaderLink, type HeaderProps, HeroSection, type HeroSectionProps, ManagedBoardBlock, type ManagedBoardBlockProps, ManagedContactBlock, type ManagedContactBlockProps, ManagedDocument, type ManagedDocumentProps, ManagedNewsletterSplitBlock, type ManagedNewsletterSplitBlockProps, ManagedNotFoundBlock, type ManagedNotFoundBlockProps, ManagedPricingBlock, type ManagedPricingBlockProps, ManagedProjectsBlock, type ManagedProjectsBlockProps, ManagedToaster, NumberInput, type NumberInputProps, PageSpinner, type PageSpinnerProps, type PlatformFeatureItem, PlatformFeatures, type PlatformFeaturesProps, PortfolioHero, type PortfolioHeroProps, type PricingFeature, type PricingPlan, type ProjectItem, type ScrollFeature, type SocialContact, type SocialLink, TextInput, type TextInputProps, ThreeDButton, type ThreeDButtonProps };