@sonordev/agency-site-kit 0.1.0

package/dist/types-BMUhBhWx.d.ts

@@ -0,0 +1,346 @@
+/**
+ * @sonordev/agency-site-kit — Type definitions
+ *
+ * These types mirror the Portal API's cms/types.ts definitions for portfolio
+ * content. Keep them in sync when modifying the API response shapes.
+ */
+interface BrandConfig {
+    /** Primary brand color (hex) */
+    primary: string;
+    /** Secondary/accent color (hex) */
+    secondary: string;
+    /** Background color (hex) */
+    background: string;
+    /** Elevated background — cards, modals (hex) */
+    backgroundElevated: string;
+    /** Surface color — interactive containers (hex) */
+    surface: string;
+    /** Surface hover state (hex) */
+    surfaceHover: string;
+    /** Surface border color (hex) */
+    surfaceBorder: string;
+    /** Primary text color (hex) */
+    textPrimary: string;
+    /** Secondary text color (hex) */
+    textSecondary: string;
+    /** Tertiary/muted text color (hex) */
+    textTertiary: string;
+    /** Heading font family */
+    fontHeading: string;
+    /** Body font family */
+    fontBody: string;
+    /** Logo URL (absolute or relative) */
+    logoUrl?: string;
+    /** Logo alt text */
+    logoAlt?: string;
+    /** Dark mode overrides — partial, merged with base values */
+    darkMode?: Partial<Omit<BrandConfig, 'fontHeading' | 'fontBody' | 'logoUrl' | 'logoAlt' | 'darkMode'>>;
+    /** Border radius tokens */
+    radius?: {
+        sm: string;
+        md: string;
+        lg: string;
+    };
+}
+interface SanityImageRef {
+    _type: 'image';
+    asset: {
+        _type: 'reference';
+        _ref: string;
+    };
+    hotspot?: {
+        x: number;
+        y: number;
+        height: number;
+        width: number;
+    };
+    crop?: {
+        top: number;
+        bottom: number;
+        left: number;
+        right: number;
+    };
+    alt?: string;
+}
+type MetricSource = 'measured' | 'estimated';
+interface PortfolioKPI {
+    label: string;
+    value: number;
+    suffix: string;
+    prefix?: string;
+    description: string;
+    source: MetricSource;
+}
+interface MetricsDelta {
+    metric: string;
+    baseline: number;
+    current: number;
+    delta: number;
+    deltaPercent: number;
+    direction: 'up' | 'down' | 'flat';
+    timespan: string;
+}
+interface MetricsSnapshot {
+    seo: {
+        clicks_28d?: number;
+        impressions_28d?: number;
+        avg_position?: number;
+        ctr?: number;
+    };
+    cwv: {
+        lcp_ms?: number;
+        inp_ms?: number;
+        cls?: number;
+        performance_score?: number;
+    };
+    analytics: {
+        sessions_28d?: number;
+        page_views_28d?: number;
+        conversion_rate?: number;
+        bounce_rate?: number;
+    };
+    pages: {
+        total_indexed?: number;
+        total_crawled?: number;
+        total_pages?: number;
+    };
+}
+interface PortfolioHeroData {
+    headline: string;
+    subheadline: string;
+    description: string;
+    category: string;
+    services: string[];
+    liveUrl?: string;
+    screenshots: {
+        desktop?: string;
+        tablet?: string;
+        mobile?: string;
+    };
+    kpis: PortfolioKPI[];
+}
+interface PortfolioChallengeItem {
+    title: string;
+    description: string;
+    solution: string;
+    result?: string;
+    icon?: string;
+}
+interface PortfolioChallengesData {
+    items: PortfolioChallengeItem[];
+}
+interface PortfolioStrategyPhase {
+    number: number;
+    title: string;
+    description: string;
+    deliverables?: string[];
+    icon?: string;
+    timeline?: string;
+}
+interface PortfolioStrategyData {
+    phases: PortfolioStrategyPhase[];
+}
+interface PortfolioResultItem {
+    title: string;
+    description: string;
+    metric?: {
+        value: number;
+        suffix: string;
+        prefix?: string;
+    };
+    source: MetricSource;
+    icon?: string;
+}
+interface PortfolioResultsData {
+    items: PortfolioResultItem[];
+}
+interface PortfolioTechItem {
+    name: string;
+    category: string;
+    icon?: string;
+    description?: string;
+}
+interface PortfolioTechStackData {
+    technologies: PortfolioTechItem[];
+}
+interface PortfolioServiceItem {
+    title: string;
+    description: string;
+    features: string[];
+    icon?: string;
+}
+interface PortfolioServicesData {
+    items: PortfolioServiceItem[];
+}
+interface PortfolioTestimonialData {
+    quote: string;
+    author: string;
+    title: string;
+    company: string;
+    avatar?: SanityImageRef;
+    rating?: number;
+}
+interface PortfolioGalleryImage {
+    image: SanityImageRef;
+    caption?: string;
+    type?: 'screenshot' | 'before' | 'after' | 'design';
+}
+interface PortfolioGalleryData {
+    images: PortfolioGalleryImage[];
+    layout?: 'grid' | 'masonry';
+}
+interface PortfolioVideoData {
+    url?: string;
+    embedUrl?: string;
+    thumbnail: SanityImageRef;
+    title: string;
+    duration?: string;
+    platform?: 'youtube' | 'vimeo' | 'custom';
+}
+interface PortfolioTeamMember {
+    name: string;
+    role: string;
+    avatar?: SanityImageRef;
+}
+interface PortfolioTeamData {
+    members: PortfolioTeamMember[];
+}
+interface PortfolioAnnotation {
+    x: number;
+    y: number;
+    label: string;
+    description: string;
+    icon?: string;
+}
+interface PortfolioFeatureSpotlightData {
+    image: SanityImageRef;
+    title: string;
+    description: string;
+    layout: 'left' | 'right' | 'full';
+    annotations: PortfolioAnnotation[];
+}
+interface PortfolioBeforeAfterData {
+    before: SanityImageRef;
+    after: SanityImageRef;
+    title?: string;
+    description?: string;
+    defaultPosition?: number;
+}
+interface PortfolioMetricsDataPoint {
+    month: string;
+    label: string;
+    metrics: {
+        traffic?: number;
+        conversions?: number;
+        revenue?: number;
+        rankings?: number;
+    };
+}
+interface PortfolioMetricsTimelineData {
+    dataPoints: PortfolioMetricsDataPoint[];
+    baselineDate: string;
+    title?: string;
+    description?: string;
+}
+interface PortfolioFunnelStage {
+    label: string;
+    value: number;
+    icon?: string;
+    color?: string;
+}
+interface PortfolioConversionFunnelData {
+    stages: PortfolioFunnelStage[];
+    title?: string;
+    description?: string;
+}
+interface PortfolioDetailsData {
+    industry: string;
+    location?: string;
+    website?: string;
+    timeline?: string;
+    launchDate?: string;
+    budgetRange?: string;
+}
+interface PortfolioSeoData {
+    metaTitle: string;
+    metaDescription: string;
+    keywords: string[];
+    ogImage?: SanityImageRef;
+}
+interface PortfolioCTAData {
+    headline: string;
+    description: string;
+    buttonText: string;
+    buttonUrl: string;
+    style?: 'primary' | 'glass';
+}
+declare const PORTFOLIO_SECTION_TYPES: readonly ["portfolioHero", "portfolioChallenges", "portfolioStrategy", "portfolioResults", "portfolioTechStack", "portfolioServices", "portfolioTestimonial", "portfolioGallery", "portfolioVideo", "portfolioTeam", "portfolioFeatureSpotlight", "portfolioBeforeAfter", "portfolioMetricsTimeline", "portfolioConversionFunnel", "portfolioDetails", "portfolioSeo", "portfolioCTA"];
+type PortfolioSectionType = (typeof PORTFOLIO_SECTION_TYPES)[number];
+type PortfolioSectionData = PortfolioHeroData | PortfolioChallengesData | PortfolioStrategyData | PortfolioResultsData | PortfolioTechStackData | PortfolioServicesData | PortfolioTestimonialData | PortfolioGalleryData | PortfolioVideoData | PortfolioTeamData | PortfolioFeatureSpotlightData | PortfolioBeforeAfterData | PortfolioMetricsTimelineData | PortfolioConversionFunnelData | PortfolioDetailsData | PortfolioSeoData | PortfolioCTAData;
+interface PortfolioSectionDataMap {
+    portfolioHero: PortfolioHeroData;
+    portfolioChallenges: PortfolioChallengesData;
+    portfolioStrategy: PortfolioStrategyData;
+    portfolioResults: PortfolioResultsData;
+    portfolioTechStack: PortfolioTechStackData;
+    portfolioServices: PortfolioServicesData;
+    portfolioTestimonial: PortfolioTestimonialData;
+    portfolioGallery: PortfolioGalleryData;
+    portfolioVideo: PortfolioVideoData;
+    portfolioTeam: PortfolioTeamData;
+    portfolioFeatureSpotlight: PortfolioFeatureSpotlightData;
+    portfolioBeforeAfter: PortfolioBeforeAfterData;
+    portfolioMetricsTimeline: PortfolioMetricsTimelineData;
+    portfolioConversionFunnel: PortfolioConversionFunnelData;
+    portfolioDetails: PortfolioDetailsData;
+    portfolioSeo: PortfolioSeoData;
+    portfolioCTA: PortfolioCTAData;
+}
+interface PortfolioSection<T extends PortfolioSectionType = PortfolioSectionType> {
+    sectionType: T;
+    displayName: string;
+    data: T extends keyof PortfolioSectionDataMap ? PortfolioSectionDataMap[T] : PortfolioSectionData;
+}
+interface PortfolioItem {
+    id: string;
+    slug: string;
+    title: string;
+    subtitle: string;
+    category: string;
+    services: string[];
+    description: string;
+    hero_image: string;
+    hero_image_alt: string;
+    live_url: string | null;
+    kpis: PortfolioKPI[];
+    details: PortfolioDetailsData | null;
+    seo: PortfolioSeoData | null;
+    featured: boolean;
+    order?: number;
+    published_at: string | null;
+    hero_screenshots: {
+        desktop?: string;
+        tablet?: string;
+        mobile?: string;
+    } | null;
+    baseline_metrics: MetricsSnapshot | null;
+    current_metrics: MetricsSnapshot | null;
+    metrics_last_refreshed_at: string | null;
+}
+interface PortfolioItemFull extends PortfolioItem {
+    sections: PortfolioSection[];
+    metricsDelta: MetricsDelta[];
+}
+interface PortfolioListResponse {
+    items: PortfolioItem[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+interface PortfolioConfigResponse {
+    brand: BrandConfig;
+    orgName: string;
+    orgSlug: string;
+}
+
+export { type PortfolioSection as A, type BrandConfig as B, type PortfolioSeoData as C, type PortfolioServiceItem as D, type PortfolioServicesData as E, type PortfolioStrategyData as F, type PortfolioStrategyPhase as G, type PortfolioTeamData as H, type PortfolioTeamMember as I, type PortfolioTechItem as J, type PortfolioTechStackData as K, type PortfolioTestimonialData as L, type MetricSource as M, type PortfolioVideoData as N, type PortfolioItemFull as P, type SanityImageRef as S, type PortfolioListResponse as a, type PortfolioSectionType as b, type PortfolioSectionDataMap as c, type PortfolioSectionData as d, type MetricsDelta as e, type MetricsSnapshot as f, PORTFOLIO_SECTION_TYPES as g, type PortfolioAnnotation as h, type PortfolioBeforeAfterData as i, type PortfolioCTAData as j, type PortfolioChallengeItem as k, type PortfolioChallengesData as l, type PortfolioConfigResponse as m, type PortfolioConversionFunnelData as n, type PortfolioDetailsData as o, type PortfolioFeatureSpotlightData as p, type PortfolioFunnelStage as q, type PortfolioGalleryData as r, type PortfolioGalleryImage as s, type PortfolioHeroData as t, type PortfolioItem as u, type PortfolioKPI as v, type PortfolioMetricsDataPoint as w, type PortfolioMetricsTimelineData as x, type PortfolioResultItem as y, type PortfolioResultsData as z };

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@sonordev/agency-site-kit",
+  "version": "0.1.0",
+  "description": "Premium portfolio showcase components for Sonor-powered agency websites",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./portfolio": {
+      "types": "./dist/portfolio/index.d.ts",
+      "import": "./dist/portfolio/index.js",
+      "require": "./dist/portfolio/index.cjs"
+    },
+    "./portfolio/server": {
+      "types": "./dist/portfolio/server.d.ts",
+      "import": "./dist/portfolio/server.js",
+      "require": "./dist/portfolio/server.cjs"
+    },
+    "./portfolio/sections": {
+      "types": "./dist/portfolio/sections.d.ts",
+      "import": "./dist/portfolio/sections.js",
+      "require": "./dist/portfolio/sections.cjs"
+    },
+    "./portfolio/client": {
+      "types": "./dist/portfolio/client.d.ts",
+      "import": "./dist/portfolio/client.js",
+      "require": "./dist/portfolio/client.cjs"
+    },
+    "./layout": {
+      "types": "./dist/layout/index.d.ts",
+      "import": "./dist/layout/index.js",
+      "require": "./dist/layout/index.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "dependencies": {
+    "gsap": "^3.12.7"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "glob": "^13.0.6",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  }
+}