@sonordev/agency-site-kit 0.1.0

package/dist/portfolio/server.d.ts

@@ -0,0 +1,68 @@
+import { B as BrandConfig, P as PortfolioItemFull, a as PortfolioListResponse } from '../types-BMUhBhWx.js';
+
+/**
+ * @sonordev/agency-site-kit — Portfolio server-side data fetching
+ *
+ * RSC (React Server Component) data layer for portfolio pages.
+ * All functions are async and designed for use in Next.js App Router
+ * server components, generateMetadata(), and generateStaticParams().
+ *
+ * This file is server-only — no 'use client' directive.
+ */
+
+/**
+ * Fetches published portfolio items from the public API.
+ * Cached via Next.js ISR (revalidate: 3600).
+ */
+declare function getPortfolioItems(options?: {
+    category?: string;
+    featured?: boolean;
+    limit?: number;
+    offset?: number;
+}): Promise<PortfolioListResponse>;
+/**
+ * Fetches a single portfolio item by slug, including full Sanity sections
+ * and live metrics delta. This is the main data function for portfolio detail pages.
+ *
+ * Returns null when the item is not found or the API call fails.
+ */
+declare function getPortfolioItem(slug: string): Promise<PortfolioItemFull | null>;
+/**
+ * Fetches available portfolio categories.
+ * Returns an empty array on failure.
+ */
+declare function getPortfolioCategories(): Promise<string[]>;
+/**
+ * Fetches brand configuration for the agency (colors, fonts, logo).
+ * Returns sensible defaults when the API call fails.
+ */
+declare function getPortfolioBrandConfig(): Promise<BrandConfig>;
+/**
+ * Generates Next.js Metadata for a portfolio item page.
+ * For use in generateMetadata() in the App Router.
+ *
+ * Returns an empty object when the item cannot be found, which is safe
+ * to spread into the metadata return value.
+ */
+declare function generatePortfolioMetadata(slug: string): Promise<{
+    title?: string;
+    description?: string;
+    keywords?: string[];
+    openGraph?: {
+        title?: string;
+        description?: string;
+        images?: string[];
+        type?: string;
+    };
+}>;
+/**
+ * Generates static params for portfolio pages.
+ * For use in generateStaticParams() in the App Router.
+ *
+ * Fetches all published portfolio items and returns their slugs.
+ */
+declare function generatePortfolioStaticParams(): Promise<Array<{
+    slug: string;
+}>>;
+
+export { generatePortfolioMetadata, generatePortfolioStaticParams, getPortfolioBrandConfig, getPortfolioCategories, getPortfolioItem, getPortfolioItems };

package/dist/portfolio/server.js

@@ -0,0 +1,134 @@
+import { apiGet } from '../chunk-A4I4IK7V.js';
+
+// src/portfolio/server.ts
+var LOG_PREFIX = "[@sonordev/agency-site-kit/portfolio]";
+function buildQuery(params) {
+  const entries = Object.entries(params).filter(
+    (entry) => entry[1] != null
+  );
+  if (entries.length === 0) return "";
+  const qs = new URLSearchParams(
+    entries.map(([k, v]) => [k, String(v)])
+  ).toString();
+  return `?${qs}`;
+}
+async function getPortfolioItems(options) {
+  const fallback = { items: [], total: 0, limit: 0, offset: 0 };
+  const query = buildQuery({
+    category: options?.category,
+    featured: options?.featured,
+    limit: options?.limit,
+    offset: options?.offset
+  });
+  const data = await apiGet(
+    `/api/public/portfolio/items${query}`
+  );
+  if (!data) {
+    console.warn(`${LOG_PREFIX} Failed to fetch portfolio items.`);
+    return fallback;
+  }
+  return data;
+}
+async function getPortfolioItem(slug) {
+  if (!slug) {
+    console.warn(`${LOG_PREFIX} getPortfolioItem called with empty slug.`);
+    return null;
+  }
+  const data = await apiGet(
+    `/api/public/portfolio/items/${encodeURIComponent(slug)}`
+  );
+  if (!data || !data.found || !data.item) {
+    console.warn(`${LOG_PREFIX} Portfolio item not found for slug: "${slug}".`);
+    return null;
+  }
+  const { item } = data;
+  return {
+    id: item.id,
+    slug: item.slug,
+    title: item.title,
+    subtitle: item.subtitle,
+    category: item.category,
+    services: item.services,
+    description: item.description,
+    hero_image: item.hero_image,
+    hero_image_alt: item.hero_image_alt,
+    live_url: item.live_url,
+    kpis: item.kpis,
+    details: item.details,
+    seo: item.seo,
+    featured: item.featured,
+    order: item.order,
+    published_at: item.published_at,
+    hero_screenshots: item.hero_screenshots,
+    baseline_metrics: item.baseline_metrics,
+    current_metrics: item.current_metrics,
+    metrics_last_refreshed_at: item.metrics_last_refreshed_at,
+    sections: item.sections ?? [],
+    metricsDelta: item.metricsDelta ?? []
+  };
+}
+async function getPortfolioCategories() {
+  const data = await apiGet("/api/public/portfolio/categories");
+  if (!data) {
+    console.warn(`${LOG_PREFIX} Failed to fetch portfolio categories.`);
+    return [];
+  }
+  return data;
+}
+async function getPortfolioBrandConfig() {
+  const fallback = {
+    primary: "#6366f1",
+    secondary: "#8b5cf6",
+    background: "#0a0a0f",
+    backgroundElevated: "#12121a",
+    surface: "#1a1a2e",
+    surfaceHover: "#22223a",
+    surfaceBorder: "#2a2a3e",
+    textPrimary: "#f0f0f5",
+    textSecondary: "#a0a0b5",
+    textTertiary: "#6b6b80",
+    fontHeading: "Inter, system-ui, sans-serif",
+    fontBody: "Inter, system-ui, sans-serif"
+  };
+  const data = await apiGet(
+    "/api/public/portfolio/config"
+  );
+  if (!data || !data.brand) {
+    console.warn(`${LOG_PREFIX} Failed to fetch brand config, using defaults.`);
+    return fallback;
+  }
+  return data.brand;
+}
+async function generatePortfolioMetadata(slug) {
+  const item = await getPortfolioItem(slug);
+  if (!item) {
+    return {};
+  }
+  const seo = item.seo;
+  const title = seo?.metaTitle || item.title;
+  const description = seo?.metaDescription || item.description;
+  const keywords = seo?.keywords ?? [];
+  const ogImages = [];
+  if (item.hero_image) {
+    ogImages.push(item.hero_image);
+  }
+  return {
+    title,
+    description,
+    keywords: keywords.length > 0 ? keywords : void 0,
+    openGraph: {
+      title,
+      description,
+      images: ogImages.length > 0 ? ogImages : void 0,
+      type: "article"
+    }
+  };
+}
+async function generatePortfolioStaticParams() {
+  const data = await getPortfolioItems({ limit: 500, offset: 0 });
+  return data.items.map((item) => ({ slug: item.slug }));
+}
+
+export { generatePortfolioMetadata, generatePortfolioStaticParams, getPortfolioBrandConfig, getPortfolioCategories, getPortfolioItem, getPortfolioItems };
+//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map

package/dist/portfolio/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/portfolio/server.ts"],"names":[],"mappings":"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","file":"server.js","sourcesContent":["/**\n * @sonordev/agency-site-kit — Portfolio server-side data fetching\n *\n * RSC (React Server Component) data layer for portfolio pages.\n * All functions are async and designed for use in Next.js App Router\n * server components, generateMetadata(), and generateStaticParams().\n *\n * This file is server-only — no 'use client' directive.\n */\n\nimport { apiGet } from '../shared/api';\nimport type {\n  BrandConfig,\n  MetricsDelta,\n  PortfolioConfigResponse,\n  PortfolioItemFull,\n  PortfolioListResponse,\n  PortfolioSeoData,\n  PortfolioSection,\n} from '../types';\n\nconst LOG_PREFIX = '[@sonordev/agency-site-kit/portfolio]';\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Builds a query string from an object, omitting undefined/null values.\n */\nfunction buildQuery(params: Record<string, string | number | boolean | undefined | null>): string {\n  const entries = Object.entries(params).filter(\n    (entry): entry is [string, string | number | boolean] => entry[1] != null,\n  );\n  if (entries.length === 0) return '';\n  const qs = new URLSearchParams(\n    entries.map(([k, v]) => [k, String(v)]),\n  ).toString();\n  return `?${qs}`;\n}\n\n// ---------------------------------------------------------------------------\n// Public API — List items\n// ---------------------------------------------------------------------------\n\n/**\n * Fetches published portfolio items from the public API.\n * Cached via Next.js ISR (revalidate: 3600).\n */\nexport async function getPortfolioItems(options?: {\n  category?: string;\n  featured?: boolean;\n  limit?: number;\n  offset?: number;\n}): Promise<PortfolioListResponse> {\n  const fallback: PortfolioListResponse = { items: [], total: 0, limit: 0, offset: 0 };\n\n  const query = buildQuery({\n    category: options?.category,\n    featured: options?.featured,\n    limit: options?.limit,\n    offset: options?.offset,\n  });\n\n  const data = await apiGet<PortfolioListResponse>(\n    `/api/public/portfolio/items${query}`,\n  );\n\n  if (!data) {\n    console.warn(`${LOG_PREFIX} Failed to fetch portfolio items.`);\n    return fallback;\n  }\n\n  return data;\n}\n\n// ---------------------------------------------------------------------------\n// Public API — Single item\n// ---------------------------------------------------------------------------\n\n/** Shape returned by the single-item API endpoint. */\ninterface PortfolioItemApiResponse {\n  found: boolean;\n  item: {\n    id: string;\n    slug: string;\n    title: string;\n    subtitle: string;\n    category: string;\n    services: string[];\n    description: string;\n    hero_image: string;\n    hero_image_alt: string;\n    live_url: string | null;\n    kpis: PortfolioItemFull['kpis'];\n    details: PortfolioItemFull['details'];\n    seo: PortfolioItemFull['seo'];\n    featured: boolean;\n    order?: number;\n    published_at: string | null;\n    hero_screenshots: PortfolioItemFull['hero_screenshots'];\n    baseline_metrics: PortfolioItemFull['baseline_metrics'];\n    current_metrics: PortfolioItemFull['current_metrics'];\n    metrics_last_refreshed_at: string | null;\n    sections: PortfolioSection[];\n    metricsDelta: MetricsDelta[];\n  };\n}\n\n/**\n * Fetches a single portfolio item by slug, including full Sanity sections\n * and live metrics delta. This is the main data function for portfolio detail pages.\n *\n * Returns null when the item is not found or the API call fails.\n */\nexport async function getPortfolioItem(slug: string): Promise<PortfolioItemFull | null> {\n  if (!slug) {\n    console.warn(`${LOG_PREFIX} getPortfolioItem called with empty slug.`);\n    return null;\n  }\n\n  const data = await apiGet<PortfolioItemApiResponse>(\n    `/api/public/portfolio/items/${encodeURIComponent(slug)}`,\n  );\n\n  if (!data || !data.found || !data.item) {\n    console.warn(`${LOG_PREFIX} Portfolio item not found for slug: \"${slug}\".`);\n    return null;\n  }\n\n  // Map the API response to the PortfolioItemFull type\n  const { item } = data;\n  return {\n    id: item.id,\n    slug: item.slug,\n    title: item.title,\n    subtitle: item.subtitle,\n    category: item.category,\n    services: item.services,\n    description: item.description,\n    hero_image: item.hero_image,\n    hero_image_alt: item.hero_image_alt,\n    live_url: item.live_url,\n    kpis: item.kpis,\n    details: item.details,\n    seo: item.seo,\n    featured: item.featured,\n    order: item.order,\n    published_at: item.published_at,\n    hero_screenshots: item.hero_screenshots,\n    baseline_metrics: item.baseline_metrics,\n    current_metrics: item.current_metrics,\n    metrics_last_refreshed_at: item.metrics_last_refreshed_at,\n    sections: item.sections ?? [],\n    metricsDelta: item.metricsDelta ?? [],\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Public API — Categories\n// ---------------------------------------------------------------------------\n\n/**\n * Fetches available portfolio categories.\n * Returns an empty array on failure.\n */\nexport async function getPortfolioCategories(): Promise<string[]> {\n  const data = await apiGet<string[]>('/api/public/portfolio/categories');\n\n  if (!data) {\n    console.warn(`${LOG_PREFIX} Failed to fetch portfolio categories.`);\n    return [];\n  }\n\n  return data;\n}\n\n// ---------------------------------------------------------------------------\n// Public API — Brand config\n// ---------------------------------------------------------------------------\n\n/**\n * Fetches brand configuration for the agency (colors, fonts, logo).\n * Returns sensible defaults when the API call fails.\n */\nexport async function getPortfolioBrandConfig(): Promise<BrandConfig> {\n  const fallback: BrandConfig = {\n    primary: '#6366f1',\n    secondary: '#8b5cf6',\n    background: '#0a0a0f',\n    backgroundElevated: '#12121a',\n    surface: '#1a1a2e',\n    surfaceHover: '#22223a',\n    surfaceBorder: '#2a2a3e',\n    textPrimary: '#f0f0f5',\n    textSecondary: '#a0a0b5',\n    textTertiary: '#6b6b80',\n    fontHeading: 'Inter, system-ui, sans-serif',\n    fontBody: 'Inter, system-ui, sans-serif',\n  };\n\n  const data = await apiGet<PortfolioConfigResponse>(\n    '/api/public/portfolio/config',\n  );\n\n  if (!data || !data.brand) {\n    console.warn(`${LOG_PREFIX} Failed to fetch brand config, using defaults.`);\n    return fallback;\n  }\n\n  return data.brand;\n}\n\n// ---------------------------------------------------------------------------\n// Next.js Metadata helper\n// ---------------------------------------------------------------------------\n\n/**\n * Generates Next.js Metadata for a portfolio item page.\n * For use in generateMetadata() in the App Router.\n *\n * Returns an empty object when the item cannot be found, which is safe\n * to spread into the metadata return value.\n */\nexport async function generatePortfolioMetadata(slug: string): Promise<{\n  title?: string;\n  description?: string;\n  keywords?: string[];\n  openGraph?: {\n    title?: string;\n    description?: string;\n    images?: string[];\n    type?: string;\n  };\n}> {\n  const item = await getPortfolioItem(slug);\n\n  if (!item) {\n    return {};\n  }\n\n  // Prefer dedicated SEO data if available, fall back to item fields\n  const seo: PortfolioSeoData | null = item.seo;\n  const title = seo?.metaTitle || item.title;\n  const description = seo?.metaDescription || item.description;\n  const keywords = seo?.keywords ?? [];\n\n  // Collect OG images: prefer SEO og image, then hero image\n  const ogImages: string[] = [];\n  if (item.hero_image) {\n    ogImages.push(item.hero_image);\n  }\n\n  return {\n    title,\n    description,\n    keywords: keywords.length > 0 ? keywords : undefined,\n    openGraph: {\n      title,\n      description,\n      images: ogImages.length > 0 ? ogImages : undefined,\n      type: 'article',\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Next.js Static Params helper\n// ---------------------------------------------------------------------------\n\n/**\n * Generates static params for portfolio pages.\n * For use in generateStaticParams() in the App Router.\n *\n * Fetches all published portfolio items and returns their slugs.\n */\nexport async function generatePortfolioStaticParams(): Promise<Array<{ slug: string }>> {\n  // Fetch a large batch to cover all published items\n  const data = await getPortfolioItems({ limit: 500, offset: 0 });\n\n  return data.items.map((item) => ({ slug: item.slug }));\n}\n"]}

package/dist/types-BMUhBhWx.d.cts

@@ -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 };